请求消息元素 该请求消息中不带消息元素。 响应消息样式 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响应结果响应消息头。

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

功能说明 GetBucketCORS用来请求获取桶的跨域资源共享权限配置。 请求消息样式 plaintext GET /{Bucket}?cors HTTP/1.1 Host: xxx.zos.ctyun.cn ContentLength: ContentLength 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 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

本节介绍创建单机训练任务。 创建任务 在智算控制台页面选择“离线训练”，单击“创建AI应用”。 基本信息 设置任务基本信息，比如任务名，任务类型、命名空间等。 配置信息 配置训练任务，选择单机任务。 选择框架和版本 这里会根据选择的任务类型筛选出所有对应的框架镜像。 说明 选择nvidiapytorchexample框架，此框架内置了Mnist训练数据集。 选择框架版本，此框架支持多架构。 选择队列 说明 若没有则单击“创建队列”，设置各类资源配额。 选择队列，设置任务资源，以及环境变量和启动命令等。 启动参数 启动命令如下：可调整对应训练轮次参数，GPU设置backend为nccl。 shell python3 /opt/mnist/src/mnist.py epochs5 backendnccl Pytorch任务环境变量必须设置。 shell PROTOCOLBUFFERSPYTHONIMPLEMENTATION:python 单击“确认”，完成任务创建。 查看任务

如何保证消息发布的可靠性？ 如果acks0，生产者在成功写入消息之前是不会等待任何的来自服务器的响应。可靠性最低、性能最优。 如果acks1，只要集群的首领节点收到消息，生产者就会收到来自服务器成功的响应。 如果acksall / 1，只有在集群所有的跟随副本都接收到消息后，生产者才会受到一个来自服务器的成功响应。可靠性最高，性能最差。 如何保证消息的顺序？ Kafka 每个 Partition 都是相互独立的，Kafka 只能保证单个 Partition 下的有序。 局部有序：当我们所需要的有序其实是针对单个用户的有序，而不要求全局有序。我们可以以用户的 ID 作为 key , 确保单个用户一定会被分配到某个固定的 Partition 上（可能会引起数据倾斜问题），这样我们就能够实现单个用户维度的有序了。 如果一定要全局的有序，所有消息都使用同一个 key ，这样他们一定会被分配到同一个 Partition 上，这种做法适用于临时性且数据量不大的小需求，消息量大了会有性能压力。 如何选择 Partiton 的数量？ 在创建 Topic 的时候可以指定 Partiton 数量，也可以在创建完后手动修改。但 Partiton 数量只能增加不能减少。中途增加 Partiton 会导致各个 Partiton 之间数据量的不平等。 Partition 的数量直接决定了该 Topic 的并发处理能力。但也并不是越多越好。Partition 的数量对消息延迟性会产生影响。 一般建议选择 Broker Num Consumer Num ，这样平均每个 Consumer 会同时读取 Broker 数目个 Partition ， 这些 Partition 压力可以平摊到每台 Broker 上。

本章节介绍了如何创建和运行一个分布式消息服务RocketMQ的实例。 本章节以在“广州4”创建一个开启SSL的RocketMQ 实例为例，介绍如何在控制台创建RocketMQ 实例。 前提条件 在创建RocketMQ实例前，需要保证存在可使用的虚拟私有云和安全组。如果还没有，请参考准备环境创建。 为RocketMQ授权 如果RocketMQ实例需要开启IPv6功能，在创建RocketMQ实例前，需要为RocketMQ授予VPC终端节点操作权限，否则会导致创建失败。 在IAM控制台创建委托，委托参数如下，其他参数保持默认，创建委托的具体步骤请参见《统一身份认证服务 用户指南》的“委托 > 委托其他云服务管理资源”章节。 委托名称：dmsadmintrust 委托类型：云服务 云服务：分布式消息服务 持续时间：永久 委托将拥有所选策略：DMS VPCEndpointAccess、DMSAgencyCheckAccessPolicy 选择授权范围方案如下： DMS VPCEndpointAccess：指定区域项目资源 DMSAgencyCheckAccessPolicy：所有资源 操作步骤 1. 进入购买RocketMQ实例页面。 2. “计费模式”选择“按需计费”。 3. 在“区域”下拉列表中，选择靠近您应用程序的区域，可降低网络延时、提高访问速度。 4. 在“项目”下拉列表中，选择项目。 5. 在“可用区”区域，根据实际情况选择1个或者3个及以上可用区。 6. 设置“实例名称”和“企业项目”。 7. 设置实例信息，配置详情请参考表1。 表1 设置实例信息 参数 配置说明 规格选择模式 选择“默认” 版本 可选择“5.x、4.8.0” RocketMQ实例创建后，版本号不支持修改。 实例类型 5.x版本提供基础版、专业版两种类型 部署架构 5.x版本支持“单机”和“集群” 4.8.0支持“集群” 鲲鹏实例 “创建鲲鹏架构实例”选框，默认不勾选是X86架构的实例，勾选之后是ARM架构的鲲鹏实例。 代理规格 选择“rocketmq.4u8g.cluster” 代理数量 选择“1” 代理存储空间 选择“超高I/O 300GB” 实例总存储空间 单个代理的存储空间 代理数量 8. 设置实例网络环境信息，配置详情请参考表2。 参数 配置说明 虚拟私有云 选择已经创建好的虚拟私有云和子网。 虚拟私有云和子网在RocketMQ实例创建完成后，不支持修改。 IPv6 仅当子网选择了支持IPv6地址后，才会显示该参数。开启IPv6后，客户端可以使用IPv6的内网连接地址连接实例。 实例创建成功后，不支持修改IPv6开关。 使用内网IPv6方式连接实例需要通过VPC终端节点实现，使用期间会产生VPC终端节点的费用。 安全组 选择已经创建好的安全组。 SSL 开启 ACL访问控制 开启 9. 单击“更多配置”，设置更多相关信息，配置详情请参考表3。 表3 更多配置 参数 配置说明 公网访问 不开启 标签 不设置 描述 不设置 10. 填写完上述信息后，单击“立即购买”，进入规格确认页面。 11. 确认实例信息无误后，提交请求。 12. 在实例列表页面，查看RocketMQ实例是否创建成功。 创建实例大约需要3到15分钟，此时实例的“状态”为“创建中”。 当实例的“状态”变为“运行中”时，说明实例创建成功。 当实例的“状态”变为“创建失败”，请删除创建失败的实例，然后重新创建。如果重新创建仍然失败，请联系客服。

功能说明 GetBucketLogging请求获取存储桶的日志转存配置。 请求消息样式 plaintext GET /{Bucket}?logging HTTP/1.1 Host: xxxx.zos.ctyun.cn AcceptEncoding: identity xamzcontentsha256: ContentSHA256 xamzdate: 20220412T100505Z Authorization: string 请求消息参数 参数名称 描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: tx00000000000000000001100624e4d205e72default ContentType: application/xml ContentLength: 129 Date: Thu, 07 Apr 2022 02:32:16 GMT Connection: KeepAlive string string string string string string string 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 参数名称 描述 类型 是否必须 BucketLoggingStatus 参数解释： 日志状态信息。若此参数置为空，则表示关闭日志转存功能。 Container 是 表 BucketLoggingStatus 参数名称 描述 类型 是否必须 LoggingEnabled 参数解释： 描述日志存储位置和日志对象前缀。 Container 否 表 LoggingEnabled 参数名称 描述 类型 是否必须 TargetBucket 参数解释： 日志存储位置。可以将日志存放到任意用户拥有的桶中，包含源存储桶。用户可以配置多个源桶的日志均投放到同一个目标存储桶中，在这种情况下，用户可以使用 TargetPrefix 区分日志来自哪个源存储桶。 String 是 TargetGrants 参数解释： 授权信息。 Container 否 TargetPrefix 参数解释： 日志对象前缀。若多个源存储桶的日志均写到同一个目标存储桶中，则可以通过目标前缀来区分日志来自哪一个源存储桶。 String 是 表 TargetGrants 参数名称 描述 类型 是否必须 Grant 参数解释： 授权许可。 Container 否 表 Grant 参数名称 描述 类型 是否必须 Grantee 参数解释： 授权许可。 Container 否 Permission 参数解释： 日志访问许可。 取值范围： FULLCONTROL：完全控制权限 READ：读权限 WRITE：写权限 String 否 表 Grantee 参数名称 描述 类型 是否必须 DisplayName 参数解释： 展示名字。 String 否 EmailAddress 参数解释： 邮件地址。 String 否 ID 参数解释： 授权用户 ID。 String 否 Type 参数解释： 授权类型。 取值范围： CanonicalUser：普通用户 AmazonCustomerByEmail：邮箱用户 String 否

本小节介绍DDoS基础防护最佳实践。 DDoS基础防护产品最佳实践 为保障公网业务持续稳定运行，避免因 DDoS 攻击导致 IP 封堵、业务中断，建议您按照以下最佳实践流程，使用天翼云 DDoS 基础防护并做好安全防护规划。 1.业务平稳运行阶段 在业务上线初期，若未遭受 DDoS 攻击，或攻击流量规模低于 DDoS 基础防护阈值，IP 不会触发封堵机制，业务网络可正常对外提供服务。 2.攻击触发封堵场景 随着业务规模扩大、行业竞争加剧，若业务遭遇针对性 DDoS 攻击，且攻击流量峰值超出基础防护阈值、挤占资源池带宽并影响网络稳定时，系统将自动对该 IP 执行 DDoS 封堵，暂时阻断公网流量以保障平台整体稳定。 3.接收封堵通知 IP 被封堵后，您将通过账号联系人及安全消息配置联系人的短信、邮箱、站内信同步收到封堵通知，通知中包含受影响 IP、攻击流量峰值、封堵时长等关键信息，便于您快速掌握异常情况。 4.方案查阅 参考官方产品文档与常见问题说明，了解封堵原因及对应的防护解决方案。针对开放DDoS基础防护控制台的资源池EIP，您可登录天翼云控制台，进入 DDoS 基础防护页面，复核流量封堵情况。 5.部署高防防护与 IP 优化 根据官方防护建议，选购并配置天翼云 DDoS 高防 IP、DDoS 高防（边缘云版）或第三方合规 DDoS 高防产品；同时同步更换业务 IP，并限制仅高防 IP 可访问业务 IP，实现业务 IP 隐藏与专业 DDoS 清洗防护，从根源避免再次触发DDoS封堵，保障业务长期稳定运行。

功能说明 GetObjectACL获取对象的访问控制列表（ACL）。 注意事项 该操作需要READACP权限。需要注意的是，如果设置对象的ACL时以邮箱类型设置，返回结果中将会以对应被授权用户的ID形式出现，即Type不会是AmazonCustomerByEmail，而是CanonicalUser，这种情况会将邮箱信息一并返回。 请求消息样式 plaintext GET /{Bucket}/{Object}?acl&versionId HTTP/1.1 Host: xxx.zos.ctyun.cn xamzdate: Date xamzcontentsha256: ContentSHA256 Authorization: Auth String 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是 Object 参数解释： 对象的名称。 String 是 versionId 参数解释： 多版本场景下，指定对象的特定版本。 String 否 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 shell HTTP/1.1 Status Code xamzrequestid: Request Id ContentType: ContentType ContentLength: ContentLength Date: Date Connection: KeepAlive string string string string string string string

功能说明 Get Object ACL获取对象的访问控制列表（ACL）。 注意事项 该操作需要READACP权限。需要注意的是，如果设置对象的ACL时以邮箱类型设置，返回结果中将会以对应被授权用户的ID形式出现，即Type不会是AmazonCustomerByEmail，而是CanonicalUser，这种情况会将邮箱信息一并返回。 请求消息样式 plaintext GET /{Bucket}/{Object}?acl&versionId HTTP/1.1 Host: xxx.zos.ctyun.cn xamzdate: Date xamzcontentsha256: ContentSHA256 Authorization: Auth String 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是 Object 参数解释： 对象的名称。 String 是 versionId 参数解释： 多版本场景下，指定对象的特定版本。 String 否 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 shell HTTP/1.1 Status Code xamzrequestid: Request Id ContentType: ContentType ContentLength: ContentLength Date: Date Connection: KeepAlive string string string string string string string

响应样式说明 当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 错误码 请参见调用前必知错误码全局错误码。

功能说明 Get Bucket Inventory Configuration返回目标桶的某项桶清单配置。 请求消息样式 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

本文为您介绍分布式消息服务MQTT续订和退订内容。 场景描述 分布式消息服务MQTT为用户提供全面周到的服务，支持用户续订和退订的需求。 续订：针对包周期消息实例服务，用户可在到期前进行服务周期延长操作，即续订操作。 退订：用户如不需要继续使用该分布式消息服务MQTT实例，可进行删除实例操作，即退订操作。 续订 1、登录MQTT消息控制台，可以看到当前租户下面的实例列表。 2、点击需要变更实例栏 > 更多 > 续订。 3、 进入到续订页面，在弹出来的确认窗口选择续订时长，点击确认即可。 退订 1、登录MQTT消息控制台，可以看到当前租户下面的实例列表。 2、点击需要变更实例栏 > 更多 > 退订。 3、 进入到退订页面，在弹出来的确认窗口点击确认即可。 注意 退订的实例处于冻结状态，请务必在实例退订前停止全部的应用。 在申请退订前，请做好数据备份工作，退订后数据将保留15个自然日，15天后相关数据将不予保留，且不会进行备份，务必谨慎操作。

请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzdeletemarker: DeleteMarker xamzexpiration: Expiration LastModified: LastModified ContentLength: ContentLength ETag: ETag xamzversionid: VersionId xamzwebsiteredirectlocation: WebsiteRedirectLocation xamzstorageclass: StorageClass xamztaggingcount: TagCount xamzobjectlockmode: ObjectLockMode xamzobjectlockretainuntildate: ObjectLockRetainUntilDate xamzobjectlocklegalhold: ObjectLockLegalHoldStatus xamzmetadata: Metadata 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 除公共响应消息头之外，还可能返回如下的消息头： 参数名称 参数描述 类型 xamzdeletemarker 参数解释： 指明对象是否是DeleteMarker。 String xamzexpiration 参数解释： 对象的过期时间。如果配置了对象过期（请参阅 PUT Bucket Lifecycle），则响应包含此标头。它包括提供对象过期信息的过期日期和规则ID键值对。 String ContentLength 参数解释： Body的长度。 Long ETag 参数解释： 对象的Etag。 String xamzversionid 参数解释： 对象的VersionId。 String xamzwebsiteredirectlocation 参数解释： 如果开启了website配置，重定向到指定的URL。 String xamzstorageclass 参数解释： 对象的存储级别。 String xamztaggingcount 参数解释： 对象的tag数。 Long xamzobjectlockmode 参数解释： 对象的Lock模式。 String xamzobjectlockretainuntildate 参数解释： 对象Lock到期的时间。 Date xamzobjectlocklegalhold 参数解释： 对象Legal hold是否开启。 String xamzmetadata 参数解释： 用户指定的元数据信息。 String

本节介绍如何创建单机训练任务。 创建训练任务 1. 在集群列表页，选择指定集群 2. 在左侧导航栏，选择“智算套件/AI应用列表” 3. 智算控制台页面选择“离线训练”，单击“创建AI应用” 2. 根据需要修改任务基本信息，比如任务名，任务类型、命名空间等 3. 配置训练任务，选择单机任务 4. 选择框架，这里选择nvidiapytorchexample框架，此框架内置了MNIST训练数据集 5. 选择框架版本，此框架支持多架构 6. 选择队列，若没有则单击去创建队列，设置各类资源配额 7. 选择队列，设置任务资源，以及环境变量和启动命令等 启动命令如下：可调整对应训练轮次参数，若使用 GPU， backend 建议设置为 nccl shell python3 /opt/mnist/src/mnist.py epochs5 backendnccl PyTorch任务环境变量必须设置 shell PROTOCOLBUFFERSPYTHONIMPLEMENTATION:python 单击确认创建任务。

请求消息元素 该请求消息中不带消息元素。 响应消息样式 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响应结果响应消息头。

本章节主要介绍数据湖探索（DLI）如何创建用户并授权使用。 如果您需要对您所拥有的DLI资源进行精细的权限管理，您可以使用统一身份认证服务（Identity and Access Management，简称IAM），具体IAM使用场景可以参考权限管理概述。 如果云帐号已经能满足您的要求，不需要创建独立的IAM用户，您可以跳过本章节，不影响您使用DLI服务的其它功能。 本章节介绍创建IAM用户并授权使用DLI的方法，操作流程如下图所示。 前提条件 给用户组授权之前，请您先了解用户组可以添加的DLI权限，并结合实际需求进行选择。DLI支持的系统权限，请参见权限管理概述章节中的“DLI系统权限”。 示例流程 给用户授权DLI权限流程 1.创建用户组并授权。 在IAM控制台创建用户组，并授予DLI服务普通用户权限“DLI ReadOnlyAccess”。 2.创建用户并加入用户组。 在IAM控制台创建用户，并将其加入1中创建的用户组。 3.用户登录并验证权限。 使用新创建的用户登录控制台，切换至授权区域，验证权限： 在“服务列表”中选择数据湖探索，进入DLI主界面。如果在“队列管理”页面可以查看队列列表，但是单击右上角“购买队列”，无法购买DLI队列（假设当前权限仅包含DLI ReadOnlyAccess），表示“DLI ReadOnlyAccess”已生效。 在“服务列表”中选择除数据湖探索外（假设当前策略仅包含DLI ReadOnlyAccess）的任一服务，若提示权限不足，表示“DLI ReadOnlyAccess”已生效。如果您需要对您所拥有的DLI资源进行精细的权限管理，您可以使用统一身份认证服务（Identity and Access Management，简称IAM），具体IAM使用场景可以参考权限管理概述。

考虑点 建议 本地磁盘存储空间 本地磁盘存储空间 （未开启弹性存储的Topic存储量 + 弹性存储Topic本地热数据存储量） 130% 未开启弹性存储的Topic存储量 ：未开启弹性存储的Topic业务消息量 副本数，如集群未开启弹性存储的Topic均为3副本，消息量为100GB，则未开启弹性存储的Topic存储量为100GB 3 300 GB。 弹性存储Topic本地数据存储量 ：弹性存储主题热数据会存储在本地，未超过 “消息本地保留时长” 的消息数据均存储在本地；由于数据生命周期以分区分片为单位， 未满一个数据分片 的数据也会存储在本地（默认1个分片大小为1GB，编辑主题可调整）。 假如集群有3副本的主题分区100个，分片大小均为1GB。 保留时间为1小时，1小时消息量为50GB，则弹性存储Topic本地数据存储量 max(100 1GB 3, 50GB 3) 300GB。 假如集群有3副本的主题分区100个，分片大小均为128MB。 保留时间为1小时，1小时消息量为50GB，则弹性存储Topic本地数据存储量 max(100 128MB 3, 50GB 3) 150GB。 建议 预留多30% 存储空间。 磁盘空间大小会影响磁盘性能，具体性能参考“ 消息本地保留时长 默认为1小时。建议根据业务实际消费场景调整，如消费者经常消费落后1.5小时，则需要调大到2小时。 分区分片大小 默认为1G，弹性存储Topic可以适当调小至128MB~1024MB之间，因为数据生命周期管理以分区分片为单位，消息数据量必须满一分片才会上传弹性存储或超时清理。

本节介绍客户端首次接入分布式消息服务Kafka时出现异常的排查方法 客户端首次接入分布式消息服务Kafka时如果出现异常，您可以通过以下三个方面进行排查： 网络连通问题：通常有如下几种情况可能会导致网络不通，客户端无法连接分布式消息服务Kafka的服务端。 （1）ECS实例（客户端）与分布式消息服务Kafka实例不在同一个VPC内。关于如何通过VPC网络接入服务端，请参见VPC接入。 （2）本地客户端访问非公网的分布式消息服务Kafka实例。您可以通过公网接入服务端。 客户端版本问题：客户端版本太低可能会出现异常，建议升级到与服务端匹配的客户端版本。 配置问题：默认接入点配置错误等都可能导致接入失败。您可以参见快速入门进行配置检查。

本章节介绍Kafka Broker CPU高负载故障演练。 背景介绍 分布式系统中作为数据交换和异步解耦核心的 Kafka 集群，其 Broker 节点 CPU 易因高消息吞吐量、过多消费者组、数据复制同步及消息压缩解压缩等因素出现持续高负载，进而引发消息延迟、吞吐量下降等问题，本演练可有效测试系统的应对与恢复能力。 基本原理 指定或随机一个Broker节点启动自定义程序，空跑for循环来消耗CPU时间片。 故障注入 1、纳管实例资源 1. 导航至 故障演练 > 目标应用 > 应用资源页面。 2. 在资源类型页签中选择分布式消息服务Kafka，然后单击添加资源。 3. 在弹出的对话框中，勾选目标分布式消息服务Kafka实例，单击确定。 2、编排演练任务 1. 导航至 故障演练 > 目标应用 > 演练管理 页面，单击新建演练。 2. 在基本信息 页面，按提示填写演练名称和描述，然后单击下一步。 3. 在演练对象配置页面： 配置动作组 ：为动作组 命名，资源类型选择分布式消息服务Kafka。 添加实例 ：单击添加实例 ，勾选上一步中添加的分布式消息服务Kafka实例。 添加故障动作 ：单击立即添加 ，在列表中选择Broker CPU高负载动作。 4. 在弹出的参数配置框中，配置所需参数，然后单击确定。 持续时间：故障动作持续时间。 CPU占用率：指定 CPU 负载百分比，取值在0 100之间

操作步骤 1. 登录媒体存储控制台，进入【告警管理告警配置】菜单页面，列表展示为目前配置的告警规则。 2. 可在列表对指定的规则进行修改、下线或删除操作。 注意 编辑规则时，规则名称、监控维度、监控区域、监控Bucket不可修改。 如规则存在未恢复或未处理的告警消息，则该规则暂无法修改，请等待告警恢复或忽略告警信息后再修改。 查看告警消息 用户可参考以下说明，通过控制台查看告警消息。 操作步骤 1. 登录媒体存储控制台，进入【告警管理告警消息】菜单页面，在【告警列表】标签页可查看告警消息。 2. 可在告警列表查看指定的告警消息详情或进行【忽略告警】操作。 3. 告警列表仅展示最近30天的告警消息。 4. 【历史推送】标签页展示近30天的告警信息所关联的历史推送记录，每推送一次为一条记录。

本节介绍如何对上传的文件进行IaC扫描。 前提条件 已上传需要检测的K8S manifests、dockerfile、Configmap文件。 操作步骤 1. 登录容器安全卫士控制台。 2. 在左侧导航栏选择“IaC安全 > IaC检查”，进入IaC检查页面。 3. 选择检查的文件类型。 4. 单击检查列表操作列的“扫描”按钮或者列表右上角的“开始扫描”，可对已上传的文件进行检测。 5. 扫描后，到“任务中心 > 扫描任务队列 > IaC安全扫描队列”中查看扫描状态及生成扫描结果。

本文介绍Kafka业务数据不均衡最佳实践 方案概述 Kafka将Topic划分为多个分区，所有消息分布式存储在各个分区上。每个分区有一个或多个副本，分布在不同的Broker节点上，每个副本存储一份全量数据，副本之间的消息数据保持同步。Kafka的Topic、分区、副本和代理的关系如下图所示： 在实际业务过程中可能会遇到各节点间或分区之间业务数据不均衡的情况，业务数据不均衡会降低Kafka集群的性能，降低资源使用率。 业务数据不均衡原因： 业务中部分Topic的流量远大于其他Topic，会导致节点间的数据不均衡。 生产者发送消息时指定了分区，未指定的分区没有消息，会导致分区间的数据不均衡。 生产者发送消息时指定了消息Key，按照对应的Key发送消息至对应的分区，会导致分区间的数据不均衡。 系统重新实现了分区分配策略，但策略逻辑有问题，会导致分区间的数据不均衡。 Kafka扩容了Broker节点，新增的节点没有分配分区，会导致节点间的数据不均衡。 业务使用过程中随着集群状态的变化，多少会发生一些Leader副本的切换或迁移，会导致个别Broker节点上的数据更多，从而导致节点间的数据不均衡。 实施步骤 业务数据不均衡的处理措施： 优化业务中Topic的设计，对于数据量特别大的Topic，可对业务数据做进一步的细分，并分配到不同的Topic上。 生产者生产消息时，尽量把消息均衡发送到不同的分区上，确保分区间的数据均衡。 创建Topic时，使分区的Leader副本分散到各个Broker节点中，以保障整体的数据均衡。 Kafka提供了分区重平衡的功能，可以把分区的副本重新分配到不同的Broker节点上，解决节点间负载不均衡的问题。具体分区重平衡的操作请参考修改分区平衡。

syslogfacility (enum) 当启用了向syslog记录时，这个参数决定要使用的syslog“设备”。你可以在LOCAL0、LOCAL1、LOCAL2、LOCAL3、LOCAL4、 LOCAL5、LOCAL6、LOCAL7中选择，默认值是LOCAL0。还请参阅系统的syslog守护进程的文档。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。 syslogident (string) 当启用了向syslog记录时，这个参数决定用来标识syslog中的TeleDB消息的程序名。默认值是postgres。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。 syslogsequencenumbers (boolean) 当日志被记录到syslog并且这个设置为 on （默认）时，每一个消息会被加上一个增长的序号作为前缀（例如 [2]）。这种行为避开了很多 syslog 实现默认采用的 “ 上一个消息重复 N 次 ”形式。在现代 syslog 实现中， 抑制重复消息是可以配置的（例如rsyslog 中的$RepeatedMsgReduction），因此这个参数可能不是必需的。 此外，如果你真的想抑制重复消息，你可以把这个参数设置为 off。这个参数只能在postgresql.conf文件或者服务器命令行上设置。 syslogsplitmessages (boolean) 当启用把日志记录到syslog时，这个参数决定消息如何送达 syslog。当设置为 on（默认）时，消息会被分成行， 并且长的行也会被划分以便能够放到 1024 字节中， 这是传统 syslog 实现一种典型的尺寸限制。当设置为 off 时，TeleDB服务器日志消息会被原样送达 syslog 服务， 而处理可能的大体量消息的任务由 syslog 服务负责。如果 syslog 最终被记录到一个文本文件中，那么两种设置的效果是一样的， 但最好设置为 on，因为大部分 syslog 实现要么不能处理大型消息， 要么需要做特殊的配置以处理大型消息。但是如果 syslog 最终写入到某种其他媒介，有必要让消息保持逻辑上的整体性（也更加有用）。这个参数只能在postgresql.conf文件或者服务器命令行上设置。

参数 类型 示例值 描述 topic String source1 Topic名称。 msgId String 210018FC0EE205EF04B51CF068350066 消息ID。 systemProperties Object 详见systemProperties属性参数解释 消息systemProperties。 userProperties Object {} 消息properties。 body Object WebsFjDDxPd503bG60bNdaT0qMrsjt5evXd9df 消息体，默认以JSON格式编码。

响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 该响应中将标签信息以消息元素的形式返回，元素的具体含义如下表所示： 参数名称 参数描述 类型 Tagging 参数解释： 标签集容器。 Container 表Tagging 参数名称 参数描述 类型 TagSet 参数解释： 标签集容器。 Container 表TagSet 参数名称 参数描述 类型 Tag 参数解释： 标签。 Container 表Tag 参数名称 参数描述 类型 Key 参数解释： 标签键 String Value 参数解释： 标签值 String 错误码 请参见调用前必知错误码全局错误码。

响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 该响应中将标签信息以消息元素的形式返回，元素的具体含义如下表所示： 参数名称 参数描述 类型 Tagging 参数解释： 标签集容器。 Container 表Tagging 参数名称 参数描述 类型 TagSet 参数解释： 标签集容器。 Container 表TagSet 参数名称 参数描述 类型 Tag 参数解释： 标签。 Container 表Tag 参数名称 参数描述 类型 Key 参数解释： 标签键 String Value 参数解释： 标签值 String 错误码 请参见调用前必知错误码全局错误码。

功能说明 ListBucketObjects请求列出Bucket中的对象。 请求消息样式 plaintext GET /{Bucket}?delimiterDelimiter&markerMarker&maxkeysMaxKeys&prefixPrefix HTTP/1.1 Host: xxx.zos.ctyun.cn xamzcontentsha256: ContentSHA256 xamzdate: Date Authorization: Auth String 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： Bucket的名称。 String 是 delimiter 参数解释： 对key名称进行分组的字符。 String 否 marker 参数解释： 列举key的起始位置，返回的列表将是以key名按照字典序排在该参数后的对象。 String 否 maxkeys 参数解释： 本次返回keys的最大数目。 约束限制： 小于0时返回结果为0，大于1000时返回结果为1000。 取值范围： 01000 默认取值： 1000 Int 否 prefix 参数解释： 返回的key的前缀。 String 否 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code TransferEncoding: chunked xamzrequestid: Request Id ContentType: application/xml Date: Date Connection: KeepAlive boolean string string string string timestamp string string integer string string ... string string string integer string ...

功能说明 List Bucket Object 请求列出Bucket中的对象。 请求消息样式 plaintext GET /{Bucket}?delimiterDelimiter&markerMarker&maxkeysMaxKeys&prefixPrefix HTTP/1.1 Host: xxx.zos.ctyun.cn XAmzContentSHA256: ContentSHA256 XAmzDate: Date Authorization: Auth String 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： Bucket的名称。 String 是 delimiter 参数解释： 对key名称进行分组的字符。 String 是 marker 参数解释： 列举key的起始位置，返回的列表将是以key名按照字典序排在该参数后的对象。 String 是 maxkeys 参数解释： 本次返回keys的最大数目。 约束限制： 小于0时返回结果为0，大于1000时返回结果为1000。 取值范围： 01000 默认取值： 1000 Int 否 prefix 参数解释： 返回的key的前缀。 String 否 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code TransferEncoding: chunked xamzrequestid: Request Id ContentType: application/xml Date: Date Connection: KeepAlive boolean string string string string timestamp string string integer string string ... string string string integer string ...

进行分布式消息服务Kafka与开源自建对比。 分布式消息服务Kafka相对开源自建的Kafka提供更多功能服务，具备如下优势： 对比项 开源自建 分布式消息服务Kafka 低成本运维 需要专业人员资源规划、部署、运维。 一键开通，全托管。提供多种规格，按需使用，支持一键式节点数、磁盘存储空间和节点规格扩容。 分区规模 千级分区稳定性下降。 支持万级分区稳定写入。 消息查询 命令行可以消费，但无法根据位点或者时间直接定位到具体的消息。 控制台可视化按时间或者位点直接查看消息。 ACL访问控制 命令行，配置复杂。 灵活配置，一键生效。 可视化配置 命令行，配置复杂。 控制台全方位可视化配置管理。 运维监控 缺乏配套的监控运维能力。 提供全引擎指标可视化监控，告警及时发现问题。 集群巡检 命令行，配置复杂。 引擎状态、主题一键健康检测、启停。 稳定可靠 需要自己开发或基于开源实现，开发成本高昂，无法保证业务可靠运行。 支持跨AZ部署，提升可靠性。 安全保证 需要自行进行安全加固。 VPC隔离，支持SSL通道加密。 简单易用 无，需要自己开发。 提供简单的实例管理RESTful API，使用门槛低。

功能说明 Get bucket logging请求获取存储桶的日志转存配置。 请求消息样式 plaintext GET /{Bucket}?logging HTTP/1.1 Host: xxxx.zos.ctyun.cn AcceptEncoding: identity XAmzContentSHA256: ContentSHA256 XAmzDate: 20220412T100505Z Authorization: string 请求消息参数 参数名称 描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: tx00000000000000000001100624e4d205e72default ContentType: application/xml ContentLength: 129 Date: Thu, 07 Apr 2022 02:32:16 GMT Connection: KeepAlive string string string string string string string 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 参数名称 描述 类型 是否必须 BucketLoggingStatus 参数解释： 日志状态信息。若此参数置为空，则表示关闭日志转存功能。 Container 是 表 BucketLoggingStatus 参数名称 描述 类型 是否必须 LoggingEnabled 参数解释： 描述日志存储位置和日志对象前缀。 Container 否 表 LoggingEnabled 参数名称 描述 类型 是否必须 TargetBucket 参数解释： 日志存储位置。可以将日志存放到任意用户拥有的桶中，包含源存储桶。用户可以配置多个源桶的日志均投放到同一个目标存储桶中，在这种情况下，用户可以使用 TargetPrefix 区分日志来自哪个源存储桶。 String 是 TargetGrants 参数解释： 授权信息。 Container 否 TargetPrefix 参数解释： 日志对象前缀。若多个源存储桶的日志均写到同一个目标存储桶中，则可以通过目标前缀来区分日志来自哪一个源存储桶。 String 是 表 TargetGrants 参数名称 描述 类型 是否必须 Grant 参数解释： 授权许可。 Container 否 表 Grant 参数名称 描述 类型 是否必须 Grantee 参数解释： 授权许可。 Container 否 Permission 参数解释： 日志访问许可。 取值范围： FULLCONTROL：完全控制权限 READ：读权限 WRITE：写权限 String 否 表 Grantee 参数名称 描述 类型 是否必须 DisplayName 参数解释： 展示名字。 String 否 EmailAddress 参数解释： 邮件地址。 String 否 ID 参数解释： 授权用户 ID。 String 否 Type 参数解释： 授权类型。 取值范围： CanonicalUser：普通用户 AmazonCustomerByEmail：邮箱用户 String 否

本文为您介绍分布式消息服务MQTT与其他服务关系。 虚拟私有云(CTVPC ，Virtual Private Cloud) 虚拟私有云为分布式消息服务MQTT提供一个逻辑隔离的区域，构建一个安全可靠、可配置和管理的虚拟网络环境。更多信息请参见虚拟私有云。 弹性云主机（CTECS，Elastic Cloud Server） 弹性云主机由 CPU、内存、镜像、云硬盘组成，同时结合VPC、安全组、数据多副本保存等能力，打造一个既高效又可靠安全的计算环境，确保分布式消息服务MQTT持久稳定运行。更多信息请参见弹性云主机。 云硬盘（CTEVS，Elastic Volume Service） 云硬盘是一种可弹性扩展的块存储设备，可以为分布式消息服务MQTT提供高性能、高可靠的块存储服务。更多信息请参见云硬盘。 弹性IP（Elastic IP，EIP） 弹性IP是可以独立申请的公网 IP 地址，包括公网IP地址与公网出口带宽服务。可以与分布式消息服务MQTT动态绑定和解绑，实现云资源的互联网访问。针对需要公网访问分布式消息服务MQTT实例的需求，用户可开通弹性IP后，在MQTT实例页面进行绑定。更多信息请参见弹性IP。