Cree un bucket

Cuando creas un depósito, puedes especificar su ubicación geográfica y la clase de almacenamiento del depósito.

Si intentas crear un depósito con un nombre no válido, obtendrás un400 Bad Request el código de estado y el cuerpo de la respuesta de errorInvalidBucketName deCode.

Solo puedes crear un depósito en proyectos para los que tengas permiso. Por ejemplo, si tienes la función Administrador de almacenamiento en un proyecto, tienes el permiso necesario (storage.objects.create) para crear depósitos.

Además, debido a que el espacio de nombres del depósito es global, el nombre del depósito debe ser único en todo el espacio de nombres de Cloud Storage. Si el nombre de tu depósito está en uso, se mostrará un código de estado 409 confliction y la solicitud de creación de depósito fallará. El cuerpo de la respuesta de error contiene BucketAlreadyExists en el elemento Code si el depósito ya existe en el espacio de nombres o contiene un BucketAlreadyOwnedByYou en el elemento Code. si el depósito es de tu propiedad. Si deseas obtener más información, consulta Requisitos para los nombres de depósitos y los Lineamientos para la asignación de nombres de objetos.

Parámetros de string de consulta

Esta solicitud no suele incluir parámetros de cadena de consulta.

Consulta los parámetros de string de consulta de URL firmados para obtener información sobre los parámetros que incluyes cuando creas y usas URL firmadas.

Solicita encabezados

Además de los encabezados de solicitud comunes, se puede usar lo siguiente.

Header Descripción Obligatorio
x-goog-acl La lista de control de acceso (LCA) predefinida que deseas aplicar al depósito. No lo uses si usas el parámetro de string de consulta acl para aplicar las LCA. No
x-goog-bucket-retention-period El tiempo, en segundos, que los objetos del depósito deben conservarse antes de que puedan reemplazarse o borrarse. No
x-goog-project-id ID del proyecto de un proyecto Obligatorio, a menos que hayas configurado el proyecto predeterminado para el acceso interoperable. No

Elementos de cuerpo de la solicitud

Los siguientes elementos del cuerpo de solicitud se aplican cuando creas un depósito. Si no especificas un cuerpo de solicitud, Cloud Storage crea un depósito en la ubicación US con una clase de almacenamiento STANDARD.

Elemento Descripción
CreateBucketConfiguration Contenedor para solicitud de creación de cuerpo.
LocationConstraint Una ubicación para el depósito.
StorageClass La clase de almacenamiento del depósito, como STANDARD, NEARLINE, COLDLINE o ARCHIVE

Sintaxis de la solicitud

PUT / HTTP/1.1
Host: BUCKET_NAME.storage.googleapis.com
Date: DATE
Content-Length: REQUEST_BODY_LENGTH
Authorization: AUTHENTICATION_STRING
x-goog-project-id: PROJECT_ID
x-goog-acl: PREDEFINED_ACL
x-goog-bucket-retention-period: TIME_IN_SECONDS

<CreateBucketConfiguration>
  <LocationConstraint>LOCATION</LocationConstraint>
  <StorageClass>STORAGE_CLASS</StorageClass>
</CreateBucketConfiguration>

Encabezados de respuesta

La solicitud puede mostrar una variedad de encabezados de respuesta según los encabezados de la solicitud que uses.

Elementos del cuerpo de la respuesta

La respuesta no incluye un documento XML en el cuerpo de la respuesta.

Ejemplo

En el siguiente ejemplo, se crea un depósito de Standard Storage llamado ac-pets en la ubicación en EE.UU. y en el proyecto especificado (no se especifica el cuerpo de la solicitud).

Solicitud

PUT / HTTP/1.1
Host: acme-pets.storage.googleapis.com
Date: Mon, 15 Feb  2008 21:30:39 GMT
Content-Length: 0
x-goog-project-id: 123456789123
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg
 
<CreateBucketConfiguration>
  <StorageClass>STANDARD</StorageClass>
</CreateBucketConfiguration>

Respuesta

HTTP/1.1 200 OK
Date: Mon, 15 Feb 2010 12:30:40 GMT
Content-Length: 0