调用AllocateVpcIpv6Cidr接口预留指定的IPv6地址段。

使用说明

为VPC分配指定IPv6地址段的流程如下：

1. 调用本接口预留指定的IPv6地址段。

2. 为存量VPC分配指定的IPv6地址段时，请调用AssociateVpcCidrBlock接口，设置RegionId、VpcId、IPv6CidrBlock为指定的IPv6地址段，IpVersion为ipv6；为新建VPC分配指定的IPv6地址段时，请调用CreateVpc接口，设置RegionId、Ipv6CidrBlock为指定的IPv6地址段、EnableIpv6为true。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
RegionId String 是 cn-hangzhou

VPC所在的地域ID。

您可以通过调用DescribeRegions接口获取地域ID。

ClientToken String 否 123e4567-e89b-12d3-a456-426655440000

客户端Token，用于保证请求的幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符。

说明 若您未指定，则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId可能不一样。
Ipv6Isp String 否 BGP

VPC的IPv6地址段类型，取值：

  • BGP（默认值）：阿里云BGP IPv6。
  • ChinaMobile：中国移动（单线）。
  • ChinaUnicom：中国联通（单线）。
  • ChinaTelecom：中国电信（单线）。
说明
  • 如果是开通了单线带宽白名单的用户，该字段可以设置为ChinaTelecom（中国电信）、ChinaUnicom（中国联通）和ChinaMobile（中国移动）。
  • 每种类型的IPv6地址段只能预留一个，只有在分配给VPC后，才可以预留下一个。
Action String 是 AllocateVpcIpv6Cidr

系统规定参数。取值：AllocateVpcIpv6Cidr。

AddressPoolType String 否 custom

IPv6地址池的类型，取值仅为custom，即用户自定义。

说明 该参数必填。
Ipv6CidrBlock String 否 2408:XXXX:0:a600::/56

需要预留的IPv6地址段。

返回数据

名称 类型 示例值 描述
Ipv6CidrBlock String 2408:XXXX:0:a600::/56

预留的IPv6地址段。
RequestId String D20C13EA-2584-53BC-8393-69DE6D98EFF1

请求ID。

示例

请求示例

http(s)://[Endpoint]/?RegionId=cn-hangzhou
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Ipv6Isp=BGP
&Action=AllocateVpcIpv6Cidr
&AddressPoolType=custom
&Ipv6CidrBlock=2408:XXXX:0:a600::/56
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<AllocateVpcIpv6CidrResponse>
    <Ipv6CidrBlock>2408:XXXX:0:a600::/56</Ipv6CidrBlock>
    <RequestId>D20C13EA-2584-53BC-8393-69DE6D98EFF1</RequestId>
</AllocateVpcIpv6CidrResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Ipv6CidrBlock" : "2408:XXXX:0:a600::/56",
  "RequestId" : "D20C13EA-2584-53BC-8393-69DE6D98EFF1"
}

错误码

访问错误中心查看更多错误码。