ListComponentInstances - 查询组件实例列表 - 开源大数据平台E-MapReduce

查询组件实例列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

emr:ListComponentInstances

list

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	区域 ID。您可以调用 ListRegions 查看。	cn-hangzhou
ClusterId	string	是	集群 ID。	C-8CFEBCCFFEF5****
NextToken	string	否	用来标记当前开始读取的位置，置空表示从头开始。	“”
MaxResults	integer	否	读取的最大数据记录数量。	10
ApplicationNames	array	否	应用名列表。	c-b933c5aac8fe****
	string	否	应用名。	KNOX
NodeIds	array	否	机器 ID 列表。	DD6B1B2A-5837-5237-ABE4-FF0C89568980
	string	否	机器 ID。	i-bp17yy050pxo01m2****
NodeNames	array	否	机器名列表。	20
	string	否	机器名。	emr-worker-1
ComponentNames	array	否	组件名列表。	["HDFS"]
	string	否	组件名。	KNOX
ComponentStates	array	否	组件状态列表。	null
	string	否	组件状态。	INSTALLED
ZoneId	string	否	可用区 ID。	cn-hangzhou-i

返回参数

名称	类型	描述	示例值
	object	Schema of Response
ComponentInstances	array<object>	实例组件安装信息列表。
	object	实例组件安装信息。
ComponentName	string	组件名。	KNOX
ApplicationName	string	应用名。	KNOX
ComponentInstanceState	string	组件状态，取值如下： WAITING：等待中。 INSTALLING：安装中。 INSTALLED：已安装。 INSTALL_FAILED：安装失败。 STARTING：启动中。 STARTED：已启动。 START_FAILED：启动失败。 STOPPING：停止中。 STOPPED：已停止。 STOP_FAILED：停止失败。	STARTED
NodeId	string	机器 ID。	i-bp17yy050pxo01m2****
NodeName	string	机器名。	emr-worker-1
CommissionState	string	Commission 状态，取值如下： COMMISSIONED：已上线。 COMMISSIONING：上线中。 DECOMMISSIONED：已下线。 DECOMMISSIONINPROGRESS：下线进程中。 DECOMMISSIONFAILED：下线失败。 INSERVICE：服务中。 UNKNOWN：未知状态。	INSERVICE
BizState	string	组件服务状态，取值如下： active：主服务。 standby：备用服务。	active
CreateTime	integer	安装时间戳。	1628248947000
DesiredState	string	期望状态，取值如下： WAITING：等待中。 INSTALLING：安装中。 INSTALLED：已安装。 INSTALL_FAILED：安装失败。 STARTING：启动中。 STARTED：已启动。 START_FAILED：启动失败。 STOPPING：停止中。 STOPPED：已停止。 STOP_FAILED：停止失败。	STARTED
ZoneId	string	可用区 ID。	cn-hangzhou-i
RequestId	string	请求 ID。	7345241A-014C-17D2-A3AC-C72771188F46
NextToken	string	用来标记当前开始读取的位置，置空表示从头开始。	“”
MaxResults	integer	读取的最大数据记录数量。	2
TotalCount	integer	结果总数。	2

示例

正常返回示例

JSON格式

{
  "ComponentInstances": [
    {
      "ComponentName": "KNOX",
      "ApplicationName": "KNOX",
      "ComponentInstanceState": "STARTED",
      "NodeId": "i-bp17yy050pxo01m2****",
      "NodeName": "emr-worker-1",
      "CommissionState": "INSERVICE",
      "BizState": "active",
      "CreateTime": 1628248947000,
      "DesiredState": "STARTED",
      "ZoneId": "cn-hangzhou-i"
    }
  ],
  "RequestId": "7345241A-014C-17D2-A3AC-C72771188F46",
  "NextToken": "“”",
  "MaxResults": 2,
  "TotalCount": 2
}

错误码

HTTP status code	错误码	错误信息	描述
400	ConflictParameters	Parameters that must not be used together. %s	多个参数间存在冲突。
400	IncompleteSignature	The request signature is invalid.	API请求签名不合法。
400	InvalidAction	The action %s requested is invalid.	不合法的Action。
400	InvalidParameter	The specified parameter %s is not valid.	参数错误。
400	InvalidParameterValue	The input parameter %s is invalid or out of range.	参数值超出范围。
400	MissingAction	The action %s requested is missing.	缺少Action参数
400	MissingParameter	The input parameter %s that is mandatory for processing this request is not supplied.	参数缺失。
400	NotAuthorized	You do not have permission to perform this action. %s	没有权限。
400	ThrottlingException	The request was denied due to request throttling. %s	限流。
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	内部错误。
404	ResourceNotFound	The resource not found by %s.	请求的资源未找到。
503	ServiceFailure	The request has failed due to a temporary failure of %s service.	依赖的阿里云其他服务不可用。
503	ServiceUnavailable	The request has failed due to a temporary failure of the server.	请求超时或者服务不可用。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。