すべてのプロダクト
Search

このプロダクト

    Security Center:DescribeContainerInstances

    ドキュメントセンター

    Security Center:DescribeContainerInstances

    最終更新日:Jun 15, 2026

    コンテナインスタンス情報のリストを取得します。

    今すぐお試しください

    この 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    yundun-sas:DescribeContainerInstances

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Criteria

    string

    任意

    アセットの検索条件。このパラメーターは JSON フォーマットです。フィールド名は大文字と小文字が区別されることに注意してください。以下のフィールドが含まれます:

    • name: 検索項目。

    • value: 検索項目の値。

    • logicalExp: 複数の条件間の論理関係。有効な値:

      • OR: 条件は OR 関係です。

      • AND: 条件は AND 関係です。

    説明

    コンテナ ID、クラスター ID、クラスター名、クラスタータイプ、リスクレベル、リージョンなどの条件でアセットを検索できます。サポートされている検索条件をクエリするには、 DescribeContainerCriteria 操作を呼び出してください。

    [{"name":"flag","value":"0|8","logicalExp":"AND"},{"name":"ecsType","value":"!8","logicalExp":"AND"}][{"name":"clusterType","value":"NotManagedKubernetes","logicalExp":"AND"}]
    LogicalExp

    string

    任意

    複数の検索条件間の論理関係。有効な値:

    • OR: 条件は OR 関係です。

    • AND: 条件は AND 関係です。

    AND
    PageSize

    integer

    任意

    ページングクエリにおける 1 ページあたりのエントリの最大値。デフォルト値: 20。このパラメーターを空のままにすると、1 ページあたり 20 件のエントリが返されます。

    説明

    PageSize を空のままにしないでください。

    20
    CurrentPage

    integer

    任意

    返すページのページ番号。デフォルト値: 1。

    1

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答パラメーター。

    RequestId

    string

    リクエスト ID。Alibaba Cloud がリクエストに対して生成する一意の識別子です。トラブルシューティングに使用できます。

    79CFF74D-E967-5407-8A78-EE03B925FDAA
    PageInfo

    object

    ページネーション情報。

    CurrentPage

    integer

    ページングクエリにおける現在のページのページ番号。

    1
    PageSize

    integer

    ページングクエリにおける 1 ページあたりのエントリの最大値。

    20
    TotalCount

    integer

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

    45
    Count

    integer

    ページングクエリにおける現在のページのエントリ数。

    3
    ContainerInstanceList

    array<object>

    コンテナアセット情報のリスト。

    object

    コンテナアセット情報。

    ImageRepoTag

    string

    イメージのタグ。

    0.3.1.0-dfa2010-aliyun
    AppName

    string

    アプリケーション名。

    alibaba-log-controller
    PodIp

    string

    Pod の IP アドレス。

    172.24.XX.XX
    VulCount

    integer

    コンテナクラスターの脆弱性の数。

    15
    HcStatus

    string

    ベースラインリスクのステータス。有効な値:

    • NO: ベースラインリスクは存在しません。

    • YES: ベースラインリスクが存在します。

    YES
    ImageId

    string

    イメージ ID。

    registry-vpc.cn-beijing.aliyuncs.com/acs/log-controller@sha256:5b046e2de8c490819125193ee2eb71a66f2cc16c032dcd8b69ead4be1024****
    ClusterId

    string

    クラスター ID。

    cfb41a869c71e4678a97021582dd8a****
    ImageRepoName

    string

    イメージリポジトリの名前。

    log-controller
    HostIp

    string

    ホストの IP アドレス。

    172.24.XX.XX
    Pod

    string

    Pod 名。

    alibaba-log-controller-6f847f8786-mk2mg
    RiskStatus

    string

    リスクが存在するかどうかを示します。有効な値:

    • NO: リスクは存在しません。

    • YES: リスクが存在します。

    YES
    VulStatus

    string

    コンテナアセットに脆弱性が存在するかどうかを示します。有効な値:

    • YES: 脆弱性が存在します。

    • NO: 脆弱性は存在しません。

    YES
    AlarmStatus

    string

    コンテナにセキュリティアラートが存在するかどうかを示します。有効な値:

    • YES: セキュリティアラートが存在します。

    • NO: セキュリティアラートは存在しません。

    YES
    Image

    string

    コンテナイメージ。

    docker.io/library/nginx:latest
    ImageRepoNamespace

    string

    イメージリポジトリの名前空間。

    acs
    ImageDigest

    string

    イメージのダイジェスト値。

    5b046e2de8c490819125193ee2eb71a66f2cc16c032dcd8b69ead4be1024****
    Namespace

    string

    名前空間。

    kube-system
    InstanceId

    string

    アセットインスタンスの ID。

    i-2zegzjyotydfkz9****
    NodeInfo

    string

    ノード情報。

    test
    ImageUuid

    string

    イメージの UUID。

    5f23dfbceec289a49ac94e035e2****
    RegionId

    string

    コンテナのリージョン ID。

    cn-hangzhou
    UpdateMark

    string

    コンテナアセットの更新識別子。

    79cff74d-e967-5407-8a78-ee03b9****
    ContainerId

    string

    コンテナ ID。

    48a6d9a92435a13ad573372c3f3c63b7e04d106458141df9f92155709d****
    NodeName

    string

    ノード名。

    test
    HcCount

    integer

    ベースラインリスクの数。

    1
    ClusterName

    string

    クラスター名。

    test
    RiskCount

    string

    リスクの数。

    1
    AlarmCount

    integer

    アラートの数。

    1
    CreateTimestamp

    integer

    クラスターが作成されたタイムスタンプ（ミリ秒単位）。

    1670368337000
    Exposed

    integer

    コンテナがインターネットに公開されているかどうかを示します。有効な値:

    • 1: 公開されています。

    • 0: 公開されていません。

    1
    ExposedDetail

    string

    JSON フォーマットの公開の詳細。

    [{\"exposedName\":\"nginx-ingress-lb\",\"exposedType\":\"LoadBalancer\",\"portDOList\":[{\"name\":\"http\",\"nodePort\":32268,\"port\":80,\"targetPort\":80},{\"name\":\"https\",\"nodePort\":32376,\"port\":443,\"targetPort\":443}]}]

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "79CFF74D-E967-5407-8A78-EE03B925FDAA",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 45,
    "Count": 3
  },
  "ContainerInstanceList": [
    {
      "ImageRepoTag": "0.3.1.0-dfa2010-aliyun",
      "AppName": "alibaba-log-controller",
      "PodIp": "172.24.XX.XX",
      "VulCount": 15,
      "HcStatus": "YES",
      "ImageId": "registry-vpc.cn-beijing.aliyuncs.com/acs/log-controller@sha256:5b046e2de8c490819125193ee2eb71a66f2cc16c032dcd8b69ead4be1024****",
      "ClusterId": "cfb41a869c71e4678a97021582dd8a****",
      "ImageRepoName": "log-controller",
      "HostIp": "172.24.XX.XX",
      "Pod": "alibaba-log-controller-6f847f8786-mk2mg",
      "RiskStatus": "YES",
      "VulStatus": "YES",
      "AlarmStatus": "YES",
      "Image": "docker.io/library/nginx:latest",
      "ImageRepoNamespace": "acs",
      "ImageDigest": "5b046e2de8c490819125193ee2eb71a66f2cc16c032dcd8b69ead4be1024****",
      "Namespace": "kube-system",
      "InstanceId": "i-2zegzjyotydfkz9****",
      "NodeInfo": "test",
      "ImageUuid": "5f23dfbceec289a49ac94e035e2****",
      "RegionId": "cn-hangzhou",
      "UpdateMark": "79cff74d-e967-5407-8a78-ee03b9****",
      "ContainerId": "48a6d9a92435a13ad573372c3f3c63b7e04d106458141df9f92155709d****",
      "NodeName": "test",
      "HcCount": 1,
      "ClusterName": "test",
      "RiskCount": "1",
      "AlarmCount": 1,
      "CreateTimestamp": 1670368337000,
      "Exposed": 1,
      "ExposedDetail": "[{\\\"exposedName\\\":\\\"nginx-ingress-lb\\\",\\\"exposedType\\\":\\\"LoadBalancer\\\",\\\"portDOList\\\":[{\\\"name\\\":\\\"http\\\",\\\"nodePort\\\":32268,\\\"port\\\":80,\\\"targetPort\\\":80},{\\\"name\\\":\\\"https\\\",\\\"nodePort\\\":32376,\\\"port\\\":443,\\\"targetPort\\\":443}]}] "
    }
  ]
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    500 ServerError ServerError
    403 NoPermission caller has no permission

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

    変更履歴

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