DescribeAccountAttributes - Amazon Database Migration Service
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

DescribeAccountAttributes

Lists all of the Amazon DMS attributes for a customer account. These attributes include Amazon DMS quotas for the account and a unique account identifier in a particular DMS region. DMS quotas include a list of resource quotas supported by the account, such as the number of replication instances allowed. The description for each resource quota, includes the quota name, current usage toward that quota, and the quota's maximum value. DMS uses the unique account identifier to name each artifact used by DMS in the given region.

This command does not take any parameters.

Response Syntax

{ "AccountQuotas": [ { "AccountQuotaName": "string", "Max": number, "Used": number } ], "UniqueAccountIdentifier": "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.

AccountQuotas

Account quota information.

Type: Array of AccountQuota objects

UniqueAccountIdentifier

A unique Amazon 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.

Note

Amazon DMS supports the UniqueAccountIdentifier parameter in versions 3.1.4 and later.

Type: String

Errors

For information about the errors that are common to all actions, see Common Errors.

Examples

Example

This example illustrates one usage of DescribeAccountAttributes.

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.DescribeAccountAttributes

Sample Response

HTTP/1.1 200 OK x-amzn-RequestId: <RequestId> Content-Type: application/x-amz-json-1.1 Content-Length: <PayloadSizeBytes> Date: <Date> { "AccountQuotas":[ { "Max":20, "AccountQuotaName":"ReplicationInstances", "Used":12 }, { "Max":10000, "AccountQuotaName":"AllocatedStorage", "Used":6339 }, { "Max":20, "AccountQuotaName":"ReplicationSubnetGroups", "Used":5 }, { "Max":20, "AccountQuotaName":"SubnetsPerReplicationSubnetGroup", "Used":4 }, { "Max":100, "AccountQuotaName":"Endpoints", "Used":10 }, { "Max":200, "AccountQuotaName":"ReplicationTasks", "Used":2 }, { "Max":20, "AccountQuotaName":"EndpointsPerInstance", "Used":8 } ] "UniqueAccountIdentifier":"c44445555666" }

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: