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:

• AWS Antarmuka Baris Perintah

• AWS SDK for .NET

• AWS SDK for C++

• AWS SDK for Go v2

• AWS SDK for Java V2

• AWS SDK untuk V3 JavaScript

• AWS SDK for PHP V3

• AWS SDK untuk Python

• AWS SDK for Ruby V3