Untuk proyek baru, kami menyarankan Anda menggunakan Managed Service baru untuk Apache Flink Studio melalui Kinesis Data Analytics untuk Aplikasi SQL. Layanan Terkelola untuk Apache Flink Studio menggabungkan kemudahan penggunaan dengan kemampuan analitis tingkat lanjut, memungkinkan Anda membangun aplikasi pemrosesan aliran yang canggih dalam hitungan menit.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
AddApplicationOutput
catatan
Dokumentasi ini ditujukan untuk API Amazon Kinesis Data Analytics versi 1, yang hanya mendukung aplikasi SQL. API versi 2 mendukung aplikasi SQL dan Java. Untuk informasi selengkapnya tentang versi 2, lihat Dokumentasi V2 API Amazon Kinesis Data Analytics.
Menambahkan tujuan eksternal ke aplikasi Amazon Kinesis Analytics Anda.
Jika Anda ingin Amazon Kinesis Analytics mengirimkan data dari aliran dalam aplikasi dalam aplikasi ke tujuan eksternal (seperti aliran Amazon Kinesis, aliran pengiriman Amazon Kinesis Firehose, atau fungsi AWS Lambda), Anda menambahkan konfigurasi yang relevan ke aplikasi menggunakan operasi ini. Anda dapat mengonfigurasi satu atau beberapa output untuk aplikasi Anda. Setiap konfigurasi output memetakan pengaliran dalam aplikasi dan tujuan eksternal.
Anda dapat menggunakan salah satu konfigurasi output untuk mengirimkan data dari pengaliran kesalahan dalam aplikasi Anda ke tujuan eksternal agar Anda dapat menganalisis kesalahan. Untuk informasi selengkapnya, lihat Memahami Output Aplikasi (Tujuan).
Pembaruan konfigurasi apa pun, termasuk menambahkan sumber streaming menggunakan operasi ini, menghasilkan versi baru aplikasi. Anda dapat menggunakan DescribeApplicationoperasi untuk menemukan versi aplikasi saat ini.
Untuk batas jumlah input dan output aplikasi yang dapat Anda konfigurasi, lihat Batas.
Operasi ini memerlukan izin untuk menjalankan tindakan kinesisanalytics:AddApplicationOutput
.
Sintaksis Permintaan
{
"ApplicationName": "string
",
"CurrentApplicationVersionId": number
,
"Output": {
"DestinationSchema": {
"RecordFormatType": "string
"
},
"KinesisFirehoseOutput": {
"ResourceARN": "string
",
"RoleARN": "string
"
},
"KinesisStreamsOutput": {
"ResourceARN": "string
",
"RoleARN": "string
"
},
"LambdaOutput": {
"ResourceARN": "string
",
"RoleARN": "string
"
},
"Name": "string
"
}
}
Parameter Permintaan
Permintaan menerima data berikut dalam format JSON.
- ApplicationName
-
Nama aplikasi tempat Anda ingin menambahkan konfigurasi output.
Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola:
[a-zA-Z0-9_.-]+
Wajib: Ya
- CurrentApplicationVersionId
-
Versi aplikasi tempat Anda ingin menambahkan konfigurasi output. Anda dapat menggunakan DescribeApplicationoperasi untuk mendapatkan versi aplikasi saat ini. Jika versi yang ditentukan bukan versi saat ini,
ConcurrentModificationException
dikembalikan.Tipe: Long
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 999999999.
Wajib: Ya
- Output
-
Susunan objek, masing-masing menjelaskan satu konfigurasi output. Dalam konfigurasi keluaran, Anda menentukan nama aliran dalam aplikasi, tujuan (yaitu aliran Amazon Kinesis, aliran pengiriman Amazon Kinesis Firehose, atau fungsi Lambda), dan merekam formasi AWS yang akan digunakan saat menulis ke tujuan.
Tipe: Objek Output
Wajib: Ya
Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.
Kesalahan
- ConcurrentModificationException
-
Pengecualian yang dibuat sebagai hasil modifikasi konkuren ke aplikasi. Sebagai contoh, dua individu yang mencoba untuk mengedit aplikasi yang sama pada waktu yang sama.
Kode Status HTTP: 400
- InvalidArgumentException
-
Nilai parameter input yang ditentukan tidak valid.
Kode Status HTTP: 400
- ResourceInUseException
-
Aplikasi ini tidak tersedia untuk operasi ini.
Kode Status HTTP: 400
- ResourceNotFoundException
-
Aplikasi yang ditentukan tidak dapat ditemukan.
Kode Status HTTP: 400
- UnsupportedOperationException
-
Permintaan ditolak karena parameter tertentu tidak didukung atau sumber daya tertentu tidak valid untuk operasi ini.
Kode Status HTTP: 400
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: