创建全球集群 (V2)
本接口创建一个全球集群。全球集群由部署在不同区域的多个成员集群组成。全球集群中的成员集群共享相同的计算单元类型和计算单元大小。您可以创建全球集群以提供跨区域的灾难恢复和低延迟访问。
该 API 的 Base URL 格式如下:
https://api.cloud.zilliz.com
控制面接口速率限制为单用户单接口每秒最多 20 个请求。
export BASE_URL="https://api.cloud.zilliz.com"
认证令牌,应为具备适当权限的 API 密钥。
全球集群名称。
全球集群所属项目 ID。
全球集群的计算单元类型(CU)。
全球集群的计算单元大小(CU)。
对于全球集群中的成员集群,该值取值范围为 1 到 1024,可能的值为1、2、4、8、12、16、20、24、28、32、...、64、72、80、88、...、256、272、288、...、1024。
关于 CU 大小的增量规则,请参阅 详细计划对比 中的 Deployment 部分。
全球集群的主集群参数。
主集群名称。
主集群部署的区域 ID。该区域必须是指定项目中适用的区域之一。
集群的副本数量。
全球集群的从集群参数。您可以指定一个或多个从集群。
要添加到 Global Cluster 的从 Cluster,由 clusterName 和 regionId 标识,两者均为必填项。可以指定一个或多个从 Cluster。
从集群名称。
从集群部署的区域 ID。该区域必须是指定项目中适用的区域之一,并且必须与主集群部署的区域不同。
集群的副本数量。
集群的自动扩缩容配置。
CU 自动扩缩容的范围与定时计划。
CU 的最小数量。
CU 的最大数量。
CU 的定时扩缩容目标列表。
定时扩缩容规则。
定义定时计划生效时间的 Cron 表达式。
定时计划触发时应用的目标值。
Cron 定时计划使用的时区。
副本自动扩缩容的范围与定时计划。
副本的最小数量。
副本的最大数量。
副本的定时扩缩容目标列表。
定时扩缩容规则。
定义定时计划生效时间的 Cron 表达式。
定时计划触发时应用的目标值。
Cron 定时计划使用的时区。
export TOKEN="YOUR_API_KEY"
curl --request POST \
--url "${BASE_URL}/v2/globalClusters/create" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json" \
-d '{
"globalClusterName": "my-global-cluster",
"projectId": "proj-xxxxxxxxxxxxxxx",
"cuType": "Performance-optimized",
"cuSize": 4,
"primaryCluster": {
"clusterName": "my-primary-cluster",
"regionId": "ali-cn-hangzhou"
},
"secondaryClusters": [
{
"clusterName": "my-secondary-cluster-1",
"regionId": "ali-cn-beijing"
},
{
"clusterName": "my-secondary-cluster-2",
"regionId": "ali-cn-shanghai"
}
]
}'
返回创建的全球集群的信息。
Global Cluster 创建请求成功时返回的响应载荷之一。
创建的全球集群 ID。
访问全球集群的用户名。
访问全球集群的密码。
创建全球集群的任务 ID。您可以使用此 ID 查询创建任务的进度。
响应负载,类型随端点而变化。
已创建的全球集群的 ID。
全球集群初始数据库账号的用户名。
全球集群初始数据库账号的密码。
跟踪创建过程的异步任务的 ID。
返回错误消息。
响应码。
错误描述。
{
"globalClusterId": "glo-xxxxxxxxxxxxxxx",
"username": "db_admin",
"password": "Passw0rd!",
"jobId": "job-xxxxxxxxxxxxxxx"
}