Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

En esta página

Funciones
Clase de almacenamiento
Sintaxis de solicitud
Parámetros de solicitud
Encabezados de solicitud
Elementos de solicitud
Sintaxis de respuesta
Encabezados de respuesta
Elementos de respuesta
Respuestas de error
Ejemplo de solicitud: Creación de un bucket
Ejemplo de respuesta: Creación de un bucket
Ejemplo de solicitud: creación de un bucket (con ACL y la clase de almacenamiento especificados)
Ejemplo de respuesta: creación de un bucket (con ACL y la clase de almacenamiento especificados)
Ejemplo de solicitud: Creación de un bucket con almacenamiento Multi-AZ
Ejemplo de respuesta: Creación de un bucket con almacenamiento Multi-AZ
Ejemplo de solicitud: Creación de un sistema de archivos paralelo
Ejemplo de respuesta: Creación de un sistema de archivos paralelo
Ejemplo de solicitud: Creación de un bucket con WORM habilitado
Ejemplo de respuesta: Creación de un bucket con WORM habilitado

Mostrar todo

Centro de ayuda/ Object Storage Service/ Referencia de la API/ Las API/ Operaciones en buckets/ Creación de un bucket

Creación de un bucket

Actualización más reciente 2024-09-18 GMT+08:00

Ver PDF

Funciones

Esta operación se utiliza para crear un bucket con un nombre especificado.

NOTA:

De forma predeterminada, un usuario puede tener un máximo de 100 los bucket.
El nombre de un bucket eliminado se puede reutilizar para un bucket o un sistema de archivos paralelo al menos 30 minutos después de la eliminación.
Al crear un bucket en OBS, puede habilitar el modo multi-AZ para el bucket o deshabilitarlo. Con el modo multi-AZ desactivado, los datos en un bucket se almacenan en una AZ única de forma predeterminada. Con el modo multi-AZ habilitado, los datos en un bucket se almacenan de forma redundante en múltiples AZ, lo que mejora la confiabilidad. Sin embargo, los bucket creados anteriormente todavía están en el modo de AZ única.
Puede habilitar WORM cuando cree un bucket, pero no puede habilitar WORM para un bucket existente. En un bucket con WORM habilitado, puede configurar aún más las políticas de retención para los objetos que cargue en este bucket. Para obtener más información, consulte las secciones de WORM. Una vez habilitado, WORM no se puede deshabilitar para un bucket. Cuando creas un bucket con WORM habilitado, OBS activa automáticamente el control de versiones para el bucket y el control de versiones no se puede suspender para ese bucket. Cuando crea un sistema de archivos paralelo, no puede habilitar WORM para él.

Un nombre de bucket debe ser único en OBS. Si un usuario crea un bucket con el mismo nombre que el de un bucket existente en la misma cuenta y en la misma región, se devuelve un código 200 (que indica éxito). En escenarios distintos al anterior, la solicitud para crear un bucket con el mismo nombre que el de uno existente recibirá el código 409 (indicando que ya existe un bucket homónimo). Para establecer una política de control de acceso para el bucket que se va a crear, puede agregar el parámetro x-obs-acl a los encabezados de solicitud.

Clase de almacenamiento

Puede crear los bucket con diferentes clases de almacenamiento. El encabezado x-obs-storage-class en una solicitud de creación de bucket especifica la clase de almacenamiento del bucket. Si no especifica una clase de almacenamiento al cargar un objeto en el bucket, el objeto heredará la clase de almacenamiento del bucket. Las opciones de clase de almacenamiento son las siguientes: STANDARD (Standard), WARM (Infrequent Access), COLD (Archive). Si el encabezado x-obs-storage-class no está en la solicitud, se creará un bucket Standard.

Si la clase de almacenamiento de un objeto no se especifica cuando se carga en un bucket (véase Carga de objetos - PUT), el objeto se almacenará en la clase de almacenamiento predeterminada del bucket.

OBS Standard cuenta con baja latencia de acceso y alto rendimiento. Es más adecuado para almacenar archivos calientes a los que se accede con frecuencia (múltiples veces al mes). Los posibles escenarios de aplicación incluyen big data, aplicaciones móviles, vídeos de tendencia e imágenes de redes sociales.
OBS Infrequent Access es más adecuado para almacenar datos de acceso semifrecuente (menos de 12 veces al año) que requieren una respuesta rápida. Los posibles escenarios de aplicación incluyen sincronización o uso compartido de archivos y backup a nivel empresarial. Proporciona la misma durabilidad, latencia de acceso y rendimiento que el estándar, pero a un precio más bajo. El principal inconveniente, sin embargo, es que tiene una disponibilidad más baja que Standard.
OBS Archive es más adecuado para archivar datos a los que se accede raramente (mediamente una vez al año). Los posibles escenarios de aplicación incluyen el archiving de datos y la retención de datos a largo plazo para el backup. Proporciona almacenamiento seguro, duradero y económico, que puede reemplazar las bibliotecas de cintas. Para mantener los costos bajos, puede tardar horas en restaurar los datos desde el almacenamiento de tipo archivo.
Deep Archive: The Deep Archive storage class (under restricted open beta testing) is suitable for storing data that is barely (once every few years) accessed. This storage class costs less than the Archive storage class, but takes longer time (usually several hours) to restore data.

Sintaxis de solicitud

    
       PUT / HTTP/1.1 
Host: bucketname.obs.region.myhuaweicloud.comContent-Length: length
Date: date
Authorization: authorization
x-obs-az-redundancy: 3az
<CreateBucketConfiguration xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/">  
    <Location>location</Location> 
</CreateBucketConfiguration>

Parámetros de solicitud

Esta solicitud no contiene parámetros.

Encabezados de solicitud

La cabecera del mensaje de operación es la misma que la de una petición común. Para más detalles, consulte Tabla 3. Sin embargo, esta solicitud puede contener encabezados adicionales. En la siguiente tabla se describen los encabezados adicionales para esta solicitud.

**Tabla 1** Cabeceras de solicitud adicionales
Encabezado	Descripción	Obligatorio
x-obs-acl	Al crear un bucket, puede agregar este encabezado para establecer la política de control de permisos para el bucket. Las políticas comunes predefinidas son las siguientes: private, public-read, public-read-write, public-read-delivered, y public-read-write-delivered (para obtener más información sobre las políticas, consulte la configuración de ACL mediante campos de encabezado en ACLs). Tipo: string	No
x-obs-storage-class	Al crear un bucket, puede agregar este encabezado para especificar la clase de almacenamiento predeterminada para el bucket. Las opciones de clase de almacenamiento son las siguientes: STANDARD (Standard), WARM (Infrequent Access), COLD (Archive). Si este encabezado no está en la solicitud, la clase de almacenamiento del bucket creado es Standard. Tipo: string	No
x-obs-grant-read	Este encabezado otorga el permiso de lectura a todos los usuarios de una cuenta. Le permite enumerar objetos en un bucket, enumerar tareas de varias partes en un bucket, enumerar objetos de varias versiones en un bucket y obtener metadatos del bucket. Tipo: string Ejemplo: x-obs-grant-read:id=Tenant ID	No
x-obs-grant-write	Este encabezado otorga el permiso de escritura a todos los usuarios de una cuenta. Por lo tanto, los usuarios pueden crear, eliminar y sobrescribir todos los objetos de un bucket y pueden inicializar piezas, cargar piezas, copiar piezas, combinar piezas y cancelar tareas de carga de varias piezas. Tipo: string Ejemplo: x-obs-grant-write:id=Tenant ID	No
x-obs-grant-read-acp	Este encabezado otorga el permiso de lectura de ACL a todos los usuarios de una cuenta. Por lo tanto, los usuarios pueden leer la información de ACL del bucket. Tipo: string Ejemplo: x-obs-grant-read-acp:id=Account ID	No
x-obs-grant-write-acp	Este encabezado otorga el permiso de escritura de ACL a todos los usuarios con una cuenta. Por lo tanto, los usuarios pueden modificar la ACL del bucket. Tipo: string Ejemplo: x-obs-grant-write-acp:id=Account ID	No
x-obs-grant-full-control	Este encabezado otorga el permiso de control total a todos los usuarios de una cuenta. Tipo: string Ejemplo: x-obs-grant-full-control:id=Account ID	No
x-obs-grant-read-delivered	Este encabezado otorga el permiso de lectura a todos los usuarios de una cuenta. De forma predeterminada, el permiso de lectura se aplica a todos los objetos del bucket. Tipo: string Ejemplo: x-obs-grant-read-delivered:id=Account ID	No
x-obs-grant-full-control-delivered	Este encabezado otorga el permiso de control total a todos los usuarios de una cuenta. De forma predeterminada, el permiso FULL_CONTROL se aplica a todos los objetos del bucket. Tipo: string Ejemplo: x-obs-grant-full-control-delivered:id=Account ID	No
x-obs-az-redundancy	Esta cabecera se incluye en la solicitud cuando se crea un bucket para habilitar el modo multi-AZ para el bucket. Si esta cabecera no se lleva, el bucket está en el modo de AZ única por defecto. Esta cabecera se lleva para especificar que un bucket recién creado utiliza almacenamiento de multi-AZ. Si la región en la que reside el bucket no admite almacenamiento multi-AZ, el bucket todavía utiliza el almacenamiento de un solo-AZ. Tipo: string Ejemplo: x-obs-az-redundancy:3az	No
x-obs-fs-file-interface	Este encabezado se puede llevar cuando se crea un bucket como un sistema de archivos paralelo. Tipo: string Ejemplo: x-obs-fs-file-interface:Enabled	No
x-obs-epid	ID de proyecto de empresa, que se puede obtener del servicio de proyecto de empresa. El valor es un identificador único universal (UUID). El valor de un proyecto de empresa predeterminado es 0 o no contiene este encabezado. Los usuarios que no han habilitado el servicio de proyecto de empresa tampoco necesitan llevar este encabezado. Tipo: string Ejemplo: x-obs-epid:9892d768-2d13-450f-aac7-ed0e44c2585f	No
x-obs-bucket-type	Puede agregar este encabezado para especificar qué tipo de bucket creará.You can choose to create a bucket or a parallel file system. Tipo: string OBJECT: un bucket POSIX: un sistema de archivos paralelo Ejemplo: x-obs-bucket-type:OBJECT	No
x-obs-bucket-object-lock-enabled	Al crear un bucket, puede usar este encabezado para habilitar WORM para el bucket. Tipo: string Ejemplo: x-obs-bucket-object-lock-enabled:true	No

Elementos de solicitud

Esta solicitud puede utilizar elementos adicionales. Para obtener más información acerca de los elementos adicionales, consulte Tabla 2.

**Tabla 2** Elementos de solicitud adicionales
Elemento	Descripción	Obligatorio
Location	Especifica la región donde se creará un bucket. Cuando el punto de conexión de la región CN North-Beijing1 se utiliza para la creación de bucket, si location no está incluida, el bucket se creará en CN North-Beijing1 (cn-north-1) por defecto. Si se especifica otra región, por ejemplo, CN-Hong Kong (ap-southeast-1), para location, el bucket se creará en la región CN-Hong Kong. Cuando se utiliza el punto de conexión de una región distinta de CN North-Beijing1 para la creación de bucket, location debe establecerse en la región a la que corresponde el punto de conexión utilizado. Por ejemplo, si se utiliza obs.ap-southeast-1.myhuaweicloud.com, debe establecer location en ap-southeast-1. Para obtener más información sobre las regiones y los endpoints de OBS, consulte Regiones y puntos de conexión. Tipo: string	No

Sintaxis de respuesta

    
       HTTP/1.1 status_code
Location: location
Date: date
Content-Length: length

Encabezados de respuesta

La respuesta a la solicitud utiliza encabezados comunes. Para más detalles, consulte Tabla 1.

Elementos de respuesta

Esta respuesta no contiene elementos.

Respuestas de error

No se devuelven respuestas de error especiales. Para obtener más información sobre las respuestas de error, consulte Tabla 2.

Ejemplo de solicitud: Creación de un bucket

    
       PUT / HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 02:25:05 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:75/Y4Ng1izvzc1nTGxpMXTE6ynw=
Content-Length: 157

<CreateBucketConfiguration xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/"> 
    <Location>region</Location>
</CreateBucketConfiguration>

Ejemplo de respuesta: Creación de un bucket

    
       HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016435CE298386946AE4C482
Location: /examplebucket
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCT9W2tcvLmMJ+plfdopaD62S0npbaRUz
Date: WED, 01 Jul 2015 02:25:06 GMT
Content-Length: 0

Ejemplo de solicitud: creación de un bucket (con ACL y la clase de almacenamiento especificados)

    
       PUT / HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 02:25:05 GMT
x-obs-acl:public-read
x-obs-storage-class:STANDARD
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:75/Y4Ng1izvzc1nTGxpMXTE6ynw=
Content-Length: 157

<CreateBucketConfiguration xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/"> 
    <Location>region</Location> 
</CreateBucketConfiguration>

Ejemplo de respuesta: creación de un bucket (con ACL y la clase de almacenamiento especificados)

    
       HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016435CE298386946AE4C482
Location: /examplebucket
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCT9W2tcvLmMJ+plfdopaD62S0npbaRUz
Date: WED, 01 Jul 2015 02:25:06 GMT
Content-Length: 0

Ejemplo de solicitud: Creación de un bucket con almacenamiento Multi-AZ

    
       PUT / HTTP/1.1 
Host: examplebucket.obs.region.myhuaweicloud.comContent-Length: length 
Date: date 
Authorization: authorization 
x-obs-az-redundancy:3az 
<CreateBucketConfiguration xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/">  <Location>region</Location> </CreateBucketConfiguration>

Ejemplo de respuesta: Creación de un bucket con almacenamiento Multi-AZ

    
       HTTP/1.1 200 OK 
Server: OBS 
x-obs-request-id: BF260000016435CE298386946AE4C482 
Location: /examplebucket 
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCT9W2tcvLmMJ+plfdopaD62S0npbaRUz 
Date: WED, 01 Jul 2015 02:25:06 GMT 
x-obs-az-redundancy:3az
Content-Length: 0

Ejemplo de solicitud: Creación de un sistema de archivos paralelo

    
       PUT / HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 02:25:05 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:75/Y4Ng1izvzc1nTGxpMXTE6ynw=
Content-Length: 157
x-obs-fs-file-interface: Enabled

<CreateBucketConfiguration xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/"> 
<Location>region</Location> 
</CreateBucketConfiguration>

Ejemplo de respuesta: Creación de un sistema de archivos paralelo

    
       HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016435CE298386946AE4C482
Location: /examplebucket
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCT9W2tcvLmMJ+plfdopaD62S0npbaRUz
Date: WED, 01 Jul 2015 02:25:06 GMT
Content-Length: 0

Ejemplo de solicitud: Creación de un bucket con WORM habilitado

PUT / HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 02:25:05 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:75/Y4Ng1izvzc1nTGxpMXTE6ynw=
x-obs-bucket-object-lock-enabled:true
Content-Length: 0

Ejemplo de respuesta: Creación de un bucket con WORM habilitado

HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 00000184C11AC7A6809F881341842C02
x-reserved-indicator: Unauthorized
Location: /examplebucket
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCT9W2tcvLmMJ+plfdopaD62S0npbaRUz
Date: WED, 01 Jul 2015 02:25:06 GMT
Content-Length: 0

Tema principal: Operaciones en buckets

Tema anterior: Enumeración de buckets

Tema siguiente: Listado de objetos en un bucket

Comentarios

¿Le pareció útil esta página?

Sí No

Deje algún comentario

Muchas gracias por sus comentarios. Seguiremos trabajando para mejorar la documentación.

El sistema está ocupado. Vuelva a intentarlo más tarde.

¿Cuáles de los siguientes problemas se presentaron?

Contenido diferente a la de la IU del producto

Descripciones poco claras

Falta de ejemplos o código

Pasos incorrectos

No puedo encontrar lo que necesito

Falta de prácticas recomendadas

Comentarios (opcional)

0/500

Seleccione al menos un tipo de problema e ingrese sus comentarios o sugerencias.

Ingrese 500 caracteres como máximo.

Enviar Cancelar