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.
Actualización más reciente 2024-09-18 GMT+08:00

Gestión de metadatos de objetos

Escenarios

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 con 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:

  1. 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.

  2. 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.
  3. 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 y xz

CacheControl

Comportamiento de caché de la página web cuando se descarga el objeto especificado.

  • Capacidad de caché: public, private, no-cache y 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>
  • Reverificación y recarga: must-revalidate, proxy-revalidate e immutable
  • Otros: no-store y no-transform

Expires

Tiempo de caducidad de caché (GMT)

ContentType

Tipo de archivo de un objeto.

Para obtener más información, véase Tipo de contenido de metadatos de objeto.

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

Tipo de contenido de metadatos de objeto

Cuando se carga un objeto en OBS a través de OBS Console 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 con 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 invocando 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

.* (binary stream, unknown file type)

application/octet-stream

.7z

application/x-7z-compressed

.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

.docx

application/vnd.openxmlformats-officedocument.wordprocessingml.document

.drw

application/x-drw

.dot

application/msword

.dwf

Model/vnd.dwf

.dtd

text/xml

.dwg

application/x-dwg

.dwf

application/x-dwf

.dxf

application/x-dxf

.dxb

application/x-dxb

.emf

application/x-emf

.edn

application/vnd.adobe.edn

.ent

text/xml

.eml

message/rfc822

.eps

application/x-ps

.epi

application/x-epi

.etd

application/x-ebx

.eps

application/postscript

.fax

image/fax

.exe

application/x-msdownload

.fif

application/fractals

.fdf

application/vnd.fdf

.frm

application/x-frm

.fo

text/xml

.gbr

application/x-gbr

.g4

application/x-g4

.gif

image/gif

.

application/x-

.gp4

application/x-gp4

.gl2

application/x-gl2

.hmr

application/x-hmr

.hgl

application/x-hgl

.hpl

application/x-hpl

.hpg

application/x-hpgl

.hrf

application/x-hrf

.hqx

application/mac-binhex40

.htc

text/x-component

.hta

application/hta

.html

text/html

.htm

text/html

.htx

text/html

.htt

text/webviewhtml

.ico

image/x-icon

.icb

application/x-icb

.iff

application/x-iff

.ico

application/x-ico

.igs

application/x-igs

.ig4

application/x-g4

.img

application/x-img

.iii

application/x-iphone

.isp

application/x-internet-signup

.ins

application/x-internet-signup

.java

java/*

.IVF

video/x-ivf

.jpe

image/jpeg

.jfif

image/jpeg

.jpeg

image/jpeg

.jpe

application/x-jpe

.jpg

application/x-jpg

.jpg

image/jpeg

.jsp

text/html

.js

text/javascript

.lar

application/x-laplayer-reg

.la1

audio/x-liquid-file

.lavs

audio/x-liquid-secure

.latex

application/x-latex

.lmsff

audio/x-la-lms

.lbm

application/x-lbm

.ltr

application/x-ltr

.ls

application/x-javascript

.m2v

video/x-mpeg

.m1v

video/x-mpeg

.m4e

video/mpeg4

.m3u

audio/mpegurl

.man

application/x-troff-man

.mac

application/x-mac

.mdb

application/msaccess

.math

text/xml

.mfp

application/x-shockwave-flash

.mdb

application/x-mdb

.mhtml

message/rfc822

.mht

message/rfc822

.mid

audio/mid

.mi

application/x-mi

.mil

application/x-mil

.midi

audio/mid

.mnd

audio/x-musicnet-download

.mml

text/xml

.mocha

application/x-javascript

.mns

audio/x-musicnet-stream

.mp1

audio/mp1

.movie

video/x-sgi-movie

.mp2v

video/mpeg

.mp2

audio/mp2

.mp4

video/mp4

.mp3

audio/mp3

.mpd

application/vnd.ms-project

.mpa

video/x-mpg

.mpeg

video/mpg

.mpe

video/x-mpeg

.mpga

audio/rn-mpeg

.mpg

video/mpg

.mps

video/x-mpeg

.mpp

application/vnd.ms-project

.mpv

video/mpg

.mpt

application/vnd.ms-project

.mpw

application/vnd.ms-project

.mpv2

video/mpeg

.mtx

text/xml

.mpx

application/vnd.ms-project

.net

image/pnetvue

.mxp

application/x-mmxp

.nws

message/rfc822

.nrf

application/x-nrf

.out

application/x-out

.odc

text/x-ms-odc

.p12

application/x-pkcs12

.p10

application/pkcs10

.p7c

application/pkcs7-mime

.p7b

application/x-pkcs7-certificates

.p7r

application/x-pkcs7-certreqresp

.p7m

application/pkcs7-mime

.pc5

application/x-pc5

.p7s

application/pkcs7-signature

.pcl

application/x-pcl

.pci

application/x-pci

.pdf

application/pdf

.pcx

application/x-pcx

.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

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.

1
2
3
4
5
6
7
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 cumplir con los estándares 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.

Cómo usarlo

Puede utilizar OBS Console, las API, los SDK, OBS Browser+ u obsutil para personalizar los metadatos de los objetos.

Herramienta

Referencia

OBS Console

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 de los SDK.

API

Modificación de metadatos de objetos

OBS Browser+

-

obsutil

Carga de un objeto