华为云用户手册

与Kafka、RocketMQ的差异 表1 功能差异 功能项 RocketMQ Kafka RabbitMQ 优先级队列 不支持 不支持 3.8.35版本：支持。建议优先级大小设置在0-10之间。 AMQP-0-9-1版本：支持。优先级大小设置在1-9之间。 延迟队列 支持 不支持 3.8.35版本：不支持。 AMQP-0-9-1版本：支持。 死信队列 支持 不支持 支持 消息重试 支持 不支持 3.8.35版本：不支持。 AMQP-0-9-1版本：支持。 消费模式 支持客户端主动拉取和服务端推送两种方式。 客户端主动拉取。 支持客户端主动拉取和服务端推送两种模式。 广播消费 支持 支持 支持 消息回溯 支持 支持。Kafka支持按照offset和timestamp两种维度进行消息回溯。 3.8.35版本：不支持。RabbitMQ中消息一旦被确认消费就会被标记删除。 AMQP-0-9-1版本：支持。 消息堆积 支持 支持。考虑吞吐因素，Kafka的堆积效率比RabbitMQ总体上要高。 支持 持久化 支持 支持 支持 消息追踪 支持 不支持 3.8.35版本：不支持。 AMQP-0-9-1版本：支持。 消息过滤 支持 支持 3.8.35版本：不支持，但可以自行封装。 AMQP-0-9-1版本：支持。 多租户 支持 支持 支持 多协议支持 兼容RocketMQ协议。 只支持Kafka自定义协议。 RabbitMQ基于AMQP协议实现。 跨语言支持 支持多语言的客户端。 采用Scala和Java编写，支持多种语言的客户端。 支持多种语言的客户端。 流量控制 RocketMQ 5.x支持基于实例规格的流量控制。 支持client、user和Topic级别，通过主动设置可将流控作用于生产者或消费者。 RabbitMQ的流控基于Credit-Based算法，是内部被动触发的保护机制，作用于生产者层面。 消息顺序性 单队列（queue）内有序。 支持单分区（partition）级别的顺序性。 单线程发送、单线程消费并且不采用延迟队列、优先级队列等一些高级功能时，才能实现消息有序。 安全机制 支持SSL认证。 支持SSL、SASL身份认证和读写权限控制。 3.8.35版本：支持SSL认证。 AMQP-0-9-1版本：支持ACL访问控制。 事务性消息 支持 支持 支持

与其他云服务的关系 弹性云服务器（Elastic Cloud Server） 弹性云服务器是由CPU、内存、操作系统、云硬盘组成的基础的计算组件。RabbitMQ实例运行在弹性云服务器上，一个代理对应一台弹性云服务器。 云硬盘（Elastic Volume Service） 云硬盘为云服务器提供块存储服务，RabbitMQ的所有数据（如消息和日志等）都保存在云硬盘中。 云审计 （Cloud Trace Service） 云审计为您提供云服务资源的操作记录，记录内容包括您从华为云管理控制台或者开放API发起的云服务资源操作请求以及每次请求的结果，供您查询、审计和回溯使用。 虚拟私有云 RabbitMQ实例运行于虚拟私有云，需要使用虚拟私有云创建的IP和带宽。通过虚拟私有 云安全 组的功能可以增强访问RabbitMQ实例的安全性。 云监控 （Cloud Eye） 云监控是一个开放性的监控平台，提供资源的实时监控、告警、通知等服务。 RabbitMQ实例向CloudEye上报监控数据的更新周期为1分钟。 弹性公网IP（Elastic IP） 弹性公网IP提供独立的公网IP资源，包括公网IP地址与公网出口带宽服务。RabbitMQ实例绑定弹性公网IP后，可以通过公网访问RabbitMQ实例。 标签管理服务（Tag Management Service） 标签管理服务是一种快速便捷将标签集中管理的可视化服务，提供跨区域、跨服务的集中标签管理和资源分类功能。 为RabbitMQ实例添加标签，可以方便用户识别和管理拥有的实例资源。

错峰流控与流量削峰 在电子商务系统或大型网站中，上下游系统处理能力存在差异，处理能力高的上游系统的突发流量可能会对处理能力低的某些下游系统造成冲击，需要提高系统的可用性的同时降低系统实现的复杂性。电商大促销等流量洪流突然来袭时，可以通过队列服务堆积缓存订单等信息，在下游系统有能力处理消息的时候再处理，避免下游订阅系统因突发流量崩溃。消息队列提供亿级消息堆积能力，3天的默认保留时长，消息消费系统可以错峰进行消息处理。 另外，在商品秒杀、抢购等流量短时间内暴增场景中，为了防止后端应用被压垮，可在前后端系统间使用RabbitMQ消息队列传递请求。 图3 消息队列应对秒杀大流量场景

RabbitMQ版本差异 RabbitMQ 3.8.35版本和AMQP-0-9-1版本有部分的功能差异，具体如表1所示。 表1 版本功能差异 功能项 3.8.35 AMQP-0-9-1 SSL √ × 公网访问 在RabbitMQ控制台开启公网 × 仲裁队列 √ × 镜像队列 √ × 优先级队列 √ √ 插件 √ × Web UI √ × 重置实例密码 √ × 变更实例规格 √ √ 用户管理 在Web UI设置 在RabbitMQ控制台设置 消息查询 × √

异步通信 将业务中属于非核心或不重要的流程部分，使用消息异步通知的方式发给目标系统，这样主业务流程无需同步等待其他系统的处理结果，从而达到系统快速响应的目的。 如网站的用户注册场景，在用户注册成功后，还需要发送注册邮件与注册短信，这两个流程使用RabbitMQ消息服务通知邮件发送系统与短信发送系统，从而提升注册流程的响应速度。 图1 串行发送注册邮件与短信流程 图2 借助消息队列异步发送注册邮件与短信流程

系统解耦 以电商秒杀、抢购等流量短时间内暴增场景为例，传统做法是，用户下单后，订单系统发送查询请求到库存系统，等待库存系统返回请求结果给订单系统。如果库存系统发生故障，订单系统获取不到数据，订单失败。这种情况下，订单系统和库存系统两个子系统高耦合。 图4 系统高耦合 引入RabbitMQ消息队列，当用户下单后，将消息写入到RabbitMQ消息队列中，然后返回用户下单成功。 库存系统订阅下单的消息，消费下单消息，然后进行库操作。即使库存系统出现故障，也不影响用户下单。 图5 系统解耦

高可用 普通队列，由于队列以及队列内容仅存储在单代理上，当该代理故障后，对应的队列不可用。 RabbitMQ引入镜像队列机制，镜像队列是开源RabbitMQ 2.6.0版本新增的一个功能，允许集群将队列镜像到其他代理上，当集群某一代理宕机后，队列能自动切换到镜像中的其他代理，保证服务的可用性。 RabbitMQ引入仲裁队列机制，仲裁队列是开源RabbitMQ 3.8版本新增的一个功能，提供队列复制的能力，当集群某一代理宕机后，队列依旧可以正常运行，保证服务的可用性。

审计与日志 云审计服务（Cloud Trace Service，简称 CTS ），是华为云安全解决方案中专业的日志审计服务，提供对各种云资源操作记录的收集、存储和查询功能，可用于支撑安全分析、合规审计、资源跟踪和问题定位等常见应用场景。 用户开通云审计服务并创建和配置追踪器后，CTS可记录DMS for RabbitMQ的管理事件用于审计。 CTS的详细介绍和开通配置方法，请参见CTS快速入门。 CTS支持追踪的DMS for RabbitMQ管理事件列表，请参见云审计服务支持的DMS for RabbitMQ操作列表。 图1 云审计服务 父主题： 安全

责任共担 华为云秉承“将公司对网络和业务安全性保障的责任置于公司的商业利益之上”。针对层出不穷的云安全挑战和无孔不入的云安全威胁与攻击，华为云在遵从法律法规业界标准的基础上，以安全生态圈为护城河，依托华为独有的软硬件优势，构建面向不同区域和行业的完善云服务安全保障体系。 安全性是华为云与您的共同责任，如图1所示。 华为云：负责云服务自身的安全，提供安全的云。华为云的安全责任在于保障其所提供的IaaS、PaaS和SaaS类云服务自身的安全，涵盖华为云数据中心的物理环境设施和运行其上的基础服务、平台服务、应用服务等。这不仅包括华为云基础设施和各项云服务技术的安全功能和性能本身，也包括运维运营安全，以及更广义的安全合规遵从。 租户：负责云服务内部的安全，安全地使用云。华为云租户的安全责任在于对使用的IaaS、PaaS和SaaS类云服务内部的安全以及对租户定制配置进行安全有效的管理，包括但不限于虚拟网络、 虚拟主机 和访客虚拟机的操作系统，虚拟防火墙、API网关和高级安全服务，各项云服务，租户数据，以及身份账号和密钥管理等方面的安全配置。 《华为云安全白皮书》详细介绍华为云安全性的构建思路与措施，包括云安全战略、责任共担模型、合规与隐私、安全组织与人员、基础设施安全、租户服务与租户安全、工程安全、运维运营安全、生态安全。 图1 华为云安全责任共担模型 父主题： 安全

步骤四：运行Job Job定义完后，确认Job已选择可用的Ray集群，在“Job定义”的“操作”列，单击目标Job对应的“启动”。 图3 启动Job 在“Job定义”的“操作”列，单击目标Job对应的“运行详情”，然后单击“运行”页签，查看Job运行状态。 当Job状态变为“成功”，表示运行完成。 图4 查看Job运行状态 您也可以在运行参数中指定的输出OBS桶路径中查看输出。 图4 在OBS桶路径中查看输出

操作步骤 张三进入DataArtsFabric服务的服务授权界面进行授权。具体操作，请参见创建 IAM 用户并授权使用Fabric。 授权李四DataArtsFabricFullPolicy权限和LakeFormation ReadOnly Access权限。 授权王五DataArtsFabricFullPolicy权限，并指定OBS桶“my-obs-bucket”的OBS OperateAccess权限。 授予赵六DataArtsFabricReadOnlyPolicy权限。 李四进入DataArtsFabric页面创建工作空间，并指定MetaStore，具体操作，请参见创建工作空间。 李四在新创建的工作空间中，购买Ray资源并生成订单。具体操作，请参见购买Ray资源。 张三进入待支付订单页面，为订单完成付费，付费完成后，Ray集群自动创建。具体操作，请参见购买Ray资源。 李四在Ray集群上执行Job。具体操作，请参见创建Ray Job。 王五在模型界面创建模型，并指定模型文件的OBS地址。具体操作，请参见创建模型。 王五使用该模型构建推理服务，并在试验场完成试验和调试。具体操作，请参见使用推理服务进行推理。 赵六在Job运行界面检查RayJob的运行结果，在试验场测试王五构建的推理服务。具体操作，请参见管理Ray Job和在试验场进行推理。

身份与权限说明 表1 身份与权限说明 姓名 身份 权限说明 张三 IAM权限管理员 需要拥有DataArtsFabricFullPolicy权限，并且需要IAM Agency Management FullAccess来创建为DataArtsFabric云服务创建委托。 李四 开发工程师 需要拥有DataArtsFabricFullPolicy权限、可以创建工作空间。如果创建工作空间时需要指定LakeFormation Metastore，则还需要LakeFormation ReadOnly Access。 搭建Ray集群时需要实际购买Ray资源，DataArtsFabricFullPolicy权限中包含了创建购买Ray资源订单的权限，但是不包含付费的权限，需要由客户指定的费用管理员来进行付费。 王五 算法工程师 需要拥有DataArtsFabricFullPolicy权限、和必须的OBS权限来在DataArtsFabric服务中使用OBS中的模型文件，OBS权限需要由用户权限管理员张三为其授权 赵六 测试工程师 需要拥有DataArtsFabricReadOnlyPolicy进行只读操作。

场景描述 小模型推理通常指的是在相对较小的机器学习模型上进行推理的过程。这些模型可能由于模型复杂度较低、参数量较少等原因，在单个计算节点上就能高效运行。然而，当需要处理的数据量非常大时，即使是小模型也可能面临性能瓶颈。此时，使用Ray进行并行和分布式推理能帮助您提升推理性能。 在Fabric上使用全托管Ray服务进行小模型推理时，您只需要将您的小模型推理过程定义为Ray可执行的任务，同时在Fabric中创建推理Job并运行，即可开启推理任务。

测试工具 本文使用JMeter进行测试。JMeter是一款用于测试性能的开源软件，它可以模拟多种协议的服务器和客户端，例如HTTP、FTP 、SMTP等。它可以用来测试Web应用程序，也可以用于测试数据库连接、 FTP服务器等。 JMeter还支持自定义和预定义的脚本，可以模拟不同的负载，并支持分布式测试。 JMeter依赖于JDK，所以必须确保当前计算机上已经安装了JDK，并且配置了环境变量。您可以从Apache JMeter官网下载。

测试数据 输入数据1： 该数据是比较简短的一个问题，且回答的max_tokens是256。 { "type":"ChatCompletionRequest", "messages": [ { "role": "user", "content": "What is LLM? What is different between different LLM?" } ], "max_tokens": 256, "stream":true} 输入数据2： 该数据是中等长度的问题，且回答的max_tokens是2048。 { "type":"ChatCompletionRequest", "messages": [ { "role": "user", "content": "Please write a novel and the word size should more than 2000, requirements:1.Setting: Village, ancient forest, bustling city, forgotten island, futuristic metropolis, enchanted castle. 2.Protagonist: Orphaned child, disgraced knight, brilliant scientist, secret agent, reclusive artist, adventurous explorer.3.Antagonist: Shadowy figure, corrupt politician, malevolent sorcerer, rival adventurer, robotic overlord, vengeful ghost.4.Conflict: Quest for revenge, search for a lost artifact, battle for power, love triangle, struggle against fate, resistance against tyranny.2000-Word Requirement Guideline: Writing a 2000-word novel can be challenging, but it's also a great way to hone your writing skills and tell a concise, compelling story. Here are some tips to help you meet the word count while maintaining quality:1.Outline Your Story: Before you start writing, take some time to outline your story. Decide on your main plot points, character arcs, and the overall theme you want to explore. This will help you stay focused and ensure that your story has a clear structure.2.Focus on Key Scenes: With a limited word count, you need to prioritize the most important scenes. Focus on the scenes that drive the plot forward, reveal character development, and create tension. Avoid unnecessary descriptions and subplots that don't contribute to the overall story.3.Show, Don't Tell: Use vivid, sensory details to bring your story to life. Instead of telling readers what's happening, show them through dialogue, actions, and internal monologue. This will make your writing more engaging and help you use your words more effectively.4.Edit Ruthlessly: As you write, be prepared to cut out anything that doesn't add value to your story. This might include redundant descriptions, unnecessary characters, or scenes that don't move the plot forward. Remember, every word should count." } ], "max_tokens": 2048, "stream":true}

测试结果 基于输入数据1进行测试，并发度为64，测试结果如下： 表1 输入数据1的测试结果 模型名称 测试类型 数量 max token 测试时间（s） 成功率 状态码 总请求数 平均时延（ms） TP99时延（ms） 每秒事务数 RPM LLama-3-8B 并发 64 256 300 100% 200 2090 9231 32615 7.01 420.6 LLama-3-70B 并发 64 256 300 100% 200 420 43072 68082 1.79 107.4 LLama-3.1-8B 并发 64 256 300 100% 200 960 20453 51011 3.27 196.2 LLama-3.1-70B 并发 64 256 300 100% 200 679 29975 44826 2.29 137.4 QWEN-2-72B 并发 64 256 300 100% 200 8706 2212 4915 29.02 1741.2 GLM-4-9B 并发 64 256 300 100% 200 578 35655 66167 1.93 115.8 基于输入数据2进行测试，并发度为16，测试结果如下： 推理请求的响应时长根据请求的输入Token、输出Token和参数的变化而变化，下表的数值仅供参考，实际可能差异比较大。 表2 输入数据2的测试结果 模型名称 测试类型 数量 max token 测试时间（s） 成功率 状态码 总请求数 平均时延（ms） TP99时延（ms） 每秒事务数 RPM LLama-3-8B 并发 16 2048 300 100% 200 96 51636 96797 0.32 19.2 LLama-3-70B 并发 16 2048 300 100% 200 82 64296 74727 0.27 16.2 LLama-3.1-8B 并发 16 2048 300 100% 200 192 26072 38645 0.68 40.8 LLama-3.1-70B 并发 16 2048 300 100% 200 64 85552 103198 0.22 13.2 QWEN-2-72B 并发 16 2048 600 100% 200 197 51260 75031 0.33 19.8 GLM-4-9B 并发 16 2048 300 100% 200 137 37630 52302 0.46 27.6

测试环境 局点：华为云-Fabric测试环境。 测试时间：2024年11月30日。 推理服务及其相关资源列表： 推理服务名称 使用模型类型 资源规格 算力数量（MU） 实例数量 LLama-3-8B LLAMA_3_8B mu.llama3.8b 2 1 LLama-3-70B LLAMA_3_70B mu.llama3.70b 8 1 LLama-3.1-8B LLAMA_3.1_8B mu.llama3.1.8b 2 1 LLama-3.1-70B LLAMA_3.1_70B mu.llama3.1.70b 8 1 QWEN-2-72B QWEN_2_72B mu.qwen2.72b 8 1 GLM-4-9B GLM_4_9B mu.glm4.9b 2 1

什么是区域和可用区 通常用区域和可用区来描述数据中心的位置，您可以在特定的区域、可用区创建资源。 区域（Region）指物理的数据中心。每个区域完全独立，这样可以实现最大程度的容错能力和稳定性。资源创建成功后不能更换区域。 可用区（AZ，Availability Zone）是同一区域内，电力和网络互相隔离的物理区域，一个可用区不受其他可用区故障的影响。一个区域内可以有多个可用区，不同可用区之间物理隔离，但内网互通，既保障了可用区的独立性，又提供了低价、低时延的网络连接。 图1 区域和可用区 目前，华为云已在全球多个地域开放云服务，您可以根据需求选择适合自己的区域和可用区。更多信息请参见华为云全球站点。

什么是项目 云的每个区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以区域默认单位为项目进行授权，IAM用户可以访问您账号中该区域的所有资源。 如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中购买资源，然后以子项目为单位进行授权，使得IAM用户仅能访问特定子项目中的资源，使得资源的权限控制更加精确。 项目中的资源不能转移。

概念 Ray是一种用于构建和运行分布式应用程序的开源框架，由加州大学伯克利分校RISELab开发。它旨在简化机器学习（Machine Learning，ML）工作负载的分布式计算，并支持复杂的任务图（Task Graphs），这使得开发者可以编写并行或分布式程序，这些程序能够高效地利用集群中的所有可用资源。 Ray提供了一个简单易用的API来实现任务的并行化和分布式执行，允许用户将Python函数转换为远程过程调用（Remote Procedure Calls，RPCs），从而可以在多个节点上并发执行。此外，Ray还引入了动态任务图的概念，这使得它可以处理需要灵活调度的工作负载，例如强化学习、超参数调整和其他迭代式算法。 通过提供对分布式计算的支持，Ray促进了更快的模型训练和更有效的资源使用，对于那些希望在多台机器上扩展其应用的研究人员和工程师来说，是一个强有力的工具。同时，Ray生态系统还包括一些高级库，例如Ray Tune（用于超参数调整）、RLlib（用于强化学习）、Ray Serve（用于模型服务）等，以满足不同场景下的需求。

响应示例 首次下发请求，响应为空列表。 { "list" : [] } { "list" : [ { "id" : "64d7bad3-6665-4590-baa2-eb5394e49625", "instance_id" : "9b2f4cc6cd584c67bc179a2bfbb37f90in14", "node_id" : "9d8c79cc41074452977a564b335220f5no14", "workflow_id" : "7d77153c12dde-4f3c-a333-7d30503267f2", "file_name" : "c7025305deb34ae9af1be94f698e7949_slowlog_download__9d8c79cc41074452977a564b335220f5no1420230823024331782", "file_size" : "719.0", "file_link" : "***", "bucket_name" : null, "created_at" : 1692758611782, "updated_at" : 1692758611782, "version" : null, "status" : "EXPORTING", "message" : null }, { "id" : "4712c3b1-d26a-49d4-9652-211d6ac106c5", "instance_id" : "9b2f4cc6cd584c67bc179a2bfbb37f90in14", "node_id" : "9d03b0a73ebd415eb2f692862f326cb7no14", "workflow_id" : "7d77153c12dde-4805-bd0b-d70c803a873a", "file_name" : "c7025305deb34ae9af1be94f698e7949_slowlog_download__9d03b0a73ebd415eb2f692862f326cb7no1420230823024331727", "file_size" : "719.0", "file_link" : "***", "bucket_name" : null, "created_at" : 1692758611727, "updated_at" : 1692758611727, "version" : null, "status" : "EXPORTING", "message" : null } ] }

在线生成SDK代码 API Explorer 能根据需要动态生成SDK代码功能，降低您使用SDK的难度，推荐使用。您可以在API Explorer中具体API的“代码示例”页签查看对应编程语言类型的SDK代码，， 右侧代码示例栏会自动拼装参数到代码中供您进行使用，步骤如下： 选择具体某个SDK，比如选择创建Workspace，并输入请求体的参数name：test_workspace。 图1 配置Body参数 选择右侧“代码示例”查看代码，代码中生成已输入参数。 图2 获取SDK代码示例 单击左侧“调试”，可以看到调试结果。 图3 调试SDK代码

URI POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/slow-log/download 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 instance_id 是 String 实例ID，严格匹配UUID规则。

URI DELETE https://{Endpoint}/v3/{project_id}/instances/{instance_id}/tag?key={key} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 instance_id 是 String 实例ID，严格匹配UUID规则。 表2 Query参数 参数 是否必选 参数类型 描述 key 是 String 标签键。

响应参数 表2 响应Body参数 参数 参数类型 描述 list Array of SlowLogDownloadInfo objects 慢日志下载信息列表。详情请参见 表3 。 表3 SlowLogDownloadInfo字段数据结构说明 参数 参数类型 描述 id String 慢日志ID。 instance_id String 实例ID。 node_id String 节点ID。 workflow_id String 工作流ID。 file_name String 文件名。 file_size String 文件大小, 单位：Byte。 file_link String 文件下载链接。 bucket_name String 桶名称。 created_at Long 创建时间。 updated_at Long 更新时间。 version String 版本。 status String 状态。 message String 消息。

URI GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/configurations 表1 参数说明 参数 是否必选 参数类型 描述 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 instance_id 是 String 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。

响应示例 { "created": "2022-04-11 10:46:59", "updated": "2022-04-11 10:46:59", "datastore_version": "2.0", "datastore_name": " GaussDB ", "configuration_parameters": [ { "name": "audit_system_object", "value": "12295", "type": "integer", "description": "该参数决定是否对数据库对象的CREATE、DROP、ALTER操作进行审计。", "restart_required": false, "value_range": "0-2097151" } ]}

响应参数 表2 响应参数 参数 参数类型 描述 datastore_version String 参数解释： 引擎版本。 取值范围： 不涉及。 datastore_name String 参数解释： 引擎名称。 取值范围： 不涉及。 created String 参数解释： 创建时间，格式为"yyyy-MM-dd HH:mm:ss"。例如：2024-05-14 07:31:11。 取值范围： 不涉及。 updated String 参数解释： 更新时间，格式为"yyyy-MM-ddHH:mm:ss"。例如：2024-05-14 07:31:11。 取值范围： 不涉及。 configuration_parameters Array of objects 参数解释： 参数对象，用户基于默认参数模板自定义的参数配置，具体请参考表3。 表3 configuration_parameters字段数据结构说明 参数 参数类型 描述 name String 参数解释： 参数名称。 取值范围： 不涉及。 value String 参数解释： 参数值。 取值范围： 不涉及。 restart_required Boolean 参数解释： 修改该参数是否需要重启实例。 取值范围： true，需要重启。 false，不需要重启。 value_range String 参数解释： 参数取值范围。 取值范围： 不涉及。 type String 参数解释： 参数类型。 取值范围： string integer boolean list float description String 参数解释： 参数描述。 取值范围： 不涉及。

响应示例 查询数据库角色列表成功。 { "roles": [ { "name": "root", "attribute": { "rolsuper": false, "rolinherit": true, "rolcreaterole": true, "rolcreatedb": true, "rolcanlogin": true, "rolconnlimit": -1, "rolreplication": false, "rolbypassrls": false, "rolpassworddeadline": "" }, "memberof": "{gs_role_copy_files,gs_role_signal_backend,gs_role_tablespace,gs_role_replication,gs_role_account_lock}", "lock_status": false } ], "total_count": 1}

响应参数 表2 参数说明 参数 参数类型 描述 roles Array of objects 参数解释： 列表中每个元素表示一个数据库用户/角色，详情参见表表3 roles字段数据结构说明。 total_count Integer 参数解释： 总记录数。 取值范围： [0, 2^31-1]，取决于实际查询大小。 表3 roles字段数据结构说明 参数 参数类型 描述 name String 参数解释： 用户/角色名称。 取值范围： 不涉及。 attribute Object 参数解释： 用户/角色的权限属性，详情参见表 attribute字段数据结构说明。 memberof String 参数解释： 用户/角色的默认权限。 取值范围： 不涉及。 lock_status Boolean 参数解释： 用户/角色是否被锁。 取值范围： 取值为“true”或“false”。 表4 attribute字段数据结构说明 参数 参数类型 描述 rolsuper Boolean 参数解释： 用户/角色是否具有管理员权限。 取值范围： 取值为“true”或“false”。 rolinherit Boolean 参数解释： 用户/角色是否自动继承其所属角色的权限。 取值范围： 取值为“true”或“false”。 rolcreaterole Boolean 参数解释： 用户/角色是否支持创建其他子用户。 取值范围： 取值为“true”或“false”。 rolcreatedb Boolean 参数解释： 用户/角色是否可以创建数据库。 取值范围： 取值为“true”或“false”。 rolcanlogin Boolean 参数解释： 用户/角色是否可以登录数据库。 取值范围： 取值为“true”或“false”。 rolconnlimit Integer 参数解释： 用户/角色连接实例的最大并发连接数。-1表示没有限制。 取值范围： 不涉及。 rolreplication Boolean 参数解释： 用户/角色是否属于复制角色。 取值范围： 取值为“true”或“false”。 rolbypassrls Boolean 参数解释： 用户/角色是否绕过每个行级安全策略。 取值范围： 取值为“true”或“false”。 rolpassworddeadline String 参数解释： 用户/角色密码过期时间。 取值范围： 不涉及。