Scelle un objet ajoutable pour empêcher tout ajout ultérieur. Une fois scellé, vous pouvez utiliser des règles de cycle de vie pour transférer l'objet vers les classes de stockage Cold Archive ou Deep Cold Archive, réduisant ainsi les coûts de stockage. Avant le scellement, l'objet ne peut être transféré que vers les classes Infrequent Access (IA) ou Archive Storage.
Pour utiliser cette opération, envoyez une demande afin d'obtenir l'accès.
Permissions
Par défaut, un compte Alibaba Cloud dispose de toutes les autorisations. Les utilisateurs RAM ou les rôles RAM associés à un compte Alibaba Cloud n'ont aucune autorisation par défaut. Le compte Alibaba Cloud ou l'administrateur du compte doit accorder les autorisations d'opération via des politiques RAM ou une Bucket Policy.
|
API |
Action |
Description |
|
SealAppendObject |
|
Scelle un objet ajoutable pour empêcher tout ajout ultérieur. |
Related operations
|
Operation |
Description |
|
Renvoie l'en-tête x-oss-sealed-time pour les objets scellés. Cet en-tête n'est pas renvoyé pour les objets non scellés. |
|
|
Renvoie l'en-tête x-oss-sealed-time pour les objets scellés. Cet en-tête n'est pas renvoyé pour les objets non scellés. |
|
|
Par défaut, les règles de cycle de vie ne peuvent pas transférer les objets ajoutables vers les classes Cold Archive ou Deep Cold Archive. Le scellement de l'objet supprime cette restriction. |
Request syntax
POST /ObjectName?seal&position=Position HTTP/1.1
Host: BucketName.oss.aliyuncs.com
Content-Length: 0
Date: GMT Date
Authorization: SignatureValueRequest parameters
|
Name |
Type |
Required |
Description |
|
seal |
string |
Yes |
Déclenche l'opération de scellement. |
|
position |
string |
Yes |
Longueur attendue de l'objet. OSS vérifie cette valeur par rapport à la longueur réelle de l'objet. En cas de différence, la requête échoue avec l'erreur PositionNotEqualToLength. |
Request headers
Cette opération utilise uniquement les en-têtes de requête communs.
Response headers
|
Response header |
Type |
Example |
Description |
|
x-oss-sealed-time |
string |
Wed, 07 May 2025 23:00:00 GMT |
Heure GMT du premier scellement de l'objet. Cette valeur ne change pas lors des appels de scellement suivants. |
Examples
Request example
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****Response example
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: AliyunOSSError codes
|
Error code |
HTTP status code |
Description |
|
AppendSealedObjectNotAllowed |
409 |
L'objet cible n'est pas un objet ajoutable. |
|
PositionNotEqualToLength |
409 |
La valeur de position ne correspond pas à la longueur réelle de l'objet. |