ObjectConditions

Condições que determinam quais objetos são transferidos. Se aplica apenas a origens de dados do Cloud, como S3, Azure e Cloud Storage.

O "horário da última modificação" se refere ao horário da última mudança no conteúdo ou nos metadados do objeto. Especificamente, é a propriedade updated dos objetos do Cloud Storage, o campo LastModified dos objetos do S3 e o cabeçalho Last-Modified dos blobs do Azure.

As transferências com uma origem ou um destino PosixFilesystem não são compatíveis com ObjectConditions.

Representação JSON
{
  "minTimeElapsedSinceLastModification": string,
  "maxTimeElapsedSinceLastModification": string,
  "includePrefixes": [
    string
  ],
  "excludePrefixes": [
    string
  ],
  "lastModifiedSince": string,
  "lastModifiedBefore": string
}
Campos
minTimeElapsedSinceLastModification

string (Duration format)

Garante que os objetos não sejam transferidos até que um tempo mínimo específico tenha decorrido após a "última modificação". Quando uma TransferOperation começa, os objetos com uma "última modificação" são transferidos somente se o tempo decorrido entre o startTime do TransferOperation e a "última modificação" do objeto for igual ou maior que o valor de minTimeElapsedSinceLastModification. Os objetos que não tiverem uma "última modificação" também são transferidos.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

maxTimeElapsedSinceLastModification

string (Duration format)

Garante que os objetos não sejam transferidos se um tempo máximo específico tiver decorrido desde a "última modificação". Quando uma TransferOperation começa, os objetos com uma "última modificação" são transferidos somente se o tempo decorrido entre o startTime do TransferOperation e a "última modificação" do objeto for menor que o valor de maxTimeElapsedSinceLastModification. Os objetos que não têm uma "última modificação" também são transferidos.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

includePrefixes[]

string

Se você especificar includePrefixes, o Serviço de transferência do Storage vai usar os itens na matriz includePrefixes para determinar quais objetos incluir em uma transferência. Os objetos precisam começar com um dos includePrefixes correspondentes para serem incluídos na transferência. Se excludePrefixes for especificado, os objetos não poderão começar com nenhum dos excludePrefixes especificados para inclusão na transferência.

Estes são os requisitos de includePrefixes:

  • Cada prefixo de inclusão pode conter qualquer sequência de caracteres Unicode, com um comprimento máximo de 1.024 bytes quando codificado em UTF-8, e não pode conter caracteres de retorno de carro ou de nova linha. Não há suporte para correspondência de caracteres curinga e expressões regulares.

  • Cada prefixo de inclusão precisa omitir a barra inicial. Por exemplo, para incluir o objeto s3://my-aws-bucket/logs/y=2015/requests.gz, especifique o prefixo de inclusão como logs/y=2015/requests.gz.

  • Nenhum dos valores de prefixo de inclusão pode estar vazio, se especificado.

  • Cada prefixo de inclusão precisa incluir uma parte distinta do namespace do objeto. Nenhum prefixo de inclusão pode ser um prefixo de outro prefixo de inclusão.

O tamanho máximo de includePrefixes é 1.000.

Para mais informações, consulte Como filtrar objetos em transferências.

excludePrefixes[]

string

Se você especificar excludePrefixes, o Serviço de transferência do Cloud Storage vai usar os itens na matriz excludePrefixes para determinar quais objetos serão excluídos de uma transferência. Os objetos não podem começar com um dos excludePrefixes correspondentes para inclusão em uma transferência.

Estes são os requisitos de excludePrefixes:

  • Cada prefixo de exclusão pode conter qualquer sequência de caracteres Unicode, com um comprimento máximo de 1.024 bytes quando codificado em UTF-8, e não pode conter caracteres de retorno de carro ou nova linha. Não há suporte para correspondência de caracteres curinga e expressões regulares.

  • Cada prefixo de exclusão precisa omitir a barra inicial. Por exemplo, para excluir o objeto s3://my-aws-bucket/logs/y=2015/requests.gz, especifique o prefixo de exclusão como logs/y=2015/requests.gz.

  • Nenhum dos valores de prefixo de exclusão pode estar vazio, se especificado.

  • Cada prefixo de exclusão precisa excluir uma parte distinta do namespace do objeto. Nenhum prefixo de exclusão pode ser um prefixo de outro prefixo de exclusão.

  • Se includePrefixes for especificado, cada prefixo de exclusão precisará começar com o valor de um caminho incluído explicitamente por includePrefixes.

O tamanho máximo de excludePrefixes é 1.000.

Para mais informações, consulte Como filtrar objetos em transferências.

lastModifiedSince

string (Timestamp format)

Se especificado, apenas os objetos com uma "última modificação" igual ou posterior a esse carimbo de data/hora e os que não têm uma "última modificação" são transferidos.

Os campos lastModifiedSince e lastModifiedBefore podem ser usados juntos para processamento de dados em blocos. Por exemplo, considere um script que processa os dados de cada dia de uma vez. Para isso, defina cada um dos campos da seguinte maneira:

  • lastModifiedSince até o início do dia

  • lastModifiedBefore até o fim do dia

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

lastModifiedBefore

string (Timestamp format)

Se especificado, apenas os objetos com uma "última modificação" antes desse carimbo de data/hora e os que não têm uma "última modificação" são transferidos.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".