AddApplicationVpcConfiguration - Amazon Managed Service für Apache Flink (früher Amazon Kinesis Data Analytics für Apache Flink)
AnforderungssyntaxAnforderungsparameterAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

AddApplicationVpcConfiguration

Fügt der Anwendung eine Virtual Private Cloud (VPC) -Konfiguration hinzu. Anwendungen können VPCs verwenden, um Ressourcen sicher zu speichern und darauf zuzugreifen.

Beachten Sie Folgendes zu VPC-Konfigurationen für Managed Service für Apache Flink-Anwendungen:

  • VPC-Konfigurationen werden für SQL-Anwendungen nicht unterstützt.

  • Wenn eine VPC zu einer Managed Service for Apache Flink-Anwendung hinzugefügt wird, kann nicht mehr direkt über das Internet auf die Anwendung zugegriffen werden. Um den Internetzugriff auf die Anwendung zu aktivieren, fügen Sie Ihrer VPC ein Internet-Gateway hinzu.

Anforderungssyntax

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

Anforderungsparameter

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

ApplicationName

Der Name einer vorhandenen Anwendung.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.

Pattern: [a-zA-Z0-9_.-]+

Erforderlich: Ja

ConditionalToken

Ein Wert, den Sie verwenden, um eine starke Parallelität für Anwendungsupdates zu implementieren. Sie müssen das ApplicationVersionID oder das ConditionalToken angeben. Sie erhalten die aktuelle ConditionalToken Verwendung der AnwendungDescribeApplication. Verwenden Sie für eine bessere Unterstützung der Parallelität den ConditionalToken Parameter anstelle vonCurrentApplicationVersionId.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge von 512.

Pattern: [a-zA-Z0-9-_+/=]+

Erforderlich: Nein

CurrentApplicationVersionId

Die Version der Anwendung, zu der Sie die VPC-Konfiguration hinzufügen möchten. Sie müssen das CurrentApplicationVersionId oder das ConditionalToken angeben. Sie können den DescribeApplication Vorgang verwenden, um die aktuelle Anwendungsversion abzurufen. Wenn die angegebene Version nicht die aktuelle Version ist, wird ConcurrentModificationException zurückgegeben. Verwenden Sie für eine bessere Unterstützung der Parallelität den ConditionalToken Parameter anstelle vonCurrentApplicationVersionId.

Type: Long

Gültiger Bereich: Mindestwert 1. Maximaler Wert von 999999999.

Erforderlich: Nein

VpcConfiguration

Beschreibung der VPC, die der Anwendung hinzugefügt werden soll.

Typ: VpcConfiguration Objekt

Erforderlich: Ja

Antwortsyntax

{
   "ApplicationARN": "string",
   "ApplicationVersionId": number,
   "OperationId": "string",
   "VpcConfigurationDescription": { 
      "SecurityGroupIds": [ "string" ],
      "SubnetIds": [ "string" ],
      "VpcConfigurationId": "string",
      "VpcId": "string"
   }
}

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

ApplicationARN

Der ARN der Anwendung.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen.

Pattern: arn:.*

ApplicationVersionId

Gibt die aktuelle Anwendungsversion an. Managed Service für Apache Flink wird ApplicationVersionId jedes Mal aktualisiert, wenn Sie die Anwendung aktualisieren.

Type: Long

Gültiger Bereich: Mindestwert 1. Maximaler Wert von 999999999.

OperationId

Die Vorgangs-ID, mit der die Anfrage verfolgt werden kann.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.

VpcConfigurationDescription

Die Parameter der neuen VPC-Konfiguration.

Typ: VpcConfigurationDescription Objekt

Fehler

ConcurrentModificationException

Ausnahme, die als Ergebnis gleichzeitiger Änderungen an einer Anwendung ausgelöst wird. Dieser Fehler kann das Ergebnis des Versuchs sein, eine Anwendung zu ändern, ohne die aktuelle Anwendungs-ID zu verwenden.

HTTP Status Code: 400

InvalidApplicationConfigurationException

Die vom Benutzer bereitgestellte Anwendungskonfiguration ist nicht gültig.

HTTP Status Code: 400

InvalidArgumentException

Der angegebene Eingabeparameterwert ist nicht gültig.

HTTP Status Code: 400

ResourceInUseException

Die Anwendung ist für diesen Vorgang nicht verfügbar.

HTTP Status Code: 400

ResourceNotFoundException

Die angegebene Anwendung kann nicht gefunden werden.

HTTP Status Code: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: