ObjectConditions

Bedingungen, die festlegen, welche Objekte übertragen werden. Gilt nur für Cloud-Datenquellen wie S3, Azure und Cloud Storage.

Der „Zeitpunkt der letzten Änderung“ bezieht sich auf den Zeitpunkt der letzten Änderung der Inhalte oder Metadaten des Objekts. Das ist die updated-Property von Cloud Storage-Objekten, das LastModified-Feld von S3-Objekten und der Last-Modified-Header von Azure-Blobs.

Für Fahrten mit einer PosixFilesystem-Quelle oder einem PosixFilesystem-Ziel wird ObjectConditions nicht unterstützt.

JSON-Darstellung
{
  "minTimeElapsedSinceLastModification": string,
  "maxTimeElapsedSinceLastModification": string,
  "includePrefixes": [
    string
  ],
  "excludePrefixes": [
    string
  ],
  "lastModifiedSince": string,
  "lastModifiedBefore": string
}
Felder
minTimeElapsedSinceLastModification

string (Duration format)

Sorgt dafür, dass Objekte erst nach Ablauf einer bestimmten Mindestdauer nach dem „Datum der letzten Änderung“ übertragen werden. Wenn eine TransferOperation beginnt, werden Objekte mit einem „Zeitpunkt der letzten Änderung“ nur übertragen, wenn die verstrichene Zeit zwischen dem startTime der TransferOperation und dem „Zeitpunkt der letzten Änderung“ des Objekts dem Wert von „minTimeElapsedSinceLastModification“ entspricht oder größer ist. Objekte ohne „Zeitpunkt der letzten Änderung“ werden ebenfalls übertragen.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

maxTimeElapsedSinceLastModification

string (Duration format)

Damit wird verhindert, dass Objekte übertragen werden, wenn seit dem „Zeitpunkt der letzten Änderung“ eine bestimmte maximale Zeit verstrichen ist. Wenn eine TransferOperation beginnt, werden Objekte mit einem „Zeitpunkt der letzten Änderung“ nur übertragen, wenn die verstrichene Zeit zwischen dem startTime der TransferOperation und dem „Zeitpunkt der letzten Änderung“ des Objekts kürzer als der Wert von „maxTimeElapsedSinceLastModification“ ist. Objekte ohne „Zeitpunkt der letzten Änderung“ werden ebenfalls übertragen.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

includePrefixes[]

string

Wenn Sie includePrefixes angeben, verwendet Storage Transfer Service die Elemente im includePrefixes-Array, um zu bestimmen, welche Objekte in eine Übertragung eingeschlossen werden sollen. Objekte müssen mit einer der übereinstimmenden includePrefixes beginnen, um in die Übertragung aufgenommen zu werden. Wenn excludePrefixes angegeben ist, dürfen Objekte nicht mit den excludePrefixes beginnen, die für die Übertragung festgelegt wurden.

Für includePrefixes gelten die folgenden Anforderungen:

  • Jedes Include-Präfix kann eine beliebige Folge von Unicode-Zeichen mit einer maximalen Länge von 1.024 Byte bei UTF-8-Codierung enthalten. Es darf keine Zeilenvorschub- oder Zeilenumbruchzeichen enthalten. Platzhalter und reguläre Ausdrücke werden nicht unterstützt.

  • Das erste Slash darf bei keinem Include-Präfix verwendet werden. Wenn Sie beispielsweise das Objekt s3://my-aws-bucket/logs/y=2015/requests.gz einschließen möchten, geben Sie das einschließende Präfix als logs/y=2015/requests.gz an.

  • Keiner der Werte für das Include-Präfix darf leer sein, sofern angegeben.

  • Jedes Include-Präfix muss einen bestimmten Teil des Objekt-Namespace angeben. Kein Include-Präfix darf ein Präfix eines anderen Include-Präfixes sein.

Die maximale Größe von includePrefixes beträgt 1.000.

Weitere Informationen finden Sie unter Objekte aus Übertragungen filtern.

excludePrefixes[]

string

Wenn Sie excludePrefixes angeben, verwendet der Storage Transfer Service die Elemente im excludePrefixes-Array, um zu bestimmen, welche Objekte von einer Übertragung ausgeschlossen werden sollen. Objekte dürfen nicht mit einem der übereinstimmenden excludePrefixes beginnen, um in eine Übertragung aufgenommen zu werden.

Für excludePrefixes gelten die folgenden Anforderungen:

  • Jedes Ausschlüssen-Präfix kann eine beliebige Folge von Unicode-Zeichen mit einer maximalen Länge von 1.024 Byte enthalten, wenn es mit UTF-8 codiert ist. Es darf keine Zeilenumbruch- oder Zeilenvorschubzeichen enthalten. Platzhalter und reguläre Ausdrücke werden nicht unterstützt.

  • Das erste Zeichen von Ausschlüssen darf kein Schrägstrich sein. Wenn Sie beispielsweise das Objekt s3://my-aws-bucket/logs/y=2015/requests.gz ausschließen möchten, geben Sie das ausschließende Präfix als logs/y=2015/requests.gz an.

  • Keiner der Werte für das Ausschlüsse-Präfix darf leer sein, sofern angegeben.

  • Jedes Ausschlüsse-Präfix muss einen bestimmten Teil des Objekt-Namespace ausschließen. Kein exclude-Prefix darf ein Präfix eines anderen exclude-Prefixes sein.

  • Wenn includePrefixes angegeben ist, muss jedes ausschließende Präfix mit dem Wert eines Pfads beginnen, der explizit durch includePrefixes eingeschlossen ist.

Die maximale Größe von excludePrefixes beträgt 1.000.

Weitere Informationen finden Sie unter Objekte aus Übertragungen filtern.

lastModifiedSince

string (Timestamp format)

Wenn dieser Parameter angegeben ist, werden nur Objekte mit einem „Datum der letzten Änderung“ an oder nach diesem Zeitstempel und Objekte ohne „Datum der letzten Änderung“ übertragen.

Die Felder lastModifiedSince und lastModifiedBefore können zusammen für die Verarbeitung von Daten in Chunks verwendet werden. Angenommen, Sie haben ein Script, das die Daten eines Tages verarbeitet. Dazu legen Sie die einzelnen Felder so fest:

  • lastModifiedSince bis zum Tagesbeginn

  • lastModifiedBefore bis zum Ende des Tages

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

lastModifiedBefore

string (Timestamp format)

Wenn Sie einen Zeitstempel angeben, werden nur Objekte mit einem Zeitstempel für die letzte Änderung vor diesem Zeitstempel und Objekte ohne Zeitstempel für die letzte Änderung übertragen.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".