Skip to main content

Describe Index

This operation describes the current index.

POST
/v2/vectordb/indexes/describe
Cluster Endpoint

The base URL for this API is in the following format:

https://${CLUSTER_ENDPOINT}

📘Notes
  • You need to fill in ${CLUSTER_ENDPOINT} with that of your Zilliz Cloud cluster.
  • To get the endpoint, refer to Zilliz Cloud Console or use the Describe Cluster V2 API to extract the values from the responses.
export CLUSTER_ENDPOINT=""
Parameters
Authorizationstringheaderrequired

The authentication token should be an API key with appropriate privileges or a pair of colon-joined username and password, like username:password.

Example Value: Bearer {{TOKEN}}
Request Bodyapplication/json
dbNamestring

The name of the database to which the collection belongs.

collectionNamestringrequired

The name of the collection to which the index belongs.

indexNamestringrequired

The name of the index to describe.

export TOKEN="db_admin:xxxxxxxxxxxxx"

curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/indexes/describe" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
-d '{
    "indexName": "vector",
    "collectionName": "quick_setup"
}'
Responses200 - application/json

A success response.

codeinteger

Response code.

Example Value: 0
dataobject

Response payload which is detailed information about the index.

fieldNamestring

The name of the target field.

indexNamestring

The name of the index.

indexStatestring

The status of the indexing progress.

indexTypestring

The type of this index.

indexedRowsinteger

The total number of entities/rows that have been indexed.

metricTypestring

The type of the similarity metric.

pendingRowsinteger

The number of entities/rows that are waiting to be indexed.

totalRowsinteger

The total number of entities/rows.

failReasonstring

The reason for the failure to build indexes.

A failure response.

codeinteger

Response code.

messagestring

Error message.

{
    "code": 0,
    "data": [
        {
            "failReason": "",
            "fieldName": "vector",
            "indexName": "vector",
            "indexState": "Finished",
            "indexType": "",
            "indexedRows": 0,
            "metricType": "COSINE",
            "pendingRows": 0,
            "totalRows": 0
        }
    ]
}