Todos os produtos
Search
Central de documentação

Object Storage Service:SealAppendObject

Última atualização: Jul 03, 2026

Sela um Objeto Acrescentável para impedir novos acréscimos. Após o selamento, use regras de ciclo de vida para transferir o objeto para o armazenamento Cold Archive ou Deep Cold Archive e reduzir os custos de armazenamento. Antes do selamento, a transferência ocorre apenas para Armazenamento de Acesso Infrequente (IA) ou Arquivo Morto.

Importante

Para usar esta operação, envie um ticket para solicitar acesso.

Permissões

Por padrão, uma conta Alibaba Cloud tem permissões totais. Usuários RAM ou funções RAM vinculados a essa conta não têm permissão por padrão. A conta Alibaba Cloud ou o administrador da conta deve conceder as permissões de operação por meio de políticas do RAM ou Bucket Policy.

API

Ação

Descrição

SealAppendObject

oss:SealAppendObject

Sela um Objeto Acrescentável para impedir novos acréscimos.

Operações relacionadas

Operação

Descrição

HeadObject

Retorna o cabeçalho x-oss-sealed-time para objetos selados. Objetos não selados não retornam esse valor.

GetObject

Retorna o cabeçalho x-oss-sealed-time para objetos selados. Objetos não selados não retornam esse valor.

Lifecycle

Por padrão, as regras de ciclo de vida não transferem Objetos Acrescentáveis para Cold Archive ou Deep Cold Archive. O selamento do objeto remove essa restrição.

Sintaxe da solicitação

POST /ObjectName?seal&position=Position HTTP/1.1
Host: BucketName.oss.aliyuncs.com
Content-Length: 0
Date: GMT Date
Authorization: SignatureValue

Parâmetros da solicitação

Nome

Tipo

Obrigatório

Descrição

seal

string

Sim

Inicia a operação de selamento.

position

string

Sim

Comprimento esperado do objeto. O OSS verifica esse valor em relação ao comprimento real do objeto. Em caso de divergência, a solicitação falha com o erro PositionNotEqualToLength.

Cabeçalhos da solicitação

Esta operação usa apenas cabeçalhos de solicitação comuns.

Cabeçalhos da resposta

Cabeçalho da resposta

Tipo

Exemplo

Descrição

x-oss-sealed-time

string

Wed, 07 May 2025 23:00:00 GMT

Horário GMT do primeiro selamento do objeto. O valor permanece inalterado em chamadas de selamento subsequentes.

Exemplos

Exemplo de solicitação

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****

Exemplo de resposta

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

Códigos de erro

Código de erro

Código de status HTTP

Descrição

AppendSealedObjectNotAllowed

409

O objeto de destino não é um Objeto Acrescentável.

PositionNotEqualToLength

409

O valor de position não corresponde ao comprimento real do objeto.