Route53Resolver / Client / update_firewall_domains

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