The DeleteVectorIndex operation deletes a vector index.
Notes
Deleting an index also deletes all vector data in the index.
This operation is irreversible. Proceed with caution and ensure that you have backed up important data.
Permissions
An Alibaba Cloud account has all permissions by default. Resource Access Management (RAM) users and RAM roles do not have any permissions by default. The Alibaba Cloud account or an administrator must grant permissions for the operation using a RAM policy or a bucket policy.
API | Action | Description |
DeleteVectorIndex |
| Deletes 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 | Data 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: AliyunOSSError codes
Error code | HTTP status code | Description |
VectorIndexParameterInvalid | 400 | The vector index parameter provided in the request is invalid. |
MalformedJson | 400 | The JSON format of the request body is invalid. |
AccessDenied | 403 | Possible causes of the error:
|
NoSuchVectorIndex | 404 | The specified vector index does not exist. |
VectorIndexOperationConflict | 409 | The index cannot be deleted if its status is not `enable`. This causes a conflict. |