本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
ModifyMountTargetSecurityGroups
修改掛載目標的作用中的安全群組。
當您建立掛載目標時,Amazon EFS 也會建立新的網路介面。如需詳細資訊,請參閱 CreateMountTarget。此作業會以要求中提供的,取代與掛載目標相關聯之網路介面的 SecurityGroups
有效安全群組。此操作要求已建立掛載目標的網路介面,且掛載目標的生命週期狀態不是「已刪除 (deleted
)」 。
此作業需要下列動作的權限:
-
掛載目標檔案系統上的
elasticfilesystem:ModifyMountTargetSecurityGroups
動作。 -
ec2:ModifyNetworkInterfaceAttribute
掛載目標網路介面上的動作。
請求語法
PUT /2015-02-01/mount-targets/MountTargetId
/security-groups HTTP/1.1
Content-type: application/json
{
"SecurityGroups": [ "string
" ]
}
URI請求參數
請求使用下列URI參數。
- MountTargetId
-
您要修改其安全群組的掛載目標 ID。
長度限制:長度下限為 13。長度上限為 45。
模式:
^fsmt-[0-9a-f]{8,40}$
必要:是
請求主體
請求接受以下JSON格式的數據。
- SecurityGroups
-
最多五個VPC安全群組的陣列IDs。
類型:字串陣列
陣列成員:最多 100 個項目。
長度限制:長度下限為 11。長度上限為 43。
模式:
^sg-[0-9a-f]{8,40}
必要:否
回應語法
HTTP/1.1 204
回應元素
如果動作成功,服務會傳回具有空HTTP主體的 HTTP 204 回應。
錯誤
- BadRequest
-
如果請求格式錯誤或包含錯誤,例如無效的參數值或缺少必要參數,則傳回。
HTTP狀態碼:
- IncorrectMountTargetState
-
如果掛載目標並未處於操作的正確狀態,則傳回。
HTTP狀態碼:4
- InternalServerError
-
如果伺服器端發生錯誤,則傳回。
HTTP狀態碼:5
- MountTargetNotFound
-
如果在發起人的 AWS 帳戶帳戶中找不到指定 ID 的掛載目標,則傳回。
HTTP狀態碼:
- SecurityGroupLimitExceeded
-
如果請求中指定的
SecurityGroups
大小大於五,則傳回。HTTP狀態碼:
- SecurityGroupNotFound
-
如果子網路的虛擬私有雲中沒有其中一個指定的安全性群組,則傳回。VPC
HTTP狀態碼:
範例
取代裝載目標的安全群組
下列範例會取代與掛載目標相關聯之網路介面的有效安全群組。
請求範例
PUT /2015-02-01/mount-targets/fsmt-9a13661e/security-groups HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T223446Z
Authorization: <...>
Content-Type: application/json
Content-Length: 57
{
"SecurityGroups" : [
"sg-188d9f74"
]
}
回應範例
HTTP/1.1 204 No Content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
另請參閱
如需有關API在其中一種特定語言中使用此功能的詳細資訊 AWS SDKs,請參閱下列內容: