创建 Collection

Creates a collection in a cluster.

POST

/v1/vector/collections/create

集群 Endpoint

该 API 的 Base URL 格式如下：

https://${CLUSTER_ENDPOINT}

📘说明

• 你需要填入您的 Zilliz Cloud 集群的 ${CLUSTER_ENDPOINT}。
• 您可以参考 On Zilliz Cloud 控制台或使用 查看集群详情来获取集群的 Endpoint.

export CLUSTER_ENDPOINT=""

参数

Authorizationstringheaderrequired

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

示例值：Bearer {{TOKEN}}

请求体application/json

collectionNamestring必填项

Collection 名称。

dimensioninteger必填项

Vector 字段的维度数。

取值范围：≥ 1≤ 32768

metricTypestring

用于 Collection 的距离度量方式。

枚举值：

L2IPCOSINE

primaryFieldstring

主键字段名称。

vectorFieldstring

向量字段名称。

descriptionstring

Collection 描述。

export TOKEN="db_admin:xxxxxxxxxxxxx"

curl --request POST \
--url "${CLUSTER_ENDPOINT}/v1/vector/collections/create" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
-d '{
    "collectionName": "medium_articles",
    "dimension": 256,
    "metricType": "COSINE",
    "primaryField": "id",
    "vectorField": "vector"
}'

响应200 - application/json

SUCCESS

codeinteger

响应码。

dataobject

响应负载，为空对象。

FAILURE

Returns an error message.

codeinteger

响应码。

messagestring

错误描述。

SUCCESS

{
    "code": 200,
    "data": {}
}