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/ Guía del usuario/ Gestión de objetos/ Gestión de metadatos de objetos

Actualización más reciente 2023-04-27 GMT+08:00

Ver PDF

Gestión de metadatos de objetos

Escenario de la aplicación

Los metadatos de objeto son un conjunto de pares nombre-valor que describen el objeto y se utilizan para la gestión de objetos.

Actualmente, solo se admiten los metadatos definidos por el sistema.

Los metadatos definidos por el sistema se clasifican en los siguientes tipos: controlados por el sistema y controlados por el usuario. Por ejemplo, los metadatos como Last-Modified son controlados por el sistema y no pueden ser modificados. Puede modificar los metadatos como ContentLanguage a través de la API. Los metadatos que se pueden modificar se describen de la siguiente manera:

**Tabla 1** Metadatos de OBS
Nombre	Descripción
ContentDisposition	Proporciona un nombre de archivo predeterminado para el objeto que se está solicitando. Cuando se descarga o se accede a un objeto, el archivo con el nombre de archivo predeterminado se muestra directamente en el explorador o se muestra un cuadro de diálogo de descarga si se accede al archivo. Por ejemplo, seleccione ContentDisposition como nombre de metadatos e introduzca attachment;filename="testfile.xls" como valor de metadatos de un objeto. Si tiene acceso al objeto a través de un vínculo, se muestra directamente un cuadro de diálogo para descargar objetos y el nombre del objeto se cambia a testfile.xls. Para obtener más información, consulte la definición de ContentDisposition en HTTP.
ContentLanguage	Indica el idioma o idiomas destinados a la audiencia. Por lo tanto, un usuario puede diferenciarse de acuerdo con el idioma preferido del usuario. Para obtener más información, consulte la definición de ContentLanguage en HTTP.
WebsiteRedirectLocation	Redirecciona un objeto a otro objeto o a una URL externa. La función de redirección se implementa utilizando el alojamiento web estático. Por ejemplo, puede realizar las siguientes operaciones para implementar la redirección de objetos: Establezca los metadatos del objeto testobject.html en el directorio raíz del bucket testbucket. Seleccione WebsiteRedirectLocation en Name y escriba http://www.example.com en Value. NOTA: OBS solo admite la redirección de objetos en el directorio raíz de un bucket. Configure el alojamiento de sitios web estáticos para el bucket testbucket y establezca el objeto testobject.html en el bucket como la página de inicio predeterminada del sitio web estático alojado. Si accede al objeto testobject.html a través del enlace URL proporcionado en la página Configure Static Website Hosting, la solicitud de acceso se redirige a http://www.example.com.
ContentEncoding	Formato de codificación de contenido cuando se descarga un objeto. Las opciones son las siguientes: Standard: compress, deflate, exi, identity, gzip, y pack200-gzip Otros: br, bzip2, lzma, peerdist, sdch, xpress, xz
CacheControl	Comportamiento de caché de la página web cuando se descarga el objeto especificado. Capacidad de caché: public, private, no-cache, and only-if-cached Tiempo de caducidad: *max-age=<seconds*>, s-maxage=<seconds>, max-stale[=<seconds>], min-fresh=<seconds>, stale-while-revalidate=<seconds>, stale-if-error=<seconds> Re-verificación y recarga: must-revalidate, proxy-revalidate, immutable Otros: no-store, no-transform**
Expires	Tiempo de caducidad de caché (GMT)
ContentType	Tipo de archivo de un objeto. Para más detalles, consulte Tipo de contenido de metadatos de objeto.

Cuando el control de versiones está habilitado para un bucket, puede establecer metadatos para objetos que son de la Versión más reciente, pero no puede establecer metadatos para objetos que son de la Versión histórica.
No se pueden establecer metadatos de objeto para un objeto Archive.

Tipo de contenido de metadatos de objeto

Cuando se carga un objeto en OBS a través de la Consola OBS o una herramienta, el sistema hace coincidir automáticamente el valor de Content-Type basándose en la extensión de nombre de archivo del objeto. Cuando se accede a un objeto a través de un explorador Web, el sistema especifica una aplicación para abrir el objeto de acuerdo con el valor de Content-Type. Puede modificar el Content-Type de un objeto basándose en su extensión de nombre de archivo.

Si carga un objeto llamando a una API, especifique el valor de Content-Type porque el sistema no coincide automáticamente con el valor de Content-Type.

**Tabla 2** Valores comunes de tipo de contenido
Extensión de nombre de archivo	Content-Type	Extensión de nombre de archivo	Content-Type
* (corriente binaria, que no conoce el tipo de archivo que se va a descargar)	application/octet-stream	.tif	image/tiff
.001	application/x-001	.301	application/x-301
.323	text/h323	.906	application/x-906
.907	drawing/907	.a11	application/x-a11
.acp	audio/x-mei-aac	.ai	application/postscript
.aif	audio/aiff	.aifc	audio/aiff
.aiff	audio/aiff	.anv	application/x-anv
.asa	text/asa	.asf	video/x-ms-asf
.asp	text/asp	.asx	video/x-ms-asf
.au	audio/basic	.avi	video/avi
.awf	application/vnd.adobe.workflow	.biz	text/xml
.bmp	application/x-bmp	.bot	application/x-bot
.c4t	application/x-c4t	.c90	application/x-c90
.cal	application/x-cals	.cat	application/vnd.ms-pki.seccat
.cdf	application/x-netcdf	.cdr	application/x-cdr
.cel	application/x-cel	.cer	application/x-x509-ca-cert
.cg4	application/x-g4	.cgm	application/x-cgm
.cit	application/x-cit	.class	java/*
.cml	text/xml	.cmp	application/x-cmp
.cmx	application/x-cmx	.cot	application/x-cot
.crl	application/pkix-crl	.crt	application/x-x509-ca-cert
.csi	application/x-csi	.css	text/css
.cut	application/x-cut	.dbf	application/x-dbf
.dbm	application/x-dbm	.dbx	application/x-dbx
.dcd	text/xml	.dcx	application/x-dcx
.der	application/x-x509-ca-cert	.dgn	application/x-dgn
.dib	application/x-dib	.dll	application/x-msdownload
.doc	application/msword	.dot	application/msword
.drw	application/x-drw	.dtd	text/xml
.dwf	Model/vnd.dwf	.dwf	application/x-dwf
.dwg	application/x-dwg	.dxb	application/x-dxb
.dxf	application/x-dxf	.edn	application/vnd.adobe.edn
.emf	application/x-emf	.eml	message/rfc822
.ent	text/xml	.epi	application/x-epi
.eps	application/x-ps	.eps	application/postscript
.etd	application/x-ebx	.exe	application/x-msdownload
.fax	image/fax	.fdf	application/vnd.fdf
.fif	application/fractals	.fo	text/xml
.frm	application/x-frm	.g4	application/x-g4
.gbr	application/x-gbr	.	application/x-
.gif	image/gif	.gl2	application/x-gl2
.gp4	application/x-gp4	.hgl	application/x-hgl
.hmr	application/x-hmr	.hpg	application/x-hpgl
.hpl	application/x-hpl	.hqx	application/mac-binhex40
.hrf	application/x-hrf	.hta	application/hta
.htc	text/x-component	.htm	text/html
.html	text/html	.htt	text/webviewhtml
.htx	text/html	.icb	application/x-icb
.ico	image/x-icon	.ico	application/x-ico
.iff	application/x-iff	.ig4	application/x-g4
.igs	application/x-igs	.iii	application/x-iphone
.img	application/x-img	.ins	application/x-internet-signup
.isp	application/x-internet-signup	.IVF	video/x-ivf
.java	java/*	.jfif	image/jpeg
.jpe	image/jpeg	.jpe	application/x-jpe
.jpeg	image/jpeg	.jpg	image/jpeg
.jpg	application/x-jpg	.js	application/x-javascript
.jsp	text/html	.la1	audio/x-liquid-file
.lar	application/x-laplayer-reg	.latex	application/x-latex
.lavs	audio/x-liquid-secure	.lbm	application/x-lbm
.lmsff	audio/x-la-lms	.ls	application/x-javascript
.ltr	application/x-ltr	.m1v	video/x-mpeg
.m2v	video/x-mpeg	.m3u	audio/mpegurl
.m4e	video/mpeg4	.mac	application/x-mac
.man	application/x-troff-man	.math	text/xml
.mdb	application/msaccess	.mdb	application/x-mdb
.mfp	application/x-shockwave-flash	.mht	message/rfc822
.mhtml	message/rfc822	.mi	application/x-mi
.mid	audio/mid	.midi	audio/mid
.mil	application/x-mil	.mml	text/xml
.mnd	audio/x-musicnet-download	.mns	audio/x-musicnet-stream
.mocha	application/x-javascript	.movie	video/x-sgi-movie
.mp1	audio/mp1	.mp2	audio/mp2
.mp2v	video/mpeg	.mp3	audio/mp3
.mp4	video/mp4	.mpa	video/x-mpg
.mpd	application/vnd.ms-project	.mpe	video/x-mpeg
.mpeg	video/mpg	.mpg	video/mpg
.mpga	audio/rn-mpeg	.mpp	application/vnd.ms-project
.mps	video/x-mpeg	.mpt	application/vnd.ms-project
.mpv	video/mpg	.mpv2	video/mpeg
.mpw	application/vnd.ms-project	.mpx	application/vnd.ms-project
.mtx	text/xml	.mxp	application/x-mmxp
.net	image/pnetvue	.nrf	application/x-nrf
.nws	message/rfc822	.odc	text/x-ms-odc
.out	application/x-out	.p10	application/pkcs10
.p12	application/x-pkcs12	.p7b	application/x-pkcs7-certificates
.p7c	application/pkcs7-mime	.p7m	application/pkcs7-mime
.p7r	application/x-pkcs7-certreqresp	.p7s	application/pkcs7-signature
.pc5	application/x-pc5	.pci	application/x-pci
.pcl	application/x-pcl	.pcx	application/x-pcx
.pdf	application/pdf	.pdf	application/pdf
.pdx	application/vnd.adobe.pdx	.pfx	application/x-pkcs12
.pgl	application/x-pgl	.pic	application/x-pic
.pko	application/vnd.ms-pki.pko	.pl	application/x-perl
.plg	text/html	.pls	audio/scpls
.plt	application/x-plt	.png	image/png
.png	application/x-png	.pot	application/vnd.ms-powerpoint
.ppa	application/vnd.ms-powerpoint	.ppm	application/x-ppm
.pps	application/vnd.ms-powerpoint	.ppt	application/vnd.ms-powerpoint
.ppt	application/x-ppt	.pr	application/x-pr
.prf	application/pics-rules	.prn	application/x-prn
.prt	application/x-prt	.ps	application/x-ps
.ps	application/postscript	.ptn	application/x-ptn
.pwz	application/vnd.ms-powerpoint	.r3t	text/vnd.rn-realtext3d
.ra	audio/vnd.rn-realaudio	.ram	audio/x-pn-realaudio
.ras	application/x-ras	.rat	application/rat-file
.rdf	text/xml	.rec	application/vnd.rn-recording
.red	application/x-red	.rgb	application/x-rgb
.rjs	application/vnd.rn-realsystem-rjs	.rjt	application/vnd.rn-realsystem-rjt
.rlc	application/x-rlc	.rle	application/x-rle
.rm	application/vnd.rn-realmedia	.rmf	application/vnd.adobe.rmf
.rmi	audio/mid	.rmj	application/vnd.rn-realsystem-rmj
.rmm	audio/x-pn-realaudio	.rmp	application/vnd.rn-rn_music_package
.rms	application/vnd.rn-realmedia-secure	.rmvb	application/vnd.rn-realmedia-vbr
.rmx	application/vnd.rn-realsystem-rmx	.rnx	application/vnd.rn-realplayer
.rp	image/vnd.rn-realpix	.rpm	audio/x-pn-realaudio-plugin
.rsml	application/vnd.rn-rsml	.rt	text/vnd.rn-realtext
.rtf	application/msword	.rtf	application/x-rtf
.rv	video/vnd.rn-realvideo	.sam	application/x-sam
.sat	application/x-sat	.sdp	application/sdp
.sdw	application/x-sdw	.sit	application/x-stuffit
.slb	application/x-slb	.sld	application/x-sld
.slk	drawing/x-slk	.smi	application/smil
.smil	application/smil	.smk	application/x-smk
.snd	audio/basic	.sol	text/plain
.sor	text/plain	.spc	application/x-pkcs7-certificates
.spl	application/futuresplash	.spp	text/xml
.ssm	application/streamingmedia	.sst	application/vnd.ms-pki.certstore
.stl	application/vnd.ms-pki.stl	.stm	text/html
.sty	application/x-sty	.svg	text/svg+xml
.swf	application/x-shockwave-flash	.tdf	application/x-tdf
.tg4	application/x-tg4	.tga	application/x-tga
.tif	image/tiff	.tif	application/x-tif
.tiff	image/tiff	.tld	text/xml
.top	drawing/x-top	.torrent	application/x-bittorrent
.tsd	text/xml	.txt	text/plain
.uin	application/x-icq	.uls	text/iuls
.vcf	text/x-vcard	.vda	application/x-vda
.vdx	application/vnd.visio	.vml	text/xml
.vpg	application/x-vpeg005	.vsd	application/vnd.visio
.vsd	application/x-vsd	.vss	application/vnd.visio
.vst	application/vnd.visio	.vst	application/x-vst
.vsw	application/vnd.visio	.vsx	application/vnd.visio
.vtx	application/vnd.visio	.vxml	text/xml
.wav	audio/wav	.wax	audio/x-ms-wax
.wb1	application/x-wb1	.wb2	application/x-wb2
.wb3	application/x-wb3	.wbmp	image/vnd.wap.wbmp
.wiz	application/msword	.wk3	application/x-wk3
.wk4	application/x-wk4	.wkq	application/x-wkq
.wks	application/x-wks	.wm	video/x-ms-wm
.wma	audio/x-ms-wma	.wmd	application/x-ms-wmd
.wmf	application/x-wmf	.wml	text/vnd.wap.wml
.wmv	video/x-ms-wmv	.wmx	video/x-ms-wmx
.wmz	application/x-ms-wmz	.wp6	application/x-wp6
.wpd	application/x-wpd	.wpg	application/x-wpg
.wpl	application/vnd.ms-wpl	.wq1	application/x-wq1
.wr1	application/x-wr1	.wri	application/x-wri
.wrk	application/x-wrk	.ws	application/x-ws
.ws2	application/x-ws	.wsc	text/scriptlet
.wsdl	text/xml	.wvx	video/x-ms-wvx
.xdp	application/vnd.adobe.xdp	.xdr	text/xml
.xfd	application/vnd.adobe.xfd	.xfdf	application/vnd.adobe.xfdf
.xhtml	text/html	.xls	application/vnd.ms-excel
.xls	application/x-xls	.xlw	application/x-xlw
.xml	text/xml	.xpl	audio/scpls
.xq	text/xml	.xql	text/xml
.xquery	text/xml	.xsd	text/xml
.xsl	text/xml	.xslt	text/xml
.xwd	application/x-xwd	.x_b	application/x-x_b
.sis	application/vnd.symbian.install	.sisx	application/vnd.symbian.install
.x_t	application/x-x_t	.ipa	application/vnd.iphone
.apk	application/vnd.android.package-archive	.xap	application/x-silverlight-app
.zip	application/zip	.rar	application/x-rar-compressed
.7z	application/x-7z-compressed	-	-

Metadatos de objetos definidos por el usuario

Puede agregar los metadatos definidos por el usuario cuyo nombre comienza con x-obs-meta- para una fácil gestión de objetos. Cuando recupera o consulta los metadatos del objeto, los metadatos definidos por el usuario agregados se devolverán en el encabezado de respuesta. El tamaño de los metadatos definidos por el usuario está limitado a 8 KB. Para medir el tamaño total de los metadatos definidos por el usuario, sume el número de bytes en la codificación UTF-8 de cada clave y valor.

Las claves de metadatos definidas por el usuario no distinguen entre mayúsculas y minúsculas, pero OBS las almacena en minúsculas. Los valores clave distinguen entre mayúsculas y minúsculas.

A continuación se presenta un ejemplo.

    
         PUT /key HTTP/1.1
Host: bucket01.obs.myhuaweicloud.com
x-obs-meta-Test1: Test Meta1

HEAD /Key HTTP/1.1
Host: bucket01.obs.myhuaweicloud.com
x-obs-meta-test1: Test Meta1

Tanto las claves de metadatos definidas por el usuario como sus valores deben ajustarse a los caracteres US-ASCII. Si son necesarios caracteres non-ASCII o irreconocibles, deben codificarse o decodificarse en URL o Base64 en el lado del cliente, porque el lado del servidor no realiza ninguna decodificación.

Si hay caracteres non-US-ASCII o irreconocibles en un valor y el cliente no codifica el valor, el lado del servidor codificará el valor en Base64 y encapsulará el valor usando?UTF-8?B?<base64(str)>?=. Se toma x-obs-meta-nonascii: nonasciiÄÄ como ejemplo. nonasciiÄÄ se codifica como bm9uYXNjaWnDhMOE en Base64 y la respuesta devuelta es x-obs-meta-nonascii: =?UTF-8?B?bm9uYXNjaWnDhMOE?=.

A continuación se presenta un ejemplo.

   
        PUT /key HTTP/1.1
Host: bucket01.obs.myhuaweicloud.com
x-obs-meta-nonascii: nonasciiÄÄ

HEAD /Key HTTP/1.1
Host: bucket01.obs.myhuaweicloud.com
x-obs-meta-nonascii: =?UTF-8?B?bm9uYXNjaWnDhMOE?=

¿Cómo usar esta función?

Puede utilizar la consola OBS, las API, los SDK, el navegador OBS+ u obsutil para personalizar los metadatos de los objetos.

Herramienta	Referencia
Consola de OBS	Configuración de metadatos de objeto
SDK	OBS admite kits de desarrollo de software (SDK) en varios idiomas. Para obtener más información, consulte la guía para desarrolladores correspondiente en la página de Descripción general del SDK.
API	Modificación de metadatos de objetos
OBS Browser+	-
obsutil	Carga de un objeto