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 服务异常