ModifyReplicationSubnetGroup
Modifies the settings for the specified replication subnet group.
Request Syntax
{
"ReplicationSubnetGroupDescription": "string
",
"ReplicationSubnetGroupIdentifier": "string
",
"SubnetIds": [ "string
" ]
}
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
The request accepts the following data in JSON format.
- ReplicationSubnetGroupDescription
-
A description for the replication instance subnet group.
Type: String
Required: No
- ReplicationSubnetGroupIdentifier
-
The name of the replication instance subnet group.
Type: String
Required: Yes
- SubnetIds
-
A list of subnet IDs.
Type: Array of strings
Required: Yes
Response Syntax
{
"ReplicationSubnetGroup": {
"ReplicationSubnetGroupDescription": "string",
"ReplicationSubnetGroupIdentifier": "string",
"SubnetGroupStatus": "string",
"Subnets": [
{
"SubnetAvailabilityZone": {
"Name": "string"
},
"SubnetIdentifier": "string",
"SubnetStatus": "string"
}
],
"SupportedNetworkTypes": [ "string" ],
"VpcId": "string"
}
}
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- ReplicationSubnetGroup
-
The modified replication subnet group.
Type: ReplicationSubnetGroup object
Errors
For information about the errors that are common to all actions, see Common Errors.
- AccessDeniedFault
-
Amazon DMS was denied access to the endpoint. Check that the role is correctly configured.
HTTP Status Code: 400
- InvalidSubnet
-
The subnet provided isn't valid.
HTTP Status Code: 400
- ReplicationSubnetGroupDoesNotCoverEnoughAZs
-
The replication subnet group does not cover enough Availability Zones (AZs). Edit the replication subnet group and add more AZs.
HTTP Status Code: 400
- ResourceNotFoundFault
-
The resource could not be found.
HTTP Status Code: 400
- ResourceQuotaExceededFault
-
The quota for this resource quota has been exceeded.
HTTP Status Code: 400
- SubnetAlreadyInUse
-
The specified subnet is already in use.
HTTP Status Code: 400
Examples
Example
This example illustrates one usage of ModifyReplicationSubnetGroup.
Sample Request
POST / HTTP/1.1
Host: dms.<region>.<domain>
x-amz-Date: <Date>
Authorization: AWS4-HMAC-SHA256
Credential=<Credential>,
SignedHeaders=contenttype;date;host;user-
agent;x-amz-date;x-amz-target;x-amzn-
requestid,Signature=<Signature>
User-Agent: <UserAgentString>
Content-Type: application/x-amz-json-1.1
Content-Length: <PayloadSizeBytes>
Connection: Keep-Alive
X-Amz-Target: AmazonDMSv20160101.ModifyReplicationSubnetGroup
{
"ReplicationSubnetGroupIdentifier":"test-subnet-group",
"ReplicationSubnetGroupDescription":"",
"SubnetIds":[
"subnet-f6dd91af",
"subnet-3605751d "
]
}
Sample Response
HTTP/1.1 200 OK
x-amzn-RequestId: <RequestId>
Content-Type: application/x-amz-json-1.1
Content-Length: <PayloadSizeBytes>
Date: <Date>
{
"ReplicationSubnetGroup":{
"ReplicationSubnetGroupDescription":"dms testing",
"Subnets":[
{
"SubnetStatus":"Active",
"SubnetIdentifier":"subnet-f6dd91af",
"SubnetAvailabilityZone":{
"Name":"us-east-1d"
}
},
{
"SubnetStatus":"Active",
"SubnetIdentifier":"subnet-3605751d",
"SubnetAvailabilityZone":{
"Name":"us-east-1b"
}
}
],
"VpcId":"vpc-6741a603",
"SubnetGroupStatus":"Complete",
"ReplicationSubnetGroupIdentifier":"test-subnet-group"
}
}
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: