Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ Object Storage Service/ Referência de API/ As API/ Configurações avançadas de bucket/ Obtenção da configuração do ciclo de vida de um bucket
Atualizado em 2022-11-07 GMT+08:00

Obtenção da configuração do ciclo de vida de um bucket

Funções

Esta operação obtém a configuração do ciclo de vida do bucket.

Para executar essa operação, você deve ter a permissão GetLifecycleConfiguration. Por padrão, somente o proprietário do bucket pode executar essa operação. O proprietário do bucket pode conceder a permissão a outros usuários configurando a política do bucket ou a política do usuário.

Sintaxe da solicitação

1
2
3
4
GET /?lifecycle HTTP/1.1 
Host: bucketname.obs.region.myhuaweicloud.com 
Date: date
Authorization: authorization

Parâmetros de solicitação

Esta solicitação não contém nenhum parâmetro.

Cabeçalhos de solicitação

Essa solicitação usa cabeçalhos comuns. Para mais detalhes, consulte Tabela 3.

Elementos de solicitação

Este pedido não envolve elementos.

Sintaxe da resposta

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
HTTP/1.1 status_code
Date: date
Content-Type: application/xml 
Date: date
Content-Length: length

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
<LifecycleConfiguration xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/">
    <Rule> 
        <ID>id</ID> 
        <Prefix>prefix</Prefix> 
        <Status>status</Status> 
        <Expiration> 
            <Date>date</Date> 
        </Expiration> 
        <NoncurrentVersionExpiration> 
            <NoncurrentDays>days</NoncurrentDays> 
        </NoncurrentVersionExpiration> 
        <Transition>  
         <Date>date</Date>  
         <StorageClass>WARM</StorageClass>  
        </Transition>  
        <Transition>  
         <Date>date</Date>  
         <StorageClass>COLD</StorageClass>  
        </Transition>  
        <NoncurrentVersionTransition>  
         <NoncurrentDays>30</NoncurrentDays>  
         <StorageClass>WARM</StorageClass>  
        </NoncurrentVersionTransition>  
        <NoncurrentVersionTransition>  
         <NoncurrentDays>60</NoncurrentDays>  
         <StorageClass>COLD</StorageClass>  
        </NoncurrentVersionTransition> 
        <AbortIncompleteMultipartUpload>
            <DaysAfterInitiation>10</DaysAfterInitiation>
        </AbortIncompleteMultipartUpload>
    </Rule> 
</LifecycleConfiguration>

Cabeçalhos de resposta

A resposta à solicitação usa cabeçalhos comuns. Para mais detalhes, consulte Tabela 1.

Elementos de resposta

Essa resposta contém elementos para detalhar a configuração. Tabela 1 descreve os elementos.

Tabela 1 Elementos de resposta para configuração do ciclo de vida

Elemento

Descrição

Date

Especifica que o OBS executa regras de ciclo de vida para objetos antes da data especificada. A data deve estar em conformidade com o formato ISO8601 e a hora deve estar em conformidade com o formato UTC de 00:00:00. Por exemplo: 2018-01-01T00:00:00.000Z, que indica que os objetos cuja última hora de modificação é anterior a 2018-01-01T00:00:00.000Z são excluídos ou transferidos para outras classes de armazenamento. Objetos cujo último tempo de modificação é igual ou posterior ao tempo especificado não são excluídos ou despejados.

Tipo: string

Nó ancestral: Expiração, Transição

Days

Especifica o número de dias (desde a atualização mais recente até a versão mais recente do objeto) após os quais a regra de ciclo de vida é executada.

Tipo: inteiro positivo

Nó ancestral: Expiração, Transição

StorageClass

A classe de armazenamento para a qual o objeto é transferido.

Tipo: string WARM ou COLD

Nó ancestral: Transição NoncurrentVersionTransition

Transition

Tempo de transição e a classe de armazenamento de objetos após a transição (válido apenas para a versão mais recente do objeto).

Tipo: XML

Nó filhos: Data ou Dias

Nó ancestral: Regra

Expiration

Recipiente para a regra de expiração do objeto.

Tipo: XML

Nó filhos: Data ou Dias

Nó ancestral: Regra

ID

Identificador único de uma regra. O valor pode conter no máximo 255 caracteres.

Tipo: string

Nó ancestral: Regra

LifecycleConfiguration

Container para regras de ciclo de vida. Você pode adicionar várias regras. O tamanho total das regras não pode exceder 20 KB.

Tipo: XML

Nó filhos: Regra

Nó do antepassado: nenhum

NoncurrentDays

Número de dias em que a regra especificada entra em vigor após o objeto se tornar uma versão histórica.

Tipo: inteiro positivo

Nó ancestral: NoncurrentVersionExpiration, NoncurrentVersionTransition

NoncurrentVersionTransition

Tempo de transição de versões de objetos históricos e a classe de armazenamento de objetos após a transição.

Tipo: XML

Nó filhos: NoncurrentDays e StorageClass

Nó ancestral: Regra

NoncurrentVersionExpiration

Contêiner para o tempo de expiração das versões históricas dos objetos. Se o versionamento estiver ativado ou suspenso para um bucket, você pode definir NoncurrentVersionExpiration para excluir objetos cujos ciclos de vida expiraram.

Tipo: XML

Nó filhos: NoncurrentDays

Nó ancestral: Regra

AbortIncompleteMultipartUpload

Contêiner para a regra de tempo de expiração aplicada às tarefas de upload de várias partes que não são mescladas.

Tipo: XML

Nó filhos: DaysAfterInitiation

Nó ancestral: Regra

DaysAfterInitiation

Indica quando uma regra de ciclo de vida entrará em vigor após a inicialização de uma tarefa de carregamento de várias partes.

Tipo: inteiro positivo

Nó ancestral: AbortIncompleteMultipartUpload

Prefix

Prefixo do nome do objeto que identifica um ou mais objetos aos quais a regra se aplica.

Tipo: string

Nó ancestral: Regra

Rule

Container para uma regra de ciclo de vida específica.

Tipo: recipiente

Nó ancestral: LifecycleConfiguration

Status

Indica se a regra está ativada.

Tipo: string

Nó ancestral: Regra

Opções de valor: Ativado, Desativado

Respostas de erro

Tabela 2 descreve possíveis erros especiais na solicitação.

Tabela 2 Erro especial

Código de erro

Descrição

Código de status HTTP

NoSuchLifecycleConfiguration

A configuração do ciclo de vida do bucket não existe.

404 Não encontrado

Para outros erros, veja Tabela 2.

Solicitação de exemplo

1
2
3
4
5
6
GET /?lifecycle HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 03:06:56 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:/Nof9FCNANfzIXDS0NDp1IfDu8I=

Resposta de exemplo

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016436BA5684FF5A10370EDB
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSEMKZSIeboCA1eAukgYOOAd7oX3ZONn
Content-Type: application/xml
Date: WED, 01 Jul 2015 03:06:56 GMT
Content-Length: 919

<?xml version="1.0" encoding="utf-8"?>
<LifecycleConfiguration> 
  <Rule> 
    <ID>delete-2-days</ID>  
    <Prefix>test/</Prefix>  
    <Status>Enabled</Status>  
    <Expiration> 
      <Days>2</Days> 
    </Expiration>  
    <NoncurrentVersionExpiration> 
      <NoncurrentDays>5</NoncurrentDays> 
    </NoncurrentVersionExpiration>
    <Transition> 
      <Days>30</Days>  
      <StorageClass>WARM</StorageClass> 
    </Transition>  
    <Transition> 
      <Days>60</Days>  
      <StorageClass>COLD</StorageClass> 
    </Transition>  
    <NoncurrentVersionTransition> 
      <NoncurrentDays>30</NoncurrentDays>  
      <StorageClass>WARM</StorageClass> 
    </NoncurrentVersionTransition>  
    <NoncurrentVersionTransition> 
      <NoncurrentDays>60</NoncurrentDays>  
      <StorageClass>COLD</StorageClass> 
    </NoncurrentVersionTransition> 
    <AbortIncompleteMultipartUpload>
        <DaysAfterInitiation>10</DaysAfterInitiation>
    </AbortIncompleteMultipartUpload>
  </Rule>
</LifecycleConfiguration>