Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ Object Storage Service/ Referencia de la API/ Las API/ Operaciones en objetos/ Modificación de metadatos de objetos

Actualización más reciente 2024-09-18 GMT+08:00

Ver PDF

Modificación de metadatos de objetos

Funciones

Esta operación modifica, elimina o agrega metadatos a los objetos cargados en un bucket.

Sintaxis de solicitud

    
         PUT /ObjectName?metadata HTTP/1.1 
Host: bucketname.obs.region.myhuaweicloud.com Content-Type: application/xml 
Content-Length: length
Authorization: authorization
Date: date
<Optional Additional Header> 
<object Content>

Parámetros de solicitud

**Tabla 1** Parámetros de solicitud
Parámetro	Descripción	Obligatorio
versionId	ID de versión del objeto Tipo: string	No

Encabezados de solicitud

OBS admite los seis encabezados de solicitud HTTP: Cache-Control, Expires, Content-Encoding, Content-Disposition, Content-Type y Content-Language. Guarda estos valores de encabezado en los metadatos del objeto. Cuando se descarga o consulta el objeto, los valores guardados se establecen para los encabezados HTTP correspondientes y se devuelven al cliente.

**Tabla 2** Encabezados de solicitud
Encabezado	Descripción	Obligatorio
x-obs-metadata-directive	Indicador de operación de metadatos. El valor puede ser REPLACE_NEW o REPLACE. REPLACE_NEW: Se reemplazan los metadatos que tienen un valor existente. Se asigna un valor a los metadatos que no tienen un valor. Los metadatos que no se especifican permanecen sin cambios. (Nota: se reemplaza un encabezado con metadatos personalizados.) REPLACE: utilice el campo encabezado incluido en la solicitud actual para reemplazar los metadatos originales. Los metadatos que no se especifican (excepto x-obs-storage-class) se eliminarán. Tipo: string	Sí
Cache-Control	Especifica el comportamiento de caché de la página web cuando se descarga el objeto. Tipo: string	No
Content-Disposition	Especifica el nombre del objeto cuando se descarga. Tipo: string	No
Content-Encoding	Especifica el formato de codificación de contenido cuando se descarga un objeto. Tipo: string	No
Content-Language	Especifica el formato de idioma de contenido cuando se descarga un objeto. Tipo: string	No
Content-Type	Tipo de archivo de objeto. Tipo: string	No
Expires	Especifica el tiempo de caducidad de la caché de la página Web cuando se descarga el objeto. Tipo: string	No
x-obs-website-redirect-location	Cuando el bucket está configurado con la redirección de sitio web, la solicitud para obtener el objeto puede redirigirse a otro objeto o a una URL externa en el bucket. En el siguiente ejemplo, el encabezado de solicitud establece la redirección a un objeto (anotherPage.html) en el mismo bucket: x-obs-website-redirect-location:/anotherPage.html En el ejemplo siguiente, el encabezado de solicitud establece la redirección del objeto a una URL externa: x-obs-website-redirect-location:http://www.example.com/ Tipo: string Restricción: el valor debe tener el prefijo de una barra diagonal (/), http:// o https://. La longitud del valor no puede superar los 2 KB.	No
x-obs-storage-class	Especifica la clase de almacenamiento de un objeto. Tipo: string Opciones de clase de almacenamiento: STANDARD (Standard), WARM (Infrequent Access), COLD (Archive). Los valores distinguen entre mayúsculas y minúsculas. Ejemplo: x-obs-storage-class: STANDARD	No
x-obs-meta-*	Un encabezado de mensaje que comienza con x-obs-meta- se puede agregar a una solicitud para agregar metadatos personalizados para la gestión de objetos. Los metadatos personalizados se devolverán en el encabezado de respuesta cuando recupere o consulte los metadatos del objeto. Para obtener más información, consulte Metadatos de objetos definidos por el usuario. Tipo: string Ejemplo: x-obs-meta-test: test metadata	No
x-obs-expires	Specifies when an object expires. It is measured in days. Once the object expires, it is automatically deleted. Type: integer Example: x-obs-expires:3	No

Elementos de solicitud

Esta solicitud no implica ningún elemento.

Sintaxis de respuesta

    
         HTTP/1.1 status_code
Date: date
Content-Length: length
Etag: etag
Last-Modified: time

Encabezados de respuesta

**Tabla 3** Parámetros de cabecera de respuesta adicionales
Encabezado	Descripción
x-obs-metadata-directive	Indicador de operación de metadatos. El valor puede ser REPLACE_NEW o REPLACE. Tipo: string
Cache-Control	Especifica el comportamiento de caché de la página web cuando se descarga el objeto. Si una solicitud incluye este campo de encabezado, el mensaje de respuesta debe contener este campo de encabezado. Tipo: string
Content-Disposition	Especifica el nombre del objeto cuando se descarga. Si una solicitud incluye este campo de encabezado, el mensaje de respuesta debe contener este campo de encabezado. Tipo: string
Content-Encoding	Especifica el formato de codificación de contenido cuando se descarga un objeto. Si una solicitud incluye este campo de encabezado, el mensaje de respuesta debe contener este campo de encabezado. Tipo: string
Content-Language	Especifica el formato de idioma de contenido cuando se descarga un objeto. Si una solicitud incluye este campo de encabezado, el mensaje de respuesta debe contener este campo de encabezado. Tipo: string
Expires	Especifica el tiempo de caducidad de la caché de la página Web cuando se descarga el objeto. Si una solicitud incluye este campo de encabezado, el mensaje de respuesta debe contener este campo de encabezado. Tipo: string
x-obs-website-redirect-location	Cuando el bucket está configurado con la redirección de sitio web, la solicitud para obtener el objeto puede redirigirse a otro objeto o a una URL externa en el bucket. Si una solicitud incluye este campo de encabezado, el mensaje de respuesta debe contener este campo de encabezado. Tipo: string
x-obs-storage-class	Especifica la clase de almacenamiento de un objeto. Si una solicitud incluye este campo de encabezado, el mensaje de respuesta debe contener este campo de encabezado. Tipo: string
x-obs-meta-*	Los metadatos personalizados se utilizan para gestionar objetos de manera personalizada. Si una solicitud incluye este campo de encabezado, el mensaje de respuesta debe contener este campo de encabezado. Tipo: string
x-obs-expires	Specifies when an object expires. It is measured in days. Si una solicitud incluye este campo de encabezado, el mensaje de respuesta debe contener este campo de encabezado. Type: integer

Elementos de respuesta

Esta respuesta no contiene elementos.

Respuestas de error

No se devuelven respuestas de error especiales. Para obtener más información sobre las respuestas de error, consulte Tabla 2.

Ejemplo de solicitud: Adición de metadatos para un objeto

Agregue los siguientes metadatos al objeto: Content-Type:application/zip y x-obs-meta-test:meta.

    
         PUT /object?metadata HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 14:24:33 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:NxtSMS0jaVxlLnxlO9awaMTn47s=
x-obs-metadata-directive:REPLACE_NEW
Content-Type:application/zip
x-obs-meta-test:meta

Ejemplo de respuesta: Adición de metadatos para un objeto

    
         HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 8DF400000163D3E4BB5905C41B6E65B6
Accept-Ranges: bytes
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSD3nAiTaBoeyt9oHp9vTYtXnLDmwV6D
Date: WED, 01 Jul 2015 04:19:21 GMT
Content-Length: 0
x-obs-metadata-directive:REPLACE_NEW
x-obs-meta-test:meta

Ejemplo de solicitud: Edición de metadatos de un objeto

Si los metadatos x-obs-meta-test:testmeta existen en el objeto y el valor de x-obs-storage-class es WARM, cambiar los metadatos x-obs-meta-test del objeto a newmeta y cambiar x-obs-storage-class a COLD.

    
         PUT /object?metadata HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 14:24:33 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:NxtSMS0jaVxlLnxlO9awaMTn47s=
x-obs-metadata-directive:REPLACE_NEW
x-obs-meta-test:newmeta
x-obs-storage-class:COLD

Ejemplo de respuesta: Edición de metadatos de un objeto

    
         HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 8DF400000163D3E4BB5905C41B6E65B6
Accept-Ranges: bytes
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSD3nAiTaBoeyt9oHp9vTYtXnLDmwV6D
Date: WED, 01 Jul 2015 04:19:21 GMT
Content-Length: 0
x-obs-metadata-directive:REPLACE_NEW
x-obs-meta-test:newmeta
x-obs-storage-class:COLD

Ejemplo de solicitud: Eliminar metadatos de un objeto

Los metadatos x-obs-meta-test:newmeta y Content-Type:application/zip existen en el objeto, y elimina x-obs-meta-test.

    
         PUT /object?metadata HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 14:24:33 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:NxtSMS0jaVxlLnxlO9awaMTn47s=
x-obs-metadata-directive:REPLACE
Content-Type:application/zip

Ejemplo de respuesta: eliminación de metadatos de un objeto

    
         HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 8DF400000163D3E4BB5905C41B6E65B6
Accept-Ranges: bytes
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSD3nAiTaBoeyt9oHp9vTYtXnLDmwV6D
Date: WED, 01 Jul 2015 04:19:21 GMT
Content-Length: 0
x-obs-metadata-directive:REPLACE