Todos los productos
Search

Este producto

    Object Storage Service:PutBucket

    Centro de documentos

    Object Storage Service:PutBucket

    Última actualización: Sep 21, 2026

    Llame a la operación PutBucket para crear un bucket.

    Notas

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

    • Cada región tiene un endpoint correspondiente. Para obtener más información sobre los endpoints de cada región, consulte Endpoints.

    • Si llama a la operación PutBucket varias veces para el mismo bucket, la primera llamada crea el bucket y las llamadas posteriores modifican sus metadatos, como la ACL del bucket. Esto puede provocar que se sobrescriban los metadatos del bucket. Proceda con precaución.

    • A partir de las 10:00:00 (UTC+8) del 13 de octubre de 2025, OSS habilita gradualmente de forma predeterminada el bloqueo de acceso público para los buckets creados mediante llamadas a operaciones de API o con los SDK de OSS u ossutil en todas las regiones. Para conocer la fecha en que el cambio entra en vigor en cada región, consulte Anuncio.

    Permisos

    De forma predeterminada, una cuenta de Alibaba Cloud tiene permisos completos. Los usuarios de RAM o los roles de RAM asociados a una cuenta de Alibaba Cloud no tienen ningún permiso de forma predeterminada. La cuenta de Alibaba Cloud o el administrador de la cuenta debe otorgar los permisos de operación mediante RAM policies o Bucket Policy.

    API

    Action

    Descripción

    PutBucket

    oss:PutBucket

    Crea un bucket.

    oss:PutBucketAcl

    Este permiso es obligatorio para modificar la ACL del bucket después de crearlo.

    Sintaxis de la solicitud

    PUT / HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
x-oss-acl: Permission
Authorization: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<CreateBucketConfiguration>
    <StorageClass>Standard</StorageClass>
</CreateBucketConfiguration>

    Encabezados de la solicitud

    Nombre

    Tipo

    Obligatorio

    Ejemplo

    Descripción

    x-oss-acl

    String

    No

    private

    La lista de control de acceso (ACL) del bucket. Valores válidos:

    • public-read-write: otorga permisos públicos de lectura y escritura.

    • public-read: lectura pública.

    • private (predeterminado)

    Para obtener más información sobre las ACL de los buckets, consulte Set bucket ACLs.

    x-oss-resource-group-id

    String

    No

    rg-aek27tc****

    El ID del resource group.

    • Si incluye este encabezado en la solicitud y especifica un ID de resource group, el bucket creado pertenecerá al resource group indicado.

      Si establece el ID del resource group en rg-default-id, el bucket creado pertenecerá al resource group predeterminado.

    • Si no incluye este encabezado en la solicitud, el bucket creado pertenecerá al resource group predeterminado.

    Puede obtener el ID del resource group en la consola de Resource Management o mediante la llamada a la operación ListResourceGroups. Para obtener más información, consulte View resource groups y ListResourceGroups.

    x-oss-bucket-tagging

    String

    No

    k1=v1&k2=v2

    Especifica las etiquetas del bucket.

    x-oss-hns-status

    String

    No

    disabled

    Indica si se habilita la función de espacio de nombres jerárquico para el bucket.

    Solo puede habilitar la función de espacio de nombres jerárquico cuando crea un bucket. No es posible cambiar el estado del espacio de nombres jerárquico de un bucket existente.

    • enabled: habilitado.

      Después de habilitar la función de espacio de nombres jerárquico para un bucket, puede ejecutar operaciones de directorio en él, como crear, eliminar y renombrar directorios.

    • disabled (predeterminado): la función está deshabilitada.

    x-oss-server-side-encryption

    String

    No

    AES256

    Establece el método de cifrado del lado del servidor predeterminado.

    Valores válidos: KMS, AES256

    Nota

    En escenarios de OSS en CloudBox, solo se admite AES256.

    El uso de la función KMS genera un cargo menor por las llamadas a la API de KMS. Para obtener más información sobre los precios, consulte KMS pricing.

    Durante el cross-region replication, si el bucket de destino tiene habilitado el cifrado del lado del servidor predeterminado y la regla de replicación se configuró con un ReplicaCMKID, aplican las siguientes situaciones:

    • Si un objeto del bucket de origen no está cifrado, se cifra con el método de cifrado predeterminado del bucket de destino después de replicarse.

    • Si un objeto del bucket de origen se cifró con SSE-KMS o SSE-OSS, conserva su método de cifrado original en el bucket de destino.

    Para obtener más información, consulte Cross-region replication with server-side encryption.

    x-oss-server-side-encryption-key-id

    String

    No

    9468da86-3509-4f8d-a61e-6eab1eac****

    El ID de la clave de KMS. Este encabezado es obligatorio únicamente cuando x-oss-server-side-encryption se establece en KMS. En otros casos, debe estar vacío.

    Si usa OSS en CloudBox, este parámetro no es compatible.

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

    Elementos de la solicitud

    Nombre

    Tipo

    Obligatorio

    Ejemplo

    Descripción

    StorageClass

    String

    No

    Standard

    La clase de almacenamiento del bucket. Valores válidos:

    • Standard (predeterminado)

    • IA: Infrequent Access.

    • Archive: Archive Storage.

    • ColdArchive: Cold Archive.

    • DeepColdArchive: Deep Cold Archive.

    Nodo principal: CreateBucketConfiguration

    Nodos secundarios: Ninguna

    DataRedundancyType

    String

    No

    LRS

    El tipo de redundancia de datos del bucket. Valores válidos:

    • LRS (predeterminado)

      El almacenamiento con redundancia local (LRS) guarda copias de sus datos en distintos dispositivos de almacenamiento dentro de la misma zona. Esto garantiza la durabilidad y disponibilidad de los datos incluso si dos dispositivos de almacenamiento resultan dañados al mismo tiempo.

    • ZRS

      El almacenamiento con redundancia de zona (ZRS) utiliza un mecanismo de redundancia de datos en varias zonas. ZRS almacena los datos de un objeto en múltiples zonas de la misma región. Si una zona deja de estar disponible, aún puede acceder a los datos.

    Nodo principal: CreateBucketConfiguration

    Nodos secundarios: Ninguna

    Encabezados de la respuesta

    Nombre

    Tipo

    Ejemplo

    Descripción

    Location

    String

    /oss-example

    La dirección del bucket. El valor es una barra diagonal (/) seguida del nombre del bucket.

    Valor predeterminado: Ninguna

    La respuesta también incluye encabezados de respuesta comunes. Para obtener más información, consulte Common response headers.

    Ejemplos

    • Crear un bucket en el resource group predeterminado

      PUT / HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 03:15:40 GMT
x-oss-acl: private
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
<?xml version="1.0" encoding="UTF-8"?>
<CreateBucketConfiguration>
    <StorageClass>Standard</StorageClass>
    <DataRedundancyType>LRS</DataRedundancyType>    
</CreateBucketConfiguration>

    • Respuesta de ejemplo

      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: /oss-example

    • Crear un bucket en un resource group específico

      Solicitud de ejemplo

      PUT / HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 03:15:40 GMT
x-oss-acl: private
x-oss-resource-group-id: rg-aek27tc********
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
<?xml version="1.0" encoding="UTF-8"?>
<CreateBucketConfiguration>
    <StorageClass>Standard</StorageClass>
</CreateBucketConfiguration>

      Respuesta de ejemplo

      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: /oss-example

    SDK

    Puede llamar a la operación PutBucket con los SDK de OSS para los siguientes lenguajes de programación:

    Herramienta de línea de comandos ossutil

    Para obtener información sobre el comando de ossutil correspondiente a la operación PutBucket, consulte put-bucket.

    Códigos de error

    Código de error

    Código de estado HTTP

    Descripción

    InvalidBucketName

    400

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

    AccessDenied

    403

    Las siguientes son posibles causas del error:

    • La solicitud PutBucket no incluye la información de autenticación del usuario.

    • No cuenta con los permisos necesarios.

    TooManyBuckets

    400

    La cantidad de buckets creados supera el límite máximo. Una cuenta de Alibaba Cloud puede crear un máximo de 100 buckets en la misma región.

    BucketAlreadyExists

    409

    • Si se eliminó un bucket, no se cumple el tiempo requerido para crear otro con el mismo nombre.

      Intentó crear un bucket con un nombre que pertenecía a un bucket eliminado recientemente. Después de eliminar un bucket, debe esperar varias horas (por lo general, de 4 a 8 horas) antes de poder crear uno con el mismo nombre.

    • Llamó a la operación PutBucket mediante métodos como un usuario de RAM o STS para crear un bucket con el mismo nombre que uno ya existente.

      Solo la cuenta de Alibaba Cloud original puede volver a crear un bucket con el mismo nombre.

    • No tiene los permisos para llamar a la operación PutBucketAcl. Compruebe que se haya otorgado al llamador el permiso oss:PutBucketAcl mediante una política de bucket o una política de RAM.

    • Intentó cambiar el estado del espacio de nombres jerárquico de un bucket existente. Solo puede habilitar la función de espacio de nombres jerárquico cuando crea un bucket.