インスタンス ID とモデル名で特定のモデルの詳細な構成を照会します。
操作説明
リクエストの説明
この API は、インスタンス内の特定のモデルのモデルタイプ、URL、ステータスなどの詳細を取得します。
指定された
instanceIdとmodelNameが有効であることを確認してください。そうでない場合、エラーが返されるか、リソースが見つかりません。応答には、リクエストヘッダーやパラメーターなどのモデルコンテンツが含まれます。作成時刻と更新時刻も含まれます。この情報は、モデルの構成とその現在のステータスを理解するのに役立ちます。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
searchengine:GetModel |
get |
*Instance
|
なし | なし |
リクエスト構文
GET /openapi/ha3/instances/{instanceId}/models/{modelName} HTTP/1.1リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| instanceId |
string |
必須 |
インスタンス ID。 |
ha-cn-pl32rf0**** |
| modelName |
string |
必須 |
モデル名。 |
test |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
応答のスキーマ |
||
| requestId |
string |
リクエスト ID。 |
38b079f1-7846-4226-8c90-3e2644b5c52b |
| result |
object |
モデルの構成。 |
|
| name |
string |
モデル名。 |
test |
| type |
string |
モデルタイプ。
列挙値：
|
text_embedding |
| url |
string |
モデルのアクセス URL。 |
http://***.platform-cn-shanghai.opensearch.aliyuncs.com/v3/openapi/workspaces/default/text-embedding/ops-text-embedding-001 |
| status |
string |
モデルのステータス。
|
ok |
| dimension |
integer |
モデルのディメンション。 |
128 |
| content |
object |
モデルの構成。 |
|
| modelName |
string |
モデル名。 |
test |
| modelType |
string |
モデルタイプ。
|
text_embedding |
| url |
string |
モデルサービスのエンドポイント。 |
http://***.platform-cn-shanghai.opensearch.aliyuncs.com/v3/openapi/workspaces/default/text-embedding/ops-text-embedding-001 |
| method |
string |
モデルサービスにアクセスするための HTTP メソッド。PUT と POST がサポートされています。 |
POST |
| request |
object |
リクエストの構成。 |
|
| header |
object |
HTTP リクエストヘッダー。 |
|
| Authorization |
string |
認証情報。フォーマットは Bearer access_token です。 |
Bearer OS-v0********6vvs |
| Content-Type |
string |
HTTP リクエストのコンテンツタイプ。 |
application/json |
| urlParams |
object |
URL パラメーター。一部のモデルサービスでは、URL でパラメーターを渡す必要があります。 |
|
| build |
object |
インデックス構築時に渡されるパラメーター。 |
key: value |
| search |
object |
クエリ時に渡されるパラメーター。 |
key: value |
| requestBody |
string |
リクエスト本文のテンプレート文字列。 |
{\"input\": [\"%{input}\"], \"input_type\": \"%{input_type}\"} |
| parameters |
object |
ビルドフェーズと検索フェーズでパラメーターが異なる場合は、ここで定義します。 |
|
| build |
object |
インデックス構築フェーズのパラメーター。 |
|
| input_type |
string |
入力タイプ。 |
query |
| search |
object |
クエリフェーズのパラメーター。 |
|
| input_type |
string |
入力タイプ。 |
document |
| response |
object |
結果を解析するメソッド。これは JSONPath フォーマットで記述されます。 |
|
| embeddings |
string |
結果を解析するメソッド。これは JSONPath フォーマットで記述されます。 |
$.result.embeddings[*].embedding |
| createTime |
string |
作成時刻。 |
2024-05-21 16:05:26 |
| updateTime |
string |
更新時刻。 |
2024-05-21 16:05:26 |
例
成功レスポンス
JSONJSON
{
"requestId": "38b079f1-7846-4226-8c90-3e2644b5c52b",
"result": {
"name": "test",
"type": "text_embedding",
"url": "http://***.platform-cn-shanghai.opensearch.aliyuncs.com/v3/openapi/workspaces/default/text-embedding/ops-text-embedding-001",
"status": "ok",
"dimension": 128,
"content": {
"modelName": "test",
"modelType": "text_embedding",
"url": "http://***.platform-cn-shanghai.opensearch.aliyuncs.com/v3/openapi/workspaces/default/text-embedding/ops-text-embedding-001",
"method": "POST",
"request": {
"header": {
"Authorization": "Bearer OS-v0********6vvs\n",
"Content-Type": "application/json\n"
},
"urlParams": {
"build": {
"test": "test",
"test2": 1
},
"search": {
"test": "test",
"test2": 1
}
},
"requestBody": "{\\\"input\\\": [\\\"%{input}\\\"], \\\"input_type\\\": \\\"%{input_type}\\\"}\n",
"parameters": {
"build": {
"input_type": "query\n"
},
"search": {
"input_type": "document\n"
}
}
},
"response": {
"embeddings": "$.result.embeddings[*].embedding\n"
}
},
"createTime": "2024-05-21 16:05:26",
"updateTime": "2024-05-21 16:05:26"
}
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。