DescribeMountTargets - Amazon Elastic File System

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

DescribeMountTargets

傳回所有目前掛載目標的說明,或檔案系統的特定掛載目標。當請求所有目前的掛載目標時,未指定回應中傳回的掛載目標順序。

FileSystemId 中指定的檔案系統 ID 上或在 MountTargetId 中指定的掛載目標檔案系統上,此操作需要獲得 elasticfilesystem:DescribeMountTargets 動作的許可。

請求語法

GET /2015-02-01/mount-targets?AccessPointId=AccessPointId&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems&MountTargetId=MountTargetId HTTP/1.1

URI請求參數

請求使用下列URI參數。

AccessPointId

(選用) 您要列出其掛載目標的存取點 ID。如果您的請求中不包含 FileSystemIdMountTargetId,則其必須包含在您的請求中。接受存取點 ID 或ARN作為輸入。

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

模式:^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$

FileSystemId

(選用) 您要列出其掛載目標的檔案系統 ID (字串)。如果您的請求中不包含 AccessPointIdMountTargetId,則其必須包含在您的請求中。接受檔案系統 ID 或ARN作為輸入。

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

模式:^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

Marker

(選用) 從先前的 DescribeMountTargets 操作中傳回不透明分頁權杖 (字串)。如果存在,則指定從先前傳回呼叫中斷的地方繼續列表。

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

模式:.+

MaxItems

(選用) 在回應中傳回的掛載目標數量上限。目前,此數字會自動設定為 10,而忽略其他值。如果您有 100 多個掛載目標,那麽回應會以每頁 100 進行分頁。

有效範圍:最小值為 1。

MountTargetId

(選用) 您要描述的掛載目標 ID (字串)。如果您的請求中不包含 FileSystemId,則其必須包含在您的請求中。接受掛載目標 ID 或ARN作為輸入。

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

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

請求主體

請求沒有請求主體。

回應語法

HTTP/1.1 200 Content-type: application/json { "Marker": "string", "MountTargets": [ { "AvailabilityZoneId": "string", "AvailabilityZoneName": "string", "FileSystemId": "string", "IpAddress": "string", "LifeCycleState": "string", "MountTargetId": "string", "NetworkInterfaceId": "string", "OwnerId": "string", "SubnetId": "string", "VpcId": "string" } ], "NextMarker": "string" }

回應元素

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

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

Marker

如果請求包含 Marker,則回應會在此欄位中傳回該值。

類型:字串

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

模式:.+

MountTargets

將文件系統的掛載目標作為 MountTargetDescription 對象陣列傳回。

類型:MountTargetDescription 物件陣列

NextMarker

如果值存在,則會有更多要傳回的掛載目標。在後續請求中,您可以在請求中使用此值來提供 Marker,以擷取下一組掛載目標。

類型:字串

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

模式:.+

錯誤

AccessPointNotFound

如果請求者中不存在指定的AccessPointId AWS 帳戶值,則返回。

HTTP狀態碼:

BadRequest

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

HTTP狀態碼:

FileSystemNotFound

如果請求者中不存在指定的FileSystemId AWS 帳戶值,則返回。

HTTP狀態碼:

InternalServerError

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

HTTP狀態碼:5

MountTargetNotFound

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

HTTP狀態碼:

範例

擷取為檔案系統建立的掛載目標說明

下列請求會擷取針對指定檔案系統建立的掛載目標說明。

請求範例

GET /2015-02-01/mount-targets?FileSystemId=fs-01234567 HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140622T191252Z Authorization: <...>

回應範例

HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Type: application/json Content-Length: 357 { "MountTargets":[ { "OwnerId":"251839141158", "MountTargetId":"fsmt-01234567", "FileSystemId":"fs-01234567", "SubnetId":"subnet-01234567", "LifeCycleState":"added", "IpAddress":"10.0.2.42", "NetworkInterfaceId":"eni-1bcb7772" } ] }

另請參閱

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