기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

DescribeFileSystems

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

모든 파일 시스템 설명을 검색할 때 선택적으로 MaxItems 파라미터를 지정하여 응답의 설명 수를 제한할 수 있습니다. 이 숫자는 자동으로 100으로 설정됩니다. 파일 시스템 설명이 더 남아 있는 경우 Amazon은 응답으로 불투명한 NextMarker 토큰인 a를 EFS 반환합니다. 이 경우 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"
}

Response Elements

작업이 성공하면 서비스는 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 SDKs 다음을 참조하십시오. API