edit-icon download-icon

DescribeImage

最終更新日: Oct 29, 2018

ローカルの単一イメージ情報を照会します。

説明

ユーザーは、クラスターにプルされた単一イメージ情報を照会することができます。

リクエストパラメータ

フィールド タイプ 要否 デフォルト値 説明
Action String - 操作インターフェイス名、システム規定パラメーター、値:DescribeImage
RegionId String - リージョン ID
ClusterId String - クラスター ID
Repository String - リポジトリ名
ImageTag String latest イメージタグ、デフォルト値:latest
ContainerType String shifter コンテナアプリケーションタイプ、値shifter。デフォルト値:shifter

リターンパラメーター

共通リターンパラメーターに加えて、以下の結果が返されます。

フィールド タイプ 説明
ImageInfo ImageInfo イメージ情報

このうち、ImageInfo 構造体には以下のフィールドが含まれます。

フィールド タイプ 説明
System String Shifter システム
Type String イメージタイプ
Status String イメージステータス
ImageId String イメージ ID
UpdateDateTime String イメージの最終更新日時
Repository String リポジトリ名
Tag String タグ

リクエスト例

  1. https://ehpc.cn-hangzhou.aliyuncs.com/?Action=DescribeImage&RegionId=cn-hangzhou&ClusterId=<クラスター ID>&Repository=hello-world&<共通リターンパラメーター>

リターン例

XML 形式

  1. <DescribeImageResponse>
  2. <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
  3. <ImageInfo>
  4. <System>mycluster</System>
  5. <Type>docker</Type>
  6. <Status>READY</Status>
  7. <ImageId>3535063d99</ImageId>
  8. <UpdateDateTime>2018-08-02T20:11:36</UpdateDateTime>
  9. <Repository>hello-world</Repository>
  10. <Tag>latest</Tag>
  11. </ImageInfo>
  12. </DescribeImageResponse>

JSON 形式

  1. {
  2. "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
  3. "ImageInfo": {
  4. "System": "mycluster",
  5. "Type": "docker",
  6. "Status": "READY",
  7. "ImageId": "3535063d99",
  8. "UpdateDateTime": "2018-08-02T20:11:36",
  9. "Repository": "hello-world",
  10. "Tag": "latest"
  11. }
  12. }

エラーコード

E-HPC インターフェイスのエラーコードについては、エラーコードで確認することができます。その他のエラーコードについては、API エラーセンターをご参照ください。