You can call DeleteVectorIndex to delete a vector index.
Important notes
Deleting an index also deletes all vector data within that index.
This operation is irreversible. Back up important data before proceeding.
Permissions
An Alibaba Cloud account has full permissions by default. RAM users and RAM roles under an Alibaba Cloud account have no permissions by default. An Alibaba Cloud account or account administrator must grant permissions using a RAM policy or a bucket policy.
API | Action | Description |
DeleteVectorIndex |
| Delete a vector index. |
Request syntax
POST /?deleteVectorIndex HTTP/1.1
Host: examplebucket-123***456.cn-hangzhou.oss-vectors.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
Content-type: application/json
{
"indexName": "string"
}Request headers
This operation uses only common request headers. For more information, see Common HTTP headers.
Request parameters
Name | Type | Required | Example | Description |
indexName | String | Yes | vectorindex1 | The name of the index to delete. |
Response headers
This operation uses only common response headers. For more information, see Common HTTP headers.
Examples
Sample request
POST /?deleteVectorIndex HTTP/1.1
Host: examplebucket-123***456.cn-hangzhou.oss-vectors.aliyuncs.com
Date: Thu, 17 Apr 2025 01:33:47 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218
Content-type: application/json
{
"indexName": "vectorindex1"
}Sample response
HTTP/1.1 204 No Content
x-oss-request-id: 534B371674E88A4D8906****
Date: Thu, 17 Apr 2025 01:33:47 GMT
Connection: keep-alive
Server: AliyunOSSSDK
The following SDKs support DeleteVectorIndex:
Command-line tool ossutil
For the ossutil command that corresponds to DeleteVectorIndex, see delete-vector-index.
Error codes
Error code | HTTP status code | Description |
VectorIndexParameterInvalid | 400 | The vector index parameter in the request is invalid. |
MalformedJson | 400 | The JSON format in the request body is invalid. |
AccessDenied | 403 | Possible causes:
|
NoSuchVectorIndex | 404 | The specified vector index does not exist. |
VectorIndexOperationConflict | 409 | This operation fails if the index state is not enabled. |