StartApplication - Guide du développeur d'Amazon Kinesis Data Analytics SQL pour applications

Pour les nouveaux projets, nous vous recommandons d'utiliser le nouveau service géré pour Apache Flink Studio plutôt que Kinesis Data Analytics SQL for Applications. Le service géré pour Apache Flink Studio allie facilité d’utilisation et capacités analytiques avancées, ce qui vous permet de créer des applications sophistiquées de traitement des flux en quelques minutes.

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.

StartApplication

Note

Cette documentation est destinée à la version 1 de l’API Amazon Kinesis Data Analytics, qui est compatible uniquement avec les applications SQL. La version 2 de l’API est compatible avec les applications SQL et Java. Pour plus d’informations sur la version 2, consultez la documentation de l’API Amazon Kinesis Data Analytics V2.

Démarre l’application Amazon Kinesis Analytics spécifiée. Après avoir créé une application, vous devez exclusivement appeler cette opération pour démarrer votre application.

Une fois que l’application démarre, elle commence à consommer les données d’entrée, à les traiter et à écrire la sortie sur la destination configurée.

Le statut de l’application doit être READY pour que vous puissiez la démarrer. Vous pouvez obtenir l'état de l'application dans la console ou à l'aide de l'DescribeApplicationopération.

Après avoir démarré l'application, vous pouvez l'empêcher de traiter l'entrée en appelant l'StopApplicationopération.

Cette opération exige des autorisations pour exécuter l'action kinesisanalytics:StartApplication.

Syntaxe de la requête

{ "ApplicationName": "string", "InputConfigurations": [ { "Id": "string", "InputStartingPositionConfiguration": { "InputStartingPosition": "string" } } ] }

Paramètres de demande

Cette demande accepte les données suivantes au format JSON.

ApplicationName

Nom de l’application.

Type : chaîne

Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128.

Modèle : [a-zA-Z0-9_.-]+

Obligatoire : oui

InputConfigurations

Identifie l’entrée spécifique, par ID, que l’application commence à consommer. Amazon Kinesis Analytics commence à lire la source de streaming associée à l’entrée. Vous pouvez également spécifier l’endroit de la source de streaming à partir duquel Amazon Kinesis Analytics doit commence à lire.

Type : tableau d’objets InputConfiguration

Obligatoire : oui

Éléments de réponse

Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.

Erreurs

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

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

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 :