Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
UpdateApplication
Memperbarui Layanan Terkelola yang ada untuk aplikasi Apache Flink. Dengan menggunakan operasi ini, Anda dapat memperbarui kode aplikasi, konfigurasi input, dan konfigurasi output.
Layanan Terkelola untuk Apache Flink memperbarui ApplicationVersionId
setiap kali Anda memperbarui aplikasi Anda.
Sintaksis Permintaan
{
"ApplicationConfigurationUpdate": {
"ApplicationCodeConfigurationUpdate": {
"CodeContentTypeUpdate": "string
",
"CodeContentUpdate": {
"S3ContentLocationUpdate": {
"BucketARNUpdate": "string
",
"FileKeyUpdate": "string
",
"ObjectVersionUpdate": "string
"
},
"TextContentUpdate": "string
",
"ZipFileContentUpdate": blob
}
},
"ApplicationSnapshotConfigurationUpdate": {
"SnapshotsEnabledUpdate": boolean
},
"ApplicationSystemRollbackConfigurationUpdate": {
"RollbackEnabledUpdate": boolean
},
"EnvironmentPropertyUpdates": {
"PropertyGroups": [
{
"PropertyGroupId": "string
",
"PropertyMap": {
"string
" : "string
"
}
}
]
},
"FlinkApplicationConfigurationUpdate": {
"CheckpointConfigurationUpdate": {
"CheckpointingEnabledUpdate": boolean
,
"CheckpointIntervalUpdate": number
,
"ConfigurationTypeUpdate": "string
",
"MinPauseBetweenCheckpointsUpdate": number
},
"MonitoringConfigurationUpdate": {
"ConfigurationTypeUpdate": "string
",
"LogLevelUpdate": "string
",
"MetricsLevelUpdate": "string
"
},
"ParallelismConfigurationUpdate": {
"AutoScalingEnabledUpdate": boolean
,
"ConfigurationTypeUpdate": "string
",
"ParallelismPerKPUUpdate": number
,
"ParallelismUpdate": number
}
},
"SqlApplicationConfigurationUpdate": {
"InputUpdates": [
{
"InputId": "string
",
"InputParallelismUpdate": {
"CountUpdate": number
},
"InputProcessingConfigurationUpdate": {
"InputLambdaProcessorUpdate": {
"ResourceARNUpdate": "string
"
}
},
"InputSchemaUpdate": {
"RecordColumnUpdates": [
{
"Mapping": "string
",
"Name": "string
",
"SqlType": "string
"
}
],
"RecordEncodingUpdate": "string
",
"RecordFormatUpdate": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string
",
"RecordRowDelimiter": "string
"
},
"JSONMappingParameters": {
"RecordRowPath": "string
"
}
},
"RecordFormatType": "string
"
}
},
"KinesisFirehoseInputUpdate": {
"ResourceARNUpdate": "string
"
},
"KinesisStreamsInputUpdate": {
"ResourceARNUpdate": "string
"
},
"NamePrefixUpdate": "string
"
}
],
"OutputUpdates": [
{
"DestinationSchemaUpdate": {
"RecordFormatType": "string
"
},
"KinesisFirehoseOutputUpdate": {
"ResourceARNUpdate": "string
"
},
"KinesisStreamsOutputUpdate": {
"ResourceARNUpdate": "string
"
},
"LambdaOutputUpdate": {
"ResourceARNUpdate": "string
"
},
"NameUpdate": "string
",
"OutputId": "string
"
}
],
"ReferenceDataSourceUpdates": [
{
"ReferenceId": "string
",
"ReferenceSchemaUpdate": {
"RecordColumns": [
{
"Mapping": "string
",
"Name": "string
",
"SqlType": "string
"
}
],
"RecordEncoding": "string
",
"RecordFormat": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string
",
"RecordRowDelimiter": "string
"
},
"JSONMappingParameters": {
"RecordRowPath": "string
"
}
},
"RecordFormatType": "string
"
}
},
"S3ReferenceDataSourceUpdate": {
"BucketARNUpdate": "string
",
"FileKeyUpdate": "string
"
},
"TableNameUpdate": "string
"
}
]
},
"VpcConfigurationUpdates": [
{
"SecurityGroupIdUpdates": [ "string
" ],
"SubnetIdUpdates": [ "string
" ],
"VpcConfigurationId": "string
"
}
],
"ZeppelinApplicationConfigurationUpdate": {
"CatalogConfigurationUpdate": {
"GlueDataCatalogConfigurationUpdate": {
"DatabaseARNUpdate": "string
"
}
},
"CustomArtifactsConfigurationUpdate": [
{
"ArtifactType": "string
",
"MavenReference": {
"ArtifactId": "string
",
"GroupId": "string
",
"Version": "string
"
},
"S3ContentLocation": {
"BucketARN": "string
",
"FileKey": "string
",
"ObjectVersion": "string
"
}
}
],
"DeployAsApplicationConfigurationUpdate": {
"S3ContentLocationUpdate": {
"BasePathUpdate": "string
",
"BucketARNUpdate": "string
"
}
},
"MonitoringConfigurationUpdate": {
"LogLevelUpdate": "string
"
}
}
},
"ApplicationName": "string
",
"CloudWatchLoggingOptionUpdates": [
{
"CloudWatchLoggingOptionId": "string
",
"LogStreamARNUpdate": "string
"
}
],
"ConditionalToken": "string
",
"CurrentApplicationVersionId": number
,
"RunConfigurationUpdate": {
"ApplicationRestoreConfiguration": {
"ApplicationRestoreType": "string
",
"SnapshotName": "string
"
},
"FlinkRunConfiguration": {
"AllowNonRestoredState": boolean
}
},
"RuntimeEnvironmentUpdate": "string
",
"ServiceExecutionRoleUpdate": "string
"
}
Parameter Permintaan
Permintaan menerima data berikut dalam format JSON.
- ApplicationConfigurationUpdate
-
Menjelaskan pembaruan konfigurasi aplikasi.
Tipe: Objek ApplicationConfigurationUpdate
Wajib: Tidak
- ApplicationName
-
Nama aplikasi yang akan diperbarui.
Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola:
[a-zA-Z0-9_.-]+
Wajib: Ya
- CloudWatchLoggingOptionUpdates
-
Menjelaskan aplikasi Pembaruan opsi CloudWatch pencatatan Amazon. Anda hanya dapat memperbarui opsi CloudWatch logging yang ada dengan tindakan ini. Untuk menambahkan opsi CloudWatch logging baru, gunakanAddApplicationCloudWatchLoggingOption.
Tipe: Array objek CloudWatchLoggingOptionUpdate
Wajib: Tidak
- ConditionalToken
-
Nilai yang Anda gunakan untuk menerapkan konkurensi yang kuat untuk pembaruan aplikasi. Anda harus memberikan
CurrentApplicationVersionId
atauConditionalToken
. Anda mendapatkan aplikasi saat iniConditionalToken
menggunakanDescribeApplication. Untuk dukungan konkurensi yang lebih baik, gunakanConditionalToken
parameter alih-alih.CurrentApplicationVersionId
Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 512.
Pola:
[a-zA-Z0-9-_+/=]+
Wajib: Tidak
- CurrentApplicationVersionId
-
ID versi aplikasi saat ini. Anda harus memberikan
CurrentApplicationVersionId
atauConditionalToken
.Anda dapat mengambil ID versi aplikasi menggunakan. DescribeApplication Untuk dukungan konkurensi yang lebih baik, gunakanConditionalToken
parameter alih-alih.CurrentApplicationVersionId
Tipe: Long
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 999999999.
Wajib: Tidak
- RunConfigurationUpdate
-
Menjelaskan pembaruan pada parameter awal aplikasi.
Tipe: Objek RunConfigurationUpdate
Wajib: Tidak
- RuntimeEnvironmentUpdate
-
Memperbarui Layanan Terkelola untuk lingkungan runtime Apache Flink yang digunakan untuk menjalankan kode Anda. Untuk menghindari masalah, Anda harus:
-
Pastikan jar dan dependensi baru Anda kompatibel dengan runtime baru yang dipilih.
-
Pastikan status kode baru Anda kompatibel dengan snapshot dari mana aplikasi Anda akan dimulai
Jenis: String
Nilai yang Valid:
SQL-1_0 | FLINK-1_6 | FLINK-1_8 | ZEPPELIN-FLINK-1_0 | FLINK-1_11 | FLINK-1_13 | ZEPPELIN-FLINK-2_0 | FLINK-1_15 | ZEPPELIN-FLINK-3_0 | FLINK-1_18 | FLINK-1_19
Wajib: Tidak
-
- ServiceExecutionRoleUpdate
-
Menjelaskan pembaruan pada peran eksekusi layanan.
Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048.
Pola:
arn:.*
Diperlukan: Tidak
Sintaksis Respons
{
"ApplicationDetail": {
"ApplicationARN": "string",
"ApplicationConfigurationDescription": {
"ApplicationCodeConfigurationDescription": {
"CodeContentDescription": {
"CodeMD5": "string",
"CodeSize": number,
"S3ApplicationCodeLocationDescription": {
"BucketARN": "string",
"FileKey": "string",
"ObjectVersion": "string"
},
"TextContent": "string"
},
"CodeContentType": "string"
},
"ApplicationSnapshotConfigurationDescription": {
"SnapshotsEnabled": boolean
},
"ApplicationSystemRollbackConfigurationDescription": {
"RollbackEnabled": boolean
},
"EnvironmentPropertyDescriptions": {
"PropertyGroupDescriptions": [
{
"PropertyGroupId": "string",
"PropertyMap": {
"string" : "string"
}
}
]
},
"FlinkApplicationConfigurationDescription": {
"CheckpointConfigurationDescription": {
"CheckpointingEnabled": boolean,
"CheckpointInterval": number,
"ConfigurationType": "string",
"MinPauseBetweenCheckpoints": number
},
"JobPlanDescription": "string",
"MonitoringConfigurationDescription": {
"ConfigurationType": "string",
"LogLevel": "string",
"MetricsLevel": "string"
},
"ParallelismConfigurationDescription": {
"AutoScalingEnabled": boolean,
"ConfigurationType": "string",
"CurrentParallelism": number,
"Parallelism": number,
"ParallelismPerKPU": number
}
},
"RunConfigurationDescription": {
"ApplicationRestoreConfigurationDescription": {
"ApplicationRestoreType": "string",
"SnapshotName": "string"
},
"FlinkRunConfigurationDescription": {
"AllowNonRestoredState": boolean
}
},
"SqlApplicationConfigurationDescription": {
"InputDescriptions": [
{
"InAppStreamNames": [ "string" ],
"InputId": "string",
"InputParallelism": {
"Count": number
},
"InputProcessingConfigurationDescription": {
"InputLambdaProcessorDescription": {
"ResourceARN": "string",
"RoleARN": "string"
}
},
"InputSchema": {
"RecordColumns": [
{
"Mapping": "string",
"Name": "string",
"SqlType": "string"
}
],
"RecordEncoding": "string",
"RecordFormat": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string",
"RecordRowDelimiter": "string"
},
"JSONMappingParameters": {
"RecordRowPath": "string"
}
},
"RecordFormatType": "string"
}
},
"InputStartingPositionConfiguration": {
"InputStartingPosition": "string"
},
"KinesisFirehoseInputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"KinesisStreamsInputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"NamePrefix": "string"
}
],
"OutputDescriptions": [
{
"DestinationSchema": {
"RecordFormatType": "string"
},
"KinesisFirehoseOutputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"KinesisStreamsOutputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"LambdaOutputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"Name": "string",
"OutputId": "string"
}
],
"ReferenceDataSourceDescriptions": [
{
"ReferenceId": "string",
"ReferenceSchema": {
"RecordColumns": [
{
"Mapping": "string",
"Name": "string",
"SqlType": "string"
}
],
"RecordEncoding": "string",
"RecordFormat": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string",
"RecordRowDelimiter": "string"
},
"JSONMappingParameters": {
"RecordRowPath": "string"
}
},
"RecordFormatType": "string"
}
},
"S3ReferenceDataSourceDescription": {
"BucketARN": "string",
"FileKey": "string",
"ReferenceRoleARN": "string"
},
"TableName": "string"
}
]
},
"VpcConfigurationDescriptions": [
{
"SecurityGroupIds": [ "string" ],
"SubnetIds": [ "string" ],
"VpcConfigurationId": "string",
"VpcId": "string"
}
],
"ZeppelinApplicationConfigurationDescription": {
"CatalogConfigurationDescription": {
"GlueDataCatalogConfigurationDescription": {
"DatabaseARN": "string"
}
},
"CustomArtifactsConfigurationDescription": [
{
"ArtifactType": "string",
"MavenReferenceDescription": {
"ArtifactId": "string",
"GroupId": "string",
"Version": "string"
},
"S3ContentLocationDescription": {
"BucketARN": "string",
"FileKey": "string",
"ObjectVersion": "string"
}
}
],
"DeployAsApplicationConfigurationDescription": {
"S3ContentLocationDescription": {
"BasePath": "string",
"BucketARN": "string"
}
},
"MonitoringConfigurationDescription": {
"LogLevel": "string"
}
}
},
"ApplicationDescription": "string",
"ApplicationMaintenanceConfigurationDescription": {
"ApplicationMaintenanceWindowEndTime": "string",
"ApplicationMaintenanceWindowStartTime": "string"
},
"ApplicationMode": "string",
"ApplicationName": "string",
"ApplicationStatus": "string",
"ApplicationVersionCreateTimestamp": number,
"ApplicationVersionId": number,
"ApplicationVersionRolledBackFrom": number,
"ApplicationVersionRolledBackTo": number,
"ApplicationVersionUpdatedFrom": number,
"CloudWatchLoggingOptionDescriptions": [
{
"CloudWatchLoggingOptionId": "string",
"LogStreamARN": "string",
"RoleARN": "string"
}
],
"ConditionalToken": "string",
"CreateTimestamp": number,
"LastUpdateTimestamp": number,
"RuntimeEnvironment": "string",
"ServiceExecutionRole": "string"
},
"OperationId": "string"
}
Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
- ApplicationDetail
-
Menjelaskan pembaruan aplikasi.
Tipe: Objek ApplicationDetail
- OperationId
-
ID operasi yang dapat digunakan untuk melacak permintaan.
Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.
Kesalahan
- CodeValidationException
-
Kode aplikasi yang disediakan pengguna (query) tidak valid. Ini bisa menjadi kesalahan sintaksis sederhana.
Kode Status HTTP: 400
- 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
- InvalidApplicationConfigurationException
-
Konfigurasi aplikasi yang disediakan pengguna tidak valid.
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
- LimitExceededException
-
Jumlah sumber daya yang diizinkan telah terlampaui.
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: