简介

概述

弹性裸金属服务器BBC(Baidu Baremetal Compute)是用户可以在云环境中独享的高性能物理裸机，用户拥有完全的物理设备管理权限，同时可以结合弹性公网IP EIP、负载均衡BLB灵活组网，并与云服务器BCC内网互通，灵活应对用户多种复杂场景的业务需求，轻松构建内网混合云。

在您使用API文档前，请确保已了解了弹性裸金属服务器BBC的一些基础知识，包括产品描述和计费说明。

如果您是初次调用百度智能云产品的API，可以观看API入门视频指南，快速掌握调用API的能力。

接口使用规范

规范化字符串

通常一个字符串中可以包含任何Unicode字符。在编程中这种灵活性会带来不少困扰。因此引入“规范字符串”的概念。一个规范字符串只包含百分号编码字符以及URI（Uniform Resource Identifier）非保留字符（Unreserved Characters）。 RFC 3986规定URI非保留字符包括以下字符：字母（A-Z，a-z）、数字（0-9）、连字号（-）、点号（.）、下划线（_）、波浪线（~）。 将任意一个字符串转换为规范字符串的方式是:

• 将字符串转换成UTF-8编码的字节流。
• 保留所有URI非保留字符原样不变。
• 对其余字节做一次RFC 3986中规定的百分号编码（Percent-Encoding），即一个%后面跟着两个表示该字节值的十六进制字母。字母一律采用大写形式。示例： 原字符串：this is an example for 测试, 对应的规范字符串：this%20is%20an%20example%20for%20%E6%B5%8B%E8%AF%95。

编码规范

• 可解析内容，所有request/response body内容目前均使用UTF-8编码，后续会支持更多encoding类型。

• 在请求时，需要对以下做UrlEncode：

  • Objectname，其中，Resource做UrlEncode的时候需要忽略“/”。
  • Querystring的Value。
  • x-bce-copy-source（忽略“/”）。
  • 自定义Meta:Meta Value只支持可见的ASCII字符，如果需要其它的字符，推荐使用UrlEncode处理。

密码加密传输规范

所有涉及密码的接口参数都需要加密，禁止明文传输。密码一律采用AES 128位加密算法进行加密，用SK的前16位作为密钥，加密后生成的二进制字节流需要转成十六进制，并以字符串的形式传到服务端。具体步骤如下：

• byte[] bCiphertext= AES(明文,SK)
• String strHex = HexStr(bCiphertext)

日期与时间

日期与时间的表示有多种方式。为统一起见，除非是约定俗成或者有相应规范的，凡是HTTP标准中规定的表示日期和时间字段用GMT，其他日期时间表示的地方一律采用UTC时间，遵循ISO 8601，并做以下约束：

• 表示日期一律采用YYYY-MM-DD方式，例如2014-06-01表示2014年6月1日。
• 表示时间一律采用hh:mm:ss方式，并在最后加一个大写字母Z表示UTC时间。例如23:00:10Z表示UTC时间23点0分10秒。
• 凡涉及日期和时间合并表示时，在两者中间加大写字母T，例如2014-06-01T23:00:10Z表示UTC时间2014年6月1日23点0分10秒。

请求响应格式标准

• HTTP请求，Querystring中参数的Key，为首字母小写的驼峰方式。如 upLoadId，partNumber等。
• 所有用户自定义Meta，以x-bce-meta-*的形式放Header中，自定义Meta总大小不得超过2K。x-bce-meta-*的Key会被Server端统一按照小写进行处理。

例如：用户使用PutObject接口上传了x-bce-meta-DeMo:value，Server端会统一按照小写x-bce-meta-demo:value进行处理，用户在使用GetObject接口时，Sever端的返回值为x-bce-meta-demo:value。

• 除RFC2616规定的标准Header外，其他Header以x-bce-*的形式定义。
• 所有JSON中，Key均为首字母小写的驼峰方式。
• 每个请求响应中均带有x-bce-request-id和x-bce-debug-id这两个Header。
• Header中Date、Content-MD5、Content-Type、Content-Length等相关字段遵守RFC 2616约束。

• 依据HTTP协议的规定，Content-MD5既要做MD5也要进行Base64编码，其计算方法如下：

  Content-MD5 = "Content-MD5" ":" md5-digest md5-digest = <base64 of 128 bit MD5 digest as per RFC 1864>

服务域名

BBC API的服务域名为：

公共请求头

公共响应头

错误码

错误信息除了HTTP状态码以外，应同时在HTTP body中包含下表的参数，内容如下：

例如：

{ 
    "code":"IllegalRequestUrl", 
    "message":"The requested url belongs to domain which is not under acceleration",
    "requestId":" 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7" 
}

公共错误码

BBC业务错误码