Route53 / Client / disassociate_vpc_from_hosted_zone

disassociate_vpc_from_hosted_zone#

Route53.Client.disassociate_vpc_from_hosted_zone(**kwargs)#

Disassociates an Amazon Virtual Private Cloud (Amazon VPC) from an Amazon Route 53 private hosted zone. Note the following:

  • You can’t disassociate the last Amazon VPC from a private hosted zone.

  • You can’t convert a private hosted zone into a public hosted zone.

  • You can submit a DisassociateVPCFromHostedZone request using either the account that created the hosted zone or the account that created the Amazon VPC.

  • Some services, such as Cloud Map and Amazon Elastic File System (Amazon EFS) automatically create hosted zones and associate VPCs with the hosted zones. A service can create a hosted zone using your account or using its own account. You can disassociate a VPC from a hosted zone only if the service created the hosted zone using your account. When you run DisassociateVPCFromHostedZone, if the hosted zone has a value for OwningAccount, you can use DisassociateVPCFromHostedZone. If the hosted zone has a value for OwningService, you can’t use DisassociateVPCFromHostedZone.

Note

When revoking access, the hosted zone and the Amazon VPC must belong to the same partition. A partition is a group of Amazon Web Services Regions. Each Amazon Web Services account is scoped to one partition.

The following are the supported partitions:

  • aws - Amazon Web Services Regions

  • aws-cn - China Regions

  • aws-us-gov - Amazon Web Services GovCloud (US) Region

For more information, see Access Management in the Amazon Web Services General Reference.

See also: AWS API Documentation

Request Syntax

response = client.disassociate_vpc_from_hosted_zone(
    HostedZoneId='string',
    VPC={
        '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',
        'VPCId': 'string'
    },
    Comment='string'
)
Parameters:

  • HostedZoneId (string) –

    [REQUIRED]

    The ID of the private hosted zone that you want to disassociate a VPC from.

  • VPC (dict) –

    [REQUIRED]

    A complex type that contains information about the VPC that you’re disassociating from the specified hosted zone.

    • 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.

  • Comment (string) – Optional: A comment about the disassociation request.

Return type:

dict

Returns:

Response Syntax

{
    'ChangeInfo': {
        'Id': 'string',
        'Status': 'PENDING'|'INSYNC',
        'SubmittedAt': datetime(2015, 1, 1),
        'Comment': 'string'
    }
}

Response Structure

  • (dict) –

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

    • ChangeInfo (dict) –

      A complex type that describes the changes made to the specified private hosted zone.

      • Id (string) –

        This element contains an ID that you use when performing a GetChange action to get detailed information about the change.

      • Status (string) –

        The current state of the request. PENDING indicates that this request has not yet been applied to all Amazon Route 53 DNS servers.

      • SubmittedAt (datetime) –

        The date and time that the change request was submitted in ISO 8601 format and Coordinated Universal Time (UTC). For example, the value 2017-03-27T17:48:16.751Z represents March 27, 2017 at 17:48:16.751 UTC.

      • Comment (string) –

        A comment you can provide.

Exceptions

  • Route53.Client.exceptions.NoSuchHostedZone

  • Route53.Client.exceptions.InvalidVPCId

  • Route53.Client.exceptions.VPCAssociationNotFound

  • Route53.Client.exceptions.LastVPCAssociation

  • Route53.Client.exceptions.InvalidInput