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 de inventários de um bucket

Atualizado em 2022-11-07 GMT+08:00

Ver PDF

Obtenção de inventários de um bucket

Funções

O OBS usa o método GET para obter um inventário específico de um bucket.

Para executar essa operação, você deve ter a permissão GetLifecycleConfiguration. Por padrão, o proprietário do bucket tem essa permissão e pode atribuir essa permissão a outros usuários.

Para obter mais informações sobre o controle de permissão, consulte o controle de permissão no Guia de configuração de permissão do OBS.

Sintaxe da solicitação

GET /?inventory&id=configuration-id HTTP/1.1
User-Agent: curl/7.29.0
Host: bucketname.obs.region.myhuaweicloud.com 
Accept: */*
Date: date
Authorization: authorization string

Parâmetros de solicitação

**Tabela 1** Parâmetros de solicitação
Parâmetro	Descrição	Obrigatório
id	ID da configuração de inventário que você deseja obter. Tipo: string Especificações: Máximo de 64 caracteres Não há valor padrão. Caracteres válidos: letras, dígitos, (-) de hífens, pontos (.) e sublinhados (_)	Sim

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
Server: OBS
x-obs-request-id: request id
x-obs-id-2: id
Content-Type: application/xml
Date: date
Content-Length: length

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<InventoryConfiguration  xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/"> 
  <Id>configuration-id</Id>
  <IsEnabled>true</IsEnabled>
  <Destination>
    <Format>CSV</Format>
    <Bucket>destbucket</Bucket>
    <Prefix>prefix</Prefix>
  </Destination>
  <Schedule>
    <Frequency>Daily</Frequency>
  </Schedule>
  <IncludedObjectVersions>Current</IncludedObjectVersions>
  <OptionalFields>
    <Field>Size</Field>
    <Field>LastModifiedDate</Field>
    <Field>ETag</Field>
    <Field>StorageClass</Field>
    <Field>IsMultipartUploaded</Field>
    <Field>ReplicationStatus</Field>
    <Field>EncryptionStatus</Field>
  </OptionalFields>
</InventoryConfiguration>

        

      

    
   

Cabeçalhos de resposta

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

Elementos de resposta

Tabela 2 lista os elementos contidos no corpo da resposta.

**Tabela 2** Elementos em um corpo de resposta à solicitação de configurações de inventário de bucket
Elemento	Descrição
InventoryConfiguration	Configuração de inventário. Tipo: recipiente Antepassado: nenhum Crianças: Id, IsEnabled, Filtro, Destino, Agendamento, Versões de Objetos Incluídos e Campos Opcionais
Id	ID de uma configuração de inventário, que deve ser consistente com a ID de configuração de inventário especificada na solicitação. Tipo: string Especificações: Máximo de 64 caracteres Não há valor padrão. Caracteres válidos: letras, dígitos, (-) de hífens, pontos (.) e sublinhados (_) Antepassado: InventoryConfiguration
IsEnabled	Indica se a regra está ativada. Se esse parâmetro for definido como true, o inventário será gerado. Caso contrário, o inventário não será gerado. Tipo: boolean Valores válidos: true ou false Antepassado: InventoryConfiguration
Filter	Configuração do filtro de inventário. O inventário contém somente objetos que atendem aos critérios de filtro (filtragem por prefixo de nome de objeto). Se nenhum critério de filtro estiver configurado, todos os objetos serão incluídos. Tipo: recipiente Antepassado: InventoryConfiguration Crianças: Prefixo
Prefix	Filtragem por prefixo de nome. Somente objetos com o prefixo de nome especificado são incluídos no inventário. Tipo: string Antepassado: Filtro
Schedule	Tempo programado para geração de estoques. Tipo: recipiente Antepassado: InventoryConfiguration Crianças: Frequência
Frequency	Intervalos quando os inventários são gerados. Você pode definir este parâmetro para Daily ou Weekly. Um inventário é gerado dentro de uma hora após ser configurado pela primeira vez. Em seguida, ele é gerado nos buckets especificados. Tipo: string Antepassado: Agendamento Valores válidos: Daily ou Weekly
Destination	Bucket de destino de um inventário. Tipo: recipiente Antepassado: InventoryConfiguration
Format	Formato do inventário. Somente o formato CSV é suportado. Tipo: string Antepassado: Destination Valores válidos: CSV
Bucket	Nome do período para salvar inventários. Tipo: string Antepassado: Destino
Prefix	O prefixo do nome dos arquivos de inventário. Se nenhum prefixo estiver configurado, os nomes dos arquivos de inventário começarão com o BucketInventory por padrão. Tipo: string Antepassado: Destino
IncludedObjectVersions	Indica se as versões dos objetos estão incluídas em um inventário. Se este parâmetro for definido como All, todas as versões dos objetos serão incluídas no inventário, e os campos relacionados a versionamento serão adicionados ao inventário, incluindo: VersionId, IsLatest, e DeleteMarker. Se este parâmetro for definido como Current, o inventário contém somente as versões de objetos atuais no momento em que o inventário é gerado. Nenhum campo de versionamento é exibido no inventário. Tipo: string Antepassado: InventoryConfiguration Valores válidos: All ou Current
OptionalFields	Campos de metadados extras que podem ser adicionados a um inventário. Se esse parâmetro estiver configurado, os campos especificados nesse parâmetro estarão contidos no inventário. Tipo: recipiente Antepassado: InventoryConfiguration Crianças: Campo
Field	Campos opcionais. O OptionalFields pode conter vários elementos de campo. Tipo: string Antepassado: OptionalFields Valores válidos: Size, LastModifiedDate, StorageClass, ETag, IsMultipartUploaded, ReplicationStatus, e EncryptionStatus.

Respostas de erro

Além de códigos de erro comuns, essa API também retorna outros códigos de erro. A tabela a seguir lista erros comuns e possíveis causas. Para mais detalhes, consulte Tabela 3.

**Tabela 3** Códigos de erro relacionados à obtenção de configurações de inventário
Código de erro	Descrição	Código de status HTTP
NoSuchInventoryConfiguration	Nenhuma configuração de inventário encontrada que corresponda ao ID especificado.	404 Not Found

Solicitação de exemplo

GET /?inventory&id=id1 HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: Tue, 08 Jan 2019 09:32:24 +0000
Authorization: OBS UDSIAMSTUBTEST000001:ySWncC9M08jNsyXdJLSMJkpi7XM=

Resposta de exemplo

    
     
       
       
         HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 000001682CB4C2EE6808A0D8DF9F3D00
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSBjn5O7Jv9CqvUMO0BenehRdil1n8rR
Content-Type: application/xml
Date: Tue, 08 Jan 2019 09:04:30 GMT
Content-Length: 626

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<InventoryConfiguration  xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/"> 
  <Id>id1</Id>
  <IsEnabled>true</IsEnabled>
  <Destination>
    <Format>CSV</Format>
    <Bucket>bucket</Bucket>
    <Prefix>prefix</Prefix>
  </Destination>
  <Schedule>
    <Frequency>Daily</Frequency>
  </Schedule>
  <IncludedObjectVersions>Current</IncludedObjectVersions>
  <OptionalFields>
    <Field>Size</Field>
    <Field>LastModifiedDate</Field>
    <Field>ETag</Field>
    <Field>StorageClass</Field>
    <Field>IsMultipartUploaded</Field>
    <Field>ReplicationStatus</Field>
    <Field>EncryptionStatus</Field>
  </OptionalFields>
</InventoryConfiguration>

        

      

    
   