Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Membuat dan menghapus menggunakan perintah batch
Untuk membuat dan menghapus tindakan dalam jadwal saluran, Anda menggunakan perintah jadwal pembaruan batch. Perintah ini memungkinkan Anda melakukan beberapa tindakan dalam satu permintaan. Tidak ada satu perintah untuk membuat tindakan dan satu lagi untuk menghapus tindakan.
**penting**
Saat bekerja dengan saluran yang dimulai dan berjalan, gunakan **batch-update-schedule**perintah untuk menambah atau menghapus tindakan. Gunakan perintah **hapus-jadwal** hanya pada saluran idle. Perintah **hapus-jadwal** akan menghapus semua tindakan terjadwal dan dapat menyebabkan gangguan layanan jika digunakan pada saluran langsung.
Anda dapat menggunakan perintah sebagai berikut:
+ Kirim *satu* permintaan seperti permintaan untuk melakukan hal berikut:
+ Buat satu tindakan.
+ Hapus satu tindakan.
+ Kirim permintaan *batch* seperti satu permintaan untuk melakukan hal berikut:
+ Buat beberapa tindakan.
+ Hapus beberapa tindakan.
+ Buat satu atau beberapa tindakan dan hapus satu atau beberapa tindakan.
**penting**
Dalam perintah yang menggabungkan tindakan buat dan hapus tindakan, tindakan hapus *selalu* dilakukan sebelum tindakan buat. Ini berarti MediaLive menghapus tindakan penghapusan dari jadwal sebelum menambahkan tindakan buat ke jadwal.
**Topics**
+ [Cara kerja permintaan batch](how-batch-schedule-requests-work.md)
+ [Perintah Batch di antarmuka yang berbeda](batchupdatecommand-interfaces.md)
+ [JSON payload di antarmuka yang berbeda](batchupdatecommand-payloads.md)
# Cara kerja permintaan batch
Tujuan dari batching adalah untuk melewati atau gagal semua tindakan bersama. Oleh karena itu, AWS Elemental MediaLive memvalidasi tindakan batch bersama-sama. MediaLive melakukan validasi berikut:
+ Ini memastikan bahwa setiap tindakan yang dibuat atau dihapus memiliki waktu mulai eksplisit atau tersirat yang setidaknya 15 detik di masa depan.
+ Jika suatu tindakan mengacu pada tindakan yang ada dalam jadwal, itu memastikan bahwa referensi ke tindakan yang ada sudah benar. Misalnya, sakelar input ikuti menyertakan referensi ke tindakan yang diikuti. Tindakan itu harus ada.
Jika validasi gagal untuk satu tindakan, itu gagal untuk semua tindakan dalam batch.
Jika Anda tidak ingin tindakan lolos atau gagal bersama, jangan kirimkan batch. Sebagai gantinya, buat setiap tindakan dalam perintah jadwal pembaruan batch sendiri.
Jika validasi berhasil, MediaLive proses semua permintaan hapus sebelum membuat permintaan, terlepas dari waktu mulai tindakan.
**Contoh 1**
Penggunaan batching yang penting adalah melakukan beberapa tindakan yang harus lulus atau gagal bersama. Misalnya, misalkan Anda ingin menghapus logo perusahaan dan segera menyisipkan splice\$1insert (untuk membuka iklan yang tersedia). Untuk melakukan itu, Anda harus membuat tindakan untuk menghapus logo dan tindakan lain untuk menyisipkan splice\$1insert. Namun, Anda tidak MediaLive ingin menyisipkan tindakan hapus jika tindakan splice\$1insert gagal, atau sebaliknya. Lebih baik jika kedua tindakan gagal karena itu memungkinkan Anda untuk memperbaiki tindakan yang terbentuk dengan buruk, dan kemudian mengirimkan kedua tindakan lagi.
Oleh karena itu Anda mengirimkan dua tindakan bersama-sama, dalam satu perintah jadwal pembaruan batch.
**Contoh 2**
Penggunaan penting lainnya dari batching adalah untuk memperbaiki kesalahan dalam suatu tindakan dalam jadwal. Misalnya, Anda mungkin ingin memperbaiki overlay gambar yang belum dimulai dan dibuat dengan waktu mulai yang salah. Untuk melakukan itu, Anda mengirimkan satu perintah jadwal pembaruan batch dengan JSON yang berisi berikut ini:
+ Payload untuk menghapus tindakan asli untuk mengaktifkan overlay gambar. Tindakan ini memiliki waktu mulai yang salah.
+ Payload untuk menambahkan tindakan baru untuk mengaktifkan overlay gambar yang sama. Tindakan ini memiliki waktu mulai yang benar.
# Perintah Batch di antarmuka yang berbeda
Perintah jadwal pembaruan batch direpresentasikan secara berbeda di antarmuka yang berbeda:
+ Dalam AWS CLI, perintahnya adalah`batch-update-schedule`.
+ Di API, perintah diwakili oleh `HTTP PUT` on`channels/channelId/schedule`.
+ Dalam AWS SDKs, perintah diwakili oleh konstruksi yang sesuai dengan bahasa SDK itu.
# JSON payload di antarmuka yang berbeda
Payload JSON untuk perintah berbeda untuk antarmuka yang berbeda:
+ Dalam AWS CLI, isi muatan tergantung pada bagaimana Anda menggunakan perintah:
+ Anda dapat memasukkan perintah dengan dua parameter: `channel-id` dan`--cli-input-json`. Dalam hal ini, Anda membuat file yang mengulangi ID saluran dan menyertakan payload JSON.
+ Anda dapat memasukkan perintah dengan tiga parameter: satu untuk ID saluran, satu untuk payload JSON untuk tindakan buat (jika ada), dan satu untuk muatan JSON untuk tindakan hapus (jika ada). Anda melewati muatan dalam perintah. Jika kedua parameter hadir, setiap parameter mengambil muatan terpisah. Tetapi dua muatan divalidasi dan dilakukan sebagai batch.
Muatan untuk selalu AWS CLI kasing pascal (kotak unta atas).
+ Di API, ada satu payload dengan dua bagian, `CREATES` bagian dan satu `DELETES` bagian. Permintaan dapat berisi satu atau kedua bagian.
Payload untuk API selalu merupakan kasus unta untuk nama variabel dan kasus pascal untuk kelas.
+ Dalam AWS SDKs, payload JSON diwakili oleh konstruksi yang sesuai dengan bahasa SDK tersebut.
Untuk lebih terbiasa dengan tindakan individual, kami sarankan Anda menggunakan MediaLive konsol untuk membuat tindakan. Setelah Anda membuat tindakan, gunakan [DescribeSchedule](viewing-schedule-using-cli.md)perintah di antarmuka yang sesuai (misalnya, AWS CLI atau SDK) untuk mendapatkan payload JSON mentah untuk seluruh jadwal. Anda kemudian dapat menyalin tindakan individual dan menyimpannya sebagai model untuk digunakan saat bekerja secara terprogram.