文档中心

专有网络VPC API参考手册

最近更新时间：2023-04-16 17:00:00

3 子网管理

3.1 CreateSubnet

调用 CreateSubnet 接口创建子网。

3.1.1 使用说明

POST http://{Endpoint}/vpc/v1.0/subnets

子网创建成功后，无法修改网段。

3.1.2 请求参数

3.1.3 返回数据

3.1.4 示例

1. 请求示例

POST http://{Endpoint}/vpc/v1.0/subnets

{

"VpcId": "vpc-exvtmvw***",

"SubnetName": "openapi-subnet",

"Cidr": "192.168.111.0/24",

"GatewayIp": "192.168.111.1",

"DnsDomain": "100.64.0.1,100.64.0.2"

}

2. 正常返回示例

HTTP/1.1 200 OK

Content-Type:application/json

{

"RequestId": "a3f26034147e925c78c8d6d1ed38d***",

"SubnetId": "snet-r5c6mx5***",

"SubnetName": "test-openapi",

"Cidr": "192.168.0.0/24",

"VpcId": "vpc-1bu96bwyrn",

"ZoneId": "",

"TenantId": "210512011001110",

"GatewayIp": "192.168.0.254",

"DnsDomain": [

"100.64.0.1",

"100.64.0.2"

"Ipv6Enable": false，

"Status": "CREATING",

"CreatedAt": "2022-01-06 15:09:53",

"UpdatedAt": "2022-01-06 15:09:55"

}

3.2 DeleteSubnet

调用 DeleteSubnet 接口删除子网。

3.2.1 使用说明

DELETE http://{Endpoint}/vpc/v1.0/subnets/{subnet_id}

调用该接口删除子网时，请注意以下事项：删除子网之前，需要先释放或移走子网内的所有资源。

3.2.2 请求参数

3.2.3 返回数据

3.2.4 示例

1. 请求示例

DELETE http://{Endpoint}/vpc/v1.0/subnets/{subnet_id}

2. 正常返回示例

HTTP/1.1 200 OK

Content-Type:application/json

{

"RequestId" : "c9d0bc5a82ca0bb2c320995cfe31f***"

}

3.3 RenameSubnet

调用 RenameSubnet 接口修改指子网名称。

3.3.1 使用说明

PUT http://{Endpoint}/vpc/v1.0/subnets/{subnet_id}

调用该接口修改子网时，请注意以下事项：不支持修改子网网段。

3.3.2 请求参数

3.3.3 返回数据

3.3.4 示例

1. 请求示例

PUT http://{Endpoint}/vpc/v1.0/subnets/{subnet_id}

{

"SubnetName": "openapi-new"

}

2. 正常返回示例

HTTP/1.1 200 OK

Content-Type:application/json

{

"RequestId": "a3f26034147e925c78c8d6d1ed38d***",

"SubnetId": "snet-r5c6mx5***",

"SubnetName": "new-SubnetName",

"Cidr": "192.168.0.0/24",

"VpcId": "vpc-1bu96bwyrn",

"ZoneId": "",

"TenantId": "210512011001110",

"GatewayIp": "192.168.0.254",

"100.64.0.1",

"100.64.0.2"

"Ipv6Enable": false，

"Status": "RUNNING",

"CreatedAt": "2022-01-06 15:09:53",

"UpdatedAt": "2022-01-06 15:09:55"

}

3.4 GetSubnetDetail

调用 GetSubnetDetail 接口获取单个子网详情。

3.4.1 使用说明

GET http://{Endpoint}/vpc/v1.0/subnets/{subnet_id}

3.4.2 请求参数

3.4.3 返回数据

3.4.4 示例

1. 请求示例

GET http://{Endpoint}/vpc/v1.0/subnets/{subnet_id}

2. 正常返回示例

HTTP/1.1 200 OK

Content-Type:application/json

{

"RequestId": "a3f26034147e925c78c8d6d1ed38d***",

"SubnetId": "snet-r5c6mx5***",

"SubnetName": "test-openapi",

"Cidr": "192.168.0.0/24",

"VpcId": "vpc-1bu96bwyrn",

"ZoneId": "",

"TenantId": "210512011001110",

"GatewayIp": "192.168.0.254",

"DnsDomain": [

"100.64.0.1",

"100.64.0.2"

"Ipv6Enable": false，

"Status": "RUNNING",

"CreatedAt": "2022-01-06 15:09:53",

"UpdatedAt": "2022-01-06 15:09:55"

}

3.5 GetSubnetList

调用 GetSubnetList 接口获取子网列表信息。

3.5.1 使用说明

GET http://{Endpoint}/vpc/v1.0/subnets?PageNumber=1&PageSize=10&Status=0

3.5.2 请求参数

3.5.3 返回数据

3.5.4 示例

1. 请求示例（多个过滤参数使用&连接）

GET http://{Endpoint}/vpc/v1.0/subnets?PageNumber=1&PageSize=10&Status=0

2. 正常返回示例

{

"PageNumber": 1,

"PageSize": 10,

"RequestId": "ea839240ea735d7e7142010433b1a***",

"Subnets": [

{

"SubnetId": "snet-6aqdgio***",

"SubnetName": "acl-2",

"Cidr": "192.168.66.0/24",

"VpcId": "vpc-9nwqv7w***",

"ZoneId": "可用区 01",

"TenantId": "210512011001110",

"GatewayIp": "192.168.66.254",

"DnsDomain": [

"100.64.0.1",

"100.64.0.2"

"Ipv6Enable": false，

"Status": "RUNNING"

{

"SubnetId": "snet-bgpgupj***",

"SubnetName": "acl-1",

"Cidr": "192.168.88.0/24",

"VpcId": "vpc-9nwqv7w***",

"ZoneId": "可用区 01",

"TenantId": "210512011001110",

"GatewayIp": "192.168.88.254",

"DnsDomain": [

"100.64.0.1",

"100.64.0.2"

"Ipv6Enable": false，

"Status": "RUNNING"

}

"TotalCount": 2

}

3.6 错误码

意见反馈

文档内容是否对您有帮助？

如您有其他疑问，您也可以通过在线客服来与我们联系探讨在线客服