View a markdown version of this page

DeleteResourceRecordSetProtections - Amazon Route 53

DeleteResourceRecordSetProtections

Deletes one or more resource record set protections from a hosted zone. After a protection is deleted, you can change the resource record sets that have that name and type by using ChangeResourceRecordSets.

The request is atomic. Route 53 either deletes all of the protections in the request or none of them. If one or more entries fail, for example because no protection exists for the specified name and type, Route 53 returns an InvalidResourceRecordSetProtectionBatch error that lists the failing entries and the reason that each one failed.

You can specify up to 100 protections in one request.

Request Syntax

POST /2013-04-01/hostedzone/Id/rrsetprotection/delete HTTP/1.1 <?xml version="1.0" encoding="UTF-8"?> <DeleteResourceRecordSetProtectionsRequest xmlns="https://route53.amazonaws.com/doc/2013-04-01/"> <Protections> <ResourceRecordSetProtectionKey> <RecordName>string</RecordName> <RecordType>string</RecordType> </ResourceRecordSetProtectionKey> </Protections> </DeleteResourceRecordSetProtectionsRequest>

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

Length Constraints: Maximum length of 32.

Required: Yes

Request Body

The request accepts the following data in XML format.

DeleteResourceRecordSetProtectionsRequest

Root level tag for the DeleteResourceRecordSetProtectionsRequest parameters.

Required: Yes

Protections

The name and type of each protection to delete. The list must contain at least one entry and can contain up to 100 entries. Each name and type can appear only once in the list.

Type: Array of ResourceRecordSetProtectionKey objects

Array Members: Minimum number of 1 item.

Required: Yes

Response Syntax

HTTP/1.1 200

Response Elements

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

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

InvalidResourceRecordSetProtectionBatch

One or more entries in the request couldn't be processed, so Route 53 didn't create or delete any of the protections in the request. The Errors element lists the failing entries and the reason that each one failed.

Errors

The entries that failed, with the reason that each one failed.

Message

A message that explains why Route 53 couldn't process the CreateResourceRecordSetProtections or DeleteResourceRecordSetProtections request.

HTTP Status Code: 400

NoSuchHostedZone

No hosted zone exists with the ID that you specified.

message

HTTP Status Code: 404

PriorRequestNotComplete

If Amazon Route 53 can't process a request before the next request arrives, it will reject subsequent requests for the same hosted zone and return an HTTP 400 error (Bad request). If Route 53 returns this error repeatedly for the same request, we recommend that you wait, in intervals of increasing duration, before you try the request again.

HTTP Status Code: 400

See Also

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