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.
Atualizado em 2022-11-07 GMT+08:00

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

 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
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

 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
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>