调用DescribeClusterService接口,查询集群当前安装服务的详情信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeClusterService |
系统规定参数。取值:DescribeClusterService。 |
ClusterId | String | 是 | C-F32FB31D8295**** |
集群ID。您可以调用ListClusters查看集群的ID。 |
RegionId | String | 是 | cn-hangzhou |
地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。 |
ServiceName | String | 是 | HDFS |
待查询的服务名称,例如:HDFS和YARN。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | EBB4D49C-4064-4818-B3AE-4C6BE5FC8264 |
当前请求的唯一ID标识。 |
ServiceInfo | Struct |
集群的服务详情信息。 |
|
ClusterServiceSummaryList | Array of ClusterServiceSummary |
服务的概览信息,主要是服务各个组件的统计数据信息。 |
|
ClusterServiceSummary | |||
AlertInfo | String | "" |
当前Key对应的警告信息。 |
Category | String | MASTER |
组件类型,枚举值:Client、MASTER和SLAVE。 |
DesiredStoppedValue | Integer | 1 |
预期的已停止组件个数。 |
DisplayName | String | NodeManager |
展示名称。 |
Key | String | NodeManager |
Key,一般是服务的组件名称。 |
Status | String | OK |
状态信息。 |
Type | String | COMPONENT |
当前Key的类型信息。 |
Value | String | 20/20 Started |
当前Key对应的Value信息。 |
NeedRestartComponentNameList | List | ["NodeManager","ResourceManager"] |
待重启的组件名称列表。 |
NeedRestartHostIdList | List | ["HostId1"] |
集群中,当前服务待重启的组件所在的主机ID信息。 |
NeedRestartInfo | String | "" |
当前服务待重启的组件详情信息。 |
NeedRestartNum | Integer | 0 |
当前服务需要重启的组件个数。 |
ServiceActionList | Array of ServiceAction |
服务支持的Action列表。 |
|
ServiceAction | |||
ActionName | String | CUSTOM_COMMAND |
Action名称。 |
Command | String | refreshQueues |
ActionName为 CUSTOM_COMMAND 时,才会有对应的 Command。不同的服务支持不同的 Command,当前 YARN 支持refreshQueues、enableCGroups和disableCGroups。 |
ComponentName | String | NodeManager |
Action对应的组件名称。 |
DisplayName | String | RESTART NodeManager |
Action的展示名称。 |
ServiceName | String | YARN |
服务名称。 |
ServiceName | String | YARN |
服务名称。 |
ServiceStatus | String | INSTALLED |
服务状态。 |
ServiceVersion | String | 2.7.2 |
服务的版本信息。 |
示例
请求示例
http(s)://[Endpoint]/?Action=DescribeClusterService
&ClusterId=C-F32FB31D8295****
&RegionId=cn-hangzhou
&ServiceName=HDFS
&<公共请求参数>
正常返回示例
XML
格式
<DescribeClusterServiceResponse>
<data>
<RequestId>7A23195A-BC03-4D82-BED5-90ED0D36F002</RequestId>
<ServiceInfo>
<NeedRestartHostIdList></NeedRestartHostIdList>
<ServiceActionList>
<ServiceAction>
<ActionName>CONFIGURE</ActionName>
<ServiceName>YARN</ServiceName>
<DisplayName>CONFIGURE All Components</DisplayName>
<ComponentName>ALL COMPONENTS</ComponentName>
</ServiceAction>
<ServiceAction>
<ActionName>START</ActionName>
<ServiceName>YARN</ServiceName>
<DisplayName>START All Components</DisplayName>
<ComponentName>ALL COMPONENTS</ComponentName>
</ServiceAction>
<ServiceAction>
<ActionName>STOP</ActionName>
<ServiceName>YARN</ServiceName>
<DisplayName>STOP All Components</DisplayName>
<ComponentName>ALL COMPONENTS</ComponentName>
</ServiceAction>
<ServiceAction>
<ActionName>RESTART</ActionName>
<ServiceName>YARN</ServiceName>
<DisplayName>RESTART All Components</DisplayName>
<ComponentName>ALL COMPONENTS</ComponentName>
</ServiceAction>
<ServiceAction>
<ActionName>RESTART</ActionName>
<ServiceName>YARN</ServiceName>
<DisplayName>RESTART NodeManager</DisplayName>
<ComponentName>NodeManager</ComponentName>
</ServiceAction>
<ServiceAction>
<ActionName>RESTART</ActionName>
<ServiceName>YARN</ServiceName>
<DisplayName>RESTART WebAppProxyServer</DisplayName>
<ComponentName>WebAppProxyServer</ComponentName>
</ServiceAction>
<ServiceAction>
<ActionName>RESTART</ActionName>
<ServiceName>YARN</ServiceName>
<DisplayName>RESTART JobHistory</DisplayName>
<ComponentName>JobHistory</ComponentName>
</ServiceAction>
<ServiceAction>
<ActionName>RESTART</ActionName>
<ServiceName>YARN</ServiceName>
<DisplayName>RESTART ResourceManager</DisplayName>
<ComponentName>ResourceManager</ComponentName>
</ServiceAction>
<ServiceAction>
<ActionName>RESTART</ActionName>
<ServiceName>YARN</ServiceName>
<DisplayName>RESTART App Timeline Server</DisplayName>
<ComponentName>TimeLineServer</ComponentName>
</ServiceAction>
<ServiceAction>
<Command>refreshQueues</Command>
<ActionName>CUSTOM_COMMAND</ActionName>
<ServiceName>YARN</ServiceName>
<DisplayName>Refresh Queues</DisplayName>
<ComponentName>ResourceManager</ComponentName>
</ServiceAction>
<ServiceAction>
<Command>enableCGroups</Command>
<ActionName>CUSTOM_COMMAND</ActionName>
<ServiceName>YARN</ServiceName>
<DisplayName>Enable CGroups</DisplayName>
<ComponentName>NodeManager</ComponentName>
</ServiceAction>
<ServiceAction>
<Command>disableCGroups</Command>
<ActionName>CUSTOM_COMMAND</ActionName>
<ServiceName>YARN</ServiceName>
<DisplayName>Disable CGroups</DisplayName>
<ComponentName>NodeManager</ComponentName>
</ServiceAction>
</ServiceActionList>
<ServiceName>YARN</ServiceName>
<NeedRestartInfo></NeedRestartInfo>
<NeedRestartNum>0</NeedRestartNum>
<ClusterServiceSummaryList>
<ClusterServiceSummary>
<Status>OK</Status>
<Value>20/20 Started</Value>
<Key>NodeManager</Key>
<Type>COMPONENT</Type>
<DisplayName>NodeManager</DisplayName>
<AlertInfo></AlertInfo>
</ClusterServiceSummary>
<ClusterServiceSummary>
<Status>OK</Status>
<Value>1/1 Started</Value>
<Key>JobHistory</Key>
<Type>COMPONENT</Type>
<DisplayName>JobHistory</DisplayName>
<AlertInfo></AlertInfo>
</ClusterServiceSummary>
<ClusterServiceSummary>
<Status>OK</Status>
<Value>22/22 Installed</Value>
<Key>YarnInit</Key>
<Type>COMPONENT</Type>
<DisplayName>Yarn Client</DisplayName>
<AlertInfo></AlertInfo>
</ClusterServiceSummary>
<ClusterServiceSummary>
<Status>OK</Status>
<Value>1/1 Started</Value>
<Key>TimeLineServer</Key>
<Type>COMPONENT</Type>
<DisplayName>App Timeline Server</DisplayName>
<AlertInfo></AlertInfo>
</ClusterServiceSummary>
<ClusterServiceSummary>
<Status>OK</Status>
<Value>1/1 Started</Value>
<Key>WebAppProxyServer</Key>
<Type>COMPONENT</Type>
<DisplayName>WebAppProxyServer</DisplayName>
<AlertInfo></AlertInfo>
</ClusterServiceSummary>
<ClusterServiceSummary>
<Status>OK</Status>
<Value>2/2 Started</Value>
<Key>ResourceManager</Key>
<Type>COMPONENT</Type>
<DisplayName>ResourceManager</DisplayName>
<AlertInfo></AlertInfo>
</ClusterServiceSummary>
</ClusterServiceSummaryList>
<ServiceVersion>2.7.2-1.3.1</ServiceVersion>
<NeedRestartComponentNameList></NeedRestartComponentNameList>
<ServiceStatus>INSTALLING</ServiceStatus>
</ServiceInfo>
</data>
<requestId>7A23195A-BC03-4D82-BED5-90ED0D36F002</requestId>
</DescribeClusterServiceResponse>
JSON
格式
{
"data": {
"RequestId": "7A23195A-BC03-4D82-BED5-90ED0D36F002",
"ServiceInfo": {
"NeedRestartHostIdList": {
"Service": []
},
"ServiceActionList": {
"ServiceAction": [
{
"ActionName": "CONFIGURE",
"ServiceName": "YARN",
"DisplayName": "CONFIGURE All Components",
"ComponentName": "ALL COMPONENTS"
},
{
"ActionName": "START",
"ServiceName": "YARN",
"DisplayName": "START All Components",
"ComponentName": "ALL COMPONENTS"
},
{
"ActionName": "STOP",
"ServiceName": "YARN",
"DisplayName": "STOP All Components",
"ComponentName": "ALL COMPONENTS"
},
{
"ActionName": "RESTART",
"ServiceName": "YARN",
"DisplayName": "RESTART All Components",
"ComponentName": "ALL COMPONENTS"
},
{
"ActionName": "RESTART",
"ServiceName": "YARN",
"DisplayName": "RESTART NodeManager",
"ComponentName": "NodeManager"
},
{
"ActionName": "RESTART",
"ServiceName": "YARN",
"DisplayName": "RESTART WebAppProxyServer",
"ComponentName": "WebAppProxyServer"
},
{
"ActionName": "RESTART",
"ServiceName": "YARN",
"DisplayName": "RESTART JobHistory",
"ComponentName": "JobHistory"
},
{
"ActionName": "RESTART",
"ServiceName": "YARN",
"DisplayName": "RESTART ResourceManager",
"ComponentName": "ResourceManager"
},
{
"ActionName": "RESTART",
"ServiceName": "YARN",
"DisplayName": "RESTART App Timeline Server",
"ComponentName": "TimeLineServer"
},
{
"Command": "refreshQueues",
"ActionName": "CUSTOM_COMMAND",
"ServiceName": "YARN",
"DisplayName": "Refresh Queues",
"ComponentName": "ResourceManager"
},
{
"Command": "enableCGroups",
"ActionName": "CUSTOM_COMMAND",
"ServiceName": "YARN",
"DisplayName": "Enable CGroups",
"ComponentName": "NodeManager"
},
{
"Command": "disableCGroups",
"ActionName": "CUSTOM_COMMAND",
"ServiceName": "YARN",
"DisplayName": "Disable CGroups",
"ComponentName": "NodeManager"
}
]
},
"ServiceName": "YARN",
"NeedRestartInfo": "",
"NeedRestartNum": 0,
"ClusterServiceSummaryList": {
"ClusterServiceSummary": [
{
"Status": "OK",
"Value": "20/20 Started",
"Key": "NodeManager",
"Type": "COMPONENT",
"DisplayName": "NodeManager",
"AlertInfo": ""
},
{
"Status": "OK",
"Value": "1/1 Started",
"Key": "JobHistory",
"Type": "COMPONENT",
"DisplayName": "JobHistory",
"AlertInfo": ""
},
{
"Status": "OK",
"Value": "22/22 Installed",
"Key": "YarnInit",
"Type": "COMPONENT",
"DisplayName": "Yarn Client",
"AlertInfo": ""
},
{
"Status": "OK",
"Value": "1/1 Started",
"Key": "TimeLineServer",
"Type": "COMPONENT",
"DisplayName": "App Timeline Server",
"AlertInfo": ""
},
{
"Status": "OK",
"Value": "1/1 Started",
"Key": "WebAppProxyServer",
"Type": "COMPONENT",
"DisplayName": "WebAppProxyServer",
"AlertInfo": ""
},
{
"Status": "OK",
"Value": "2/2 Started",
"Key": "ResourceManager",
"Type": "COMPONENT",
"DisplayName": "ResourceManager",
"AlertInfo": ""
}
]
},
"ServiceVersion": "2.7.2-1.3.1",
"NeedRestartComponentNameList": {
"Service": []
},
"ServiceStatus": "INSTALLING"
}
},
"requestId": "7A23195A-BC03-4D82-BED5-90ED0D36F002"
}