Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# UpdateApplication
Met à jour un service géré existant pour l'application Apache Flink. À l'aide de cette opération, vous pouvez mettre à jour le code de l'application, la configuration d'entrée et la configuration de sortie.
Le service géré pour Apache Flink est mis à jour `ApplicationVersionId` chaque fois que vous mettez à jour votre application.
## Syntaxe de la requête
```
{
"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"
}
```
## Paramètres de demande
Cette demande accepte les données suivantes au format JSON.
** [ApplicationConfigurationUpdate](#API_UpdateApplication_RequestSyntax) **
Décrit les mises à jour de configuration des applications.
Type : objet [ApplicationConfigurationUpdate](API_ApplicationConfigurationUpdate.md)
Obligatoire : non
** [ApplicationName](#API_UpdateApplication_RequestSyntax) **
Nom de l'application à mettre à jour.
Type : Chaîne
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128.
Modèle : `[a-zA-Z0-9_.-]+`
Obligatoire : oui
** [CloudWatchLoggingOptionUpdates](#API_UpdateApplication_RequestSyntax) **
Décrit les mises à jour des options de CloudWatch journalisation de l'application Amazon. Vous ne pouvez mettre à jour les options de CloudWatch journalisation existantes qu'avec cette action. Pour ajouter une nouvelle option de CloudWatch journalisation, utilisez[AddApplicationCloudWatchLoggingOption](API_AddApplicationCloudWatchLoggingOption.md).
Type : tableau d’objets [CloudWatchLoggingOptionUpdate](API_CloudWatchLoggingOptionUpdate.md)
Obligatoire : non
** [ConditionalToken](#API_UpdateApplication_RequestSyntax) **
Valeur que vous utilisez pour implémenter une forte simultanéité pour les mises à jour des applications. Vous devez fournir le `CurrentApplicationVersionId` ou le`ConditionalToken`. Vous obtenez l'`ConditionalToken`utilisation actuelle de l'application[DescribeApplication](API_DescribeApplication.md). Pour une meilleure prise en charge de la simultanéité, utilisez le `ConditionalToken` paramètre au lieu de`CurrentApplicationVersionId`.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 512.
Modèle : `[a-zA-Z0-9-_+/=]+`
Obligatoire : non
** [CurrentApplicationVersionId](#API_UpdateApplication_RequestSyntax) **
ID de la version d’application actuelle. Vous devez fournir le `CurrentApplicationVersionId` ou le `ConditionalToken` fichier .Vous pouvez récupérer l'ID de version de l'application à l'aide [DescribeApplication](API_DescribeApplication.md) de. Pour une meilleure prise en charge de la simultanéité, utilisez le `ConditionalToken` paramètre au lieu de`CurrentApplicationVersionId`.
Type : Long
Plage valide : valeur minimum de 1. Valeur maximale de 999999999.
Obligatoire : non
** [RunConfigurationUpdate](#API_UpdateApplication_RequestSyntax) **
Décrit les mises à jour des paramètres de démarrage de l'application.
Type : objet [RunConfigurationUpdate](API_RunConfigurationUpdate.md)
Obligatoire : non
** [RuntimeEnvironmentUpdate](#API_UpdateApplication_RequestSyntax) **
Met à jour l'environnement d'exécution Managed Service for Apache Flink utilisé pour exécuter votre code. Pour éviter les problèmes, vous devez :
+ Assurez-vous que votre nouveau fichier jar et vos dépendances sont compatibles avec le nouveau runtime sélectionné.
+ Assurez-vous que l'état de votre nouveau code est compatible avec l'instantané à partir duquel votre application démarrera
Type : Chaîne
Valeurs valides : `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`
Obligatoire : non
** [ServiceExecutionRoleUpdate](#API_UpdateApplication_RequestSyntax) **
Décrit les mises à jour apportées au rôle d'exécution du service.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.
Modèle : `arn:.*`
Obligatoire : non
## Syntaxe de la réponse
```
{
"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"
}
```
## Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
** [ApplicationDetail](#API_UpdateApplication_ResponseSyntax) **
Décrit les mises à jour de l’application.
Type : objet [ApplicationDetail](API_ApplicationDetail.md)
** [OperationId](#API_UpdateApplication_ResponseSyntax) **
ID d'opération qui peut être utilisé pour suivre la demande.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.
## Erreurs
** CodeValidationException **
Le code d'application (requête) fourni par l'utilisateur n'est pas valide. Il peut s’agir d’une simple erreur de syntaxe.
Code d’état HTTP : 400
** ConcurrentModificationException **
Exception déclenchée à la suite de modifications simultanées apportées à une application. Cette erreur peut être le résultat d'une tentative de modification d'une application sans utiliser l'ID d'application actuel.
Code d’état HTTP : 400
** InvalidApplicationConfigurationException **
La configuration de l'application fournie par l'utilisateur n'est pas valide.
Code d’état HTTP : 400
** InvalidArgumentException **
La valeur du paramètre d'entrée spécifiée n'est pas valide.
Code d’état HTTP : 400
** InvalidRequestException **
Le JSON de la requête n'est pas valide pour l'opération.
Code d’état HTTP : 400
** LimitExceededException **
Le nombre de ressources autorisées a été dépassé.
Code d’état HTTP : 400
** ResourceInUseException **
L'application n'est pas disponible pour cette opération.
Code d’état HTTP : 400
** ResourceNotFoundException **
L’application spécifiée est introuvable.
Code d’état HTTP : 400
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalyticsv2-2018-05-23/UpdateApplication)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalyticsv2-2018-05-23/UpdateApplication)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalyticsv2-2018-05-23/UpdateApplication)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalyticsv2-2018-05-23/UpdateApplication)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalyticsv2-2018-05-23/UpdateApplication)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalyticsv2-2018-05-23/UpdateApplication)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalyticsv2-2018-05-23/UpdateApplication)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalyticsv2-2018-05-23/UpdateApplication)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalyticsv2-2018-05-23/UpdateApplication)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalyticsv2-2018-05-23/UpdateApplication)