| 代码 | HTTP 状态 | 消息 | 可能原因 | 解决方法 |
|---|---|---|---|---|
1002 |
400 | Invalid set payload | 请求正文格式错误或缺少必填字段 | 验证请求正文是否为包含 resource_type、resource_id 和 tags 的有效 JSON |
1003 |
400 | resource_type and resource_id are required |
缺少查询参数 | 在查询字符串中包含 resource_type 和 resource_id |
1006 |
400 | Invalid resource type | 不支持的资源类型 | 使用受支持的资源类型 |
1007 |
400 | tag parameter must be in format... | 标签过滤语法错误 | 请参阅 标签过滤语法 |
1009 |
400 | tag_key is required |
缺少 tag_key 参数 |
包含 tag_key 路径参数 |
1010 |
400 | too many tag filters (maximum 20) | tag 查询参数超过 20 个 |
将过滤器减少到 20 个或更少，或拆分到多个请求中 |
1011 |
400 | tag key too long (maximum 256 characters) | 标签键超过 256 个字符 | 缩短标签键的长度 |
1012 |
400 | tag value too long (maximum 1024 characters) | 标签值超过 1,024 个字符 | 缩短标签值的长度 |
1013 |
400 | too many OR values in tag filter (maximum 10) | 在单个过滤器中用逗号分隔的值超过 10 个 | 拆分为多个过滤器 |
1014 |
400 | Invalid tag key | 键包含无效字符 | 仅使用字母、数字、_、.、- |
1015 |
400 | Invalid delete payload | 删除请求正文格式错误 | 验证请求正文是否包含 resource_type 和 resource_id |
在当前的公测版本中，对于不存在或从未被标记过的资源，GET /accounts/{account_id}/tags 会返回 500 Internal Server Error 错误：
"resource not found: type={resource_type} id={resource_id}"列表端点（/tags/resources、/tags/keys、/tags/values/{key}）在未找到匹配项时会返回 200 OK 并附带空结果数组——这是预期行为，并不是错误。
这一 500 错误的行为是已知的测试版限制，在未来的版本中可能会更改为返回 404。