すべてのプロダクト
Search
ドキュメントセンター

ENS:ListApplications

最終更新日:Mar 20, 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ens:ListApplications

get

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

ClusterNames

string

任意

アプリケーションクラスターの名前です。複数の名前はカンマ (,) で区切ります。アカウント内のすべてのクラスターのアプリケーションをクエリする場合は、このパラメーターに `All` を指定します。デフォルト値: All。

poc,pre

AppVersions

string

任意

アプリケーションのバージョン番号です。複数のバージョン番号はカンマ (,) で区切ります。アプリケーションのすべてのバージョンのデータをクエリする場合は、このパラメーターに `All` を指定します。デフォルトでは、安定版のアプリケーションのデータのみがクエリされます。

v1,v2

Level

string

任意

アプリケーションのエッジリソースが収集されるリージョンレベルです。値は列挙型です。有効な値は次のとおりです。

  • National:中国本土

  • Big:エリア

  • Middle:省

  • Small:市

  • RegionId:エッジノード

デフォルト値: National。

列挙値:

  • Big :
  • Small :
  • National :
  • RegionId :
  • Middle :

National

OutAppInfoParams

string

任意

リソースインスタンスや Pod の統計など、アプリケーションに関する他の情報を返すかどうかを指定します。値は JSON 文字列である必要があります。デフォルトでは、すべての情報が返されます。

{\"appInfo\":true,\"detailStat\": true, \"appVersionStat\": true, \"districtStat\":true ,\"instanceStat\": true, \"podCountStat\": true}

PageNumber

integer

任意

ページ番号です。ページは 1 から始まります。すべてのデータファイルのプッシュステータスを返す場合、このパラメーターはオプションです。

1

PageSize

integer

任意

1 ページあたりのエントリ数です。アプリケーションに関するすべての情報を返す場合、このパラメーターはオプションです。

10

MinDate

string

任意

クエリする時間範囲の開始時刻です。時間は `2006-01-02` 形式で指定します。デフォルトでは、クエリする時間範囲は制限されません。

2022-02-15

MaxDate

string

任意

クエリする時間範囲の終了時刻です。時間は `2006-01-02` 形式で指定します。デフォルトでは、クエリする時間範囲は制限されません。

2022-02-20

レスポンスフィールド

フィールド

説明

object

Applications

object

Application

array<object>

アプリケーションの詳細です。

array<object>

AppList

object

App

array<object>

アプリケーションの詳細です。

object

AppId

string

アプリケーションの ID です。

e76f8985-7965-41fc-925b-9648bb6bf650

AppInfo

string

リソース仕様、パラメーター設定、リソースなど、アプリケーションに関する情報です。

{ "AppStatus":{ "Phase":"RUNNING", "StatusDescrip":"{\"status\":\"UPDATE_SUCCESS\",\"step\":\"DONE\",\"descrip\":\"update to version:1022 success\",\"start_time\":\"2022-03-01 16:18:22\"}", "UpdateTime":"2022-03-01 16:18:22", "OrderStatus":null }, "ResourceAttribute":{ "NetSecurityInfo":null, "InitConfig":null, "InventoryType":"Ens", "InstanceSpec":"ens.gi6s-c12g1.large", "SystemDiskSize":100, "DataDiskSize":0, "BandwithOut":5000, "SchedulingStrategy":"Disperse", "ImageId":"m-5or73kzkuxytv7hh6wxr6yc5q", "ResourceType":"Linux", "AreaLevel":"National", "IpType":"PublicIP" }, "WorkloadAttribute":[ { "Name":"andorid", "Count":15, "ServiceConfig":{ "PortsBindConfig":{ "NetServiceContainer":"uravi-service", "Ports":[ { "Protocol":"TCP", "BindType":"Mapping", "StartNodePorts":"31000-31009", "ContainerPorts":"4440-4449" }, { "Protocol":"TCP", "BindType":"PassThrough", "StartNodePorts":"59000-59000", "ContainerPorts":"59000-59000" }, { "Protocol":"UDP", "BindType":"PassThrough", "StartNodePorts":"40001-40010", "ContainerPorts":"40001-40010" } ] }, "ServiceContainerName":"android" } }, { "Name":"coturn", "Count":1, "ServiceConfig":{ "PortsBindConfig":{ "NetServiceContainer":"coturn", "Ports":[ { "Protocol":"TCP", "BindType":"PassThrough", "StartNodePorts":"3478-3478", "ContainerPorts":"3478-3478" }, { "Protocol":"UDP", "BindType":"PassThrough", "StartNodePorts":"3478-3478", "ContainerPorts":"3478-3478" } ] }, "ServiceContainerName":"coturn" } }, { "Name":"aic-manager", "Count":1, "ServiceConfig":null } ] }

ClusterName

string

クラスターの名前です。

ay-ads-hz-h

PageNumber

integer

ページ番号です。

1

PageSize

integer

1 ページあたりのエントリ数です。

10

RequestId

string

リクエストの ID です。

50373E71-7710-4620-8AAB-133CCE49451C

TotalCount

integer

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

49

成功レスポンス

JSONJSON

{
  "Applications": {
    "Application": [
      {
        "AppList": {
          "App": [
            {
              "AppId": "e76f8985-7965-41fc-925b-9648bb6bf650",
              "AppInfo": "{\n    \"AppStatus\":{\n        \"Phase\":\"RUNNING\",\n        \"StatusDescrip\":\"{\\\"status\\\":\\\"UPDATE_SUCCESS\\\",\\\"step\\\":\\\"DONE\\\",\\\"descrip\\\":\\\"update to version:1022 success\\\",\\\"start_time\\\":\\\"2022-03-01 16:18:22\\\"}\",\n        \"UpdateTime\":\"2022-03-01 16:18:22\",\n        \"OrderStatus\":null\n    },\n    \"ResourceAttribute\":{\n        \"NetSecurityInfo\":null,\n        \"InitConfig\":null,\n        \"InventoryType\":\"Ens\",\n        \"InstanceSpec\":\"ens.gi6s-c12g1.large\",\n        \"SystemDiskSize\":100,\n        \"DataDiskSize\":0,\n        \"BandwithOut\":5000,\n        \"SchedulingStrategy\":\"Disperse\",\n        \"ImageId\":\"m-5or73kzkuxytv7hh6wxr6yc5q\",\n        \"ResourceType\":\"Linux\",\n        \"AreaLevel\":\"National\",\n        \"IpType\":\"PublicIP\"\n    },\n    \"WorkloadAttribute\":[\n        {\n            \"Name\":\"andorid\",\n            \"Count\":15,\n            \"ServiceConfig\":{\n                \"PortsBindConfig\":{\n                    \"NetServiceContainer\":\"uravi-service\",\n                    \"Ports\":[\n                        {\n                            \"Protocol\":\"TCP\",\n                            \"BindType\":\"Mapping\",\n                            \"StartNodePorts\":\"31000-31009\",\n                            \"ContainerPorts\":\"4440-4449\"\n                        },\n                        {\n                            \"Protocol\":\"TCP\",\n                            \"BindType\":\"PassThrough\",\n                            \"StartNodePorts\":\"59000-59000\",\n                            \"ContainerPorts\":\"59000-59000\"\n                        },\n                        {\n                            \"Protocol\":\"UDP\",\n                            \"BindType\":\"PassThrough\",\n                            \"StartNodePorts\":\"40001-40010\",\n                            \"ContainerPorts\":\"40001-40010\"\n                        }\n                    ]\n                },\n                \"ServiceContainerName\":\"android\"\n            }\n        },\n        {\n            \"Name\":\"coturn\",\n            \"Count\":1,\n            \"ServiceConfig\":{\n                \"PortsBindConfig\":{\n                    \"NetServiceContainer\":\"coturn\",\n                    \"Ports\":[\n                        {\n                            \"Protocol\":\"TCP\",\n                            \"BindType\":\"PassThrough\",\n                            \"StartNodePorts\":\"3478-3478\",\n                            \"ContainerPorts\":\"3478-3478\"\n                        },\n                        {\n                            \"Protocol\":\"UDP\",\n                            \"BindType\":\"PassThrough\",\n                            \"StartNodePorts\":\"3478-3478\",\n                            \"ContainerPorts\":\"3478-3478\"\n                        }\n                    ]\n                },\n                \"ServiceContainerName\":\"coturn\"\n            }\n        },\n        {\n            \"Name\":\"aic-manager\",\n            \"Count\":1,\n            \"ServiceConfig\":null\n        }\n    ]\n}"
            }
          ]
        },
        "ClusterName": "ay-ads-hz-h"
      }
    ]
  },
  "PageNumber": 1,
  "PageSize": 10,
  "RequestId": "50373E71-7710-4620-8AAB-133CCE49451C",
  "TotalCount": 49
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 MissingParameter The input parameter that is mandatory for processing this request is not supplied.
400 NoPermission Permission denied.
400 InvalidParameter.%s The specified field %s invalid. Please check it again.
400 InvalidParameter The errorMessage is %s. Please check it again.
400 ens.interface.error An error occurred while calling the API.
400 CallInterface Call Interface Happen Error.

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

変更履歴

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