기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Amazon EFS API
아마존 EFS API는 HTTP (RFC 2616)
아마존 EFS API는 RPC 모델입니다. 이 모델은 고정된 작업 세트가 있고, 이전 상호 작용이 없어도 클라이언트가 각 작업의 구문을 알고 있습니다. 다음 섹션에서 추상 RPC 표기법을 사용한 각 API 작업에 대한 설명을 볼 수 있습니다. 각 작업에는 네트워크 상에 나타나지 않는 작업 이름이 있습니다. 각 작업에 대해 주제는 HTTP 요청 요소에 대한 매핑을 지정합니다.
지정된 요청이 매핑되는 특정 Amazon EFS 작업은 요청 메서드(GET, PUT, POST 또는 DELETE)와 요청-URI가 일치되는 다양한 패턴의 조합에 따라 결정됩니다. PUT 또는 POST 작업인 경우 Amazon EFS에서는 요청-URI 경로 세그먼트, 쿼리 파라미터, 요청 본문의 JSON 객체에서 직접 호출 인수를 추출합니다.
참고
와 같은 작업 이름은 유선에 CreateFileSystem표시되지 않지만 이러한 이름은 AWS Identity and Access Management (IAM) 정책에서 의미가 있습니다. 자세한 내용은 Amazon EFS의 자격 증명 및 액세스 관리 단원을 참조하십시오.
작업 이름은 명령줄 도구 및 AWS SDK API 요소에서 명령의 이름을 지정하는 데에도 사용됩니다. 예를 들어 CreateFileSystem 작업에 매핑create-file-system되는 라는 AWS CLI 명령이 있습니다.
작업 이름은 Amazon EFS API 호출에 대한 AWS CloudTrail 로그에도 표시됩니다.
API 엔드포인트
엔드포인트는 AWS 웹 서비스의 진입점 역할을 하는 URL입니다. Amazon EFS는 다음 엔드포인트 유형을 지원합니다.
-
IPv4 엔드포인트
-
듀얼 스택(IPv4 및 IPv6 모두) 엔드포인트
요청 시에, 사용할 엔드포인트를 지정할 수 있습니다. 엔드포인트를 지정하지 않으면 기본적으로 IPv4 엔드포인트가 사용됩니다. 다른 엔드포인트 유형을 사용하려면 요청에서 이를 지정해야 합니다. 이렇게 하는 방법의 예제는 엔드포인트 지정 섹션을 참조하세요. 사용 가능한 엔드포인트 표는 Amazon EFS 엔드포인트 및 할당량을 참조하세요.
IPv4 엔드포인트
IPv4 엔드포인트는 IPv4 트래픽만 지원합니다. IPv4 엔드포인트는 모든 리전에 사용할 수 있습니다. IPv4 엔드포인트의 형식은 리전에 따라 다릅니다.
-
AWS 상용 리전의 IPv4 엔드포인트의 경우 형식은 입니다
elasticfilesystem..region.amazonaws.com예를 들어 엔드포인트
elasticfilesystem.us-west-2.amazonaws.com로를 지정하면 요청을 미국 서부(오레곤) 리전(us-west-2) 엔드포인트로 보냅니다.
-
중국 리전의 IPv4 엔드포인트의 경우 형식은 입니다
elasticfilesystem..region.amazonaws.com.rproxy.govskope.ca.cn예를 들어 중국(베이징) 리전의 Amazon EFS API 엔드포인트는 입니다
elasticfilesystem---cn-north-1.amazonaws.com.rproxy.govskope.ca.cn.
이중 스택(IPv4 및 IPv6) 엔드포인트
이중 스택 엔드포인트는 IPv4 트래픽과 IPv6 트래픽을 모두 지원합니다. 이중 스택 엔드포인트에 요청하는 경우, 엔드포인트 URL이 네트워크 및 클라이언트에서 사용하는 프로토콜에 따라 IPv6 또는 IPv4 주소로 확인됩니다. 듀얼 스택 엔드포인트의 형식은 리전에 따라 다릅니다.
-
AWS 상용 리전의 듀얼 스택 엔드포인트의 경우 형식은 입니다
efs..aws-region.api.aws예를 들어 미국 서부(오레곤) 리전(us-west-2)의 듀얼 스택 엔드포인트는 입니다
efs.eu-west-2.api.aws. -
중국 리전의 듀얼 스택 엔드포인트의 경우 형식은 입니다
efs..region.api.amazonwebservices.com.rproxy.govskope.ca.cn예를 들어 중국(베이징) 리전의 듀얼 스택 엔드포인트는 입니다
efs---cn-north-1---api.amazonwebservices.com.rproxy.govskope.ca.cn.
엔드포인트 지정
다음 예제에서는 Amazon EFS용를 사용하여 미국 서부(캘리포니아 북부) 리전(us-west-1)의 엔드포인트 AWS CLI 를 지정하는 방법을 보여줍니다.
IPv4
aws efs get-rest-apis --region us-west-1 --endpoint-url https://elasticfilesystem.us-west-1.amazonaws.com
이중 스택
aws efs get-rest-apis --region us-west-1 --endpoint-url https://efs.us-west-1.api.aws
API 버전
호출에 사용 중인 API 버전은 요청 URI의 첫 번째 경로 세그먼트로 식별할 수 있으며 형식은 ISO 8601 날짜입니다. 예제는 CreateFileSystem을 참조하세요.
이 문서에서는 API 버전 2015-02-01에 대해 설명합니다.
관련 주제
다음 섹션에서는 API 작업에 대한 설명, 요청 인증을 위한 서명을 생성하는 방법, IAM 정책을 사용하여 이러한 API 작업에 대한 권한을 부여하는 방법을 제공합니다.
Amazon EFS의 쿼리 API 요청 속도 활용하기
Amazon EFS API 요청은 서비스 성능에 도움이 되도록 리전별로 각 AWS 계정 에 대해 제한됩니다. 애플리케이션, AWS CLI또는 Amazon EFS 콘솔에서 시작되었는지 여부에 관계없이 모든 Amazon EFS API 직접 호출은 허용되는 최대 API 요청 속도를 초과해서는 안 됩니다. 최대 API 요청 속도는 다를 수 있습니다 AWS 리전. API 요청은 기본에 귀속됩니다 AWS 계정.
API 요청이 해당 카테고리의 API 요청 비율을 초과하는 경우 요청은 ThrottlingException 오류 코드를 반환합니다. 이 오류를 방지하려면 애플리케이션이 API 요청을 빠른 속도로 재시도하지 않도록 해야 합니다. 폴링 시 주의를 기울이고 지수 백오프 재시도를 사용하면 이 작업을 수행할 수 있습니다.
폴링
애플리케이션이 API 작업을 반복해서 직접 호출하여 업데이트 상태를 확인해야 할 수 있습니다. 폴링을 시작하기 전에 요청이 완료될 수 있도록 시간을 주세요. 폴링을 시작할 때는 연속된 요청 사이에 적절한 휴면 간격을 두세요. 최상의 결과를 얻으려면 휴면 간격을 늘리세요.
재시도 또는 일괄 처리
애플리케이션이 API 요청을 실패하면 다시 시도하거나 여러 리소스(예: 모든 Amazon EFS 파일 시스템)를 처리해야 할 수 있습니다. API 요청 속도를 낮추려면 연속된 요청 사이에 적절한 휴면 간격을 사용하세요. 최상의 결과를 얻으려면 휴면 간격을 늘리거나 가변적으로 사용하세요.
휴면 간격 계산
API 요청을 폴링하거나 재시도해야 하는 경우 지수 백오프 알고리즘을 사용하여 API 직접 호출 간 휴면 간격을 계산하는 것이 좋습니다. 지수 백오프의 기본 개념은 오류 응답이 연이어 나올 때마다 재시도 간 대기 시간을 점진적으로 늘리는 것입니다. 자세한 내용과이 알고리즘의 구현 예제는의 재시도 동작을 참조하세요Amazon Web Services 일반 참조.
