ObjectConditions

Son las condiciones que determinan qué objetos se transfieren. Solo se aplica a fuentes de datos de Cloud, como S3, Azure y Cloud Storage.

La “hora de modificación” hace referencia a la hora del último cambio en el contenido o los metadatos del objeto; específicamente, es la propiedad updated de los objetos de Cloud Storage, el campo LastModified de los objetos de S3 y el encabezado Last-Modified de los blobs de Azure.

Las transferencias con una fuente o un destino PosixFilesystem no admiten ObjectConditions.

Representación JSON
{
  "minTimeElapsedSinceLastModification": string,
  "maxTimeElapsedSinceLastModification": string,
  "includePrefixes": [
    string
  ],
  "excludePrefixes": [
    string
  ],
  "lastModifiedSince": string,
  "lastModifiedBefore": string
}
Campos
minTimeElapsedSinceLastModification

string (Duration format)

Garantiza que los objetos no se transfieran hasta que haya transcurrido un tiempo mínimo específico después de la "última hora de modificación". Cuando comienza un TransferOperation, los objetos con una "última hora de modificación" se transfieren solo si el tiempo transcurrido entre el startTime de TransferOperation y la "última hora de modificación" del objeto es igual o mayor que el valor de minTimeElapsedSinceLastModification. También se transfieren los objetos que no tienen una "última hora de modificación".

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

maxTimeElapsedSinceLastModification

string (Duration format)

Garantiza que los objetos no se transfieran si transcurrió un tiempo máximo específico desde la "última vez que se modificaron". Cuando comienza una TransferOperation, los objetos con una "última hora de modificación" se transfieren solo si el tiempo transcurrido entre el startTime de la TransferOperation y la "última hora de modificación" del objeto es inferior al valor de "maxTimeElapsedSinceLastModification". También se transfieren los objetos que no tienen una "última hora de modificación".

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

includePrefixes[]

string

Si especificas includePrefixes, el Servicio de transferencia de almacenamiento usa los elementos del array includePrefixes para determinar qué objetos incluir en una transferencia. Los objetos deben comenzar con uno de los includePrefixes coincidentes para incluirse en la transferencia. Si se especifica excludePrefixes, los objetos no deben comenzar con ninguno de los excludePrefixes especificados para incluirlos en la transferencia.

Los siguientes son requisitos de includePrefixes:

  • Cada prefijo de inclusión puede contener cualquier secuencia de caracteres Unicode, con una longitud máxima de 1,024 bytes cuando se codifica en UTF-8, y no debe contener caracteres de retorno de carro ni de salto de línea. No se admiten la concordancia con comodines ni la concordancia con expresiones regulares.

  • Cada prefijo de inclusión debe omitir la barra inicial. Por ejemplo, para incluir el objeto s3://my-aws-bucket/logs/y=2015/requests.gz, especifica el prefijo de inclusión como logs/y=2015/requests.gz.

  • Si se especifican, ninguno de los valores de prefijo de inclusión puede estar vacío.

  • Cada prefijo de inclusión debe incluir una parte distinta del espacio de nombres del objeto. Ningún prefijo de inclusión puede ser un prefijo de otro prefijo de inclusión.

El tamaño máximo de includePrefixes es 1,000.

Para obtener más información, consulta Cómo filtrar objetos de transferencias.

excludePrefixes[]

string

Si especificas excludePrefixes, el Servicio de transferencia de almacenamiento usa los elementos del array excludePrefixes para determinar qué objetos se excluirán de una transferencia. Los objetos no deben comenzar con uno de los excludePrefixes coincidentes para incluirse en una transferencia.

Los siguientes son requisitos de excludePrefixes:

  • Cada prefijo de exclusión puede contener cualquier secuencia de caracteres Unicode, con una longitud máxima de 1,024 bytes cuando se codifica en UTF-8, y no debe contener caracteres de retorno de carro ni salto de línea. No se admiten la concordancia con comodines ni la concordancia con expresiones regulares.

  • Cada prefijo de exclusión debe omitir la barra diagonal inicial. Por ejemplo, para excluir el objeto s3://my-aws-bucket/logs/y=2015/requests.gz, especifica el prefijo de exclusión como logs/y=2015/requests.gz.

  • Si se especifican, ninguno de los valores de prefijo de exclusión puede estar vacío.

  • Cada exclude-prefix debe excluir una parte distinta del espacio de nombres del objeto. Ningún prefijo de exclusión puede ser un prefijo de otro prefijo de exclusión.

  • Si se especifica includePrefixes, cada prefijo de exclusión debe comenzar con el valor de una ruta de acceso que includePrefixes incluye de forma explícita.

El tamaño máximo de excludePrefixes es 1,000.

Para obtener más información, consulta Cómo filtrar objetos de transferencias.

lastModifiedSince

string (Timestamp format)

Si se especifica, solo se transferirán los objetos con una "última hora de modificación" a partir de esta marca de tiempo y los que no tengan una "última hora de modificación".

Los campos lastModifiedSince y lastModifiedBefore se pueden usar juntos para el procesamiento de datos por fragmentos. Por ejemplo, considera una secuencia de comandos que procesa los datos de cada día a la vez. Para ello, debes configurar cada uno de los campos de la siguiente manera:

  • lastModifiedSince al inicio del día

  • lastModifiedBefore hasta el final del día

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

lastModifiedBefore

string (Timestamp format)

Si se especifica, solo se transfieren los objetos con una "última hora de modificación" anterior a esta marca de tiempo y los que no tienen una "última hora de modificación".

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".