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

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

DescribeFileSystems

如果提供了檔案系統CreationToken或EFS檔案系統，則傳回特定 Amazon 檔案系統的說明。FileSystemId否則，它將返回調用者在您調用的端點 AWS 帳戶 中擁有 AWS 區域 的所有文件系統的描述。

擷取所有檔案系統描述時，您可以選擇性地指定 MaxItems 參數，以限制回應中的描述數目。此數字會自動設定為 100。如果保留更多文件系統描述，Amazon 在響應中EFS返回一NextMarker個不透明的令牌。在這種情況下，您應該使用 Marker 請求參數 (設定為 NextMarker 的值) 傳送後續請求。

若要擷取檔案系統描述清單，則要在反覆程序中使用如下操作，即先呼叫 DescribeFileSystems 而不包含 Marker，然後使用 Marker 參數繼續呼叫，直至沒有 NextMarker 回應爲止。其中，參數設定為先前回應的 NextMarker 值。

未指定一次 DescribeFileSystems 呼叫回應中傳回的檔案系統順序，也未指定跨多路呼叫重複回應傳回的檔案系統順序。

這項操作需要 elasticfilesystem:DescribeFileSystems 動作的許可。

請求語法

GET /2015-02-01/file-systems?CreationToken=CreationToken&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems HTTP/1.1

URI請求參數

請求使用下列URI參數。

CreationToken

(可選) 使用此建立權杖 (字串) 將列表限制為檔案系統。您可以在建立 Amazon EFS 檔案系統時指定建立權杖。

長度限制：長度下限為 1。長度上限為 64。

模式：.+

FileSystemId

(選用) 您要擷取其說明的檔案系統 ID (字串)。

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

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

Marker

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

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

模式：.+

MaxItems

(選用) 指定回應中傳回的檔案系統數量上限。此數字會自動設定為 100。如果您有 100 多個檔案系統，那麽回應會以每頁 100 進行分頁。

有效範圍：最小值為 1。

請求主體

請求沒有請求主體。

回應語法

HTTP/1.1 200
Content-type: application/json

{
   "FileSystems": [ 
      { 
         "AvailabilityZoneId": "string",
         "AvailabilityZoneName": "string",
         "CreationTime": number,
         "CreationToken": "string",
         "Encrypted": boolean,
         "FileSystemArn": "string",
         "FileSystemId": "string",
         "FileSystemProtection": { 
            "ReplicationOverwriteProtection": "string"
         },
         "KmsKeyId": "string",
         "LifeCycleState": "string",
         "Name": "string",
         "NumberOfMountTargets": number,
         "OwnerId": "string",
         "PerformanceMode": "string",
         "ProvisionedThroughputInMibps": number,
         "SizeInBytes": { 
            "Timestamp": number,
            "Value": number,
            "ValueInArchive": number,
            "ValueInIA": number,
            "ValueInStandard": number
         },
         "Tags": [ 
            { 
               "Key": "string",
               "Value": "string"
            }
         ],
         "ThroughputMode": "string"
      }
   ],
   "Marker": "string",
   "NextMarker": "string"
}

回應元素

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

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

FileSystems

檔案系統描述陣列。

類型：FileSystemDescription 物件陣列

Marker

如果在請求中由發起人提供了相應的信息 (字串)，那麼這個信息就會在響應中呈現。

類型：字串

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

模式：.+

NextMarker

如果在回應中傳回的文件系統數量少於所有存在的文件系統，那麼相應的信息 (字串)就會在響應中呈現。您可以在後續請求中使用 NextMarker 來擷取下一頁描述。

類型：字串

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

模式：.+

錯誤

BadRequest

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

HTTP狀態碼:

FileSystemNotFound

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

HTTP狀態碼:

InternalServerError

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

HTTP狀態碼:5

範例

擷取 10 個檔案系統清單

下列範例會將要GET求傳送至file-systems端點 (elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems)。請求會指定 MaxItems 查詢參數，以便將檔案系統描述的數目限制為 10。

請求範例

GET /2015-02-01/file-systems?MaxItems=10 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T191208Z
Authorization: <...>

回應範例

HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 499
{
   "FileSystems":[
      {
         "OwnerId":"251839141158",
         "CreationToken":"MyFileSystem1",
         "FileSystemId":"fs-01234567",
         "PerformanceMode" : "generalPurpose",
         "CreationTime":"1403301078",
         "LifeCycleState":"created",
         "Name":"my first file system",
         "NumberOfMountTargets":1,
         "SizeInBytes":{
            "Timestamp": 1403301078,
            "Value": 29313618372,
            "ValueInArchive": 201156,
            "ValueInIA": 675432,
            "ValueInStandard": 29312741784
         }
      }
   ]
}

另請參閱

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