华为云用户手册

请求示例 更新自定义事件通道 PUT https://{endpoint}/v1/{project_id}/channels/{channel_id} { "description" : "first channel", "enterprise_project_id" : "string", "cross_account" : true, "policy" : { "additionalProp1" : { "Sid" : "allow_account_to_put_events", "Effect" : "Allow", "Principal" : { "additionalProp1" : { " IAM " : [ "domainID" ] }, "additionalProp2" : { "IAM" : [ "domainID" ] }, "additionalProp3" : { "IAM" : [ "domainID" ] } }, "Action" : "eg:channels:putEvents", "Resource" : "urn:eg:cn-east-2:07d52e5245000fef0f08c008b20dc5c0:channel:testChannel" }, "additionalProp2" : { "Sid" : "allow_account_to_put_events", "Effect" : "Allow", "Principal" : { "additionalProp1" : { "IAM" : [ "domainID" ] }, "additionalProp2" : { "IAM" : [ "domainID" ] }, "additionalProp3" : { "IAM" : [ "domainID" ] } }, "Action" : "eg:channels:putEvents", "Resource" : "urn:eg:cn-east-2:07d52e5245000fef0f08c008b20dc5c0:channel:testChannel" }, "additionalProp3" : { "Sid" : "allow_account_to_put_events", "Effect" : "Allow", "Principal" : { "additionalProp1" : { "IAM" : [ "domainID" ] }, "additionalProp2" : { "IAM" : [ "domainID" ] }, "additionalProp3" : { "IAM" : [ "domainID" ] } }, "Action" : "eg:channels:putEvents", "Resource" : "urn:eg:cn-east-2:07d52e5245000fef0f08c008b20dc5c0:channel:testChannel" } } }

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表4 请求Body参数 参数 是否必选 参数类型 描述 description 否 String 通道描述 enterprise_project_id 否 String 企业项目id cross_account 否 Boolean 跨账号开关 policy 否 Object 策略

响应参数 状态码：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参数 参数 参数类型 描述 id String 通道ID name String 通道名称 description String 通道描述 provider_type String 通道提供方类型，OFFICIAL：官方事件通道；CUSTOM：自定义事件通道；PARTNER：伙伴事件通道 created_time String 创建UTC时间 updated_time String 更新UTC时间 enterprise_project_id String 企业项目id

响应示例 状态码：200 Information { "id" : "bd14144e-8f3c-43d6-bdfd-bf09b52c2b96", "name" : "channel", "description" : "first channel", "provider_type" : "CUSTOM", "created_time" : "2021-12-09 09:00:00", "updated_time" : "2021-12-09 09:00:00", "enterprise_project_id" : "string" }

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 total Integer 总数 size Integer 本页数量 items Array of EventSampleItemInfo objects 对象列表 表5 EventSampleItemInfo 参数 参数类型 描述 id String 事件示例ID name String 事件示例名称 content String 事件示例内容 event_type_id String 事件示例对应的事件类型ID event_type_name String 事件示例对应的事件类型名称 event_source_id String 事件示例对应的事件源ID event_source_name String 事件示例对应的事件源名称 created_time String 创建时间 updated_time String 更新时间 deleted_time String 删除时间

URI GET /v1/{project_id}/samples 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户资源空间ID 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量，表示从此偏移量开始查询，偏移量不能小于0 limit 否 Integer 每页显示的条目数量，不能小于1或大于1000 sort 否 String 指定查询排序 name 否 String 指定查询的事件示例名称，模糊匹配 event_type_name 否 String 指定查询事件示例的事件类型名称 event_source_id 否 String 指定查询事件示例的事件源

响应示例 状态码：200 单个事件流详情 { "name" : "test-eventstreaming", "description" : "this is a test eventstreaming", "source" : { }, "sink" : { }, "rule_config" : { "transform" : { }, "filter" : { } }, "option" : { }, "status" : "running", "id" : "string", "created_time" : "string", "updated_time" : "string" }

响应参数 状态码：200 表3 响应Header参数 参数 参数类型 描述 X-Request-Id String This field is the request ID number for task tracking. Format is request_uuid-timestamp-hostname. 表4 响应Body参数 参数 参数类型 描述 name String 事件流名称，租户下唯一，由字母、数字、点、下划线和中划线组成，必须字母或数字开头 description String 事件流描述 source EventStreamingSource object 事件源，一个事件流中事件源只有一个 sink EventStreamingSink object 事件目标，一个事件流中只有一个事件目标，sink_fg、sink_kafka只能选择其中一个参数 rule_config rule_config object 事件规则，包括过滤规则和转换规则 option RunOption object 运行配置 status String 事件流状态 id String 事件流ID created_time String 创建时间 updated_time String 更新时间 表5 EventStreamingSource 参数 参数类型 描述 source_kafka SourceKafkaMQParameters object 事件源参数 source_mobile_rocketmq SourceMobileMQParameters object 事件流移动云rockectMq事件源参数 source_community_rocketmq SourceCommunityMQParameters object 事件流社区rockectMq事件源参数 source_dms_rocketmq SourceDMSMQParameters object DMS事件源参数 name String 事件源类型名称 表6 SourceKafkaMQParameters 参数 参数类型 描述 addr String kafka连接地址 group String kafka消费组 instance_name String kafka实例名称 security_protocol String 安全协议 instance_id String kafka实例ID topic String kafka topic名称 seek_to String 消费点位 enable_sasl_ssl Boolean SASL_SSL是否开启 sasl_mechanism String SASL认证机制 ssl_certificate_url String SASL证书地址，配置的obs地址 ssl_certificate_pwd String SASL证书密码 user_name String 用户名 password String 用户密码 表7 SourceMobileMQParameters 参数 参数类型 描述 group_id String 消费组id instance_id String 实例id topic String topic tag String 标签 authentication_required Boolean 鉴权认证 msg_trace_switch Boolean 保存消息轨迹 access_key String AccessKey secret_key String SecretKey message_model String 订阅方式 addr_type String 接入点类型 addr String 地址 sdk_url String 依赖SDK consume_timeout Integer 消费超时时间 message_type String 消息类型 suspend_time Integer 失败重试的等待时间 max_reconsumer_times Integer 最大重试次数 consumer_thread_nums Integer 消费线程数 consumer_batch_max_size Integer 批量消费最大消息数 consumer_max_wait Integer 批量消费最大等待时长，单位：秒 vpc_id String 虚拟私有云 subnet_id String 子网 表8 SourceCommunityMQParameters 参数 参数类型 描述 instance_name String 实例名称，仅dms的rockectMq需要该字段 instance_id String 实例ID，仅dms的rockectMq需要该字段 addr String rockectMq连接地址 group String 消费组 topic String topic名称 tag String 标签 vpc_id String 虚拟云id subnet_id String 子网id ssl_enable Boolean 开启SSL enable_acl Boolean ACL访问控制 access_key String 用户名 secret_key String 密码 message_type String 消息类型 consume_timeout Integer 消费超时时间 consumer_thread_nums Integer 线程消费数 consumer_batch_max_size Integer 批量消费最大消息数 max_reconsume_times Integer 最大重试次数，-1表示一直重试 suspend_current_queue_time_millis Integer 重试间隔，单位ms 表9 SourceDMSMQParameters 参数 参数类型 描述 instance_name String 实例名称，仅dms的rockectMq需要该字段 instance_id String 实例ID，仅dms的rockectMq需要该字段 group String 消费组 topic String topic名称 tag String 标签 ssl_enable Boolean 开启SSL enable_acl Boolean ACL访问控制 access_key String 用户名 secret_key String 密码 message_type String 消费方式，针对不同生产顺序消息类型，选择消费方式会导致不同结果，请严格按照需求选择消费方式。1、生产顺序为：设置消息组，保证消息顺序发送。消费方式为：顺序消费，实际消息处理结果：按照消息组粒度，严格保证消息顺序。 同一消息组内的消息的消费顺序和发送顺序完全一致。2、生产顺序为：设置消息组，保证消息顺序发送。消费方式为：并发消费，实际消息处理结果：并发消费，尽可能按时间顺序处理。3、生产顺序为：未设置消息组，消息乱序发送。消费方式为：顺序消费，实际消息处理结果：按队列存储粒度，严格顺序。 基于 Apache RocketMQ 本身队列的属性，消费顺序和队列存储的顺序一致，但不保证和发送顺序一致。4、生产顺序为：未设置消息组，消息乱序发送。消费方式为：并发消费，实际消息处理结果：并发消费，尽可能按照时间顺序处理。 engine_version String mq实例版本 consume_timeout Integer 消费超时时间 consumer_thread_nums Integer 线程消费数 consumer_batch_max_size Integer 批量消费最大消息数 max_reconsume_times Integer 最大重试次数，-1表示一直重试 suspend_current_queue_time_millis Integer 重试间隔，单位ms 表10 EventStreamingSink 参数 参数类型 描述 sink_fg SinkFGParameters object 函数事件目标的参数 sink_kafka SinkKafkaParameters object kafka事件目标的参数 sink_obs SinkObsParameters object OBS事件目标的参数 name String 事件目标类型名称 表11 SinkFGParameters 参数 参数类型 描述 invoke_type String 函数执行方式,同步/异步 urn String 函数链接 agency String 租户委托 表12 SinkKafkaParameters 参数 参数类型 描述 topic String topic名称 keyTransform Array of TransForm objects key的转换规则 connectionId String 目标连接id 表13 TransForm 参数 参数类型 描述 type String 转换规则类型 value String 常量类型规则时，字段为常量内容定义； 变量类型规则时，为变量定义，内容必须为JsonObject字符串。 变量最多支持100个，且不支持嵌套结构定义； 变量名由字母、数字、点、下划线和中划线组成，必须字母或数字开头不能以HC.开头，长度不超过64个字符； 变量值表达式支持常量或JsonPath表达式，字符串长度不超过1024个字符。 template String 变量类型规则时，规则内容的模板定义，支持对已定义变量的引用。 表14 SinkObsParameters 参数 参数类型 描述 access_key String AK secret_key String SK obs_bucket String 桶 obs_path String 转储目录 time_format String 时间目录格式 表15 rule_config 参数 参数类型 描述 transform TransForm object 订阅的事件目标转换规则 filter Object 过滤规则 表16 RunOption 参数 参数类型 描述 thread_num Integer 并发数 batch_window BatchWindow object 批量推送 表17 BatchWindow 参数 参数类型 描述 count Integer 批量推送条数[1,10000] time Integer 重试次数 interval Integer 批量推送间隔[0,15]，单位秒

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 offset 是 Integer 偏移量 最小0 最大10000 limit 是 Integer 每页展示数量 最小是10 最大是1000 conditions 否 Array of Condition objects 条件 表4 Condition 参数 是否必选 参数类型 描述 key 是 String 查询条件的key 只支持值为‘topic’ operate 是 String 查询的操作 目前支持持EQUAL LIKE value 是 Object 查询条件的值 topic的名称

响应参数 状态码：200 表5 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID 表6 响应Body参数 参数 参数类型 描述 metadata MQSyncDetailMetadata object 元数据 total Integer 总数 size Integer 数量 type String 类型 items_kafka Array of KafkaSyncDetaiData objects kafka类型的返回值，取items，不要_kafka items_rocketmq Array of RocketMQSyncDetaiData objects rocketmq型的返回值，取items，不要_rocketmq items_redis Array of RedisSyncDetaiData objects redis型的返回值，取items，不要_redis 表7 MQSyncDetailMetadata 参数 参数类型 描述 sync_remain_total Integer 剩余同步总数量 source_key_num Integer dcs源端key数量 sink_key_num Integer dcs目标端key数量 表8 KafkaSyncDetaiData 参数 参数类型 描述 topic String 主题 number Integer 数量 sync_remain_num Integer 剩余同步数量 offset_details Array of OffsetDetail objects 偏移量详情 表9 OffsetDetail 参数 参数类型 描述 partition KafkaPartition object 分区 offset KafkaOffset object 偏移量 表10 KafkaPartition 参数 参数类型 描述 cluter String 所属集群 topic String 主题 partition Integer 分区 表11 KafkaOffset 参数 参数类型 描述 offset Integer 偏移量 max_offset Integer 最大偏移量 表12 RocketMQSyncDetaiData 参数 参数类型 描述 topic String 主题 number Integer 数量 sync_remain_num Integer 剩余同步数量 offset_details Array of RocketMQOffsetDetail objects 偏移量详情 表13 RocketMQOffsetDetail 参数 参数类型 描述 queue RocketMQQueueInfo object 队列 offset RocketMQOffsetInfo object 偏移量 表14 RocketMQQueueInfo 参数 参数类型 描述 rocketmq_topic String rocketmq的主题 rocketmq_broker String rocketmq的代理 rocketmq_queue Integer rocketmq的队列 表15 RocketMQOffsetInfo 参数 参数类型 描述 rocketmq_offset Integer rocketmq的偏移量 max_offset Integer rocketmq的最大偏移量 表16 RedisSyncDetaiData 参数 参数类型 描述 sourceAddr String 源地址 ip+port描述同步地址信息 sinkAddr String 目标地址 ip+port描述同步地址信息 taskProgress String 作业进度 值在[0,1]区间，1表示进度100% syncPhase String 同步阶段 存在“全量”和“全量+增量”两种模式，当前只提供“全量+增量”模式 (full、incremental) sourceOffset Integer 源Offset 源地址数据同步量 sinkOffset Integer 目标Offset 目标地址数据同步量 taskStatus String 作业状态 created已创建、syncing 同步中、failed 作业失败、stoped 作业停止 finish 作业完成

响应示例 状态码：200 请求成功 { "cluster_id" : "fac59513-6c18-4266-bc81-5d412dfc1925", "name" : "cluster-ifpcv5u4", "description" : null, "source_type" : "KAFKA", "sink_type" : "KAFKA", "status" : "RUNNING", "job_count" : 1, "err_code" : null, "err_message" : null, "created_time" : "2024-05-16T11:46:07Z", "updated_time" : "2024-05-16T11:46:07Z", "vpc_id" : "199f632d-34e7-4915-b4d8-1bc4e2824867", "subnet_id" : "0d1799e1-116e-4551-92dc-02dd8a860072" }

响应参数 状态码：200 表3 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID 表4 响应Body参数 参数 参数类型 描述 cluster_id String 专业版事件流集群ID name String 集群名称。约束：集群名称由大小英文字母、数字、点、中划线和下划线组成，必须以大小英文字母或数字开头，最多128个字符。 description String 集群描述，约束：集群描述不能超过256位。 source_type String 源端类型 sink_type String 目标端类型 subnet_id String 子网ID vpc_id String 虚拟私有云ID zone_names String 可用区名称 status String 作业状态 job_count Number 当前集群下作业数量 flavor String 规格 charging_mode String 计费模式 err_code String 错误码 err_message String 错误原因 created_time String 创建UTC时间 updated_time String 更新UTC时间

响应参数 状态码：200 表2 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID 表3 响应Body参数 参数 参数类型 描述 cloudType String 场景 total Integer 总数 products Array of ProductInfo objects 产品信息 表4 ProductInfo 参数 参数类型 描述 product_id String 产品ID service_type String 服务类型 create_vdc_id String 创建的vcd的ID create_user_id String 创建的用户的ID icon_id String 图标ID catalog_id String 目录ID region_id String 区域ID params String 参数 name String 名称 description String 描述 create_time String 创建时间 publish_status String 发布状态 deletable_status String 可删除状态 is_default Boolean 是否为默认 true: 默认 false： 非默认 publish_scope String 发布作用域 online_scope String 在线作用域 online_status String 在线状态 approval Boolean 批准 price String 价格 resource_pool_id String 资源池ID project_id String 资源空间ID az_id String 可用区ID secret_params String 秘密参数 product_type String 产品类型 custom_catalog_info String 自定义目录信息 custom_catalog_id String 自定义目录ID version String 版本 support_user String 支持用户 charge_user String 计费用户 service_vendor String 服务厂商 register_service_type String 注册服务类型 approval_parameter_mode String 批准参数模式

响应示例 状态码：200 请求成功 { "cloudType" : "hcs", "total" : 1, "products" : [ { "product_id" : "2fc0b6d4ee5b44e294d4b23e9178d170", "service_type" : "EG", "create_vdc_id" : "all", "create_user_id" : "specialUserId", "icon_id" : "defaulticon", "catalog_id" : 6, "region_id" : "roma-dev-1", "params" : { }, "name" : "test", "description" : "", "create_time" : 1711448764000, "publish_status" : "publish", "deletable_status" : "normal", "is_default" : true, "publish_scope" : "", "online_scope" : "", "online_status" : "online", "approval" : false, "price" : null, "resource_pool_id" : null, "project_id" : null, "az_id" : null, "secret_params" : null, "product_type" : null, "custom_catalog_info" : [ ], "custom_catalog_id" : 10006, "version" : null, "support_user" : null, "charge_user" : null, "service_vendor" : null, "register_service_type" : null, "approval_parameter_mode" : null } ] }

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 id String 订阅目标ID name String 订阅的事件目标名称 provider_type String 订阅的事件目标的提供方类型 connection_id String 订阅的事件目标使用的目标链接ID detail Object 订阅的事件目标参数列表 kafka_detail KafkaTargetDetail object 订阅的kafka事件目标参数列表，该字段序列化后总长度不超过1024字节 smn_detail SmnTargetDetail object 订阅的 SMN 事件目标参数列表，该字段序列化后总长度不超过1024字节 eg_detail EgTargetDetail object 订阅的事件eg通道目标参数列表，该字段序列化后总长度不超过1024字节，eg通道目标必填 apigw_detail ApigwTargetDetail object 订阅的事件APIGWurl目标参数列表，该字段序列化后总长度不超过1024字节，APIGW目标必填 retry_times Integer 重试次数 transform TransForm object 订阅的事件目标转换规则 dead_letter_queue DeadLetterQueue object 订阅的死信参数列表 created_time String 创建时间 updated_time String 更新时间 表5 KafkaTargetDetail 参数 参数类型 描述 topic String 主题 keyTransform keyTransform object 键值规则 表6 keyTransform 参数 参数类型 描述 type String 键值规则类型 value String 键值规则，键值规则为VARIABLE，CONSTANT时必填 template String 键值规则模板，键值规则为VARIABLE时必填 表7 SmnTargetDetail 参数 参数类型 描述 urn String 主题urn agency_name String 委托名称 subject_transform subject_transform object 标题规则 表8 subject_transform 参数 参数类型 描述 type String 标题规则类型 value String 标题规则 template String 标题规则模板，键值规则为VARIABLE时必填 表9 EgTargetDetail 参数 参数类型 描述 target_project_id String 目标项目id target_channel_id String 目标通道id target_region String 目标region cross_region Boolean 跨region开关 cross_account Boolean 跨账号开关 agency_name String 委托名称 表10 ApigwTargetDetail 参数 参数类型 描述 url String 目标url invocation_http_parameters InvocationHttpParameters object 调用Http的参数 表11 InvocationHttpParameters 参数 参数类型 描述 header_parameters Array of HeaderParameter objects 对象列表 表12 HeaderParameter 参数 参数类型 描述 is_value_secret Boolean 是否加密 key String header的key值 value String deader的value值 表13 TransForm 参数 参数类型 描述 type String 转换规则类型 value String 常量类型规则时，字段为常量内容定义； 变量类型规则时，为变量定义，内容必须为JsonObject字符串。 变量最多支持100个，且不支持嵌套结构定义； 变量名由字母、数字、点、下划线和中划线组成，必须字母或数字开头不能以HC.开头，长度不超过64个字符； 变量值表达式支持常量或JsonPath表达式，字符串长度不超过1024个字符。 template String 变量类型规则时，规则内容的模板定义，支持对已定义变量的引用。 表14 DeadLetterQueue 参数 参数类型 描述 type String 队列类型 instance_id String 实例id connection_id String 目标连接id topic String 主题

响应示例 状态码：200 详情 { "id" : "3a0eeff2-78a4-4122-dfge-7ty5e37f64er", "name" : "WEBHOOK", "provider_type" : "CUSTOM", "connection_id" : "456eekj3-778u-4tyu-dfrt-er55e37f667t", "detail" : { "url" : "http://10.213.96.90:8080/t/nodeapp/trigger-hello-nodejs" }, "kafka_detail" : { }, "smn_detail" : { }, "eg_detail" : { }, "apigw_detail" : { }, "retry_times" : 16, "transform" : { }, "dead_letter_queue" : { }, "created_time" : "2021-12-09 09:00:00", "updated_time" : "2021-12-09 09:00:00" }

URI GET /v1/{project_id}/subscriptions/{subscription_id}/targets/{target_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户资源空间ID subscription_id 是 String 事件订阅ID target_id 是 String 事件订阅目标ID 表2 Query参数 参数 是否必选 参数类型 描述 enterprise_project_id 否 String 创建订阅时所使用的企业项目id

响应示例 状态码：200 详情 { "id" : "23709d68-54d5-423b-a6be-03302e893152", "name" : "test-subscription", "description" : "this is a test subscription", "type" : "EVENT", "status" : "CREATED", "channel_id" : "05649f9a-b324-4920-9c49-156d4cd2e546", "channel_name" : "channel006", "used" : [ { } ], "sources" : [ { } ], "targets" : [ { } ], "created_time" : "2021-12-09 09:00:00", "updated_time" : "2021-12-09 09:00:00" }

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 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 更新时间 表5 SubscriptionUsedInfo 参数 参数类型 描述 resource_id String 关联资源ID owner String 管理租户账号 description String 描述 表6 SubscriptionSourceInfo 参数 参数类型 描述 id String 订阅源ID name String 订阅的事件源名称 provider_type String 订阅的事件源的提供方类型 detail Object 订阅的事件源参数列表 filter Object 订阅事件源的匹配过滤规则 created_time String 创建时间 updated_time String 更新时间 表7 SubscriptionTargetInfo 参数 参数类型 描述 id String 订阅目标ID name String 订阅的事件目标名称 provider_type String 订阅的事件目标的提供方类型 connection_id String 订阅的事件目标使用的目标链接ID detail Object 订阅的事件目标参数列表 kafka_detail KafkaTargetDetail object 订阅的kafka事件目标参数列表，该字段序列化后总长度不超过1024字节 smn_detail SmnTargetDetail object 订阅的SMN事件目标参数列表，该字段序列化后总长度不超过1024字节 eg_detail EgTargetDetail object 订阅的事件eg通道目标参数列表，该字段序列化后总长度不超过1024字节，eg通道目标必填 apigw_detail ApigwTargetDetail object 订阅的事件APIGWurl目标参数列表，该字段序列化后总长度不超过1024字节，APIGW目标必填 retry_times Integer 重试次数 transform TransForm object 订阅的事件目标转换规则 dead_letter_queue DeadLetterQueue object 订阅的死信参数列表 created_time String 创建时间 updated_time String 更新时间 表8 KafkaTargetDetail 参数 参数类型 描述 topic String 主题 keyTransform keyTransform object 键值规则 表9 keyTransform 参数 参数类型 描述 type String 键值规则类型 value String 键值规则，键值规则为VARIABLE，CONSTANT时必填 template String 键值规则模板，键值规则为VARIABLE时必填 表10 SmnTargetDetail 参数 参数类型 描述 urn String 主题urn agency_name String 委托名称 subject_transform subject_transform object 标题规则 表11 subject_transform 参数 参数类型 描述 type String 标题规则类型 value String 标题规则 template String 标题规则模板，键值规则为VARIABLE时必填 表12 EgTargetDetail 参数 参数类型 描述 target_project_id String 目标项目id target_channel_id String 目标通道id target_region String 目标region cross_region Boolean 跨region开关 cross_account Boolean 跨账号开关 agency_name String 委托名称 表13 ApigwTargetDetail 参数 参数类型 描述 url String 目标url invocation_http_parameters InvocationHttpParameters object 调用Http的参数 表14 InvocationHttpParameters 参数 参数类型 描述 header_parameters Array of HeaderParameter objects 对象列表 表15 HeaderParameter 参数 参数类型 描述 is_value_secret Boolean 是否加密 key String header的key值 value String deader的value值 表16 TransForm 参数 参数类型 描述 type String 转换规则类型 value String 常量类型规则时，字段为常量内容定义； 变量类型规则时，为变量定义，内容必须为JsonObject字符串。 变量最多支持100个，且不支持嵌套结构定义； 变量名由字母、数字、点、下划线和中划线组成，必须字母或数字开头不能以HC.开头，长度不超过64个字符； 变量值表达式支持常量或JsonPath表达式，字符串长度不超过1024个字符。 template String 变量类型规则时，规则内容的模板定义，支持对已定义变量的引用。 表17 DeadLetterQueue 参数 参数类型 描述 type String 队列类型 instance_id String 实例id connection_id String 目标连接id topic String 主题

URI GET /v1/{project_id}/subscriptions/{subscription_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户资源空间ID subscription_id 是 String 事件订阅ID 表2 Query参数 参数 是否必选 参数类型 描述 enterprise_project_id 否 String 创建订阅时所使用的企业项目id

响应示例 状态码：200 事件轨迹的返回体 { "eventId" : "21637dd2-c4af-46e9-a4ba-f21b71deaa82", "eventSource" : null, "eventType" : null, "receiveTime" : 0, "channelId" : "65688f41-81d4-479f-bd8f-9727e7595128", "channelName" : "default", "deliverList" : [ { "subscriptionId" : "83799a5c-4e3e-49e5-b2cf-a5aa38758ee0", "subscriptionName" : "subscription-03us", "successCounts" : 0, "failCounts" : 1, "allDeliverTimes" : 7, "deliverTargetList" : [ { "deliverTargetId" : "2ae78b38-46c5-4f64-a1d3-0fc6b0b9324e", "deliverTargetName" : "HC.FunctionGraph", "deliverStatus" : "fail", "deliverDetailList" : [ { "deliverTime" : "2023-03-17 18:37:38", "deliverStatus" : "FAILED", "deliverConsuming" : 1679049458706, "deliverRspCode" : "" }, { "deliverTime" : "2023-03-17 18:37:38", "deliverStatus" : "FAILED", "deliverConsuming" : 0, "deliverRspCode" : "" }, { "deliverTime" : "2023-03-17 18:37:38", "deliverStatus" : "FAILED", "deliverConsuming" : 0, "deliverRspCode" : "" }, { "deliverTime" : "2023-03-17 18:37:38", "deliverStatus" : "FAILED", "deliverConsuming" : 0, "deliverRspCode" : "" }, { "deliverTime" : "2023-03-17 18:37:38", "deliverStatus" : "FAILED", "deliverConsuming" : 0, "deliverRspCode" : "" }, { "deliverTime" : "2023-03-17 18:37:38", "deliverStatus" : "FAILED", "deliverConsuming" : 0, "deliverRspCode" : "" }, { "deliverTime" : "2023-03-17 18:37:38", "deliverStatus" : "FAILED", "deliverConsuming" : 0, "deliverRspCode" : "" } ] } ] } ] }

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 eventId String 事件ID eventSource String 事件源 eventType String 事件类型 receiveTime String 接收时间 channelId String 通道ID channelName String 通道名称 deliverList Array of DeliverItem objects 事件投递列表 表5 DeliverItem 参数 参数类型 描述 subscriptionId String 订阅ID，全局唯一 subscriptionName String 订阅名称 successCounts Integer 成功目标个数 failCounts Integer 失败目标个数 allDeliverTimes Integer 共投递次数 deliverTargetList Array of DeliverTarget objects 投递详情 表6 DeliverTarget 参数 参数类型 描述 deliverTargetId String 投递目标ID，即事件目标ID deliverTargetName String 投递目标名称，及事件目标名称 deliverStatus String 投递状态 SUC CES S Or FAILED deliverDetailList Array of DeliverDetail objects 考虑展示的个数 例如限制只展示最新三条 表7 DeliverDetail 参数 参数类型 描述 deliverTime String 投递时间 格式 yyyy/mm/dd xx:yy:zz deliverStatus String 投递状态 SUCCESS Or FAILED deliverConsuming String 投递耗时，单位ms deliverRspCode String 投递响应码

响应示例 状态码：200 更新成功 { "id" : "90e0b962-c6c1-438c-ba8a-3024fe592bda", "name" : "first-source", "label" : "first-source", "description" : "first event source", "provider_type" : "CUSTOM", "event_types" : [ { "name" : "OBS:CloudTrace:ApiCall", "description" : "服务API调用类型事件" } ], "created_time" : "2021-12-09 09:00:00", "updated_time" : "2021-12-09 09:00:00", "channel_id" : "bd14144e-8f3c-43d6-bdfd-bf09b52c2b96", "channel_name" : "channel", "type" : "RABBITMQ", "detail" : "{\"instance_id\":\"ac14144e-9v3c-43d6-acfd-bf09b52c98uy\",\"user_name\":\"rabbitmq_user\",\"password\":\"changeme\",\"vhost_name\":\"vhost_name\",\"queue_name\":\"queue_name\"}", "status" : "RUNNING", "error_info" : { } }

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 id String 事件源ID name String 事件源名称 label String 事件源名称展示 description String 事件源描述 provider_type String 事件源提供方类型，OFFICIAL：官方云服务事件源；CUSTOM：用户创建的自定义事件源；PARTNER：伙伴事件源 event_types Array of event_types objects 事件源提供的事件类型列表，只有官方云服务事件源提供事件类型 created_time String 创建UTC时间 updated_time String 更新UTC时间 channel_id String 事件源归属的事件通道ID channel_name String 事件源归属的事件通道名称 type String 事件源类型 detail Object json格式封装消息实例链接信息：如RabbitMQ实例的instance_id字段、 虚拟主机 vhost字段、队列queue字段、用户名、密码等 status String 自定义事件源状态 error_info ErrorInfo object 错误信息 表4 event_types 参数 参数类型 描述 name String 事件类型名称 description String 事件类型描述 表5 ErrorInfo 参数 参数类型 描述 error_code String 错误码 error_detail String 错误详情 error_msg String 错误信息

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 id String 事件模型版本ID schema_id String 事件模型ID version Integer 事件模型版本号 format String 事件模型格式 created_time String 创建时间 updated_time String 更新时间 definition String 事件模型内容定义

响应示例 状态码：200 详情 { "id" : "6f70e150-f20c-4c22-85aa-78ceecd52b98", "schema_id" : "2a0ee4f2-78a4-4122-80af-7455e37f64ee", "version" : 1, "format" : "OPENAPI_3_0", "created_time" : "2021-12-09 09:00:00", "updated_time" : "2021-12-09 09:00:00", "definition" : "{\"$schema\": \"http://json-schema.org/draft-06/schema#\",\"title\": \"fileUpload\",\"definitions\": {\"fileUpload\": {\"properties\": {\"fileName\": {\"type\": \"string\"},\"fileSize\": {\"type\": \"integer\"}},\"required\": [\"foo\",\"bar\"],\"type\": \"object\"}},\"properties\": {\"specversion\": {\"type\": \"string\"},\"id\": {\"type\": \"string\"},\"type\": {\"type\": \"string\"},\"source\": {\"type\": \"string\"},\"subject\": {\"type\": \"string\"},\"datacontenttype\": {\"type\": \"string\"},\"dataschema\": {\"type\": \"string\"},\"time\": {\"format\": \"date-time\",\"type\": \"string\"},\"data\": {\"$ref\": \"#/definitions/fileUpload\"}},\"required\": [\"id\",\"source\",\"time\",\"type\",\"specversion\"],\"type\": \"object\"}" }

响应示例 状态码：200 详情 { "id" : "2a0ee4f2-78a4-4122-80af-7455e37f64ee", "name" : "file.upload", "description" : "文件上传事件模型定义", "compatibility" : "NONE", "provider_type" : "CUSTOM", "format" : "OPENAPI_3_0", "number_of_versions" : 1, "created_time" : "2021-12-09 09:00:00", "updated_time" : "2021-12-09 09:00:00", "version" : 1, "definition" : "{\"$schema\": \"http://json-schema.org/draft-06/schema#\",\"title\": \"fileUpload\",\"definitions\": {\"fileUpload\": {\"properties\": {\"fileName\": {\"type\": \"string\"},\"fileSize\": {\"type\": \"integer\"}},\"required\": [\"foo\",\"bar\"],\"type\": \"object\"}},\"properties\": {\"specversion\": {\"type\": \"string\"},\"id\": {\"type\": \"string\"},\"type\": {\"type\": \"string\"},\"source\": {\"type\": \"string\"},\"subject\": {\"type\": \"string\"},\"datacontenttype\": {\"type\": \"string\"},\"dataschema\": {\"type\": \"string\"},\"time\": {\"format\": \"date-time\",\"type\": \"string\"},\"data\": {\"$ref\": \"#/definitions/fileUpload\"}},\"required\": [\"id\",\"source\",\"time\",\"type\",\"specversion\"],\"type\": \"object\"}" }

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 id String 事件模型ID name String 事件模型名称，租户下唯一 description String 事件模型描述 compatibility String 事件模型兼容性 provider_type String 提供方类型，OFFICIAL：官方事件源；CUSTOM：自定义事件源 format String 事件模型格式 number_of_versions Integer 事件模型版本数 created_time String 创建时间 updated_time String 更新时间 version Integer 事件模型当前版本号 definition String 事件模型内容定义

响应示例 状态码：200 详情 { "id" : "90e0b962-c6c1-438c-ba8a-3024fe592bda", "name" : "private-link", "description" : "", "status" : "CREATING", "error_info" : { }, "vpc_id" : "ac14144e-8fec-53d6-bdfd-8f09b52c09iu", "subnet_id" : "bf14153e-5fec-67d6-b89d-5409b52c0op8", "agency" : "EG_TRUST", "flavor" : { "name" : "default", "concurrency_type" : "exclusive", "concurrency" : 500, "bandwidth_type" : "exclusive" }, "type" : { }, "kafka_detail" : { }, "created_time" : "2021-12-09 09:00:00", "updated_time" : "2021-12-09 09:00:00" }

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 id String 事件源ID name String 目标连接名称，租户下唯一，由小写字母、数字、点、下划线和中划线组成，必须以字母或数字开头，不能为default description String 目标连接描述 status String 目标连接状态 error_info ErrorInfo object 错误信息 vpc_id String 待连接的VPC ID subnet_id String 待连接的子网ID agency String 私网目标连接使用的用户委托名称 flavor flavor object 规格 type String 目标连接类型。目前支持webhook：http连接；kafka：华为云官方kafka实例 kafka_detail KafkaConnectionDetail object kafka连接参数 created_time String 创建UTC时间 updated_time String 更新UTC时间 表4 ErrorInfo 参数 参数类型 描述 error_code String 错误码 error_detail String 错误详情 error_msg String 错误信息 表5 flavor 参数 参数类型 描述 name String 规格名称 concurrency_type String 并发规格类型 concurrency Integer 并发数 bandwidth_type String 带宽类型 表6 KafkaConnectionDetail 参数 参数类型 描述 instance_id String kafka实例id。 addr String kafka连接地址。 security_protocol String 安全协议。 enable_sasl_ssl Boolean kafka实例是否开启了SASL_SSL。 user_name String kafka实例用户名。实例开启了SASL_SSL时必填 password String kafka实例密码。实例开启了SASL_SSL时必填 acks String 收到Server端确认信号个数，表示procuder需要收到多少个这样的确认信号，算消息发送成功。acks参数代表了数据备份的可用性。支持选项： acks=0：表示producer不需要等待任何确认收到的信息，副本将立即加到socket buffer并认为已经发送。没有任何保障可以保证此种情况下server已经成功接收数据，同时重试配置不会发生作用（因为客户端不知道是否失败）回馈的offset会总是设置为-1。 acks=1：这意味着至少要等待leader已经成功将数据写入本地log，但是并没有等待所有follower是否成功写入。如果follower没有成功备份数据，而此时leader又无法提供服务，则消息会丢失。 acks=all：这意味着leader需要等待ISR中所有备份都成功写入日志，只有任何一个备份存活，数据都不会丢失。min.insync.replicas指定必须确认写入才能被认为成功的副本的最小数量。