创建 Volume (V2)

This operation creates a new volume in the specified project.

POST

/v2/volumes/create

集群 Endpoint

该 API 的 Base URL 格式如下：

https://${CLUSTER_ENDPOINT}

📘说明

• 你需要填入您的 Zilliz Cloud 集群的 ${CLUSTER_ENDPOINT}。
• 您可以使用 查看集群详情 V2 来获取集群的 Endpoint.

export CLUSTER_ENDPOINT=""

参数

Authorizationstringheaderrequired

认证令牌，应为具备适当权限的 API 密钥或用冒号分隔的用户名和密码，如 username:password。

示例值：Bearer {{TOKEN}}

请求体application/json

projectIdstring必填项

所属项目的 ID。

示例值：proj-xxxxxxxxxxxxxxxxxxxxxxx

regionIdstring必填项

Volume 所属区域的 ID。您可以使用 查看云服务区域 接口列出可用区域。

volumeNamestring必填项

Volume 名称。

export TOKEN="db_admin:xxxxxxxxxxxxx"

curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/volumes/create" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
-d '{
    "projectId": "proj-xxxxxxxxxxxxxxxxxxxxxxx",
    "regionId": "ali-cn-hangzhou",
    "volumeName": "my_volume"
}'

响应200 - application/json

SUCCESS

返回 Volume 列表。

codeinteger

响应码。

dataobject

volumeNamestring

已创建的 Volume 名称。

FAILURE

返回错误消息。

codeinteger

响应码。

messagestring

错误描述。

SUCCESS

{
    "code": 0,
    "data": {
        "volumeName": "my_volume"
    }
}