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.
AddApplicationOutput
Ajoute une destination externe à votre application Kinesis Data Analytics basée sur SQL.
Si vous souhaitez que Kinesis Data Analytics diffuse des données depuis un flux intégré à l'application dans votre application vers une destination externe (tel qu'un flux de données Amazon Kinesis, un flux de diffusion Amazon Kinesis Firehose ou une fonction Amazon Lambda), vous ajoutez la configuration appropriée à votre application à l'aide de l'opération suivante. Vous pouvez configurer une ou plusieurs sorties pour votre application. Chaque configuration de sortie mappe un flux intégré à l'application et une destination externe.
Vous pouvez utiliser l'une des configurations de sortie pour diffuser des données depuis votre flux d'erreurs intégré à l'application vers une destination externe, ce qui vous permet d'analyser les erreurs.
Toutes les mises à jour de la configuration, y compris l'ajout d'une source de streaming à l'aide de cette opération, débouchent sur une nouvelle version de l'application. Vous pouvez utiliser l'opération DescribeApplication pour rechercher la version de l'application actuelle.
Syntaxe de la requête
{
"ApplicationName": "string
",
"CurrentApplicationVersionId": number
,
"Output": {
"DestinationSchema": {
"RecordFormatType": "string
"
},
"KinesisFirehoseOutput": {
"ResourceARN": "string
"
},
"KinesisStreamsOutput": {
"ResourceARN": "string
"
},
"LambdaOutput": {
"ResourceARN": "string
"
},
"Name": "string
"
}
}
Paramètres de demande
Cette demande accepte les données suivantes au format JSON.
- ApplicationName
-
Nom de l'application à laquelle vous souhaitez ajouter la configuration de sortie.
Type : chaîne
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128.
Modèle :
[a-zA-Z0-9_.-]+
Obligatoire : oui
- CurrentApplicationVersionId
-
Version de l'application à laquelle vous souhaitez ajouter la configuration de sortie. Vous pouvez utiliser cette DescribeApplication opération pour obtenir la version actuelle de l'application. Si la version spécifiée n’est pas la version actuelle,
ConcurrentModificationException
est renvoyé.Type : long
Plage valide : valeur minimum de 1. Valeur maximale de 999999999.
Obligatoire : oui
- Output
-
Tableau d'objets, chacun décrivant une configuration de sortie. Dans la configuration de sortie, vous spécifiez le nom d'un flux intégré à l'application, d'une destination (c'est-à-dire un flux de données Kinesis, un flux de diffusion Kinesis Data Firehose ou une fonction Amazon Lambda), et vous enregistrez la formation à utiliser lors de l'écriture vers la destination.
Type : objet Output
Obligatoire : oui
Syntaxe de la réponse
{
"ApplicationARN": "string",
"ApplicationVersionId": number,
"OutputDescriptions": [
{
"DestinationSchema": {
"RecordFormatType": "string"
},
"KinesisFirehoseOutputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"KinesisStreamsOutputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"LambdaOutputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"Name": "string",
"OutputId": "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.
- ApplicationARN
-
Amazon Resource Name (ARN) de l'application .
Type : chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.
Modèle :
arn:.*
- ApplicationVersionId
-
L'ID de version de l'application mis à jour. Kinesis Data Analytics incrémente cet identifiant lors de la mise à jour de l'application.
Type : long
Plage valide : valeur minimum de 1. Valeur maximale de 999999999.
- OutputDescriptions
-
Décrit la configuration de sortie de l’application. Pour plus d'informations, consultez Configuration de la sortie d'application.
Type : tableau d’objets OutputDescription
Erreurs
- 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
- 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
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 :