ObjectConditions

転送するオブジェクトを決定する条件。S3、Azure、Cloud Storage などの Cloud データソースにのみ適用されます。

「最終更新日時」は、オブジェクトのコンテンツまたはメタデータが最後に変更された日時を指します。具体的には、Cloud Storage オブジェクトの updated プロパティ、S3 オブジェクトの LastModified フィールド、Azure Blob の Last-Modified ヘッダーです。

移行元または移行先が PosixFilesystem の転送は、ObjectConditions をサポートしていません。

JSON 表現 
{
  "minTimeElapsedSinceLastModification": string,
  "maxTimeElapsedSinceLastModification": string,
  "includePrefixes": [
    string
  ],
  "excludePrefixes": [
    string
  ],
  "lastModifiedSince": string,
  "lastModifiedBefore": string
}
フィールド
minTimeElapsedSinceLastModification

string (Duration format)

「最終更新日時」から特定の最小時間が経過するまで、オブジェクトが転送されないようにします。TransferOperation の開始時に、「最終更新日時」が設定されているオブジェクトが転送されるのは、TransferOperation の startTime とオブジェクトの「最終更新日時」の間の経過時間が minTimeElapsedSinceLastModification の値以上の場合のみです。「最終更新日時」が設定されていないオブジェクトも転送されます。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。
maxTimeElapsedSinceLastModification

string (Duration format)

「最終更新日時」から特定の最大時間が経過した場合、オブジェクトが転送されないようにします。TransferOperation の開始時に、「最終更新日時」が設定されているオブジェクトは、TransferOperation の startTime とオブジェクトの「最終更新日時」の間の経過時間が maxTimeElapsedSinceLastModification の値より短い場合にのみ転送されます。「最終更新日時」が設定されていないオブジェクトも転送されます。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。
includePrefixes[]

string

includePrefixes を指定すると、Storage Transfer Service は includePrefixes 配列内の項目を使用して、転送に含めるオブジェクトを決定します。転送に含めるオブジェクトは、一致する includePrefixes のいずれかで始まる必要があります。excludePrefixes が指定されている場合、オブジェクトは、転送に含めるように指定された excludePrefixes で始まってはなりません。

includePrefixes の要件は次のとおりです。

  • 各 include-prefix には、UTF8 エンコードで最大 1,024 バイトの長さの任意の Unicode 文字列を含めることができます。改行文字やラインフィード文字を含めることはできません。ワイルドカード照合と正規表現照合は、サポートされていません。

  • 各包含接頭辞の先頭のスラッシュは省略する必要があります。たとえば、オブジェクト s3://my-aws-bucket/logs/y=2015/requests.gz を含めるには、包括接頭辞を logs/y=2015/requests.gz として指定します。

  • 指定する場合、包含接頭辞の値を空にすることはできません。

  • 各 include-prefix には、オブジェクトの名前空間の個別の部分を含める必要があります。包含接頭辞に別の接頭辞を含めることはできません。

includePrefixes の最大サイズは 1,000 です。

詳細については、転送からオブジェクトを除外するをご覧ください。
excludePrefixes[]

string

excludePrefixes を指定すると、Storage Transfer Service は excludePrefixes 配列内のアイテムを使用して、転送から除外するオブジェクトを決定します。転送に含めるオブジェクトの先頭は、一致する excludePrefixes のいずれかであってはなりません。

excludePrefixes の要件は次のとおりです。

  • 各除外接頭辞には、UTF8 エンコードで最大 1,024 バイトの Unicode 文字列を含めることができます。キャリッジ リターン文字や改行文字を含めることはできません。ワイルドカード照合と正規表現照合は、サポートされていません。

  • 各除外接頭辞の先頭のスラッシュは省略する必要があります。たとえば、オブジェクト s3://my-aws-bucket/logs/y=2015/requests.gz を除外するには、除外接頭辞を logs/y=2015/requests.gz として指定します。

  • 除外接頭辞の値は、指定する場合は空にできません。

  • 各除外接頭辞には、オブジェクトの名前空間の個別の部分を除外する必要があります。除外接頭辞に別の接頭辞を含めることはできません。

  • includePrefixes を指定する場合、各除外接頭辞は、includePrefixes によって明示的に含められたパスの値で始まる必要があります。

excludePrefixes の最大サイズは 1,000 です。

詳細については、転送からオブジェクトを除外するをご覧ください。
lastModifiedSince

string (Timestamp format)

指定した場合、このタイムスタンプ以降の「最終更新日時」を持つオブジェクトと「最終更新日時」がないオブジェクトのみが転送されます。

lastModifiedSince フィールドと lastModifiedBefore フィールドを組み合わせて、チャンク化されたデータ処理を行うことができます。たとえば、1 日分のデータを一度に処理するスクリプトについて考えてみましょう。そのためには、各フィールドを次のように設定します。

  • lastModifiedSince から 1 日の始まり

  • lastModifiedBefore から当日まで

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
lastModifiedBefore

string (Timestamp format)

指定した場合、このタイムスタンプより前の「最終更新日時」を持つオブジェクトと「最終更新日時」がないオブジェクトのみが転送されます。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。