pub struct Client { /* private fields */ }
Expand description

Client for AWS Database Migration Service

Client for invoking operations on AWS Database Migration Service. Each operation on AWS Database Migration Service is a method on this this struct. .send() MUST be invoked on the generated operations to dispatch the request to the service.

Constructing a Client

A Config is required to construct a client. For most use cases, the aws-config crate should be used to automatically resolve this config using aws_config::load_from_env(), since this will resolve an SdkConfig which can be shared across multiple different AWS SDK clients. This config resolution process can be customized by calling aws_config::from_env() instead, which returns a ConfigLoader that uses the builder pattern to customize the default config.

In the simplest case, creating a client looks as follows:

let config = aws_config::load_from_env().await;
let client = aws_sdk_databasemigration::Client::new(&config);

Occasionally, SDKs may have additional service-specific that can be set on the Config that is absent from SdkConfig, or slightly different settings for a specific client may be desired. The Config struct implements From<&SdkConfig>, so setting these specific settings can be done as follows:

let sdk_config = aws_config::load_from_env().await;
let config = aws_sdk_databasemigration::config::Builder::from(&sdk_config)
    .some_service_specific_setting("value")
    .build();

See the aws-config docs and Config for more information on customizing configuration.

Note: Client construction is expensive due to connection thread pool initialization, and should be done once at application start-up.

Using the Client

A client has a function for every operation that can be performed by the service. For example, the AddTagsToResource operation has a Client::add_tags_to_resource, function which returns a builder for that operation. The fluent builder ultimately has a call() function that returns an async future that returns a result, as illustrated below:

let result = client.add_tags_to_resource()
    .resource_arn("example")
    .call()
    .await;

The underlying HTTP requests that get made by this can be modified with the customize_operation function on the fluent builder. See the customize module for more information.

Implementations§

source§

impl Client

source

pub fn add_tags_to_resource(&self) -> AddTagsToResourceFluentBuilder

Constructs a fluent builder for the AddTagsToResource operation.

source§

impl Client

source

pub fn apply_pending_maintenance_action( &self ) -> ApplyPendingMaintenanceActionFluentBuilder

Constructs a fluent builder for the ApplyPendingMaintenanceAction operation.

source§

impl Client

source

pub fn cancel_replication_task_assessment_run( &self ) -> CancelReplicationTaskAssessmentRunFluentBuilder

Constructs a fluent builder for the CancelReplicationTaskAssessmentRun operation.

source§

impl Client

source

pub fn create_endpoint(&self) -> CreateEndpointFluentBuilder

Constructs a fluent builder for the CreateEndpoint operation.

source§

impl Client

source

pub fn create_event_subscription(&self) -> CreateEventSubscriptionFluentBuilder

Constructs a fluent builder for the CreateEventSubscription operation.

source§

impl Client

source

pub fn create_fleet_advisor_collector( &self ) -> CreateFleetAdvisorCollectorFluentBuilder

Constructs a fluent builder for the CreateFleetAdvisorCollector operation.

source§

impl Client

source

pub fn create_replication_instance( &self ) -> CreateReplicationInstanceFluentBuilder

Constructs a fluent builder for the CreateReplicationInstance operation.

source§

impl Client

source

pub fn create_replication_subnet_group( &self ) -> CreateReplicationSubnetGroupFluentBuilder

Constructs a fluent builder for the CreateReplicationSubnetGroup operation.

source§

impl Client

source

pub fn create_replication_task(&self) -> CreateReplicationTaskFluentBuilder

Constructs a fluent builder for the CreateReplicationTask operation.

source§

impl Client

source

pub fn delete_certificate(&self) -> DeleteCertificateFluentBuilder

Constructs a fluent builder for the DeleteCertificate operation.

source§

impl Client

source

pub fn delete_connection(&self) -> DeleteConnectionFluentBuilder

Constructs a fluent builder for the DeleteConnection operation.

source§

impl Client

source

pub fn delete_endpoint(&self) -> DeleteEndpointFluentBuilder

Constructs a fluent builder for the DeleteEndpoint operation.

source§

impl Client

source

pub fn delete_event_subscription(&self) -> DeleteEventSubscriptionFluentBuilder

Constructs a fluent builder for the DeleteEventSubscription operation.

source§

impl Client

source

pub fn delete_fleet_advisor_collector( &self ) -> DeleteFleetAdvisorCollectorFluentBuilder

Constructs a fluent builder for the DeleteFleetAdvisorCollector operation.

source§

impl Client

source

pub fn delete_fleet_advisor_databases( &self ) -> DeleteFleetAdvisorDatabasesFluentBuilder

Constructs a fluent builder for the DeleteFleetAdvisorDatabases operation.

source§

impl Client

source

pub fn delete_replication_instance( &self ) -> DeleteReplicationInstanceFluentBuilder

Constructs a fluent builder for the DeleteReplicationInstance operation.

source§

impl Client

source

pub fn delete_replication_subnet_group( &self ) -> DeleteReplicationSubnetGroupFluentBuilder

Constructs a fluent builder for the DeleteReplicationSubnetGroup operation.

source§

impl Client

source

pub fn delete_replication_task(&self) -> DeleteReplicationTaskFluentBuilder

Constructs a fluent builder for the DeleteReplicationTask operation.

source§

impl Client

source

pub fn delete_replication_task_assessment_run( &self ) -> DeleteReplicationTaskAssessmentRunFluentBuilder

Constructs a fluent builder for the DeleteReplicationTaskAssessmentRun operation.

source§

impl Client

source

pub fn describe_account_attributes( &self ) -> DescribeAccountAttributesFluentBuilder

Constructs a fluent builder for the DescribeAccountAttributes operation.

  • The fluent builder takes no input, just send it.
  • On success, responds with DescribeAccountAttributesOutput with field(s):
    • account_quotas(Option<Vec<AccountQuota>>):

      Account quota information.

    • unique_account_identifier(Option<String>):

      A unique DMS identifier for an account in a particular Amazon Web Services Region. The value of this identifier has the following format: c99999999999. DMS uses this identifier to name artifacts. For example, DMS uses this identifier to name the default Amazon S3 bucket for storing task assessment reports in a given Amazon Web Services Region. The format of this S3 bucket name is the following: dms-AccountNumber-UniqueAccountIdentifier. Here is an example name for this default S3 bucket: dms-111122223333-c44445555666.

      DMS supports the UniqueAccountIdentifier parameter in versions 3.1.4 and later.

  • On failure, responds with SdkError<DescribeAccountAttributesError>
source§

impl Client

source

pub fn describe_applicable_individual_assessments( &self ) -> DescribeApplicableIndividualAssessmentsFluentBuilder

Constructs a fluent builder for the DescribeApplicableIndividualAssessments operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn describe_certificates(&self) -> DescribeCertificatesFluentBuilder

Constructs a fluent builder for the DescribeCertificates operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn describe_connections(&self) -> DescribeConnectionsFluentBuilder

Constructs a fluent builder for the DescribeConnections operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn describe_endpoint_settings( &self ) -> DescribeEndpointSettingsFluentBuilder

Constructs a fluent builder for the DescribeEndpointSettings operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn describe_endpoint_types(&self) -> DescribeEndpointTypesFluentBuilder

Constructs a fluent builder for the DescribeEndpointTypes operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn describe_endpoints(&self) -> DescribeEndpointsFluentBuilder

Constructs a fluent builder for the DescribeEndpoints operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn describe_event_categories(&self) -> DescribeEventCategoriesFluentBuilder

Constructs a fluent builder for the DescribeEventCategories operation.

source§

impl Client

source

pub fn describe_event_subscriptions( &self ) -> DescribeEventSubscriptionsFluentBuilder

Constructs a fluent builder for the DescribeEventSubscriptions operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn describe_events(&self) -> DescribeEventsFluentBuilder

Constructs a fluent builder for the DescribeEvents operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn describe_fleet_advisor_collectors( &self ) -> DescribeFleetAdvisorCollectorsFluentBuilder

Constructs a fluent builder for the DescribeFleetAdvisorCollectors operation. This operation supports pagination; See into_paginator().

  • The fluent builder is configurable:
    • filters(Vec<Filter>) / set_filters(Option<Vec<Filter>>):

      If you specify any of the following filters, the output includes information for only those collectors that meet the filter criteria:

      • collector-referenced-id – The ID of the collector agent, for example d4610ac5-e323-4ad9-bc50-eaf7249dfe9d.

      • collector-name – The name of the collector agent.

      An example is: describe-fleet-advisor-collectors –filter Name=“collector-referenced-id”,Values=“d4610ac5-e323-4ad9-bc50-eaf7249dfe9d”

    • max_records(i32) / set_max_records(Option<i32>):

      Sets the maximum number of records returned in the response.

    • next_token(impl Into<String>) / set_next_token(Option<String>):

      If NextToken is returned by a previous response, there are more results available. The value of NextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.

  • On success, responds with DescribeFleetAdvisorCollectorsOutput with field(s):
    • collectors(Option<Vec<CollectorResponse>>):

      Provides descriptions of the Fleet Advisor collectors, including the collectors’ name and ID, and the latest inventory data.

    • next_token(Option<String>):

      If NextToken is returned, there are more results available. The value of NextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.

  • On failure, responds with SdkError<DescribeFleetAdvisorCollectorsError>
source§

impl Client

source

pub fn describe_fleet_advisor_databases( &self ) -> DescribeFleetAdvisorDatabasesFluentBuilder

Constructs a fluent builder for the DescribeFleetAdvisorDatabases operation. This operation supports pagination; See into_paginator().

  • The fluent builder is configurable:
    • filters(Vec<Filter>) / set_filters(Option<Vec<Filter>>):

      If you specify any of the following filters, the output includes information for only those databases that meet the filter criteria:

      • database-id – The ID of the database.

      • database-name – The name of the database.

      • database-engine – The name of the database engine.

      • server-ip-address – The IP address of the database server.

      • database-ip-address – The IP address of the database.

      • collector-name – The name of the associated Fleet Advisor collector.

      An example is: describe-fleet-advisor-databases –filter Name=“database-id”,Values=“45”

    • max_records(i32) / set_max_records(Option<i32>):

      Sets the maximum number of records returned in the response.

    • next_token(impl Into<String>) / set_next_token(Option<String>):

      If NextToken is returned by a previous response, there are more results available. The value of NextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.

  • On success, responds with DescribeFleetAdvisorDatabasesOutput with field(s):
    • databases(Option<Vec<DatabaseResponse>>):

      Provides descriptions of the Fleet Advisor collector databases, including the database’s collector, ID, and name.

    • next_token(Option<String>):

      If NextToken is returned, there are more results available. The value of NextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.

  • On failure, responds with SdkError<DescribeFleetAdvisorDatabasesError>
source§

impl Client

source

pub fn describe_fleet_advisor_lsa_analysis( &self ) -> DescribeFleetAdvisorLsaAnalysisFluentBuilder

Constructs a fluent builder for the DescribeFleetAdvisorLsaAnalysis operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn describe_fleet_advisor_schema_object_summary( &self ) -> DescribeFleetAdvisorSchemaObjectSummaryFluentBuilder

Constructs a fluent builder for the DescribeFleetAdvisorSchemaObjectSummary operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn describe_fleet_advisor_schemas( &self ) -> DescribeFleetAdvisorSchemasFluentBuilder

Constructs a fluent builder for the DescribeFleetAdvisorSchemas operation. This operation supports pagination; See into_paginator().

  • The fluent builder is configurable:
    • filters(Vec<Filter>) / set_filters(Option<Vec<Filter>>):

      If you specify any of the following filters, the output includes information for only those schemas that meet the filter criteria:

      • complexity – The schema’s complexity, for example Simple.

      • database-id – The ID of the schema’s database.

      • database-ip-address – The IP address of the schema’s database.

      • database-name – The name of the schema’s database.

      • database-engine – The name of the schema database’s engine.

      • original-schema-name – The name of the schema’s database’s main schema.

      • schema-id – The ID of the schema, for example 15.

      • schema-name – The name of the schema.

      • server-ip-address – The IP address of the schema database’s server.

      An example is: describe-fleet-advisor-schemas –filter Name=“schema-id”,Values=“50”

    • max_records(i32) / set_max_records(Option<i32>):

      Sets the maximum number of records returned in the response.

    • next_token(impl Into<String>) / set_next_token(Option<String>):

      If NextToken is returned by a previous response, there are more results available. The value of NextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.

  • On success, responds with DescribeFleetAdvisorSchemasOutput with field(s):
  • On failure, responds with SdkError<DescribeFleetAdvisorSchemasError>
source§

impl Client

source

pub fn describe_orderable_replication_instances( &self ) -> DescribeOrderableReplicationInstancesFluentBuilder

Constructs a fluent builder for the DescribeOrderableReplicationInstances operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn describe_pending_maintenance_actions( &self ) -> DescribePendingMaintenanceActionsFluentBuilder

Constructs a fluent builder for the DescribePendingMaintenanceActions operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn describe_refresh_schemas_status( &self ) -> DescribeRefreshSchemasStatusFluentBuilder

Constructs a fluent builder for the DescribeRefreshSchemasStatus operation.

source§

impl Client

source

pub fn describe_replication_instance_task_logs( &self ) -> DescribeReplicationInstanceTaskLogsFluentBuilder

Constructs a fluent builder for the DescribeReplicationInstanceTaskLogs operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn describe_replication_instances( &self ) -> DescribeReplicationInstancesFluentBuilder

Constructs a fluent builder for the DescribeReplicationInstances operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn describe_replication_subnet_groups( &self ) -> DescribeReplicationSubnetGroupsFluentBuilder

Constructs a fluent builder for the DescribeReplicationSubnetGroups operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn describe_replication_task_assessment_results( &self ) -> DescribeReplicationTaskAssessmentResultsFluentBuilder

Constructs a fluent builder for the DescribeReplicationTaskAssessmentResults operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn describe_replication_task_assessment_runs( &self ) -> DescribeReplicationTaskAssessmentRunsFluentBuilder

Constructs a fluent builder for the DescribeReplicationTaskAssessmentRuns operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn describe_replication_task_individual_assessments( &self ) -> DescribeReplicationTaskIndividualAssessmentsFluentBuilder

Constructs a fluent builder for the DescribeReplicationTaskIndividualAssessments operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn describe_replication_tasks( &self ) -> DescribeReplicationTasksFluentBuilder

Constructs a fluent builder for the DescribeReplicationTasks operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn describe_schemas(&self) -> DescribeSchemasFluentBuilder

Constructs a fluent builder for the DescribeSchemas operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn describe_table_statistics(&self) -> DescribeTableStatisticsFluentBuilder

Constructs a fluent builder for the DescribeTableStatistics operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn import_certificate(&self) -> ImportCertificateFluentBuilder

Constructs a fluent builder for the ImportCertificate operation.

source§

impl Client

source

pub fn list_tags_for_resource(&self) -> ListTagsForResourceFluentBuilder

Constructs a fluent builder for the ListTagsForResource operation.

source§

impl Client

source

pub fn modify_endpoint(&self) -> ModifyEndpointFluentBuilder

Constructs a fluent builder for the ModifyEndpoint operation.

source§

impl Client

source

pub fn modify_event_subscription(&self) -> ModifyEventSubscriptionFluentBuilder

Constructs a fluent builder for the ModifyEventSubscription operation.

source§

impl Client

source

pub fn modify_replication_instance( &self ) -> ModifyReplicationInstanceFluentBuilder

Constructs a fluent builder for the ModifyReplicationInstance operation.

source§

impl Client

source

pub fn modify_replication_subnet_group( &self ) -> ModifyReplicationSubnetGroupFluentBuilder

Constructs a fluent builder for the ModifyReplicationSubnetGroup operation.

source§

impl Client

source

pub fn modify_replication_task(&self) -> ModifyReplicationTaskFluentBuilder

Constructs a fluent builder for the ModifyReplicationTask operation.

source§

impl Client

source

pub fn move_replication_task(&self) -> MoveReplicationTaskFluentBuilder

Constructs a fluent builder for the MoveReplicationTask operation.

source§

impl Client

source

pub fn reboot_replication_instance( &self ) -> RebootReplicationInstanceFluentBuilder

Constructs a fluent builder for the RebootReplicationInstance operation.

source§

impl Client

source

pub fn refresh_schemas(&self) -> RefreshSchemasFluentBuilder

Constructs a fluent builder for the RefreshSchemas operation.

source§

impl Client

source

pub fn reload_tables(&self) -> ReloadTablesFluentBuilder

Constructs a fluent builder for the ReloadTables operation.

source§

impl Client

source

pub fn remove_tags_from_resource(&self) -> RemoveTagsFromResourceFluentBuilder

Constructs a fluent builder for the RemoveTagsFromResource operation.

source§

impl Client

source

pub fn run_fleet_advisor_lsa_analysis( &self ) -> RunFleetAdvisorLsaAnalysisFluentBuilder

Constructs a fluent builder for the RunFleetAdvisorLsaAnalysis operation.

source§

impl Client

source

pub fn start_replication_task(&self) -> StartReplicationTaskFluentBuilder

Constructs a fluent builder for the StartReplicationTask operation.

source§

impl Client

source

pub fn start_replication_task_assessment( &self ) -> StartReplicationTaskAssessmentFluentBuilder

Constructs a fluent builder for the StartReplicationTaskAssessment operation.

source§

impl Client

source

pub fn start_replication_task_assessment_run( &self ) -> StartReplicationTaskAssessmentRunFluentBuilder

Constructs a fluent builder for the StartReplicationTaskAssessmentRun operation.

source§

impl Client

source

pub fn stop_replication_task(&self) -> StopReplicationTaskFluentBuilder

Constructs a fluent builder for the StopReplicationTask operation.

source§

impl Client

source

pub fn test_connection(&self) -> TestConnectionFluentBuilder

Constructs a fluent builder for the TestConnection operation.

source§

impl Client

source

pub fn update_subscriptions_to_event_bridge( &self ) -> UpdateSubscriptionsToEventBridgeFluentBuilder

Constructs a fluent builder for the UpdateSubscriptionsToEventBridge operation.

source§

impl Client

source

pub fn with_config( client: Client<DynConnector, DynMiddleware<DynConnector>>, conf: Config ) -> Self

Creates a client with the given service configuration.

source

pub fn conf(&self) -> &Config

Returns the client’s configuration.

source§

impl Client

source

pub fn new(sdk_config: &SdkConfig) -> Self

Creates a new client from an SDK Config.

Panics
  • This method will panic if the sdk_config is missing an async sleep implementation. If you experience this panic, set the sleep_impl on the Config passed into this function to fix it.
  • This method will panic if the sdk_config is missing an HTTP connector. If you experience this panic, set the http_connector on the Config passed into this function to fix it.
source

pub fn from_conf(conf: Config) -> Self

Creates a new client from the service Config.

Panics
  • This method will panic if the conf is missing an async sleep implementation. If you experience this panic, set the sleep_impl on the Config passed into this function to fix it.
  • This method will panic if the conf is missing an HTTP connector. If you experience this panic, set the http_connector on the Config passed into this function to fix it.

Trait Implementations§

source§

impl Clone for Client

source§

fn clone(&self) -> Self

Returns a copy of the value. Read more
1.0.0 · source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
source§

impl Debug for Client

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
source§

impl From<Client<DynConnector, DynMiddleware<DynConnector>, Standard>> for Client

source§

fn from(client: Client<DynConnector, DynMiddleware<DynConnector>>) -> Self

Converts to this type from the input type.

Auto Trait Implementations§

§

impl !RefUnwindSafe for Client

§

impl Send for Client

§

impl Sync for Client

§

impl Unpin for Client

§

impl !UnwindSafe for Client

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

const: unstable · source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

const: unstable · source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

const: unstable · source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for Twhere U: From<T>,

const: unstable · source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> Same<T> for T

§

type Output = T

Should always be Self
source§

impl<T> ToOwned for Twhere T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
const: unstable · source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
const: unstable · source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more