获取目标镜像ID

功能介绍

该接口用于获取当前集群的可升级目标镜像ID。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。

URI

GET /v1.0/{project_id}/clusters/{cluster_id}/target/{upgrade_type}/images

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID。获取方法请参见获取项目ID和名称。
cluster_id	是	String	待升级的集群的ID。
upgrade_type	是	String	升级目标版本类型： same：相同版本。 cross：跨版本。 crossEngine：跨引擎。

请求参数

无

响应参数

状态码： 200

表2 响应Body参数
参数	参数类型	描述
needUploadUpgradePlugin	Boolean	是否需要上传升级后版本的插件。
imageInfoList	Array of GetTargetImageIdDetail objects	镜像详情信息。

表3 GetTargetImageIdDetail
参数	参数类型	描述
id	String	可以升级的目标镜像ID。
displayName	String	可以升级的目标镜像名称。
imageDesc	String	镜像描述信息。
datastoreType	String	镜像引擎类型。
datastoreVersion	String	镜像引擎版本。
priority	Integer	优先级。

请求示例

GET /v1.0/6204a5bd270343b5885144cf9c8c158d/clusters/ea244205-d641-45d9-9dcb-ab2236bcd07e/target/cross/images

{
  "needUploadUpgradePlugin" : false,
  "imageInfoList" : [ ]
}

响应示例

状态码： 200

请求已成功。

{
  "needUploadUpgradePlugin" : false,
  "imageInfoList" : [ ]
}

状态码

状态码	描述
200	请求已成功。
400	非法请求。建议直接修改该请求，不要重试该请求。
403	请求被拒绝访问。返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。