文档中心

规范化字符串

通常一个字符串中可以包含任何Unicode字符，在编程中这种灵活性会带来不少困扰，因此引入“规范字符串”的概念。

将任意一个字符串转换为规范字符串的方式是:

1. 将字符串转换成UTF-8编码的字节流。
2. 将转换后的字符串按照URL编码规则进行编码。

URL编码规则

URL编码规则遵循RFC 3986标准，大体规则如下：

i. 对于字母（A-Z，a-z）、数字（0-9）、连字号（-）、点号（.）、下划线（_)、波浪线（~）。不编码；

ii. 对于其他字符编码成 “%XY” 的格式，其中 XY 是字符对应 ASCII 码的 16 进制表示。比如英文的双引号（”）对应的编码就是 %22

iii.对于扩展的 UTF-8 字符，编码成 “%XY%ZA…” 的格式；

iv. 需要注意的是英文空格（ ）要被编码是 %20

主机套餐规格

有关BCH套餐的具体规格，请参看产品定价。

数据类型

Contact

描述

联系人类型

包含参数

BindFailResult

描述

域名绑定失败的结果

包含参数

BCHIP购买

描述

本接口用于创建一个BCHIP实例

请求

请求结构

POST /v{version}/host/bchip HTTP/1.1
Host: bch.bj.baidubce.com
Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

请求备注

• 该创建接口为同步返回接口，请求超时时间建议设置为1分钟或以上

• couponName需要传入请求用户可用于BCH消费的代金券ID。传入无效ID，可能出现以下两种情况：

  （1）如果代金券是他人的或者已过期的，则直接扣除现金余额创建。

  （2）如果是不存在的ID，则返回错误

返回

返回头域

除公共头域，无其它特殊头域

返回参数

返回错误

示例

请求示例

POST /v1/host/bchip HTTP/1.1
Host: bch.bj.baidubce.com
x-bce-date: 2015-08-11T04:17:29Z
Content-Type: application/json; charset=utf-8     
Authorization:bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z

/3600/host;x-bce-date/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

{
    "bandwidth": 1,
    "purchaseLength": 1,
    "region": "bj",
    "couponName": "DS4I63WK7A3SL9H"
}

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Wed, 03 Dec 2014 06:42:19 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Server: BWS

{
    "userId": "b1f91fbe6fe54d2eaf70ef0025f1c3c2",
    "eip": "10.107.246.31",
    "eipId": "6639614935774b2f39426e365a3353456132336468673d3d",
    "bandwidthInMbps": 1,
    "status": "IDLE",
    "region": "bj",
    "expiredTime": "2018-02-09T03:53:25Z"
}

Bchip续费

描述

续费Bchip，延长其到期时间

请求

请求结构

PUT /v{version}/host/bchip/{ip}?renewip HTTP/1.1
Host: bch.bj.baidubce.com
Authorization: authorization string
...

请求头域

除公共头域外，无其它特殊头域。

请求参数

返回

返回头域

除公共头域，无其它特殊头域

返回参数

返回错误

示例

请求示例

PUT /v1/host/bchip/10.107.246.31?renewip HTTP/1.1
Host: bch.bj.baidubce.com
x-bce-date: 2015-08-11T04:17:29Z
Content-Type: application/json; charset=utf-8     
Authorization:bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z

/3600/host;x-bce-date/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

{
    "renewLength": 1
}

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Wed, 03 Dec 2014 06:42:19 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Server: BWS

{
    "orderId": "4ad35247da9b4a8dae53245dcfee1638"
}

BCHIP升级

描述

升级一个Bchip到一个更高的带宽

请求

请求结构

PUT /v{version}/host/bchip/{ip}?resizeip HTTP/1.1
Host: bch.bj.baidubce.com
Authorization: authorization string
...

请求头域

除公共头域外，无其它特殊头域。

请求参数

请求备注

• ip在PUT请求时，需要加入到path中
• 升级操作以Query参数加入

返回

返回头域

除公共头域，无其它特殊头域

返回参数

返回错误

示例

请求示例

PUT /v1/host/bchip/10.107.246.31?resizeip HTTP/1.1
Host: bch.bj.baidubce.com
x-bce-date: 2015-08-11T04:17:29Z
Content-Type: application/json; charset=utf-8    
Authorization:bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:

29Z/3600/host;x-bce-date/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

{
    "bandwidth": 2
}

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Wed, 03 Dec 2014 06:42:19 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Server: BWS

{
    "orderId": "db41576e3cd2453794dd95509ddee095"
}

BCHIP绑定bch

描述

绑定一个bchip到指定的bch主机

请求

请求结构

PUT /v{version}/host/bchip/{account}?bindeip HTTP/1.1
Host: bch.bj.baidubce.com
Authorization: authorization string
...

请求头域

除公共头域外，无其它特殊头域。

请求参数

请求备注

• account在PUT请求时，需要加入到path中
• 绑定操作以Query参数加入

返回

返回头域

除公共头域，无其它特殊头域

返回参数

返回错误

示例

请求示例

PUT /v1/host/bchip/openapi7rrf3?bindeip HTTP/1.1
Host: bch.bj.baidubce.com
x-bce-date: 2015-08-11T04:17:29Z
Content-Type: application/json; charset=utf-8    
Authorization:bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17

:29Z/3600/host;x-bce-date/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

{
    "eip" : "10.107.246.31"
}

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Wed, 03 Dec 2014 06:42:19 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Server: BWS

10.107.246.31

BCHIP解绑bch

描述

解除指定bch和bchip的绑定关系

请求

请求结构

PUT /v{version}/host/bchip/{account}?unbindeip HTTP/1.1
Host: bch.bj.baidubce.com
Authorization: authorization string
...

请求头域

除公共头域外，无其它特殊头域。

请求参数

请求备注

• account在PUT请求时，需要加入到path中
• 解绑操作以Query参数加入

返回

返回头域

除公共头域，无其它特殊头域

返回参数

返回错误

示例

请求示例

PUT /v1/host/bchip/openapi7rrf3?unbindeip HTTP/1.1
Host: bch.bj.baidubce.com
x-bce-date: 2015-08-11T04:17:29Z
Content-Type: application/json; charset=utf-8    
Authorization:bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z

/3600/host;x-bce-date/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

{
    "eip" : "10.107.246.31"
}

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Wed, 03 Dec 2014 06:42:19 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Server: BWS

10.107.246.31