All Products
Search
Document Center

Object Storage Service:Delete a vector bucket (Go SDK V2)

Last Updated:Jun 03, 2026

You can use the Go SDK V2 to call the DeleteVectorBucket operation and delete a vector bucket. This operation is irreversible. Proceed with caution.

Permissions

An Alibaba Cloud account has full permissions by default. RAM users and roles have no permissions by default and must be granted permissions through a RAM policy overview or a bucket policy.

API

Action

Description

DeleteVectorBucket

oss:DeleteVectorBucket

Deletes a vector bucket.

Method definition

func (c *VectorsClient) DeleteVectorBucket(ctx context.Context, request *DeleteVectorBucketRequest, optFns ...func(*Options)) (*DeleteVectorBucketResult, error)

Request parameters

Parameter

Type

Description

ctx

context.Context

The request context.

request

*DeleteVectorBucketRequest

The request parameters. This includes the name of the vector bucket to delete. For more information, see DeleteVectorBucketRequest.

optFns

...func(*Options)

(Optional) The interface-level configuration parameters.

For more information, see Options.

Return values

Parameter

Type

Description

result

*DeleteVectorBucketResult

The return value. This is valid when err is nil. For more information, see DeleteVectorBucketResult.

err

error

The error message. This is nil if the operation is successful.

Example code

package main

import (
	"context"
	"flag"
	"log"

	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/vectors"
)

var (
	region     string
	bucketName string
	accountId  string
)

func init() {
	flag.StringVar(&region, "region", "", "The region in which the vector bucket is located.")
	flag.StringVar(&bucketName, "bucket", "", "The name of the vector bucket.")
	flag.StringVar(&accountId, "account-id", "", "The ID of the account that contains the vector bucket.")
}

func main() {
	flag.Parse()
	if len(bucketName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, bucket name required")
	}

	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, region required")
	}

	if len(accountId) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, accountId required")
	}

	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region).WithAccountId(accountId).
		// To use public access, set this parameter to false or remove this line.
		WithUseInternalEndpoint(true)

	client := vectors.NewVectorsClient(cfg)

	request := &vectors.DeleteVectorBucketRequest{
		Bucket: oss.Ptr(bucketName),
	}
	result, err := client.DeleteVectorBucket(context.TODO(), request)
	if err != nil {
		log.Fatalf("failed to delete vector bucket %v", err)
	}
	log.Printf("delete vector bucket result:%#v\n", result)
}

References

For complete sample code, see delete_vector_bucket.go.