Route53GlobalResolver / Client / create_access_source

create_access_source

Route53GlobalResolver.Client.create_access_source(**kwargs)

Creates an access source for a DNS view. Access sources define IP addresses or CIDR ranges that are allowed to send DNS queries to the Route 53 Global Resolver, along with the permitted DNS protocols.

See also: AWS API Documentation

Request Syntax

response = client.create_access_source(
    cidr='string',
    clientToken='string',
    ipAddressType='IPV4'|'IPV6',
    name='string',
    dnsViewId='string',
    protocol='DO53'|'DOH'|'DOT',
    tags={
        'string': 'string'
    }
)
Parameters:

  • cidr (string) –

    [REQUIRED]

    The IP address or CIDR range that is allowed to send DNS queries to the Route 53 Global Resolver.

  • clientToken (string) –

    A unique string that identifies the request and ensures idempotency.

    This field is autopopulated if not provided.

  • ipAddressType (string) – The IP address type for this access source. Valid values are IPv4 and IPv6 (if the Route 53 Global Resolver supports dual-stack).

  • name (string) – A descriptive name for the access source.

  • dnsViewId (string) –

    [REQUIRED]

    The ID of the DNS view to associate with this access source.

  • protocol (string) –

    [REQUIRED]

    The DNS protocol that is permitted for this access source. Valid values are Do53 (DNS over port 53), DoT (DNS over TLS), and DoH (DNS over HTTPS).

  • tags (dict) –

    Tags to associate with the access source.

    • (string) –

      • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'arn': 'string',
    'cidr': 'string',
    'createdAt': datetime(2015, 1, 1),
    'id': 'string',
    'ipAddressType': 'IPV4'|'IPV6',
    'name': 'string',
    'dnsViewId': 'string',
    'protocol': 'DO53'|'DOH'|'DOT',
    'status': 'CREATING'|'OPERATIONAL'|'UPDATING'|'DELETING',
    'updatedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) –

    • arn (string) –

      The Amazon Resource Name (ARN) of the access source.

    • cidr (string) –

      The IP address or CIDR range that is allowed to send DNS queries to the Route 53 Global Resolver.

    • createdAt (datetime) –

      The date and time when the access source was created.

    • id (string) –

      The unique identifier for the access source.

    • ipAddressType (string) –

      The IP address type for this access source (IPv4 or IPv6).

    • name (string) –

      The descriptive name of the access source.

    • dnsViewId (string) –

      The ID of the DNS view associated with this access source.

    • protocol (string) –

      The DNS protocol that is permitted for this access source (Do53, DoT, or DoH).

    • status (string) –

      The operational status of the access source.

    • updatedAt (datetime) –

      The date and time when the access source was last updated.

Exceptions

  • Route53GlobalResolver.Client.exceptions.InternalServerException

  • Route53GlobalResolver.Client.exceptions.ValidationException

  • Route53GlobalResolver.Client.exceptions.ConflictException

  • Route53GlobalResolver.Client.exceptions.ServiceQuotaExceededException

  • Route53GlobalResolver.Client.exceptions.AccessDeniedException

  • Route53GlobalResolver.Client.exceptions.ThrottlingException

  • Route53GlobalResolver.Client.exceptions.ResourceNotFoundException