Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# UpdateApplication
Aktualisiert eine bestehende Managed Service for Apache Flink-Anwendung. Mit diesem Vorgang können Sie den Anwendungscode, die Eingabekonfiguration und die Ausgabekonfiguration aktualisieren.
Managed Service für Apache Flink wird `ApplicationVersionId` jedes Mal aktualisiert, wenn Sie Ihre Anwendung aktualisieren.
## Anforderungssyntax
```
{
"ApplicationConfigurationUpdate": {
"ApplicationCodeConfigurationUpdate": {
"CodeContentTypeUpdate": "string",
"CodeContentUpdate": {
"S3ContentLocationUpdate": {
"BucketARNUpdate": "string",
"FileKeyUpdate": "string",
"ObjectVersionUpdate": "string"
},
"TextContentUpdate": "string",
"ZipFileContentUpdate": blob
}
},
"ApplicationEncryptionConfigurationUpdate": {
"KeyIdUpdate": "string",
"KeyTypeUpdate": "string"
},
"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"
}
```
## Anforderungsparameter
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
** [ApplicationConfigurationUpdate](#API_UpdateApplication_RequestSyntax) **
Beschreibt Aktualisierungen der Anwendungskonfiguration.
Typ: [ApplicationConfigurationUpdate](API_ApplicationConfigurationUpdate.md) Objekt
Erforderlich: Nein
** [ApplicationName](#API_UpdateApplication_RequestSyntax) **
Der Name der zu aktualisierenden Anwendung.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.
Pattern: `[a-zA-Z0-9_.-]+`
Erforderlich: Ja
** [CloudWatchLoggingOptionUpdates](#API_UpdateApplication_RequestSyntax) **
Beschreibt Aktualisierungen der CloudWatch Amazon-Protokollierungsoptionen für Anwendungen. Mit dieser Aktion können Sie nur bestehende CloudWatch Protokollierungsoptionen aktualisieren. Um eine neue CloudWatch Protokollierungsoption hinzuzufügen, verwenden Sie[AddApplicationCloudWatchLoggingOption](API_AddApplicationCloudWatchLoggingOption.md).
Typ: Array von [CloudWatchLoggingOptionUpdate](API_CloudWatchLoggingOptionUpdate.md)-Objekten
Erforderlich: Nein
** [ConditionalToken](#API_UpdateApplication_RequestSyntax) **
Ein Wert, den Sie verwenden, um eine starke Parallelität für Anwendungsupdates zu implementieren. Sie müssen das `CurrentApplicationVersionId` oder das `ConditionalToken` angeben. Sie erhalten die aktuelle `ConditionalToken` Verwendung der Anwendung[DescribeApplication](API_DescribeApplication.md). Verwenden Sie für eine bessere Unterstützung der Parallelität den `ConditionalToken` Parameter anstelle von`CurrentApplicationVersionId`.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge von 512.
Pattern: `[a-zA-Z0-9-_+/=]+`
Erforderlich: Nein
** [CurrentApplicationVersionId](#API_UpdateApplication_RequestSyntax) **
Die aktuelle Anwendungsversions-ID. Sie müssen das `CurrentApplicationVersionId` oder angeben. `ConditionalToken` Sie können die Versions-ID der Anwendung mithilfe von abrufen. [DescribeApplication](API_DescribeApplication.md) Verwenden Sie für eine bessere Unterstützung der Parallelität den `ConditionalToken` Parameter anstelle von. `CurrentApplicationVersionId`
Type: Long
Gültiger Bereich: Mindestwert 1. Maximaler Wert von 999999999.
Erforderlich: Nein
** [RunConfigurationUpdate](#API_UpdateApplication_RequestSyntax) **
Beschreibt Aktualisierungen der Startparameter der Anwendung.
Typ: [RunConfigurationUpdate](API_RunConfigurationUpdate.md) Objekt
Erforderlich: Nein
** [RuntimeEnvironmentUpdate](#API_UpdateApplication_RequestSyntax) **
Aktualisiert die Laufzeitumgebung Managed Service for Apache Flink, die zur Ausführung Ihres Codes verwendet wird. Um Probleme zu vermeiden, müssen Sie:
+ Stellen Sie sicher, dass Ihr neues JAR und Ihre Abhängigkeiten mit der neu ausgewählten Laufzeit kompatibel sind.
+ Stellen Sie sicher, dass der Status Ihres neuen Codes mit dem Snapshot kompatibel ist, von dem aus Ihre Anwendung gestartet wird
Typ: Zeichenfolge
Zulässige Werte: `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 | FLINK-1_20`
Erforderlich: Nein
** [ServiceExecutionRoleUpdate](#API_UpdateApplication_RequestSyntax) **
Beschreibt Aktualisierungen der Dienstausführungsrolle.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen.
Pattern: `arn:.*`
Erforderlich: Nein
## Antwortsyntax
```
{
"ApplicationDetail": {
"ApplicationARN": "string",
"ApplicationConfigurationDescription": {
"ApplicationCodeConfigurationDescription": {
"CodeContentDescription": {
"CodeMD5": "string",
"CodeSize": number,
"S3ApplicationCodeLocationDescription": {
"BucketARN": "string",
"FileKey": "string",
"ObjectVersion": "string"
},
"TextContent": "string"
},
"CodeContentType": "string"
},
"ApplicationEncryptionConfigurationDescription": {
"KeyId": "string",
"KeyType": "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"
}
```
## Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.
Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.
** [ApplicationDetail](#API_UpdateApplication_ResponseSyntax) **
Beschreibt Anwendungsupdates.
Typ: [ApplicationDetail](API_ApplicationDetail.md) Objekt
** [OperationId](#API_UpdateApplication_ResponseSyntax) **
Die Vorgangs-ID, mit der die Anforderung verfolgt werden kann.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.
## Fehler
** CodeValidationException **
Der vom Benutzer bereitgestellte Anwendungscode (Abfrage) ist ungültig. Dies kann ein einfacher Syntaxfehler sein.
HTTP-Statuscode: 400
** ConcurrentModificationException **
Ausnahme, die als Ergebnis gleichzeitiger Änderungen an einer Anwendung ausgelöst wurde. Dieser Fehler kann das Ergebnis des Versuchs sein, eine Anwendung zu ändern, ohne die aktuelle Anwendungs-ID zu verwenden.
HTTP-Statuscode: 400
** InvalidApplicationConfigurationException **
Die vom Benutzer bereitgestellte Anwendungskonfiguration ist nicht gültig.
HTTP-Statuscode: 400
** InvalidArgumentException **
Der angegebene Eingabeparameterwert ist nicht gültig.
HTTP-Statuscode: 400
** InvalidRequestException **
Die JSON-Anforderung ist für den Vorgang nicht gültig.
HTTP-Statuscode: 400
** LimitExceededException **
Die Anzahl der zulässigen Ressourcen wurde überschritten.
HTTP-Statuscode: 400
** ResourceInUseException **
Die Anwendung ist für diesen Vorgang nicht verfügbar.
HTTP-Statuscode: 400
** ResourceNotFoundException **
Die angegebene Anwendung kann nicht gefunden werden.
HTTP-Statuscode: 400
## Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+ [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalyticsv2-2018-05-23/UpdateApplication)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalyticsv2-2018-05-23/UpdateApplication)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalyticsv2-2018-05-23/UpdateApplication)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalyticsv2-2018-05-23/UpdateApplication)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalyticsv2-2018-05-23/UpdateApplication)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalyticsv2-2018-05-23/UpdateApplication)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalyticsv2-2018-05-23/UpdateApplication)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalyticsv2-2018-05-23/UpdateApplication)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalyticsv2-2018-05-23/UpdateApplication)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalyticsv2-2018-05-23/UpdateApplication)