Object Storage Service:GetBucketInventory

Notas de uso

Por padrão, uma conta Alibaba Cloud tem permissão para visualizar a configuração de inventário especificada de um bucket. Para chamar esta operação como usuário do Resource Access Management (RAM) ou usando o Security Token Service (STS), é necessária a permissão oss:GetBucketInventory.

Sintaxe da solicitação

GET /?inventory&inventoryId=inventoryId HTTP/1.1

Parâmetros da solicitação

Elementos da resposta

A tabela a seguir descreve os elementos retornados na resposta. Alguns elementos aplicam-se apenas a configurações de inventário específicas. Por exemplo, DayOfMonth aplica-se somente quando Frequency está definido como Monthly, e AutoDelete aplica-se somente quando Frequency está definido como Once. A subseção seguinte descreve os elementos específicos para inventários incrementais.

Campos de registro do inventário incremental

Os campos a seguir descrevem os registros em um arquivo de inventário incremental:

• SequenceNumber: Número de série do registro. O SequenceNumber de cada registro é único. Registros do mesmo objeto no mesmo bucket podem ser ordenados por SequenceNumber, e os registros classificados geralmente seguem a ordem cronológica.

• RecordType: Tipo de evento. Valores válidos:

  • CREATE: todas as operações de upload ocorridas sob o prefixo selecionado, como Put, Post, Append, MultipartUpload e Copy.

  • UPDATE_METADATA: todas as atualizações de metadados sob o prefixo selecionado.

  • DELETE: todas as operações de exclusão de objetos sob o prefixo selecionado, como DeleteObject e DeleteMultipleObjects, a geração de um marcador de exclusão após a ativação do versionamento e a exclusão baseada em ciclo de vida. As exclusões incluem a criação de um marcador de exclusão e a exclusão permanente. Para uma exclusão permanente, o registro mantém apenas os campos principais Bucket, Key, SequenceNumber, RecordType, RecordTimestamp e VersionId, enquanto todas as outras colunas ficam nulas.

• RecordTimestamp: Timestamp do registro, no Horário de Greenwich e com precisão de milissegundos. Exemplo: 2024-08-25 18:08:01.024.

• Requester: ID da Alibaba Cloud ou Principal ID do solicitante.

• RequestId: Identificador exclusivo da solicitação.

• SourceIp: Endereço IP de source do solicitante.

• Key: Nome do objeto codificado por URL no bucket.

• VersionId: ID da versão do objeto. Este campo aparece apenas quando a regra de inventário configurada exporta todas as versões.

  • Se o versionamento não estiver ativado no bucket para o qual a regra de inventário foi configurada, este campo ficará vazio.

  • Caso o versionamento esteja ativado no bucket associado à regra de inventário, este campo exibirá o VersionId do objeto.

• IsDeleteMarker: Indica se a versão do objeto é um marcador de exclusão. Este campo aparece apenas quando a regra de inventário configurada exporta todas as versões.

  • Se o versionamento não estiver ativado no bucket para o qual a regra de inventário foi configurada, o valor padrão deste campo será false.

  • Quando o versionamento estiver ativado no bucket associado à regra de inventário, este campo será true se o objeto for um marcador de exclusão e false caso contrário.

• Size: Tamanho do objeto.

• StorageClass: Classe de armazenamento do objeto.

• LastModifiedDate: Data da última modificação do objeto.

• ETag: ETag do objeto. Um ETag é criado quando o objeto é gerado e identifica o conteúdo do objeto.

  • Para um objeto criado usando a operação PutObject, o ETag corresponde ao hash MD5 do seu conteúdo.

  • Para objetos criados por outros métodos, o ETag é um valor exclusivo gerado com base em regras de cálculo específicas e não representa o hash MD5 do conteúdo.

• IsMultipartUploaded: Indica se o objeto foi enviado usando upload multipart.

• ObjectType: Tipo do objeto.

• ObjectAcl: Lista de controle de acesso do objeto.

• Crc64: Valor CRC-64 do objeto.

• EncryptionStatus: Indica se o objeto está criptografado.

Exemplos

• Exemplo de solicitação

GET /?inventory&inventoryId=report1 HTTP/1.1

• Exemplo de resposta

HTTP/1.1 200 OK
  x-oss-request-id: 56594298207FB304438516F9
  Date: Mon, 31 Oct 2016 12:00:00 GMT
  Server: AliyunOSS
  Content-Length: length

  <?xml version="1.0" encoding="UTF-8"?>
  <InventoryConfiguration>
     <Id>report1</Id>
     <IsEnabled>true</IsEnabled>
     <Destination>
        <OSSBucketDestination>
           <Format>CSV</Format>
           <AccountId>1000000000000000</AccountId>
           <RoleArn>acs:ram::1000000000000000:role/AliyunOSSRole</RoleArn>
           <Bucket>acs:oss:::bucket_0001</Bucket>
           <Prefix>prefix1</Prefix>
           <Encryption>
              <SSE-OSS/>
           </Encryption>
        </OSSBucketDestination>
     </Destination>
     <Schedule>
        <Frequency>Daily</Frequency>
     </Schedule>
     <Filter>
       <Prefix>myprefix/</Prefix>
     </Filter>
     <IncludedObjectVersions>All</IncludedObjectVersions>
     <OptionalFields>
        <Field>Size</Field>
        <Field>LastModifiedDate</Field>
        <Field>ETag</Field>
        <Field>StorageClass</Field>
        <Field>IsMultipartUploaded</Field>
        <Field>EncryptionStatus</Field>
     </OptionalFields>
  </InventoryConfiguration>

SDKs

Os seguintes SDKs oferecem suporte a esta operação:

• Java

• Python V2

• Go V2

• Node.js

• C++

• .NET

ossutil CLI

Para obter o comando ossutil correspondente à operação GetBucketInventory, consulte get-bucket-inventory.