All Products
Search
Document Center

Object Storage Service:DeleteVectorIndex

Last Updated:Feb 11, 2026

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

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

SDK

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:

  • No authentication information was provided in the request.

  • You do not have permission to perform this operation.

NoSuchVectorIndex

404

The specified vector index does not exist.

VectorIndexOperationConflict

409

This operation fails if the index state is not enabled.