URL
/vector-service/fetch
この URL には、リクエストヘッダーまたはエンコードの詳細は含まれません。
この URL には、アプリケーションのホストアドレスは含まれません。
上記の URL のクエリパラメーターの詳細については、後述の「クエリパラメーター」セクションをご参照ください。
リクエストプロトコル
HTTP
リクエストメソッド
POST
対応フォーマット
JSON
リクエスト署名
次の方法でリクエスト署名を計算できます。 リクエスト署名は Authorization ヘッダーに格納されます。
パラメーター | タイプ | 説明 |
accessUserName | 文字列 | [インスタンスの詳細] ページ > [ネットワーク情報] でユーザー名を確認できます。 |
accessPassWord | 文字列 | [インスタンスの詳細] ページの [ネットワーク情報] セクションでパスワードを変更できます。 |
import com.aliyun.darabonba.encode.Encoder;
import com.aliyun.darabonbastring.Client;
public class GenerateAuthorization {
public static void main(String[] args) throws Exception {
String accessUserName = "username";
String accessPassWord = "password";
String realmStr = "" + accessUserName + ":" + accessPassWord + "";
String authorization = Encoder.base64EncodeToString(Client.toBytes(realmStr, "UTF-8"));
System.out.println(authorization);
}
}Authorization ヘッダーの値の有効なフォーマット:
cm9vdDp******mdhbA==HTTP リクエストで Authorization ヘッダーを設定する場合は、Basic プレフィックスを追加します。
例:ヘッダーの追加
Authorization: Basic cm9vdDp******mdhbA==リクエストボディの構文
パラメーター | 説明 | タイプ | 必須 |
tableName | テーブル名。 | 文字列 | はい |
ids | ID のリスト。 | list[文字列] | はい |
指定したプライマリキーでデータをクエリする例:
{
"tableName": "gist",
"ids": [
"1",
"2",
"3"
]
}レスポンスパラメーター
フィールド名 | 説明 | タイプ |
result | 返される結果。 | list[Doc] |
totalCount | 結果数。 | int |
totalTime | レスポンスタイム。単位:ミリ秒。 | float |
errorCode | リクエストが失敗した場合に返されるエラーコード。 | int |
errorMsg | リクエストが失敗した場合に返されるエラーメッセージ。 | 文字列 |
Doc の定義
フィールド名 | 説明 | タイプ |
id | プライマリキーのフィールド。 | データ型は、テーブルの作成時に指定します。 |
vector | ベクターフィールド。 | list[float] |
fields | ベクターの属性フィールド。 | map<string, FieldType> |
例:
{
"result": [
{
"id": "1",
"vector": [
0.1,
0.2,
0.3
],
"fields": {
"a": 11
}
}
],
"totalCount": 1,
"totalTime": 1.2
}