Menu
Amazon Elastic Compute Cloud
API Reference (API Version 2016-11-15)

DisassociateVpcCidrBlock

Disassociates a CIDR block from a VPC. To disassociate the CIDR block, you must specify its association ID. You can get the association ID by using DescribeVpcs. You must detach or delete all gateways and resources that are associated with the CIDR block before you can disassociate it.

You cannot disassociate the CIDR block with which you originally created the VPC (the primary CIDR block).

Request Parameters

For more information about required and optional parameters that are common to all actions, see Common Query Parameters.

AssociationId

The association ID for the CIDR block.

Type: String

Required: Yes

Response Elements

The following elements are returned by the service.

cidrBlockAssociation

Information about the IPv4 CIDR block association.

Type: VpcCidrBlockAssociation object

ipv6CidrBlockAssociation

Information about the IPv6 CIDR block association.

Type: VpcIpv6CidrBlockAssociation object

requestId

The ID of the request.

Type: String

vpcId

The ID of the VPC.

Type: String

Errors

For information about the errors that are common to all actions, see Common Client Errors.

Example

Example

This example disassociates the IPv6 CIDR block from the VPC.

Sample Request

https://ec2.amazonaws.com/?Action=DisassociateVpcCidrBlock
&AssociationId=vpc-cidr-assoc-e2a5408b
&AUTHPARAMS

Sample Response

<DisassociateVpcCidrBlockResponse xmlns="http://ec2.amazonaws.com/doc/2016-11-15/">
    <ipv6CidrBlockAssociation>
        <ipv6CidrBlock>2001:db8:1234:1a00::/56</ipv6CidrBlock>
        <ipv6CidrBlockState>
            <state>disassociating</state>
        </ipv6CidrBlockState>
        <associationId>vpc-cidr-assoc-e2a5408b</associationId>
    </ipv6CidrBlockAssociation>
    <vpcId>vpc-a034d6c4</vpcId>
</DisassociateVpcCidrBlockResponse>

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: