eipv6说明
IPv6是Internet Protocol Version 6的缩写,其中Internet Protocol译为“互联网协议”。IPv6是IETF(互联网工程任务组,Internet Engineering Task Force)设计的用于替代现行版本IP协议(IPv4)的下一代IP协议,IPv6将IPv4中32位的地址长度扩展到了128位,使用IPv6,可以让全世界的每一粒沙子都能分配到一个IP地址。
IPv6转换服务相关接口
1. CreateEipv6
创建eipv6实例,创建eipv6有两种方式,一是选择已有的eip,二是eip和eipv6同时创建。 (目前创建的Eipv6只能是按需的方式。)
请求方式:POST
请求参数
名称 | 位置 | 类型 | 是否必须 | 描述 |
---|---|---|---|---|
Action | path | String | 是 | CreateIpts |
eipId | path | String | 是 | Eip的Id |
Bandwidth | path | String | 是 | EIP带宽大小 |
BillType | path | String | 是 | 计费方式---1.monthly:按月; 2.hourlySettlement:按小时实时结算(即按需)。 |
返回参数
名称 | 位置 | 类型 | 是否必须 | 描述 |
---|---|---|---|---|
eipv6Id | body | String | 是 | ipv6的Id |
ipv6 | body | String | 是 | ipv6地址 |
status | body | String | 是 | ipv6的状态 |
createdTime | body | Date | 是 | ipv6的创建时间 |
ipv4 | body | String | 是 | eip的地址 |
示例
创建一条eipv6(使用已有的EIP)
请求示例
URL:
https://eip.cn-north-3.inspurcloudapi.com/?Action=CreateIpts&EipId=c5af6a5b-538a-4cc2-83ca-a2f1014f2d04&Nonce=623566&Timestamp=1655717904&Version=2019-01-31
响应示例
<CreateIptsResponse>
<CreateTime>2019-12-30T14:59:40Z</CreateTime>
<RequestId>7667a95f-7a93-4a71-a2b4-1343008e03b1</RequestId>
<Eipv6Id>e7f82663-8f7a-4aee-84a9-386f60e2348a</Eipv6Id>
<Ipv4>117.73.8.165</Ipv4>
<Status>ACTIVE</Status>
<Ipv6>2001:da8:20d:40e9::68</Ipv6>
</CreateIptsResponse>
示例
创建一条eipv6(创建新的EIP)
请求示例
URL:
https://eip.cn-north-3.inspurcloudapi.com/?Action=CreateIptsBindEip&Bandwidth=2&Nonce=6266556&Timestamp=1655717904&BillType=hourlySettlement&Version=2019-01-31
响应示例
<CreateIptsBindEipResponse>
<OrderId>269837843686957056</OrderId>
<RequestId>e70d554d-683d-4aed-a92b-811618ce0928</RequestId>
</CreateIptsBindEipResponse>
错误码
以下为本接口特有的错误码。
错误代码 | 错误信息 | Http状态码 | 描述 |
---|---|---|---|
106.999400 | SC_PARAM_ERROR | 400 | 请求参数错误 |
106.993400 | SC_RESOURCE_NOTENOUGH | 400 | 找不到资源 |
106.999500 | SC_INTERNAL_SERVER_ERROR | 500 | 内部服务错误 |
2. Delete Eipv6
URI
第三方调用,释放EIP实例。 请求方式:DELETE
请求参数
名称 | 位置 | 类型 | 是否必须 | 描述 |
---|---|---|---|---|
Action | path | String | 是 | DeleteIpts |
eipv6Id | path | String | 是 | ipv6的Id |
返回参数
返回参数
名称 | 位置 | 类型 | 描述 |
---|---|---|---|
code | body | String | 返回码(错误时返回相应错误码)。 |
message | body | String | 返回信息 有效值:成功 或 失败。 |
示例
删除一条Eipv6
请求示例
https://eip.cn-north-3.inspurcloudapi.com/?Action=DeleteIpts&Eipv6Id=4599f9dd-594d-480a-a998-f99efd3ba23e&Nonce=920212&Timestamp=1655717904&Version=2019-01-31
响应示例
<DeleteIptsResponse>
<RequestId>c5ae604b-0863-4c2d-8d20-00dcac8eee72</RequestId>
</DeleteIptsResponse>
错误码
以下为本接口特有的错误码。
错误代码 | 错误信息 | Http状态码 | 描述 |
---|---|---|---|
106.999400 | SC_PARAM_ERROR | 400 | 请求错误 |
106.999500 | SC_INTERNAL_SERVER_ERROR | 500 | 系统内部错误 |
3. Get Eipv6 List
查询当前用户下所有eipv6信息
请求方式:GET
请求参数
名称 | 位置 | 类型 | 是否必须 | 描述 |
---|---|---|---|---|
Action | path | String | 是 | ListEipv6 |
pageNo | path | String | 是 | 当前页 |
pageSize | path | String | 是 | 每页记录条数 |
返回参数
名称 | 位置 | 类型 | 是否必须 | 描述 |
---|---|---|---|---|
eipv6Id | body | String | 是 | eipv6的id。 |
ipv6 | body | String | 是 | ipv6地址 |
status | body | String | 是 | ipv6的状态。 |
ipv4 | body | String | 是 | 弹性公网IP地址。 |
eipv6Bandwidth | body | Int | 是 | ipv6的带宽值 |
eipBillType | body | String | 是 | 实例的计费方式,取值范围:
|
eipBandwidth | body | Int | 是 | 弹性公网IP带宽大小(Mbps) |
region | body | String | 是 | 地区 |
createTime | body | Date | 是 | 创建时间 |
eipId | boby | String | 是 | 弹性公网IP的id |
pageNo | body | Integer | 是 | 页数 |
pageSize | body | Integer | 是 | 每页大小(个数) |
totalCount | body | Integer | 是 | 总个数 |
示例
查询所有eipv6信息
请求示例
https://eip.cn-north-3.inspurcloudapi.com/?Action=ListEipv6&PageNo=1&PageSize=20&Nonce=92022&Timestamp=1655717904&Version=2019-01-31
响应示例
<ListEipv6Response>
<TotalCount>1</TotalCount>
<PageSize>20</PageSize>
<PageNo>1</PageNo>
<Data>
<CreateTime>2019-12-30T17:14:39Z</CreateTime>
<EipBandwidth>1</EipBandwidth>
<Id>b362d8bc-08ff-4e5c-a5a2-ddc655fde85d</Id>
<EipBillType>hourlySettlement</EipBillType>
<Status>ACTIVE</Status>
<EipId>2c44096b-5338-43f1-abe0-13c3ccc1df68</EipId>
<Eipv6Bandwidth>1</Eipv6Bandwidth>
<Ipv4>117.73.11.207</Ipv4>
<Region>cn-north-3</Region>
<Ipv6>2001:da8:20d:40e9::70</Ipv6>
</Data>
<RequestId>12a10444-b5f6-464a-8cdf-baa31dda2f69</RequestId>
</ListEipv6Response>
错误码
以下为本接口特有的错误码。
错误代码 | 错误信息 | Http状态码 | 描述 |
---|---|---|---|
106.001403 | SC_FORBIDDEN | 401 | 认证失败 |
106.999500 | SC_INTERNAL_SERVER_ERROR | 500 | 内部服务错误 |
106.999400 | SC_PARAM_ERROR | 400 | 请求错误 |
4. Get Eipv6
查询当前用户下eipv6详情
请求方式:GET
请求参数
名称 | 位置 | 类型 | 是否必须 | 描述 |
---|---|---|---|---|
Action | path | String | 是 | GetIpv6Details |
eipv6Id | path | String | 是 | eipv6的Id |
返回参数
名称 | 位置 | 类型 | 是否必须 | 描述 |
---|---|---|---|---|
eipv6Id | body | String | 是 | eipv6的id。 |
ipv6 | body | String | 是 | ipv6地址 |
status | body | String | 是 | ipv6的状态。 |
ipv4 | body | String | 是 | 弹性公网IP地址。 |
eipv6Bandwidth | body | Int | 是 | ipv6的带宽值 |
eipBillType | body | String | 是 | 实例的计费方式,取值范围:
|
eipBandwidth | body | Int | 是 | 弹性公网IP带宽大小(Mbps) |
region | body | String | 是 | 地区 |
createTime | body | Date | 是 | 创建时间 |
eipId | boby | String | 是 | 弹性公网IP的id |
示例
显示单个eipv6的相关信息
请求示例
https://eip.cn-north-3.inspurcloudapi.com/?Action=GetIpv6Details&Eipv6Id=6e899b0d-6d30-4daf-8601-c5d5ddb99059&Nonce=92021&Timestamp=1655717904&Version=2019-01-31
响应示例
<GetIpv6DetailsResponse>
<CreateTime>2019-12-30T17:14:39Z</CreateTime>
<EipBandwidth>1</EipBandwidth>
<Id>b362d8bc-08ff-4e5c-a5a2-ddc655fde85d</Id>
<EipBillType>hourlySettlement</EipBillType>
<Status>ACTIVE</Status>
<EipId>2c44096b-5338-43f1-abe0-13c3ccc1df68</EipId>
<RequestId>7be2ce30-0a3c-4687-84a5-aaf2eab9b6bc</RequestId>
<Eipv6Bandwidth>0</Eipv6Bandwidth>
<Ipv4>117.73.11.207</Ipv4>
<Region>cn-north-3</Region>
<Ipv6>2001:da8:20d:40e9::70</Ipv6>
</GetIpv6DetailsResponse>
错误码
以下为本接口特有的错误码。
错误代码 | 错误信息 | Http状态码 | 描述 |
---|---|---|---|
106.202404 | SC_NOT_FOUND | 404 | 找不到资源 |
106.999500 | SC_INTERNAL_SERVER_ERROR | 500 | 内部服务异常 |
5. Update Eipv6
修改eipv6映射的eip地址
请求方式:PUT
请求参数
名称 | 位置 | 类型 | 是否必须 | 描述 |
---|---|---|---|---|
Action | path | String | 是 | UpdateEipv6Ip |
eipAddress | body | String | 是 | eip地址 |
eipv6Id | path | String | 是 | eipv6的Id |
返回参数
名称 | 位置 | 类型 | 描述 |
---|---|---|---|
code | body | String | 返回码(错误时返回相应错误码)。 |
message | body | String | 返回信息 有效值:成功 或 失败。 |
示例
更换eip地址
请求示例
https://eip.cn-north-3.inspurcloudapi.com/?Action=UpdateEipv6Ip&Eipv6Id=6e899b0d-6d30-4daf-8601-c5d5ddb99059&Nonce=92021&Timestamp=1655717904&Version=2019-01-31&eipAddress=10.110.38.36
响应示例
<UpdateEipv6IpResponse>
<RequestId>08e16f30-2274-4be6-b3ad-b4fcdcc18d53</RequestId>
<Code>200</Code>
<Message>Ipv4 was replaced successfully</Message>
</UpdateEipv6IpResponse>
错误码
以下为本接口特有的错误码。
错误代码 | 错误信息 | Http状态码 | 描述 |
---|---|---|---|
106.994404 | SC_NOT_FOUND | 404 | 没有发现此数据 |
106.999400 | SC_PARAM_ERROR | 400 | 参数错误 |
106.202404 | SC_FIREWALL_NAT_UNAVAILABLE | 404 | 防火墙nat错误 |
106.999500 | SC_INTERNAL_SERVER_ERROR | 500 | 服务异常 |