Todos los productos
Search
Centro de documentos

Object Storage Service:PutVectorBucket

Última actualización: Sep 23, 2026

Cree un bucket de vectores.

Notas

Una cuenta de Alibaba Cloud puede crear un máximo de 100 buckets de vectores en una región.

Permisos

De forma predeterminada, una cuenta de Alibaba Cloud tiene todos los permisos. Los usuarios y roles de RAM no cuentan con permisos de manera predeterminada, por lo que se les debe otorgar acceso mediante una RAM policy o una bucket policy.

API

Acción

Descripción

PutVectorBucket

oss:PutVectorBucket

Cree un bucket de vectores. El nombre del bucket de vectores debe ser único para un UID dentro de la misma región. Debe tener entre 3 y 32 caracteres de longitud. Solo admite letras minúsculas, dígitos y guiones (-). No puede comenzar ni terminar con un guion.

Sintaxis de la solicitud

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

Encabezados de solicitud

Esta operación solo utiliza encabezados de solicitud comunes. Para obtener más información, consulte Common request headers.

Encabezados de respuesta

Nombre

Tipo

Ejemplo

Descripción

Location

String

/examplebucket

La dirección del bucket de vectores, formada por una barra diagonal (/) seguida del nombre del bucket.

Valor predeterminado: Ninguna

Esta operación también devuelve encabezados de respuesta comunes. Para obtener más información, consulte Common HTTP Header Definitions.

Ejemplos

Ejemplo de solicitud

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

Ejemplo de respuesta

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

Los SDK a continuación son compatibles con la operación PutVectorBucket:

Interfaz de línea de comandos de ossutil

Para conocer el comando correspondiente de ossutil, consulte put-vector-bucket.

Códigos de error

Código de error

Código de estado HTTP

Descripción

InvalidVectorBucketName

400

El nombre del bucket de vectores no cumple con las convenciones de nomenclatura.

AccessDenied

403

Posibles motivos:

  • La solicitud no contiene información de autenticación del usuario.

  • No cuenta con los permisos obligatorios.

TooManyBuckets

400

Se alcanzó el límite máximo de buckets de vectores. Una cuenta de Alibaba Cloud puede crear un máximo de 10 buckets de vectores en la misma región.

BucketNameNotAvailable

409

  • Se eliminó recientemente un bucket con el mismo nombre.

    Debe esperar varias horas, generalmente entre 4 y 8, antes de crear un bucket con ese mismo nombre.

  • Utilizó un usuario de RAM o Security Token Service (STS) para crear un bucket que ya existe.

    Solo la cuenta de Alibaba Cloud propietaria del bucket puede volver a crear uno con el mismo nombre.