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

# DescribeMountTargets
<a name="API_DescribeMountTargets"></a>

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

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

對應的 CLI 命令為 `describe-mount-targets`。

## 請求語法
<a name="API_DescribeMountTargets_RequestSyntax"></a>

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

## URI 請求參數
<a name="API_DescribeMountTargets_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [AccessPointId](#API_DescribeMountTargets_RequestSyntax) **   <a name="efs-DescribeMountTargets-request-uri-AccessPointId"></a>
(選用) 您要列出其掛載目標的存取點 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](#API_DescribeMountTargets_RequestSyntax) **   <a name="efs-DescribeMountTargets-request-uri-FileSystemId"></a>
(選用) 您要列出其掛載目標的檔案系統 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](#API_DescribeMountTargets_RequestSyntax) **   <a name="efs-DescribeMountTargets-request-uri-Marker"></a>
(選用) 從先前的 `DescribeMountTargets` 操作中傳回不透明分頁權杖 (字串)。如果存在，則指定從先前傳回呼叫中斷的地方繼續列表。  
長度限制：長度下限為 1。長度上限為 128。  
模式：`.+`

 ** [MaxItems](#API_DescribeMountTargets_RequestSyntax) **   <a name="efs-DescribeMountTargets-request-uri-MaxItems"></a>
(選用) 在回應中傳回的掛載目標數量上限。目前，此數字會自動設定為 10，而忽略其他值。如果您有 100 多個掛載目標，那麽回應會以每頁 100 進行分頁。  
有效範圍：最小值為 1。

 ** [MountTargetId](#API_DescribeMountTargets_RequestSyntax) **   <a name="efs-DescribeMountTargets-request-uri-MountTargetId"></a>
(選用) 您要描述的掛載目標 ID (字串)。如果您的請求中不包含 `FileSystemId`，則其必須包含在您的請求中。接受作為輸入的掛載目標 ID 或 ARN。  
長度限制：長度下限為 13。長度上限為 45。  
模式：`^fsmt-[0-9a-f]{8,40}$`

## 請求主體
<a name="API_DescribeMountTargets_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_DescribeMountTargets_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Marker": "string",
   "MountTargets": [ 
      { 
         "AvailabilityZoneId": "string",
         "AvailabilityZoneName": "string",
         "FileSystemId": "string",
         "IpAddress": "string",
         "Ipv6Address": "string",
         "LifeCycleState": "string",
         "MountTargetId": "string",
         "NetworkInterfaceId": "string",
         "OwnerId": "string",
         "SubnetId": "string",
         "VpcId": "string"
      }
   ],
   "NextMarker": "string"
}
```

## 回應元素
<a name="API_DescribeMountTargets_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

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

 ** [Marker](#API_DescribeMountTargets_ResponseSyntax) **   <a name="efs-DescribeMountTargets-response-Marker"></a>
如果請求包含 `Marker`，則回應會在此欄位中傳回該值。  
類型：字串  
長度限制：長度下限為 1。長度上限為 128。  
模式：`.+`

 ** [MountTargets](#API_DescribeMountTargets_ResponseSyntax) **   <a name="efs-DescribeMountTargets-response-MountTargets"></a>
將文件系統的掛載目標作為 `MountTargetDescription` 對象陣列傳回。  
類型：[MountTargetDescription](API_MountTargetDescription.md) 物件陣列

 ** [NextMarker](#API_DescribeMountTargets_ResponseSyntax) **   <a name="efs-DescribeMountTargets-response-NextMarker"></a>
如果值存在，則會有更多要傳回的掛載目標。在後續請求中，您可以在請求中使用此值來提供 `Marker`，以擷取下一組掛載目標。  
類型：字串  
長度限制：長度下限為 1。長度上限為 128。  
模式：`.+`

## 錯誤
<a name="API_DescribeMountTargets_Errors"></a>

 ** AccessPointNotFound **   
如果指定的`AccessPointId`值不存在於請求者的 中，則傳回 AWS 帳戶。    
 ** ErrorCode **   
錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。  
 ** Message **   
錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。
HTTP 狀態碼：404

 ** BadRequest **   
如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。    
 ** ErrorCode **   
錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。  
 ** Message **   
錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。
HTTP 狀態碼：400

 ** FileSystemNotFound **   
如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。    
 ** ErrorCode **   
錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。  
 ** Message **   
錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。
HTTP 狀態碼：404

 ** InternalServerError **   
如果伺服器端發生錯誤，則傳回。    
 ** ErrorCode **   
錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。  
 ** Message **   
錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。
HTTP 狀態碼：500

 ** MountTargetNotFound **   
如果在發起人的 AWS 帳戶帳戶中找不到指定 ID 的掛載目標，則傳回。    
 ** ErrorCode **   
錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。  
 ** Message **   
錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。
HTTP 狀態碼：404

## 範例
<a name="API_DescribeMountTargets_Examples"></a>

### 擷取為檔案系統建立的掛載目標說明
<a name="API_DescribeMountTargets_Example_1"></a>

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

#### 請求範例
<a name="API_DescribeMountTargets_Example_1_Request"></a>

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

#### 回應範例
<a name="API_DescribeMountTargets_Example_1_Response"></a>

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

## 另請參閱
<a name="API_DescribeMountTargets_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeMountTargets) 
+  [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeMountTargets) 
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeMountTargets) 
+  [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeMountTargets) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeMountTargets) 
+  [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeMountTargets) 
+  [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeMountTargets) 
+  [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeMountTargets) 
+  [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeMountTargets) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeMountTargets)