Table Of Contents

Feedback

User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . ec2 ]

associate-vpc-cidr-block

Description

Associates a CIDR block with your VPC. You can associate a secondary IPv4 CIDR block, or you can associate an Amazon-provided IPv6 CIDR block. The IPv6 CIDR block size is fixed at /56.

For more information about associating CIDR blocks with your VPC and applicable restrictions, see VPC and Subnet Sizing in the Amazon Virtual Private Cloud User Guide .

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.

Synopsis

  associate-vpc-cidr-block
[--amazon-provided-ipv6-cidr-block | --no-amazon-provided-ipv6-cidr-block]
[--cidr-block <value>]
--vpc-id <value>
[--ipv6-cidr-block-network-border-group <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]

Options

--amazon-provided-ipv6-cidr-block | --no-amazon-provided-ipv6-cidr-block (boolean)

Requests an Amazon-provided IPv6 CIDR block with a /56 prefix length for the VPC. You cannot specify the range of IPv6 addresses, or the size of the CIDR block.

--cidr-block (string)

An IPv4 CIDR block to associate with the VPC.

--vpc-id (string)

The ID of the VPC.

--ipv6-cidr-block-network-border-group (string)

The name of the location from which we advertise the IPV6 CIDR block. Use this parameter to limit the CiDR block to this location.

You must set AmazonProvidedIpv6CidrBlock to true to use this parameter.

You can have one IPv6 CIDR block association per network border group.

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See 'aws help' for descriptions of global parameters.

Examples

To associate an IPv6 CIDR block with a VPC

This example associates an IPv6 CIDR block with a VPC.

Command:

aws ec2 associate-vpc-cidr-block --amazon-provided-ipv6-cidr-block --vpc-id vpc-a034d6c4

Output:

{
  "Ipv6CidrBlockAssociation": {
      "Ipv6CidrBlockState": {
          "State": "associating"
      },
      "AssociationId": "vpc-cidr-assoc-eca54085"
  },
  "VpcId": "vpc-a034d6c4"
}

To associate an additional IPv4 CIDR block with a VPC

This example associates the IPv4 CIDR block 10.2.0.0/16 with VPC vpc-1a2b3c4d.

Command:

aws ec2 associate-vpc-cidr-block --vpc-id vpc-1a2b3c4d --cidr-block 10.2.0.0/16

Output:

{
  "CidrBlockAssociation": {
      "AssociationId": "vpc-cidr-assoc-2447724d",
      "CidrBlock": "10.2.0.0/16",
      "CidrBlockState": {
          "State": "associating"
      }
  },
  "VpcId": "vpc-1a2b3c4d"
}

Output

Ipv6CidrBlockAssociation -> (structure)

Information about the IPv6 CIDR block association.

AssociationId -> (string)

The association ID for the IPv6 CIDR block.

Ipv6CidrBlock -> (string)

The IPv6 CIDR block.

Ipv6CidrBlockState -> (structure)

Information about the state of the CIDR block.

State -> (string)

The state of the CIDR block.

StatusMessage -> (string)

A message about the status of the CIDR block, if applicable.

NetworkBorderGroup -> (string)

The name of the location from which we advertise the IPV6 CIDR block.

CidrBlockAssociation -> (structure)

Information about the IPv4 CIDR block association.

AssociationId -> (string)

The association ID for the IPv4 CIDR block.

CidrBlock -> (string)

The IPv4 CIDR block.

CidrBlockState -> (structure)

Information about the state of the CIDR block.

State -> (string)

The state of the CIDR block.

StatusMessage -> (string)

A message about the status of the CIDR block, if applicable.

VpcId -> (string)

The ID of the VPC.