ObjectConditions

Kondisi yang menentukan objek mana yang ditransfer. Hanya berlaku untuk Sumber Data Cloud seperti S3, Azure, dan Cloud Storage.

"Waktu perubahan terakhir" mengacu pada waktu perubahan terakhir pada konten atau metadata objek — khususnya, ini adalah properti updated objek Cloud Storage, kolom LastModified objek S3, dan header Last-Modified blob Azure.

Transfer dengan sumber atau tujuan PosixFilesystem tidak mendukung ObjectConditions.

Representasi JSON 
{
  "minTimeElapsedSinceLastModification": string,
  "maxTimeElapsedSinceLastModification": string,
  "includePrefixes": [
    string
  ],
  "excludePrefixes": [
    string
  ],
  "lastModifiedSince": string,
  "lastModifiedBefore": string
}
Kolom
minTimeElapsedSinceLastModification

string (Duration format)

Memastikan bahwa objek tidak ditransfer hingga waktu minimum tertentu berlalu setelah "waktu perubahan terakhir". Saat TransferOperation dimulai, objek dengan "waktu perubahan terakhir" hanya ditransfer jika waktu yang berlalu antara startTime TransferOperation dan "waktu perubahan terakhir" objek sama dengan atau lebih besar dari nilai minTimeElapsedSinceLastModification`. Objek yang tidak memiliki "waktu perubahan terakhir" juga ditransfer.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
maxTimeElapsedSinceLastModification

string (Duration format)

Memastikan bahwa objek tidak ditransfer jika waktu maksimum tertentu telah berlalu sejak "waktu perubahan terakhir". Saat TransferOperation dimulai, objek dengan "waktu perubahan terakhir" hanya ditransfer jika waktu yang berlalu antara startTime TransferOperation dan "waktu perubahan terakhir" objek kurang dari nilai maxTimeElapsedSinceLastModification`. Objek yang tidak memiliki "waktu perubahan terakhir" juga ditransfer.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
includePrefixes[]

string

Jika Anda menentukan includePrefixes, Storage Transfer Service akan menggunakan item dalam array includePrefixes untuk menentukan objek yang akan disertakan dalam transfer. Objek harus diawali dengan salah satu includePrefixes yang cocok untuk disertakan dalam transfer. Jika excludePrefixes ditentukan, objek tidak boleh dimulai dengan excludePrefixes yang ditentukan untuk disertakan dalam transfer.

Berikut adalah persyaratan includePrefixes:

  • Setiap awalan include dapat berisi urutan karakter Unicode, dengan panjang maksimum 1.024 byte jika berenkode UTF8, dan tidak boleh berisi karakter Enter atau Line Feed. Pencocokan karakter pengganti dan pencocokan ekspresi reguler tidak didukung.

  • Setiap awalan include harus menghilangkan garis miring di awal. Misalnya, untuk menyertakan objek s3://my-aws-bucket/logs/y=2015/requests.gz, tentukan awalan include sebagai logs/y=2015/requests.gz.

  • Tidak ada nilai include-prefix yang boleh kosong, jika ditentukan.

  • Setiap awalan include harus menyertakan bagian yang berbeda dari namespace objek. Tidak ada awalan include-prefix yang dapat menjadi awalan dari awalan include-prefix lain.

Ukuran maksimum includePrefixes adalah 1.000.

Untuk mengetahui informasi selengkapnya, lihat Memfilter objek dari transfer.
excludePrefixes[]

string

Jika Anda menentukan excludePrefixes, Storage Transfer Service akan menggunakan item dalam array excludePrefixes untuk menentukan objek mana yang akan dikecualikan dari transfer. Objek tidak boleh diawali dengan salah satu excludePrefixes yang cocok untuk disertakan dalam transfer.

Berikut adalah persyaratan excludePrefixes:

  • Setiap awalan pengecualian dapat berisi urutan karakter Unicode apa pun, dengan panjang maksimum 1.024 byte jika dienkode UTF8, dan tidak boleh berisi karakter Enter atau Line Feed. Pencocokan karakter pengganti dan pencocokan ekspresi reguler tidak didukung.

  • Setiap awalan pengecualian harus menghilangkan garis miring di awal. Misalnya, untuk mengecualikan objek s3://my-aws-bucket/logs/y=2015/requests.gz, tentukan awalan pengecualian sebagai logs/y=2015/requests.gz.

  • Tidak ada nilai exclude-prefix yang boleh kosong, jika ditentukan.

  • Setiap awalan pengecualian harus mengecualikan bagian yang berbeda dari namespace objek. Tidak ada awalan exclude-prefix yang dapat menjadi awalan dari awalan exclude-prefix lainnya.

  • Jika includePrefixes ditentukan, setiap awalan pengecualian harus diawali dengan nilai jalur yang disertakan secara eksplisit oleh includePrefixes.

Ukuran maksimum excludePrefixes adalah 1.000.

Untuk mengetahui informasi selengkapnya, lihat Memfilter objek dari transfer.
lastModifiedSince

string (Timestamp format)

Jika ditentukan, hanya objek dengan "waktu terakhir diubah" pada atau setelah stempel waktu ini dan objek yang tidak memiliki "waktu terakhir diubah" yang akan ditransfer.

Kolom lastModifiedSince dan lastModifiedBefore dapat digunakan bersama untuk pemrosesan data yang dikelompokkan. Misalnya, pertimbangkan skrip yang memproses data setiap hari sekaligus. Untuk itu, Anda harus menetapkan setiap kolom sebagai berikut:

  • lastModifiedSince ke awal hari

  • lastModifiedBefore hingga akhir hari

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
lastModifiedBefore

string (Timestamp format)

Jika ditentukan, hanya objek dengan "waktu perubahan terakhir" sebelum stempel waktu ini dan objek yang tidak memiliki "waktu perubahan terakhir" yang akan ditransfer.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".