接口功能
多个网卡关联IPv6(批量使用)
接口约束
- 该接口无法保证原子性,可能会出现部分网卡更新成功,部分网卡更新失败的情况,这种情况需要调用方进行处理
- 对于同一张网卡,ipv6AddressesCount和ipv6Addresses不能同时传入。
URI
POST /openapi/v4/ports/batch-assign-ipv6
请求参数
请求体Body参数
参数 | 参数类型 | 是否必填 | 说明 | 示例 |
---|---|---|---|---|
clientToken | String | 是 | 客户端存根,用于保证订单幂等性, 长度 1 - 64 | 79fa97e3-c48b-xxxx-9f46-6a13d8163678 |
regionID | String | 是 | 资源池ID | |
data | Array of Objects | 是 | 网卡设置IPv6信息的列表 |
表 data
参数 | 参数类型 | 是否必填 | 说明 | 示例 |
---|---|---|---|---|
networkInterfaceID | String | 是 | port-xx | 网卡ID |
ipv6AddressesCount | Integer | 否 | Ipv6地址数量,新增自动分配地址的IPv6的数量, 与 ipv6Addresses 二选一 | |
ipv6Addresses | Array of String | 否 | IPv6地址列表,新增指定地址的IPv6列表,与 ipv6AddressesCount 二选一 |
响应参数
参数 | 参数类型 | 说明 | 示例 |
---|---|---|---|
statusCode | Integer | 返回状态码(800为成功,900为失败) | 800 |
message | String | statusCode为900时的错误信息; statusCode为800时为success, 英文 | success |
description | String | statusCode为900时的错误信息; statusCode为800时为成功, 中文 | 成功 |
errorCode | String | statusCode为900时为业务细分错误码,三段式:product.module.code; statusCode为800时为SUCCESS | SUCCESS |
请求示例
POST /openapi/v4/ports/batch-assign-ipv6
请求体Body
{
"clientToken": "xxxxxxxxx" ,
"regionID": "100054c0416811e9a6690242ac110002",
"data": [
{
"networkInterfaceID": "port-id1",
"ipv6Addresses": ["xxxxxxx"]
},
{
"networkInterfaceID": "port-id2",
"ipv6AddressesCount": 5
}
]
}
响应示例
{
"statusCode":800,
"errorCode":"SUCCESS",
"message":"success",
"descritption": "成功"
}
状态码
状态码 | 描述 |
---|---|
200 | 表示请求成功。 |
错误码
请参考 错误码说明。