功能说明 Delete Object Tagging从指定的对象中删除整个标记集。 注意事项 要使用此操作，您必须具有执行s3:DeleteObjectTagging操作的权限。要删除特定对象版本的标签，请在请求中添加versionId查询参数。您将需要s3:DeleteObjectVersionTagging操作的权限。 请求消息样式 plaintext DELETE /{Bucket}/{Key}?tagging&versionId{VersionId} HTTP/1.1 Host: xxx.zos.ctyun.cn AcceptEncoding: identity Date: Tue, 12 Apr 2022 11:03:15 GMT ContentLength: 0 Authorization: string 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： Bucket的名称。 String 是 Key 参数解释： Object的名称。 String 是 VersionId 参数解释： 多版本场景下，指定对象的特定版本。不指定时，默认为最新版本的Id，如存在null版本号，并需对其操作，则需指定VersionId'null'。VersionId''等效于指定最新版本的Id。 String 否 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: tx00000000000000000001c0062555c7434455default Date: Tue, 12 Apr 2022 11:03:16 GMT Connection: KeepAlive 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。

功能说明 获取指定Bucket的标签。该操作需要s3:GetBucketTagging权限，桶的拥有者默认具有该权限。 注意事项 通过API设置桶标签和通过控制台设置桶标签是完全不同的两套标签功能，二者不互通，故通过API获取桶标签只能获取通过API或SDK设置的桶标签，无法获取通过控制台设置的桶标签。 请求消息样式 plaintext GET /{Bucket}?tagging HTTP/1.1 Host: xxxx.zos.ctyun.cn XAmzContentSHA256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 Authorization: string XAmzDate: 20220408T030447Z 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: tx00000000000000000000400624fa64f2a818nanjing3 ContentType: application/xml ContentLength: 169 Date: Fri, 08 Apr 2022 03:04:47 GMT Connection: KeepAlive string string 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。

操作系 统 相关配置项 Windows 设置网卡属性为DHCP 开启远程桌面连接功能 安装Guest OS driver，包括PV driver和UVP VMtools驱动 安装CloudbaseInit工具 （可选）开启网卡多队列 （可选）配置IPv6地址 Linux 清理网络规则文件 设置网卡属性为DHCP 安装原生KVM驱动 修改grub文件的磁盘标识方式为UUID 修改fstab文件的磁盘标识方式为UUID 清除“/etc/fstab”中非系统盘的自动挂载信息 安装CloudInit工具 （可选）开启网卡多队列 （可选）配置IPv6地址

功能说明 在线图片处理为GetObject请求的扩展，用于对存储桶中的图片文件在线处理，并将处理结果返回。支持处理图片格式JPG、PNG、WEBP、TIFF、GIF。 请求消息样式 plaintext GET /{Bucket}/{Key}?xzosprocessimage/[action,paramevalue]/[action,paramevalue] HTTP/1.1 Host: xxx.zos.ctyun.cn xamzdate: Date ContentLength: ContentLength xamzcontentsha256: ContentSHA256 Authorization: Auth String 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： 目标Bucket的名称。 String 是 Key 参数解释： 目标Key的名称。 String 是 xzosprocess 参数解释： 图片处理操作参数，image/[action,paramevalue]/[action,paramevalue]。具体请求参数及限制请参考图片处理指南。 String 是 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code acceptranges: AcceptRanges LastModified: LastModified ContentLength: ContentLength ContentType: ContentType ETag: ETag ContentDispostion: attachment Date: Date Connection: KeepAlive xamzrequestid: Request Id LastModified: LastModified ContentLength: ContentLength ETag: ETag xamzversionid: VersionId xamzmetadata: Metadata Body 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。除公共响应消息头之外，还可能返回如下的消息头： 名称 描述 类型 ContentLength 参数解释： Body的长度。 Long ETag 参数解释： 对象的Etag。 String xamzversionid 参数解释： 对象的VersionId。 String xamzmetadata[自定义后缀] 参数解释： 用户指定的元数据信息。 String

功能说明 在线图片处理为GetObject请求的扩展，用于对存储桶中的图片文件在线处理，并将处理结果返回。支持处理图片格式JPG、PNG、WEBP、TIFF、GIF。 请求消息样式 plaintext GET /{Bucket}/{Key}?xzosprocessimage/[action,paramevalue]/[action,paramevalue] HTTP/1.1 Host: xxx.zos.ctyun.cn XAmzDate: Date ContentLength: ContentLength XAmzContentSHA256: ContentSHA256 Authorization: Auth String 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： 目标Bucket的名称。 String 是 Key 参数解释： 目标Key的名称。 String 是 xzosprocess 参数解释： 图片处理操作参数，image/[action,paramevalue]/[action,paramevalue]。具体请求参数及限制请参考图片处理指南。 String 是 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code acceptranges: AcceptRanges LastModified: LastModified ContentLength: ContentLength ContentType: ContentType ETag: ETag ContentDispostion: attachment Date: Date Connection: KeepAlive xamzrequestid: Request Id LastModified: LastModified ContentLength: ContentLength ETag: ETag xamzversionid: VersionId xamzmetadata: Metadata Body 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。除公共响应消息头之外，还可能返回如下的消息头： 名称 描述 类型 ContentLength 参数解释： Body的长度。 Long ETag 参数解释： 对象的Etag。 String xamzversionid 参数解释： 对象的VersionId。 String xamzmetadata[自定义后缀] 参数解释： 用户指定的元数据信息。 String

在会议过程中，参会者可以发送和接收实时消息，支持群聊和一对一私聊。 功能说明 可选择发送消息给会中所有人或指定单个成员。当成员收到聊天消息时，底部工具栏的“聊天”按钮右上角会显示红色气泡提示有未读消息。 聊天窗口仅支持发送文字消息，不支持发送图片或文件。 主持人可管理聊天权限，包括限制部分参会者的聊天发送功能。 操作步骤 1. 进入会议后，点击工具栏中的“聊天”图标，打开右侧聊天窗口。 2. 在聊天窗口顶部的下拉框中选择消息接收对象（所有人或指定成员），也可以在成员列表中选择对应的成员后点击“私聊”。 3. 在输入框输入消息内容，点击发送按钮即可发送消息。 注意事项 请勿在聊天中发送违法或违规内容，保持良好会议秩序。 如果消息发送失败，请检查网络连接并重试。

功能说明 Get bucket object lock请求获取存储桶的对象锁定配置。对象锁定功能将会应用到每一个新放入到存储桶中的对象。 请求消息样式 plaintext GET /{Bucket}?objectlock HTTP/1.1 Host: xxxx.zos.ctyun.cn AcceptEncoding: identity XAmzContentSHA256: ContentSHA256 Authorization: string XAmzDate: 20220407T022928Z 请求消息参数 参数名称 参数描述 类型 是否必须 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

自定义云短信网关 1 登录云堡垒机系统。 2 选择“系统 > 系统配置 > 外发配置”，进入系统外发配置管理页面。 外发配置 3 在“短信网关配置”区域，单击“编辑”，弹出短信网关配置窗口。 4 单击“确认”，返回外发配置页面，即可查看短信网关信息。 云短信网关参数说明 参数 说明 APPKey 申请短信应用后，输入短信应用的APPKey。 APPSecret 申请短信应用后，输入短信应用的APPSecret。 APP接入地址 申请短信应用后，输入短信应用的APP接入地址。 通道号 申请短信签名后，输入短信前面通道号。 模板ID 申请短信模板后，输入短信模板的ID。 测试手机号 输入可用手机号码，验证短信内容。 告警配置 配置告警方式 针对系统消息、业务消息、任务消息、命令告警、工单消息五大类告警类型，支持不同告警类型各级别消息是否告警和告警方式。 告警方式包括消息中心、邮件通知、短信通知。 根据告警等级划分各类消息是否告警，以及告警方式。 默认低等级消息不告警。 默认中等级消息告警，通过消息中心告警提醒。 默认高等级消息告警，通过消息中心和邮件通知。 本小节主要介绍如何配置系统告警方式。

请求消息元素 参数名称 参数描述 类型 是否必须 Body 参数解释： 上传的对象数据。 Binary 否 响应消息样式 plaintext HTTP/1.1 Status Code ContentLength: 0 ETag: ETag AcceptRanges: bytes xamzversionid: VersionId xamzrequestid: Request Id Date: Date Connection: KeepAlive 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 除公共响应消息头之外，还可能返回如下的消息头： 参数名称 参数描述 类型 ETag 参数解释： 对象的ETag。 String xamzversionid 参数解释： 对象的版本号。 String 响应消息元素 该请求的响应中不带有响应元素。 错误码 请参见调用前必知错误码全局错误码。

请求消息元素 参数名称 参数描述 类型 是否必须 Body 参数解释： 上传的对象数据。 Binary 否 响应消息样式 plaintext HTTP/1.1 Status Code ContentLength: 0 ETag: ETag AcceptRanges: bytes xamzversionid: VersionId xamzrequestid: Request Id Date: Date Connection: KeepAlive 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 除公共响应消息头之外，还可能返回如下的消息头： 参数名称 参数描述 类型 ETag 参数解释： 对象的ETag。 String xamzversionid 参数解释： 对象的版本号。 String 响应消息元素 该请求的响应中不带有响应元素。 错误码 请参见调用前必知错误码全局错误码。

场景描述 RocketMQ中的Topic一旦创建后，通常是不允许直接修改的。因为Topic的配置信息会对消息的发送和消费产生影响，直接修改Topic可能导致消息的发送和消费出现问题。 然而，有时候可能会遇到需要修改Topic配置的场景，以下是一些可能的场景描述： 扩展Topic的分区数量：当Topic的消息量增加，原有的分区数量可能无法满足需求时，可以考虑扩展Topic的分区数量。通过修改Topic的配置，增加分区数量，可以提高消息的并发处理能力和负载均衡性能。 修改Topic的生产模式，可能会对消息的发送和消费产生影响，生产模式决定了消息发送的方式和策略，直接修改可能会导致消息发送和消费的异常。 修改Topic的读写权限，需要考虑到消费者和生产者的配置，以确保它们能够正确地读写Topic。 修改Topic备注，用户按照业务需要修改注意备注。 需要注意的是，修改Topic的配置可能会对消息的发送和消费产生影响，因此在进行修改之前，需要谨慎评估和测试，确保不会对现有的消息系统造成不可逆的影响。在实际操作中，建议在创建Topic时就根据业务需求进行充分的规划和配置，避免频繁修改Topic的配置。 操作步骤 1、进入Topic管理菜单，在Topic列表点击【编辑】按钮，进入编辑Topic窗口。 2、Topic修改时，不能修改集群、broker、topic名称；可以修改分区数、读写权限、备注；

操作步骤 1.在FusionInsight Manager，选择“运维 > 备份恢复 > 备份管理”。 2.单击“创建”。 3.在“任务名称”填写备份任务的名称。 4.在“备份对象”选择待操作的集群。 5.在“备份类型”选择备份任务的运行类型。 “周期备份”表示按周期自动执行备份，“手动备份”表示由手工执行备份。 周期备份参数 参数名称 描述 开始时间 任务第一次启动的时间。 周期 任务下次启动，与上一次运行的时间间隔，支持按“小时”或按“天”。 备份策略 首次全量备份，后续增量备份 每次都全量备份 每n次进行一次全量备份 说明 备份Manager数据和组件元数据时不支持增量备份，仅支持“每次都全量备份”。 如果“路径类型”要使用NFS或CIFS，不能使用增量备份功能。因为在NFS或CIFS备份时使用增量备份时，每次增量备份都会刷新最近一次全量备份的备份数据，所以不会产生新的恢复点。 6.在“备份配置”，勾选“Hive > Hive”。 7.在“Hive”的“路径类型”，选择一个备份目录的类型。 备份目录支持以下类型： “RemoteHDFS”：表示将备份文件保存在备集群的HDFS目录。选择此参数值，还需要配置以下参数： “目的端NameService名称”：填写备集群的NameService名称。可以输入集群内置的远端集群的NameService名称（haclusterX，haclusterX1，haclusterX2，haclusterX3，haclusterX4），也可输入其他已配置的远端集群NameService名称。 “IP 模式”：目标IP的IP地址模式。系统会根据集群网络类型自动选择对应的IP模式，如IPv4或者IPv6。 “目的端NameNode IP地址”：填写备集群NameNode业务平面IP地址，支持主节点或备节点。 “目的端路径”：填写备集群保存备份数据的HDFS目录。不支持填写HDFS中的隐藏目录，例如快照或回收站目录；也不支持默认的系统目录，例如“/hbase”或“/user/hbase/backup”。 “最大备份数”：填写备份目录中可保留的备份文件集数量。 “队列名称”：填写备份任务执行时使用的YARN队列的名称。需和集群中已存在且状态正常的队列名称相同。 “最大map数”：填写执行MapReduce任务的最大map数，默认值为“20”。 “单个map的最大带宽(MB/s)”：填写单个map最大带宽，默认值为“100”。 “NameService名称”：选择备份目录对应的NameService名称。默认值为“hacluster”。 “NFS”：表示将备份文件通过NFS协议保存在NAS中。选择此参数值，还需要配置以下参数： “IP 模式”：目标IP的IP地址模式。系统会根据集群网络类型自动选择对应的IP模式，如IPv4或者IPv6。 “服务器IP地址”：填写NAS服务器IP地址。 “最大备份数”：填写备份目录中可保留的备份文件集数量。 “服务器共享路径”：填写用户配置的NAS服务器共享目录。 “队列名称”：填写备份任务执行时使用的YARN队列的名称。需和集群中已存在且状态正常的队列名称相同。 “最大map数”：填写执行MapReduce任务的最大map数，默认值为“20”。 “单个map的最大带宽(MB/s)”：填写单个map最大带宽，默认值为“100”。 “NameService名称”：选择备份目录对应的NameService名称。默认值为“hacluster”。 “CIFS”：表示将备份文件通过CIFS协议保存在NAS中。选择此参数值，还需要配置以下参数： “IP 模式”：目标IP的IP地址模式。系统会根据集群网络类型自动选择对应的IP模式，如IPv4或者IPv6。 “服务器IP地址”：填写NAS服务器IP地址。 “端口号”：填写CIFS协议连接NAS服务器使用的端口号，默认值为“445”。 “用户名”：填写配置CIFS协议时设置的用户名。 “密码”：填写配置CIFS协议时设置的密码。 “最大备份数”：填写备份目录中可保留的备份文件集数量。 “服务器共享路径”：填写用户配置的NAS服务器共享目录。 “队列名称”：填写备份任务执行时使用的YARN队列的名称。需和集群中已存在且状态正常的队列名称相同。 “最大map数”：填写执行MapReduce任务的最大map数，默认值为“20”。 “单个map的最大带宽(MB/s)”：填写单个map最大带宽，默认值为“100”。 “NameService名称”：选择备份目录对应的NameService名称。默认值为“hacluster”。 “SFTP”：表示将备份文件通过SFTP协议保存到服务器中。 选择此参数值，还需要配置以下参数： “IP 模式”：目标IP的IP地址模式。系统会根据集群网络类型自动选择对应的IP模式，如IPv4或者IPv6。 “服务器IP地址”：填写备份数据的服务器IP地址。 “端口号”：填写SFTP协议连接备份服务器使用的端口号，默认值为“22”。 “用户名”：填写使用SFTP协议连接服务器时的用户名。 “密码”：填写使用SFTP协议连接服务器时的密码。 “服务器共享路径”：SFTP服务器上的备份路径。 “最大备份数”：填写备份目录中可保留的备份文件集数量。 “队列名称”：填写备份任务执行时使用的YARN队列的名称。需和集群中已存在且状态正常的队列名称相同。 “最大map数”：填写执行MapReduce任务的最大map数，默认值为“20”。 “单个map的最大带宽(MB/s)”：填写单个map最大带宽，默认值为“100”。 “NameService名称”：选择备份目录对应的NameService名称。默认值为“hacluster”。 8.在“最大恢复点个数”填写备份任务在本集群中备份可保留的快照数量。 9.在“备份内容”中，选择一个或多个需要备份的Hive表。 支持两种方式选择备份数据： 直接选择 单击导航中某个数据库的名称，将展开显示此数据库中的所有表，勾选指定的表。 正则表达式筛选 a. 单击“正则表达式输入”。 b. 根据界面提示，在第一个输入框填写Hive表所在的数据库，需要与当前存在的数据库完全匹配。例如“defalut”。 c. 在第二个输入框输入正则表达式，支持标准正则表达式。例如要筛选数据库中所有的表，输入“([sS] ?)”。例如要筛选命名规则为字母数字组合的表，如tb1可输入“tbd ”。 d. 单击“刷新”，在“目录名称”查看筛选的表。 e. 单击“同步”保存筛选结果。 说明 输入正则表达式时，可以使用和增加或删除一条表达式。 如果已选择的表或目录不正确，可以单击“清除选中节点”清除勾选。 10.单击“校验”查看备份任务的配置是否正确。 校验失败可能存在以下原因： 目的端NameNode IP地址不正确。 队列名称不正确。 待备份的数据文件所在HDFS路径的父目录或子目录存在HDFS快照。 待备份的目录或表不存在。 NameService名称不正确。 11.单击“确定”保存。 12.在备份任务列表中已创建任务的“操作”列，选择“更多 > 即时备份”，开始执行备份任务。 备份任务执行完成后，系统自动在备集群的备份路径中为每个备份任务创建子目录，目录名为 “备份任务名数据源任务创建时间” ，数据源每次备份的最新备份文件保存在此目录中。所有备份文件集保存在对应的快照目录中。

功能说明 GetBucketACL接口用于获取桶的访问控制列表。 注意事项 该操作需要READACP权限。需要注意的是，如果设置桶的ACL时以邮箱类型设置，返回结果中将会以对应被授权用户的ID形式出现，即Type不会是AmazonCustomerByEmail，而是CanonicalUser，这种情况会将邮箱信息一并返回。 请求消息样式 plaintext GET /{Bucket}?acl HTTP/1.1 Host: xxx.zos.ctyun.cn xamzcontentsha256: ContentSHA256 xamzdate: Date Authorization: Auth String 请求消息参数 参数名称 参数描述 类型 是否必须 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 string 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。

本文为您介绍分布式消息服务MQTT的操作指南连接查询。 分布式消息服务MQTT提供按 Client ID 查询客户端的连接信息和订阅关系，进行剔除（下线）和主题退订操作。 操作步骤 1、 天翼云官网点击控制中心，选择产品分布式消息服务MQTT。 2、 登录分布式消息服务MQTT控制台，点击右上角地域选择对应资源池。 3、 进入实例列表，点击【管理】按钮进入管理菜单。 4、 进入连接查询菜单页面，输入Client ID，点击查询按钮。 5、 展示客户端的连接信息和订阅关系，支持剔除（下线）和主题退订操作。 查询结果 ClientID：一个在客户端连接到MQTT代理（MQTT broker）时分配的唯一标识符，用于标识特定的MQTT客户端。 客户端IP：客户端的IP地址。 连接协议：MQTT协议。 连接时间：指客户端与MQTT代理（MQTT broker）之间建立和维护连接的时间。 cleanSession： MQTT 协议中一个重要的连接选项，用于定义客户端与 MQTT 代理（broker）之间的会话保持行为。这个选项决定了当客户端重新连接到代理时，是否应该恢复之前的会话状态。 认证用户：认证授权模块创建的用户。 当前订阅数：指当前连接到MQTT代理的客户端数量，这些客户端已经发送了订阅请求并成功订阅了一个或多个主题。每个订阅都占用一个资源，因此订阅数可以反映出代理的负载和资源使用情况。 发送消息数：在MQTT代理（broker）上发布或传输的消息数量。这个指标反映了在特定时间段内从一个或多个发布者发送到MQTT代理并通过代理传递到一个或多个订阅者的消息数量。发送消息数通常用于衡量MQTT通信的活动水平和负载。 接收消息数：MQTT代理（broker）上接收并传递给订阅者（Subscriber）的消息数量。这个指标表示了在特定时间段内，MQTT代理成功接收到的消息数量，然后将这些消息传递给相应的订阅者。 是否在线：客户端是否在线，支持剔除下线操作。 连接断开时间：客户端与服务器之间的连接保持（Keep Alive）时间。在MQTT中，客户端和服务器之间的连接是通过心跳机制来保持的，以确保连接的活跃性和可靠性。

功能说明 HeadBucket请求获取指定Bucket的信息。 请求消息样式 xml HEAD /{Bucket} HTTP/1.1 Host: xxx.zos.ctyun.cn xamzcontentsha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 xamzdate: 20220406T134209Z Authorization: authorization string 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释: 桶的名称。 String 是 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 xml HTTP/1.1 Status Code XRGWObjectCount: 3 XRGWBytesUsed: 20971526 xamzrequestid: tx00000000000000000002100624d98b11217bdefault ContentLength: 0 Date: Wed, 06 Apr 2022 13:42:09 GMT Connection: KeepAlive 响应消息头 参数名称 参数描述 类型 XRGWObjectCount 参数解释： Bucket中对象个数。 Long XRGWBytesUsed 参数解释： Bucket中对象占用空间。 Long xamzstorageclass 参数解释： Bucket的存储类型。 String xzosprojectid 参数解释： Bucket的企业项目。 String xazpolicy 参数解释： Bucket所在的放置组。 String 响应消息元素 该请求的响应中不带有响应元素。

本文为您介绍分布式消息服务MQTT消息收发内容。 会话机制 终端 clean sessiontrue,断线后会话信息清除，再次上线后之前所有的订阅关系以及离线消息丢失。 clean sessionfalse断开连接的情况下，MQTT Broker也会为断连客户端保存一个会话，默认2小时，超期未重连订购关系清除；对于clean sessionfalse的客户端断线重连后可接收Qos>0的离线消息。对于客户端因网络等各种原因断线，需要加上重连和订购关系重新订购机制。 离线消息 对于clean sessionfalse的客户端，在未超出会话失效期，断线重连后可接收Qos>0的离线消息。 系统主题 系统主题 说明 mq2mqtt 用于云端服务向终端发送消息。发往该主题消息会转发至MQTT Broker实现云端与移动端互通 mqttdeviceconnect 设备上线主题，内容 {"clientid":客户端ID,"ts":上线时间戳 } mqttdevicedisconnect 设备下线主题，内容 {"clientid":客户端ID,"ts":下线时间戳 } SDK支持 分布式消息服务MQTT支持标准的MQTT协议，理论上适配所有的MQTT客户端SDK。 推荐对应的第三方 SDK 如下表： 语言/平台 推荐的第三方SDK Java Eclipse Paho SDK iOS MQTTClientFramework Android Eclipse Paho SDK JavaScript Eclipse Paho JavaScript Python Eclipse Paho Python SDK C Eclipse Paho C SDK C Eclipse Paho C SDK Golang Eclipse Paho Golang SDK Node.js MQTTJS PHP MosquittoPHP

响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。除公共响应消息头之外，还可能返回如下的消息头： 参数名称 参数描述 类型 ETag 参数解释： 本次上传数据的ETag值，使用MD5计算。 String 响应消息元素 该请求的响应中不带有响应元素。 错误码 请参见调用前必知错误码全局错误码。

本文为您介绍分布式消息服务MQTT 的入门指引。 本章节将为您介绍分布式消息服务MQTT入门的基本流程，主要包括环境准备、创建实例、连接实例及消息收发，帮助您快速上手MQTT。 操作流程 步骤说明 1.环境准备 创建MQTT实例先要准备好虚拟私有云、子网和安全组，可选弹性公网IP。 2.创建实例 在订购分布式消息MQTT填写和确认实例名称、计费模式等信息，确认费用后点击下一步，等待开通流程结果通知成功后完成创建实例。 3.连接实例 创建用户密码、父主题等管理信息，对用户进行主题授权，绑定弹性IP，终端设备和云端应用通过MQTT客户端接入。 4.消息收发 使用MQTT SDK接入终端连接地址进行消息生产消费。

功能说明 GetSymlink获取软链接，得到版本号和链接所指向的对象名。如果软链接的当前版本为删除标记，服务端会返回404 Not Found。 请求消息样式 plaintext GET /{Bucket}/{Object}?symlink&versionIdxxx HTTP/1.1 Host: xxx.zos.ctyun.cn xzossymlinktarget: xxx xzosforbidoverwrite:xxx AcceptEncoding: identity XAmzContentSHA256: ContentSHA256 XAmzDate: 20250107T025728Z ContentLength: 0 Authorization: string 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： Bucket的名称。 String 是 Object 参数解释： Object的名称。 String 是 versionId 参数解释： Object的指定版本。 String 否 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: tx00000000000000000000400677c98181f09bbdefault ContentLength: 0 Date: Tue, 07 Jan 2025 02:57:28 GMT Connection: KeepAlive xzossymlinktarget: xxx 响应消息头 参数描述 参数描述 类型 xzossymlinktarget 参数解释： 软链接指向的目标文件。 String xamzversionid 参数解释： 指定对象的版本id。 String 响应消息元素 该请求的响应中不带有响应元素。

请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: tx00000000000000000001d00624d34ba5403fdefault ContentType: application/xml ContentLength: 240 Date: Wed, 06 Apr 2022 06:35:38 GMT Connection: KeepAlive bkmultipart obj 2~VHfTnlYabDYVAOgyL07QqKrratNl2w 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 参数名称 参数描述 类型 InitiateMultipartUploadResult 参数解释： 初始化分段上传的请求结果。 Container 表 InitiateMultipartUploadResult 参数名称 参数描述 类型 Bucket 参数解释： 对象待上传的Bucket名称。 String Key 参数解释： 待上传的对象名称。 String UploadId 参数解释： 本次分段上传的upload ID。 String 错误码 请参见调用前必知错误码全局错误码。

请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: tx00000000000000000001d00624d34ba5403fdefault ContentType: application/xml ContentLength: 240 Date: Wed, 06 Apr 2022 06:35:38 GMT Connection: KeepAlive bkmultipart obj 2~VHfTnlYabDYVAOgyL07QqKrratNl2w 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 参数名称 参数描述 类型 InitiateMultipartUploadResult 参数解释： 初始化分段上传的请求结果。 Container 表 InitiateMultipartUploadResult 参数名称 参数描述 类型 Bucket 参数解释： 对象待上传的Bucket名称。 String Key 参数解释： 待上传的对象名称。 String UploadId 参数解释： 本次分段上传的upload ID。 String 错误码 请参见调用前必知错误码全局错误码。

本章节介绍故障演练服务中应用资源管理功能。 概述 应用资源 是构成应用 的组件节点，例如云主机 、云容器引擎 、分布式缓存服务Redis版 、分布式消息服务Kafka等实例。应用需要先纳管资源，才能对其进行故障演练。 添加应用资源 1. 登录应用高可用服务控制台。 2. 在左侧导航栏中，定位到故障演练 菜单，选择要操作的目标应用 ，然后单击其下的应用资源 选项，进入应用资源管理页面。 3. 在页面上方的资源类型 页签中，选择希望添加的资源类型（如云主机），然后单击添加资源按钮。 4. 在弹出的对话框中，选择资源池等筛选条件 ，单击搜索，系统将列出符合条件的、当前用户有权访问的资源清单。 5. 从列表中勾选 一个或多个资源，然后单击确认完成添加。 6. 返回应用资源列表，可以看到新添加的资源对象。 注意 列表中显示的资源状态可能存在一定延迟，如需获取最实时的信息，以该资源对应的云产品控制台为准。 删除应用资源 1. 进入目标应用的应用资源管理页面。 2. 在应用资源 列表中，找到希望删除的资源对象，单击其对应的删除按钮。 3. 在弹出的确认对话框中完成删除操作。 4. 返回应用资源列表，确认该资源对象已被成功移除。 注意 若目标资源被演练任务引用，则无法直接删除；必须先解除所有关联任务对该资源的引用，才能进行删除操作。

功能说明 GetBucketEncryption请求可以返回存储桶默认加密配置。若是存储桶不存在默认加密配置，则返回NoSuchEncryptionSetError。 请求消息样式 plaintext GET /{Bucket}?encryption HTTP/1.1 Host: xxxx.zos.ctyun.cn AcceptEncoding: Identity xamzcontentsha256: ContentSHA256 xamzdate: Date Authorization: Auth String 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: Request Id ContentType: application/xml ContentLength: ContentLength Date: Thu, Date Connection: KeepAlive string string 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 名称 描述 类型 ServerSideEncryptionConfiguration 参数解释： 指定默认的服务端加密配置。 Container 表ServerSideEncryptionConfiguration 参数名称 参数描述 类型 Rule 参数解释： 服务端加密配置规则信息。 Container 表Rule 参数名称 参数描述 类型 ApplyServerSideEncryptionByDefault 参数解释： 指定默认的服务端加密配置，若上传对象时请求中未指定任何加密信息，则会使用该加密配置。 Container 表ApplyServerSideEncryptionByDefault 参数名称 参数描述 类型 SSEAlgorithm 参数解释： 加密算法。 取值范围： 仅支持AES256和aws:kms。 String KMSMasterKeyID 参数解释： 加密密钥。 约束限制： 若加密算法选用的是aws:kms，参数格式为"{密钥管理服务处的密钥ID}::::{userID}"，其中userId是用户的ctyun账号id。 若加密算法选用的是AES256，此项字符长度为32。 String

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

请求消息元素 参数名称 参数描述 类型 是否必须 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 消息体方式下必须 xsi:type 参数解释： 被授权用户类型 取值范围： CanonicalUser 、Group String 消息体方式下必须 URI 参数解释： 被授权组URI。 取值范围： 所有用户： 所有认证用户： String Group类型下必须

请求消息元素 参数名称 参数描述 类型 是否必须 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 消息体方式下必须 xsi:type 参数解释： 被授权用户类型 取值范围： CanonicalUser 、Group String 消息体方式下必须 URI 参数解释： 被授权组URI。 取值范围： 所有用户： 所有认证用户： String Group类型下必须

介绍分布式消息服务Kafka的新建消费组功能操作介绍。 场景描述 Kafka新建消费组的场景如下： 多个应用程序需要独立消费同一个主题：如果有多个应用程序需要从同一个Kafka主题中独立消费消息，并且每个应用程序需要管理自己的消费进度和分区分配，那么可以为每个应用程序创建一个独立的消费组。 消费者需要实现消息的负载均衡：当有多个消费者需要消费同一个主题的消息时，可以将它们加入同一个消费组，Kafka会自动将主题的分区均匀地分配给消费组中的消费者，实现消息的负载均衡。 消费者需要实现消息的并行处理：如果需要将一个主题的消息并行地处理，可以创建多个消费者实例，并将它们加入同一个消费组。Kafka会将主题的分区分配给消费组中的消费者，每个消费者只消费自己被分配的分区，从而实现消息的并行处理。 消费者需要实现高可用性：为了提高消费者的可用性，可以创建一个消费组，并将多个消费者实例加入该组。当一个消费者实例发生故障时，Kafka会将该消费者的分区重新分配给其他健康的消费者，从而保证消息的连续消费。 操作步骤 （1）登录管理控制台。 （2）进入Kafka管理控制台。 （3）在实例列表页在操作列，目标实例行点击“管理”。 （4）点击“消费组管理”后进入消费组管理页面。 （5）点击“创建消费组”后，输入消费组名称，点击创建。 说明 消费组业务应用接入使用时客户端也可自动创建。

本节主要介绍Kafka客户端使用规范。 consumer使用规范 1、consumer的owner线程需确保不会异常退出，避免客户端无法发起消费请求，阻塞消费。 2、确保处理完消息后再做消息commit，避免业务消息处理失败，无法重新拉取处理失败的消息。 3、consumer不能频繁加入和退出group，频繁加入和退出，会导致consumer频繁做rebalance，阻塞消费。 4、consumer数量不能超过topic分区数，否则会有consumer拉取不到消息。 5、consumer需周期poll，维持和server的心跳，避免心跳超时，导致consumer频繁加入和退出，阻塞消费。 6、consumer拉取的消息本地缓存应有大小限制，避免OOM（Out of Memory）。 7、consumer session设置为30秒，session.timeout.ms30000。 8、Kafka不能保证消费重复的消息，业务侧需保证消息处理的幂等性。 9、消费线程退出要调用consumer的close方法，避免同一个组的其他消费者阻塞sesstion.timeout.ms的时间。 producer使用规范 1、同步复制客户端需要配合使用：acksall 2、配置发送失败重试：retries3 3、发送优化：linger.ms0 4、生产端的JVM内存要足够，避免内存不足导致发送阻塞 topic使用规范 配置要求：推荐3副本，同步复制，最小同步副本数为2，且同步副本数不能等于topic副本数，否则宕机1个副本会导致无法生产消息。 创建方式：支持选择是否开启kafka自动创建Topic的开关。选择开启后，表示生产或消费一个未创建的Topic时，会自动创建一个包含3个分区和3个副本的Topic。 单topic最大分区数建议为100。 topic副本数为3（当前版本限制，不可调整）。

关键操作列表 操作事件 读写类型 重启实例节点 写事件 创建消息路由任务 写事件 删除消息路由任务 写事件 暂停消息路由任务 写事件 恢复消息路由任务 写事件 重发死信消息 写事件 更新Topic的读写模式 写事件 创建Acl用户 写事件 删除用户 写事件 更新用户 写事件 用户更新Topic权限 写事件 创建Connector任务 写事件 删除Connector任务 写事件 暂停Connector任务 写事件 恢复Connector任务 写事件 创建预付费实例 写事件 创建后付费实例 写事件 磁盘扩容 写事件 节点扩容 写事件 升规格 写事件 续订 写事件 退订 写事件

配置项 解释说明 最大重试次数 用于配置异步调用流程中的消息最大重试次数，取值范围[0,8]。函数计算在默认情况下，对异步触发失败的消息进行3次重试，您可以根据业务需求减少或增加对异步调用的重试。 消息最大存活时长 用于配置异步调用流程中的消息最大存活时长，取值范围[1,2592000]，单位为秒。该时长从触发异步调用时开始计算，到该消息出队准备进行处理为止。如果超过配置的消息最大存活时长，该条消息将被丢弃。

每个 Topic 会有多个分区，每个分区会统计当前消息的总条数，这个称为最大位点 MaxOffset。Kafka Consumer 会按顺序依次消费分区内的每条消息，记录已经消费了的消息条数，称为ConsumerOffset。 剩余的未消费的条数（也称为消息堆积量） MaxOffset ConsumerOffset

功能说明 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