功能说明 GetBucketObjectLock请求获取存储桶的对象锁定配置。对象锁定功能将会应用到每一个新放入到存储桶中的对象。 请求消息样式 plaintext GET /{Bucket}?objectlock HTTP/1.1 Host: xxxx.zos.ctyun.cn AcceptEncoding: identity xamzcontentsha256: ContentSHA256 xamzdate: 20220407T022928Z Authorization: string 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: tx00000000000000000000f00624e4c895e72default ContentType: application/xml ContentLength: 222 Date: Thu, 07 Apr 2022 02:29:45 GMT Connection: KeepAlive string integer string integer 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 参数名称 参数描述 类型 ObjectLockConfiguration 参数解释： 桶的名称。 Container 表ObjectLockConfiguration 参数名称 参数描述 类型 ObjectLockEnabled 参数解释： 指定桶的对象锁定功能是否生效。 String Rule 参数解释： 对象锁定规则。 Container 表Rule 参数名称 参数描述 类型 DefaultRetention 参数解释： 对象锁定规则中指定的默认配置。 Container 表DefaultRetention 参数名称 参数描述 类型 Mode 参数解释： 对象锁定规则中指定的默认保留期限模式。 取值范围： GOVERNANCE：监管模式 COMPLIANCE：合规性模式 String Days 参数解释： 保留期限日期，单位：天。与Years设置只能二选一。 Long Years 参数解释： 保留期限日期，单位：年。与Days设置只能二选一。 Long

生产消息 进入Kafka客户端文件的“/bin”目录下，执行如下命令进行生产消息。 ./kafkaconsoleproducer.sh brokerlist ​{连接地址} topic 连接地址−−topic​{Topic名称} producer.config ../config/producer.properties 参数说明如下： 连接地址：从前提条件获取的连接地址。 Topic名称：Kafka实例下创建的Topic名称。 示例如下，“10.3.196.45:9095,10.78.42.127:9095,10.4.49.103:9095”为Kafka实例连接地址。 执行完命令后，输入需要生产的消息内容，按“Enter”发送消息到Kafka实例，输入的每一行内容都将作为一条消息发送到Kafka实例。 [root@ecskafka bin] ./kafkaconsoleproducer.sh brokerlist 10.3.196.45:9095,10.78.42.127:9095,10.4.49.103:9095 topic topicdemo producer.config ../config/producer.propertiesHello DMS Kafka! ^C[root@ecskafka bin] 如需停止生产使用Ctrl+C命令退出。 消费消息 执行如下命令消费消息。 ./kafkaconsoleconsumer.sh bootstrapserver ​{连接地址} topic 连接地址−−topic​{Topic名称} group ${消费组名称} frombeginning consumer.config ../config/consumer.properties 参数说明如下： 连接地址：从前提条件获取的连接地址。 Topic名称：Kafka实例下创建的Topic名称。 消费组名称：根据您的业务需求，设定消费组名称。 如果已经在配置文件中指定了消费组名称，请确保命令行中的消费组名称与配置文件中的相同，否则可能消费失败 。 消费组名称开头包含特殊字符，例如下划线“”、 号“ ”时，监控数据无法展示。 示例如下： [root@ecskafka bin]

场景描述 在RocketMQ中，删除消费组的场景可以有以下几种情况： 业务变更：当某个业务不再需要使用消费组时，可以删除该消费组。例如，某个业务已经停止使用RocketMQ作为消息中间件，或者该业务的订阅逻辑发生了变化，不再需要使用该消费组。 重构订阅逻辑：当订阅逻辑发生较大变化时，可能需要删除原有的消费组，并重新创建一个新的消费组。例如，原有的消费组无法满足新的业务需求，或者需要重新设计消费组的消费者数量、消费策略等配置。 清理无用消费组：在RocketMQ中，可能会存在一些无用的消费组，这些订阅组可能是之前测试或开发过程中创建的，但在实际生产环境中已经不再使用。为了清理无用的消费组，可以进行删除操作，以减少资源占用和管理复杂度。 需要注意的是，在删除消费组之前，需要确保该消费组没有任何未处理的消息。如果消费组中还存在未消费的消息，删除消费组可能会导致消息丢失。因此，在删除消费组之前，建议先停止该消费组的消费者，并确保所有消息都已经被消费或者转移到其他消费组。 总之，删除消费组的场景包括业务变更、重构订阅逻辑和清理无用消费组。在删除消费组之前，需要确保没有未处理的消息，并谨慎操作，以避免消息丢失和其他问题的发生。 操作步骤 1、进入消费组管理菜单。 2、在消费组管理菜单选择将要删除的消费组，点击删除按钮，即可完成删除。

响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: Request Id ContentLength: 0 Date: Date Connection: KeepAlive 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 该请求的响应中不带有响应元素。 错误码 请参见调用前必知错误码全局错误码。

功能说明 AbortMultipartUpload用来实现舍弃一个分块上传并删除已上传的块。当您调用该请求时，如果有正在使用这个uploadId上传块的请求，则该上传会返回失败。 请求消息样式 plaintext DELETE /{Bucket}/{key}?uploadId2~DixxGkXNw6F79q2AcwMQH41XMMkUr HTTP/1.1 Host: xxx.zos.ctyun.cn xamzcontentsha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b85 xamzdate: 20220406T063538Z Authorization: AWS4HMACSHA256 Credentialbase/20220406/useast1/s3/aws4request, SignedHeadershost;xamzacl;xamzcontentsha256;xamzdate;xamzstorageclass;xamztagging, Signature4f31f3b56e248aa32b165005714448c3fe30b38a76e1c3cdeac11bf5d8314963 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： Bucket的名称。 String 是 Key 参数解释： 上传对象在集群中保存的对象名称。 String 是 uploadId 参数解释： 分段上传的ID。 String 是 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: tx00000000000000000004b00624d5da35403fdefault Date: Wed, 06 Apr 2022 09:30:11 GMT Connection: KeepAlive

功能说明 AbortMultipartUpload用来实现舍弃一个分块上传并删除已上传的块。当您调用该请求时，如果有正在使用这个uploadId上传块的请求，则该上传会返回失败。 请求消息样式 plaintext DELETE /{Bucket}/{key}?uploadId2~DixxGkXNw6F79q2AcwMQH41XMMkUr HTTP/1.1 Host: xxx.zos.ctyun.cn xamzcontentSHA256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b85 xamzDate: 20220406T063538Z Authorization: AWS4HMACSHA256 Credentialbase/20220406/useast1/s3/aws4request, SignedHeadershost;xamzacl;xamzcontentsha256;xamzdate;xamzstorageclass;xamztagging, Signature4f31f3b56e248aa32b165005714448c3fe30b38a76e1c3cdeac11bf5d8314963 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： Bucket的名称。 String 是 Key 参数解释： 上传对象在集群中保存的对象名称。 String 是 uploadId 参数解释： 分段上传的ID。 String 是 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: tx00000000000000000004b00624d5da35403fdefault Date: Wed, 06 Apr 2022 09:30:11 GMT Connection: KeepAlive

本文主要介绍 步骤二:创建Kafka实例。 前提条件 在创建Kafka实例前，需要保证存在可使用的虚拟私有云。创建方法，请参考《虚拟私有云 用户指南》的“创建虚拟私有云和子网”。 如果您已有虚拟私有云，可重复使用，不需要多次创建。 操作步骤 步骤 1 登录分布式消息服务Kafka控制台，单击页面右上方的“购买Kafka实例”。 步骤 2 选择计费模式。 步骤 3 在“区域”下拉列表中，选择靠近您应用程序的区域，可降低网络延时、提高访问速度。 步骤 4 在“项目”下拉列表中，选择项目。 步骤 5 在“可用区”区域，根据实际情况选择1个或者3个及以上可用区。 步骤 6 设置“实例名称”和“企业项目”。 步骤 7 设置实例信息。 1. 版本：Kafka的版本号，支持1.1.0、2.7和3.x，根据实际情况选择，推荐使用3.x。 Kafka实例创建后，版本号不支持修改 。 2. 鲲鹏实例，“创建鲲鹏架构实例”选框，默认不勾选是X86架构的实例，勾选之后是ARM架构的鲲鹏实例。 3. 在“代理规格”中，请根据业务需求选择相应的代理规格。在“代理数量”中，选择代理个数。 单个代理最大分区数代理个数实例分区数上限。当所有Topic的总分区数大于实例分区数上限时，创建Topic失败。 4. 在“存储空间”区域，您根据实际需要选择存储Kafka数据的磁盘类型和总磁盘大小。 Kafka实例创建后，磁盘类型不支持修改 。 存储空间包含所有副本存储空间总和，建议根据业务消息体积以及副本数量选择存储空间大小。假设业务存储数据保留天数内磁盘大小为100GB，则磁盘容量最少为100GB副本数 + 预留磁盘大小100GB。 创建实例时会进行磁盘格式化，磁盘格式化会导致实际可用磁盘为总磁盘的93%~95%。 5. 在“容量阈值策略”区域，设置磁盘使用达到容量阈值后的消息处理策略，容量阈值为95%。 自动删除：可以正常生产和消费消息，但是会删除最早的10%的消息，以保证磁盘容量充足。该场景优先保障业务不中断，数据存在丢失的风险。 生产受限：无法继续生产消息，但可以继续消费消息。该场景适用于对数据不能丢的业务场景，但是会导致生产业务失败。 图 创建Kafka实例 步骤 8 设置实例网络环境信息。 1. 在“虚拟私有云”下拉列表，选择已经创建好的虚拟私有云和子网。 说明 虚拟私有云和子网在Kafka实例创建完成后，不支持修改。 子网开启IPv6后，Kafka实例支持IPv6功能。Kafka实例开启IPv6后，客户端可以使用IPv6地址连接实例。 子网开启IPv6后，页面才展示此参数。开启IPv6后，客户端可以使用IPv6地址连接实例。 开启IPv6的实例不支持动态开启和关闭SASLSSL功能。 实例创建成功后，不支持修改IPv6开关。 3. 在“安全组”下拉列表，可以选择已经创建好的安全组。 安全组是一组对Kafka实例的访问规则的集合。您可以单击右侧的“管理安全组”，跳转到网络控制台的“安全组”页面，查看或创建安全组。 步骤 9 设置登录Kafka Manager的用户名和密码。创建实例后，Kafka Manager用户名无法修改。 Kafka Manager是开源的Kafka集群管理工具，实例创建成功后，实例详情页面会展示Kafka Manager登录地址，您可登录Kafka Manager页面，查看Kafka集群的监控、代理等信息。 步骤 10 设置实例购买时长。 当选择了“包年/包月”付费模式时，页面才显示“购买时长”参数，您需要根据业务需要选择。 步骤 11 单击“更多配置”，设置更多相关信息。 1. 设置“公网访问”。 “公网访问”默认为关闭状态，根据业务需求选择是否开启。开启公网访问后，还需要为每个代理设置对应的IPv4弹性IP地址。 图 设置公网访问开关 2. 设置“Kafka SASLSSL”。 客户端连接Kafka实例时，是否开启SSL认证。开启Kafka SASLSSL，则数据加密传输，安全性更高。 “Kafka SASLSSL”默认为关闭状态，您可以选择是否开启。 Kafka实例创建后，Kafka SASLSSL开关不支持修改 ，请慎重选择。如果创建后需要修改，需要重新创建实例。 开启Kafka SASLSSL后，您可以选择是否开启“SASL PLAIN 机制”。未开启“SASL PLAIN 机制”时，使用SCRAMSHA512机制传输数据，开启“SASL PLAIN 机制”后，同时支持SCRAMSHA512机制和PLAIN机制，根据实际情况选择其中任意一种配置连接。Kafka实例创建后，SASL PLAIN机制开关不支持修改。 什么是SCRAMSHA512机制和PLAIN机制？ SCRAMSHA512机制：采用哈希算法对用户名与密码生成凭证，进行身份校验的安全认证机制，比PLAIN机制安全性更高。 PLAIN机制：一种简单的用户名密码校验机制。 开启Kafka SASLSSL后，您需要设置连接Kafka实例的用户名和密码。 3. 设置“Kafka自动创建Topic”。 “Kafka自动创建Topic”默认为关闭状态，您可以选择是否开启。 开启“Kafka自动创建Topic”表示生产或消费一个未创建的Topic时，系统会自动创建此Topic，此Topic的默认参数值如下：分区数为3，副本数为3，老化时间为72小时，不开启同步复制和同步落盘。 如果在“配置参数”中修改“log.retention.hours”、“default.replication.factor”或“num.partitions”的参数值，此后自动创建的Topic参数值为修改后的参数值。例如：“num.partitions”修改为“5”，自动创建的Topic参数值如下：分区数为5，副本数为3，老化时间为72小时，不开启同步复制和同步落盘。 4. 设置“标签”。 标签用于标识云资源，当您拥有相同类型的许多云资源时，可以使用标签按各种维度（例如用途、所有者或环境）对云资源进行分类。 如果您已经预定义了标签，在“标签键”和“标签值”中选择已经定义的标签键值对。另外，您可以单击“查看预定义标签”，跳转到标签管理服务页面，查看已经预定义的标签，或者创建新的标签。 您也可以直接在“标签键”和“标签值”中设置标签。 当前每个Kafka实例最多支持设置20个不同标签，标签的命名规格，请参考管理实例标签。 5. 设置实例的描述信息。 步骤 12 填写完上述信息后，单击“立即购买”，进入规格确认页面。 步骤 13 确认实例信息无误后，提交请求。 步骤 14 单击“返回Kafka专享版”，查看Kafka实例是否创建成功。 创建实例大约需要3到15分钟，此时实例的“状态”为“创建中”。 当实例的“状态”变为“运行中”时，说明实例创建成功。 如果创建实例失败，在信息栏的“创建失败任务”中查看创建失败的实例。请删除创建失败的实例，然后重新创建。如果重新创建仍然失败，请联系客服。 说明 创建失败的实例，不会占用其他资源。

功能说明 Get Bucket CORS用来请求获取桶的跨域资源共享权限配置。 请求消息样式 plaintext GET /{Bucket}?cors HTTP/1.1 Host: xxx.zos.ctyun.cn xamzdate: Date xamzcontentsha256: ContentSHA256 Authorization: Auth String ContentLength: ContentLength 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: Request Id ContentType: ContentType ContentLength: ContentLength Date: Date Connection: KeepAlive string ... string ... string ... string ... string integer ... 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 该响应中将桶的跨域资源共享权限配置信息以消息元素的形式返回，元素的具体含义如下表所示： 参数名称 参数描述 类型 CORSConfiguration 参数解释： 描述存储桶中对象的跨源访问配置。 Container 表CORSConfiguration 参数名称 参数描述 类型 CORSRule 参数解释： 为指定bucket配置的所有跨域规则的集合。 约束限制： 最多允许配置100条规则。 Contanier 表CORSRule 参数名称 参数描述 类型 ID 参数解释： 跨域规则的ID。 约束限制： 最长长度为255个字符。 String AllowedHeader 参数解释： 允许浏览器发送CORS请求时携带的自定义HTTP请求头部。 约束限制： 不区分英文大小写，单条CORSRule可以配置多个AllowedHeader。 String AllowedMethod 参数解释： 允许该源执行的HTTP方法列表。 约束限制： 只能填入GET、PUT、HEAD、POST和DELETE，单条规则可以配置多个方法。 String AllowedOrigin 参数解释： 允许能够访问该bucket的一个或多个源,支持 通配符，表示所有域名都允许访问，不推荐。 约束限制： 一条CORSRule可以配置多个AllowedOrigin。 String ExposeHeader 参数解释： 允许浏览器获取的CORS请求响应中的头部。 约束限制： 不区分英文大小写，单条CORSRule可以配置多个 ExposeHeader。 String MaxAgeSeconds 参数解释： 跨域资源共享配置的有效时间，单位为秒，对应CORS请求响应中的AccessControlMaxAge头部。 约束限制： 单条CORSRule只能配置一个MaxAgeSeconds。 Integer

本文主要介绍消费组问题。 Kafka实例是否需要创建消费组、生产者和消费者？ 不需要单独创建消费组、生产者和消费者，在使用时自动生成，实例创建后，直接使用即可。 连接Kafka实例后，生产消息和消费消息，请参考向Kafka实例生产消息和消费消息。 如果消息组中没有在线的消费者（如empty状态），是否14天后会自动被删除？ 消息组中没有在线的消费者（如empty状态），14天后是否会自动被删除与offsets.retention.minutes参数有关： 2020年6月16日前创建的实例，offsets.retention.minutes默认为2147483646分钟，约1491308天，消费组14天后不会被删除。 2020年6月16日以及之后创建的实例，offsets.retention.minutes默认为20160分钟，即14天，消费组14天后会自动被删除。 原因如下： Kafka通过offsets.retention.minutes参数控制消费组中offsets保留时间，在此时间内如果没有提交offset，offsets将会被删除。Kafka判定消息组中没有在线的消费者（如empty状态），且没有offsets时，将会删除此消费组。 客户端删除消费组后，在Kafka Manager中仍可以看到此消费组？ 客户端删除消费组后，此消费组已经被删除了。在Kafka Manager中仍可以看到此消费组，是因为Kafka Manager存在缓存。 通过以下任意一种方法解决此问题： 重启Kafka Manager。 Kafka Manager只显示14天内有消费记录的消费组，如果您不想重启Kafka Manager，可以等待14天后Kafka Manager自动清除此消费组。

请求消息元素 参数名称 参数描述 类型 是否必须 AccessControlPolicy 参数解释： 授权信息的根标签。 Container 消息体方式下必须 表AccessControlPolicy 参数名称 参数描述 类型 是否必须 Owner 参数解释： 桶的所有者。 Container 消息体方式下必须 AccessControlList 参数解释： 授权列表。 Container 消息体方式下必须 表Owner 参数名称 参数描述 类型 是否必须 ID 参数解释： 桶所有者的uid。 String 消息体方式下必须 表AccessControlList 参数名称 参数描述 类型 是否必须 Grant 参数解释： 授权信息。 Container 消息体方式下必须 表Grant 参数名称 参数描述 类型 是否必须 Grantee 参数解释： 授权主体。 Container 消息体方式下必须 Permission 参数解释： 授予的权限。 取值范围： FULLCONTROL、WRITE 、WRITEACP、READ、READACP String 消息体方式下必须 表Grantee 参数名称 参数描述 类型 是否必须 ID 参数解释： 被授权用户的UID。 String CanonicalUser类型下必须 xsi:type 参数解释： 被授权用户类型。 取值范围： CanonicalUser 、Group String 消息体方式下必须 URI 参数解释： 被授权组URI。 取值范围： 所有用户： 所有认证用户： String Group类型下必须

响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: Request Id ContentType: ContentType ContentLength: ContentLength Date: Date Connection: KeepAlive 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 该请求的响应中不带有响应元素。 错误码 请参见调用前必知错误码全局错误码。

响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: Request Id ContentType: ContentType ContentLength: ContentLength Date: Date Connection: KeepAlive 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 该请求的响应中不带有响应元素。 错误码 请参见调用前必知错误码全局错误码。

本文主要介绍实例规格变更问题。 Kafka扩容/缩容会影响业务吗？ Kafka扩容带宽/代理个数/存储空间，都不会影响业务的使用。 Kafka扩容代理规格，在扩容过程中，节点会重启，可能造成闪断。若Topic为单副本，扩容期间无法对该Topic生产消息或消费消息。 表 变更实例规格的影响 变更配置类型 影响 基准带宽/代理数量 扩容基准带宽/代理数量不会影响原来的代理，业务也不受影响。 扩容基准带宽/代理数量时，系统会根据当前磁盘大小进行相应比例的存储空间扩容。例如扩容前实例的代理数为3，每个代理的磁盘大小为200GB，扩容后实例的代理数为10，此时代理的磁盘大小依旧为200GB，但是总磁盘大小为2000GB。 新创建的Topic才会分布在新代理上，原有Topic还分布在原有代理上，造成分区分布不均匀。通过修改Kafka分区平衡，实现将原有Topic分区的副本迁移到新代理上。 存储空间 扩容存储空间有次数限制，只能扩容20次。 扩容存储空间不会影响业务。 代理规格 若Topic为单副本，扩容/缩容期间无法对该Topic生产消息或消费消息，会造成业务中断。 若Topic为多副本，扩容/缩容代理规格不会造成服务中断，但会逐个节点重启，负载会转移到剩余节点上，建议您在业务低峰期扩容/缩容。 扩容/缩容代理规格的过程中，节点滚动重启造成分区Leader切换，会发生秒级连接闪断，在用户网络环境稳定的前提下，Leader切换时长一般为1分钟以内。多副本的Topic需要在生产客户端配置重试机制，方法如下： a. 生产客户端为Kafka开源客户端时，检查是否配置retries和retry.backoff.ms参数。建议参数值分别配置为：retries10，retry.backoff.ms1000。 b. 生产客户端为Flink客户端时，检查是否配置重启策略，配置重启策略可以参考如下代码。 StreamExecutionEnvironment env StreamExecutionEnvironment.getExecutionEnvironment(); env.setRestartStrategy(RestartStrategies.fixedDelayRestart(10, Time.seconds(20))); 若实例已创建的分区数总和大于待缩容规格的实例分区数上限，此时无法缩容。不同规格配置的实例分区数上限不同，具体请参见产品规格。例如：kafka.4u8g.cluster3的实例，已创建800个分区，您想把此实例的规格缩容为kafka.2u4g.cluster3，kafka.2u4g.cluster3规格的实例分区数上限为750，此时无法缩容。 变更代理规格的时长和代理数量有关，单个代理的变更时长一般在5~10分钟，代理数量越多，规格变更时间越长。

响应样式说明 当successactionstatus设为201时，返回如下： plaintext HTTP/1.1 201 xamzversionid: VersionId Bucket Key Etag 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。除公共响应消息头之外，还可能返回如下的消息头： 参数名称 参数描述 类型 xamzversionid 参数解释： 若开启多版本，则返回对象的版本号。 string 响应消息元素 该响应中将桶的区域信息以消息元素的形式返回，元素的具体含义如下表所示 ： 参数名称 参数描述 类型 PostResponse 参数解释： 返回结果的容器。 string Location 参数解释： 对象的URI。 string Bucket 参数解释： 对象所在桶的名称。 string Key 参数解释： 对象的key。 string ETag 参数解释： 对象的ETag。 string 错误码 请参见调用前必知错误码全局错误码。

介绍APM监控详情里消息监控中的RabbitMqConsumer相关指标的名称、含义等信息。 RabbitMqConsumer监控指标说明表 指标类别 指标 指标说明 数据类型 异常 exceptionstacktrace 异常产生的堆栈信息 String 异常 exceptiontype 异常类型 String 异常 exceptioncount 错误数 Int 推模式消费维度监控 messageerrorcount 消费消息的错误次数 Int 推模式消费维度监控 ms0To10Count 010ms次数 Int 推模式消费维度监控 ms10To100Count 10100ms次数 Int 推模式消费维度监控 ms100To500Count 100500ms次数 Int 推模式消费维度监控 ms500To1000Count 5001000ms次数 Int 推模式消费维度监控 ms1000To10000Count 110s次数 Int 推模式消费维度监控 msMorethan10000Count 10s以上次数 Int 推模式消费维度监控 messagecount 调用次数 Int Connection监控 notacknowledgedpublished 该连接中未确认的消息数 Int Total监控 messageerrorcount 消费消息的错误次数 Int Total监控 messagecount 消费消息数 Int Total监控 messagetotalpayload 消费字节数 Int Total监控 Max(messagetotalpayload) 单次消费最大字节数 Int Total监控 acknowledged Ack消息数 Int Total监控 rejected Reject消息数 Int Total监控 ms0To10Count 010ms次数 Int Total监控 ms10To100Count 10100ms次数 Int Total监控 ms100To500Count 100500ms次数 Int Total监控 ms500To1000Count 5001000ms次数 Int Total监控 ms1000To10000Count 110s次数 Int Total监控 msMorethan10000Count 10s以上次数 Int Total监控 notacknowledgedpublished 未确认的消息数 Int Total监控 messagemaxcost 最大响应时间 Int Total监控 sum(messagecost) 消费消息的总响应时间 Int

目前推理服务提供Chat和Image、Embeddings三类接口。 功能分类 支持模型类别 请求路径后缀 请求完整路径 功能描述 chat 文本生成、图像理解 /chat/completions 针对描述会话的消息列表，模型将返回响应。 image 文本生图 /images/generations 基于提示创建图像。 Embeddings 文本向量化 /embeddings 创建表示输入文本的嵌入向量

响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: tx00000000000000000000e00624e4c295e72default ContentLength: 0 Date: Thu, 07 Apr 2022 02:28:09 GMT Connection: KeepAlive 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 该请求的响应中不带有响应元素。 错误码 请参见调用前必知错误码全局错误码。

响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: tx00000000000000000000a00624e497a5e72default ContentLength: 0 Date: Thu, 07 Apr 2022 02:16:42 GMT Connection: KeepAlive 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 该请求的响应中不带有响应元素。 错误码 请参见调用前必知错误码全局错误码。

请求消息体（可选） 请求消息体用于携带除消息头以外的额外数据，其格式通常与 ContentType 头部字段相匹配，如 JSON 或 XML。当包含中文参数时，需确保使用 UTF8 编码。是否需要消息体及其具体内容，取决于所调用的接口类型；例如，GET 和 DELETE 请求通常不包含消息体，而其他接口则可能需要根据其功能传入相应的数据结构。

参数 是否必选 说明 节点名称 是 节点名称，可以包含中文、英文字母、数字、“”、“”、“/”、“<”、“>”等各类特殊字符，长度为1～128个字符。 代理集群名称 是 选择CDM集群名称，CDM集群提供代理连接的功能。如果选择选择的CDM集群与第三方服务处于同一个VPC下，那么Rest Client可以调用租户面的API。 URL地址 是 填写请求主机的IP或域名地址，以及端口号。例如： HTTP方法 是 选择请求的类型： GET POST PUT DELETE 请求头 否 单击 ，添加请求消息头，参数说明如下： 参数名称 选择参数的名称，选项为“ContentType”、“AcceptLanguage”。 参数值 填写参数的值。 URL参数 否 填写URL参数，格式为“参数值”形式的字符串，字符串间以换行符分隔。当“HTTP方法”为“GET”时，显示该配置项。参数说明如下： 参数 只支持英文字母、数字、“”、“”，最大长度为32字符。 值 只支持英文字母、数字、“”、“”、“$”、“{”和“}”，最大长度为64字符。 请求消息体 是 填写Json格式的请求消息体。当“HTTP方法”为“POST”、“PUT”时，显示该配置项。 是否需要判断返回值 否 设置是否判断返回消息的值和预期的一致。当“HTTP方法”为“GET”时，显示该配置项。 YES：检查返回消息中的值是否和预期的一致。 NO：不检查，请求返回200响应码（表示节点执行成功）。 返回值字段路径 是 填写Json响应消息中某个属性的路径（下称：Json属性路径），每个Rest Client节点都只能配置一个属性的路径。当“是否需要判断返回值”为“YES”时，显示该配置项。 例如，返回结果为： { "param1": "aaaa", "inner": { "inner": { "param4": 2014247437 }, "param3": "cccc" }, "status": 200, "param2": "bbbb" } 其中“param4”属性的路径为“inner.inner.param4”。 请求成功标志位 是 填写请求成功标志位，如果响应消息的返回值与请求成功标志位中的某一个匹配，表示节点执行成功。当“是否需要判断返回值”为“YES”时，显示该配置项。请求成功标志位只支持英文字母、数字、“”、“”、“$”、“{”、“}”，多个值使用“;”分隔。 请求失败标志位 否 填写请求失败标志位，如果响应消息的返回值与请求失败标志位中的某一个匹配，表示节点执行失败。当“是否需要判断返回值”为“YES”时，显示该配置项。请求失败标志位只支持英文字母、数字、“”、“”、“$”、“{”、“}”，多个值使用“;”分隔。 请求间隔时间（秒） 是 如果响应消息的返回值与请求成功标志位不匹配，将每隔一段时间查询一次，直到响应消息的返回值与请求成功标志位一致。节点执行的超时时间默认为1小时，如果1小时内查询的结果始终为不匹配，那么节点的状态将置为失败。当“是否需要判断返回值”为“YES”时，显示该配置项。 响应消息体解析为传递参数定义 否 设置作业变量与Json属性路径的对应关系，参数间以换行符分隔。例如：var4inner.inner.param4其中，“var4”为作业变量，作业变量只支持英文字母、数字，最大长度为64字符；“inner.inner.param4”为Json属性路径。仅该节点的后续节点引用该参数才会生效，引用该参数时，格式为：${var4}。

请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code TransferEncoding: chunked xamzrequestid: tx00000000000000000004e00624d61a05403fdefault ContentType: application/xml Date: Wed, 06 Apr 2022 09:47:12 GMT Connection: KeepAlive YYYYYY bkmultipart 2~ls51tmBOaXRZ0cphaKniJgwYvTXYd9E 1000 false 111 2~wa0ng7BS4kgkvH53BIv6IiKghQicI base base base base STANDARD 20220406T06:44:46.545Z obj 2~3VNk9y7oaxEplNPYRoVCwZDJIvxAI9 base base base base STANDARD 20220406T06:20:02.607Z 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。

请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code TransferEncoding: chunked xamzrequestid: tx00000000000000000004e00624d61a05403fdefault ContentType: application/xml Date: Wed, 06 Apr 2022 09:47:12 GMT Connection: KeepAlive YYYYYY bkmultipart 2~ls51tmBOaXRZ0cphaKniJgwYvTXYd9E 1000 false 111 2~wa0ng7BS4kgkvH53BIv6IiKghQicI base base base base STANDARD 20220406T06:44:46.545Z obj 2~3VNk9y7oaxEplNPYRoVCwZDJIvxAI9 base base base base STANDARD 20220406T06:20:02.607Z 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。

功能说明 GetBucketInventory返回目标桶的某项桶清单配置。 请求消息样式 plaintext GET /{Bucket}?inventory&idxxx HTTP/1.1 Host: xxx.zos.ctyun.cn xamzdate: Date xamzcontentsha256: ContentSHA256 Authorization: Auth String ContentLength: ContentLength 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是 id 参数解释： 用来标识清单规则的id。 String 是 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: Request Id ContentType: ContentType ContentLength: ContentLength Date: Date Connection: KeepAlive string string string boolean string string string string string 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 该响应中将桶清单配置信息以消息元素的形式返回，元素的具体含义如下表所示 ： 参数名称 参数描述 类型 InventoryConfiguration 参数解释： 桶清单信息的根标签。 Container 表InventoryConfiguration 参数名称 参数描述 类型 Destination 参数解释： 清单导出目标的容器。 Container IsEnabled 参数解释： 是否启用清单规则。 Boolean Filter 参数解释： 包含清单过滤规则，清单仅包括符合条件的对象。 Container Id 参数解释： 用来标识清单规则的id。 String IncludedObjectVersions 参数解释： 是否列出对象的所有版本。 约束限制： 支持的字段为All和Current。 String OptionalFields 参数解释： 包含清单文件中包含的可选字段。 String Schedule 参数解释： 指定清单文件的导出周期。 String 表Destination 参数名称 参数描述 类型 S3BucketDestination 参数解释： 包含清单文件导出目标存储桶，前缀。 Container 表S3BucketDestination 参数名称 参数描述 类型 Bucket 参数解释： 清单文件导出的目标桶。 String Format 参数解释： 清单导出的格式。 约束限制： 只支持CSV格式。 String Prefix 参数解释： 导出清单文件的路径。 String 表Filter 参数名称 参数描述 类型 Prefix 参数解释： 指定源存储桶中需要进行清单导出的文件前缀。 String 表OptionalFields 参数名称 参数描述 类型 Field 参数解释： 清单文件中的可选字段。 String 表Schedule 参数名称 参数描述 类型 Frequency 参数解释： 清单文件导出周期。 约束限制： 支持Daily和Weekly，分别对应每天和每周末导出。 String

功能说明 ListBucketInventory返回目标桶的所有桶清单配置。 请求消息样式 plaintext GET /{Bucket}?inventory HTTP/1.1 Host: xxx.zos.ctyun.cn xamzdate: Date xamzcontentsha256: ContentSHA256 Authorization: Auth String ContentLength: ContentLength 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: Request Id ContentType: ContentType ContentLength: ContentLength Date: Date Connection: KeepAlive string string string string string string boolean string string ... boolean string 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 该响应中将桶清单配置信息以消息元素的形式返回，元素的具体含义如下表所示 ： 参数名称 参数描述 类型 ListInventoryConfigurationsResult 参数解释： 存储桶清单配置的列表结果根标签。 Container 表ListInventoryConfigurationsResult 参数名称 参数描述 类型 InventoryConfiguration 参数解释： 一个具体的清单任务配置。 Container IsTruncated 参数解释： 返回的清单配置列表是否完整。 Bool 表InventoryConfiguration 参数名称 参数描述 类型 Destination 参数解释： 清单文件生成后存储的目标位置。 Container IsEnabled 参数解释： 是否启用清单规则。 Bool Filter 参数解释： 包含清单过滤规则，清单仅包括符合条件的对象。 String Id 参数解释： 用来标识清单规则的id。 String IncludedObjectVersions 参数解释： 是否列出对象的所有版本。 String OptionalFields 参数解释： 包含清单文件中包含的可选字段。 String Schedule 参数解释： 指定清单文件的导出周期。 Container 表Destination 参数名称 参数描述 类型 S3BucketDestination 参数解释： 包含清单文件导出目标存储桶，前缀。 String 表S3BucketDestination 参数名称 参数描述 类型 Bucket 参数解释： 清单文件导出的目标桶。 String Format 参数解释： 清单导出的格式，目前只支持CSV。 String Prefix 参数解释： 导出清单文件的路径。 String 表Filter 参数名称 参数描述 类型 Prefix 参数解释： 指定源存储桶中需要进行清单导出的文件前缀。 String 表OptionalFields 参数名称 参数描述 类型 Field 参数解释： 清单文件中的可选字段。 String 表Schedule 参数名称 参数描述 类型 Frequency 参数解释： 清单文件导出周期。 String

功能说明 List Bucket Inventory Configuration返回目标桶的所有桶清单配置。 请求消息样式 plaintext GET /{Bucket}?inventory HTTP/1.1 Host: xxx.zos.ctyun.cn xamzdate: Date xamzcontentsha256: ContentSHA256 Authorization: Auth String ContentLength: ContentLength 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: Request Id ContentType: ContentType ContentLength: ContentLength Date: Date Connection: KeepAlive string string string string string string boolean string string ... boolean string 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 该响应中将桶清单配置信息以消息元素的形式返回，元素的具体含义如下表所示 ： 参数名称 参数描述 类型 ListInventoryConfigurationsResult 参数解释： 存储桶清单配置的列表结果根标签。 Container 表ListInventoryConfigurationsResult 参数名称 参数描述 类型 InventoryConfiguration 参数解释： 一个具体的清单任务配置。 Container IsTruncated 参数解释： 返回的清单配置列表是否完整。 Bool 表InventoryConfiguration 参数名称 参数描述 类型 Destination 参数解释： 清单文件生成后存储的目标位置。 Container IsEnabled 参数解释： 是否启用清单规则。 Bool Filter 参数解释： 包含清单过滤规则，清单仅包括符合条件的对象。 String Id 参数解释： 用来标识清单规则的id。 String IncludedObjectVersions 参数解释： 是否列出对象的所有版本。 String OptionalFields 参数解释： 包含清单文件中包含的可选字段。 String Schedule 参数解释： 指定清单文件的导出周期。 Container 表Destination 参数名称 参数描述 类型 S3BucketDestination 参数解释： 包含清单文件导出目标存储桶，前缀。 String 表S3BucketDestination 参数名称 参数描述 类型 Bucket 参数解释： 清单文件导出的目标桶。 String Format 参数解释： 清单导出的格式，目前只支持CSV。 String Prefix 参数解释： 导出清单文件的路径。 String 表Filter 参数名称 参数描述 类型 Prefix 参数解释： 指定源存储桶中需要进行清单导出的文件前缀。 String 表OptionalFields 参数名称 参数描述 类型 Field 参数解释： 清单文件中的可选字段。 String 表Schedule 参数名称 参数描述 类型 Frequency 参数解释： 清单文件导出周期。 String

生产消息 进入Kafka客户端文件的“/bin”目录下，执行如下命令进行生产消息： ./kafkaconsoleproducer.sh brokerlist ​{连接地址} topic 连接地址−−topic​{Topic名称} 参数说明如下： 连接地址：从前提条件中获取的连接地址。 Topic名称：Kafka实例下创建的Topic名称。 示例如下，“10.3.196.45:9094,10.78.42.127:9094,10.4.49.103:9094”为获取的Kafka实例公网连接地址。 执行完命令后，输入需要生产的消息内容，按“Enter”发送消息到Kafka实例，输入的每一行内容都将作为一条消息发送到Kafka实例。 [root@ecskafka bin] ./kafkaconsoleproducer.sh brokerlist 10.3.196.45:9094,10.78.42.127:9094,10.4.49.103:9094 topic topicdemoHello DMS Kafka! ^C[root@ecskafka bin] 如需停止生产使用Ctrl+C命令退出。 消费消息 执行如下命令进行消费消息： ./kafkaconsoleconsumer.sh bootstrapserver ​{连接地址} topic 连接地址−−topic​{Topic名称} group ${消费组名称} frombeginning 参数说明如下： 连接地址：从前提条件中获取的连接地址。 Topic名称：Kafka实例下创建的Topic名称。 消费组名称：根据您的业务需求，设定消费组名称。 如果已经在配置文件中指定了消费组名称，请确保命令行中的消费组名称与配置文件中的相同，否则可能消费失败。 消费组名称开头包含特殊字符，例如下划线“”、 号“ ”时，监控数据无法展示。 示例如下： [root@ecskafka bin] ./kafkaconsoleconsumer.sh bootstrapserver 10.3.196.45:9094,10.78.42.127:9094,10.4.49.103:9094 topic topicdemo group ordertest frombeginning Kafka! DMS Hello ^CProcessed a total of 3 messages [root@ecskafka bin]

响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 该请求的响应中不带有响应元素。 错误码 请参见调用前必知错误码全局错误码。

响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 该请求的响应中不带有响应元素。 错误码 请参见调用前必知错误码全局错误码。

响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 该请求的响应中不带有响应元素。 错误码 请参见调用前必知错误码全局错误码。

响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: tx00000000000000000002e00624e43581217bdefault ContentType: application/xml ContentLength: 0 Date: Thu, 07 Apr 2022 01:50:16 GMT Connection: KeepAlive 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 该请求的响应中不带有响应元素。 错误码 请参见调用前必知错误码全局错误码。

响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: tx00000000000000000000200624f957a2a818nanjing3 ContentType: application/xml ContentLength: 0 Date: Fri, 08 Apr 2022 01:52:58 GMT Connection: KeepAlive 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 该请求的响应中不带有响应元素。 错误码 请参见调用前必知错误码全局错误码。

请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 参数名称 参数描述 类型 是否必须 CompleteMultipartUpload 参数解释： 完成分段上传需要的分段数据信息。 Container 是 表CompleteMultipartUpload 参数名称 参数描述 类型 是否必须 Part 参数解释： 所有分段信息 Container 是 表Part 参数名称 参数描述 类型 是否必须 PartNumber 参数解释： 具体某个分段的分段号 Long 是 ETag 参数解释： 具体某个分段的Etag String 是 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: tx00000000000000000004200624d4b055403fdefault ContentType: application/xml ContentLength: 296 Date: Wed, 06 Apr 2022 08:10:45 GMT Connection: KeepAlive bucket3 key 38d95dc1f762ef78d9e73d1d6515abb42 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。