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

Ver PDF

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

    
         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

    
     
       
       
         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

    
         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

    
     
       
       
         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>

        

      

    
   