CreateApplication - Amazon Managed Service pour Apache Flink (anciennement Amazon Kinesis Data Analytics pour Apache Flink)

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, consultez la section Création d'une application.

Syntaxe de la requête

{ "ApplicationConfiguration": { "ApplicationCodeConfiguration": { "CodeContent": { "S3ContentLocation": { "BucketARN": "string", "FileKey": "string", "ObjectVersion": "string" }, "TextContent": "string", "ZipFileContent": blob }, "CodeContentType": "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

Utilisez ce paramètre pour configurer l'application.

Type : objet ApplicationConfiguration

Obligatoire : non

ApplicationDescription

Description sommaire de l'application.

Type : chaîne

Contraintes de longueur : longueur minimum de 0. Longueur maximale de 1024.

Obligatoire : non

ApplicationMode

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

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

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

Obligatoire : non

RuntimeEnvironment

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

Obligatoire : oui

ServiceExecutionRole

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

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.

Type : tableau d’objets Tag

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" }, "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

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

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

consultez aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :