更新时间:2025-12-30 GMT+08:00

绑定云日志

功能介绍

为指定Topic绑定一个云日志,用于记录主题消息发送状态等信息。

调用方法

请参见如何调用API

URI

POST /v2/{project_id}/notifications/topics/{topic_urn}/logtanks

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。 获取项目ID请参考 获取项目ID

topic_urn

String

Topic的唯一的资源标识,可通过查询主题列表获取该标识。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

表3 请求Body参数

参数

是否必选

参数类型

描述

log_group_id

String

云日志服务日志组ID。

log_stream_id

String

云日志服务日志流ID。

响应参数

状态码:201

表4 响应Body参数

参数

参数类型

描述

request_id

String

请求的唯一标识。

id

String

云日志信息唯一的资源标识。

状态码:400

表5 响应Body参数

参数

参数类型

描述

request_id

String

请求的唯一标识ID。

error_code

String

返回信息对应的代码。

error_msg

String

服务异常错误信息描述。

状态码:403

表6 响应Body参数

参数

参数类型

描述

request_id

String

请求的唯一标识ID。

code

String

服务异常错误信息编码。

message

String

服务异常错误信息描述。

error_code

String

服务异常错误信息编码。

error_msg

String

服务异常错误信息描述。

encoded_authorization_message

String

编码 (加密) 后的详细拒绝原因。

details

OpenAPIFailedDetails object

云服务调用依赖服务得到的异常信息详情。

表7 OpenAPIFailedDetails

参数

参数类型

描述

error_code

String

云服务调用依赖服务响应中携带的 异常错误信息编码。

error_msg

String

云服务调用依赖服务响应中携带的 异常错误信息描述。

状态码:404

表8 响应Body参数

参数

参数类型

描述

request_id

String

请求的唯一标识ID。

error_code

String

返回信息对应的代码。

error_msg

String

服务异常错误信息描述。

状态码:500

表9 响应Body参数

参数

参数类型

描述

request_id

String

请求的唯一标识ID。

error_code

String

返回信息对应的代码。

error_msg

String

服务异常错误信息描述。

请求示例

绑定云日志

POST https://{SMN_Endpoint}/v2/{project_id}/notifications/topics/urn:smn:regionId:f96188c7ccaf4ffba0c9aa149ab2bd57:test_topic_v2/logtanks

{
  "log_group_id" : "d1b6c352-ee45-4196-9230-c74b7894e356",
  "log_stream_id" : "114960b4-1c26-48dd-93c2-4caae24aec49"
}

响应示例

状态码:201

OK

{
  "request_id" : "42f3b0cd1c894e87aa0275ce33305b21",
  "id" : "4ea80c8a68b840e19b4efd3a8f0d62ed"
}

状态码

状态码

描述

201

OK

400

Bad Request

403

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码