Pemicu - AWS Glue

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Pemicu

Triggers API menjelaskan tipe data dan API yang terkait dengan pembuatan, pembaruan, atau penghapusan, serta memulai dan menghentikan pemicu pekerjaan. AWS Glue

Tipe Data

Struktur pemicu

Informasi tentang sebuah pemicu tertentu.

Bidang
  • Name — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Nama pemicu.

  • WorkflowName — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Nama alur kerja yang dikaitkan dengan pemicu.

  • Id — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Disimpan untuk digunakan di masa depan.

  • Type – String UTF-8 (nilai yang valid: SCHEDULED | CONDITIONAL | ON_DEMAND | EVENT).

    Jenis pemicu yang ini.

  • State – String UTF-8 (nilai yang valid: CREATING | CREATED | ACTIVATING | ACTIVATED | DEACTIVATING | DEACTIVATED | DELETING | UPDATING).

    Status pemicu saat ini.

  • Description — String deskripsi, dengan panjang tidak lebih dari 2048 byte, yang cocok dengan URI address multi-line string pattern.

    Deskripsi pemicu ini.

  • Schedule – String UTF-8.

    Sebuah ekspresi cron yang digunakan untuk menentukan jadwal (lihat Jadwal Berbasis Waktu untuk Tugas dan Crawler. Sebagai contoh, untuk menjalankan sesuatu setiap hari pada 12:15 UTC, Anda harus menentukan cron(15 12 * * ? *).

  • Actions – Susunan objek Tindakan.

    Tindakan yang dimulai oleh pemicu ini.

  • Predicate — Sebuah objek Predikat.

    Predikat pemicu ini, yang menentukan kapan akan aktif.

  • EventBatchingCondition — Sebuah objek EventBatchingCondition.

    Kondisi batch yang harus dipenuhi (jumlah peristiwa tertentu yang diterima atau jendela waktu batch kedaluwarsa) sebelum pemicu EventBridge peristiwa terjadi kebakaran.

TriggerUpdate struktur

Struktur yang digunakan untuk memberikan informasi yang digunakan untuk memperbarui sebuah pemicu. Objek ini memperbarui definisi pemicu sebelumnya dengan menimpa semuanya.

Bidang
  • Name — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Disimpan untuk digunakan di masa depan.

  • Description — String deskripsi, dengan panjang tidak lebih dari 2048 byte, yang cocok dengan URI address multi-line string pattern.

    Deskripsi pemicu ini.

  • Schedule – String UTF-8.

    Sebuah ekspresi cron yang digunakan untuk menentukan jadwal (lihat Jadwal Berbasis Waktu untuk Tugas dan Crawler. Sebagai contoh, untuk menjalankan sesuatu setiap hari pada 12:15 UTC, Anda harus menentukan cron(15 12 * * ? *).

  • Actions – Susunan objek Tindakan.

    Tindakan yang dimulai oleh pemicu ini.

  • Predicate — Sebuah objek Predikat.

    Predikat pemicu ini, yang menentukan kapan akan aktif.

  • EventBatchingCondition — Sebuah objek EventBatchingCondition.

    Kondisi batch yang harus dipenuhi (jumlah peristiwa tertentu yang diterima atau jendela waktu batch kedaluwarsa) sebelum pemicu EventBridge peristiwa terjadi kebakaran.

Struktur predikat

Menentukan predikat pemicu, yang menentukan kapan terjadi inisiasi.

Bidang
  • Logical – String UTF-8 (nilai yang valid: AND | ANY).

    Bidang opsional hanya jika satu kondisi tercantum. Jika beberapa kondisi tercantum, bidang ini diperlukan.

  • Conditions – Susunan objek Syarat.

    Daftar syarat yang menentukan kapan pemicu akan aktif.

Struktur kondisi

Menentukan kondisi yang memicu inisiasi.

Bidang
  • LogicalOperator – String UTF-8 (nilai yang valid: EQUALS).

    Operator logika.

  • JobName — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Nama tugas yang JobRuns-nya berlaku syarat ini, dan di mana pemicu ini menunggu.

  • State— UTF-8 string (nilai yang valid: STARTING | RUNNING | STOPPING | STOPPED | SUCCEEDED | FAILED TIMEOUT ERROR |WAITING).

    Status syarat. Saat ini, satu-satunya status tugas yang didengarkan oleh pemicu adalah SUCCEEDED, STOPPED, FAILED, dan TIMEOUT. Satu-satunya status crawler yang didengarkan oleh pemicu adalah SUCCEEDED, FAILED, dan CANCELLED.

  • CrawlerName — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Nama crawler yang berlaku syarat ini padanya.

  • CrawlState – String UTF-8 (nilai valid: RUNNING | CANCELLING | CANCELLED | SUCCEEDED | FAILED | ERROR).

    Status crawler yang berlaku syarat ini padanya.

Struktur aksi

Menentukan tindakan yang dimulai oleh pemicu.

Bidang
  • JobName — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Nama tugas yang akan dijalankan.

  • Arguments – Susunan peta pasangan nilai kunci.

    Setiap kunci adalah string UTF-8.

    Setiap nilai adalah string UTF-8.

    Argumen tugas yang digunakan saat pemicu ini aktif. Untuk eksekusi tugas ini, mereka mengganti argumen default yang diatur dalam definisi tugas itu sendiri.

    Anda dapat menentukan argumen di sini, yang digunakan skrip eksekusi-tugas Anda sendiri, serta argumen yang digunakan oleh AWS Glue sendiri.

    Untuk informasi tentang cara menentukan dan menggunakan argumen Tugas Anda sendiri, lihat topik Memanggil API AWS Glue dalam Python dalam panduan developer.

    Untuk informasi tentang pasangan nilai kunci yang digunakan oleh AWS Glue untuk mengatur tugas Anda, lihat topik Parameter Khusus yang Digunakan oleh AWS Glue dalam panduan developer.

  • Timeout — Nomor (bilangan bulat), minimal 1.

    Waktu habis JobRun, dalam satuan menit. Ini adalah waktu maksimum yang bisa digunakan oleh eksekusi tugas untuk menggunakan sumber daya sebelum eksekusi dihentikan dan memasuki status TIMEOUT. Nilai default-nya adalah 2.880 menit (48 jam). Hal ini menimpa nilai habis waktu yang ditetapkan dalam tugas induk.

  • SecurityConfiguration — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Nama struktur SecurityConfiguration yang akan digunakan dengan tindakan ini.

  • NotificationProperty — Sebuah objek NotificationProperty.

    Menentukan properti konfigurasi dari sebuah notifikasi eksekusi tugas.

  • CrawlerName — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Nama crawler yang akan digunakan dengan tindakan ini.

EventBatchingCondition struktur

Kondisi batch yang harus dipenuhi (jumlah peristiwa tertentu yang diterima atau jendela waktu batch kedaluwarsa) sebelum pemicu EventBridge peristiwa terjadi kebakaran.

Bidang
  • BatchSizeWajib: Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 100.

    Jumlah peristiwa yang harus diterima dari Amazon EventBridge sebelum EventBridge peristiwa memicu kebakaran.

  • BatchWindow — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 900.

    Jendela waktu dalam hitungan detik setelah EventBridge peristiwa memicu kebakaran. Jendela dimulai ketika peristiwa pertama diterima.

Operasi

CreateTrigger tindakan (Python: create_trigger)

Menciptakan sebuah pemicu baru.

Permintaan
  • NameWajib: String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Nama pemicu.

  • WorkflowName — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Nama alur kerja yang dikaitkan dengan pemicu.

  • TypeWajib: String UTF-8 (nilai yang valid: SCHEDULED | CONDITIONAL | ON_DEMAND | EVENT).

    Jenis pemicu baru.

  • Schedule – String UTF-8.

    Sebuah ekspresi cron yang digunakan untuk menentukan jadwal (lihat Jadwal Berbasis Waktu untuk Tugas dan Crawler. Sebagai contoh, untuk menjalankan sesuatu setiap hari pada 12:15 UTC, Anda harus menentukan cron(15 12 * * ? *).

    Bidang ini wajib ketika jenis pemicu-nya adalah TERJADWAL.

  • Predicate — Sebuah objek Predikat.

    Sebuah predikat untuk menentukan kapan pemicu baru harus aktif.

    Bidang ini wajib ketika jenis pemicu-nya adalah CONDITIONAL.

  • ActionsWajib: Susunan objek Tindakan.

    Tindakan yang dimulai oleh pemicu ini saat pemicu tersebut aktif.

  • Description — String deskripsi, dengan panjang tidak lebih dari 2048 byte, yang cocok dengan URI address multi-line string pattern.

    Sebuah deskripsi dari pemicu baru.

  • StartOnCreation – Boolean.

    Atur ke true untuk memulai pemicu SCHEDULED dan CONDITIONAL ketika dibuat. BETUL tidak didukung untuk pemicu ON_DEMAND.

  • Tags — Sebuah rangkaian peta pasangan nilai kunci, tidak lebih dari 50 pasang.

    Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.

    Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak lebih dari 256 byte.

    Tag yang akan digunakan dengan pemicu ini. Anda dapat menggunakan tag untuk membatasi akses ke pemicu tersebut. Untuk informasi tentang tag di AWS Glue, lihat Tag AWS di AWS Glue dalam panduan developer.

  • EventBatchingCondition — Sebuah objek EventBatchingCondition.

    Kondisi batch yang harus dipenuhi (jumlah peristiwa tertentu yang diterima atau jendela waktu batch kedaluwarsa) sebelum pemicu EventBridge peristiwa terjadi kebakaran.

Respons
  • Name — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Nama pemicu.

Kesalahan
  • AlreadyExistsException

  • EntityNotFoundException

  • InvalidInputException

  • IdempotentParameterMismatchException

  • InternalServiceException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • ConcurrentModificationException

StartTrigger tindakan (Python: start_trigger)

Memulai pemicu yang ada. Lihat Memicu Tugas untuk informasi tentang bagaimana berbagai jenis pemicu dimulai.

Permintaan
  • NameWajib: String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Nama pemicu yang akan dimulai.

Respons
  • Name — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Nama pemicu yang sudah dimulai.

Kesalahan
  • InvalidInputException

  • InternalServiceException

  • EntityNotFoundException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • ConcurrentRunsExceededException

GetTrigger tindakan (Python: get_trigger)

Mengambil definisi dari sebuah pemicu.

Permintaan
  • NameWajib: String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Nama pemicu yang akan diambil.

Respons
  • Trigger — Sebuah objek Pemicu.

    Definisi pemicu yang diminta.

Kesalahan
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

GetTriggers tindakan (Python: get_trigger)

Mendapatkan semua pemicu yang dikaitkan dengan sebuah tugas.

Permintaan
  • NextToken – String UTF-8.

    Sebuah token kelanjutan, jika ini adalah panggilan kelanjutan.

  • DependentJobName — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Nama tugas yang untuknya pemicu akan diambil. Pemicu yang dapat memulai tugas ini dikembalikan, dan jika tidak ada pemicu seperti itu, maka semua pemicu dikembalikan.

  • MaxResults— Angka (bilangan bulat), tidak kurang dari 1 atau lebih dari 200.

    Ukuran maksimum respons.

Respons
  • Triggers – Susunan objek Pemicu.

    Daftar pemicu untuk tugas yang ditentukan.

  • NextToken – String UTF-8.

    Sebuah token kelanjutan, jika bukan semua pemicu yang diminta yang belum dikembalikan.

Kesalahan
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

UpdateTrigger tindakan (Python: update_trigger)

Memperbarui sebuah definisi pemicu.

Permintaan
  • NameWajib: String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Nama pemicu yang akan diperbarui.

  • TriggerUpdateWajib: Sebuah objek TriggerUpdate.

    Nilai-nilai baru yang digunakan untuk memperbarui pemicu.

Respons
  • Trigger — Sebuah objek Pemicu.

    Definisi pemicu yang dihasilkan.

Kesalahan
  • InvalidInputException

  • InternalServiceException

  • EntityNotFoundException

  • OperationTimeoutException

  • ConcurrentModificationException

StopTrigger tindakan (Python: stop_trigger)

Menghentikan pemicu tertentu.

Permintaan
  • NameWajib: String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Nama pemicu yang akan dihentikan.

Respons
  • Name — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Nama pemicu yang sudah dihentikan.

Kesalahan
  • InvalidInputException

  • InternalServiceException

  • EntityNotFoundException

  • OperationTimeoutException

  • ConcurrentModificationException

DeleteTrigger tindakan (Python: delete_trigger)

Menghapus pemicu tertentu. Jika pemicu tidak ditemukan, tidak ada pengecualian yang dibuang.

Permintaan
  • NameWajib: String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Nama pemicu yang akan dihapus.

Respons
  • Name — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Nama pemicu yang sudah dihapus.

Kesalahan
  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • ConcurrentModificationException

ListTriggers tindakan (Python: list_trigger)

Mengambil nama-nama semua sumber daya pemicu dalam akun AWS ini, atau sumber daya dengan tag yang ditentukan. Operasi ini memungkinkan Anda melihat sumber daya yang tersedia di akun Anda, dan nama-namanya.

Operasi ini mengambil kolom Tags opsional, yang dapat Anda gunakan sebagai filter pada respon sehingga tag sumber daya dapat diambil sebagai sebuah grup. Jika Anda memilih untuk menggunakan pem-filter-an tag, maka hanya sumber daya dengan tag saja yang diambil.

Permintaan
  • NextToken – String UTF-8.

    Sebuah token kelanjutan, jika ini adalah permintaan kelanjutan.

  • DependentJobName — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Nama tugas yang untuknya pemicu akan diambil. Pemicu yang dapat memulai tugas ini dikembalikan. Jika tidak ada pemicu seperti itu, maka semua pemicu dikembalikan.

  • MaxResults— Angka (bilangan bulat), tidak kurang dari 1 atau lebih dari 200.

    Ukuran maksimum daftar yang akan dikembalikan.

  • Tags — Sebuah rangkaian peta pasangan nilai kunci, tidak lebih dari 50 pasang.

    Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.

    Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak lebih dari 256 byte.

    Menentukan untuk mengembalikan hanya sumber daya ditandai saja.

Respons
  • TriggerNames – Susunan string UTF-8.

    Nama dari semua pemicu dalam akun, atau pemicu dengan tag yang ditentukan.

  • NextToken – String UTF-8.

    Sebuah token kelanjutan, jika daftar yang dikembalikan tidak berisi metrik terakhir yang tersedia.

Kesalahan
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

BatchGetTriggers tindakan (Python: batch_get_trigger)

Mengembalikan daftar metadata sumber daya untuk daftar nama pemicu tertentu. Setelah memanggil operasi ListTriggers, Anda dapat memanggil operasi ini untuk mengakses data yang Anda telah diberikan izinnya. Operasi ini mendukung semua izin IAM, termasuk syarat izin yang menggunakan tag.

Permintaan
  • TriggerNamesWajib: Susunan string UTF-8.

    Daftar nama pemicu, mungkin nama yang dikembalikan dari operasi ListTriggers.

Respons
  • Triggers – Susunan objek Pemicu.

    Daftar definisi pemicu.

  • TriggersNotFound – Susunan string UTF-8.

    Daftar nama pemicu yang tidak ditemukan.

Kesalahan
  • InternalServiceException

  • OperationTimeoutException

  • InvalidInputException