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

OpenSearch:DescribeApp

最終更新日:Dec 23, 2025

OpenSearch アプリケーションの特定バージョンの情報を照会します。

今すぐお試しください

この 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:DescribeApp

get

*App

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

なし なし

リクエスト構文

GET /v4/openapi/app-groups/{appGroupIdentity}/apps/{appId} HTTP/1.1

パスパラメータ

パラメーター

必須 / 任意

説明

appGroupIdentity

string

必須

アプリケーション名

my_app_group_name

appId

integer

必須

バージョン ID。

110116134

リクエストパラメーター

パラメーター

必須 / 任意

説明

リクエストパラメーターは必要ありません。

レスポンスフィールド

フィールド

説明

object

レスポンスボディ。

{}

requestId

string

リクエスト ID。

33477D76-C380-1D84-A4AD-043F52876CB1

result

object

バージョン情報。

{}

id

string

バージョン ID。

100303063

isCurrent

boolean

バージョンがオンラインバージョンであるかどうかを示します。

True

clusterName

string

クラスター名。

-

autoSwitch

boolean

バージョンが自動的にオンラインバージョンに切り替わるかどうかを示します。

true

type

string

エディションタイプ。有効値:

  • standard:標準版アプリケーション。

  • advance:旧バージョンのアドバンスト版アプリケーション。このエディションでは新しいバージョンはサポートされていません。

  • enhanced:新しいバージョンのアドバンスト版アプリケーション。

enhanced

description

string

バージョンの説明。

-

status

string

バージョンのステータス。有効値:

  • ok:バージョンは正常です。

  • stopped:バージョンは一時停止されています。

  • frozen:バージョンは凍結されています。

  • initializing:バージョンは初期化中です。

  • unavailable:バージョンは無効です。

  • data_waiting:データは初期化待ちです。

  • data_preparing:データは初期化中です。

ok

schema

object

アプリケーションのスキーマ。

{}

tables

object

テーブルスキーマ。

{ "primaryTable": true, "name": "main", "fields": { "id": { "name": "id", "type": "LITERAL", "primaryKey": true }, "title": { "name": "title", "type": "TEXT", "primaryKey": false }, "buy": { "name": "buy", "type": "INT", "primaryKey": false }, "cate_id": { "name": "cate_id", "type": "INT", "primaryKey": false }, "cate_name": { "name": "cate_name", "type": "LITERAL", "primaryKey": false } } }

indexes

object

インデックススキーマ。

filterFields

array

属性フィールド。

string

属性フィールド。

id

searchFields

object

インデックスフィールド。

{ "fields": ["title"], "analyzer": "chn_standard" }

routeField

string

レベル 1 ルーティングフィールドの名前。

field1

routeFieldValues

array

レベル 1 ルーティングフィールドのホットバリュー。

string

レベル 1 ルーティングフィールドのホットバリュー。

routeFieldValues

secondRouteField

string

レベル 2 ルーティングフィールドの名前。このパラメーターは、`routeFieldValues` パラメーターが設定されている場合にのみ有効になります。デフォルトでは、ワイドテーブルのプライマリキーフィールドがレベル 2 ルーティングフィールドとして使用されます。

field2

ttlField

object

ドキュメントクリア設定。

name

string

ドキュメント時間フィールド。

text1

ttl

integer

TTL。単位:ミリ秒。

1000

indexSortConfig

array<object>

ソート設定。

object

ソート設定。

field

string

ソートフィールド。

field1

direction

string

ソート方法。有効値:

  • ASC

  • DESC

DESC

name

string

ワイドテーブルの名前。

test

progressPercent

integer

データインポートの進捗状況 (パーセンテージ)。たとえば、値が 83 の場合は 83% を示します。

100

fetchFields

array

デフォルト表示フィールド。

[]

string

デフォルト表示フィールド。

{}

quota

object

クォータ情報。

{}

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

qps

integer

1 秒あたりの検索リクエスト数。以前の課金モデルでは、1 秒あたりの検索リクエスト数に基づいて課金されます。

5

docSize

integer

ストレージ容量。単位:GB。

1

computeResource

integer

コンピューティングリソース。単位:論理コンピューティングユニット (LCU)。

20

domain

object

業種。有効値:

  • GENERAL

  • ECOMMERCE

  • IT_CONTENT

GENERAL

category

string

エディションのタイプ。有効値:standard、advance、enhanced。standard は標準版を示します。advance は旧バージョンのアドバンスト版を示します。このエディションでは新しいバージョンはサポートされていません。enhanced は新しいバージョンのアドバンスト版を示します。

-

name

string

名前 (英語)。

test

functions

object

検索結果。

{}

service

array

各機能の説明。

[]

string

機能 1。

-

qp

array

レイアウトに関する情報。

[]

string

情報 1。

-

algo

array

アルゴリズムの構造。

[]

string

構造 1。

-

schemas

array<object>

複数テーブルスキーマ。

array<object>

単一テーブルスキーマ。

tables

object

テーブルスキーマ。

{ "primaryTable": true, "name": "main", "fields": { "id": { "name": "id", "type": "LITERAL", "primaryKey": true }, "title": { "name": "title", "type": "TEXT", "primaryKey": false }, "buy": { "name": "buy", "type": "INT", "primaryKey": false }, "cate_id": { "name": "cate_id", "type": "INT", "primaryKey": false }, "cate_name": { "name": "cate_name", "type": "LITERAL", "primaryKey": false } } }

indexes

object

インデックススキーマ。

filterFields

array

属性フィールド。

string

属性フィールド。

field1

searchFields

object

インデックスフィールド。

{ "fields": ["title"], "analyzer": "chn_standard" }

routeField

string

レベル 1 ルーティングフィールドの名前。

field1

routeFieldValues

array

レベル 1 ルーティングフィールドのホットバリュー。

string

レベル 1 ルーティングフィールドのホットバリュー。

routeFieldValues

secondRouteField

string

レベル 2 ルーティングフィールドの名前。このパラメーターは、`routeFieldValues` パラメーターが設定されている場合にのみ有効になります。デフォルトでは、ワイドテーブルのプライマリキーフィールドがレベル 2 ルーティングフィールドとして使用されます。

field2

ttlField

object

ドキュメントクリア設定。

name

string

ドキュメント時間フィールド。

fIeld1

ttl

integer

TTL。単位:ミリ秒。

1000

indexSortConfig

array<object>

ソート設定。

object

ソート設定。

field

string

ソートフィールド。

fIeld1

direction

string

ソート方法。有効値:

  • ASC

  • DESC

DESC

name

string

ワイドテーブルの名前。

main

firstRanks

array<object>

基本ソートの設定。

object

基本ソートの設定。

type

string

式のタイプ。有効値:

STRUCT:式の内容は構造です。STRING (デフォルト):カスタム数式。

STRING

name

string

基本ソート式の名前。

test

description

string

説明。

描述

active

boolean

式がデフォルトであるかどうかを示します。

False

meta

any

式に関する情報。情報は配列または文字列タイプにすることができます。

String :"random()*100+now()"; Array: [ { "attribute": "static_bm25()", "arg": "", "weight": 10 } ]

secondRanks

array<object>

高度ソートの設定。

object

高度ソートの設定。

meta

any

高度ソート式。フィールド、特徴関数、数学関数を含む式を定義して、複雑なソートロジックを実装できます。

"cate_id > 0 and cate_id < 1000"

name

string

高度ソート式の名前。

default

description

string

説明。

描述

active

boolean

式がデフォルトであるかどうかを示します。

False

dataSources

array<object>

データソースの設定。

array<object>

データソースの設定。

tableName

string

アプリケーション内のテーブルの名前。

main

type

string

データソースのタイプ。有効値:

  • rds

  • odps

  • opensearch

  • polardb

rds

fields

array<object>

フィールドマッピングに関する情報。

object

フィールドマッピングに関する情報。

{ "id": "id" }

plugins

object

データ処理に使用されるプラグイン。

name:

  • JsonKeyValueExtractor

  • MultiValueSpliter

  • KeyValueExtractor

  • StringCatenateExtractor

  • HTMLTagRemover

parameters:

  • JsonKeyValueExtractor

  • MultiValueSpliter

  • KeyValueExtractor

  • StringCatenateExtractor

  • HTMLTagRemover

{ "name": "JsonKeyValueExtractor", "parameters": { "key": "my_field" } }

keyField

string

プライマリキー。

id

schemaName

string

ワイドテーブルの名前。

name

parameters

object

データソースに関する情報。

{ "instanceId": "rds-instance-id", "dbName": "my_db", "dbTableName": "my_table", "dbUser": "my", "dbPassword": "my_passwd", "filter":"", "autoSync": true }

summaries

array<object>

検索結果の概要設定。

array<object>

検索結果の概要設定。

name

string

グループ名。

default

meta

array<object>

概要設定。

object

概要設定。

field

string

フィールド。

field1

len

integer

セグメントの長さ。有効値:1~300。

50

element

string

ハイライトに使用される要素。

em

ellipsis

string

セグメントを接続するために使用されるコネクタ。

...

snippet

string

セグメントの数。有効値:1~5。

5

queryProcessors

array<object>

クエリ意図解釈設定。

array<object>

クエリ意図解釈設定。

name

string

ルール名。

test

domain

string

業種。有効値:

  • GENERAL

  • ECOMMERCE

  • IT_CONTENT

GENERAL

category

string

業界カテゴリ。

""

processors

array<object>

機能。

object

機能。

{ "name": "stop_word", "useSystemDictionary": true, "interventionDictionary": "my_dict", "ignoreSpace": true }

indexes

array

インデックスの範囲。

string

インデックス。

default

active

boolean

ルールがデフォルトであるかどうかを示します。

False

cluster

object

機能開放設定。

maxTimeoutMS

integer

タイムアウト期間。単位:ミリ秒。

750

maxQueryClauseLength

integer

クエリ句の最大長。

1024

interpretations

object

業界モデルモジュール。

[ { "table": "table1", "fields": [ { "name": "field1", "interpretation": "标题" }, { "name": "field2", "interpretation": "编号" } ] } ]

prompts

array<object>

プロンプト設定。

object

プロンプト設定。

{ "parameters" : [ { "name" : "docs", "value" : "doc内容的拼接方式,比如现在的 qwen的 '

\n${doc}\n
\n" } ], "messages":[ { "role" : "role_name,这里是否需要限定只能是 system, user, assistant,还是可以让用户随意填写", "content" : "用户设置的prompt内容,里面可以使用 ${parameter_key} 来表示期望动态替换的内容,具体替换规则参考下面说明" } ] }

成功レスポンス

JSONJSON

{
  "requestId": "33477D76-C380-1D84-A4AD-043F52876CB1",
  "result": {
    "id": "100303063",
    "isCurrent": true,
    "clusterName": "-",
    "autoSwitch": true,
    "type": "enhanced",
    "description": "-",
    "status": "ok",
    "schema": {
      "tables": {
        "primaryTable": true,
        "name": "main",
        "fields": {
          "id": {
            "name": "id",
            "type": "LITERAL",
            "primaryKey": true
          },
          "title": {
            "name": "title",
            "type": "TEXT",
            "primaryKey": false
          },
          "buy": {
            "name": "buy",
            "type": "INT",
            "primaryKey": false
          },
          "cate_id": {
            "name": "cate_id",
            "type": "INT",
            "primaryKey": false
          },
          "cate_name": {
            "name": "cate_name",
            "type": "LITERAL",
            "primaryKey": false
          }
        }
      },
      "indexes": {
        "filterFields": [
          "id"
        ],
        "searchFields": {
          "fields": [
            "title"
          ],
          "analyzer": "chn_standard"
        }
      },
      "routeField": "field1",
      "routeFieldValues": [
        "routeFieldValues"
      ],
      "secondRouteField": "field2\n",
      "ttlField": {
        "name": "text1\n",
        "ttl": 1000
      },
      "indexSortConfig": [
        {
          "field": "field1",
          "direction": "DESC"
        }
      ],
      "name": "test"
    },
    "progressPercent": 100,
    "fetchFields": [
      "{}"
    ],
    "quota": {
      "spec": "opensearch.share.common",
      "qps": 5,
      "docSize": 1,
      "computeResource": 20
    },
    "domain": {
      "category": "-",
      "name": "test",
      "functions": {
        "service": [
          "-"
        ],
        "qp": [
          "-"
        ],
        "algo": [
          "-"
        ]
      }
    },
    "schemas": [
      {
        "tables": {
          "primaryTable": true,
          "name": "main",
          "fields": {
            "id": {
              "name": "id",
              "type": "LITERAL",
              "primaryKey": true
            },
            "title": {
              "name": "title",
              "type": "TEXT",
              "primaryKey": false
            },
            "buy": {
              "name": "buy",
              "type": "INT",
              "primaryKey": false
            },
            "cate_id": {
              "name": "cate_id",
              "type": "INT",
              "primaryKey": false
            },
            "cate_name": {
              "name": "cate_name",
              "type": "LITERAL",
              "primaryKey": false
            }
          }
        },
        "indexes": {
          "filterFields": [
            "field1"
          ],
          "searchFields": {
            "fields": [
              "title"
            ],
            "analyzer": "chn_standard"
          }
        },
        "routeField": "field1\n",
        "routeFieldValues": [
          "routeFieldValues"
        ],
        "secondRouteField": "field2",
        "ttlField": {
          "name": "fIeld1",
          "ttl": 1000
        },
        "indexSortConfig": [
          {
            "field": "fIeld1",
            "direction": "DESC"
          }
        ],
        "name": "main"
      }
    ],
    "firstRanks": [
      {
        "type": "STRING",
        "name": "test",
        "description": "描述",
        "active": true,
        "meta": "String :\"random()*100+now()\";\nArray: [\n    {\n      \"attribute\": \"static_bm25()\",\n      \"arg\": \"\",\n      \"weight\": 10\n    }\n  ]"
      }
    ],
    "secondRanks": [
      {
        "meta": "\"cate_id > 0 and cate_id < 1000\"\n",
        "name": "default\n",
        "description": "描述",
        "active": true
      }
    ],
    "dataSources": [
      {
        "tableName": "main",
        "type": "rds",
        "fields": [
          {
            "id": "id"
          }
        ],
        "plugins": {
          "name": "JsonKeyValueExtractor",
          "parameters": {
            "key": "my_field"
          }
        },
        "keyField": "id",
        "schemaName": "name",
        "parameters": {
          "instanceId": "rds-instance-id",
          "dbName": "my_db",
          "dbTableName": "my_table",
          "dbUser": "my",
          "dbPassword": "my_passwd",
          "filter": "",
          "autoSync": true
        }
      }
    ],
    "summaries": [
      {
        "name": "default",
        "meta": [
          {
            "field": "field1",
            "len": 50,
            "element": "em",
            "ellipsis": "...",
            "snippet": "5"
          }
        ]
      }
    ],
    "queryProcessors": [
      {
        "name": "test",
        "domain": "GENERAL",
        "category": "\"\"",
        "processors": [
          {
            "name": "stop_word",
            "useSystemDictionary": true,
            "interventionDictionary": "my_dict",
            "ignoreSpace": true
          }
        ],
        "indexes": [
          "default"
        ],
        "active": true
      }
    ],
    "cluster": {
      "maxTimeoutMS": 750,
      "maxQueryClauseLength": 1024
    },
    "interpretations": [
      {
        "table": "table1",
        "fields": [
          {
            "name": "field1",
            "interpretation": "标题"
          },
          {
            "name": "field2",
            "interpretation": "编号"
          }
        ]
      }
    ],
    "prompts": [
      {
        "parameters": [
          {
            "name": "docs",
            "value": "doc内容的拼接方式,比如现在的 qwen的 '\n${doc}\n\n"
          }
        ],
        "messages": [
          {
            "role": "role_name,这里是否需要限定只能是 system, user, assistant,还是可以让用户随意填写",
            "content": "用户设置的prompt内容,里面可以使用 ${parameter_key} 来表示期望动态替换的内容,具体替换规则参考下面说明"
          }
        ]
      }
    ]
  }
}

エラーコード

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

変更履歴

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