En esta página, se describe cómo ver y editar los metadatos asociados con los objetos almacenados en Cloud Storage.
En esta página, no se analiza la visualización ni la edición de las políticas de administración de identidades y accesos (IAM) o las Listas de control de acceso (LCA), que controlan quién puede acceder a tus datos. Consulta el uso de permisos de IAM y la creación y administración de LCA para obtener guías para llevar a cabo estas tareas.
Roles obligatorios
Para obtener los permisos necesarios para ver y editar los metadatos de los objetos, pídele a tu administrador que te otorgue el rol de usuario de objetos de almacenamiento (roles/storage.objectUser
) en el bucket.
Esta función contiene los permisos necesarios para ver y editar los metadatos de los objetos. Para ver los permisos exactos que son necesarios, expande la sección Permisos necesarios:
Permisos necesarios
storage.buckets.list
- Este permiso solo es necesario si planeas usar la consola de Google Cloud para realizar la tarea en esta página.
storage.objects.get
storage.objects.getIamPolicy
- Este permiso solo es necesario si deseas mostrar las políticas de IAM de un objeto.
storage.objects.list
storage.objects.setRetention
- Este permiso solo es necesario si deseas establecer la configuración de retención de un objeto.
storage.objects.update
También puedes obtener estos permisos con otros roles predefinidos o roles personalizados.
Para obtener instrucciones para otorgar roles a los buckets, consulta Usa IAM con buckets.
Visualiza los metadatos de objetos
Completa las siguientes instrucciones para ver los metadatos asociados con un objeto:
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 que contiene el objeto del que deseas ver los metadatos.
Se abrirá la página Detalles del bucket y se seleccionará la pestaña Objetos.
Navega hasta el objeto, que puede estar en una carpeta.
Ciertos valores de metadatos del objeto, como el tamaño y la clase de almacenamiento, se muestran junto con el nombre del objeto.
Haz clic en el nombre del objeto.
Se abre la página Detalles del objeto, en la que se muestran metadatos de objetos adicionales.
Haz clic en Editar metadatos.
La ventana de superposición que aparece muestra los valores actuales para varias claves de metadatos de más objetos, incluidos los metadatos personalizados.
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
Usa el comando gcloud storage objects describe
:
gcloud storage objects describe gs://BUCKET_NAME/OBJECT_NAME
Aquí:
BUCKET_NAME
es el nombre del bucket que contiene el objeto cuyos metadatos deseas ver. Por ejemplo,my-awesome-bucket
.OBJECT_NAME
es el nombre del objeto cuyos metadatos deseas ver. Por ejemplo,cat.jpeg
.
Si se realiza de forma correcta, la respuesta se verá como el ejemplo siguiente:
bucket: my-awesome-bucket content_type: image/png crc32c_hash: pNKjPQ== creation_time: 2024-01-26T21:33:04+0000 custom_fields: Animal: Cat Type: Cute custom_time: 1970-01-01T00:00:00+0000 etag: CMXyydSA/IMDEAE= generation: '1706304784726341' md5_hash: KCbI3PYk1aHfekIvf/osrw== metageneration: 1 name: kitten.png size: 168276 storage_class: STANDARD storage_class_update_time: 2024-01-26T21:33:04+0000 storage_url: gs://my-awesome-bucket/kitten.png#1706304784726341 update_time: 2024-01-26T21:33:04+0000
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 ver los metadatos de un objeto.
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
.Usa
cURL
para llamar a la API de JSON con una solicitud de objetoGET
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME"
Aquí:
BUCKET_NAME
es el nombre del bucket que contiene el objeto cuyos metadatos deseas ver. Por ejemplo,my-bucket
.OBJECT_NAME
es el nombre codificado en URL del objeto cuyos metadatos deseas editar. Por ejemplo,pets/dog.png
, codificado en URL comopets%2Fdog.png
.
API de XML
Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado
Authorization
.Usa
cURL
para llamar a la API de XML con una solicitud de objetoHEAD
:curl -I HEAD \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
Aquí:
BUCKET_NAME
es el nombre del bucket que contiene el objeto cuyos metadatos deseas ver. Por ejemplo,my-bucket
.OBJECT_NAME
es el nombre codificado en URL del objeto cuyos metadatos deseas editar. Por ejemplo,pets/dog.png
, codificado en URL comopets%2Fdog.png
.
Editar metadatos del objeto
Completa los siguientes pasos para editar los metadatos asociados con un objeto:
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 que contiene el objeto en el que deseas editar los metadatos.
Se abrirá la página Detalles del bucket y se seleccionará la pestaña Objetos.
Navega hasta el objeto, que puede estar en una carpeta.
Haz clic en el nombre del objeto.
Se abre la página Detalles del objeto, que muestra los metadatos de objetos.
Haz clic en el ícono de lápiz asociado con los metadatos que deseas editar, si aparece en la página.
De lo contrario, haz clic en Editar metadatos para acceder a metadatos editables adicionales.
En la ventana de superposición que aparece, edita los metadatos según sea necesario.
Para los campos de metadatos, edita el Valor.
Agrega tus metadatos personalizados con un clic en el botón add_box Agregar elemento.
Puedes editar la Clave y el Valor de tus metadatos personalizados.
Haz clic en la X asociada para borrar tus metadatos personalizados.
Cuando termines de editar los metadatos en la ventana de superposición, 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
Usa el comando gcloud storage objects update
:
gcloud storage objects update gs://BUCKET_NAME/OBJECT_NAME METADATA_FLAG
Aquí:
BUCKET_NAME
es el nombre del bucket que contiene el objeto cuyos metadatos deseas editar. Por ejemplo,my-bucket
.OBJECT_NAME
es el nombre del objeto cuyos metadatos deseas editar. Por ejemplo,pets/dog.png
METADATA_FLAG
es la marca de los metadatos que deseas editar. Por ejemplo,--content-type=image/png
.
Si se ejecuta de forma correcta, la respuesta se parece al siguiente ejemplo:
Patching gs://my-bucket/pets/dog.png#1560574162144861... Completed 1
Para obtener una lista completa de los metadatos que puedes actualizar con este comando, consulta la página de referencia del comando.
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.
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 los metadatos que deseas modificar.
Para agregar o modificar metadatos de clave fija, como
contentType
, usa el siguiente formato:{ "STANDARD_METADATA_KEY": "STANDARD_METADATA_VALUE" }
Aquí:
STANDARD_METADATA_KEY
es la clave de los metadatos que deseas agregar o modificar. Por ejemplo,Content-Type
.STANDARD_METADATA_VALUE
es el valor de los metadatos que deseas agregar o modificar. Por ejemplo,image/png
.
Para agregar o modificar metadatos personalizados, usa el siguiente formato:
{ "metadata": { "CUSTOM_METADATA_KEY": "CUSTOM_METADATA_VALUE" } }
Aquí:
CUSTOM_METADATA_KEY
es la clave de metadatos personalizados que deseas agregar o modificar. Por ejemplo,dogbreed
.CUSTOM_METADATA_VALUE
es el valor que deseas asociar a la clave de metadatos personalizados. Por ejemplo,shibainu
.
Para borrar una entrada de metadatos personalizados, usa el siguiente formato:
{ "metadata": { "CUSTOM_METADATA_KEY": null } }
Aquí:
CUSTOM_METADATA_KEY
es la clave de los metadatos personalizados que deseas borrar. Por ejemplo,dogbreed
.
Usa
cURL
para llamar a la API de JSON con una solicitud de objetoPATCH
: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/o/OBJECT_NAME"
Aquí:
JSON_FILE_NAME
es la ruta de acceso del archivo que creaste en el paso 2.BUCKET_NAME
es el nombre del bucket que contiene el objeto cuyos metadatos deseas editar. Por ejemplo,my-bucket
.OBJECT_NAME
es el nombre codificado en URL del objeto cuyos metadatos deseas editar. Por ejemplo,pets/dog.png
, codificado en URL comopets%2Fdog.png
.
Ten en cuenta que también puedes cambiar los metadatos de un objeto con una solicitud de objeto UPDATE
. Cuando se usa este método, cualquier metadato que no se especifique de forma explícita en la solicitud se quita de los metadatos del objeto.
API de XML
Cuando trabajas con la API de XML, los metadatos solo pueden configurarse en el momento en que se escribe el objeto, como cuando se lo sube, mueve o reemplaza. Sigue las instrucciones como las de subir un objeto con los siguientes lineamientos:
Agrega
-H "METADATA_KEY:METADATA_VALUE"
al encabezado de la solicitud para cada valor de metadatos que configures. Por ejemplo,-H "Content-Type:image/png"
.Agrega el prefijo
x-goog-meta-
a cualquier valor de metadatos personalizado. Un ejemplo de"METADATA_KEY:METADATA_VALUE"
personalizado es"x-goog-meta-dogbreed:shibainu"
.
Para obtener más información, consulta cómo subir un objeto para XML.
¿Qué sigue?
- Obtén más información sobre metadatos asociados a un objeto.
- Obtén metadatos de buckets.
- Cambia la clase de almacenamiento de un objeto
- Agrega una retención a un objeto.
- Obtén información sobre cómo usar las condiciones previas de solicitud para garantizar que los metadatos de objeto no cambien entre solicitudes.