すべてのプロダクト
Search

このプロダクト

    Elastic Container Instance:DescribeImageCaches

    ドキュメントセンター

    Elastic Container Instance:DescribeImageCaches

    最終更新日:Oct 17, 2025

    1 つ以上のイメージキャッシュの詳細を照会します。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    eci:DescribeImageCaches

    get

    ImageCache

    acs:eci:{#regionId}:{#accountId}:imagecache/*

    ImageCache

    acs:eci:{#regionId}:{#accountId}:imagecache/{#imagecacheId}
    • eci:tag
    		 なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    リージョン ID。

    cn-hangzhou
    RegionId

    string

    必須

    リージョン ID。

    cn-hangzhou
    ImageCacheId

    string

    任意

    イメージキャッシュ ID。

    imc-bp195erqe9o2pb09****
    ImageCacheName

    string

    任意

    イメージキャッシュの名前。

    testcache
    SnapshotId

    string

    任意

    イメージキャッシュに対応するスナップショット ID。

    s-2zec5oj8e1yhxijt****
    Image

    string

    任意

    コンテナイメージ。

    nginx
    ResourceGroupId

    string

    任意

    イメージキャッシュが属するリソースグループの ID。

    rg-2df3isufhi38****
    Tag

    array<object>

    任意

    イメージキャッシュにアタッチされているタグ。

    object

    任意

    イメージキャッシュにアタッチされているタグ。最大 20 個のタグを指定できます。

    Key

    string

    任意

    タグのキー。

    imc
    Value

    string

    任意

    タグの値。

    test
    MatchImage

    array

    任意

    一致したイメージキャッシュのクエリに使用されるコンテナイメージ。最大 100 個のイメージを指定できます。

    registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl

    string

    任意

    一致したイメージキャッシュのクエリに使用されるコンテナイメージ。最大 100 個のイメージを指定できます。

    registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl
    Limit

    integer

    任意

    返すエントリの最大数。

    20
    NextToken

    string

    任意

    次のクエリに使用されるトークン。前の API 呼び出しの応答の `NextToken` パラメーターからトークンを取得できます。

    AAAAAdDWBF2****
    ImageFullMatch

    boolean

    任意

    コンテナイメージの完全一致を実行するかどうかを指定します。
    このパラメーターは、`MatchImage` が指定されている場合にクエリ結果をさらにフィルター処理するために使用されます。

    true
    ImageMatchCountRequest

    integer

    任意

    コンテナイメージに完全に一致するイメージキャッシュの数。
    このパラメーターは、`MatchImage` が指定されている場合にクエリ結果をさらにフィルター処理するために使用されます。

    3

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエスト ID。

    39FC2E43-3DD7-4CEF-9EF4-E4AD6E635301
    ImageCaches

    array<object>

    イメージキャッシュのリスト。

    array<object>

    イメージキャッシュのリスト。

    Images

    array

    イメージキャッシュ内のイメージのリスト。

    string

    イメージキャッシュ内のイメージのリスト。

    registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl
    CreationTime

    string

    イメージキャッシュが作成された時刻。

    2021-02-09T02:24:07Z
    Status

    string

    イメージキャッシュのステータス。有効な値:

    • Preparing: イメージキャッシュは準備中です。

    • Creating: イメージキャッシュは作成中です。

    • Ready: イメージキャッシュは作成済みです。

    • Failed: イメージキャッシュの作成に失敗しました。

    • Updating: イメージキャッシュは更新中です。

    • UpdateFailed: イメージキャッシュの更新に失敗しました。

    イメージキャッシュは、Ready 状態の場合にのみ使用できます。

    Ready
    Progress

    string

    イメージキャッシュのスナップショットを作成する進行状況。

    説明

    インスタントイメージキャッシュ機能が有効になっている場合、標準スナップショットが作成される前に一時的なローカルスナップショットが作成されます。このパラメーターは、標準スナップショットの作成の進行状況を示します。

    100%
    ExpireDateTime

    string

    有効期限。

    2019-11-10T09:00:48Z
    LastMatchedTime

    string

    イメージキャッシュが最後に照合された時刻。

    2021-08-18T03:48:10Z
    ContainerGroupId

    string

    コンテナグループの ID。

    eci-bp18oq3m15prd9jb****
    Tags

    array<object>

    イメージキャッシュのタグのリスト。

    object

    イメージキャッシュのタグのリスト。

    Key

    string

    タグキー。

    imc
    Value

    string

    タグの値。

    test
    Events

    array<object>

    イメージキャッシュのイメージがプルされたときに生成されるイベント。

    object

    イメージキャッシュのイメージがプルされたときに生成されるイベント。

    Type

    string

    イベントのタイプ。

    Normal
    LastTimestamp

    string

    イベントが終了した時刻。

    2021-02-09T02:24:48Z
    Message

    string

    イベントメッセージ。

    Successfully check image cache resource.
    Name

    string

    イベントの名前。

    imagetest.1661f31f851a****
    Count

    integer

    イベントの数。

    1
    FirstTimestamp

    string

    イベントが開始した時刻。

    2021-02-09T02:24:48Z
    Reason

    string

    イベントの理由。

    Started
    ImageCacheId

    string

    イメージキャッシュ ID。

    imc-bp195erqe9o2pb09****
    RegionId

    string

    リージョン ID。

    cn-beijing
    SnapshotId

    string

    イメージキャッシュに対応するスナップショット ID。

    s-2zec5oj8e1yhxijt****
    FlashSnapshotId

    string

    ローカルスナップショットの ID。インスタントイメージキャッシュ機能が有効になっている場合、一時的なローカルスナップショットが作成されます。

    s-bp12w3v37sit96t6****
    ResourceGroupId

    string

    リソースグループの ID。

    rg-2df3isufhi38****
    ImageCacheSize

    integer

    イメージキャッシュのサイズ。単位: GiB。

    20
    ImageCacheName

    string

    イメージキャッシュの名前。

    imagetest
    EliminationStrategy

    string

    イメージキャッシュを保持するためのポリシー。このパラメーターを空のままにすると、イメージキャッシュは常に保持されます。

    このパラメーターを LRU に設定できます。この値は、イメージキャッシュを自動的に削除できることを示します。イメージキャッシュの数がクォータ制限に達すると、システムは、`EliminationStrategy` が `LRU` に設定されている、最も最近使用されていないイメージキャッシュを自動的に削除します。

    LRU
    NextToken

    string

    返されたページネーショントークン。

    AAAAAdDWBF2****
    TotalCount

    integer

    返されたエントリの総数。

    15

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "39FC2E43-3DD7-4CEF-9EF4-E4AD6E635301",
  "ImageCaches": [
    {
      "Images": [
        "registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl"
      ],
      "CreationTime": "2021-02-09T02:24:07Z",
      "Status": "Ready",
      "Progress": "100%",
      "ExpireDateTime": "2019-11-10T09:00:48Z",
      "LastMatchedTime": "2021-08-18T03:48:10Z",
      "ContainerGroupId": "eci-bp18oq3m15prd9jb****",
      "Tags": [
        {
          "Key": "imc",
          "Value": "test"
        }
      ],
      "Events": [
        {
          "Type": "Normal",
          "LastTimestamp": "2021-02-09T02:24:48Z",
          "Message": "Successfully check image cache resource.",
          "Name": "imagetest.1661f31f851a****",
          "Count": 1,
          "FirstTimestamp": "2021-02-09T02:24:48Z",
          "Reason": "Started"
        }
      ],
      "ImageCacheId": "imc-bp195erqe9o2pb09****",
      "RegionId": "cn-beijing",
      "SnapshotId": "s-2zec5oj8e1yhxijt****",
      "FlashSnapshotId": "s-bp12w3v37sit96t6****",
      "ResourceGroupId": "rg-2df3isufhi38****",
      "ImageCacheSize": 20,
      "ImageCacheName": "imagetest",
      "EliminationStrategy": "LRU"
    }
  ],
  "NextToken": "AAAAAdDWBF2****",
  "TotalCount": 15
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 Account.Arrearage Your account has an outstanding payment. Your account has an outstanding payment.
    400 DryRunOperation Request validation has been passed with DryRun flag set. Request validation has been passed with DryRun flag set.
    400 ServiceNotEnabled %s
    403 Forbidden.SubUser The specified action is not available for you.
    403 Forbidden.UserBussinessStatus This operation is not allowed, because you have overdue bills. Pay the overdue bill and try again.
    403 Forbidden.UserNotRealNameAuthentication This operation is not allowed, because you have not passed the real-name verification.
    403 NoPermission The RAM role does not belong to ECS.

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。