All Products
Search
Document Center

Object Storage Service:DeleteVectorIndex

Last Updated:Sep 25, 2025

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

oss: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: AliyunOSS

Error 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:

  • User authentication information is not included in the request.

  • The required permissions are not granted.

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.