ObjectConditions

Condizioni che determinano quali oggetti vengono trasferiti. Si applica solo alle origini dati cloud come S3, Azure e Cloud Storage.

Per "data e ora dell'ultima modifica" si intende la data e l'ora dell'ultima modifica dei contenuti o dei metadati dell'oggetto. Nello specifico, si tratta della proprietà updated degli oggetti Cloud Storage, del campo LastModified degli oggetti S3 e dell'intestazione Last-Modified dei blob di Azure.

I trasferimenti con un'origine o una destinazione PosixFilesystem non supportano ObjectConditions.

Rappresentazione JSON
{
  "minTimeElapsedSinceLastModification": string,
  "maxTimeElapsedSinceLastModification": string,
  "includePrefixes": [
    string
  ],
  "excludePrefixes": [
    string
  ],
  "lastModifiedSince": string,
  "lastModifiedBefore": string
}
Campi
minTimeElapsedSinceLastModification

string (Duration format)

Garantisce che gli oggetti non vengano trasferiti finché non è trascorso un periodo di tempo minimo specificato dopo l'ora dell'ultima modifica. Quando inizia un TransferOperation, gli oggetti con un "ora dell'ultima modifica" vengono trasferiti solo se il tempo trascorso tra l'startTime del TransferOperation e l'"ora dell'ultima modifica" dell'oggetto è uguale o superiore al valore di "minTimeElapsedSinceLastModification". Vengono trasferiti anche gli oggetti che non hanno un "ora dell'ultima modifica".

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

maxTimeElapsedSinceLastModification

string (Duration format)

Garantisce che gli oggetti non vengano trasferiti se è trascorso un tempo massimo specifico dall'ora dell'ultima modifica. Quando inizia un TransferOperation, gli oggetti con un "momento dell'ultima modifica" vengono trasferiti solo se il tempo trascorso tra il startTime del TransferOperatione il "momento dell'ultima modifica" dell'oggetto è inferiore al valore di maxTimeElapsedSinceLastModification. Vengono trasferiti anche gli oggetti che non hanno un "momento dell'ultima modifica".

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

includePrefixes[]

string

Se specifichi includePrefixes, Storage Transfer Service utilizza gli elementi dell'array includePrefixes per determinare quali oggetti includere in un trasferimento. Gli oggetti devono iniziare con uno dei valori includePrefixes corrispondenti per essere inclusi nel trasferimento. Se è specificato excludePrefixes, gli oggetti non devono iniziare con nessuno dei excludePrefixes specificati per l'inclusione nel trasferimento.

Di seguito sono riportati i requisiti di includePrefixes:

  • Ogni prefisso include può contenere qualsiasi sequenza di caratteri Unicode, con una lunghezza massima di 1024 byte quando è codificato in UTF-8 e non deve contenere caratteri di ritorno a capo o di a capo. La ricerca di corrispondenze tramite caratteri jolly e espressioni regolari non è supportata.

  • Ogni prefisso include deve omettere la barra iniziale. Ad esempio, per includere l'oggetto s3://my-aws-bucket/logs/y=2015/requests.gz, specifica il prefisso include come logs/y=2015/requests.gz.

  • Nessuno dei valori del prefisso include può essere vuoto, se specificato.

  • Ogni prefisso include deve includere una parte distinta dello spazio dei nomi dell'oggetto. Nessun prefisso include-prefix può essere un prefisso di un altro prefisso include-prefix.

La dimensione massima di includePrefixes è 1000.

Per ulteriori informazioni, vedi Filtrare gli oggetti dai trasferimenti.

excludePrefixes[]

string

Se specifichi excludePrefixes, Storage Transfer Service utilizza gli elementi dell'array excludePrefixes per determinare quali oggetti escludere da un trasferimento. Gli oggetti non devono iniziare con uno dei excludePrefixes corrispondenti per essere inclusi in un trasferimento.

Di seguito sono riportati i requisiti di excludePrefixes:

  • Ogni prefisso di esclusione può contenere qualsiasi sequenza di caratteri Unicode, con una lunghezza massima di 1024 byte quando è codificato in UTF-8 e non deve contenere caratteri di a capo o di ritorno a capo. La ricerca di corrispondenze tramite caratteri jolly e espressioni regolari non è supportata.

  • Ogni prefisso di esclusione deve omettere la barra iniziale. Ad esempio, per escludere l'oggetto s3://my-aws-bucket/logs/y=2015/requests.gz, specifica il prefisso di esclusione come logs/y=2015/requests.gz.

  • Nessuno dei valori del prefisso di esclusione può essere vuoto, se specificato.

  • Ogni prefisso di esclusione deve escludere una parte distinta dello spazio dei nomi dell'oggetto. Nessun prefisso di esclusione può essere un prefisso di un altro prefisso di esclusione.

  • Se è specificato includePrefixes, ogni prefisso di esclusione deve iniziare con il valore di un percorso incluso esplicitamente da includePrefixes.

La dimensione massima di excludePrefixes è 1000.

Per ulteriori informazioni, vedi Filtrare gli oggetti dai trasferimenti.

lastModifiedSince

string (Timestamp format)

Se specificato, vengono trasferiti solo gli oggetti con una "data e ora ultima modifica" uguale o successiva a questo timestamp e gli oggetti che non hanno una "data e ora ultima modifica".

I campi lastModifiedSince e lastModifiedBefore possono essere utilizzati insieme per l'elaborazione dei dati suddivisi in blocchi. Ad esempio, prendiamo in considerazione uno script che elabora i dati di un giorno alla volta. A questo scopo, devi impostare ciascun campo come segue:

  • lastModifiedSince all'inizio della giornata

  • lastModifiedBefore fino alla fine della giornata

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

lastModifiedBefore

string (Timestamp format)

Se specificato, vengono trasferiti solo gli oggetti con un "ora dell'ultima modifica" precedente a questo timestamp e gli oggetti che non hanno un'"ora dell'ultima modifica".

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".