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.

En esta página

Functions
Versioning
Multipart Upload
Request Syntax
Request Parameters
Request Headers
Request Elements
Response Syntax
Response Headers
Response Elements
Error Responses
Sample Request
Sample Response

Mostrar todo

Centro de ayuda/ Object Storage Service/ Referencia de la API/ Las API/ Operaciones en objetos/ Configuring WORM Retention for an Object

Configuring WORM Retention for an Object

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

Ver PDF

Functions

This operation configures or updates the retention period for objects uploaded to a bucket with WORM enabled.

When you upload an object, if you do not configure a protection period or apply the default bucket-level protection rule to the object, you can perform this operation to configure a protection period for the object.
When you upload an object, if you configure a protection period or apply the default bucket-level protection rule to the object, you can perform this operation to prolong the protection period for the object.
The protection period of an object can only be modified, but not deleted.
NOTA:

To configure or update the protection period of an object, you must have the PutObjectRetention permission.

Versioning

OBS automatically enables versioning when you enable WORM for a bucket. In such case, the object you uploaded to the bucket will be assigned a version ID. An object-level WORM policy is applied to the current object version by default, but you can specify a version ID to make the policy applied to a specific object version. The WORM configuration does not apply to a delete marker with a unique version ID.

Multipart Upload

Before a multipart upload is complete, the default bucket-level WORM policy is not automatically applied to the object parts uploaded. Besides, you cannot configure an object-level WORM policy using a header when you upload a part or assemble the object parts, or for a part that is already uploaded to the bucket. You can call this API to configure a WORM retention policy for the new object after the object parts are assembled.

Request Syntax

PUT /ObjectName?retention HTTP/1.1 
Host: bucketname.obs.region.myhuaweicloud.com 
Date: date
Authorization: authorization

<Retention>
    <Mode>String</Mode>
    <RetainUntilDate>Timestamp</RetainUntilDate>
</Retention>

Request Parameters

Tabla 1 describes the parameters.

**Tabla 1** Request parameters
Parameter	Description	Mandatory
versionId	ID of the object version on which this operation will be performed. If this header is not carried, this operation applies to the current object version. Type: string	No

Request Headers

This request uses common headers. For details, see Tabla 3.

Request Elements

Element	Description	Mandatory
Retention	Container for configuring an object-level WORM retention policy. Type: container	Yes
Mode	Protection mode for the object. It can only be set to COMPLIANCE now. Type: string Example: COMPLIANCE	Yes
RetainUntilDate	Protection period for the object. Its value is a timestamp accurate to milliseconds, for example, 1435728035000 (corresponding to 13:20:35 on July 1, 2015). NOTA: The value of this field must be later than the current time and can be extended but not shortened. Type: long Example: 1435728035000	Yes

Element

Description

Mandatory

Retention

Container for configuring an object-level WORM retention policy.

Type: container

Yes

Mode

Protection mode for the object. It can only be set to COMPLIANCE now.

Type: string

Example: COMPLIANCE

Yes

RetainUntilDate

Protection period for the object. Its value is a timestamp accurate to milliseconds, for example, 1435728035000 (corresponding to 13:20:35 on July 1, 2015).

NOTA:

The value of this field must be later than the current time and can be extended but not shortened.

Type: long

Example: 1435728035000

Yes

Response Syntax

HTTP/1.1 status_code
Date: date
Content-Length: length

Response Headers

This response uses common headers. For details, see Tabla 1.

Response Elements

This response contains no elements.

Error Responses

Tabla 2 describes possible special errors in this request.

**Tabla 2**
Error Code	Description	HTTP Status Code
InvalidRequest	The object retention period cannot be configured, because object lock is not enabled for the bucket.	400
InvalidRequest	The retention period date must be later than the current or the configured date.	400
MalformedObjectLockError	Invalid format of the Object Lock configuration.	400

For other errors, see Tabla 2.

Sample Request

PUT /objectname?retention HTTP/1.1
Host: bucketname.obs.region.myhuaweicloud.com 
Date: WED, 01 Jul 2015 02:25:05 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:75/Y4Ng1izvzc1nTGxpMXTE6ynw=
Content-Type: application/xml
Content-Length: 157
<Retention>
    <Mode>COMPLIANCE</Mode>
    <RetainUntilDate>1435728035000</RetainUntilDate>
</Retention>

Sample Response

HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016435CE298386946AE4C482
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCT9W2tcvLmMJ+plfdopaD62S0npbaRUz
Date: WED, 01 Jul 2015 02:25:06 GMT
Content-Length: 0

Tema principal: Operaciones en objetos

Tema anterior: Cambio de nombre de un objeto

Tema siguiente: Operaciones en carga multiparte

Comentarios

¿Le pareció útil esta página?

Sí No

Deje algún comentario

Muchas gracias por sus comentarios. Seguiremos trabajando para mejorar la documentación.

El sistema está ocupado. Vuelva a intentarlo más tarde.

¿Cuáles de los siguientes problemas se presentaron?

Contenido diferente a la de la IU del producto

Descripciones poco claras

Falta de ejemplos o código

Pasos incorrectos

No puedo encontrar lo que necesito

Falta de prácticas recomendadas

Comentarios (opcional)

0/500

Seleccione al menos un tipo de problema e ingrese sus comentarios o sugerencias.

Ingrese 500 caracteres como máximo.

Enviar Cancelar