DescribeFileSystems

파일 시스템 CreationToken 또는 FileSystemId가 제공된 경우 특정 Amazon EFS 파일 시스템에 대한 설명을 반환합니다. 그렇지 않을 경우 사용자가 직접 호출하는 엔드포인트의 AWS 리전에서 호출자의 AWS 계정이 소유하는 모든 파일 시스템에 대한 설명을 반환합니다.

모든 파일 시스템 설명을 검색할 때 선택적으로 MaxItems 파라미터를 지정하여 응답의 설명 수를 제한할 수 있습니다. 이 숫자는 자동으로 100으로 설정됩니다. 파일 시스템 설명이 더 남아 있는 경우 Amazon EFS는 응답으로 불투명 토큰인 NextMarker를 반환합니다. 이 경우 Marker 요청 파라미터를 NextMarker 값으로 설정하여 후속 요청을 보내야 합니다.

파일 시스템 설명 목록을 검색하기 위해 이 작업을 반복 프로세스에서 사용합니다. 반복 프로세스에서는 Marker를 사용하지 않고 DescribeFileSystems를 먼저 직접 호출한 다음 Marker 파라미터를 이전 응답의 NextMarker 값으로 설정한 다음 응답에 NextMarker가 없을 때까지 계속 직접 호출합니다.

한 번의 DescribeFileSystems 직접 호출에 대한 응답으로 반환되는 파일 시스템의 순서와 다중 직접 호출 반복의 응답에서 반환되는 파일 시스템의 순서는 지정되지 않았습니다.

이 작업에는 elasticfilesystem:DescribeFileSystems 액션에 대한 권한이 필요합니다.

Request Syntax

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

URI 요청 파라미터

요청은 다음 URI 파라미터를 사용합니다.

Request Body

해당 요청에는 본문이 없습니다.

Response Syntax

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 형식으로 반환됩니다.

Errors

예시

10개 파일 시스템 목록을 검색합니다.

다음 예제에서는 file-systems 엔드포인트(elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems)에 GET 요청을 보냅니다. 요청은 파일 시스템 설명 수를 10개로 제한하는 MaxItems 쿼리 파라미터를 지정합니다.

샘플 요청

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

참고

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.