ModifyMountTargetSecurityGroups - Amazon Elastic File System

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

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,請參閱下列內容: