DescribeMountTargets - Amazon Elastic File System
請求語法URI請求參數請求主體回應語法回應元素錯誤範例另請參閱

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

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。如果您的請求中不包含 FileSystemId 或 MountTargetId，則其必須包含在您的請求中。接受存取點 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 (字串)。如果您的請求中不包含 AccessPointId 或 MountTargetId，則其必須包含在您的請求中。接受檔案系統 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，請參閱下列內容：