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 狀態碼：404

BadRequest

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

HTTP 狀態碼：400

FileSystemNotFound

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

HTTP 狀態碼：404

InternalServerError

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

HTTP 狀態碼：500

MountTargetNotFound

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

HTTP 狀態碼：404

範例

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

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

請求範例

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"
      }
   ]
}

另請參閱

如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊，請參閱下列內容：