ModifySubnetStackType

1. 接口描述

本接口(ModifySubnetStackType)用于修改子网堆栈类型

注意事项

• 当前子网的堆栈类型只能从IPv4切换为IPv4_IPv6。切换后，将得到一个IPv6地址段。

• 注意切换后，操作不可逆。

2. 请求参数

以下请求参数列表仅列出了接口中需要的请求参数

参数名称	必选	类型	描述
subnetId	是	String	要操作的子网的ID。
ipv6Type	是	IPv6Type	IPv6的类型。
stackType	否	SubnetStackType	子网堆栈类型。 目前只支持IPv4_IPv6。 默认值：IPv4_IPv6。
ipv6CidrBlockId	否	String	公网IPv6 CIDR ID。 该字段仅当ipv6Type是公网(Public)时允许指定。 如果不指定，将从系统默认IP池里分配。
ipv6MaskLength	否	Integer	分配给虚拟机（VM）的IPv6 CIDR前缀的大小。 该参数必须与ipv6CidrBlockId参数配合使用。 当未显式传递时，默认值为96。 最小必须大于指定ipv6CidrBlockId的前缀，最大不能超过96。 可选值范围：[-, 96]。

3. 响应结果

参数名称	类型	描述
requestId	String	唯一请求 ID。 每次请求都会返回。定位问题时需要提供该次请求的 requestId。
ipv6CidrBlock	String	分配的IPv6地址段。

4. 代码示例

示例

1. 修改子网的堆栈类型。并指定公网IPv6是内网。

POST /api/v2/zec HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: ModifySubnetStackType
<Common Request Params>

Request：
{
  "subnetId": "XXX",
  "stackType": "IPv4_IPv6",
  "ipv6Type": "Private"
}

Response：
{
  "requestId": "T05992D0C-7E8B-4047-B0C0-780F2CD549D3",
  "response": {
    "requestId": "T05992D0C-7E8B-4047-B0C0-780F2CD549D3",
    "ipv6CidrBlock": "f0xxxx:xx:xxx::/64"
  }
}

5. 开发者工具

Zenlayer Cloud API 2.0 提供了配套的开发工具集（SDK），未来会陆续支持更多开发语言，方便快速接入和使用Zenlayer的产品和服务。

6. 错误码

下面包含业务逻辑中遇到的错误码，其他错误码见公共错误码

HTTP状态码	错误码	说明
400	INVALID_CIDR_BLOCK_STATUS	CIDR地址段状态不合法。
404	INVALID_CIDR_IPV6_NOT_FOUND	IPv6 Cidr不存在
400	INVALID_CIDR_REGION_MISMATCH	子网区域与客户ipv6网段区域不一致。
400	INVALID_MAST_LENGTH	IPv6地址掩码值需大于子网ipv6网段。
404	INVALID_SUBNET_NOT_FOUND	子网不存在。
404	INVALID_VPC_NOT_FOUND	VPC不存在。
404	INVALID_ZONE_NOT_FOUND	可用区不存在。
400	OPERATION_DENIED_NO_AVAILABLE_CIDR	无空余的CIDR地址段。
400	OPERATION_DENIED_REGION_NOT_SUPPORT_PUB_IPV6	指定的区域不支持公网IPV6。
400	OPERATION_DENIED_SUBNET_TYPE_NOT_SUPPORT	子网堆栈类型不支持。
400	OPERATION_DENIED_VPC_NOT_SUPPORT_PRI_IPV6	指定的VPC不支持内网IPV6。