Consulta a política de retenção configurada para um bucket específico.
Se a política de retenção especificada pelo ID na solicitação não existir, o OSS retornará 404.
Notas de uso
O OSS oferece suporte à estratégia Write Once Read Many (WORM), que impede a exclusão ou substituição de objetos por um período determinado. Configure uma política de retenção baseada em tempo para um bucket com períodos de um dia a 70 anos.
Após o bloqueio da política de retenção de um bucket, ainda é possível ler ou enviar objetos para ele. No entanto, nem os objetos nem a política de retenção podem ser excluídos durante o período de vigência. A exclusão dos objetos só é permitida após o término desse período.
Cabeçalhos da solicitação
Uma solicitação GetBucketWorm contém apenas cabeçalhos comuns de solicitação. Para mais informações, consulte Cabeçalhos comuns de solicitação.
Cabeçalhos da resposta
A resposta a uma solicitação GetBucketWorm contém apenas cabeçalhos comuns de resposta. Para mais informações, consulte Cabeçalhos comuns de resposta.
Elementos da resposta
|
Elemento |
Tipo |
Descrição |
|
WormConfiguration |
Container |
Nó raiz. Nós filhos: WormId, State, RetentionPeriodInDays e CreationDate. |
|
WormId |
String |
ID da política de retenção. |
|
State |
String |
Status da política de retenção. Valores válidos:
|
|
RetentionPeriodInDays |
Inteiro positivo |
Número de dias de retenção dos objetos. |
|
CreationDate |
String |
Data e hora de criação da política de retenção. |
Exemplos
-
Exemplo de solicitação
GET /? worm HTTP/1.1 Date: Fri, 16 Oct 2020 11:18:32 GMT Host: BucketName.oss.aliyuncs.com Authorization: SignatureValue -
Exemplo de resposta
HTTP/1.1 200 OK x-oss-request-id: 5374A2880232A65C2300**** Date: Fri, 16 Oct 2020 11:18:32 GMT Content-Type: application/xml Content-Length: length <WormConfiguration> <WormId>1666E2CFB2B3418****</WormId> <State>Locked</State> <RetentionPeriodInDays>1</RetentionPeriodInDays> <CreationDate>2020-10-15T15:50:32</CreationDate> </WormConfiguration>
SDKs do OSS
Os seguintes SDKs do OSS oferecem suporte à operação GetBucketWorm:
ossutil
Para obter o comando do ossutil correspondente à operação GetBucketWorm, consulte get-bucket-worm.