Modify Cluster Replica
This operation sets the number of replicas for the specified cluster.
POST
/v2/clusters/{CLUSTER_ID}/modifyReplicaThe base URL for this API is in the following format:
https://api.cloud.zilliz.com
📘Notes
The endpoints on the control plane currently supports up to 20 requests per second per user per endpoint.
export BASE_URL="https://api.cloud.zilliz.com"
Parameters
Authorizationstringheaderrequired
The authentication token should be an API key with appropriate privileges.
Example Value: Bearer {{TOKEN}}
Acceptstringheader
Use application/json
.
Example Value: application/json
CLUSTER_IDstringpathrequired
ID of the cluster to modify.
Example Value: inxx-xxxxxxxxxxxxxxx
Request Bodyapplication/json
replicaintegerrequired
Number of replicas for this cluster after the modification.
Value Range: ≥ 1≤ 8
export TOKEN="YOUR_API_KEY"
export CLUSTER_ID="inxx-xxxxxxxxxxxxxxx"
curl --request POST \
--url "${BASE_URL}/v2/clusters/${CLUSTER_ID}/modifyReplica" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
-d '{
"replica": 2
}'
Responses200 - application/json
codeinteger
Response code.
dataobject
Response payload.
clusterIdstring
ID of the cluster that has been modified.
promptstring
Prompt message returned.
Returns an error message.
codeinteger
Response code.
messagestring
Error message.
{
"code": 0,
"data": {
"clusterId": "inxx-xxxxxxxxxxxxxxx",
"prompt": "successfully submitted. Cluster is being upgraded, which is expected to take several minutes. 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."
}
}