AddApplicationVpcConfiguration - Amazon Managed Service for Apache Flink (先前為 Amazon Kinesis Data Analytics for Apache Flink)

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

AddApplicationVpcConfiguration

將 Virtual Private Cloud (VPC) 組態新增至應用程式。應用程式可以使用 VPC 安全地儲存和存取資源。

請注意下列有關 Apache Flink 應用程式之受管理服務的 VPC 組態的相關資訊:

  • SQL 應用程式不支援 VPC 組態。

  • 將 VPC 新增至 Apache Flink 應用程式的受管理服務時,無法再直接從網際網路存取該應用程式。若要啟用對應用程式的網際網路存取,請將網際網路閘道新增至您的 VPC。

請求語法

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

請求參數

請求接受採用 JSON 格式的下列資料。

ApplicationName

現有應用程式的名稱。

類型:字串

長度限制:長度下限為 1。長度上限為 128。

模式:[a-zA-Z0-9_.-]+

必要:是

ConditionalToken

您用來為應用程式更新實作強式並行的值。您必須提供ApplicationVersionIDConditionalToken。你得到應用程序的當前ConditionalToken使用DescribeApplication. 為了獲得更好的CurrentApplicationVersionId並發支持,請使用ConditionalToken參數而不是。

類型:字串

長度限制:長度下限為 1。長度上限為 512。

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

必要:否

CurrentApplicationVersionId

您要新增 VPC 組態的應用程式版本。您必須提供CurrentApplicationVersionIdConditionalToken。您可以使用該DescribeApplication操作來獲取當前應用程序版本。如果指定的版本不是目前版本,則會傳回 ConcurrentModificationException。為了獲得更好的CurrentApplicationVersionId並發支持,請使用ConditionalToken參數而不是。

類型:Long

有效範圍:最小值為 1。最大值為 999999999。

必要:否

VpcConfiguration

要新增至應用程式的 VPC 說明。

類型:VpcConfiguration 物件

必要:是

回應語法

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

回應元素

如果動作成功,則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

ApplicationARN

應用程式的 ARN。

類型:字串

長度限制:長度下限為 1。長度上限為 2048。

模式:arn:.*

ApplicationVersionId

提供目前的應用程式版本。Apache Flink 的受管理服務會在您 ApplicationVersionId 每次更新應用程式時更新。

類型:Long

有效範圍:最小值為 1。最大值為 999999999。

OperationId

可用來追蹤要求的作業 ID。

類型:字串

長度限制:長度下限為 1。長度上限為 64。

VpcConfigurationDescription

新 VPC 組態的參數。

類型:VpcConfigurationDescription 物件

錯誤

ConcurrentModificationException

因應用程式並行修改而擲回的例外狀況。此錯誤可能是因為嘗試在不使用目前應用程式 ID 的情況下修改應用程式所致。

HTTP 狀態碼:400

InvalidApplicationConfigurationException

使用者提供的應用程式組態無效。

HTTP 狀態碼:400

InvalidArgumentException

指定的輸入參數值無效。

HTTP 狀態碼:400

ResourceInUseException

該應用程序不適用於此操作。

HTTP 狀態碼:400

ResourceNotFoundException

找不到指定的應用程式。

HTTP 狀態碼:400

另請參閱

如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: