En esta página se explica cómo crear un segmento de Cloud Storage. Si no se especifica lo contrario en tu solicitud, los segmentos se crean en la US
ubicación multirregional con la clase de almacenamiento Standard Storage de forma predeterminada y tienen un periodo de conservación de eliminación suave de siete días.
Roles obligatorios
Para obtener los permisos necesarios para crear un segmento de Cloud Storage, pide a tu administrador que te conceda el rol de administrador de Storage (roles/storage.admin
) de gestión de identidades y accesos en el proyecto.
Este rol predefinido contiene el permiso necesario para crear un segmento. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:
Permisos obligatorios
storage.buckets.create
storage.buckets.enableObjectRetention
(solo es necesario si se van a habilitar las configuraciones de retención de objetos del segmento)storage.buckets.list
(solo es necesario si se crea un contenedor mediante la Google Cloud consola).resourcemanager.projects.get
(solo es necesario si se crea un contenedor con la Google Cloud consola)
También puedes obtener estos permisos con roles personalizados u otros roles predefinidos. Para ver qué roles están asociados a qué permisos, consulta Roles de gestión de identidades y accesos de Cloud Storage.
Para obtener instrucciones sobre cómo asignar roles a proyectos, consulta Gestionar el acceso a proyectos.
Crear un nuevo segmento
Si es la primera vez que creas un segmento, consulta Descubrir el almacenamiento de objetos con la Google Cloud consola o Descubrir el almacenamiento de objetos con la herramienta de línea de comandos de Google Cloud.
Para crear un contenedor con ajustes específicos o configuraciones avanzadas, sigue estos pasos:
Consola
- En la Google Cloud consola, ve a la página Segmentos de Cloud Storage.
Haz clic en
Crear.En la página Crear un segmento, introduce la información del segmento. Después de cada uno de los siguientes pasos, haz clic en Continuar para ir al siguiente paso:
En la sección Empezar, haz lo siguiente:
Introduce un nombre único a nivel global que cumpla los requisitos de nombres de segmentos.
Para añadir una etiqueta de contenedor, haz clic en la flecha de expansión para desplegar la sección Etiquetas, haz clic en add_box Añadir etiqueta y especifica un
key
y unvalue
para la etiqueta.
En la sección Elige dónde quieres almacenar los datos, haz lo siguiente:
Selecciona un Tipo de ubicación.
Usa el menú desplegable del tipo de ubicación para seleccionar una ubicación donde se almacenarán permanentemente los datos de los objetos de tu segmento.
- Si seleccionas el tipo de ubicación birregional, también puedes habilitar la replicación turbo marcando la casilla correspondiente.
Para configurar la replicación entre contenedores, seleccione Añadir replicación entre contenedores mediante el Servicio de transferencia de Storage y siga estos pasos:
Configurar la replicación entre segmentos
- En el menú Contenedor, selecciona un contenedor.
En la sección Configuración de la replicación, haga clic en Configurar para configurar los ajustes del trabajo de replicación.
Aparecerá el panel Configurar la replicación entre contenedores.
- Para filtrar los objetos que se van a replicar por prefijo de nombre de objeto, introduzca un prefijo con el que quiera incluir o excluir objetos y, a continuación, haga clic en Añadir prefijo.
- Para definir una clase de almacenamiento para los objetos replicados, selecciona una clase de almacenamiento en el menú Clase de almacenamiento. Si te saltas este paso, los objetos replicados usarán la clase de almacenamiento del segmento de destino de forma predeterminada.
- Haz clic en Listo.
En la sección Elige cómo quieres almacenar tus datos, haz lo siguiente:
- Selecciona una clase de almacenamiento predeterminada para el segmento o Autoclass para gestionar automáticamente la clase de almacenamiento de los datos del segmento.
En la sección Optimizar el almacenamiento para cargas de trabajo con gran cantidad de datos, haga lo siguiente:
Para habilitar el espacio de nombres jerárquico, selecciona Habilitar espacio de nombres jerárquico en este segmento.
Para habilitar Caché en cualquier lugar, selecciona Habilitar caché en cualquier lugar.
.Para crear cachés, haz clic en Configurar.
En el cuadro de diálogo Configurar ajustes de caché que aparece, haz clic en la flecha desplegable situada junto a las regiones que se muestran y selecciona las zonas en las que quieras crear cachés.
Haz clic en Listo.
Haz clic en Continuar.
En la sección Elige cómo quieres controlar el acceso a los objetos, selecciona si tu segmento aplica o no la prevención del acceso público y elige un modelo de control de acceso para los objetos del segmento.
En la sección Elige cómo proteger los datos de los objetos, haz lo siguiente:
Seleccione cualquiera de las opciones de Protección de datos que quiera definir para su contenedor.
Para habilitar la eliminación lógica, haga clic en la flecha del desplegable Política de eliminación lógica y especifique el número de días que quiere conservar los objetos después de eliminarlos.
Para elegir cómo se cifrarán los datos de los objetos, haga clic en la flecha del desplegable cifrado de datos.
Cifrado de datos y seleccione un método de
Haz clic en Crear.
Para saber cómo obtener información detallada sobre los errores de las operaciones de Cloud Storage en la consola, consulta la sección Solución de problemas. Google Cloud
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 dar al segmento, que está sujeto a los requisitos de nomenclatura. Por ejemplo,my-bucket
.BUCKET_LOCATION
es la ubicación de tu segmento. Por ejemplo,US
.
Si la solicitud se realiza correctamente, el comando devuelve el siguiente mensaje:
Creating gs://BUCKET_NAME/...
Define las siguientes marcas para tener más control sobre la creación de tu segmento:
--project
: especifica el ID o el número del proyecto al que se asociará tu cubo. Por ejemplo,my-project
.--default-storage-class
: especifica la clase de almacenamiento predeterminada de tu segmento. Por ejemplo,STANDARD
.--uniform-bucket-level-access
: habilita el acceso uniforme a nivel de segmento en tu segmento.--soft-delete-duration
: especifica la duración de la retención de la eliminación no definitiva, que es el número de días que quieres conservar los objetos después de que se eliminen. Por ejemplo,10d
.
Por ejemplo:
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_ID --default-storage-class=STORAGE_CLASS --location=BUCKET_LOCATION --uniform-bucket-level-access --soft-delete-duration=RETENTION_DURATION
Para ver una lista completa de las opciones de creación de segmentos, usa la CLI de gcloud. Consulta las opciones de
buckets create
.Tener instalada e inicializadala CLI de gcloud, que te permite generar un token de acceso para el encabezado
Authorization
.Crea un archivo JSON que contenga los ajustes del segmento, que debe incluir un
name
para el segmento. Consulta la documentación de Buckets:Insert para ver la lista completa de ajustes. Estos son los ajustes habituales que puedes incluir:{ "name": "BUCKET_NAME", "location": "BUCKET_LOCATION", "storageClass": "STORAGE_CLASS", "iamConfiguration": { "uniformBucketLevelAccess": { "enabled": true }, } }
Donde:
BUCKET_NAME
es el nombre que quieres dar al segmento, sujeto a los requisitos de nomenclatura. Por ejemplo,my-bucket
.BUCKET_LOCATION
es la ubicación en la que quieres almacenar los datos de los objetos de tu segmento. Por ejemplo,US
.STORAGE_CLASS
es la clase de almacenamiento predeterminada de tu segmento. Por ejemplo,STANDARD
.
Usa
cURL
para llamar a la API 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 has creado en el paso 2.PROJECT_IDENTIFIER
es el ID o el número del proyecto al que se asociará el contenedor. Por ejemplo,my-project
.
Tener instalada e inicializadala CLI de gcloud, que te permite generar un token de acceso para el encabezado
Authorization
.Crea un archivo XML que contenga los ajustes del segmento. Consulta la documentación sobre XML: Crear un contenedor para ver una lista completa de ajustes. A continuación se indican algunos ajustes habituales que puedes incluir:
<CreateBucketConfiguration> <StorageClass>STORAGE_CLASS</StorageClass> <LocationConstraint>BUCKET_LOCATION</LocationConstraint> </CreateBucketConfiguration>
Donde:
STORAGE_CLASS
es la clase de almacenamiento predeterminada de tu segmento. Por ejemplo,STANDARD
.BUCKET_LOCATION
es la ubicación en la que quieres almacenar los datos de los objetos de tu segmento. Por ejemplo,US
.
Usa
cURL
para llamar a la API 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 has creado en el paso 2.PROJECT_ID
es el ID del proyecto al que se asociará el contenedor. Por ejemplo,my-project
.BUCKET_NAME
es el nombre que quieres dar al segmento, sujeto a los requisitos de nomenclatura. Por ejemplo,my-bucket
.
Si la solicitud se ha realizado correctamente, no se devuelve ninguna respuesta.
Bibliotecas de cliente
C++
Para obtener más información, consulta la documentación de referencia de la API C++ de Cloud Storage.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
C#
Para obtener más información, consulta la documentación de referencia de la API C# de Cloud Storage.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Go
Para obtener más información, consulta la documentación de referencia de la API Go de Cloud Storage.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Java
Para obtener más información, consulta la documentación de referencia de la API Java de Cloud Storage.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Node.js
Para obtener más información, consulta la documentación de referencia de la API Node.js de Cloud Storage.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
PHP
Para obtener más información, consulta la documentación de referencia de la API PHP de Cloud Storage.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Python
Para obtener más información, consulta la documentación de referencia de la API Python de Cloud Storage.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Ruby
Para obtener más información, consulta la documentación de referencia de la API Ruby de Cloud Storage.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Terraform
Puedes usar un recurso de Terraform para crear un segmento de almacenamiento.
APIs REST
API JSON
API XML
Siguientes pasos
- Mostrar los segmentos de un proyecto.
- Consulta información sobre los metadatos asociados a un segmento.
- Mover un segmento o cambiarle el nombre
- Eliminar un segmento
- Sube un objeto a tu segmento.
- Crea y configura contenedores de forma declarativa con Kubernetes Config Connector, que te permite describir recursos Google Cloud con herramientas, APIs y configuraciones de Kubernetes. Para obtener más información, consulta la documentación de la API de Config Connector.
Pruébalo
Si es la primera vez que utilizas Google Cloud, crea una cuenta para evaluar el rendimiento de Cloud Storage en situaciones reales. Los nuevos clientes también reciben 300 USD en crédito gratuito para ejecutar, probar y desplegar cargas de trabajo.
Probar Cloud Storage gratis