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.
# CreateApplication
Crée un service géré pour l'application Apache Flink. Pour plus d'informations sur la création d'un service géré pour l'application Apache Flink, voir [Création d'une application](https://docs.aws.amazon.com/kinesisanalytics/latest/java/getting-started.html).
## Syntaxe de la requête
```
{
"ApplicationConfiguration": {
"ApplicationCodeConfiguration": {
"CodeContent": {
"S3ContentLocation": {
"BucketARN": "string",
"FileKey": "string",
"ObjectVersion": "string"
},
"TextContent": "string",
"ZipFileContent": blob
},
"CodeContentType": "string"
},
"ApplicationEncryptionConfiguration": {
"KeyId": "string",
"KeyType": "string"
},
"ApplicationSnapshotConfiguration": {
"SnapshotsEnabled": boolean
},
"ApplicationSystemRollbackConfiguration": {
"RollbackEnabled": boolean
},
"EnvironmentProperties": {
"PropertyGroups": [
{
"PropertyGroupId": "string",
"PropertyMap": {
"string" : "string"
}
}
]
},
"FlinkApplicationConfiguration": {
"CheckpointConfiguration": {
"CheckpointingEnabled": boolean,
"CheckpointInterval": number,
"ConfigurationType": "string",
"MinPauseBetweenCheckpoints": number
},
"MonitoringConfiguration": {
"ConfigurationType": "string",
"LogLevel": "string",
"MetricsLevel": "string"
},
"ParallelismConfiguration": {
"AutoScalingEnabled": boolean,
"ConfigurationType": "string",
"Parallelism": number,
"ParallelismPerKPU": number
}
},
"SqlApplicationConfiguration": {
"Inputs": [
{
"InputParallelism": {
"Count": number
},
"InputProcessingConfiguration": {
"InputLambdaProcessor": {
"ResourceARN": "string"
}
},
"InputSchema": {
"RecordColumns": [
{
"Mapping": "string",
"Name": "string",
"SqlType": "string"
}
],
"RecordEncoding": "string",
"RecordFormat": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string",
"RecordRowDelimiter": "string"
},
"JSONMappingParameters": {
"RecordRowPath": "string"
}
},
"RecordFormatType": "string"
}
},
"KinesisFirehoseInput": {
"ResourceARN": "string"
},
"KinesisStreamsInput": {
"ResourceARN": "string"
},
"NamePrefix": "string"
}
],
"Outputs": [
{
"DestinationSchema": {
"RecordFormatType": "string"
},
"KinesisFirehoseOutput": {
"ResourceARN": "string"
},
"KinesisStreamsOutput": {
"ResourceARN": "string"
},
"LambdaOutput": {
"ResourceARN": "string"
},
"Name": "string"
}
],
"ReferenceDataSources": [
{
"ReferenceSchema": {
"RecordColumns": [
{
"Mapping": "string",
"Name": "string",
"SqlType": "string"
}
],
"RecordEncoding": "string",
"RecordFormat": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string",
"RecordRowDelimiter": "string"
},
"JSONMappingParameters": {
"RecordRowPath": "string"
}
},
"RecordFormatType": "string"
}
},
"S3ReferenceDataSource": {
"BucketARN": "string",
"FileKey": "string"
},
"TableName": "string"
}
]
},
"VpcConfigurations": [
{
"SecurityGroupIds": [ "string" ],
"SubnetIds": [ "string" ]
}
],
"ZeppelinApplicationConfiguration": {
"CatalogConfiguration": {
"GlueDataCatalogConfiguration": {
"DatabaseARN": "string"
}
},
"CustomArtifactsConfiguration": [
{
"ArtifactType": "string",
"MavenReference": {
"ArtifactId": "string",
"GroupId": "string",
"Version": "string"
},
"S3ContentLocation": {
"BucketARN": "string",
"FileKey": "string",
"ObjectVersion": "string"
}
}
],
"DeployAsApplicationConfiguration": {
"S3ContentLocation": {
"BasePath": "string",
"BucketARN": "string"
}
},
"MonitoringConfiguration": {
"LogLevel": "string"
}
}
},
"ApplicationDescription": "string",
"ApplicationMode": "string",
"ApplicationName": "string",
"CloudWatchLoggingOptions": [
{
"LogStreamARN": "string"
}
],
"RuntimeEnvironment": "string",
"ServiceExecutionRole": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Paramètres de demande
Cette demande accepte les données suivantes au format JSON.
** [ApplicationConfiguration](#API_CreateApplication_RequestSyntax) **
Utilisez ce paramètre pour configurer l'application.
Type : objet [ApplicationConfiguration](API_ApplicationConfiguration.md)
Obligatoire : non
** [ApplicationDescription](#API_CreateApplication_RequestSyntax) **
Description sommaire de l'application.
Type : Chaîne
Contraintes de longueur : longueur minimum de 0. Longueur maximale de 1024.
Obligatoire : non
** [ApplicationMode](#API_CreateApplication_RequestSyntax) **
Utilisez ce `STREAMING` mode pour créer un service géré pour l'application Apache Flink. Pour créer un service géré pour le bloc-notes Apache Flink Studio, utilisez le `INTERACTIVE` mode.
Type : Chaîne
Valeurs valides : `STREAMING | INTERACTIVE`
Obligatoire : non
** [ApplicationName](#API_CreateApplication_RequestSyntax) **
Le nom de votre application (par exemple,`sample-app`).
Type : Chaîne
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128.
Modèle : `[a-zA-Z0-9_.-]+`
Obligatoire : oui
** [CloudWatchLoggingOptions](#API_CreateApplication_RequestSyntax) **
Utilisez ce paramètre pour configurer un flux de CloudWatch journal Amazon afin de surveiller les erreurs de configuration des applications.
Type : tableau d’objets [CloudWatchLoggingOption](API_CloudWatchLoggingOption.md)
Obligatoire : non
** [RuntimeEnvironment](#API_CreateApplication_RequestSyntax) **
Environnement d'exécution de l'application.
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 : oui
** [ServiceExecutionRole](#API_CreateApplication_RequestSyntax) **
Rôle IAM utilisé par l'application pour accéder aux flux de données Kinesis, aux flux de diffusion Kinesis Data Firehose, aux objets Amazon S3 et à d'autres ressources externes.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.
Modèle : `arn:.*`
Obligatoire : oui
** [Tags](#API_CreateApplication_RequestSyntax) **
Liste d'une ou plusieurs balises à affecter à l'application. Une balise est une paire clé-valeur qui identifie une application. Notez que le nombre maximal de balises d'application inclut les balises système. Le nombre maximal de balises d'application définies par l'utilisateur est de 50. Pour plus d’informations, consultez la section [Utilisation du balisage](https://docs.aws.amazon.com/kinesisanalytics/latest/java/how-tagging.html).
Type : tableau d’objets [Tag](API_Tag.md)
Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 200 éléments.
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"
}
}
```
## 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_CreateApplication_ResponseSyntax) **
En réponse à votre `CreateApplication` demande, Managed Service for Apache Flink renvoie une réponse contenant les détails de l'application créée.
Type : objet [ApplicationDetail](API_ApplicationDetail.md)
## 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
** 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
** TooManyTagsException **
Application créée avec trop de balises ou trop de balises ajoutées à une application. Notez que le nombre maximal de balises d'application inclut les balises système. Le nombre maximal de balises d'application définies par l'utilisateur est de 50.
Code d’état HTTP : 400
** UnsupportedOperationException **
La requête a été rejetée car un paramètre spécifié n’est pas pris en charge ou parce qu’une ressource spécifiée n’est pas valide pour cette opération.
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/CreateApplication)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalyticsv2-2018-05-23/CreateApplication)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalyticsv2-2018-05-23/CreateApplication)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalyticsv2-2018-05-23/CreateApplication)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalyticsv2-2018-05-23/CreateApplication)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalyticsv2-2018-05-23/CreateApplication)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalyticsv2-2018-05-23/CreateApplication)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalyticsv2-2018-05-23/CreateApplication)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalyticsv2-2018-05-23/CreateApplication)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalyticsv2-2018-05-23/CreateApplication)