ListReusableDelegationSets
Retrieves a list of the reusable delegation sets that are associated with the current AWS account.
Request Syntax
GET /2013-04-01/delegationset?marker=Marker
&maxitems=MaxItems
HTTP/1.1
URI Request Parameters
The request uses the following URI parameters.
- marker
-
If the value of
IsTruncated
in the previous response wastrue
, you have more reusable delegation sets. To get another group, submit anotherListReusableDelegationSets
request.For the value of
marker
, specify the value ofNextMarker
from the previous response, which is the ID of the first reusable delegation set that Amazon Route 53 will return if you submit another request.If the value of
IsTruncated
in the previous response wasfalse
, there are no more reusable delegation sets to get.Length Constraints: Maximum length of 64.
- maxitems
-
The number of reusable delegation sets that you want Amazon Route 53 to return in the response to this request. If you specify a value greater than 100, Route 53 returns only the first 100 reusable delegation sets.
Request Body
The request does not have a request body.
Response Syntax
HTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<ListReusableDelegationSetsResponse>
<DelegationSets>
<DelegationSet>
<CallerReference>string</CallerReference>
<Id>string</Id>
<NameServers>
<NameServer>string</NameServer>
</NameServers>
</DelegationSet>
</DelegationSets>
<IsTruncated>boolean</IsTruncated>
<Marker>string</Marker>
<MaxItems>string</MaxItems>
<NextMarker>string</NextMarker>
</ListReusableDelegationSetsResponse>
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in XML format by the service.
- ListReusableDelegationSetsResponse
-
Root level tag for the ListReusableDelegationSetsResponse parameters.
Required: Yes
- DelegationSets
-
A complex type that contains one
DelegationSet
element for each reusable delegation set that was created by the current AWS account.Type: Array of DelegationSet objects
- IsTruncated
-
A flag that indicates whether there are more reusable delegation sets to be listed.
Type: Boolean
- Marker
-
For the second and subsequent calls to
ListReusableDelegationSets
,Marker
is the value that you specified for themarker
parameter in the request that produced the current response.Type: String
Length Constraints: Maximum length of 64.
- MaxItems
-
The value that you specified for the
maxitems
parameter in the call toListReusableDelegationSets
that produced the current response.Type: String
- NextMarker
-
If
IsTruncated
istrue
, the value ofNextMarker
identifies the next reusable delegation set that Amazon Route 53 will return if you submit anotherListReusableDelegationSets
request and specify the value ofNextMarker
in themarker
parameter.Type: String
Length Constraints: Maximum length of 64.
Errors
For information about the errors that are common to all actions, see Common Errors.
- InvalidInput
-
The input is not valid.
HTTP Status Code: 400
Examples
Example Request
This example illustrates one usage of ListReusableDelegationSets.
GET /2013-04-01/delegationset?maxitems=2
Example Response
This example illustrates one usage of ListReusableDelegationSets.
HTTP/1.1 200 OK <?xml version="1.0" encoding="UTF-8"?> <ListReusableDelegationSetsResponse xmlns="https://route53.amazonaws.com/doc/2013-04-01/"> <DelegationSets> <DelegationSet> <Id>/delegationset/N1PA6795SAMPLE</Id> <CallerReference>2017-03-15T01:36:41.958Z</CallerReference> <NameServers> <NameServer>ns-2042.awsdns-64.com</NameServer> <NameServer>ns-2043.awsdns-65.net</NameServer> <NameServer>ns-2044.awsdns-66.org</NameServer> <NameServer>ns-2045.awsdns-67.co.uk</NameServer> </NameServers> </DelegationSet> <DelegationSet> <Id>/delegationset/N1PA7000SAMPLE</Id> <CallerReference>2017-03-16T01:37:42.959Z</CallerReference> <NameServers> <NameServer>ns-2046.awsdns-68.com</NameServer> <NameServer>ns-2047.awsdns-69.net</NameServer> <NameServer>ns-2048.awsdns-70.org</NameServer> <NameServer>ns-2049.awsdns-71.co.uk</NameServer> </NameServers> </DelegationSet> </DelegationSets> <IsTruncated>true</IsTruncated> <NextMarker>N1PA6797SAMPLE</NextMarker> <MaxItems>2</MaxItems> </ListReusableDelegationSetsResponse>
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: