DescribeMountTargetSecurityGroups - Amazon Elastic File System

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

DescribeMountTargetSecurityGroups

傳回掛載目標目前作用中的安全群組。此操作要求已建立掛載目標的網路介面,且掛載目標的生命週期狀態不是「已刪除 (deleted)」 。

此操作需要以下動作的許可:

  • 掛載目標檔案系統上的 elasticfilesystem:DescribeMountTargetSecurityGroups 動作。

  • ec2:DescribeNetworkInterfaceAttribute 掛載目標網路介面上的動作。

請求語法

GET /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1

URI請求參數

請求使用下列URI參數。

MountTargetId

您要擷取其安全群組的掛載目標 ID。

長度限制:長度下限為 13。長度上限為 45。

模式:^fsmt-[0-9a-f]{8,40}$

必要:是

請求主體

請求沒有請求主體。

回應語法

HTTP/1.1 200 Content-type: application/json { "SecurityGroups": [ "string" ] }

回應元素

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

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

SecurityGroups

安全群組陣列。

類型:字串陣列

陣列成員:最多 100 個項目。

長度限制:長度下限為 11。長度上限為 43。

模式:^sg-[0-9a-f]{8,40}

錯誤

BadRequest

如果請求格式錯誤或包含錯誤,例如無效的參數值或缺少必要參數,則傳回。

HTTP狀態碼:

IncorrectMountTargetState

如果掛載目標並未處於操作的正確狀態,則傳回。

HTTP狀態碼:4

InternalServerError

如果伺服器端發生錯誤,則傳回。

HTTP狀態碼:5

MountTargetNotFound

如果在發起人的 AWS 帳戶帳戶中找不到指定 ID 的掛載目標,則傳回。

HTTP狀態碼:

範例

擷取對檔案系統有效的安全群組

下列範例會擷取安全群組,這些安全群組對與掛載目標相關聯的網路介面有效。

請求範例

GET /2015-02-01/mount-targets/fsmt-9a13661e/security-groups HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140620T223513Z Authorization: <...>

回應範例

HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Length: 57 { "SecurityGroups" : [ "sg-188d9f74" ] }

另請參閱

如需有關API在其中一種特定語言中使用此功能的詳細資訊 AWS SDKs,請參閱下列內容: