기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# DescribeAccessPoints
`AccessPointId`가 제공된 경우 특정 Amazon EFS 액세스 포인트에 대한 설명을 반환합니다. EFS `FileSystemId`를 제공하면 해당 파일 시스템의 모든 액세스 포인트에 대한 설명이 반환됩니다. 요청에서 `AccessPointId` 또는 `FileSystemId`를 제공할 수 있지만 둘 다 제공할 수는 없습니다.
이 작업에는 `elasticfilesystem:DescribeAccessPoints` 액션에 대한 권한이 필요합니다.
## Request Syntax
```
GET /2015-02-01/access-points?AccessPointId=AccessPointId&FileSystemId=FileSystemId&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [AccessPointId](#API_DescribeAccessPoints_RequestSyntax) **
(선택 사항)응답에서 설명할 EFS 액세스 포인트를 지정합니다. `FileSystemId`와는 상호 배타적입니다.
길이 제약: 최대 길이는 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_DescribeAccessPoints_RequestSyntax) **
(선택 사항)`FileSystemId`를 제공하는 경우 EFS는 해당 파일 시스템에 대한 모든 액세스 포인트를 반환하며, `AccessPointId`와는 상호 배타적입니다.
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`
** [MaxResults](#API_DescribeAccessPoints_RequestSyntax) **
(선택 사항)파일 시스템의 모든 액세스 포인트를 검색할 때, 선택적으로 `MaxItems` 파라미터를 지정하여 응답으로 반환되는 객체 수를 제한할 수 있습니다. 기본값은 100입니다.
유효 범위: 최소값 1.
** [NextToken](#API_DescribeAccessPoints_RequestSyntax) **
응답에 페이지가 매겨진 경우 `NextToken`이 나타납니다. 후속 요청에서 `NextMarker`를 사용하여 액세스 포인트 설명의 다음 페이지를 가져올 수 있습니다.
길이 제약: 최소 길이 1. 최대 길이 128.
패턴: `.+`
## 요청 본문
해당 요청에는 본문이 없습니다.
## Response Syntax
```
HTTP/1.1 200
Content-type: application/json
{
"AccessPoints": [
{
"AccessPointArn": "string",
"AccessPointId": "string",
"ClientToken": "string",
"FileSystemId": "string",
"LifeCycleState": "string",
"Name": "string",
"OwnerId": "string",
"PosixUser": {
"Gid": number,
"SecondaryGids": [ number ],
"Uid": number
},
"RootDirectory": {
"CreationInfo": {
"OwnerGid": number,
"OwnerUid": number,
"Permissions": "string"
},
"Path": "string"
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
],
"NextToken": "string"
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [AccessPoints](#API_DescribeAccessPoints_ResponseSyntax) **
액세스 포인트 설명 배열입니다.
타입: [AccessPointDescription](API_AccessPointDescription.md)객체 배열
** [NextToken](#API_DescribeAccessPoints_ResponseSyntax) **
응답에 반환된 것보다 많은 액세스 포인트가 있는 경우 제시하세요. 후속 요청에서 NextMarker를 사용하여 추가 설명을 가져올 수 있습니다.
유형: 문자열
길이 제약: 최소 길이는 1. 최대 길이 128.
패턴: `.+`
## 오류
** AccessPointNotFound **
지정된 `AccessPointId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** FileSystemNotFound **
지정된 `FileSystemId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeAccessPoints)