AllocateIpv6Address - 创建IPv6地址_专有网络VPC(VPC)-阿里云帮助中心

调用AllocateIpv6Address接口，分配一个IPv6地址。

调试

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

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
vpc:AllocateIpv6Address	Write	Ipv6Address acs:vpc:{#regionId}:{#accountId}:ipv6address/*	无	无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	地域 ID。	cn-hangzhou
VSwitchId	string	是	IPv6 地址所在的交换机的 ID。	vsw-asdfjlnaue4g****
Ipv6Address	string	否	指定要申请的 IPv6 地址。指定的 IPv6 地址必须是在所属交换机的地址段内的空闲地址。	2408:XXXX:153:3921:851c:c435:7b12:1c5f
Ipv6AddressName	string	否	IPv6 地址的实例名称。	ipv6-name
Ipv6AddressDescription	string	否	IPv6 地址的实例描述。	ipv6-description
ResourceGroupId	string	否	资源组 ID。关于资源组的更多信息，请参见什么是资源组。	rg-bp67acfmxazb4ph****
Tag	object []	否	资源的标签列表。
Key	string	否	资源的标签键。最多支持输入 20 个标签键。如需传入该值，请勿输入空字符串。一个标签键最多支持 128 个字符，不能以`aliyun`和`acs:`开头，不能包含`http://`或者`https://`。	FinanceDept
Value	string	否	资源的标签值。最多支持输入 20 个标签值。如需传入该值，可以输入空字符串。最多支持 128 个字符，不能以 aliyun 和 acs:开头，不能包含 http://或者 https://。	FinanceJoshua
ClientToken	string	否	客户端 Token，用于保证请求的幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。说明若您未指定，则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 不一样。	02fb3da4-130e-11e9-8e44-0016e04****
DryRun	boolean	否	是否只预检此次请求，取值： true：发送检查请求，不会查询资源状况。检查项包括是否填写了必需参数、请求格式、业务限制。如果检查不通过，则返回对应错误。如果检查通过，则返回错误码 DryRunOperation。 false（默认值）：发送正常请求，通过检查后返回 HTTP 2xx 状态码并直接进行操作。	false

返回参数

名称	类型	描述	示例值
	object
Ipv6AddressId	string	IPv6 地址的实例 ID。	ipv6-2zen5j4axcp5l5qyy****
Ipv6Address	string	IPv6 地址。	2408:XXXX:153:3921:851c:c435:7b12:1c5f
ResourceGroupId	string	资源组 ID。	rg-acfmxazdjdhd****
RequestId	string	请求 ID。	54B48E3D-DF70-471B-AA93-08E683A1B45

示例

正常返回示例

JSON格式

{
  "Ipv6AddressId": "ipv6-2zen5j4axcp5l5qyy****",
  "Ipv6Address": "2408:XXXX:153:3921:851c:c435:7b12:1c5f",
  "ResourceGroupId": "rg-acfmxazdjdhd****",
  "RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B45"
}

错误码

HTTP status code	错误码	错误信息	描述
400	OperationFailed.IPv6AddressAlreadyAllocated	The operation is failed because of the ipv6 address specified was allocated.	指定的IPv6地址已被分配
400	OperationFailed.AddressNotInVSwitchCidr	The operation is failed because of %s.	指定的IP地址不在vSwitch的网段内，请按API文档参数说明修改后重试。
400	IllegalParam.IpAddress	The param of %s is illegal.	指定的IP地址格式非法，请按API文档参数说明修改后再重试
400	OperationFailed.IPv6Disabled	Operation failed because IPv6 is not enabled for the vSwitch.	指定操作失败，因为IPv6功能未打开。
404	ResourceNotFound.VSwitch	The specified resource of %s is not found.	指定的vSwitch不存在，请检查您的输入是否正确

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