AddApplicationVpcConfiguration - Amazon Managed Service pour Apache Flink (anciennement Amazon Kinesis Data Analytics pour Apache Flink)
Syntaxe de la requêteParamètres de demandeSyntaxe de la réponseEléments de réponseErreursconsultez aussi

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.

AddApplicationVpcConfiguration

Ajoute une configuration Virtual Private Cloud (VPC) à l'application. Les applications peuvent utiliser des VPC pour stocker des ressources et y accéder en toute sécurité.

Notez ce qui suit à propos des configurations VPC pour le service géré pour les applications Apache Flink :

  • Les configurations VPC ne sont pas prises en charge pour les applications SQL.

  • Lorsqu'un VPC est ajouté à une application Managed Service for Apache Flink, il n'est plus possible d'accéder directement à l'application depuis Internet. Pour activer l'accès Internet à l'application, ajoutez une passerelle Internet à votre VPC.

Syntaxe de la requête

{
   "ApplicationName": "string",
   "ConditionalToken": "string",
   "CurrentApplicationVersionId": number,
   "VpcConfiguration": { 
      "SecurityGroupIds": [ "string" ],
      "SubnetIds": [ "string" ]
   }
}

Paramètres de demande

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

ApplicationName

Le nom d'une application existante.

Type : chaîne

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

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

Obligatoire : oui

ConditionalToken

Valeur que vous utilisez pour implémenter une forte simultanéité pour les mises à jour des applications. Vous devez fournir le ApplicationVersionID ou leConditionalToken. Vous obtenez l'ConditionalTokenutilisation actuelle de l'applicationDescribeApplication. Pour une meilleure prise en charge de la simultanéité, utilisez le ConditionalToken paramètre au lieu deCurrentApplicationVersionId.

Type : chaîne

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

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

Obligatoire : non

CurrentApplicationVersionId

Version de l'application à laquelle vous souhaitez ajouter la configuration VPC. Vous devez fournir le CurrentApplicationVersionId ou leConditionalToken. 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é. Pour une meilleure prise en charge de la simultanéité, utilisez le ConditionalToken paramètre au lieu deCurrentApplicationVersionId.

Type : long

Plage valide : valeur minimum de 1. Valeur maximale de 999999999.

Obligatoire : non

VpcConfiguration

Description du VPC à ajouter à l'application.

Type : objet VpcConfiguration

Obligatoire : oui

Syntaxe de la réponse

{
   "ApplicationARN": "string",
   "ApplicationVersionId": number,
   "OperationId": "string",
   "VpcConfigurationDescription": { 
      "SecurityGroupIds": [ "string" ],
      "SubnetIds": [ "string" ],
      "VpcConfigurationId": "string",
      "VpcId": "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

L'ARN de l'application.

Type : chaîne

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

Modèle : arn:.*

ApplicationVersionId

Fournit la version d’application actuelle. Le service géré pour Apache Flink est mis à jour ApplicationVersionId chaque fois que vous mettez à jour l'application.

Type : long

Plage valide : valeur minimum de 1. Valeur maximale de 999999999.

OperationId

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.

VpcConfigurationDescription

Les paramètres de la nouvelle configuration du VPC.

Type : objet VpcConfigurationDescription

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

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

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 :