ObjectConditions

Conditions qui déterminent les objets à transférer. Ne s'applique qu'aux sources de données cloud telles que S3, Azure et Cloud Storage.

La date/heure de la dernière modification fait référence à l'heure de la dernière modification du contenu ou des métadonnées de l'objet. Plus précisément, il s'agit de la propriété updated des objets Cloud Storage, du champ LastModified des objets S3 et de l'en-tête Last-Modified des blobs Azure.

Les transferts avec une source ou une destination PosixFilesystem ne sont pas compatibles avec ObjectConditions.

Représentation JSON
{
  "minTimeElapsedSinceLastModification": string,
  "maxTimeElapsedSinceLastModification": string,
  "includePrefixes": [
    string
  ],
  "excludePrefixes": [
    string
  ],
  "lastModifiedSince": string,
  "lastModifiedBefore": string
}
Champs
minTimeElapsedSinceLastModification

string (Duration format)

Assure que les objets ne sont pas transférés tant qu'un délai minimal spécifique n'est pas écoulé après la date et l'heure de la dernière modification. Au début d'une TransferOperation, les objets avec une "date et heure de la dernière modification" ne sont transférés que si le temps écoulé entre la startTime de la TransferOperation et la "date et heure de la dernière modification" de l'objet est égal ou supérieur à la valeur de minTimeElapsedSinceLastModification. Les objets qui ne comportent pas de "date et heure de la dernière modification" sont également transférés.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

maxTimeElapsedSinceLastModification

string (Duration format)

Assure que les objets ne sont pas transférés si un délai maximal spécifique s'est écoulé depuis la date et l'heure de la dernière modification. Au début d'une TransferOperation, les objets avec une "date et heure de la dernière modification" ne sont transférés que si le temps écoulé entre le startTime de la TransferOperation et la "date et heure de la dernière modification" de l'objet est inférieur à la valeur de "maxTimeElapsedSinceLastModification". Les objets qui ne comportent pas de "date et heure de la dernière modification" sont également transférés.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

includePrefixes[]

string

Si vous spécifiez includePrefixes, le service de transfert de stockage utilise les éléments du tableau includePrefixes pour déterminer les objets à inclure dans un transfert. Pour être inclus dans le transfert, les objets doivent commencer par l'un des includePrefixes correspondants. Si excludePrefixes est spécifié, les objets ne doivent pas commencer par l'un des excludePrefixes spécifiés pour être inclus dans le transfert.

Les exigences concernant includePrefixes sont les suivantes:

  • Chaque préfixe d'inclusion peut contenir n'importe quelle séquence de caractères Unicode, avec une longueur maximale de 1 024 octets en UTF-8. Il ne doit pas contenir de caractères de retour chariot ni de saut de ligne. Les correspondances de caractères génériques et d'expressions régulières ne sont pas acceptées.

  • Chaque préfixe d'inclusion doit omettre le slash initial. Par exemple, pour inclure l'objet s3://my-aws-bucket/logs/y=2015/requests.gz, spécifiez le préfixe d'inclusion logs/y=2015/requests.gz.

  • Aucune des valeurs "include-prefix" ne peut être vide, le cas échéant.

  • Chaque préfixe d'inclusion doit inclure une partie distincte de l'espace de noms de l'objet. Aucun préfixe "include-prefix" ne peut être un préfixe d'un autre préfixe "include-prefix".

La taille maximale de includePrefixes est de 1 000.

Pour en savoir plus, consultez Filtrer les objets des transferts.

excludePrefixes[]

string

Si vous spécifiez excludePrefixes, le service de transfert de stockage utilise les éléments du tableau excludePrefixes pour déterminer les objets à exclure d'un transfert. Les objets ne doivent pas commencer par l'un des excludePrefixes correspondants pour être inclus dans un transfert.

Les exigences concernant excludePrefixes sont les suivantes:

  • Chaque préfixe d'exclusion peut contenir n'importe quelle séquence de caractères Unicode, avec une longueur maximale de 1 024 octets en UTF-8. Il ne doit pas contenir de caractères de retour chariot ni de saut de ligne. Les correspondances de caractères génériques et d'expressions régulières ne sont pas acceptées.

  • Chaque préfixe d'exclusion doit omettre la barre oblique initiale. Par exemple, pour exclure l'objet s3://my-aws-bucket/logs/y=2015/requests.gz, spécifiez le préfixe d'exclusion logs/y=2015/requests.gz.

  • Aucune des valeurs de préfixe d'exclusion ne peut être vide, le cas échéant.

  • Chaque préfixe d'exclusion doit exclure une partie distincte de l'espace de noms d'objet. Aucun préfixe "exclude-prefix" ne peut être un préfixe d'un autre préfixe "exclude-prefix".

  • Si includePrefixes est spécifié, chaque préfixe d'exclusion doit commencer par la valeur d'un chemin explicitement inclus par includePrefixes.

La taille maximale de excludePrefixes est de 1 000.

Pour en savoir plus, consultez Filtrer les objets des transferts.

lastModifiedSince

string (Timestamp format)

Si ce paramètre est spécifié, seuls les objets dont la date et l'heure de la dernière modification sont égales ou postérieures à ce code temporel et ceux qui ne comportent pas de date et d'heure de la dernière modification sont transférés.

Les champs lastModifiedSince et lastModifiedBefore peuvent être utilisés ensemble pour le traitement par blocs de données. Prenons l'exemple d'un script qui traite les données d'une journée à la fois. Pour ce faire, vous devez définir chacun des champs comme suit:

  • lastModifiedSince au début de la journée

  • lastModifiedBefore jusqu'à la fin de la journée

Utilise la norme RFC 3339, où la sortie générée est toujours normalisée avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

lastModifiedBefore

string (Timestamp format)

Si vous spécifiez cette valeur, seuls les objets dont la valeur "heure de la dernière modification" est antérieure à ce code temporel et ceux qui ne comportent pas de valeur "heure de la dernière modification" sont transférés.

Utilise la norme RFC 3339, où la sortie générée est toujours normalisée avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".