기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
DescribeMountTargets
파일 시스템에 대한 모든 현재 탑재 대상 또는 특정 탑재 대상의 설명을 반환합니다. 현재 탑재 대상을 모두 요청하는 경우 응답에서 반환되는 탑재 대상의 순서는 지정되지 않습니다.
이 작업을 수행하려면 FileSystemId에서 지정한 파일 시스템 ID 또는 MountTargetId에서 지정한 탑재 대상의 파일 시스템에 대한 elasticfilesystem:DescribeMountTargets 작업 권한이 필요합니다.
Request Syntax
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입니다.
Pattern:
^fsmt-[0-9a-f]{8,40}$
요청 본문
해당 요청에는 본문이 없습니다.
Response Syntax
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.
패턴:
.+
Errors
- 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를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.
