Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
AddApplicationOutput
Menambahkan tujuan eksternal ke aplikasi Kinesis Data Analytics berbasis SQL Anda.
Jika Anda menginginkan Kinesis Data Analytics untuk mengirimkan data dari pengaliran dalam aplikasi di dalam aplikasi Anda ke tujuan eksternal (seperti pengaliran data Kinesis, aliran pengiriman Kinesis Data Firehose, atau fungsi Amazon Lambda), Anda dapat menambahkan konfigurasi yang relevan ke aplikasi Anda 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.
Pembaruan konfigurasi apa pun, termasuk menambahkan sumber streaming menggunakan operasi ini, menghasilkan versi baru aplikasi. Anda dapat menggunakan operasi DescribeApplication untuk menemukan versi aplikasi saat ini.
Sintaksis Permintaan
{
"ApplicationName": "string",
"CurrentApplicationVersionId": number,
"Output": {
"DestinationSchema": {
"RecordFormatType": "string"
},
"KinesisFirehoseOutput": {
"ResourceARN": "string"
},
"KinesisStreamsOutput": {
"ResourceARN": "string"
},
"LambdaOutput": {
"ResourceARN": "string"
},
"Name": "string"
}
}Parameter Permintaan
Permintaan menerima data berikut dalam format JSON.
- ApplicationName
-
Nama aplikasi yang ingin Anda tambahkan konfigurasi output.
Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola:
[a-zA-Z0-9_.-]+Wajib: Ya
- CurrentApplicationVersionId
-
Versi aplikasi yang ingin Anda tambahkan konfigurasi output. Anda dapat menggunakan DescribeApplication operasi untuk mendapatkan versi aplikasi saat ini. Jika versi yang ditentukan bukan versi saat ini,
ConcurrentModificationExceptiondikembalikan.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 data Kinesis, aliran pengiriman Firehose Data Kinesis, atau fungsi Amazon Lambda), dan merekam formasi yang akan digunakan saat menulis ke tujuan.
Tipe: Objek Output
Wajib: Ya
Sintaksis Respons
{
"ApplicationARN": "string",
"ApplicationVersionId": number,
"OutputDescriptions": [
{
"DestinationSchema": {
"RecordFormatType": "string"
},
"KinesisFirehoseOutputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"KinesisStreamsOutputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"LambdaOutputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"Name": "string",
"OutputId": "string"
}
]
}Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
- ApplicationARN
-
Aplikasi Amazon Resource Name (ARN).
Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048.
Pola:
arn:.* - ApplicationVersionId
-
ID versi aplikasi yang diperbarui. Kinesis Data Analytics menambah ID ini saat aplikasi diperbarui.
Tipe: Long
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 999999999.
- OutputDescriptions
-
Menjelaskan konfigurasi output aplikasi. Untuk informasi lebih lanjut, lihat Mengonfigurasi Output Aplikasi.
Tipe: Array objek OutputDescription
Kesalahan
- ConcurrentModificationException
-
Pengecualian dilemparkan sebagai hasil dari modifikasi bersamaan ke aplikasi. Kesalahan ini dapat disebabkan oleh upaya memodifikasi aplikasi tanpa menggunakan ID aplikasi saat ini.
Kode Status HTTP: 400
- InvalidArgumentException
-
Nilai parameter input yang ditentukan tidak valid.
Kode Status HTTP: 400
- InvalidRequestException
-
Permintaan JSON tidak valid untuk operasi.
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
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini:
