Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors See Also

ListResourceRecordSetProtections

Lists the resource record set protections in a hosted zone. We recommend using pagination to ensure that the operation returns quickly and successfully.

If the response includes a NextToken element, there are more protections to list. To get the next page of results, submit another request and specify the value of NextToken in the NextToken parameter.

Request Syntax


GET /2013-04-01/hostedzone/Id/rrsetprotection?maxresults=MaxResults&name=StartRecordName&nexttoken=NextToken&type=StartRecordType HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

Id

The ID of the hosted zone that contains the protections that you want to list.

Length Constraints: Maximum length of 32.

Required: Yes

maxresults

The maximum number of protections that you want Route 53 to return in this response. If you don't specify a value, or if you specify a value greater than 300, Route 53 returns up to 300 protections.

name

The first resource record set name that you want Route 53 to list protections for. If you don't specify a value, the list starts with the first protection in the hosted zone.

If you specify NextToken, Route 53 ignores StartRecordName.

Length Constraints: Maximum length of 1024.

nexttoken

If the response to a previous ListResourceRecordSetProtections request included a NextToken element, specify that value here to get the next page of results.

Length Constraints: Maximum length of 1024.

type

The first resource record set type, within the name specified by StartRecordName, that you want Route 53 to list protections for. If you specify StartRecordType, you must also specify StartRecordName.

If you specify NextToken, Route 53 ignores StartRecordType.

Valid Values: SOA | A | TXT | NS | CNAME | MX | NAPTR | PTR | SRV | SPF | AAAA | CAA | DS | TLSA | SSHFP | SVCB | HTTPS

Request Body

The request does not have a request body.

Response Syntax


HTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<ListResourceRecordSetProtectionsResponse>
   <NextToken>string</NextToken>
   <ResourceRecordSetProtections>
      <ResourceRecordSetProtection>
         <Comment>string</Comment>
         <RecordName>string</RecordName>
         <RecordType>string</RecordType>
      </ResourceRecordSetProtection>
   </ResourceRecordSetProtections>
</ListResourceRecordSetProtectionsResponse>

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.

ListResourceRecordSetProtectionsResponse

Root level tag for the ListResourceRecordSetProtectionsResponse parameters.

Required: Yes

NextToken

If there are more protections to list, a token that you can specify in the NextToken parameter of another request to get the next page of results. If there are no more protections to list, the response doesn't include NextToken.

Type: String

Length Constraints: Maximum length of 1024.

ResourceRecordSetProtections

The protections in the hosted zone. The list is empty if the hosted zone has no protections.

Type: Array of ResourceRecordSetProtection objects

Errors

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

InvalidInput

The input is not valid.

message

HTTP Status Code: 400

InvalidPaginationToken

The value that you specified to get the second or subsequent page of results is invalid.

HTTP Status Code: 400

NoSuchHostedZone

No hosted zone exists with the ID that you specified.

message

HTTP Status Code: 404