IAmazonDatabaseMigrationService.CreateReplicationSubnetGroup Method (CreateReplicationSubnetGroupRequest)

Creates a replication subnet group given a list of the subnet IDs in a VPC.

The VPC needs to have at least one subnet in at least two availability zones in the Amazon Web Services Region, otherwise the service will throw a ReplicationSubnetGroupDoesNotCoverEnoughAZs exception.

If a replication subnet group exists in your Amazon Web Services account, the CreateReplicationSubnetGroup action returns the following error message: The Replication Subnet Group already exists. In this case, delete the existing replication subnet group. To do so, use the DeleteReplicationSubnetGroup action. Optionally, choose Subnet groups in the DMS console, then choose your subnet group. Next, choose Delete from Actions.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to CreateReplicationSubnetGroupAsync.

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

Syntax

public abstract CreateReplicationSubnetGroupResponse CreateReplicationSubnetGroup(
         CreateReplicationSubnetGroupRequest request
)

Parameters

request: Type: Amazon.DatabaseMigrationService.Model.CreateReplicationSubnetGroupRequest

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

Return Value

Type: CreateReplicationSubnetGroupResponse

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

Exceptions

Exception	Condition
AccessDeniedException	DMS was denied access to the endpoint. Check that the role is correctly configured.
InvalidSubnetException	The subnet provided isn't valid.
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.

Examples

Creates a replication subnet group given a list of the subnet IDs in a VPC.

Create replication subnet group


var client = new AmazonDatabaseMigrationServiceClient();
var response = client.CreateReplicationSubnetGroup(new CreateReplicationSubnetGroupRequest 
{
    ReplicationSubnetGroupDescription = "US West subnet group",
    ReplicationSubnetGroupIdentifier = "us-west-2ab-vpc-215ds366",
    SubnetIds = new List<string> {
        "subnet-e145356n",
        "subnet-58f79200"
    },
    Tags = new List<Tag> {
        new Tag {
            Key = "Acount",
            Value = "145235"
        }
    }
});

ReplicationSubnetGroup replicationSubnetGroup = response.ReplicationSubnetGroup;

Version Information

.NET Framework:
Supported in: 4.5 and newer, 3.5

IAmazonDatabaseMigrationService.CreateReplicationSubnetGroup (CreateReplicationSubnetGroupRequest)

Method