更新事件
功能介绍
更新指定事件的元数据信息。支持更新的元数据包含事件启用状态、基础类型列表、通知主题。
接口约束
此接口仅能修改凭据事件通知的元数据信息。
调用方法
请参见如何调用API。
URI
PUT /v1/{project_id}/csms/events/{event_name}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID。 |
|
event_name |
是 |
String |
事件通知名称。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
state |
否 |
String |
事件通知状态，取值如下。 ENABLED：表示启用状态 DISABLED：表示禁用状态 |
|
event_types |
否 |
Array of strings |
本次事件通知的基础事件列表，基础事件类型如下。
列表包含的基础事件类型不能重复。 |
|
notification |
否 |
Notification object |
通知主题对象。 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
event |
Event object |
事件通知对象。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
name |
String |
事件通知名称。 |
|
event_id |
String |
事件通知的资源标识符。 |
|
event_types |
Array of strings |
设置事件的基础事件类型列表。 约束：数组大小：最小1，最大12。 |
|
state |
String |
事件通知状态，取值如下。 ENABLED：表示启用状态 DISABLED：表示禁用状态 |
|
create_time |
Long |
事件通知创建时间，时间戳，即从1970年1月1日至该时间的总秒数。 |
|
update_time |
Long |
事件通知上次更新时间，时间戳，即从1970年1月1日至该时间的总秒数。 |
|
notification |
Notification object |
通知主题对象。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
target_type |
String |
事件通知的对象类型。 |
|
target_id |
String |
事件通知的对象ID。 |
|
target_name |
String |
事件通知的对象名称。 |
状态码：400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error |
ErrorDetail object |
错误信息返回体。 |
状态码：401
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error |
ErrorDetail object |
错误信息返回体。 |
状态码：403
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error |
ErrorDetail object |
错误信息返回体。 |
状态码：404
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error |
ErrorDetail object |
错误信息返回体。 |
状态码：500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error |
ErrorDetail object |
错误信息返回体。 |
状态码：502
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error |
ErrorDetail object |
错误信息返回体。 |
状态码：504
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error |
ErrorDetail object |
错误信息返回体。 |
请求示例
更新指定事件。
{
"notification" : {
"target_type" : "SMN",
"target_id" : "demo-smn-id",
"target_name" : "demo-smn-name"
}
}
响应示例
状态码：200
请求已成功
{
"event" : {
"name" : "event-test",
"event_id" : "bb6a3d22-dc93-47ac-b5bd-88df7ad35f1e",
"state" : "ENABLED",
"event_types" : [ "SECRET_VERSION_EXPIRED" ],
"create_time" : 1581507580000,
"update_time" : 1581507580000,
"notification" : {
"target_type" : "SMN",
"target_id" : "urn:smn:cn-north-4:SecertExpirationTest",
"target_name" : "SecertExpirationNotificationTest"
}
}
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
请求已成功 |
|
400 |
请求参数有误 |
|
401 |
被请求的页面需要用户名和密码 |
|
403 |
认证失败 |
|
404 |
资源不存在，资源未找到 |
|
500 |
服务内部错误 |
|
502 |
请求未完成。服务器从上游服务器收到一个无效的响应 |
|
504 |
网关超时 |
错误码
请参见错误码。
