本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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
-
您用來為應用程式更新實作強式並行的值。您必須提供
ApplicationVersionID
或ConditionalToken
。你得到應用程序的當前ConditionalToken
使用DescribeApplication. 為了獲得更好的CurrentApplicationVersionId
並發支持,請使用ConditionalToken
參數而不是。類型:字串
長度限制:長度下限為 1。長度上限為 512。
模式:
[a-zA-Z0-9-_+/=]+
必要:否
- CurrentApplicationVersionId
-
您要新增 VPC 組態的應用程式版本。您必須提供
CurrentApplicationVersionId
或ConditionalToken
。您可以使用該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 組態的參數。
錯誤
- ConcurrentModificationException
-
因應用程式並行修改而擲回的例外狀況。此錯誤可能是因為嘗試在不使用目前應用程式 ID 的情況下修改應用程式所致。
HTTP 狀態碼:400
- InvalidApplicationConfigurationException
-
使用者提供的應用程式組態無效。
HTTP 狀態碼:400
- InvalidArgumentException
-
指定的輸入參數值無效。
HTTP 狀態碼:400
- ResourceInUseException
-
該應用程序不適用於此操作。
HTTP 狀態碼:400
- ResourceNotFoundException
-
找不到指定的應用程式。
HTTP 狀態碼:400
另請參閱
如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: