The delete_vector_bucket interface deletes a specified vector bucket. This article explains how to perform the deletion using the delete_vector_bucket interface in the TOS Vectors Python SDK. Before calling, ensure there are no uncleared vector data in the bucket.

Notes

You need to fill in the region and access domain in the sample code according to your actual situation. For details, see Region and Access Domain (Endpoint).

To prevent key leakage, the example code in this article reads the Access Key ID and Secret Access Key from environment variables. Therefore, before using the SDK, you need to configure long-term access credentials. For details, see Configure long-term access credentials.

The TOS Vectors Python SDK supports temporary access credentials and also allows configuration of timeout mechanisms, retry strategies, and other settings. You can flexibly set these according to business needs to enhance application security. For details, see Common Configuration Scenarios.

Before deleting a vector bucket, ensure the bucket is empty, meaning the vector indexes in the bucket have been deleted.

Permissions required

The main account has all permissions by default, but an IAM user has no permissions by default. If you need a sub-account to perform the delete_vector_bucket operation, the main account must grant the following permissions to the sub-account through IAM policies and bucket policies:

tosvectors:DeleteVectorBucket

Code example

Basic usage of deleting a vector bucket

# Basic usage of deleting vector buckets​
import os​
import tos​
​
# Retrieve AK and SK information from environment variables.​
ak = os.getenv('TOS_ACCESS_KEY')​
sk = os.getenv('TOS_SECRET_KEY')​
# Fill in your endpoint and your region with the endpoint corresponding to the bucket's region. # For example, for China (Beijing), set your endpoint to https://tosvectors-cn-beijing.volces.com and your region to cn-beijing.​
endpoint = 'Provide your endpoint'​
region = 'Provide your region'​
vector_bucket_name = 'Provide your bucket name'​
​
# Account ID, used for vector bucket operations​
account_id = os.getenv('TOS_ACCOUNT_ID')​
​
try:​
    # Create a VectorClient object; all vector operations are handled through VectorClient​
    client = tos.VectorClient(ak, sk, endpoint, region)​
    ​
    # Delete vector bucket​
    # Parameter description：​
    # - vector_bucket_name: Vector bucket name to be deleted​
    # - account_id: Account ID, used for authorization verification​
    result = client.delete_vector_bucket(vector_bucket_name, account_id)​
    ​
    # Print the deletion result​
    print('Delete vector bucket successfully')​
    print('Request ID:', result.request_id)​
    print('Status Code:', result.status_code)​
    ​
except tos.exceptions.TosClientError as e:​
    # The operation failed and a client exception was caught. This is usually due to invalid request parameters or a network exception.​
    print('fail with client error, message:{}, cause: {}'.format(e.message, e.cause))​
except tos.exceptions.TosServerError as e:​
    # The operation failed and a server exception occurred. See the response for the error details.​
    print('fail with server error, code: {}'.format(e.code))​
    # Use the request ID for troubleshooting purposes. We strongly recommend including the request ID in the logs.​
    print('error with request id: {}'.format(e.request_id))​
    print('error with message: {}'.format(e.message))​
    print('error with http code: {}'.format(e.status_code))​
    print('error with ec: {}'.format(e.ec))​
    print('error with request url: {}'.format(e.request_url))​
except Exception as e:​
    print('fail with unknown error: {}'.format(e))​