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

Global Cluster を作成します (V2)

この操作は global cluster を作成します。global cluster は、異なるリージョンにデプロイされた複数の member cluster で構成されます。global cluster 内の member cluster は同じ CU type と CU size を共有します。global cluster を作成することで、災害復旧とリージョンをまたいだ低レイテンシアクセスを実現できます。

POST/v2/globalClusters/create
接続エンドポイント

https://api.cloud.zilliz.com

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

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

値の例： Bearer {{TOKEN}}
リクエスト・ボディapplication/json
globalClusterNamestring必要

global cluster の名前。

値の例： my-global-cluster
projectIdstring必要

global cluster が属する project の ID。

値の例： proj-xxxxxxxxxxxxxxx
cuTypestring必要

global cluster の Compute unit (CU) type。global cluster のメンバーは同じ CU type を共有します。

値の例： Performance-optimized
cuSizeinteger必要

global cluster の Compute unit (CU) size。global cluster のメンバーは同じ CU size を共有します。
global cluster 内のメンバーでは、この値は 1 ～ 1,024 を指定でき、使用可能な値は 1, 2, 4, 8, 12, 16, 20, 24, 28, 32,...,64, 72, 80, 88,...,256, 272, 288, ...,1024 です。
CU size の増分ルールの詳細については、Detailed Plan Comparison の Deployment セクションを参照してください。

値の例： 4
primaryClusterobject必要

global cluster の primary cluster のパラメーター。

clusterNamestring必要

primary cluster の名前。

値の例： my-primary-cluster
regionIdstring必要

primary cluster がデプロイされるリージョン ID。リージョンは、指定された project で利用可能なリージョンのいずれかである必要があります。

secondaryClustersarray必要

global cluster の secondary cluster のパラメーター。1 つ以上の secondary cluster を指定できます。

[]secondaryClustersobject必要
clusterNamestring必要

secondary cluster の名前。

値の例： my-secondary-cluster-1
regionIdstring必要

secondary cluster がデプロイされるリージョン ID。リージョンは、指定された project で利用可能なリージョンのいずれかである必要があり、かつ primary cluster がデプロイされるリージョンとは異なる必要があります。

レスポンス200 OK - application/json

作成された global cluster の情報を返します。

globalClusterIdstring

作成された global cluster の ID。

値の例： glo-xxxxxxxxxxxxxxx
usernamestring

global cluster へのアクセスに使用するユーザー名。

値の例： admin
passwordstring

global cluster へのアクセスに使用するパスワード。

値の例： Passw0rd!
jobIdstring

global cluster 作成ジョブの ID。この ID を使用して作成ジョブの進行状況を照会できます。

値の例： job-xxxxxxxxxxxxxxx

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

codeinteger

レスポンスコード。

messagestring

エラーメッセージ。

Successjson
{
    "globalClusterId": "glo-xxxxxxxxxxxxxxx",
    "username": "db_admin",
    "password": "Passw0rd!",
    "jobId": "job-xxxxxxxxxxxxxxx"
}
Ctrl I