En esta página, se describe cómo crear, enumerar y borrar buckets con el espacio de nombres jerárquico habilitado.
Crea un bucket
En esta sección, se describe cómo crear un bucket con el espacio de nombres jerárquico habilitado.
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 alpha storage buckets create
:gcloud alpha storage buckets create gs://BUCKET_NAME --location=BUCKET_LOCATION --uniform-bucket-level-access --enable-hierarchical-namespace
Aquí:
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
.--uniform-bucket-level-access
: Habilita el acceso uniforme a nivel de bucket para el bucket.
--enable-hierarchical-namespace
: Habilita el espacio de nombres jerárquico para el bucket. No puedes habilitar el espacio de nombres jerárquico en un bucket existente.
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á tu bucket. Por ejemplo,my-project
--default-storage-class
: Especifica la clase de almacenamiento predeterminada de tu bucket. Por ejemplo,STANDARD
.
Para obtener una lista completa de las opciones para crear buckets con Google Cloud CLI, consulta Opciones de
buckets create
.Por ejemplo:
gcloud alpha storage buckets create gs://BUCKET_NAME --project=PROJECT_ID --default-storage-class=STORAGE_CLASS --location=BUCKET_LOCATION --uniform-bucket-level-access
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 un entorno de desarrollo local.
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 un entorno de desarrollo local.
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 un entorno de desarrollo local.
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 un entorno de desarrollo local.
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 un entorno de desarrollo local.
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 un entorno de desarrollo local.
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 un entorno de desarrollo local.
API de REST
API de JSON
Tener la gcloud CLI instalada e inicializadaa fin de generar un token de acceso para el encabezado
Authorization
.Como alternativa, puedes crear un token de acceso con OAuth 2.0 Playground y, luego, incluirlo en 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: 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
.hierarchicalNamespace.enabled
se configura comoTRUE
para habilitar el espacio de nombres jerárquico para tu bucket. No puedes habilitar el espacio de nombres jerárquico en un bucket existente.- 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"
Aquí:
JSON_FILE_NAME
es el nombre del archivo JSON que contiene la configuración del bucket.PROJECT_IDENTIFIER
es el ID o número del proyecto con el que se asociará tu bucket. Por ejemplo,my-project
{ "name": "BUCKET_NAME", "location": "BUCKET_LOCATION", "storageClass": "STORAGE_CLASS", "hierarchicalNamespace": { "enabled": "BOOLEAN" }, }
Aquí:
El diseño de almacenamiento de un bucket describe cómo se organizan los objetos dentro de un bucket, ya sea en un espacio de nombres plano o en un espacio de nombres jerárquico. Para obtener instrucciones sobre cómo ver el diseño de almacenamiento de un bucket, consulta Obtén el diseño de almacenamiento de un bucket.
Para enumerar todos los buckets, sin importar su diseño de almacenamiento, sigue las instrucciones detalladas en Enumera buckets.
Puedes borrar un bucket con un espacio de nombres jerárquico habilitado de la misma manera que cualquier otro bucket. Para fines de eliminación, si un bucket habilitado con espacio de nombres jerárquico solo contiene carpetas vacías y ningún objeto ni carpetas administradas, el bucket se considera vacío. Si quieres obtener instrucciones para borrar buckets, consulta Borra buckets.
¿Qué sigue?
- Obtén información sobre los metadatos de un bucket.
- Obtén información sobre el diseño de almacenamiento de un bucket
- Información sobre las carpetas.
- Crea y administra carpetas.
- Cambia el nombre de las carpetas.
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