A operação ListBucketInventory lista todas as configurações de inventário de um bucket.
Observações de uso
A chamada à operação ListBucketInventory exige a permissão oss:GetBucketInventory. Para mais informações, consulte Grant custom permission policies to a RAM user.
Uma única solicitação recupera no máximo 100 configurações de inventário. Se a resposta for truncada, use o valor NextContinuationToken da resposta como continuation-token na próxima solicitação para obter a página seguinte de resultados.
Verifique se você tem permissão para gerenciar as configurações de inventário do bucket. Por padrão, apenas o proprietário do bucket possui essa permissão. Caso não seja o proprietário, solicite a permissão necessária.
Sintaxe da solicitação
-
Com continuation-token
GET /?inventory&continuation-token=xxx HTTP/1.1 -
Sem continuation-token
GET /?inventory HTTP/1.1
Elementos da resposta
Parâmetro | Tipo | Descrição |
InventoryConfiguration | container | Contêiner dos parâmetros de configuração de inventário. |
IsTruncated | Boolean | Indica se a lista de configurações de inventário foi truncada. Valores válidos: true ou false
|
NextContinuationToken | String | Se a resposta estiver truncada (IsTruncated é true), use este token no parâmetro continuation-token da próxima solicitação para obter a página seguinte de resultados. |
Id | String | Nome especificado pelo usuário para a configuração de inventário. O nome deve ser exclusivo dentro do bucket. |
IsEnabled | Boolean | Defina se o inventário está ativado. Valores válidos: true ou false
|
Filter | container | Contêiner das regras de filtro. O inventário inclui apenas objetos correspondentes ao filtro. |
Prefix | String | Prefixo de objeto usado para filtragem. Nó pai: Filter |
Destination | container | Contêiner com informações sobre o local de publicação dos resultados do inventário. |
OSSBucketDestination | container | Detalhes sobre o bucket de destino onde o relatório de inventário é armazenado. Nó pai: Destination |
Format | String | Formato de arquivo do inventário exportado. Valores válidos: CSV, Parquet (o formato Parquet tem suporte apenas na região UK (London).) Nó pai: OSSBucketDestination |
AccountId | String | ID da conta com permissão para gravar o relatório de inventário no bucket de destino. Nó pai: OSSBucketDestination |
RoleArn | String | ARN da função com permissão para gravar o relatório de inventário no bucket de destino. Formato: acs:ram::uid:role/rolename Nó pai: OSSBucketDestination |
Bucket | String | Bucket de destino do relatório de inventário. Nó pai: OSSBucketDestination |
Prefix | String | Prefixo no bucket de destino onde o relatório de inventário é armazenado. Nó pai: OSSBucketDestination |
Encryption | container | Método de criptografia no lado do servidor para o relatório de inventário. Valores válidos: SSE-OSS, SSE-KMS ou Null Nó pai: OSSBucketDestination |
SSE-OSS | container | Contêiner da criptografia SSE-OSS. Nó pai: Encryption |
SSE-KMS | container | Contêiner da chave usada na criptografia SSE-KMS. Nó pai: Encryption |
KeyId | String | ID da chave KMS. Nó pai: SSE-KMS |
Schedule | container | Contêiner da programação de exportação do inventário. |
Frequency | String | Frequência de exportação do inventário. Valores válidos: Nó pai: Schedule |
DayOfMonth | Integer | Dia do mês de exportação do inventário quando Nó pai: Schedule |
AutoDelete | Boolean | Defina se a configuração de inventário deve ser excluída automaticamente após a exportação de um inventário único. Este elemento é válido apenas quando Valores válidos: true, false Nó pai: Schedule |
IncludedObjectVersions | String | Especifica quais versões de objeto incluir no inventário. Valores válidos:
|
OptionalFields | container | Contêiner dos campos opcionais a serem incluídos no inventário. |
Field | container | Campos opcionais a serem incluídos no inventário. Os campos opcionais incluem: Nó pai: OptionalFields |
IncrementalInventory | container | Contêiner da configuração de inventário incremental. |
IsEnabled | Boolean | Indica se o inventário incremental deve ser ativado. Valores válidos:
Se true, o inventário incremental será ativado mesmo que o IsEnabled pai seja false. Nó pai: IncrementalInventory |
Schedule | container | Contêiner da programação de exportação do inventário incremental. Nó pai: IncrementalInventory |
Frequency | Integer | Frequência de exportação do inventário incremental, em segundos. O sistema exporta inventários incrementais em um intervalo fixo de 600 segundos. Em cada intervalo, o sistema cria automaticamente um prefixo de diretório e gera um arquivo de manifesto e vários arquivos CSV. Não há suporte para frequências personalizadas. Nó pai: Schedule |
OptionalFields | container | Contêiner dos campos opcionais a serem incluídos no inventário incremental. Nó pai: IncrementalInventory |
Field | String | Campos incluídos no inventário incremental. Nó pai: OptionalFields
|
Exemplos
-
Exemplo de solicitação
GET /?inventory HTTP/1.1 Host: BucketName.oss.aliyuncs.com Date: Fri, 24 Feb 2012 03:55:00 GMT Authorization: authorization string Content-Type: text/plain -
Exemplo de resposta
HTTP/1.1 200 OK x-oss-request-id: 56594298207FB304438516F9 Date: Sat, 30 Apr 2016 23:29:37 GMT Content-Type: application/xml Content-Length: length Connection: close Server: AliyunOSS <?xml version="1.0" encoding="UTF-8"?> <ListInventoryConfigurationsResult> <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:::destination-bucket</Bucket> <Prefix>prefix1</Prefix> </OSSBucketDestination> </Destination> <Schedule> <Frequency>Daily</Frequency> </Schedule> <Filter> <Prefix>prefix/One</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> <InventoryConfiguration> <Id>report2</Id> <IsEnabled>true</IsEnabled> <Destination> <OSSBucketDestination> <Format>CSV</Format> <AccountId>1000000000000000</AccountId> <RoleArn>acs:ram::1000000000000000:role/AliyunOSSRole</RoleArn> <Bucket>acs:oss:::destination-bucket</Bucket> <Prefix>prefix2</Prefix> </OSSBucketDestination> </Destination> <Schedule> <Frequency>Daily</Frequency> </Schedule> <Filter> <Prefix>prefix/Two</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> <InventoryConfiguration> <Id>report3</Id> <IsEnabled>true</IsEnabled> <Destination> <OSSBucketDestination> <Format>CSV</Format> <AccountId>1000000000000000</AccountId> <RoleArn>acs:ram::1000000000000000:role/AliyunOSSRole</RoleArn> <Bucket>acs:oss:::destination-bucket</Bucket> <Prefix>prefix3</Prefix> </OSSBucketDestination> </Destination> <Schedule> <Frequency>Daily</Frequency> </Schedule> <Filter> <Prefix>prefix/Three</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> ... <IsTruncated>true</IsTruncated> <NextContinuationToken>...</NextContinuationToken> </ListInventoryConfigurationsResult>
SDKs
Chame esta operação usando os seguintes SDKs:
Ossutil CLI
Para executar esta operação com o ossutil, consulte o comando list-bucket-inventory.