update_firewall_domains

Route53Resolver.Client.update_firewall_domains(**kwargs)

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

See also: AWS API Documentation

Request Syntax

response = client.update_firewall_domains(
    FirewallDomainListId='string',
    Operation='ADD'|'REMOVE'|'REPLACE',
    Domains=[
        'string',
    ]
)
Parameters
  • FirewallDomainListId (string) --

    [REQUIRED]

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

  • Operation (string) --

    [REQUIRED]

    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.
  • Domains (list) --

    [REQUIRED]

    A list of domains to use in the update operation.

    Warning

    There is a limit of 1000 domains per request.

    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.
    • (string) --
Return type

dict

Returns

Response Syntax

{
    'Id': 'string',
    'Name': 'string',
    'Status': 'COMPLETE'|'COMPLETE_IMPORT_FAILED'|'IMPORTING'|'DELETING'|'UPDATING',
    'StatusMessage': 'string'
}

Response Structure

  • (dict) --

    • Id (string) --

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

    • Name (string) --

      The name of the domain list.

    • Status (string) --

      Status of the UpdateFirewallDomains request.

    • StatusMessage (string) --

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

Exceptions

  • Route53Resolver.Client.exceptions.ValidationException
  • Route53Resolver.Client.exceptions.AccessDeniedException
  • Route53Resolver.Client.exceptions.ResourceNotFoundException
  • Route53Resolver.Client.exceptions.LimitExceededException
  • Route53Resolver.Client.exceptions.ConflictException
  • Route53Resolver.Client.exceptions.InternalServiceErrorException
  • Route53Resolver.Client.exceptions.ThrottlingException