EIP说明

弹性公网IP是可以独立购买和持有的公网IP地址资源，可以动态的与云服务器、云路由器以及负载均衡器绑定，使其与互联网相连接。绑定和解绑弹性公网IP时无需停机。 云服务器和负载均衡器允许绑定多个公网IP。云路由器仅可绑定一个公网IP，为云路由器及挂载在云路由器上的子网提供互联网接入。

EIP相关接口

1. CreateEIP

创建EIP实例，创建弹性IP的计费模式有两种，一种是包年包月（预付费），一种是按需计费（后付费），其中按需计费又有三种计费方式：按带宽和按共享带宽，以及按流量计费（后付费）。模式为：异步。

请求方式：GET

请求参数

名称 类型 是否必须 描述
Action String 是 CreateEip
Bandwidth Integer 是 EIP带宽大小
BillType String 是 计费方式---1.monthly：按月; 2.hourlySettlement：按小时实时结算（即按需）;3.hourlyNetflow：按流量按需计费，根据流量实际使用量收费，单位是GB。账户余额不能小于100元。。
Duration String 否 购买时长---BillType为monthly时必传。
Iptype String 否 线路类型---默认BGP，当需要选择其他线路时，可修改成其他线路参数。

返回参数

名称 位置 类型 描述
code body String 返回码（错误时返回相应错误码）。
message body String 返回信息 有效值：成功 或 失败。
result body String 返回结果

示例

创建一条EIP(按需计费)

请求示例

URL：

https://eip.cn-north-3.inspurcloudapi.com/?Action=CreateEip&Bandwidth=2&BillType=hourlySettlement&Nonce=6213&Timestamp=1555717904&Version=2019-01-31

响应示例

<CreateEipResponse>
    <OrderId>263968250519035904</OrderId>
    <RequestId>8cf7779d-2e64-48a2-8a8d-9e5a80edbce9</RequestId>
</CreateEipResponse>

错误码

以下为本接口特有的错误码。

错误代码 错误信息 Http状态码
106.999400 SC_PARAM_ERROR 400
106.102503 SC_OPENSTACK_FIPCREATE_ERROR 500
106.999500 SC_INTERNAL_SERVER_ERROR 500

示例

创建一条EIP(包年包月计费)

请求示例

URL：

https://eip.cn-north-3.inspurcloudapi.com/?Action=CreateEip&Bandwidth=2&BillType=monthly&Nonce=625&Timestamp=1555717904&Version=2019-01-31&Duration=1

响应示例

<CreateEipResponse>
    <OrderId>263912250519035904</OrderId>
    <RequestId>8cf77793-2e64-48a2-8a8d-9e5a80edbce9</RequestId>
</CreateEipResponse>

错误码

以下为本接口特有的错误码。

错误代码 错误信息 Http状态码
106.999400 SC_PARAM_ERROR 400
106.102503 SC_OPENSTACK_FIPCREATE_ERROR 500
106.999500 SC_INTERNAL_SERVER_ERROR 500

2. DeleteEip

第三方调用，释放EIP实例。 请求方式：GET

请求参数

名称 类型 是否必须 描述
Action String 是 DeleteEip
EipId String 是 EIPUUID

返回参数

名称 位置 类型 描述
code body String 返回码（错误时返回相应错误码）。
message body String 返回信息 有效值：成功 或 失败。
result body String 返回结果

示例

删除一条Eip

请求示例

https://eip.cn-north-3.inspurcloudapi.com/?Action=DeleteEip&EipId=a3c9a4f3-7d0b-4a2c-93aa-600437f36ecc&Nonce=21631&Timestamp=1555717904&Version=2019-01-31

响应示例

<DeleteEipResponse>
    <OrderId>263238250519035904</OrderId>
    <RequestId>8ce7779d-2e64-48a2-8a8d-9e5a80edbce9</RequestId>
</DeleteEipResponse>

错误码

以下为本接口特有的错误码。

错误代码 错误信息 Http状态码
106.994400 SC_PARAM_UNKONWERROR 400
106.999500 SC_INTERNAL_SERVER_ERROR 500

3. Bind EIP

将一条EIP绑定到一台ECS服务器上。

请求方式：GET

请求参数

名称 类型 是否必须 描述
Action String 是 BindEip
EipId String 是 EIP的Id
PortId String 是 绑定服务器的端口的Id
ServerId String 是 绑定服务器的Id
Type String 是 用来区分EIP绑定的是云服务器，云物理机，负载均衡（1.云服务器.2.云物理机.3.负载均衡）

返回参数

名称 位置 类型 描述
code body String 返回码（错误时返回相应错误码）。
message body String 返回信息 有效值：成功 或 失败。
result body String 返回结果

示例

一条EIP绑定到一台ECS服务器上。

请求示例

https://eip.cn-north-3.inspurcloudapi.com/?Action=BindEip&EipId=616b3c47-8e57-43e1-bb01-b78ee61db540&PortId=65ad697d-aad0-460d-b332-02650be2d730&ServerId=1f1305f4-034f-4a03-8fe1-12f1c0c986bb&Type=1&Nonce=221332&Timestamp=1555717904&Version=2019-01-31

响应示例

<BindEipResponse>
    <RequestId>34f700eb-6bfa-4833-9f07-515e39b1b5cf</RequestId>
    <Code>200</Code>
    <Message>success</Message>
</BindEipResponse>

错误码

以下为本接口特有的错误码。

错误代码 错误信息 Http状态码
006.999400 SC_PARAM_ERROR 400
006.999500 SC_INTERNAL_SERVER_ERROR 500
006.994404 SC_NOT_FOUND 404
006.991400 EIP_BIND_HAS_BAND 400
006.101503 SC_OPENSTACK_SERVER_ERROR 500

4. Unbind EIP

将一条EIP与一台ECS服务器解绑。

请求方式：GET

请求参数

名称 类型 是否必须 描述
Action String 是 UnbindEip
EipId String 是 EIP的Id
PortId String 否 绑定服务器的端口的Id
ServerId String 否 绑定服务器的Id
Type String 否 表示绑的是云服务器

返回参数

名称 位置 类型 描述
code body String 返回码（错误时返回相应错误码）。
message body String 返回信息 有效值：成功 或 失败。
result body String 返回结果

示例

一条EIP与一台ECS服务器解绑。

请求示例

https://eip.cn-north-3.inspurcloudapi.com/?Action=UnbindEip&EipId=616b3c47-8e57-43e1-bb01-b78ee61db540&PortId=&ServerId=&Type=&Nonce=2212&Timestamp=1555717904&Version=2019-01-31

响应示例


<UnbindEipResponse>
    <RequestId>34f732qw-6bfa-4833-9f07-515e39b1b5cf</RequestId>
    <Code>200</Code>
    <Message>success</Message>
</UnbindEipResponse>

错误码

以下为本接口特有的错误码。

错误代码 错误信息 Http状态码
106.101503 SC_OPENSTACK_SERVER_ERROR 400
106.994400 SC_RESOURCE_ERROR 500
106.999400 SC_PARAM_ERROR 500
106.994404 SC_NOT_FOUND 500
106.999500 SC_INTERNAL_SERVER_ERROR 500

5. Update the Eip bindwidth

当业务量发生变动需要变更带宽时，可以在线调带宽，支持增大和减小带宽。 注意：按需eip的带宽可调大或调小，包年包月的带宽只能调大

请求方式：GET

请求参数

名称 类型 是否必须 描述
Action String 是 UpdateBindWidth
EipId String 是 EIP的Id
NewBandwidth String 是 升级的EIP的带宽

返回参数

名称 位置 类型 描述
code body String 返回码（错误时返回相应错误码）。
message body String 返回信息 有效值：成功 或 失败。
result body String 返回结果

示例

更新一条EIP的带宽(按需计费)。

请求示例

https://eip.cn-north-3.inspurcloudapi.com/?Action=UpdateBindWidth&EipId=c9254416-b96c-4ae1-b781-41b7e105bae5&NewBandwidth=9&Nonce=2116&Timestamp=1555717904&Version=2019-01-31

响应示例

<UpdateBindWidthResponse>
    <OrderId>263977913125904384</OrderId>
    <RequestId>b5cdc464-ec54-48e0-8840-e89ce4b0f5b9</RequestId>
</UpdateBindWidthResponse>

错误码

以下为本接口特有的错误码。

错误代码 错误信息 Http状态码
106.994404 SC_NOT_FOUND 404
106.999400 SC_PARAM_ERROR 400
106.201503 SC_FIREWALL_SERVER_ERROR 500
106.999500 SC_INTERNAL_SERVER_ERROR 500

示例

更新一条EIP的带宽(包年包月计费)。

请求示例

https://eip.cn-north-3.inspurcloudapi.com/?Action=UpdateBindWidth&EipId=d8932410-ab8f-41b3-908f-d2fd9d6cb83c&NewBandwidth=5&Nonce=21165&Timestamp=1555717904&Version=2019-01-31

响应示例

<UpdateBindWidthResponse>
    <OrderId>263977913125904384</OrderId>
    <RequestId>b5cdc464-ec54-48e0-8840-e89ce4b0f5b9</RequestId>
</UpdateBindWidthResponse>

错误码

以下为本接口特有的错误码。

错误代码 错误信息 Http状态码
106.994404 SC_NOT_FOUND 404
106.999400 SC_PARAM_ERROR 400
106.201503 SC_FIREWALL_SERVER_ERROR 500
106.999500 SC_INTERNAL_SERVER_ERROR 500

6. List Eips

查询所有EIP信息

请求方式：GET

请求参数

名称 类型 是否必须 描述
Action String 是 ListEip
CurrentPage String 是 当前页
Limit String 是 每页记录条数

返回参数

名称 位置 类型 描述
code body String 返回码（错误时返回相应错误码）。
message body String 返回信息 有效值：成功 或 失败。
result body String 返回结果

示例

查询所有EIP信息

请求示例

https://eip.cn-north-3.inspurcloudapi.com/?Action=ListEip&CurrentPage=1&Limit=20&Nonce=921&Timestamp=1555717904&Version=2019-01-31

响应示例

<ListEipResponse>
    <TotalCount>29</TotalCount>
    <PageSize>1</PageSize>
    <PageNo>10</PageNo>
    <Data>
        <OldBandwidth>50</OldBandwidth>
        <Region>cn-north-3</Region>
        <Status>ACTIVE</Status>
        <CreatedTime>2019-07-19T14:04:00Z</CreatedTime>
        <PortId>f3bc9f8a-c2d2-4c9f-b82d-24f8abe259df</PortId>
        <IpType>BGP</IpType>
        <ResourceSet>
            <ResourceType>1</ResourceType>
            <ResourceId>d9b7e594-2944-4d4c-8dd7-a7c44abf5073</ResourceId>
        </ResourceSet>
        <EipId>f04fe4f3-1494-4ef6-bdd1-c7f9883c7abd</EipId>
        <PrivateIpAddress>192.168.0.11</PrivateIpAddress>
        <BillType>hourlySettlement</BillType>
        <SbwId>e7fac86b-72f6-4234-890b-097b64cf4ed4</SbwId>
        <Bandwidth>6</Bandwidth>
        <Duration>1</Duration>
        <ChargeMode>SharedBandwidth</ChargeMode>
        <EipAddress>117.73.10.66</EipAddress>
    </Data>
    <RequestId>29b49433-7102-483f-a45e-e56222f04790</RequestId>
</ListEipResponse>

错误码

以下为本接口特有的错误码。

错误代码 错误信息 Http状态码
106.001403 SC_FORBIDDEN 401
106.999500 SC_INTERNAL_SERVER_ERROR 500
106.999400 SC_PARAM_ERROR 400

7. Show a EIP details

查询单个EIP信息

请求方式：GET

请求参数

名称 类型 是否必须 描述
Action String 是 GetEip
EipId String 是 EIPUUID

返回参数

名称 位置 类型 描述
code body String 返回码（错误时返回相应错误码）。
message body String 返回信息 有效值：成功 或 失败。
result body String 返回结果

示例

显示单个Eip的相关信息

请求示例

https://eip.cn-north-3.inspurcloudapi.com/?Action=GetEip&EipId=5676dd4a-923b-4460-9ef3-2fe328c82a1f&Nonce=541&Timestamp=1555717904&Version=2019-01-31

响应示例

{
<GetEipResponse>
    <OldBandwidth>1</OldBandwidth>
    <Region>cn-north-3</Region>
    <IpType>BGP</IpType>
    <RequestId>970b6ffb-a131-4892-ac67-cba4c28042fd</RequestId>
    <EipId>5cffba97-8731-40a8-862c-406068bed789</EipId>
    <CreatedTime>2019-11-25T15:39:25Z</CreatedTime>
    <BillType>monthly</BillType>
    <Status>DOWN</Status>
    <Bandwidth>3</Bandwidth>
    <ResourceSet>
        <ResourceType>null</ResourceType>
        <ResourceId>null</ResourceId>
    </ResourceSet>
    <ChargeMode>Bandwidth</ChargeMode>
    <EipAddress>117.73.3.156</EipAddress>
</GetEipResponse>

错误码

以下为本接口特有的错误码。

错误代码 错误信息 Http状态码
106.001403 SC_FORBIDDEN 401
106.999500 SC_INTERNAL_SERVER_ERROR 500

8. Renew EIP

EIP续费（包年包月）

请求方式：GET

请求参数

名称 类型 是否必须 描述
Action String 是 RenewEip
EipId String 是 EIPUUID
Duration String 是 购买时长

返回参数

名称 位置 类型 描述
code body String 返回码（错误时返回相应错误码）。
message body String 返回信息 有效值：成功 或 失败。
result body String 返回结果

示例

对包年包月类型的Eip进行续费操作

请求示例

https://eip.cn-north-3.inspurcloudapi.com/?Action=RenewEip&EipId=fceeaabf—fc6d-4270-8abe-68ae597ecb3f&Duration=2&Nonce=922182&Timestamp=1555717904&Version=2019-01-31

响应示例

<RenewEipResponse>
    <OrderId>263977922125904384</OrderId>
    <RequestId>b5cdc464-ec54-48e0-8840-e89ce4b0f5b9</RequestId>
</RenewEipResponse>

错误码

以下为本接口特有的错误码。

错误代码 错误信息 Http状态码
106.994404 SC_NOT_FOUND 404
106.999500 Bad Request 400
106.999500 Forbiden 403
106.999500 SC_INTERNAL_SERVER_ERROR 500

共享带宽相关接口

1. CreateSbw

创建共享带宽实例，创建共享带宽的计费模式有两种，一种是包年包月（预付费），一种是按需计（后付费）。模式为：异步。 目前支持包年包月模式创建。

请求方式：GET

请求参数

名称 类型 是否必须 描述
Action String 是 CreateSbw
Bandwidth Integer 是 共享带宽大小
BillType String 是 计费方式---1.monthly：按月; 2.hourlySettlement：按小时实时结算（即按需）。
sbwName String 是 共享带宽的名字
Duration String 是 购买时长---BillType为monthly时必传。
DurationUnit String 是 购买时长单位---默认值：M（区分大小写）。BillType为monthly时必传。

返回参数

名称 位置 类型 描述
code body String 返回码（错误时返回相应错误码）。
message body String 返回信息 有效值：成功 或 失败。
result body String 返回结果

示例

创建一条共享带宽(包年包月)

请求示例

URL：

https://eip.cn-north-3.inspurcloudapi.com/?Action=CreateSbw&Bandwidth=7&BillType=monthly&Nonce=62372&Timestamp=1555717904&Version=2019-01-31&sbwname=openapitest-smz&Duration=1&DurationUnit=M

响应示例

<CreateSbwResponse>
    <OrderId>263977913125904384</OrderId>
    <RequestId>b5cdc464-ec54-48e0-8840-e89ce4b0f5b9</RequestId>
</CreateSbwResponse>

错误码

以下为本接口特有的错误码。

错误代码 错误信息 Http状态码
106.999400 SC_PARAM_ERROR 400
106.102503 SC_OPENSTACK_FIPCREATE_ERROR 500
106.999500 SC_INTERNAL_SERVER_ERROR 500

示例

创建一条共享带宽(按需计费)

请求示例

URL：

https://eip.cn-north-3.inspurcloudapi.com/?Action=CreateSbw&Bandwidth=6&BillType=hourlySettlement&Nonce=62350&Timestamp=1555717904&Version=2019-01-31&sbwname=ccc

响应示例

<CreateSbwResponse>
    <OrderId>263977913125902184</OrderId>
    <RequestId>b5cdc464-ec54-48e0-8840-e89ce4b0f5b9</RequestId>
</CreateSbwResponse>

错误码

以下为本接口特有的错误码。

错误代码 错误信息 Http状态码
106.999400 SC_PARAM_ERROR 400
106.102503 SC_OPENSTACK_FIPCREATE_ERROR 500
106.999500 SC_INTERNAL_SERVER_ERROR 500

2. DeleteSbw

第三方调用，释放共享带宽实例。 请求方式：GET

请求参数

名称 类型 是否必须 描述
Action String 是 DeleteSbw
SbwId String 是 SBWUUID

返回参数

名称 位置 类型 描述
code body String 返回码（错误时返回相应错误码）。
message body String 返回信息 有效值：成功 或 失败。
result body String 返回结果

示例

删除一条共享带宽。

请求示例

https://eip.cn-north-3.inspurcloudapi.com/?Action=DeleteSbw&SbwId=eacef739-0486-4d6c-ad07-878ced4c35e9&Nonce=2163589&Timestamp=1555717904&Version=2019-01-31

响应示例

<DeleteSbwResponse>
    <OrderId>263977913125904384</OrderId>
    <RequestId>b5cdc464-ec54-48e0-8840-e89ce4b0f5b9</RequestId>
</DeleteSbwResponse>

错误码

以下为本接口特有的错误码。

错误代码 错误信息 Http状态码
106.994400 SC_PARAM_UNKONWERROR 400
106.999500 SC_INTERNAL_SERVER_ERROR 500

3. List Sbws

查询所有共享带宽信息

请求方式：GET

请求参数

名称 类型 是否必须 描述
Action String 是 ListSbw
pageIndex String 是 当前页
pageSize String 是 每页记录条数

返回参数

名称 位置 类型 描述
code body String 返回码（错误时返回相应错误码）。
message body String 返回信息 有效值：成功 或 失败。
result body String 返回结果

示例

查询所有共享带宽信息

请求示例

https://eip.cn-north-3.inspurcloudapi.com/?Action=ListSbw&pageIndex=1&pageSize=20&Nonce=920&Timestamp=1555717904&Version=2019-01-31

响应示例

<ListSbwResponse>
    <TotalCount>3</TotalCount>
    <TotalPages>3</TotalPages>
    <PageSize>1</PageSize>
    <PageNo>1</PageNo>
    <Data>
        <SbwId>fb200712-6814-4bf8-b8b2-b3119e03eb82</SbwId>
        <Region>cn-north-3</Region>
        <IpCount>1</IpCount>
        <Status>ACTIVE</Status>
        <BillType>monthly</BillType>
        <ChargeMode>Bandwidth</ChargeMode>
        <Bandwidth>61</Bandwidth>
        <Duration>1</Duration>
        <SbwName>bao0613bbcc</SbwName>
        <CreateTime>2019-06-13T20:45:27Z</CreateTime>
    </Data>
    <RequestId>a27509c0-0c2d-492e-a749-61c7c502114e</RequestId>
</ListSbwResponse>

错误码

以下为本接口特有的错误码。

错误代码 错误信息 Http状态码
106.001403 SC_FORBIDDEN 401
106.999500 SC_INTERNAL_SERVER_ERROR 500
106.999400 SC_PARAM_ERROR 400

4. Sbw Details

查询共享带宽信息

请求方式：GET

请求参数

名称 类型 是否必须 描述
Action String 是 SbwDetails
EipId String 是 SbwId

返回参数

名称 位置 类型 描述
code body String 返回码（错误时返回相应错误码）。
message body String 返回信息 有效值：成功 或 失败。
result body String 返回结果

示例

显示单个Sbw的相关信息

请求示例

https://eip.cn-north-3.inspurcloudapi.com/?Action=SbwDetails&SbwId=f383788e-6cb0-49aa-9e34-bc37f90b2844&Nonce=920&Timestamp=1555717904&Version=2019-01-31

响应示例

<SbwDetailsResponse>
    <SbwId>fb200712-6814-4bf8-b8b2-b3119e03eb82</SbwId>
    <Region>cn-north-3</Region>
    <IpCount>1</IpCount>
    <RequestId>0bb9e7fb-f4b8-40ac-93be-b126190aba8e</RequestId>
    <Status>ACTIVE</Status>
    <BillType>monthly</BillType>
    <ChargeMode>Bandwidth</ChargeMode>
    <Bandwidth>61</Bandwidth>
    <Duration>1</Duration>
    <SbwName>bao0613bbcc</SbwName>
    <CreateTime>2019-06-13T20:45:27Z</CreateTime>
</SbwDetailsResponse>

错误码

以下为本接口特有的错误码。

错误代码 错误信息 Http状态码
106.001404 SC_FORBIDDEN 404
106.999500 SC_INTERNAL_SERVER_ERROR 500

5. Sbw EipList

查询当前共享带宽下的EIP列表

请求方式：GET

请求参数

名称 类型 是否必须 描述
Action String 是 SbwEipList
SbwId String 是 SbwId

返回参数

名称 位置 类型 描述
code body String 返回码（错误时返回相应错误码）。
message body String 返回信息 有效值：成功 或 失败。
result body String 返回结果

示例

显示加入SBW的EIP信息

请求示例

https://eip.cn-north-3.inspurcloudapi.com/?Action=SbwEipList&SbwId=b292db42-fbbc-45fe-bcb2-46bc804a88e6&Nonce=12356&Timestamp=1555717904&Version=2019-01-31&status=bind

响应示例

<SbwEipListResponse>
    <TotalCount>2</TotalCount>
    <TotalPages>1</TotalPages>
    <PageSize>10</PageSize>
    <PageNo>1</PageNo>
    <Data>
        <OldBandwidth>1</OldBandwidth>
        <Region>cn-north-3</Region>
        <CreatedTime>2019-10-01T16:13:10Z</CreatedTime>
        <IpType>BGP</IpType>
        <Status>DOWN</Status>
        <EipId>bc2c232a-f17e-465e-9255-818f7598e72b</EipId>
        <ResourceSet>
            <ResourceType>null</ResourceType>
            <ResourceId>null</ResourceId>
        </ResourceSet>
        <BillType>hourlySettlement</BillType>
        <SbwId>b292db42-fbbc-45fe-bcb2-46bc804a88e6</SbwId>
        <Bandwidth>50</Bandwidth>
        <Duration>1</Duration>
        <ChargeMode>SharedBandwidth</ChargeMode>
        <EipAddress>117.73.10.114</EipAddress>
    </Data>
    <Data>
        <OldBandwidth>1</OldBandwidth>
        <Region>cn-north-3</Region>
        <Status>ACTIVE</Status>
        <CreatedTime>2019-07-12T12:53:27Z</CreatedTime>
        <PortId>35574812-0a08-41c4-a654-89127477b967</PortId>
        <IpType>BGP</IpType>
        <ResourceSet>
            <ResourceType>1</ResourceType>
            <ResourceId>4785b96a-a25f-4144-b309-5e143708ec69</ResourceId>
        </ResourceSet>
        <EipId>29e87735-0e97-433e-bb1c-1c35b6736e04</EipId>
        <PrivateIpAddress>192.168.0.5</PrivateIpAddress>
        <BillType>hourlySettlement</BillType>
        <SbwId>b292db42-fbbc-45fe-bcb2-46bc804a88e6</SbwId>
        <Bandwidth>50</Bandwidth>
        <Duration>1</Duration>
        <ChargeMode>SharedBandwidth</ChargeMode>
        <EipAddress>117.73.13.175</EipAddress>
    </Data>
    <RequestId>3afef610-4bd2-48c2-9716-7211a8f11490</RequestId>
</SbwEipListResponse>

错误码

以下为本接口特有的错误码。

错误代码 错误信息 Http状态码
106.994400 SC_PARAM_UNKONWERROR 400
106.001403 SC_FORBIDDEN 401
106.999500 SC_INTERNAL_SERVER_ERROR 500

6. Rename Sbw

对当前共享带宽重新命名

请求方式：GET

请求参数

名称 类型 是否必须 描述
Action String 是 RenameSbw
SbwId String 是 SbwId
SbwName String 是 共享带宽的名字

返回参数

名称 位置 类型 描述
code body String 返回码（错误时返回相应错误码）。
message body String 返回信息 有效值：成功 或 失败。
result body String 返回结果

示例

重命名当前共享带宽的名称

请求示例

https://eip.cn-north-3.inspurcloudapi.com/?Action=RenameSbw&SbwId=86ac66dc-0264-4715-9b97-62ad1a952197&Sbwname=abb&Nonce=9205212&Timestamp=1555717904&Version=2019-01-31

响应示例

<RenameSbwResponse>
    <SbwId>b87497b7-c6ff-4ead-9c7d-3938bbbea5f7</SbwId>
    <Region>cn-north-3</Region>
    <IpCount>0</IpCount>
    <RequestId>7827c650-a3a2-4409-975e-f81a8a9119b2</RequestId>
    <Status>ACTIVE</Status>
    <BillType>monthly</BillType>
    <ChargeMode>Bandwidth</ChargeMode>
    <Bandwidth>8</Bandwidth>
    <Duration>1</Duration>
    <SbwName>weqr</SbwName>
    <CreateTime>2019-11-26T19:10:25Z</CreateTime>
</RenameSbwResponse>

错误码

以下为本接口特有的错误码。

错误代码 错误信息 Http状态码
106.994400 SC_PARAM_UNKONWERROR 400
106.001403 SC_FORBIDDEN 401
106.999500 SC_INTERNAL_SERVER_ERROR 500

7. Sbw UnbindEipList

查询当前用户共享带宽未绑定的Eip列表(EIP类型都是按需付费)

请求方式：GET

请求参数

名称 类型 是否必须 描述
Action String 是 SbwUnbindEipList
SbwId String 是 SbwId

返回参数

名称 位置 类型 描述
code body String 返回码（错误时返回相应错误码）。
message body String 返回信息 有效值：成功 或 失败。
result body String 返回结果

示例

查询当前用户共享带宽未绑定的Eip列表(EIP类型都是按需付费)

请求示例

https://eip.cn-north-3.inspurcloudapi.com/?Action=SbwEipList&SbwId=b292db42-fbbc-45fe-bcb2-46bc804a88e6&Nonce=12356&Timestamp=1555717904&Version=2019-01-31&status=unbind

响应示例

<SbwEipListResponse>
    <Data>
        <OldBandwidth>1</OldBandwidth>
        <Region>cn-north-3</Region>
        <IpType>BGP</IpType>
        <EipId>7bb9e5d2-b1a2-4ee8-a357-26fbe2957706</EipId>
        <CreatedTime>2019-07-16T10:13:30Z</CreatedTime>
        <BillType>hourlySettlement</BillType>
        <Status>ACTIVE</Status>
        <Bandwidth>10</Bandwidth>
        <Duration>1</Duration>
        <ChargeMode>Bandwidth</ChargeMode>
        <EipAddress>117.73.13.188</EipAddress>
    </Data>
    <Data>
        <OldBandwidth>50</OldBandwidth>
        <Region>cn-north-3</Region>
        <PortId>f3bc9f8a-c2d2-4c9f-b82d-24f8abe259df</PortId>
        <IpType>BGP</IpType>
        <CreatedTime>2019-07-19T14:04:00Z</CreatedTime>
        <EipId>f04fe4f3-1494-4ef6-bdd1-c7f9883c7abd</EipId>
        <Status>ACTIVE</Status>
        <BillType>hourlySettlement</BillType>
        <PrivateIpAddress>192.168.0.11</PrivateIpAddress>
        <Bandwidth>50</Bandwidth>
        <Duration>1</Duration>
        <ChargeMode>Bandwidth</ChargeMode>
        <EipAddress>117.73.10.66</EipAddress>
    </Data>
    <Data>
        <OldBandwidth>1</OldBandwidth>
        <Region>cn-north-3</Region>
        <PortId>c455abb2-732e-4d8f-b91e-500da6c87579</PortId>
        <IpType>BGP</IpType>
        <CreatedTime>2019-10-09T19:44:18Z</CreatedTime>
        <EipId>f7e1d91b-6ca9-46bb-8329-7f9357af4020</EipId>
        <Status>ACTIVE</Status>
        <BillType>hourlySettlement</BillType>
        <PrivateIpAddress>172.31.0.10</PrivateIpAddress>
        <Bandwidth>6</Bandwidth>
        <Duration>1</Duration>
        <ChargeMode>Bandwidth</ChargeMode>
        <EipAddress>117.73.2.250</EipAddress>
    </Data>
    <RequestId>c6dc6bf1-381b-472c-bf47-f7f58bc6693d</RequestId>
</SbwEipListResponse>

错误码

以下为本接口特有的错误码。

错误代码 错误信息 Http状态码
106.001403 SC_FORBIDDEN 401
106.999500 SC_INTERNAL_SERVER_ERROR 500

8. Eip AddSbw

EIP加入共享带宽，。

请求方式：GET

请求参数

名称 类型 是否必须 描述
Action String 是 EipAddSbw
EipId String 是 EIPUUID
SbwId String 是 SBWUUID

返回参数

名称 位置 类型 描述
code body String 返回码（错误时返回相应错误码）。
message body String 返回信息 有效值：成功 或 失败。
result body String 返回结果

示例

将一条EIP加入到共享带宽。

请求示例

URL：

https://eip.cn-north-3.inspurcloudapi.com/?Action=EipAddSbw&EipId=63aa185b-f8c3-4b3a-b3d9-2bbc31bad62e&SbwId=f383788e-6cb0-49aa-9e34-bc37f90b2844&Nonce=2213&Timestamp=1555717904&Version=2019-01-31&Format=json

响应示例

<EipAddSbwResponse>
    <OrderId>263978913125904384</OrderId>
    <RequestId>b5cdc464-ec54-48e0-8840-e89ce4b0f5b9</RequestId>
</EipAddSbwResponse>

错误码

以下为本接口特有的错误码。

错误代码 错误信息 Http状态码
106.999400 SC_PARAM_ERROR 400
106.999500 Forbiden 403
106.001404 SC_FORBIDDEN 404
106.999500 SC_INTERNAL_SERVER_ERROR 500

9. Eip RemoveSbw

EIP移出共享带宽，。

请求方式：GET

请求参数

名称 类型 是否必须 描述
Action String 是 EipAddSbw
EipId String 是 EIPUUID
SbwId String 是 SBWUUID

返回参数

名称 位置 类型 描述
code body String 返回码（错误时返回相应错误码）。
message body String 返回信息 有效值：成功 或 失败。
result body String 返回结果

示例

将一条EIP从共享带宽中移出。

请求示例

URL：

https://eip.cn-north-3.inspurcloudapi.com/?Action=EipRemoveSbw&EipId=63aa185b-f8c3-4b3a-b3d9-2bbc31bad62e&SbwId=f383788e-6cb0-49aa-9e34-bc37f90b2844&Nonce=221376&Timestamp=1555717904&Version=2019-01-31

响应示例

<EipRemoveSbwResponse>
    <RequestId>7a619ac2-bf6f-471e-b25f-311f05f7bc32</RequestId>
    <OrderId>251739153470267392</OrderId>
</EipRemoveSbwResponse>

错误码

以下为本接口特有的错误码。

错误代码 错误信息 Http状态码
106.999400 SC_PARAM_ERROR 400
106.999500 Forbiden 403
106.001404 SC_FORBIDDEN 404
106.999500 SC_INTERNAL_SERVER_ERROR 500

10. Update the Sbw bindwidth

当业务量发生变动需要变更带宽时，可以在线调整共享带宽，支持增大和减小带宽。 注意：按需的共享带宽可调大或调小，包年包月的共享带宽只能调大。

请求方式：GET

请求参数

名称 类型 是否必须 描述
Action String 是 UpdateSbwBindWidth
SbwId String 是 SBW的Id
NewSbwBandwidth String 是 升级的共享带宽大小

返回参数

名称 位置 类型 描述
code body String 返回码（错误时返回相应错误码）。
message body String 返回信息 有效值：成功 或 失败。
result body String 返回结果

示例

更新一条共享带宽的带宽(按需计费)。

请求示例

https://eip.cn-north-3.inspurcloudapi.com/?Action=UpdateSbwBindWidth&SbwId=f383788e-6cb0-49aa-9e34-bc37f90b2844&NewSbwBandwidth=20&BillType=hourlySettlement&Nonce=2132367&Timestamp=1555717904&Version=2019-01-31

响应示例

<UpdateSbwBindWidthResponse>
    <RequestId>3d801232-1937-44f0-b6bd-6e845eb6ba66</RequestId>
    <OrderId>251878256804077568</OrderId>
</UpdateSbwBindWidthResponse>

错误码

以下为本接口特有的错误码。

错误代码 错误信息 Http状态码
106.999400 SC_PARAM_ERROR 400
106.999500 Forbiden 403
106.994404 SC_NOT_FOUND 404
106.201503 SC_FIREWALL_SERVER_ERROR 500
106.999500 SC_INTERNAL_SERVER_ERROR 500

示例

更新一条共享带宽的带宽(包年包月计费)。

请求示例

https://eip.cn-north-3.inspurcloudapi.com/?Action=UpdateSbwBindWidth&SbwId=9bca7a0a-9e9d-4c18-9651-787587ee38e9&NewSbwBandwidth=12&Nonce=2132369&Timestamp=1555717904&Version=2019-01-31&Duration=1

响应示例

<UpdateSbwBindWidthResponse>
    <RequestId>3d801432-1937-44f0-b6bd-6e845eb6ba66</RequestId>
    <OrderId>251998256804077568</OrderId>
</UpdateSbwBindWidthResponse>

错误码

以下为本接口特有的错误码。

错误代码 错误信息 Http状态码
106.999400 SC_PARAM_ERROR 400
106.999500 Forbiden 403
106.994404 SC_NOT_FOUND 404
106.201503 SC_FIREWALL_SERVER_ERROR 500
106.999500 SC_INTERNAL_SERVER_ERROR 500

11. Renew SBW

共享带宽续费（包年包月）

请求方式：GET

请求参数

名称 类型 是否必须 描述
Action String 是 RenewSbw
SbwId String 是 SBWUUID
Duration String 是 购买时长

返回参数

名称 位置 类型 描述
code body String 返回码（错误时返回相应错误码）。
message body String 返回信息 有效值：成功 或 失败。
result body String 返回结果

示例

对包年包月类型的Sbw进行续费操作

请求示例

https://eip.cn-north-3.inspurcloudapi.com/?Action=RenewSbw&SbwId=2bd0e921-7d2d-4157-8036-ae62f515c12e&Duration=1&Nonce=922182&Timestamp=1555717904&Version=2019-01-31

响应示例

<RenewSbwResponse>
    <RequestId>92119eb8-6625-41ad-9a8f-613487b4c1bf</RequestId>
    <OrderId>259256658307260416</OrderId>
</RenewSbwResponse>

错误码

以下为本接口特有的错误码。

错误代码 错误信息 Http状态码
106.999500 Bad Request 400
106.999500 Forbiden 403
106.994404 SC_NOT_FOUND 404
106.999500 SC_INTERNAL_SERVER_ERROR 500

IPV6转换服务相关接口

1. CreateEipv6

创建eipv6实例，创建eipv6有两种方式，一是选择已有的eip，二是eip和eipv6同时创建。 （目前创建的Eipv6只能是按需的方式。）

请求方式：GET

请求参数

名称 位置 类型 是否必须 描述
Action path String 是 CreateIpts
eipId path String 是 Eip的Id
Bandwidth path String 是 EIP带宽大小
BillType path String 是 计费方式---1.monthly：按月; 2.hourlySettlement：按小时实时结算（即按需）。
Iptype path String 否 线路类型---默认BGP，当需要选择其他线路时，可修改成其他线路参数。

返回参数

名称 位置 类型 是否必须 描述
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，新购的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>264051064866283520</OrderId>
    <RequestId>733e241c-37e1-40e6-a1ae-6065821604bc</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实例。 请求方式：GET

请求参数

名称 位置 类型 是否必须 描述
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=7403423b-0d6c-4eb5-99f2-24ec3a1ff490&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

示例

显示单个Ipv6的相关信息

请求示例

https://eip.cn-north-3.inspurcloudapi.com/?Action=GetIpv6Details&Eipv6Id=b362d8bc-08ff-4e5c-a5a2-ddc655fde85d&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地址

请求方式：GET

请求参数

名称 位置 类型 是否必须 描述
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=b362d8bc-08ff-4e5c-a5a2-ddc655fde85d&Nonce=92021&Timestamp=1655717904&Version=2019-01-31&EipAddress=117.73.11.207

响应示例

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