# 查询集群列表-ListClusters #### 功能介绍 查看当前用户创建的MRS集群列表信息，支持按集群名称、状态、标签和企业项目等条件进行筛选和分页查询。该接口不兼容Sahara。 #### 接口约束 无 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-mrs/zh-cn_topic_0013582897.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-mrs/mrs_02_0221.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### URI GET /v1.1/{project_id}/cluster_infos 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 项目编号。获取方法，请参见[获取项目ID](https://support.huaweicloud.com/api-mrs/mrs_02_0011.html)。 **约束限制：** 不涉及 **取值范围：** 只能由英文字母和数字组成，且长度为\[1-64\]个字符。 **默认取值：** 不涉及 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | tags | 否 | String | **参数解释：** 标签列表。可以通过集群的标签来搜索指定标签的集群，当指定多个tag进行查询时，标签之间是与的关系。 **约束限制：** 不涉及 **取值范围：** - tags参数的格式为tags=k1\*v1,k2\*v2,k3\*v3。 - 当标签的value为空时，格式为tags=k1,k2,k3\*v3。 - 标签的key与value值可以包含任意语种字母、数字、空格和_.:=+-@，但首尾不能含有空格，不能以_sys_开头，长度为1\~128个字符。 **默认取值：** 不涉及 | | pageSize | 否 | String | **参数解释：** 分页查询每页返回的集群列表信息数量。 **约束限制：** 不涉及 **取值范围：** 只能由数字组成，取值范围为1\~2147483646。 **默认取值：** 10 | | currentPage | 否 | String | **参数解释：** 当前查询页码。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 1 | | clusterName | 否 | String | **参数解释：** 集群名称。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | clusterState | 否 | String | **参数解释：** 根据集群状态查询集群列表。 **约束限制：** 不涉及 **取值范围：** - existing：查询现有集群列表，包括除"已删除"、包周期集群的"订单处理中"和"准备中"状态外的所有集群。 - history：查询历史集群列表，包括所有"已删除"、删除集群失败、集群删除虚拟机失败、删除集群更新数据库失败等状态的集群。 - starting：查询启动中的集群列表。 - running：查询运行中的集群列表。 - terminated：查询已删除的集群列表。 - failed：查询失败的集群列表。 - abnormal：查询异常的集群列表。 - terminating：查询删除中的集群列表。 - frozen：查询已冻结的集群列表。 - scaling-out：查询扩容中的集群列表。 - scaling-in：查询缩容中的集群列表。 **默认取值：** 不涉及 | | enterpriseProjectId | 否 | String | **参数解释：** 通过企业项目ID来搜索指定项目的集群。获取方式请参见《企业管理API参考》的"查询企业项目列表"响应消息表"enterprise_project字段数据结构说明"的"id"。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 0 | #### 请求参数 无 #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | clusterTotal | Integer | **参数解释：** 集群列表总数。 **取值范围：** 不涉及 | | clusters | Array of [Cluster] objects | **参数解释：** 集群参数。 **取值范围：** 不涉及 | 表4Cluster | 参数 | 参数类型 | 描述 | |:---|:---|:---| | clusterId | String | **参数解释：** 集群ID。 **取值范围：** 不涉及 | | clusterName | String | **参数解释：** 集群名称。 **取值范围：** 不涉及 | | totalNodeNum | String | **参数解释：** 集群部署的节点总数。 **取值范围：** 不涉及 | | clusterState | String | **参数解释：** 集群状态（默认为英文，当X-Language请求头被设置为zh-cn，该字段会返回中文，因此请谨慎设置X-Language等语言请求头）。 **取值范围：** - starting：启动中。 - running：运行中。 - terminated：已删除。 - failed：失败。 - abnormal：异常。 - terminating：删除中。 - frozen：已冻结。 - scaling-out：扩容中。 - scaling-in：缩容中。 | | stageDesc | String | **参数解释：** 集群进度描述。（默认为英文，当X-Language请求头被设置为zh-cn时，该字段会返回中文，因此请谨慎设置X-Language等语言请求头）。 **取值范围：** 安装集群进度包括： - Verifying cluster parameters：校验集群参数中 - Applying for cluster resources：申请集群资源中 - Creating VM：创建虚拟机中 - Initializing VM：初始化虚拟机中 - Installing MRS Manager：安装MRS Manager中 - Deploying cluster：部署集群中 - Cluster installation failed：集群安装失败 扩容集群进度包括： - Preparing for cluster expansion：准备扩容中 - Creating VM：创建虚拟机中 - Initializing VM：初始化虚拟机中 - Adding node to the cluster：节点加入集群中 - Cluster expansion failed：集群扩容失败 缩容集群进度包括： - Preparing for cluster shrink：正在准备缩容 - Decommissioning instance：实例退服中 - Deleting VM：删除虚拟机中 - Deleting node from the cluster：从集群删除节点中 - Cluster shrink failed：集群缩容失败 集群安装、扩容、缩容失败，stageDesc会显示失败的原因。 | | createAt | String | **参数解释：** 集群创建时间，十位时间戳。 **取值范围：** 不涉及 | | updateAt | String | **参数解释：** 集群更新时间，十位时间戳。 **取值范围：** 不涉及 | | chargingStartTime | String | **参数解释：** 开始计费时间，十位时间戳。 **取值范围：** 不涉及 | | billingType | String | **参数解释：** 集群计费模式。 **取值范围：** - Yearly/Monthly：包周期计费 - Metered：按需计费 | | dataCenter | String | **参数解释：** 集群工作区域。 **取值范围：** 不涉及 | | vpc | String | **参数解释：** VPC名称。 **取值范围：** 不涉及 | | vpcId | String | **参数解释：** VPC ID。 **取值范围：** 不涉及 | | duration | String | **参数解释：** 包周期集群购买时长，例如1个月。 **取值范围：** 不涉及 | | fee | String | **参数解释：** 创建集群所需费用，系统自动计算。 **取值范围：** 不涉及 | | hadoopVersion | String | **参数解释：** Hadoop组件版本信息。 **取值范围：** 不涉及 | | componentList | Array of [ComponentAmb] objects | **参数解释：** 组件列表信息。 **取值范围：** 不涉及 | | externalIp | String | **参数解释：** 公网IP地址。用于集群外访问集群主master进程所开放IP的地址。 **取值范围：** 不涉及 | | externalAlternateIp | String | **参数解释：** 公网备用IP地址。用于集群外访问集群备master进程所使用的IP地址。 **取值范围：** 不涉及 | | internalIp | String | **参数解释：** 内网IP地址。用于集群内访问集群master进程所使用IP的地址。 **取值范围：** 不涉及 | | deploymentId | String | **参数解释：** 集群部署ID。本集群的任务部署所对应的ID，用于云服务查询集群部署任务详情。 **取值范围：** 不涉及 | | remark | String | **参数解释：** 集群备注信息。当前默认都为空。 **取值范围：** 不涉及 | | orderId | String | **参数解释：** 创建集群的订单号。 **取值范围：** 不涉及 | | azId | String | **参数解释：** 可用区域ID。 **取值范围：** 不涉及 | | azName | String | **参数解释：** 可用区域名称。 **取值范围：** 不涉及 | | azCode | String | **参数解释：** 可用区域英文名称。 **取值范围：** 不涉及 | | availabilityZoneId | String | **参数解释：** 可用区域ID。 **取值范围：** 不涉及 | | instanceId | String | **参数解释：** 实例ID。 **取值范围：** 不涉及 | | vnc | String | **参数解释：** 远程登录弹性云服务器的URI地址。 **取值范围：** 不涉及 | | tenantId | String | **参数解释：** 项目编号。 **取值范围：** 不涉及 | | volumeSize | Integer | **参数解释：** 磁盘存储空间（GB）。 **取值范围：** 不涉及 | | volumeType | String | **参数解释：** 磁盘类型。 **取值范围：** - SATA：普通IO - SAS：高IO - SSD：超高IO | | subnetId | String | **参数解释：** 子网ID。 **取值范围：** 不涉及 | | subnetName | String | **参数解释：** 子网名称。 **取值范围：** 不涉及 | | securityGroupsId | String | **参数解释：** 安全组ID。 **取值范围：** 不涉及 | | slaveSecurityGroupsId | String | **参数解释：** 非Master节点的安全组id，当前一个MRS集群只会使用一个安全组，所以该字段已经废弃，从兼容性考虑，该字段会返回和securityGroupsId同样的值。 **取值范围：** 不涉及 | | bootstrapScripts | Array of [BootstrapScript] objects | **参数解释：** 配置引导操作脚本信息。 **取值范围：** 不涉及 | | safeMode | Integer | **参数解释：** MRS集群运行模式。 **取值范围：** - 0：普通集群 - 1：安全集群 | | clusterVersion | String | **参数解释：** 集群版本。 **取值范围：** 不涉及 | | nodePublicCertName | String | **参数解释：** 密钥文件名称。 **取值范围：** 不涉及 | | masterNodeIp | String | **参数解释：** Master节点IP。 **取值范围：** 不涉及 | | privateIpFirst | String | **参数解释：** 首选私有IP。 **取值范围：** 不涉及 | | errorInfo | String | **参数解释：** 错误信息。 **取值范围：** 不涉及 | | tags | String | **参数解释：** 标签信息。 **取值范围：** 不涉及 | | masterNodeNum | String | **参数解释：** 集群部署的Master节点数量。 **取值范围：** 不涉及 | | coreNodeNum | String | **参数解释：** 集群部署的Core节点数量。 **取值范围：** 不涉及 | | masterNodeSize | String | **参数解释：** Master节点的实例规格。 **取值范围：** 不涉及 | | coreNodeSize | String | **参数解释：** Core节点的实例规格。 **取值范围：** 不涉及 | | masterNodeProductId | String | **参数解释：** Master节点产品ID。 **取值范围：** 不涉及 | | masterNodeSpecId | String | **参数解释：** Master节点规格ID。 **取值范围：** 不涉及 | | coreNodeProductId | String | **参数解释：** Core节点产品ID。 **取值范围：** 不涉及 | | coreNodeSpecId | String | **参数解释：** Core节点规格ID。 **取值范围：** 不涉及 | | masterDataVolumeType | String | **参数解释：** Master节点数据磁盘存储类别，目前支持SATA、SAS和SSD。 **取值范围：** - SATA：普通IO - SAS：高IO - SSD：超高IO | | masterDataVolumeSize | Integer | **参数解释：** Master节点数据磁盘存储空间。为增大数据存储容量，创建集群时可同时添加磁盘。单位为GB。 **取值范围：** 100-32000 | | masterDataVolumeCount | Integer | **参数解释：** Master节点数据磁盘个数。 **取值范围：** 只能为1。 | | coreDataVolumeType | String | **参数解释：** Core节点数据磁盘存储类别，目前支持SATA、SAS和SSD。 **取值范围：** - SATA：普通IO - SAS：高IO - SSD：超高IO | | coreDataVolumeSize | Integer | **参数解释：** Core节点数据磁盘存储空间。为增大数据存储容量，创建集群时可同时添加磁盘。单位为GB。 **取值范围：** 100-32000 | | coreDataVolumeCount | Integer | **参数解释：** Core节点数据磁盘个数。 **取值范围：** 1-10 | | enterpriseProjectId | String | **参数解释：** 企业项目ID。 **取值范围：** 不涉及 | | isMrsManagerFinish | Boolean | **参数解释：** 表示集群创建过程中，MRS Manager是否安装完成。 **取值范围：** - true：安装完成。 - false：安装未完成。 | | clusterType | Integer | **参数解释：** 集群类型。 **取值范围：** - 0：分析集群。 - 1：流式集群。 - 2：混合集群。 - 3：自定义集群。 - 4：离线集群。 | | logCollection | Integer | **参数解释：** 集群安装失败时，是否搜集日志。 **取值范围：** - 0：不收集。 - 1：收集。 | | periodType | Integer | **参数解释：** 区分包周期，集群是包年还是包月。 **取值范围：** - 0：包月。 - 1：包年。 | | scale | String | **参数解释：** 集群节点的变更状态（扩容/缩容/变更规格）。当该参数取值为空时，表示集群节点没有进行变更操作。（默认为英文，当X-Language请求头被设置为zh-cn时，该字段会返回中文，因此请谨慎设置X-Language等语言请求头）。 **取值范围：** - scaling-out：扩容中。 - scaling-in：缩容中。 - scaling-error：处于running状态，且上一次扩容/缩容/升级规格失败的集群。 - scaling-up：Master节点规格升级中。 - scaling_up_first：备Master节点规格升级中。 - scaled_up_first：备Master节点规格升级成功。 - scaled-up-success：Master节点规格升级成功。 | | nodeGroups | Array of [NodeGroupV10] objects | **参数解释：** Master节点、Core节点和Task节点列表信息。 **取值范围：** 不涉及 | | taskNodeGroups | Array of [NodeGroupV10] objects | **参数解释：** Task节点列表信息。 **取值范围：** 不涉及 | | eipId | String | **参数解释：** 集群弹性公网ip的唯一标识。 **取值范围：** 不涉及 | | eipAddress | String | **参数解释：** 集群弹性公网ip的IPV4地址。 **取值范围：** 不涉及 | | eipv6Address | String | **参数解释：** 集群弹性公网ip的IPV6地址，IPv4时无此字段。 **取值范围：** 不涉及 | | azCategory | Integer | **参数解释：** 表示当前可用区的类型。 **取值范围：** - 0：大云主可用区 - 21：本地可用区 - 41：边缘可用区 | 表5ComponentAmb | 参数 | 参数类型 | 描述 | |:---|:---|:---| | componentId | String | **参数解释：** 组件ID。 **取值范围：** 不涉及 | | componentName | String | **参数解释：** 组件名称。 **取值范围：** 不涉及 | | componentVersion | String | **参数解释：** 组件版本。 **取值范围：** 不涉及 | | componentDesc | String | **参数解释：** 组件描述信息。 **取值范围：** 不涉及 | 表6BootstrapScript | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释：** 引导操作脚本的名称。 **取值范围：** 同一个集群的引导操作脚本名称不允许相同。不能以空格开头，只能由英文字母、数字以及"_"和"-"组成，且长度为\[1-64\]个字符。 | | uri | String | **参数解释：** 引导操作脚本的路径。设置为OBS桶的路径或虚拟机本地的路径。 - OBS桶的路径：直接手动输入脚本路径。例如输入MRS提供的公共样例脚本路径。示例：s3a://bootstrap/presto/presto-install.sh，其中安装dualroles时，presto-install.sh脚本参数为dualroles,安装worker时，presto-install.sh脚本参数为worker。根据Presto使用习惯，建议您在Active Master节点上安装dualroles，在Core节点上安装worker。 - 虚拟机本地的路径：用户需要输入正确的脚本路径。脚本所在的路径必须以'/'开头，以.sh结尾。 **取值范围：** 不涉及 | | parameters | String | **参数解释：** 引导操作脚本参数。 **取值范围：** 不涉及 | | nodes | Array of strings | **参数解释：** 引导操作脚本所执行的节点类型，包含master、core和task三种类型。 **取值范围：** 不涉及 | | active_master | Boolean | **参数解释：** 引导操作脚本是否只运行在主Master节点上。 **取值范围：** - true：引导操作脚本只运行在主Master节点上。 - false：引导操作脚本可运行在所有Master节点上。 | | fail_action | String | **参数解释：** 引导操作脚本执行失败后，是否继续执行后续脚本和创建集群。建议您在调试阶段设置为"continue"，无论此引导操作是否执行成功，则集群都能继续安装和启动。 **取值范围：** - continue：继续执行后续脚本。 - errorout：终止操作。 | | before_component_start | Boolean | **参数解释：** 引导操作脚本执行的时间。目前支持"组件启动前"和"组件启动后"两种类型。 **取值范围：** - true：引导操作脚本在组件启动前执行。 - false：引导操作脚本在组件启动后执行。 | | start_time | Long | **参数解释：** 单个引导操作脚本的执行时间，格式为秒级Unix时间戳。 **取值范围：** 不涉及 | | state | String | **参数解释：** 单个引导操作脚本的运行状态。 **取值范围：** - PENDING：挂起 - IN_PROGRESS：正在处理 - SUCCESS：处理成功 - FAILURE：处理失败 | | action_stages | Array of strings | **参数解释：** 选择引导操作脚本执行的时间。 - BEFORE_COMPONENT_FIRST_START：组件首次启动前 - AFTER_COMPONENT_FIRST_START：组件首次启动后 - BEFORE_SCALE_IN：缩容前 - AFTER_SCALE_IN：缩容后 - BEFORE_SCALE_OUT：扩容前 - AFTER_SCALE_OUT：扩容后 **取值范围：** 不涉及 | 表7NodeGroupV10 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | GroupName | String | **参数解释：** 节点组名。 **取值范围：** 不涉及 | | NodeNum | Integer | **参数解释：** 节点数量，取值范围0-500，Master节点和Core节点数量至少为1，Core与Task节点总数最大为500个。 **取值范围：** 0-500 | | NodeSize | String | **参数解释：** 节点的实例规格。 **取值范围：** 不涉及 | | NodeSpecId | String | **参数解释：** 节点实例规格ID。 **取值范围：** 不涉及 | | VmProductId | String | **参数解释：** 节点虚拟机产品ID。 **取值范围：** 不涉及 | | VmSpecCode | String | **参数解释：** 节点虚拟机产品规格。 **取值范围：** 不涉及 | | NodeProductId | String | **参数解释：** 节点实例产品ID。 **取值范围：** 不涉及 | | RootVolumeSize | Integer | **参数解释：** 节点系统盘大小，不可配置，默认为40GB。 **取值范围：** 不涉及 | | RootVolumeProductId | String | **参数解释：** 节点系统盘的产品ID。 **取值范围：** 不涉及 | | RootVolumeType | String | **参数解释：** 节点系统盘的类型。 **取值范围：** - SATA：普通IO - SAS：高IO - SSD：超高IO | | RootVolumeResourceSpecCode | String | **参数解释：** 节点系统盘产品规格。 **取值范围：** 不涉及 | | RootVolumeResourceType | String | **参数解释：** 节点系统盘产品类型。 **取值范围：** 不涉及 | | DataVolumeType | String | **参数解释：** 节点数据磁盘存储类别，目前支持SATA、SAS和SSD。 **取值范围：** - SATA：普通IO - SAS：高IO - SSD：超高IO | | DataVolumeCount | Integer | **参数解释：** 节点数据磁盘存储数目。 **取值范围：** 不涉及 | | DataVolumeSize | Integer | **参数解释：** 节点数据磁盘存储大小，单位为GB。 **取值范围：** 不涉及 | | DataVolumeProductId | String | **参数解释：** 节点数据磁盘的产品ID。 **取值范围：** 不涉及 | | DataVolumeResourceSpecCode | String | **参数解释：** 节点数据磁盘的产品规格。 **取值范围：** 不涉及 | | DataVolumeResourceType | String | **参数解释：** 节点数据磁盘的产品类型。 **取值范围：** 不涉及 | #### 请求示例 ``` GET /v1.1/{project_id}/cluster_infos?pageSize={page_size}¤tPage={current_page}&clusterState={cluster_state}&tags={tags} ``` #### 响应示例 **状态码：200** 查询集群列表信息成功。 ``` { "clusterTotal" : 1, "clusters" : [ { "clusterId" : "bc134369-294c-42b7-a707-b2036ba38524", "clusterName" : "mrs_D0zW", "masterNodeNum" : "2", "coreNodeNum" : "3", "clusterState" : "terminated", "createAt" : "1498272043", "updateAt" : "1498636753", "chargingStartTime" : "1498273733", "logCollection" : 1, "billingType" : "Metered", "dataCenter" : "cn-north-1", "vpc" : null, "duration" : "0", "fee" : null, "hadoopVersion" : null, "masterNodeSize" : null, "coreNodeSize" : null, "componentList" : [ { "componentId" : "MRS 3.1.0_001", "componentName" : "Hadoop", "componentVersion" : "3.1.1", "componentDesc" : "A framework that allows for the distributed processing of large data sets across clusters." }, { "componentId" : "MRS 3.1.0_003", "componentName" : "HBase", "componentVersion" : "2.1.1", "componentDesc" : "A scalable, distributed database that supports structured data storage for large tables." }, { "componentId" : "MRS 3.1.0_002", "componentName" : "Spark", "componentVersion" : "2.3.2", "componentDesc" : "A fast and general engine for large-scale data processing." }, { "componentId" : "MRS 3.1.0_004", "componentName" : "Hive", "componentVersion" : "3.1.0", "componentDesc" : "A data warehouse infrastructure that provides data summarization and ad hoc querying." } ], "externalIp" : null, "externalAlternateIp" : null, "internalIp" : null, "deploymentId" : null, "remark" : "", "orderId" : null, "azId" : null, "azCode" : null, "masterNodeProductId" : null, "masterNodeSpecId" : null, "coreNodeProductId" : null, "coreNodeSpecId" : null, "azName" : "az1.dc1", "instanceId" : null, "vnc" : "v2/5a3314075bfa49b9ae360f4ecd333695/servers/e2cda891-232e-4703-995e-3b1406add01d/action", "tenantId" : null, "volumeSize" : 0, "volumeType" : null, "subnetId" : null, "subnetName" : null, "securityGroupsId" : null, "slaveSecurityGroupsId" : null, "bootstrapScripts" : [ { "name" : "test1-success", "uri" : "s3a://bootscript/script/simple/basic_success.sh", "parameters" : "", "nodes" : [ "master", "core" ], "active_master" : true, "fail_action" : "errorout", "before_component_start" : true, "state" : "SUCCESS", "start_time" : 1527681083, "action_stages" : [ "AFTER_SCALE_IN", "AFTER_SCALE_OUT" ] } ], "isMrsManagerFinish" : false, "stageDesc" : "Installing MRS Manager", "safeMode" : 0, "clusterVersion" : null, "nodePublicCertName" : null, "masterNodeIp" : "unknown", "privateIpFirst" : null, "eipId" : "b16dd5eb-5e5b-486a-906a-2e8f6e814a7a", "eipAddress" : "100.XXX.XXX.XXX", "eipv6Address" : "2403:XXXX:XXXX::XXXX:XXXX", "errorInfo" : "", "clusterType" : 0, "nodeGroups" : [ { "GroupName" : "master_node_default_group", "NodeNum" : 1, "NodeSize" : "s3.xlarge.2.linux.bigdata", "NodeSpecId" : "cdc6035a249a40249312f5ef72a23cd7", "VmProductId" : "", "VmSpecCode" : null, "NodeProductId" : "dc970349d128460e960a0c2b826c427c", "RootVolumeSize" : 40, "RootVolumeProductId" : "16c1dcf0897249758b1ec276d06e0572", "RootVolumeType" : "SATA", "RootVolumeResourceSpecCode" : "", "RootVolumeResourceType" : "", "DataVolumeType" : "SATA", "DataVolumeCount" : 1, "DataVolumeSize" : 100, "DataVolumeProductId" : "16c1dcf0897249758b1ec276d06e0572", "DataVolumeResourceSpecCode" : "", "DataVolumeResourceType" : "" }, { "GroupName" : "core_node_analysis_group", "NodeNum" : 1, "NodeSize" : "s3.xlarge.2.linux.bigdata", "NodeSpecId" : "cdc6035a249a40249312f5ef72a23cd7", "VmProductId" : "", "VmSpecCode" : null, "NodeProductId" : "dc970349d128460e960a0c2b826c427c", "RootVolumeSize" : 40, "RootVolumeProductId" : "16c1dcf0897249758b1ec276d06e0572", "RootVolumeType" : "SATA", "RootVolumeResourceSpecCode" : "", "RootVolumeResourceType" : "", "DataVolumeType" : "SATA", "DataVolumeCount" : 1, "DataVolumeSize" : 100, "DataVolumeProductId" : "16c1dcf0897249758b1ec276d06e0572", "DataVolumeResourceSpecCode" : "", "DataVolumeResourceType" : "" }, { "GroupName" : "task_node_analysis_group", "NodeNum" : 1, "NodeSize" : "s3.xlarge.2.linux.bigdata", "NodeSpecId" : "cdc6035a249a40249312f5ef72a23cd7", "VmProductId" : "", "VmSpecCode" : null, "NodeProductId" : "dc970349d128460e960a0c2b826c427c", "RootVolumeSize" : 40, "RootVolumeProductId" : "16c1dcf0897249758b1ec276d06e0572", "RootVolumeType" : "SATA", "RootVolumeResourceSpecCode" : "", "RootVolumeResourceType" : "", "DataVolumeType" : "SATA", "DataVolumeCount" : 1, "DataVolumeSize" : 100, "DataVolumeProductId" : "16c1dcf0897249758b1ec276d06e0572", "DataVolumeResourceSpecCode" : "", "DataVolumeResourceType" : "" } ], "taskNodeGroups" : [ { "GroupName" : "task_node_default_group", "NodeNum" : 1, "NodeSize" : "s3.xlarge.2.linux.bigdata", "NodeSpecId" : "cdc6035a249a40249312f5ef72a23cd7", "VmProductId" : "", "VmSpecCode" : null, "NodeProductId" : "dc970349d128460e960a0c2b826c427c", "RootVolumeSize" : 40, "RootVolumeProductId" : "16c1dcf0897249758b1ec276d06e0572", "RootVolumeType" : "SATA", "RootVolumeResourceSpecCode" : "", "RootVolumeResourceType" : "", "DataVolumeType" : "SATA", "DataVolumeCount" : 1, "DataVolumeSize" : 100, "DataVolumeProductId" : "16c1dcf0897249758b1ec276d06e0572", "DataVolumeResourceSpecCode" : "", "DataVolumeResourceType" : "" } ], "masterDataVolumeType" : "SATA", "masterDataVolumeSize" : 200, "masterDataVolumeCount" : 1, "coreDataVolumeType" : "SATA", "coreDataVolumeSize" : 100, "coreDataVolumeCount" : 1, "periodType" : 0, "azCategory" : 0 } ] } ``` #### SDK代码示例 SDK代码示例如下。 - [Java] ``` package com.huaweicloud.sdk.test; import com.huaweicloud.sdk.core.auth.ICredential; import com.huaweicloud.sdk.core.auth.BasicCredentials; import com.huaweicloud.sdk.core.exception.ConnectionException; import com.huaweicloud.sdk.core.exception.RequestTimeoutException; import com.huaweicloud.sdk.core.exception.ServiceResponseException; import com.huaweicloud.sdk.mrs.v1.region.MrsRegion; import com.huaweicloud.sdk.mrs.v1.*; import com.huaweicloud.sdk.mrs.v1.model.*; public class ListClustersSolution { public static void main(String[] args) { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment String ak = System.getenv("CLOUD_SDK_AK"); String sk = System.getenv("CLOUD_SDK_SK"); String projectId = "{project_id}"; ICredential auth = new BasicCredentials() .withProjectId(projectId) .withAk(ak) .withSk(sk); MrsClient client = MrsClient.newBuilder() .withCredential(auth) .withRegion(MrsRegion.valueOf("")) .build(); ListClustersRequest request = new ListClustersRequest(); try { ListClustersResponse response = client.listClusters(request); System.out.println(response.toString()); } catch (ConnectionException e) { e.printStackTrace(); } catch (RequestTimeoutException e) { e.printStackTrace(); } catch (ServiceResponseException e) { e.printStackTrace(); System.out.println(e.getHttpStatusCode()); System.out.println(e.getRequestId()); System.out.println(e.getErrorCode()); System.out.println(e.getErrorMsg()); } } } ``` - [Python] ``` # coding: utf-8 import os from huaweicloudsdkcore.auth.credentials import BasicCredentials from huaweicloudsdkmrs.v1.region.mrs_region import MrsRegion from huaweicloudsdkcore.exceptions import exceptions from huaweicloudsdkmrs.v1 import * if __name__ == "__main__": # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak = os.environ["CLOUD_SDK_AK"] sk = os.environ["CLOUD_SDK_SK"] projectId = "{project_id}" credentials = BasicCredentials(ak, sk, projectId) client = MrsClient.new_builder() \ .with_credentials(credentials) \ .with_region(MrsRegion.value_of("")) \ .build() try: request = ListClustersRequest() response = client.list_clusters(request) print(response) except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg) ``` - [Go] ``` package main import ( "fmt" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic" mrs "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/mrs/v1" "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/mrs/v1/model" region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/mrs/v1/region" ) func main() { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak := os.Getenv("CLOUD_SDK_AK") sk := os.Getenv("CLOUD_SDK_SK") projectId := "{project_id}" auth := basic.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). WithProjectId(projectId). Build() client := mrs.NewMrsClient( mrs.MrsClientBuilder(). WithRegion(region.ValueOf("")). WithCredential(auth). Build()) request := &model.ListClustersRequest{} response, err := client.ListClusters(request) if err == nil { fmt.Printf("%+v\n", response) } else { fmt.Println(err) } } ``` - [更多] 更多编程语言的SDK代码示例，请参见[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/MRS/sdk?api=ListClusters&version=v1)的代码示例页签，可生成自动对应的SDK代码示例。 #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 查询集群列表信息成功。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-mrs/ErrorCode.html)。