Todos os produtos
Search
Central de documentação

Object Storage Service:PutVectorBucket

Última atualização: Sep 23, 2026

Cria um vector bucket.

Observações

Uma conta da Alibaba Cloud pode criar, no máximo, 100 vector buckets em uma região.

Permissões

Uma conta da Alibaba Cloud possui todas as permissões por padrão. Usuários e funções do RAM não têm permissões por padrão e devem 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 de um vector bucket deve ser exclusivo para um UID na mesma região. O nome deve ter entre 3 e 32 caracteres e conter apenas letras minúsculas, dígitos e hifens (-). O nome não pode começar nem terminar com hífen.

Sintaxe da requisição

PUT / HTTP/1.1
Host: exampebucket-123***456.cn-hangzhou-internal.oss-vectors.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Cabeçalhos da requisição

Esta operação usa apenas cabeçalhos de requisição comuns. Para obter mais informações, consulte Common request headers.

Cabeçalhos da resposta

Nome

Tipo

Exemplo

Descrição

Location

String

/examplebucket

O endereço do vector bucket, composto de uma barra (/) seguida do nome do vector bucket.

Valor padrão: nenhum

Esta operação também retorna cabeçalhos de resposta comuns. Para obter mais informações, consulte Common HTTP Header Definitions.

Exemplos

Exemplo de requisição

PUT / HTTP/1.1
Host: examplebucket-123***456.cn-hangzhou-internal.oss-vectors.aliyuncs.com
Date: Thu, 17 Apr 2025 03:15:40 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Exemplo de resposta

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 24 Feb 2017 03:15:40 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS
Location: /examplebucket

SDK

Os SDKs a seguir oferecem suporte à operação PutVectorBucket:

Interface de linha de comando ossutil

Para o comando ossutil correspondente, consulte put-vector-bucket.

Códigos de erro

Código de erro

Código de status HTTP

Descrição

InvalidVectorBucketName

400

O nome do vector bucket não segue as convenções de nomenclatura.

AccessDenied

403

Possíveis motivos:

  • A requisição não contém informações de autenticação de usuário.

  • Você não possui as permissões necessárias.

TooManyBuckets

400

A quantidade de vector buckets atingiu o limite máximo. Uma conta da Alibaba Cloud pode criar, no máximo, 10 vector buckets na mesma região.

BucketNameNotAvailable

409

  • Um bucket com o mesmo nome foi excluído recentemente.

    Aguarde algumas horas, geralmente de 4 a 8 horas, antes de criar um bucket com o mesmo nome.

  • Você usou um usuário do RAM ou o Security Token Service (STS) para criar um bucket que já existe.

    Somente a conta da Alibaba Cloud proprietária do bucket pode criar um bucket com o mesmo nome novamente.