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 实例的计费方式,取值范围:
  • PrePaid:预付费,即包年包月。此时,您必须确认自己的账号支持余额支付或者信用支付。
  • PostPaid:按量付费。
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 实例的计费方式,取值范围:
  • PrePaid:预付费,即包年包月。此时,您必须确认自己的账号支持余额支付或者信用支付。
  • PostPaid:按量付费。
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 服务异常