[説明] このページは機械翻訳された日本語版です。内容に誤りがございましたら、報告していただけると助かります。

Update Volume (V2)

Update the description of a volume.

PATCH/v2/volumes/{VOLUME_NAME}

Connection Endpoint

The 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}}

OrgIdstringheaderrequired

The organization ID of the volume.

Example Value: org-xxxxxxxxxxxxxxxxxxx

VOLUME_NAMEstringpathrequired

The name of the volume to update.

Example Value: my_volume

Request Bodyapplication/json

descriptionstringrequired

The new description of the volume. The value can be an empty string.

export TOKEN="YOUR_API_KEY"
export VOLUME_NAME="my_volume"

curl --request PATCH \
--url "${BASE_URL}/v2/volumes/${VOLUME_NAME}" \
--header "Authorization: Bearer ${TOKEN}" \
--header "OrgId: org-xxxxxxxxxxxxxxxxxxx" \
--header "Content-Type: application/json" \
-d '{
    "description": "This is the new description of the volume."
}'

Responses200 - application/json

SUCCESS

codeinteger

Response code.

dataobject

Response payload which contains volume details.

volumeNamestring

The name of the volume.

typestring

The category of the volume.

regionIdstring

The ID of the region where the volume is located.

storageIntegrationIdstring

The storage integration ID. Only returned for external volumes.

pathstring

The path prefix within the volume. Only returned for external volumes.

statusstring

The current status of the volume.

createTimestring

The creation time of the volume in ISO 8601 format.

FAILURE

A failure response.

codeinteger

Response code.

messagestring

Error message.

MANAGED

{
    "code": 0,
    "data": {
        "volumeName": "my_volume",
        "type": "MANAGED",
        "regionId": "aws-us-west-2",
        "status": "RUNNING",
        "createTime": "2026-05-06T03:50:35Z"
    }
}

EXTERNAL

{
    "code": 0,
    "data": {
        "volumeName": "my_external_volume",
        "type": "EXTERNAL",
        "regionId": "aws-us-west-2",
        "storageIntegrationId": "integ-xxxxxxxxxxxxxxxxxxx",
        "path": "data/",
        "status": "RUNNING",
        "createTime": "2026-05-06T03:50:35Z"
    }
}