メインコンテンツまでスキップ

Dedicated Cluster の作成 (V2)

Dedicated Cluster を作成します。

POST/v2/clusters/createDedicated
接続エンドポイント

https://api.cloud.zilliz.com

shell
export BASE_URL="https://api.cloud.zilliz.com"
パラメータ
Authorizationstringheader必要

認証トークンには、適切な権限を持つ API key を使用する必要があります。

値の例： Bearer {{TOKEN}}
Acceptstringheader

application/json を使用します。

値の例： application/json
リクエスト・ボディapplication/json
clusterNamestring必要

作成するクラスターの名前。

descriptionstring

クラスターの説明。

値の例： Production vector search cluster
projectIdstring必要

クラスターが属するプロジェクトの ID。

planstring

クラスターが属するプロジェクトのサブスクリプションプラン。指定可能な値は Standard および Enterprise です。

cuTypestring必要

クラスターの CU タイプ。
これは Dedicated Cluster にのみ適用されます。free および serverless クラスターでは、この値は空です。
指定可能な値については、以下のドロップダウンを参照するか、Zilliz Cloud console でクラスターを作成する際に確認できます。

cuSizeinteger必要

クラスターの CU サイズ。
free および serverless クラスターでは、この値は常に 0 です。
Standard プランの Dedicated Cluster では、この値は 1 から 32 までで、指定可能な値は 1, 2, 4, 8, 12, 16, 20, 24, 28, 32 です。
Enterprise プランの Dedicated Cluster では、この値は 1 から 1,024 までで、指定可能な値は 1, 2, 4, 8, 12, 16, 20, 24, 28, 32,...,64, 72, 80, 88,...,256, 272, 288, ...,1024 です。
CU サイズの増分ルールの詳細については、Detailed Plan Comparison の Deployment セクションを参照してください。

値の範囲： ≥ 1≤ 1024
labelsobject

BYOC クラスターを識別するためのキーと値のラベル。

bucketInfoobject

BYOC クラスター用のカスタムバケット設定。

bucketNamestring

カスタムストレージバケットの名前。

prefixstring

バケット内のプレフィックスパス。

keyIdentifierstring

BYOC クラスターでの暗号化に使用するキー識別子。

レスポンス200 OK - application/json

作成されたクラスターの詳細情報を返します。

codeinteger

レスポンスコード。

dataobject

レスポンスペイロード。

clusterIdstring

作成されたクラスターの ID。

usernamestring

db_admin という名前のクラスター管理ユーザー名。

passwordstring

クラスター管理ユーザーのパスワード。この値はクラスター作成時に一度だけ表示されます。安全に記録しておくことを推奨します。

promptstring

返されたプロンプトメッセージ。

エラーメッセージを返します。

codeinteger

レスポンスコード。

messagestring

エラーメッセージ。

Successjson
{
    "code": 0,
    "data": {
        "clusterId": "inxx-xxxxxxxxxxxxxxx",
        "username": "db_admin",
        "password": "****************",
        "prompt": "successfully submitted, cluster is being created. You can access data about the creation progress and status of your cluster by DescribeCluster API. Once the cluster status is RUNNING, you may access your vector database using the SDK with the admin account and the initial password you specified."
    }
}
Ctrl I