文档首页/事件网格 EG/API参考/API/事件管理/预校验指定事件源发布事件成功 - CheckPutEvents
更新时间：2025-10-22 GMT+08:00
在线调试
CLI示例
查看PDF
分享

预校验指定事件源发布事件成功 - CheckPutEvents

功能介绍

发布事件到事件源成功需要有订阅等条件，预先校验。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

POST /v1/{project_id}/events/check

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户资源空间ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

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

表3 请求Body参数

参数

是否必选

参数类型

描述

sources

否

Array of sources objects

事件源参数

表4 sources

参数

是否必选

参数类型

描述

channel_id

否

String

事件通道ID

source_name

否

String

事件源名称

响应参数

状态码：200

表5 响应Header参数

参数

参数类型

描述

X-Request-Id

String

This field is the request ID number for task tracking. Format is request_uuid-timestamp-hostname.

表6 响应Body参数

参数

参数类型

描述

failed_count

Integer

预校验发布事件失败的个数

sources

Array of CheckPutEventsResult objects

事件源参数

表7 CheckPutEventsResult

参数

参数类型

描述

channel_id

String

事件通道id

source_name

String

事件源名称

check_result

Boolean

发送事件是否成功检查结果

check_detail

String

发送事件是否成功检查明细

请求示例

预校验指定事件源发布事件成功

POST https://{endpoint}/v1/{project_id}/events/check

{
  "sources" : [ {
    "channel_id" : "092e1243e88146768798b0e8c9933192",
    "source_name" : "source-demo"
  } ]
}

响应示例

状态码：200

Information

{
  "failed_count" : 0,
  "sources" : [ { } ]
}

状态码

状态码

描述

200

Information

错误码

请参见错误码。

父主题：事件管理