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
-
En la consola de Google Cloud, activa Cloud Shell.
En la parte inferior de la consola de Google Cloud, se inicia una sesión de Cloud Shell en la que se muestra una ventana de línea de comandos. Cloud Shell es un entorno de shell con Google Cloud CLI ya instalada y con valores ya establecidos para el proyecto actual. La sesión puede tardar unos segundos en inicializarse.
-
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.
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.
APIs 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.- 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í:
Enumera un bucket
Enumerar los buckets con el espacio de nombres jerárquico habilitado usa el mismo proceso que para enumerar un bucket sin el espacio de nombres jerárquico habilitado. Si quieres obtener instrucciones para enumerar buckets, consulta Enumera los buckets.
Borrar un bucket
Puedes borrar un bucket si solo contiene carpetas vacías y no tiene objetos ni carpetas administradas.
El proceso para borrar buckets con el espacio de nombres jerárquico habilitado es el mismo que el proceso para borrar buckets sin el espacio de nombres jerárquico habilitado. 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