ListDomains
This operation returns all the domain names registered with Amazon Route 53 for the current AWS account.
Request Syntax
{ "Marker": "
string
", "MaxItems":number
}
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.
- Marker
-
For an initial request for a list of domains, omit this element. If the number of domains that are associated with the current AWS account is greater than the value that you specified for
MaxItems
, you can useMarker
to return additional domains. Get the value ofNextPageMarker
from the previous response, and submit another request that includes the value ofNextPageMarker
in theMarker
element.Constraints: The marker must match the value specified in the previous request.
Type: String
Length Constraints: Maximum length of 4096.
Required: No
- MaxItems
-
Number of domains to be returned.
Default: 20
Type: Integer
Valid Range: Maximum value of 100.
Required: No
Response Syntax
{ "Domains": [ { "AutoRenew": boolean, "DomainName": "string", "Expiry": number, "TransferLock": boolean } ], "NextPageMarker": "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.
- Domains
-
A summary of domains.
Type: Array of DomainSummary objects
- NextPageMarker
-
If there are more domains than you specified for
MaxItems
in the request, submit another request and include the value ofNextPageMarker
in the value ofMarker
.Type: String
Length Constraints: Maximum length of 4096.
Errors
For information about the errors that are common to all actions, see Common Errors.
- InvalidInput
-
The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.
HTTP Status Code: 400
Example
ListDomains Example
Sample Request
POST / HTTP/1.1 host:route53domains.us-east-1.amazonaws.com x-amz-date:20140711T205230Z authorization:AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request, SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target, Signature=[calculated-signature] x-amz-target:Route53Domains_v20140515.ListDomains user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60 content-type:application/x-amz-json-1.1 content-length:[number of characters in the JSON string] { "Marker":"AxDAClaROQAXasf29GHWAIKPLA=", "MaxItems":20 }
Sample Response
HTTP/1.1 200 Content-Length:[number of characters in the JSON string] { "Domains":[ { "AutoRenew":false, "DomainName":"example.com", "Expiry":1431203765, "TransferLock":false }, { "AutoRenew":false, "DomainName":"example.net", "Expiry":1431539260, "TransferLock":false }, { "AutoRenew":false, "DomainName":"example.org", "Expiry":1431240024, "TransferLock":false }, { "AutoRenew":false, "DomainName":"example.test", "Expiry":1431539259, "TransferLock":false } ] }
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: