UpdateFirewallDomains - Amazon Route 53

UpdateFirewallDomains

Updates the firewall domain list from an array of domain specifications.

Request Syntax

{ "Domains": [ "string" ], "FirewallDomainListId": "string", "Operation": "string" }

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.

Domains

A list of domains to use in the update operation.

Each domain specification in your domain list must satisfy the following requirements:

  • It can optionally start with * (asterisk).

  • With the exception of the optional starting asterisk, it must only contain the following characters: A-Z, a-z, 0-9, - (hyphen).

  • It must be from 1-255 characters in length.

Type: Array of strings

Length Constraints: Minimum length of 1. Maximum length of 255.

Required: Yes

FirewallDomainListId

The ID of the domain list whose domains you want to update.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Required: Yes

Operation

What you want DNS Firewall to do with the domains that you are providing:

  • ADD - Add the domains to the ones that are already in the domain list.

  • REMOVE - Search the domain list for the domains and remove them from the list.

  • REPLACE - Update the domain list to exactly match the list that you are providing.

Type: String

Valid Values: ADD | REMOVE | REPLACE

Required: Yes

Response Syntax

{ "Id": "string", "Name": "string", "Status": "string", "StatusMessage": "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.

Id

The ID of the firewall domain list that DNS Firewall just updated.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Name

The name of the domain list.

Type: String

Length Constraints: Maximum length of 64.

Pattern: (?!^[0-9]+$)([a-zA-Z0-9\-_' ']+)

Status

Type: String

Valid Values: COMPLETE | COMPLETE_IMPORT_FAILED | IMPORTING | DELETING | UPDATING

StatusMessage

Additional information about the status of the list, if available.

Type: String

Length Constraints: Maximum length of 255.

Errors

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

AccessDeniedException

The current account doesn't have the IAM permissions required to perform the specified Resolver operation.

HTTP Status Code: 400

ConflictException

HTTP Status Code: 400

InternalServiceErrorException

We encountered an unknown error. Try again in a few minutes.

HTTP Status Code: 400

LimitExceededException

The request caused one or more limits to be exceeded.

HTTP Status Code: 400

ResourceNotFoundException

The specified resource doesn't exist.

HTTP Status Code: 400

ThrottlingException

The request was throttled. Try again in a few minutes.

HTTP Status Code: 400

ValidationException

HTTP Status Code: 400

See Also

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