Object Storage Service:PutBucketInventory

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Id

String

Sim

report1

Nome personalizado do inventário. O nome deve atender aos seguintes requisitos:

• Deve ser exclusivo dentro do bucket.

• Não pode exceder 192 caracteres.

IsEnabled

Boolean

Sim

true

Indica se o inventário está ativado.

Filter

Container

Não

N/A

Contêiner para o filtro, que especifica os critérios dos objetos a serem incluídos no inventário.

Prefix

String

Não

Pics/

Prefixo para filtragem de objetos.

Nó pai: Filter

LastModifyBeginTimeStamp

String

Não

1637883649

Início do intervalo de tempo da última modificação dos objetos. O valor é um timestamp UNIX em segundos.

Intervalo de valores: [1262275200, 253402271999]

LastModifyEndTimeStamp

String

Não

1638347592

Fim do intervalo de tempo da última modificação dos objetos. O valor é um timestamp UNIX em segundos.

Intervalo de valores: [1262275200, 253402271999]

LowerSizeBound

String

Não

1024

Tamanho mínimo (em bytes) dos objetos a serem incluídos no inventário.

O valor deve ser maior ou igual a 0 B e menor ou igual a 48,8 TB.

UpperSizeBound

String

Não

1048576

Tamanho máximo (em bytes) dos objetos a serem incluídos no inventário.

O valor deve ser maior que 0 B e menor ou igual a 48,8 TB.

StorageClass

String

Não

Standard,IA

Classes de armazenamento dos objetos a serem incluídos no inventário. É possível especificar várias classes de armazenamento.

Destination

Container

Sim

N/A

Contêiner com informações sobre o destino onde os relatórios de inventário são armazenados.

OSSBucketDestination

Container

Sim

N/A

Contêiner com informações sobre o bucket onde os relatórios de inventário são armazenados.

Nó pai: Destination

Format

String

Sim

CSV

Formato do relatório de inventário. O relatório é um arquivo CSV compactado com GZIP.

Valor válido: CSV

Nó pai: OSSBucketDestination

AccountId

String

Sim

100000000000000

ID da conta Alibaba Cloud proprietária do bucket de destino.

Nó pai: OSSBucketDestination

RoleArn

String

Sim

acs:ram::100000000000000:role/AliyunOSSRole

ARN (Alibaba Cloud Resource Name) da função do RAM com permissões para ler todos os objetos do bucket de origem e gravar objetos no bucket de destino. O formato é acs:ram::uid:role/rolename.

Nó pai: OSSBucketDestination

Bucket

String

Sim

acs:oss:::bucket_0001

Bucket de destino do relatório de inventário.

Nó pai: OSSBucketDestination

Prefix

String

Não

prefix1/

Prefixo do caminho onde os arquivos do relatório de inventário são armazenados.

Nó pai: OSSBucketDestination

Encryption

Container

Não

N/A

Contêiner para a configuração de criptografia no lado do servidor do relatório de inventário.

Valores válidos:

• SSE-OSS: usa chaves gerenciadas pelo OSS para criptografia e descriptografia.

• SSE-KMS: usa uma chave mestra de cliente (CMK) padrão ou especificada, gerenciada pelo Key Management Service (KMS), para criptografia e descriptografia.

Nó pai: OSSBucketDestination

Para obter mais informações sobre criptografia no lado do servidor, consulte Criptografia no lado do servidor.

SSE-OSS

Container

Não

N/A

Contêiner para a configuração de criptografia SSE-OSS.

Nó pai: Encryption

SSE-KMS

Container

Não

N/A

Contêiner para a configuração de criptografia SSE-KMS.

Nó pai: Encryption

KeyId

String

Não

keyId

ID da CMK gerenciada pelo KMS.

Nó pai: SSE-KMS

Schedule

Container

Sim

N/A

Contêiner para a programação de geração do relatório de inventário.

Frequency

String

Sim

Daily

Define a frequência de geração do relatório de inventário.

Valores válidos:

• Daily: os relatórios de inventário são gerados diariamente.

• Weekly: os relatórios de inventário são gerados semanalmente.

• Monthly: os relatórios de inventário são gerados mensalmente.

• Once: o relatório de inventário é gerado apenas uma vez.

Nó pai: Schedule

DayOfMonth

Inteiro positivo

Não

1

Se Frequency estiver definido como Monthly, especifica o dia do mês para gerar o inventário. O valor deve ser um inteiro positivo de 1 a 31.

• Caso DayOfMonth não seja especificado, o inventário será gerado em um intervalo fixo de 30 dias. A primeira varredura começa no dia em que a regra é configurada, e os relatórios subsequentes são gerados a cada 30 dias.

• Se o valor estiver entre 1 e 28, a tarefa de inventário começa no dia especificado de cada mês.

• Se o valor estiver entre 29 e 31, a tarefa começa nesse dia caso o mês o possua. Caso contrário, a tarefa começa no último dia do mês. Por exemplo, se você definir o valor como 31, a tarefa começará em 30 de abril.

Nó pai: Schedule

AutoDelete

Boolean

Não

true

Especifica se a configuração de inventário deve ser excluída após a geração de um inventário único. Este elemento é válido apenas quando Frequency está definido como Once.

Valores válidos: true, false

Nó pai: Schedule

IncludedObjectVersions

String

Sim

All

Define se as versões dos objetos devem ser incluídas no inventário.

OptionalFields

Container

Não

N/A

Contêiner para os campos opcionais a serem incluídos no relatório de inventário.

Field

String

Não

Size

Campos opcionais a serem incluídos no relatório de inventário.

• Key: nome do objeto no bucket. O nome é codificado em URL.

• VersionId: ID da versão do objeto. Este campo é incluído apenas se IncludedObjectVersions estiver definido como All.

  • Se o controle de versão não estiver ativado para o bucket, este campo estará vazio.

  • Se o controle de versão estiver ativado para o bucket, este campo conterá o ID da versão do objeto.

• IsDeleteMarker: indica se a versão do objeto é um marcador de exclusão. Este campo é incluído apenas se IncludedObjectVersions estiver definido como All.

  • Se o controle de versão não estiver ativado para o bucket, este campo será definido como false por padrão.

  • Se o controle de versão estiver ativado e o objeto for um marcador de exclusão, este campo será definido como true. Se o objeto não for um marcador de exclusão, este campo será definido como false.

• Size: tamanho do objeto.

• StorageClass: classe de armazenamento do objeto.

• TransitionTime: momento em que o objeto foi transferido para a classe de armazenamento Archive ou Cold Archive por uma regra de ciclo de vida.

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

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

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

  • Para um objeto criado por outros métodos, o ETag é um valor exclusivo calculado com base em uma regra específica e não corresponde ao hash MD5 do conteúdo do objeto.

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

• ObjectType: tipo do objeto.

• ObjectAcl: lista de controle de acesso (ACL) do objeto.

• Crc64: valor CRC-64 do objeto.

• EncryptionStatus: indica se o objeto está criptografado.

• TaggingCount: quantidade de tags.

IncrementalInventory

Container

Não

N/A

Contêiner para a configuração do inventário incremental.

IsEnabled

Boolean

Sim

true

Define se o inventário incremental deve ser ativado. Valores válidos:

• true: ativa o inventário incremental.

• false: desativa o inventário incremental.

Se este elemento estiver definido como true, o inventário incremental será ativado e entrará em vigor mesmo que InventoryConfiguration/IsEnabled esteja definido como false.

Nó pai: IncrementalInventory

Schedule

Container

Sim

N/A

Contêiner para a programação de geração do inventário incremental.

Nó pai: IncrementalInventory

Frequency

Inteiro positivo

Sim

600

Frequência de geração do inventário incremental, em segundos.

O sistema utiliza uma frequência fixa de 600 segundos. Em cada período, um prefixo de diretório é criado automaticamente, juntamente com um arquivo de manifesto correspondente e vários arquivos CSV gerados durante esse período. Não há suporte para frequências personalizadas.

Nó pai: Schedule

OptionalFields

Container

Não

N/A

Contêiner para as propriedades a serem incluídas no arquivo de inventário incremental.

Nó pai: IncrementalInventory

Field

String

Não

Size

Campos a serem incluídos no inventário incremental.

Nó pai: OptionalFields

• SequenceNumber: número de sequência exclusivo para cada registro. Para registros do mesmo objeto no mesmo bucket, é possível ordená-los por SequenceNumber. Os registros ordenados geralmente seguem uma ordem cronológica.

• RecordType: tipo de evento. Valores válidos: CREATE, UPDATE_METADATA e DELETE.

  • CREATE: inclui todos os métodos de upload de objetos sob o prefixo selecionado, como Put, Post, Append, MultipartUpload e Copy.

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

  • DELETE: inclui todos os métodos de exclusão de objetos sob o prefixo selecionado, como DeleteObject, DeleteMultipleObjects, geração de marcadores de exclusão após a ativação do controle de versão e exclusão baseada em ciclo de vida. As exclusões incluem tanto marcadores de exclusão quanto exclusões permanentes. Para registros de exclusão permanente, apenas os campos principais Bucket, Key, SequenceNumber, RecordType, RecordTimestamp e VersionId são mantidos; as demais colunas ficam nulas.

• RecordTimestamp: timestamp do registro, em GMT, com precisão de milissegundos. Exemplo: "2024-08-25 18:08:01.024".

• Requester: ID da conta Alibaba Cloud ou ID principal do solicitante.

• RequestId: identificador exclusivo da solicitação.

• SourceIp: endereço IP de origem do solicitante.

• Key: nome do objeto no bucket. O nome é codificado em URL.

• VersionId: ID da versão do objeto. Este campo é incluído apenas se a regra de inventário estiver configurada para exportar todas as versões.

  • Se o controle de versão não estiver ativado para o bucket, este campo estará vazio.

  • Se o controle de versão estiver ativado para o bucket, este campo conterá o ID da versão do objeto.

• IsDeleteMarker: indica se a versão do objeto é um marcador de exclusão. Este campo é incluído apenas se a regra de inventário estiver configurada para exportar todas as versões.

  • Se o controle de versão não estiver ativado para o bucket, este campo será definido como false por padrão.

  • Se o controle de versão estiver ativado e o objeto for um marcador de exclusão, este campo será definido como true. Se o objeto não for um marcador de exclusão, este campo será definido como false.

• Size: tamanho do objeto.

• StorageClass: classe de armazenamento do objeto.

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

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

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

  • Para um objeto criado por outros métodos, o ETag é um valor exclusivo calculado com base em uma regra específica e não corresponde ao hash MD5 do conteúdo do objeto.

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

• ObjectType: tipo do objeto.

• ObjectAcl: lista de controle de acesso (ACL) do objeto.

• Crc64: valor CRC-64 do objeto.

• EncryptionStatus: indica se o objeto está criptografado.

Código de erro

Código de status HTTP

Descrição

InvalidArgument

400

Um ou mais parâmetros especificados são inválidos.

InventoryExceedLimit

400

A quantidade de regras de inventário configuradas excede o limite.

AccessDenied

403

• Credenciais de autenticação ausentes na solicitação PutBucketInventory.

• Você não tem autorização para realizar esta operação.

InventoryAlreadyExist

409

A regra de inventário já existe.