Creating an IPv6 public address range in the console

To create an IPv6 public address range in the IBM Cloud console, follow these steps:

1. From the IBM Cloud console, select the Navigation menu , then click Infrastructure > Network > Public address ranges.
2. Click Create on the Public address ranges tab, or click Create public address range from the Actions menu next to an authorized CIDR on the IPv6 authorized CIDRs tab.
3. For IP version, select IPv6.
4. Select the Location where you want to create the public address range.
5. In the Details section, complete the following fields:
   • Name: Enter a name for the public address range, or leave blank to auto-generate a name after creation.
   • Resource group: Select a resource group.
   • Tags: Optional: Add tags to help organize your resources.
   • Authorized CIDR: Select the IPv6 authorized CIDR to allocate from. If no authorized CIDR exists for the selected zone, the field shows No CIDR available and the rest of the form is disabled. Click Create authorized CIDR to open the authorized CIDR creation panel without leaving this flow. After the authorized CIDR is created, the Authorized CIDR field is automatically populated with the new CIDR and the form is re-enabled. You can then complete the remaining fields and click Create.
   • Reserving method: Select how the IP range is assigned:
     • Select a range for me: IBM selects an available block of the specified size from the authorized CIDR. Select the Size (prefix length) from the following options: /128 (1 address), /127 (2 addresses), /126 (4 addresses), /120 (256 addresses), /112 (65,536 addresses), /96 (more than 4 billion addresses), or /64 (full authorized CIDR).
     • Let me specify: Enter a specific CIDR block in the IP address range field. The block must fall within the available address space of the selected authorized CIDR.
6. Optional: In the Binding section, select a virtual network interface to bind the range to immediately. You can also bind the range later after creation.
7. Click Create.

The range is created and is displayed in the Public address ranges list alongside any existing IPv4 ranges. IPv6 ranges are identified by their IPv6 CIDR in the IP range column and show VNI in the Target type column. If you selected a VNI, the status shows Bound. If you did not select a VNI, the status shows Unbound.

Creating an IPv6 public address range from the CLI

To create an IPv6 public address range from the command line, follow these steps:

1. Set up your CLI environment.

2. Log in to your CLI environment:

   ibmcloud login --sso
   

3. Run one of the following commands:

   ibmcloud is public-address-range-create
     (--authorized-cidr AUTHORIZED_CIDR --network-prefix-length NETWORK_PREFIX_LENGTH | --cidr CIDR)
     [--name NAME] [--vni VNI]
     [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME]
     [--output JSON] [-q, --quiet]
   

   Where:

   --authorized-cidr

   The ID or name of the IPv6 authorized CIDR to allocate this public address range from. IBM selects an available block of the specified prefix length. Requires --network-prefix-length.

   --network-prefix-length

   The prefix length of the IPv6 block to allocate. Supported values: 64–128. Requires --authorized-cidr.

   --cidr

   An exact IPv6 CIDR block to allocate. Must be an unallocated block within an authorized CIDR in your account. Mutually exclusive with --authorized-cidr.

   --name

   A name for the public address range. Names beginning with ibm- are reserved.

   --vni

   The ID or name of the VNI to bind this range to. The VNI must be in the same zone as the authorized CIDR.

   --resource-group-id

   ID of the resource group. Mutually exclusive with --resource-group-name.

   --resource-group-name

   Name of the resource group. Mutually exclusive with --resource-group-id.

ibmcloud is public-address-range-create --authorized-cidr my-ipv6-auth-cidr --network-prefix-length 112 --name my-ipv6-par --vni my-vni

ibmcloud is public-address-range-create --cidr 2001:db8:85a3::8a2e:0:0/112 --name my-ipv6-par-specific

Creating an IPv6 public address range with the API

Before you begin, set up your API environment.

Select one of the following options:

• Create an IPv6 public address range from an authorized CIDR, bound to a VNI (IBM selects the block):

  curl -sX POST \
  "$vpc_api_endpoint/v1/public_address_ranges?version=$api_version&generation=2" \
  -H "Authorization: Bearer $iam_token" \
  -H "Content-Type: application/json" \
  -d '{
        "name": "my-ipv6-par",
        "authorized_cidr": { "id": "'$authorized_cidr_id'" },
        "network_prefix_length": 112,
        "target": {
           "virtual_network_interface": { "id": "'$vni_id'" }
        }
     }'
  

• Create an IPv6 public address range from a specific CIDR block, unbound:

  curl -sX POST \
  "$vpc_api_endpoint/v1/public_address_ranges?version=$api_version&generation=2" \
  -H "Authorization: Bearer $iam_token" \
  -H "Content-Type: application/json" \
  -d '{
        "name": "my-ipv6-par",
        "cidr": "2001:db8:85a3::8a2e:0:0/112"
     }'
  

Creating an IPv6 public address range with Terraform

To create an IPv6 public address range from an authorized CIDR, bound to a VNI:

resource "ibm_is_public_address_range" "my_ipv6_par" {
  name                  = "my-ipv6-par"
  network_prefix_length = 112
  authorized_cidr {
    id = ibm_is_public_address_range_authorized_cidr.my_ipv6_auth_cidr.id
  }
  target {
    virtual_network_interface {
      id = ibm_is_virtual_network_interface.my_vni.id
    }
  }
}