Skip to main content

DescribeClusterAddonsVersion

Description

call DescribeClusterAddonsVersion to query information of all components installed in the specified cluster.

Request Method

POST

Request Path

/apsara/route/CS/DescribeClusterAddonsVersion

Request Parameters Common Parameters

NameLocationTypeRequiredSample valueDescription
ClusterIdBODYstringYesc82e6987e2961451182edacd74fafcluster ID.
regionIdBODYstringYesNo sample value for this parameter.region id
versionBODYstringNo2016-01-01version of api

Return data

NameTypeSample valueDescription
existbooleantruewhether the component is installed. Value: true: already installed. false: not installed.
component_namestringack-node-problem-detectorcomponent name.
can_upgradebooleanfalsewhether the component can be upgraded. Value: true: components can be upgraded. false: components cannot be upgraded.
ready_to_upgradestringfalsewhether the component meets the upgrade conditions. Value: true: the upgrade condition is met. false: does not meet the upgrade conditions.
messagestringplug-ins for node fault detection and reporting to event centerAdditional instructions on whether the component can be upgraded.
versionstring1.2.1current version of the component.
valuestringnpd: Custom monitor definitions to add to Node Problem Detectoruser-defined parameter values when the component is installed.
requiredbooleanfalsewhether the component is a required component for the cluster. Value: true: is a required component. false: non-essential components.
next_versionstring1.2.1next Upgradeable version.
changedstringfalseWhether the component has been updated. Value: true: updated. false: not updated.
policystringoverwritecomponent upgrade policy. overwrite: mandatory overwrite. default value:overwrite.

Example

Successful Response example

{
"exist":"true",
"component_name":"ack-node-problem-detector",
"can_upgrade":"false",
"ready_to_upgrade":"false",
"message":"plug-ins for node fault detection and reporting to event center",
"version":"1.2.1",
"value":"npd: Custom monitor definitions to add to Node Problem Detector",
"required":"false",
"next_version":"1.2.1",
"changed":"false",
"policy":"overwrite"
}

Failed Response example

{
"errorSample":
{
"resultCode":-1,
"resultMsg":"system error",
"result":null
}

}