OpenSearch アプリケーションの特定バージョンの情報を照会します。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
opensearch:DescribeApp |
get |
*App
|
なし | なし |
リクエスト構文
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 |
エディションタイプ。有効値:
|
enhanced |
| description |
string |
バージョンの説明。 |
- |
| status |
string |
バージョンのステータス。有効値:
|
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 |
ソート方法。有効値:
|
DESC |
| name |
string |
ワイドテーブルの名前。 |
test |
| progressPercent |
integer |
データインポートの進捗状況 (パーセンテージ)。たとえば、値が 83 の場合は 83% を示します。 |
100 |
| fetchFields |
array |
デフォルト表示フィールド。 |
[] |
|
string |
デフォルト表示フィールド。 |
{} |
|
| quota |
object |
クォータ情報。 |
{} |
| spec |
string |
仕様。有効値:
|
opensearch.share.common |
| qps |
integer |
1 秒あたりの検索リクエスト数。以前の課金モデルでは、1 秒あたりの検索リクエスト数に基づいて課金されます。 |
5 |
| docSize |
integer |
ストレージ容量。単位:GB。 |
1 |
| computeResource |
integer |
コンピューティングリソース。単位:論理コンピューティングユニット (LCU)。 |
20 |
| domain |
object |
業種。有効値:
|
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 |
ソート方法。有効値:
|
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 |
| fields |
array<object> |
フィールドマッピングに関する情報。 |
|
|
object |
フィールドマッピングに関する情報。 |
{ "id": "id" } |
|
| plugins |
object |
データ処理に使用されるプラグイン。 name:
parameters:
|
{ "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 |
| 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的 ' |
例
成功レスポンス
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} 来表示期望动态替换的内容,具体替换规则参考下面说明"
}
]
}
]
}
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。