Sella un objeto anexable para impedir que se le agreguen más datos. Después de sellarlo, puede usar reglas de ciclo de vida para mover el objeto al almacenamiento Cold Archive o Deep Cold Archive y así reducir los costos de almacenamiento. Antes del sellado, el objeto solo puede transicionar a Infrequent Access (IA) o Archive Storage.
Para utilizar esta operación, envíe un ticket y solicite acceso.
Permisos
De forma predeterminada, una cuenta de Alibaba Cloud tiene permisos completos. Los usuarios de RAM o los roles de RAM bajo una cuenta de Alibaba Cloud no tienen ningún permiso predeterminado. La cuenta de Alibaba Cloud o el administrador de la cuenta deben otorgar los permisos de operación mediante RAM policies o Bucket Policy.
|
API |
Acción |
Descripción |
|
SealAppendObject |
|
Sella un objeto anexable para impedir que se le agreguen más datos. |
Operaciones relacionadas
|
Operación |
Descripción |
|
Devuelve el encabezado x-oss-sealed-time para objetos sellados. No se devuelve en objetos sin sellar. |
|
|
Devuelve el encabezado x-oss-sealed-time para objetos sellados. No se devuelve en objetos sin sellar. |
|
|
De forma predeterminada, las reglas de ciclo de vida no pueden mover objetos anexables a Cold Archive ni a Deep Cold Archive. Sellar el objeto elimina esta restricción. |
Sintaxis de la solicitud
POST /ObjectName?seal&position=Position HTTP/1.1
Host: BucketName.oss.aliyuncs.com
Content-Length: 0
Date: GMT Date
Authorization: SignatureValueParámetros de la solicitud
|
Nombre |
Tipo |
Obligatorio |
Descripción |
|
seal |
string |
Sí |
Inicia la operación de sellado. |
|
position |
string |
Sí |
Longitud esperada del objeto. OSS verifica este valor frente a la longitud real del objeto. Si difieren, la solicitud falla con un error PositionNotEqualToLength. |
Encabezados de la solicitud
Esta operación utiliza únicamente common request headers.
Encabezados de la respuesta
|
Encabezado de respuesta |
Tipo |
Ejemplo |
Descripción |
|
x-oss-sealed-time |
string |
Wed, 07 May 2025 23:00:00 GMT |
Hora GMT en la que se selló el objeto por primera vez. No cambia en llamadas posteriores de sellado. |
Ejemplos
Ejemplo de solicitud
POST /test.jpg?seal&position=344606 HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 07 May 2025 23:00:00 GMT
Content-Length: 0
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250507/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3****Ejemplo de respuesta
HTTP/1.1 200 OK
x-oss-request-id: 559CC9BDC755F95A6448****
x-oss-object-type: Appendable
x-oss-storage-class: Standard
x-oss-sealed-time: Wed, 07 May 2025 23:00:00 GMT
Date: Wed, 07 May 2025 23:00:00 GMT
Last-Modified: Mon, 07 Apr 2025 07:32:52 GMT
ETag: "fba9dede5f27731c9771645a3986****"
Content-Length: 344606
Content-Type: image/jpg
Connection: keep-alive
Server: AliyunOSSCódigos de error
|
Código de error |
Código de estado HTTP |
Descripción |
|
AppendSealedObjectNotAllowed |
409 |
El objeto destino no es un objeto anexable. |
|
PositionNotEqualToLength |
409 |
El valor de posición no coincide con la longitud real del objeto. |