Route53 / Client / list_vpc_association_authorizations

list_vpc_association_authorizations#

Route53.Client.list_vpc_association_authorizations(**kwargs)#

Gets a list of the VPCs that were created by other accounts and that can be associated with a specified hosted zone because you’ve submitted one or more CreateVPCAssociationAuthorization requests.

The response includes a VPCs element with a VPC child element for each VPC that can be associated with the hosted zone.

See also: AWS API Documentation

Request Syntax

response = client.list_vpc_association_authorizations(
    HostedZoneId='string',
    NextToken='string',
    MaxResults='string'
)
Parameters:

  • HostedZoneId (string) –

    [REQUIRED]

    The ID of the hosted zone for which you want a list of VPCs that can be associated with the hosted zone.

  • NextToken (string) – Optional: If a response includes a NextToken element, there are more VPCs that can be associated with the specified hosted zone. To get the next page of results, submit another request, and include the value of NextToken from the response in the nexttoken parameter in another ListVPCAssociationAuthorizations request.

  • MaxResults (string) – Optional: An integer that specifies the maximum number of VPCs that you want Amazon Route 53 to return. If you don’t specify a value for MaxResults, Route 53 returns up to 50 VPCs per page.

Return type:

dict

Returns:

Response Syntax

{
    'HostedZoneId': 'string',
    'NextToken': 'string',
    'VPCs': [
        {
            'VPCRegion': 'us-east-1'|'us-east-2'|'us-west-1'|'us-west-2'|'eu-west-1'|'eu-west-2'|'eu-west-3'|'eu-central-1'|'eu-central-2'|'ap-east-1'|'me-south-1'|'us-gov-west-1'|'us-gov-east-1'|'us-iso-east-1'|'us-iso-west-1'|'us-isob-east-1'|'me-central-1'|'ap-southeast-1'|'ap-southeast-2'|'ap-southeast-3'|'ap-south-1'|'ap-south-2'|'ap-northeast-1'|'ap-northeast-2'|'ap-northeast-3'|'eu-north-1'|'sa-east-1'|'ca-central-1'|'cn-north-1'|'af-south-1'|'eu-south-1'|'eu-south-2'|'ap-southeast-4'|'il-central-1'|'ca-west-1'|'ap-southeast-5',
            'VPCId': 'string'
        },
    ]
}

Response Structure

  • (dict) –

    A complex type that contains the response information for the request.

    • HostedZoneId (string) –

      The ID of the hosted zone that you can associate the listed VPCs with.

    • NextToken (string) –

      When the response includes a NextToken element, there are more VPCs that can be associated with the specified hosted zone. To get the next page of VPCs, submit another ListVPCAssociationAuthorizations request, and include the value of the NextToken element from the response in the nexttoken request parameter.

    • VPCs (list) –

      The list of VPCs that are authorized to be associated with the specified hosted zone.

      • (dict) –

        (Private hosted zones only) A complex type that contains information about an Amazon VPC.

        If you associate a private hosted zone with an Amazon VPC when you make a CreateHostedZone request, the following parameters are also required.

        • VPCRegion (string) –

          (Private hosted zones only) The region that an Amazon VPC was created in.

        • VPCId (string) –

          (Private hosted zones only) The ID of an Amazon VPC.

Exceptions

  • Route53.Client.exceptions.NoSuchHostedZone

  • Route53.Client.exceptions.InvalidInput

  • Route53.Client.exceptions.InvalidPaginationToken