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.
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 |
|
Sela um Objeto Acrescentável para impedir novos acréscimos. |
Operações relacionadas
|
Operação |
Descrição |
|
Retorna o cabeçalho x-oss-sealed-time para objetos selados. Objetos não selados não retornam esse valor. |
|
|
Retorna o cabeçalho x-oss-sealed-time para objetos selados. Objetos não selados não retornam esse valor. |
|
|
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. |