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.
Requisitos previos
Los requisitos previos pueden variar según la herramienta que se use:
Console
Para completar esta guía con Google Cloud Console, debes tener los permisos de IAM adecuados. Si no creaste el proyecto al que deseas acceder, es posible que el propietario del proyecto te otorgue un rol que contenga los permisos necesarios.
A fin de obtener una lista de los permisos necesarios para acciones específicas, consulta Permisos de IAM para Google Cloud Console.
Para obtener una lista de los roles relevantes, consulta Funciones de Cloud Storage. Como alternativa, puedes crear un rol personalizado que tenga permisos más limitados.
Línea de comandos
Para completar esta guía con una utilidad de línea de comandos, debes tener los permisos de IAM adecuados. Si no creaste el proyecto al que deseas acceder, es posible que el propietario del proyecto te otorgue un rol que contenga los permisos necesarios.
Si deseas obtener una lista de los permisos necesarios para acciones específicas, consulta Permisos de IAM para los comandos de gsutil.
Para obtener una lista de los roles relevantes, consulta Roles de Cloud Storage. Como alternativa, puedes crear un rol personalizado que tenga permisos más limitados.
Muestras de código
Para completar esta guía con las bibliotecas cliente de Cloud Storage, debes tener los permisos de IAM adecuados. Si no creaste el proyecto al que deseas acceder, es posible que el propietario del proyecto te otorgue un rol que contenga los permisos necesarios. A menos que se indique lo contrario, las solicitudes de la biblioteca cliente se realizan mediante la API de JSON.
Si deseas obtener una lista de los permisos necesarios para acciones específicas, consulta Permisos de IAM para métodos JSON.
Para obtener una lista de los roles relevantes, consulta Roles de Cloud Storage. Como alternativa, puedes crear un rol personalizado que tenga permisos más limitados.
API de REST
API de JSON
Para completar esta guía con la API de JSON, debes tener los permisos de IAM adecuados. Si no creaste el proyecto al que deseas acceder, es posible que el propietario del proyecto te otorgue un rol que contenga los permisos necesarios.
Si deseas obtener una lista de los permisos necesarios para acciones específicas, consulta Permisos de IAM para métodos JSON.
Para obtener una lista de los roles relevantes, consulta Roles de Cloud Storage. Como alternativa, puedes crear un rol personalizado que tenga permisos más limitados.
Crea un bucket nuevo
Console
- En Google Cloud Console, ve a la página Navegador de Cloud Storage.
- Haga clic en Crear bucket.
- En la página Crear un bucket, ingresa la información de tu bucket. Para ir al paso siguiente, haz clic en Continuar.
- En Asigna un nombre a tu bucket, ingresa un nombre que cumpla con los requisitos de nomenclatura de buckets.
- En Elige dónde almacenar tus datos, selecciona un Tipo de ubicación y una Ubicación en la que se almacenarán de forma permanente los datos del bucket.
- En Elegir una clase de almacenamiento predeterminada para tus datos, selecciona una clase de almacenamiento 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.
- En Elige cómo controlar el acceso a los objetos, selecciona si tu bucket aplica o no la prevención del acceso público y selecciona un modelo de Control de acceso para los objetos del bucket.
Nota: Si la política de la organización de tu proyecto ya aplica la prevención del acceso público, el botón de activación Impedir el acceso público se bloquea.
- En Elige cómo proteger los datos de objetos, configura herramientas de protección si lo deseas y selecciona un método de encriptación de datos.
- Haga clic en Crear.
Para aprender a obtener información detallada sobre errores en las operaciones fallidas en el navegador de Cloud Storage, consulta Solución de problemas.
Línea de comandos
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 ID o el número del 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
: especifica la configuración de acceso uniforme a nivel de bucket para tu bucket. Por ejemplo,ON
.
Para obtener una lista completa de opciones para la creación de buckets de gsutil, consulta las opciones de mb.
Por ejemplo:
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.
Terraform
Puedes usar un recurso de Terraform para crear un bucket de almacenamiento.
API de REST
API de JSON
- Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus credenciales de OAuth. Para obtener instrucciones, consulta Autenticación de la API.
- 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_IDENTIFIER"
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_IDENTIFIER
es el ID o el número del proyecto al que se asociará el 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 autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus credenciales de OAuth. Para obtener instrucciones, consulta Autenticación de la API.
- 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.
Pruébalo tú mismo
Si es la primera vez que usas Google Cloud, crea una cuenta para evaluar el rendimiento de Cloud Storage en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
Probar Cloud Storage gratis