Has コレクション (V2)
この操作は、コレクションが存在するかどうかを確認します。
POST/v2/vectordb/collections/has
https://{cluster-id}.{region}.vectordb.zillizcloud.com:19530
📘ノート
- サービングクラスターを使用している場合は、クラスターエンドポイントを使用してください。
Free & Serverless
https://{cluster-id}.serverless.{region}.vectordb.zillizcloud.comDedicated
https://{cluster-id}.{region}.vectordb.zillizcloud.com:19530
${CLUSTER_ENDPOINT}を、あなたのZilliz Cloudクラスターのエンドポイントに置き換える必要があります。- エンドポイントを取得するには、Describe Cluster V2 APIを使用してレスポンスから値を抽出してください。
shell
export CLUSTER_ENDPOINT="https://{cluster-id}.{region}.vectordb.zillizcloud.com:19530"
パラメータ
Authorizationstringheader必要
認証トークンは、適切な権限を持つAPIキー、またはユーザー名とパスワードをコロンで連結したペア(例:username:password)である必要があります。プロジェクトエンドポイントを使用している場合は、十分な権限を持つ有効なAPIキーのみが適用されます。
値の例: Bearer {{TOKEN}}
リクエスト・ボディapplication/json
dbNamestring
コレクションが属するデータベースの名前です。存在しないデータベースを指定するとエラーになります。指定しない場合は、デフォルトのデータベースが使用されます。
collectionNamestring必要
対象コレクションの名前です。 存在しないコレクションを指定するとエラーになります。
bash
export TOKEN="db_admin:xxxxxxxxxxxxx"
curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/collections/has" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json" \
-d '{
"collectionName": "quick_setup"
}'
レスポンス200 OK - application/json
指定したコレクションが存在するかどうかを示すブール値です。
codeinteger
レスポンスコードです。
値の例: 0
dataobject
ブール値を含むレスポンスペイロードです。
hasboolean
指定したコレクションが存在するかどうかを示すブール値です。
エラーメッセージを返します。
codeinteger
レスポンスコードです。
messagestring
エラーメッセージです。
Successjson
{
"code": 0,
"data": {
"has": true
}
}