En esta página, se muestra cómo crear buckets de Cloud Storage. Si no se especifica lo contrario en tu solicitud, los buckets se crean en elUS
multirregión con una clase de almacenamiento predeterminada de
Standard Storage y tiene una duración de borrar de forma no definitiva de siete días de retención.
Roles obligatorios
Para obtener los permisos necesarios que te permitan crear un bucket de Cloud Storage, pídele a tu administrador que te otorgue el rol de IAM de administrador de almacenamiento (roles/storage.admin
) para el proyecto.
Este rol predefinido contiene el permiso necesario para crear un bucket. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
storage.buckets.create
storage.buckets.enableObjectRetention
(solo es necesaria si habilitas las configuraciones de retención de objetos para el bucket)storage.buckets.list
(solo es necesario si se crea un bucket con la consola de Google Cloud)resourcemanager.projects.get
(solo es necesario si se crea un bucket con la consola de Google Cloud)
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos. Para ver qué roles están asociados con qué permisos, consulta Roles de IAM para Cloud Storage.
Si deseas obtener instrucciones para otorgar roles a proyectos, consulta Administra el acceso a los proyectos.
Crea un bucket nuevo
Si creas un bucket por primera vez, consulta Descubre el almacenamiento de objetos con la consola de Google Cloud o Descubre el almacenamiento de objetos con la herramienta Google Cloud CLI.
Para crear buckets con parámetros de configuración específicos o avanzados, completa los siguientes pasos:
Console
- En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.
Haz clic en
Crear.En la página Crear un bucket, ingresa la información de tu bucket. Después de cada uno de los siguientes pasos, haz clic en Continuar para avanzar al siguiente paso:
En la sección Primeros pasos, haz lo siguiente:
- Ingresa un nombre único a nivel global que cumpla con los requisitos de nombre de los buckets.
Para habilitar el espacio de nombres jerárquico, haz clic en la flecha de expansión para expandir la sección Optimizar las cargas de trabajo orientadas a archivos y con uso intensivo de datos y, luego, selecciona Habilitar el espacio de nombres jerárquico en este bucket.
Para agregar una etiqueta de bucket, haz clic en la flecha desplegable para expandir la sección Etiquetas, haz clic en add_box Agrega etiqueta y especifica una
key
y unvalue
para tu etiqueta.
En la sección Eligir dónde almacenar tus datos, haz lo siguiente:
Selecciona un tipo de ubicación
Usa el menú desplegable del tipo de ubicación para seleccionar una Ubicación en la que se almacenarán de forma permanente los datos de objetos de tu bucket.
- Si seleccionas el tipo de ubicación birregional, también puedes habilitar la replicación turbo con la casilla de verificación correspondiente.
Para configurar la replicación bucket buckets, expande la sección Configurar la bucket entre buckets y sigue estos pasos:
Configura la replicación entre bucket
- Selecciona la casilla de verificación junto a Agregar replicación entre bucket a través del Servicio de transferencia de almacenamiento.
- En el menú Bucket de destino, selecciona un bucket de destino.
En la sección Configuración de replicación, haz clic en Configurar para configurar la configuración del trabajo de replicación.
Aparecerá el panel Configurar la replicación entre buckets.
- Para filtrar los objetos que se replicarán por prefijo de nombre de objeto, ingresa un prefijo con el que deseas incluir o excluir objetos y, luego, haz clic en Agregar un prefijo.
- Para establecer una clase de almacenamiento para los objetos replicados, selecciona una clase de almacenamiento del menú Clase de almacenamiento. Si omites este paso, los objetos replicados usarán la clase de almacenamiento del bucket de destino de forma predeterminada.
- Haz clic en Listo.
En laElige una clase de almacenamiento para tus datos, selecciona una clase de almacenamiento predeterminada para el bucket, o selecciona Autoclass para la administración automática de clases de almacenamiento de los datos de tu bucket.
En la sección Elige cómo controlar el acceso a los objetos, selecciona si tu bucket aplica o no la prevención del acceso público y elige un modelo de control de acceso para los objetos del bucket.
En la sección Elige cómo proteger los datos de objetos, haz lo siguiente:
Selecciona cualquiera de las opciones de Protección de datos que desees configurar para tu bucket.
Para elegir cómo se encriptarán los datos de tus objetos, haz clic en la flecha desplegable encriptación de datos.
etiquetada como Encriptación de datos y selecciona un método de
Haz clic en Crear.
Para obtener información acerca de cómo ver detalles de errores acerca de operaciones fallidas de Cloud Storage en la consola de Google Cloud, consulta Solución de problemas.
Línea de comandos
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
En tu entorno de desarrollo, ejecuta el comando
gcloud storage buckets create
:gcloud storage buckets create gs://BUCKET_NAME --location=BUCKET_LOCATION
Donde:
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 de tu bucket. Por ejemplo,us-east1
.
Si la solicitud se realiza correctamente, el comando mostrará el siguiente mensaje:
Creating gs://BUCKET_NAME/...
Configura las siguientes marcas para tener un mayor control sobre la creación de tu bucket:
--project
: Especifica el ID o el número del proyecto con el que se asociará el bucket. Por ejemplo,my-project
--default-storage-class
: Especifica la clase de almacenamiento predeterminada de tu bucket. Por ejemplo,STANDARD
.--uniform-bucket-level-access
: Habilita el acceso uniforme a nivel de bucket para el bucket.
Por ejemplo:
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_ID --default-storage-class=STORAGE_CLASS --location=BUCKET_LOCATION --uniform-bucket-level-access
Para obtener una lista completa de las opciones de creación de buckets con gcloud CLI, consulta Opciones de
buckets create
.
Bibliotecas cliente
C++
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage C++.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
C#
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage C#.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Go
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Go.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Java
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Java.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Node.js
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Node.js.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
PHP
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage PHP.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Python
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Python.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Ruby
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Ruby.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Terraform
Puedes usar un recurso de Terraform para crear un bucket de almacenamiento.
API de REST
API de JSON
Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado
Authorization
.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:{ "name": "BUCKET_NAME", "location": "BUCKET_LOCATION", "storageClass": "STORAGE_CLASS", "iamConfiguration": { "uniformBucketLevelAccess": { "enabled": true }, } }
Donde:
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,STANDARD
.
Usa
cURL
para llamar a la API de JSON:curl -X POST --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-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.PROJECT_IDENTIFIER
es el ID o el número del proyecto al que se asociará el bucket. Por ejemplo,my-project
.
API de XML
Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado
Authorization
.Crea un archivo en formato XML que contenga la configuración del bucket. Consulta la documentación de XML: crea un bucket para obtener una lista completa de los parámetros de configuración. A continuación, se indican las opciones de configuración comunes que puedes incluir:
<CreateBucketConfiguration> <StorageClass>STORAGE_CLASS</StorageClass> <LocationConstraint>BUCKET_LOCATION</LocationConstraint> </CreateBucketConfiguration>
Donde:
STORAGE_CLASS
es la clase de almacenamiento predeterminada de tu bucket. Por ejemplo,STANDARD
.BUCKET_LOCATION
es la ubicación en la que deseas almacenar los datos de objeto de tu bucket. Por ejemplo,US-EAST1
Usa
cURL
para llamar a la API de XML:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-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.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
.
Si la solicitud fue exitosa, no se mostrará una respuesta.
¿Qué sigue?
- Crea una lista de depósitos en el proyecto.
- Obtén más información de los metadatos asociados a un bucket.
- Mueve o cambia el nombre de un depósito.
- Borra un depósito.
- Sube un objeto a tu bucket.
- Crea y configura buckets de forma declarativa con Kubernetes Config Connector, que te permite describir recursos de Google Cloud con las herramientas, las APIs y las configuraciones de Kubernetes. Para obtener más información, consulta la documentación de la API de Config Connector.
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