创建事件订阅
功能介绍
创建事件订阅。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v1/{project_id}/subscriptions
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
租户项目ID |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 最小长度:1 最大长度:16384 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
是 |
String |
订阅名称,租户下唯一,由字母、数字、点、下划线和中划线组成,必须字母或数字开头 最小长度:1 最大长度:128 |
description |
否 |
String |
订阅描述 最大长度:255 |
channel_id |
是 |
String |
所属事件通道ID |
sources |
是 |
Array of SubscriptionSource objects |
订阅的事件源列表, 当前仅支持订阅一个事件源 数组长度:1 - 1 |
targets |
是 |
Array of SubscriptionTarget objects |
事件目标列表,至少订阅一个事件目标 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
id |
否 |
String |
订阅源ID,需保证全局唯一。指定ID的订阅源存在时则进行更新,否则进行创建;未指定时由系统自动生成。由小写字母、数字、中划线组成,必须字母或数字开头。 最小长度:32 最大长度:64 |
name |
是 |
String |
订阅的事件源名称 最大长度:128 |
provider_type |
是 |
String |
订阅的事件源的提供方类型 枚举值:
|
detail |
否 |
Object |
订阅的事件源参数列表, 该字段序列化后总长度不超过1024字节 |
filter |
是 |
Object |
订阅事件源的匹配过滤规则, 该字段序列化后总长度不超过2048字节 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
id |
否 |
String |
订阅目标ID,需保证全局唯一,由小写字母、数字、中划线组成,必须字母或数字开头。 更新订阅场景时,指定ID的订阅目标存在时则进行更新,否则进行创建; 创建订阅目标场景时,指定ID作为待创建的订阅目标对象ID,未指定时由系统自动生成。 更新订阅目标时,此字段忽略; 最小长度:32 最大长度:64 |
name |
是 |
String |
订阅的事件目标名称 最大长度:128 |
provider_type |
是 |
String |
订阅的事件目标的提供方类型 枚举值:
|
connection_id |
否 |
String |
订阅的事件目标使用的目标链接ID 最大长度:64 |
detail |
否 |
Detail object |
订阅的事件目标参数列表,该字段序列化后总长度不超过1024字节,函数、函数流、webhook订阅目标必填,其中函数、函数流委托名称必填 |
kafka_detail |
否 |
KafkaTargetDetail object |
订阅的事件kafka目标参数列表,该字段序列化后总长度不超过1024字节,kafka订阅目标必填 |
smn_detail |
否 |
SmnTargetDetail object |
订阅的事件smn目标参数列表,该字段序列化后总长度不超过1024字节,smn订阅目标必填 |
transform |
是 |
TransForm object |
订阅的事件目标转换规则 |
dead_letter_queue |
否 |
DeadLetterQueue object |
订阅的死信参数列表 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
url |
否 |
String |
自定义目标url |
agency_name |
否 |
String |
委托名称 |
invocation_http_parameters |
否 |
InvocationHttpParameters object |
|
invoke_type |
否 |
String |
函数调用方式,异步/同步 枚举值:
|
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
header_parameters |
否 |
Array of HeaderParameter objects |
对象列表 数组长度:0 - 5 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
is_value_secret |
否 |
Boolean |
是否加密 |
key |
否 |
String |
header的key值 最小长度:1 最大长度:256 |
value |
否 |
String |
header的value值 最小长度:1 最大长度:1024 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
type |
否 |
String |
键值规则类型 枚举值:
|
value |
否 |
String |
键值规则,键值规则为VARIABLE,CONSTANT时必填 |
template |
否 |
String |
键值规则模板,键值规则为VARIABLE时必填 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
urn |
是 |
String |
主题urn |
agency_name |
是 |
String |
委托名称 |
subject_transform |
否 |
subject_transform object |
标题规则 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
type |
是 |
String |
标题规则类型 枚举值:
|
value |
是 |
String |
标题规则 |
template |
否 |
String |
标题规则模板,键值规则为VARIABLE时必填 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
type |
是 |
String |
转换规则类型 枚举值:
|
value |
否 |
String |
常量类型规则时,字段为常量内容定义; 变量类型规则时,为变量定义,内容必须为JsonObject字符串。 变量最多支持100个,且不支持嵌套结构定义; 变量名由字母、数字、点、下划线和中划线组成,必须字母或数字开头不能以HC.开头,长度不超过64个字符; 变量值表达式支持常量或JsonPath表达式,字符串长度不超过1024个字符。 最大长度:1024 |
template |
否 |
String |
变量类型规则时,规则内容的模板定义,支持对已定义变量的引用。 最大长度:2048 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
X-Request-Id |
String |
This field is the request ID number for task tracking. Format is request_uuid-timestamp-hostname. |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
订阅ID |
name |
String |
订阅名称 |
description |
String |
订阅描述 |
type |
String |
类型 枚举值:
|
status |
String |
状态 枚举值:
|
channel_id |
String |
通道ID |
channel_name |
String |
通道名称 |
used |
Array of SubscriptionUsedInfo objects |
标签信息 |
sources |
Array of SubscriptionSourceInfo objects |
订阅源列表 |
targets |
Array of SubscriptionTargetInfo objects |
订阅目标列表 |
created_time |
String |
创建时间 |
updated_time |
String |
更新时间 |
参数 |
参数类型 |
描述 |
---|---|---|
resource_id |
String |
关联资源ID |
owner |
String |
管理租户账号 |
description |
String |
描述 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
订阅源ID |
name |
String |
订阅的事件源名称 |
provider_type |
String |
订阅的事件源的提供方类型 |
detail |
Object |
订阅的事件源参数列表 |
filter |
Object |
订阅事件源的匹配过滤规则 |
created_time |
String |
创建时间 |
updated_time |
String |
更新时间 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
订阅目标ID |
name |
String |
订阅的事件目标名称 |
provider_type |
String |
订阅的事件目标的提供方类型 |
connection_id |
String |
订阅的事件目标使用的目标链接ID 最大长度:64 |
detail |
Object |
订阅的事件目标参数列表 |
transform |
TransForm object |
订阅的事件目标转换规则 |
dead_letter_queue |
DeadLetterQueue object |
订阅的死信参数列表 |
created_time |
String |
创建时间 |
updated_time |
String |
更新时间 |
参数 |
参数类型 |
描述 |
---|---|---|
type |
String |
转换规则类型 枚举值:
|
value |
String |
常量类型规则时,字段为常量内容定义; 变量类型规则时,为变量定义,内容必须为JsonObject字符串。 变量最多支持100个,且不支持嵌套结构定义; 变量名由字母、数字、点、下划线和中划线组成,必须字母或数字开头不能以HC.开头,长度不超过64个字符; 变量值表达式支持常量或JsonPath表达式,字符串长度不超过1024个字符。 最大长度:1024 |
template |
String |
变量类型规则时,规则内容的模板定义,支持对已定义变量的引用。 最大长度:2048 |
参数 |
参数类型 |
描述 |
---|---|---|
type |
String |
队列类型 枚举值:
|
instance_id |
String |
实例id 最小长度:1 最大长度:128 |
connection_id |
String |
目标连接id 最小长度:1 最大长度:128 |
topic |
String |
主题 最小长度:1 最大长度:128 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 最小长度:1 最大长度:128 |
error_msg |
String |
错误消息 最小长度:1 最大长度:512 |
error_details |
String |
具体错误消息 最小长度:1 最大长度:1024 |
request_id |
String |
请求处理ID 最小长度:1 最大长度:128 |
状态码: 401
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 最小长度:1 最大长度:128 |
error_msg |
String |
错误消息 最小长度:1 最大长度:512 |
error_details |
String |
具体错误消息 最小长度:1 最大长度:1024 |
request_id |
String |
请求处理ID 最小长度:1 最大长度:128 |
状态码: 403
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 最小长度:1 最大长度:128 |
error_msg |
String |
错误消息 最小长度:1 最大长度:512 |
error_details |
String |
具体错误消息 最小长度:1 最大长度:1024 |
request_id |
String |
请求处理ID 最小长度:1 最大长度:128 |
状态码: 404
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 最小长度:1 最大长度:128 |
error_msg |
String |
错误消息 最小长度:1 最大长度:512 |
error_details |
String |
具体错误消息 最小长度:1 最大长度:1024 |
request_id |
String |
请求处理ID 最小长度:1 最大长度:128 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 最小长度:1 最大长度:128 |
error_msg |
String |
错误消息 最小长度:1 最大长度:512 |
error_details |
String |
具体错误消息 最小长度:1 最大长度:1024 |
request_id |
String |
请求处理ID 最小长度:1 最大长度:128 |
请求示例
无
响应示例
状态码: 400
{ "error_code" : "EG.00014000", "error_msg" : "Bad request" }
状态码: 401
{ "error_code" : "EG.00014010", "error_msg" : "Incorrect token or token resolution failed" }
状态码: 403
{ "error_code" : "EG.00014030", "error_msg" : "No permissions to request this method" }
状态码: 404
{ "error_code" : "EG.00014040", "error_msg" : "Not request resource found" }
状态码: 500
{ "error_code" : "EG.00015000", "error_msg" : "Internal Server Error" }
状态码
状态码 |
描述 |
---|---|
200 |
Demo Information |
400 |
非法请求 |
401 |
未授权 |
403 |
禁止访问 |
404 |
未找到资源 |
500 |
内部服务错误 |
错误码
请参见错误码。