AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Creates the replication instance using the specified parameters.

DMS requires that your account have certain roles with appropriate permissions before you can create a replication instance. For information on the required roles, see Creating the IAM Roles to Use With the CLI and DMS API. For information on the required permissions, see IAM Permissions Needed to Use DMS.

If you don't specify a version when creating a replication instance, DMS will create the instance using the default engine version. For information about the default engine version, see Release Notes.

Note:

This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginCreateReplicationInstance and EndCreateReplicationInstance.

Namespace: Amazon.DatabaseMigrationService
Assembly: AWSSDK.DatabaseMigrationService.dll
Version: 3.x.y.z

Syntax

C#
public virtual Task<CreateReplicationInstanceResponse> CreateReplicationInstanceAsync(
         CreateReplicationInstanceRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.DatabaseMigrationService.Model.CreateReplicationInstanceRequest

Container for the necessary parameters to execute the CreateReplicationInstance service method.

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value


The response from the CreateReplicationInstance service method, as returned by DatabaseMigrationService.

Exceptions

ExceptionCondition
AccessDeniedException DMS was denied access to the endpoint. Check that the role is correctly configured.
InsufficientResourceCapacityException There are not enough resources allocated to the database migration.
InvalidResourceStateException The resource is in a state that prevents it from being used for database migration.
InvalidSubnetException The subnet provided isn't valid.
KMSKeyNotAccessibleException DMS cannot access the KMS key.
ReplicationSubnetGroupDoesNotCoverEnoughAZsException The replication subnet group does not cover enough Availability Zones (AZs). Edit the replication subnet group and add more AZs.
ResourceAlreadyExistsException The resource you are attempting to create already exists.
ResourceNotFoundException The resource could not be found.
ResourceQuotaExceededException The quota for this resource quota has been exceeded.
StorageQuotaExceededException The storage quota has been exceeded.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5

See Also