Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Pemicu
Pemicu API menjelaskan tipe data dan API terkait dengan membuat, memperbarui, atau menghapus, dan memulai dan menghentikan pemicu pekerjaan. AWS Glue
Jenis data
Struktur pemicu
Informasi tentang sebuah pemicu tertentu.
Bidang
-
Name
- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Single-line string patternNama pemicu.
-
WorkflowName
- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Single-line string patternNama alur kerja yang dikaitkan dengan pemicu.
-
Id
- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Single-line string patternTerpesan untuk digunakan di masa mendatang.
-
Type
— UTF -8 string (nilai valid:SCHEDULED
| |CONDITIONAL
ON_DEMAND
|EVENT
).Jenis pemicu yang ini.
-
State
— UTF -8 string (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
— UTF -8 string.Sebuah ekspresi
cron
yang digunakan untuk menentukan jadwal (lihat Jadwal Berbasis Waktu untuk Tugas dan Crawler. Misalnya, untuk menjalankan sesuatu setiap hari pada pukul 12:15UTC, Anda akan 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
- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Single-line string patternTerpesan untuk digunakan di masa mendatang.
-
Description
— String deskripsi, dengan panjang tidak lebih dari 2048 byte, yang cocok dengan URI address multi-line string pattern.Deskripsi pemicu ini.
-
Schedule
— UTF -8 string.Sebuah ekspresi
cron
yang digunakan untuk menentukan jadwal (lihat Jadwal Berbasis Waktu untuk Tugas dan Crawler. Misalnya, untuk menjalankan sesuatu setiap hari pada pukul 12:15UTC, Anda akan 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
— UTF -8 string (nilai 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
— UTF -8 string (nilai valid:EQUALS
).Operator logika.
-
JobName
- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Single-line string patternNama tugas yang
JobRuns
kondisi ini berlaku, dan tempat pemicu ini menunggu. -
State
— UTF -8 string (nilai valid:STARTING
|RUNNING
|STOPPING
|STOPPED
|SUCCEEDED
|FAILED
|TIMEOUT
|ERROR
WAITING
|EXPIRED
).Status syarat. Saat ini, satu-satunya status tugas yang didengarkan oleh pemicu adalah
SUCCEEDED
,STOPPED
,FAILED
, danTIMEOUT
. Satu-satunya status crawler yang didengarkan oleh pemicu adalahSUCCEEDED
,FAILED
, danCANCELLED
. -
CrawlerName
- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Single-line string patternNama crawler tempat kondisi ini berlaku.
-
CrawlState
— UTF -8 string (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
- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Single-line string patternNama 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. Agar tugas ini berjalan, argumen default yang diatur dalam ketentuan tugas itu sendiri diganti.
Anda dapat menentukan argumen di sini yang digunakan skrip eksekusi pekerjaan Anda sendiri, serta argumen yang AWS Glue dikonsumsi sendiri.
Untuk informasi tentang cara menentukan dan menggunakan argumen Job Anda sendiri, lihat topik Memanggil AWS Glue APIs dengan Python di panduan pengembang.
Untuk informasi tentang pasangan kunci-nilai yang AWS Glue digunakan untuk menyiapkan pekerjaan Anda, lihat Parameter Khusus yang Digunakan menurut AWS Glue topik dalam panduan pengembang.
-
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 statusTIMEOUT
. Nilai default-nya adalah 2.880 menit (48 jam). Ini menimpa nilai waktu habis yang diatur dalam tugas induk. -
SecurityConfiguration
- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Single-line string patternNama struktur
SecurityConfiguration
yang akan digunakan dengan tindakan ini. -
NotificationProperty
— Sebuah objek NotificationProperty.Menentukan properti konfigurasi dari sebuah notifikasi eksekusi tugas.
-
CrawlerName
- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Single-line string patternNama 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
-
BatchSize
— Wajib: 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.
Argumen Job dapat dicatat. Jangan berikan rahasia plaintext sebagai argumen. Ambil rahasia dari AWS Glue Connection, AWS Secrets Manager atau mekanisme manajemen rahasia lainnya jika Anda ingin menyimpannya dalam Job.
Permintaan
-
Name
- Diperlukan: UTF -8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Single-line string patternNama pemicu.
-
WorkflowName
- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Single-line string patternNama alur kerja yang dikaitkan dengan pemicu.
-
Type
- Diperlukan: UTF -8 string (nilai valid:SCHEDULED
| |CONDITIONAL
ON_DEMAND
|EVENT
).Jenis pemicu baru.
-
Schedule
— UTF -8 string.Sebuah ekspresi
cron
yang digunakan untuk menentukan jadwal (lihat Jadwal Berbasis Waktu untuk Tugas dan Crawler. Misalnya, untuk menjalankan sesuatu setiap hari pada pukul 12:15UTC, Anda akan menentukan:cron(15 12 * * ? *)
.Bidang ini wajib ketika jenis pemicu-nya adalah SCHEDULED.
-
Predicate
— Sebuah objek Predikat.Sebuah predikat untuk menentukan kapan pemicu baru harus aktif.
Bidang ini wajib ketika jenis pemicu-nya adalah
CONDITIONAL
. -
Actions
– Wajib: 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 pemicuSCHEDULED
danCONDITIONAL
ketika dibuat. BETUL tidak didukung untuk pemicuON_DEMAND
. -
Tags
— Sebuah rangkaian peta pasangan nilai kunci, tidak lebih dari 50 pasang.Setiap kunci adalah string UTF -8, panjangnya tidak kurang dari 1 atau lebih dari 128 byte.
Setiap nilai adalah string UTF -8, panjangnya tidak lebih dari 256 byte.
Tag yang akan digunakan dengan pemicu ini. Anda dapat menggunakan tag untuk membatasi akses ke pemicu tersebut. Untuk informasi selengkapnya tentang AWS tag AWS Glue, lihat Tag AWS Glue di panduan pengembang.
-
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
- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Single-line string patternNama 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
-
Name
- Diperlukan: UTF -8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Single-line string patternNama pemicu yang akan dimulai.
Respons
-
Name
- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Single-line string patternNama pemicu yang sudah dimulai.
Kesalahan
InvalidInputException
InternalServiceException
EntityNotFoundException
OperationTimeoutException
ResourceNumberLimitExceededException
ConcurrentRunsExceededException
GetTrigger tindakan (Python: get_trigger)
Mengambil definisi dari sebuah pemicu.
Permintaan
-
Name
- Diperlukan: UTF -8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Single-line string patternNama 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
— UTF -8 string.Sebuah token kelanjutan, jika ini adalah panggilan kelanjutan.
-
DependentJobName
- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Single-line string patternNama 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
— UTF -8 string.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.
Argumen Job dapat dicatat. Jangan berikan rahasia plaintext sebagai argumen. Ambil rahasia dari AWS Glue Connection, AWS Secrets Manager atau mekanisme manajemen rahasia lainnya jika Anda ingin menyimpannya dalam Job.
Permintaan
-
Name
- Diperlukan: UTF -8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Single-line string patternNama pemicu yang akan diperbarui.
-
TriggerUpdate
— Wajib: 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
-
Name
- Diperlukan: UTF -8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Single-line string patternNama pemicu yang akan dihentikan.
Respons
-
Name
- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Single-line string patternNama 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
-
Name
- Diperlukan: UTF -8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Single-line string patternNama pemicu yang akan dihapus.
Respons
-
Name
- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Single-line string patternNama pemicu yang sudah dihapus.
Kesalahan
InvalidInputException
InternalServiceException
OperationTimeoutException
ConcurrentModificationException
ListTriggers tindakan (Python: list_trigger)
Mengambil nama semua sumber daya pemicu di AWS akun 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
— UTF -8 string.Sebuah token kelanjutan, jika ini adalah permintaan kelanjutan.
-
DependentJobName
- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Single-line string patternNama 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.Setiap kunci adalah string UTF -8, panjangnya tidak kurang dari 1 atau lebih dari 128 byte.
Setiap nilai adalah string UTF -8, panjangnya tidak lebih dari 256 byte.
Menentukan untuk mengembalikan hanya sumber daya ditandai saja.
Respons
-
TriggerNames
— Sebuah array UTF -8 string.Nama dari semua pemicu dalam akun, atau pemicu dengan tag yang ditentukan.
-
NextToken
— UTF -8 string.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 IAM izin, termasuk kondisi izin yang menggunakan tag.
Permintaan
-
TriggerNames
— Diperlukan: Sebuah array UTF -8 string.Daftar nama pemicu, mungkin nama yang dikembalikan dari operasi
ListTriggers
.
Respons
-
Triggers
– Susunan objek Pemicu.Daftar definisi pemicu.
-
TriggersNotFound
— Sebuah array UTF -8 string.Daftar nama pemicu yang tidak ditemukan.
Kesalahan
InternalServiceException
OperationTimeoutException
InvalidInputException