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.
Cómputo
Elastic Cloud Server
Bare Metal Server
Auto Scaling
Image Management Service
Dedicated Host
FunctionGraph
Cloud Phone Host
Huawei Cloud EulerOS
Redes
Virtual Private Cloud
Elastic IP
Elastic Load Balance
NAT Gateway
Direct Connect
Virtual Private Network
VPC Endpoint
Cloud Connect
Enterprise Router
Enterprise Switch
Global Accelerator
Gestión y gobernanza
Cloud Eye
Identity and Access Management
Cloud Trace Service
Resource Formation Service
Tag Management Service
Log Tank Service
Config
Resource Access Manager
Simple Message Notification
Application Performance Management
Application Operations Management
Organizations
Optimization Advisor
Cloud Operations Center
Resource Governance Center
Migración
Server Migration Service
Object Storage Migration Service
Cloud Data Migration
Migration Center
Cloud Ecosystem
KooGallery
Partner Center
User Support
My Account
Billing Center
Cost Center
Resource Center
Enterprise Management
Service Tickets
HUAWEI CLOUD (International) FAQs
ICP Filing
Support Plans
My Credentials
Customer Operation Capabilities
Partner Support Plans
Professional Services
Análisis
MapReduce Service
Data Lake Insight
CloudTable Service
Cloud Search Service
Data Lake Visualization
Data Ingestion Service
GaussDB(DWS)
DataArts Studio
IoT
IoT Device Access
Otros
Product Pricing Details
System Permissions
Console Quick Start
Common FAQs
Instructions for Associating with a HUAWEI CLOUD Partner
Message Center
Seguridad y cumplimiento
Security Technologies and Applications
Web Application Firewall
Host Security Service
Cloud Firewall
SecMaster
Data Encryption Workshop
Database Security Service
Cloud Bastion Host
Data Security Center
Cloud Certificate Manager
Blockchain
Blockchain Service
Servicios multimedia
Media Processing Center
Video On Demand
Live
SparkRTC
Almacenamiento
Object Storage Service
Elastic Volume Service
Cloud Backup and Recovery
Storage Disaster Recovery Service
Scalable File Service
Volume Backup Service
Cloud Server Backup Service
Data Express Service
Dedicated Distributed Storage Service
Contenedores
Cloud Container Engine
SoftWare Repository for Container
Application Service Mesh
Ubiquitous Cloud Native Service
Cloud Container Instance
Bases de datos
Relational Database Service
Document Database Service
Data Admin Service
Data Replication Service
GeminiDB
GaussDB
Distributed Database Middleware
Database and Application Migration UGO
TaurusDB
Middleware
Distributed Cache Service
API Gateway
Distributed Message Service for Kafka
Distributed Message Service for RabbitMQ
Distributed Message Service for RocketMQ
Cloud Service Engine
EventGrid
Dedicated Cloud
Dedicated Computing Cluster
Aplicaciones empresariales
ROMA Connect
Message & SMS
Domain Name Service
Edge Data Center Management
Meeting
AI
Face Recognition Service
Graph Engine Service
Content Moderation
Image Recognition
Data Lake Factory
Optical Character Recognition
ModelArts
ImageSearch
Conversational Bot Service
Speech Interaction Service
Huawei HiLens
Developer Tools
SDK Developer Guide
API Request Signing Guide
Terraform
Koo Command Line Interface
Distribución de contenido y cómputo de borde
Content Delivery Network
Intelligent EdgeFabric
CloudPond
Soluciones
SAP Cloud
High Performance Computing
Servicios para desarrolladores
ServiceStage
CodeArts
CodeArts PerfTest
CodeArts Req
CodeArts Pipeline
CodeArts Build
CodeArts Deploy
CodeArts Artifact
CodeArts TestPlan
CodeArts Check
Cloud Application Engine
aPaaS MacroVerse
KooPhone
KooDrive

Modificación de metadatos de objetos

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

Funciones

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

Sintaxis de solicitud

1
2
3
4
5
6
7
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

NOTA:

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

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

1
2
3
4
5
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.

1
2
3
4
5
6
7
8
9
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

1
2
3
4
5
6
7
8
9
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.

1
2
3
4
5
6
7
8
9
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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
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.

1
2
3
4
5
6
7
8
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

1
2
3
4
5
6
7
8
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

Utilizamos cookies para mejorar nuestro sitio y tu experiencia. Al continuar navegando en nuestro sitio, tú aceptas nuestra política de cookies. Descubre más

Comentarios

Comentarios

Comentarios

0/500

Seleccionar contenido

Enviar el contenido seleccionado con los comentarios