En esta página, se muestra cómo agregar, modificar, quitar y ver las etiquetas configuradas en un bucket de Cloud Storage.
Roles obligatorios
Para obtener los permisos necesarios para agregar y administrar etiquetas de bucket, pídele a tu administrador que te otorgue el rol de IAM de Administrador de almacenamiento (roles/storage.admin
) en el bucket.
Este rol predefinido contiene los permisos necesarios para agregar y administrar etiquetas de bucket. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
storage.buckets.get
storage.buckets.list
- Este permiso solo es necesario si planeas usar la consola de Google Cloud para ejecutar las instrucciones en esta página.
storage.buckets.update
También puedes obtener estos permisos con roles personalizados.
Para obtener instrucciones para otorgar roles a los buckets, consulta Usa IAM con buckets.
Agrega, modifica o quita las etiquetas de un bucket
Console
- En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.
En la lista de buckets, haz clic en el nombre del bucket al que deseas agregar, modificar o quitar etiquetas.
En la página de detalles del bucket haz clic en la pestaña Configuración.
Haz clic en el ícono Editar (edit) en Etiquetas.
Aparecerá la ventana del editor de etiquetas.
Para agregar una etiqueta, haz clic en el botón add_box Agregar etiqueta y especifica una
key
y unvalue
para tu etiqueta.Para modificar una etiqueta existente, haz clic en su Valor y, luego, ingresa un valor nuevo.
Para quitar una etiqueta, haz clic en el ícono de la papelera asociado con la etiqueta que deseas quitar.
Haz clic en Guardar.
Para obtener información sobre 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
Para agregar una etiqueta nueva o actualizar una etiqueta existente, usa el comando gcloud storage buckets update
con la marca --update-labels
. Por ejemplo:
gcloud storage buckets update gs://BUCKET_NAME --update-labels=KEY_1=VALUE_1
Donde
BUCKET_NAME
es el nombre del bucket al que se aplica la etiqueta. Por ejemplo,my-bucket
.KEY_1
es el nombre de la clave de tu etiqueta. Por ejemplo,pet
.VALUE_1
es el valor de tu etiqueta. Por ejemplo,dog
.
Para borrar una etiqueta existente, usa la marca -remove-labels
. Por ejemplo:
gcloud storage buckets update gs://BUCKET_NAME --remove-labels=KEY_1
Puedes cambiar varias etiquetas con los comandos anteriores con la inclusión de las etiquetas en una lista separada por comas dentro de la marca relevante. Por ejemplo, --update-labels=blue-key=cyan,red-key=ruby
.
Para quitar todas las etiquetas adjuntas a un bucket, usa el siguiente comando:
gcloud storage buckets update gs://BUCKET_NAME --clear-labels
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.
En el siguiente ejemplo, se agrega la etiqueta especificada a un bucket, o se modifica la etiqueta si ya existe para este:
En el siguiente ejemplo, se quita la etiqueta especificada de un bucket:
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.
En el siguiente ejemplo, se agrega la etiqueta especificada a un bucket, o se modifica la etiqueta si ya existe para este:
En el siguiente ejemplo, se quita la etiqueta especificada de un bucket:
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.
En el siguiente ejemplo, se agrega la etiqueta especificada a un bucket, o se modifica la etiqueta si ya existe para este:
En el siguiente ejemplo, se quita la etiqueta especificada de un bucket:
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.
En el siguiente ejemplo, se agrega la etiqueta especificada a un bucket, o se modifica la etiqueta si ya existe para este:
En el siguiente ejemplo, se quita la etiqueta especificada de un bucket:
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.
En el siguiente ejemplo, se agrega la etiqueta especificada a un bucket, o se modifica la etiqueta si ya existe para este:
En el siguiente ejemplo, se quita la etiqueta especificada de un bucket:
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.
En el siguiente ejemplo, se agrega la etiqueta especificada a un bucket, o se modifica la etiqueta si ya existe para este:
En el siguiente ejemplo, se quita la etiqueta especificada de un bucket:
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.
En el siguiente ejemplo, se agrega la etiqueta especificada a un bucket, o se modifica la etiqueta si ya existe para este:
En el siguiente ejemplo, se quita la etiqueta especificada de un bucket:
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.
En el siguiente ejemplo, se agrega la etiqueta especificada a un bucket, o se modifica la etiqueta si ya existe para este:
En el siguiente ejemplo, se quita la etiqueta especificada de un bucket:
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 siguiente información:
{ "labels": { "KEY_1": "VALUE_1" } }
Donde
KEY_1
es el nombre de la clave de tu etiqueta. Por ejemplo,pet
.VALUE_1
es el valor de tu etiqueta. Por ejemplo,dog
. Si deseas quitar una clave, usanull
en lugar de"<var>VALUE_1</var>"
.
Usa
cURL
para llamar a la API de JSON con una solicitud de bucketPATCH
:curl -X PATCH --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/BUCKET_NAME?fields=labels"
Donde:
JSON_FILE_NAME
es la ruta de acceso del archivo JSON que creaste en el paso 2.BUCKET_NAME
es el nombre del bucket al que se aplica la etiqueta. Por ejemplo,my-bucket
.
Puede agregar, editar o quitar varios pares key:value
en una solicitud.
API de XML
Tener la gcloud CLI instalada e inicializadapara 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 XML que contenga la siguiente información:
<Tagging> <TagSet> <Tag> <Key>KEY_1</Key> <Value>VALUE_1</Value> </Tag> </TagSet> </Tagging>
Donde:
KEY_1
es el nombre de la clave de tu etiqueta. Por ejemplo,pet
.VALUE_1
es el valor de tu etiqueta. Por ejemplo,dog
.
Ten en cuenta que puedes agregar varios elementos
<Tag>
en una solicitud. Si deseas quitar todas las etiquetas de un bucket, usa un solo elemento vacío<Tag>
en el archivo:<Tagging> <TagSet> <Tag> </Tag> </TagSet> </Tagging>
Usa
cURL
para llamar a la API de XML con una solicitud de bucketPUT
y un parámetro de string de consultatagging
:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?tagging"
Donde:
XML_FILE_NAME
es la ruta de acceso del archivo XML que creaste en el paso 2.BUCKET_NAME
es el nombre del bucket al que se aplica la etiqueta. Por ejemplo,my-bucket
.
Ve las etiquetas del bucket
Console
- En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.
Haz clic en el nombre del bucket cuyas etiquetas deseas ver.
Haz clic en la pestaña Configuración.
Las etiquetas establecidas en el bucket se enumeran en el campo Etiquetas.
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
Usa el comando gcloud storage buckets describe
con la marca --format
:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(labels)"
En el ejemplo anterior, BUCKET_NAME
es el nombre del bucket cuyas etiquetas deseas ver. Por ejemplo, my-bucket
.
Si se realiza de forma correcta y hay etiquetas para el bucket, la respuesta es similar a la siguiente:
labels: red-key: ruby blue-key: cyan
Si se ejecuta de forma correcta y no existen etiquetas para el bucket, la respuesta es similar a la siguiente:
null
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.
Para ver las etiquetas de un bucket, sigue las instrucciones para mostrar los metadatos de un bucket y busca el campo de etiqueta en la respuesta.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.
Para ver las etiquetas de un bucket, sigue las instrucciones para mostrar los metadatos de un bucket y busca el campo de etiqueta en la respuesta.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.
Para ver las etiquetas de un bucket, sigue las instrucciones para mostrar los metadatos de un bucket y busca el campo de etiqueta en la respuesta.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.
Para ver las etiquetas de un bucket, sigue las instrucciones para mostrar los metadatos de un bucket y busca el campo de etiqueta en la respuesta.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.
Para ver las etiquetas de un bucket, sigue las instrucciones para mostrar los metadatos de un bucket y busca el campo de etiqueta en la respuesta.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.
Para ver las etiquetas de un bucket, sigue las instrucciones para mostrar los metadatos de un bucket y busca el campo de etiqueta en la respuesta.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.
Para ver las etiquetas de un bucket, sigue las instrucciones para mostrar los metadatos de un bucket y busca el campo de etiqueta en la respuesta.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.
Para ver las etiquetas de un bucket, sigue las instrucciones para mostrar los metadatos de un bucket y busca el campo de etiqueta en la respuesta.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
.Usa
cURL
para llamar a la API de JSON con una solicitud de bucketGET
que incluya un parámetro de string de consultafields=labels
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=labels"
En el ejemplo anterior,
BUCKET_NAME
es el nombre del bucket cuyas etiquetas deseas ver. Por ejemplo,my-bucket
.
La respuesta se ve como el siguiente ejemplo:
{ "labels" : { (your_label_key): your_label_value }, }
API de XML
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
.Usa
cURL
para llamar a la API de XML con una solicitud de bucketGET
y un parámetro de string de consultatagging
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?tagging"
En el ejemplo anterior,
BUCKET_NAME
es el nombre del bucket cuyas etiquetas deseas ver. Por ejemplo,my-bucket
.
La respuesta se ve como el siguiente ejemplo:
<Tagging> <TagSet> <Tag> <Key>your_label_key</Key> <Value>your_label_value</Value> </Tag> </TagSet> </Tagging>
¿Qué sigue?
- Obtén más información sobre las etiquetas de bucket.
- Obtén metadatos de buckets adicionales.