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