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

OpenSearch:ListAppGroups

最終更新日:Nov 24, 2025

OpenSearch アプリケーションのリストを照会します。

操作説明

  • 名前、インスタンス ID、およびタイプでアプリケーションをフィルターします。

  • 作成時間でアプリケーションをソートします。

  • ページングをサポートします。

今すぐお試しください

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

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

opensearch:ListAppGroup

list

*AppGroup

acs:opensearch:{#regionId}:{#accountId}:app-groups/*

なし なし

リクエスト構文

GET /v4/openapi/app-groups HTTP/1.1

リクエストパラメーター

パラメーター

必須 / 任意

説明

pageNumber

integer

任意

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

1

pageSize

integer

任意

各ページで返されるエントリ数。デフォルト値: 10。

10

instanceId

string

任意

インスタンスの ID。完全一致で照合されます。

ops-cn-xxxx

name

string

任意

アプリケーション名。

my_name

type

string

任意

アプリケーションのタイプ。有効な値:

  • standard: Standard Edition アプリケーション。

  • enhanced: プレミアムエディションのアプリケーション。

standard

sortBy

integer

任意

ソート順。有効な値:

  • 0: 作成時間の降順でアプリケーションをソートします。

  • 1: 更新時間の降順でアプリケーションをソートします。

デフォルト値: 0。

0

resourceGroupId

string

任意

リソースグループの ID。

"110123123"

tags

array<object>

任意

タグのリスト。

object

任意

key

string

任意

タグキー。

foo

value

string

任意

タグの値。

bar

レスポンスフィールド

フィールド

説明

object

レスポンスボディ。

{}

totalCount

integer

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

1

requestId

string

リクエスト ID。

0A6EB64B-B4C8-CF02-810F-E660812972FF

result

array<object>

アプリケーション。

詳細については、「AppGroup」をご参照ください。

[]

array<object>

結果。

{}

created

integer

アプリケーションが作成された日時を示すタイムスタンプ。

1575442875

currentVersion

string

現在のオンラインバージョンの ID。

110116134

lockMode

string

ロックステータス。有効な値:

  • Unlock: インスタンスはロックされていません。

  • LockByExpiration: インスタンスは有効期限が切れた後に自動的にロックされます。

  • ManualLock: インスタンスは手動でロックされます。

Unlock

updated

integer

アプリケーションが最後に更新された日時を示すタイムスタンプ。

1578916076

id

string

アプリケーション ID。

110116134

chargeType

string

課金方法。有効な値:

  • POSTPAY: 従量課金。

  • PREPAY: サブスクリプション。

POSTPAY

hasPendingQuotaReviewTask

integer

クォータの承認ステータス。有効な値:

  • 0: 通常

  • 1: 承認待ち

0

name

string

アプリケーション名。

os_function_test_v1

instanceId

string

インスタンス ID。

"xxx"

chargingWay

integer

課金方法。有効な値:

  • 1: 計算リソース

  • 2: クエリ/秒 (QPS)

1

type

string

アプリケーションのタイプ。有効な値:

  • standard: Standard Edition アプリケーション。

  • enhanced: プレミアムエディションのアプリケーション。

enhanced

status

string

アプリケーションのステータス。有効な値:

  • producing: アプリケーションは作成中です。

  • review_pending: アプリケーションは承認待ちです。

  • config_pending: アプリケーションは設定待ちです。

  • normal: アプリケーションは正常に実行されています。

  • frozen: アプリケーションは凍結されています。

normal

projectId

string

A/B テストプロジェクトの名前。

"xxx"

switchedTime

integer

現在のオンラインバージョンが公開された日時を示すタイムスタンプ。

0

commodityCode

string

商品コード。

opensearch

expireOn

string

アプリケーションの有効期限が切れる時間。

"xxx"

domain

string

アプリケーショングループのドメイン。

""

description

string

アプリケーションの説明。

"xxx"

produced

integer

アプリケーションが作成されたかどうかを示します。有効な値:

  • 0: アプリケーションは作成中です。

  • 1: アプリケーションは作成されました。

1

lockedByExpiration

integer

インスタンスが有効期限切れ後に自動的にロックされるかどうかを示します。

0

quota

object

アプリケーションのクォータ情報。 詳細については、「Quota」をご参照ください。

{}

spec

string

仕様。有効な値:

  • opensearch.share.junior: ベーシック

  • opensearch.share.common: 共有汎用

  • opensearch.share.compute: 共有コンピューティング最適化

  • opensearch.share.storage: 共有ストレージ最適化

  • opensearch.private.common: 排他的汎用

  • opensearch.private.compute: 排他的コンピューティング最適化

  • opensearch.private.storage: 排他的ストレージ最適化

opensearch.share.common

docSize

integer

ストレージ容量 (GB)。

1

computeResource

integer

論理計算ユニット (LCU) 単位の計算リソース。

20

tags

array<object>

アプリケーションのタグ。

object

タグ。

key

string

タグキー。

foo

value

string

タグの値。

bar

engineType

string

エンジンタイプ。

ha3

成功レスポンス

JSONJSON

{
  "totalCount": 1,
  "requestId": "0A6EB64B-B4C8-CF02-810F-E660812972FF",
  "result": [
    {
      "created": 1575442875,
      "currentVersion": "110116134",
      "lockMode": "Unlock",
      "updated": 1578916076,
      "id": "110116134",
      "chargeType": "POSTPAY",
      "hasPendingQuotaReviewTask": 0,
      "name": "os_function_test_v1",
      "instanceId": "\"xxx\"",
      "chargingWay": 1,
      "type": "enhanced",
      "status": "normal",
      "projectId": "\"xxx\"",
      "switchedTime": 0,
      "commodityCode": "opensearch",
      "expireOn": "\"xxx\"",
      "domain": "\"\"",
      "description": "\"xxx\"",
      "produced": 1,
      "lockedByExpiration": 0,
      "quota": {
        "spec": "opensearch.share.common",
        "docSize": 1,
        "computeResource": 20
      },
      "tags": [
        {
          "key": "foo",
          "value": "bar"
        }
      ],
      "engineType": "ha3"
    }
  ]
}

エラーコード

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

変更履歴

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