通用说明

更新时间：2024-03-11

下表列出了所有资源管理API所携带的公共头域。HTTP协议的标准头域不再这里列出了。

头域（Header）	是否必须	说明
Authorization	必须	包含Access Key与请求签名。
Content-Type	可选	application/json; charset=utf-8
x-bce-date	可选	表示日期的字符串，符合BCE API规范
x-bce-content-sha256	可选	表示内容部分的SHA256签名的十六进制字符串。这里内容指HTTP Request Payload Body。即Content部分在被HTTP encode之前的原始数据

公共头域将在每个资源管理服务API中出现，是必需的头域，其中x-bce-content-sha256头域只出现在POST和PUT请求中。 POST、PUT、DELETE等请求数据放在request body中。

公共响应头

下表列出了所有资源管理API的公共响应头域。HTTP协议的标准响应头域不再这里列出了。

头域（Header）	说明
Content-Length	只支持JSON格式，application/json; charset=utf-8
x-bce-request-id	资源管理后端生成，并自动设置到响应头域中

其中，request id使用UUID version4生成。

资源管理服务错误响应符合BCE规范，统一为如下格式。后续各接口不再单独列出。

{
    "requestId": "47e0ef1a-9bf2-11e1-9279-0100e8cf109a",
    "code":"ResourceNotFound",
    "message":"Requested resource is not found."
}

其中，code为错误码，所有错误码取值来源BCE公共错误码和资源管理专有错误码（参考错误码部分内容）。

当前API版本为1，即下文出现的{version}取值为1。