En esta página, se muestra cómo crear buckets de Cloud Storage. Para obtener una descripción general de los buckets, consulta los Términos clave. Si no se especifica lo contrario en tu solicitud, los buckets se crean en la multirregión US
y tienen una clase de almacenamiento predeterminada de Standard Storage.
Para crear un bucket de almacenamiento nuevo, sigue estos pasos:
Console
- Abre el navegador de Cloud Storage en Google Cloud Console.
Abrir el navegador de Cloud Storage - Haz clic en Crear bucket para abrir el formulario de creación de buckets.
- Ingresa la información de tu bucket y haz clic en Continuar para completar cada paso:
- Especifica un Nombre, sujeto a los requisitos de nombre de buckets.
- Selecciona un Tipo de ubicación y una Ubicación donde se almacenarán los datos del bucket de forma permanente.
- Selecciona una clase de almacenamiento predeterminada para el bucket. La clase de almacenamiento predeterminada se asigna de forma predeterminada a todos los objetos subidos al bucket.
Nota: El panel Estimación de costo mensual en el panel derecho calcula los costos mensuales del bucket en función de la clase y ubicación de almacenamiento seleccionadas, así como las operaciones y el tamaño de los datos esperados.
- Selecciona un modelo de control de acceso para determinar cómo controlar el acceso a los objetos del bucket.
- De forma opcional, puedes agregar etiquetas de bucket, establecer una política de retención y elegir un método de encriptación.
- Haga clic en Crear.
Consulta Solución de problemas para obtener información detallada sobre las operaciones fallidas en el navegador de Cloud Storage.
gsutil
Usa el comando gsutil mb
:
gsutil mb gs://BUCKET_NAME
Donde:
BUCKET_NAME
es el nombre que quieres asignar a tu bucket, sujeto a los requisitos de nomenclatura. Por ejemplo,my-bucket
.
Si la solicitud se realiza correctamente, el comando mostrará el siguiente mensaje:
Creating gs://BUCKET_NAME/...
Configura las siguientes marcas opcionales para tener un mayor control sobre la creación de tu bucket:
-p
: Especifica el proyecto con el que se asociará el bucket. Por ejemplo,my-project
.-c
: Especifica la clase de almacenamiento predeterminada de tu bucket. Por ejemplo,NEARLINE
.-l
: Especifica la ubicación de tu bucket. Por ejemplo,US-EAST1
.-b
: Habilita el acceso uniforme a nivel de bucket para el bucket.
Un ejemplo es el siguiente:
gsutil mb -p PROJECT_ID -c STORAGE_CLASS -l BUCKET_LOCATION -b on gs://BUCKET_NAME
Muestras de código
C++
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para C++.
C#
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para C#.
Go
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Go.
Java
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Java.
Node.js
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Node.js.
PHP
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para PHP.
Python
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Python.
Ruby
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Ruby.
API de REST
API de JSON
- Obtén un token de acceso de autorización de OAuth 2.0 Playground. Configura Playground para usar tus credenciales de OAuth.
- Crea un archivo .json que contenga la configuración del bucket, que debe incluir un
name
para el bucket. Consulta la documentación de Buckets:Insert para obtener una lista completa de opciones de configuración. A continuación, se indican las opciones de configuración comunes que puedes incluir: BUCKET_NAME
es el nombre que quieres asignar a tu bucket, sujeto a los requisitos de nomenclatura. Por ejemplo,my-bucket
.BUCKET_LOCATION
es la ubicación en la que deseas almacenar los datos de objeto de tu bucket. Por ejemplo,US-EAST1
.STORAGE_CLASS
es la clase de almacenamiento predeterminada de tu bucket. Por ejemplo,NEARLINE
.- Usa
cURL
para llamar a la API de JSON:curl -X POST --data-binary @JSON_FILE_NAME.json \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b?project=PROJECT_ID"
Donde:
JSON_FILE_NAME
es el nombre del archivo JSON que creaste en el paso 2.OAUTH2_TOKEN
es el token de acceso que generaste en el paso 1.PROJECT_ID
es el ID del proyecto al que se asociará tu bucket. Por ejemplo,my-project
.
{ "name": "BUCKET_NAME", "location": "BUCKET_LOCATION", "storageClass": "STORAGE_CLASS", "iamConfiguration": { "uniformBucketLevelAccess": { "enabled": true }, } }
Aquí:
API de XML
- Obtén un token de acceso de autorización de OAuth 2.0 Playground. Configura Playground para usar tus credenciales de OAuth.
- Crea un archivo .xml que contenga la siguiente información:
BUCKET_LOCATION
es la ubicación en la que deseas almacenar los datos de objeto de tu bucket. Por ejemplo,US-EAST1
.STORAGE_CLASS
es la clase de almacenamiento predeterminada de tu bucket. Por ejemplo,NEARLINE
.- Usa
cURL
para llamar a la API de XML:curl -X PUT --data-binary @XML_FILE_NAME.xml \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "x-goog-project-id: PROJECT_ID" \ "https://storage.googleapis.com/BUCKET_NAME"
Donde:
XML_FILE_NAME
es el nombre del archivo XML que creaste en el paso 2.OAUTH2_TOKEN
es el token de acceso que generaste en el paso 1.PROJECT_ID
es el ID del proyecto al que se asociará tu bucket. Por ejemplo,my-project
.BUCKET_NAME
es el nombre que quieres asignar a tu bucket, sujeto a los requisitos de nomenclatura. Por ejemplo,my-bucket
.
<CreateBucketConfiguration> <LocationConstraint>BUCKET_LOCATION</LocationConstraint> <StorageClass>STORAGE_CLASS</StorageClass> </CreateBucketConfiguration>
Donde:
¿Qué sigue?
- Crea una lista de depósitos en el proyecto.
- Obtén información del bucket .
- Mueve o cambia el nombre de un depósito.
- Borra un depósito.
- Sube un objeto a tu bucket.
- Conoce los conceptos básicos sobre el uso de Cloud Storage con Google Cloud Console.