赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 百度云
  3. 云服务器 BCC
  4. 标签服务API参考
  5. 通用说明

通用说明

  • 标签服务API参考
  • 发布于 2025-04-02
  • 0 次阅读
文档编辑
文档编辑

公共请求头

下表列出了所有标签服务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-Type 只支持JSON格式,application/json; charset=utf-8
x-bce-request-id tag后端生成,并自动设置到响应头域中

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

通用错误返回

标签服务错误响应符合BCE规范,统一为如下格式。后续各接口不再单独列出。

    {
        "requestId": "47e0ef1a-9bf2-11e1-9279-0100e8cf109a",
        "code":"NoSuchKey",
        "message":"The resource you requested does not exist"
    }

其中,code为错误码,所有错误码取值来源BCE公共错误码和标签服务专有错误码(参考错误码部分内容)。

API版本

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

相关文章

简介 2025-04-02 17:54

标签服务API对于每个HTTP请求,认证签名放在Authorization头域中,后端统一认证。且后端在Response头域中会添加x-bce-request-id,作为请求唯一标识,从而方便追踪定位问题。 目前支持的tag API接口如下: 创建标签 删除标签 标签列表 查看标签下绑定的资源

通用说明 2025-04-02 17:54

域名 2025-04-02 17:54

标签服务不分区域,使用全局域名tag.baidubce.com。

附录1 2025-04-02 17:54

创建标签 2025-04-02 17:54

删除标签 2025-04-02 17:54

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号