Todos os produtos
Search
Central de documentação

Object Storage Service:Criar um vector bucket (Python SDK V2)

Última atualização: Jul 03, 2026

Um vector bucket armazena índices e dados vetoriais. Para criar um vector bucket, chame o método put_vector_bucket do Python SDK V2.

Permissões

A conta Alibaba Cloud tem todas as permissões por padrão. Usuários e funções RAM não têm permissões por padrão e precisam receber acesso por meio de uma política do RAM ou de uma política de bucket.

API

Ação

Descrição

PutVectorBucket

oss:PutVectorBucket

Cria um vector bucket. O nome do vector bucket deve ser exclusivo para um UID na mesma região. O nome deve ter de 3 a 32 caracteres e conter apenas letras minúsculas, dígitos e hifens (-). Não inicie nem termine o nome com hífen.

Definição do método

put_vector_bucket(request: PutVectorBucketRequest, **kwargs) → PutVectorBucketResult

Parâmetros da solicitação

Parâmetro

Tipo

Descrição

request

PutVectorBucketRequest

Parâmetros da solicitação, como o nome do vector bucket. Para mais informações, consulte PutVectorBucketRequest.

Valor de retorno

Tipo

Descrição

PutVectorBucketResult

Valor retornado pela operação. Para mais detalhes, consulte PutVectorBucketResult.

Para ver a definição completa do método put_vector_bucket, consulte put_vector_bucket.

Código de exemplo

O código a seguir mostra como criar um vector bucket.

import argparse
import alibabacloud_oss_v2 as oss
import alibabacloud_oss_v2.vectors as oss_vectors

parser = argparse.ArgumentParser(description="vector put bucket sample")
parser.add_argument('--region', help='The region in which the bucket is located.', required=True)
parser.add_argument('--bucket', help='The name of the bucket.', required=True)
parser.add_argument('--endpoint', help='The endpoint for accessing OSS.', required=False)
parser.add_argument('--account_id', help='The account id.', required=True)

def main():
    args = parser.parse_args()

    # Load credentials from environment variables
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # Use the SDK's default configuration
    cfg = oss.config.load_default()
    cfg.credentials_provider = credentials_provider
    cfg.region = args.region
    cfg.account_id = args.account_id
    cfg.use_internal_endpoint = True  # Set this to False or delete this line if you want to access OSS over the public network.
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    vector_client = oss_vectors.Client(cfg)

    result = vector_client.put_vector_bucket(oss_vectors.models.PutVectorBucketRequest(
        bucket=args.bucket,
    ))

    print(f'status code: {result.status_code},'
          f' request id: {result.request_id},'
    )

if __name__ == "__main__":
    main()

Referências

Para obter o código de exemplo completo, consulte put_vector_bucket.py.