Amazon EFS - Amazon Elastic File System
API 엔드포인트API 버전관련 주제EFS EFS의 쿼리 API 요청 속도 사용

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

Amazon EFS

Amazon EFS API는 HTTP (RFC 2616) 를 기반으로 하는 네트워크 프로토콜입니다. 각 API 호출에 대해 파일 시스템을 관리하려는AWS 리전 지역별 Amazon EFS API 엔드포인트에 HTTP 요청을 보냅니다. API에서는 HTTP 요청/응답 본문에 대해 JSON(RFC 4627) 문서를 사용합니다.

아마존 EFS API는 RPC 모델입니다. 이 모델에는 고정된 작업 집합이 있으며 각 작업의 구문은 사전 상호 작용 없이 클라이언트에 알려집니다. 다음 섹션에서 추상 RPC 표기법을 사용하는 각 작업에 대한 설명을 찾을 수 있습니다. 각 작업에는 와이어에 표시되지 않는 작업 이름이 있습니다. 각 작업에 대해 주제는 HTTP 요청 요소에 대한 매핑을 지정합니다.

특정 요청이 매핑되는 특정 Amazon EFS 작업은 요청 메서드 (GET, PUT, POST 또는 DELETE) 와 요청-URI와 일치하는 다양한 패턴의 조합에 따라 결정됩니다. 작업이 PUT 또는 POST인 경우 EFS 요청 본문의 요청 URI 경로 세그먼트, 쿼리 파라미터 및 JSON 객체에서 호출 인수를 추출합니다.

참고

CreateFileSystem등과 같은 작업 이름은 전선에 표시되지 않지만 이러한 이름은AWS Identity and Access Management (IAM) 정책에서 의미가 있습니다. 자세한 정보는 Amazon Elastic File System용 자격 증명 및 액세스 관리을 참조하세요.

작업 이름은 명령줄 도구 및AWS SDK API 요소의 명령 이름을 지정하는 데도 사용됩니다. 예를 들어CreateFileSystem 작업에create-file-system 매핑되는AWS CLI 명령이라는 명령이 있습니다.

작업 이름은 Amazon EFS API 호출AWS CloudTrail 로그에도 표시됩니다.

API 엔드포인트

API 엔드포인트는 API 호출의 HTTP URI에서 호스트로 사용되는 DNS 이름입니다. 이러한 API 엔드포인트는 다음과 같은 형태로AWS 리전 고유하며 다음과 같은 형식을 취합니다.

elasticfilesystem.aws-region.amazonaws.com

예를 들어 미국 서부 (오레곤) 리전의 Amazon EFS

elasticfilesystem.us-west-2.amazonaws.com

EFSAWS 리전 EFS에서 지원하는 목록 (파일 시스템을 생성하고 관리할 수 있는 위치) 은 의 Amazon Elastic File System System을 참조하십시오 AWS 일반 참조.

지역별 API 엔드포인트는 API 호출 시 액세스할 수 있는 Amazon EFS 리소스의 범위를 정의합니다. 예를 들어, 이전 엔드포인트를 사용하여DescribeFileSystems 작업을 호출하면 계정에 생성된 미국 서부 (오레곤) 지역의 파일 시스템 목록이 표시됩니다.

API 버전

호출에 사용 중인 API 버전은 요청 URI의 첫 번째 경로 세그먼트로 식별할 수 있으며 형식은 ISO 8601 날짜입니다. 예제는 CreateFileSystem 단원을 참조하세요.

이 설명서에서는 API 버전 2015-02-01에 대해 설명합니다.

다음 섹션에서는 API 작업, 요청 인증을 위한 서명을 생성하는 방법, IAM 정책을 사용하여 이러한 API 작업에 권한을 부여하는 방법에 대해 설명합니다.

EFS EFS의 쿼리 API 요청 속도 사용

Amazon EFS API 요청은 서비스 성능을 높이기 위해 각 요청에AWS 계정 대해 리전별로 조절됩니다. 애플리케이션, Amazon EFS 콘솔 또는 Amazon EFS 콘솔에서 시작된 모든 Amazon EFS API 호출은 허용되는 최대 API 요청 속도를 초과해서는 안 됩니다.AWS CLI 최대 API 요청 속도는 서로 다를 수 있습니다AWS 리전. 이루어진 API 요청은 기본 요청에 어트리뷰션됩니다AWS 계정.

API 요청이 해당 카테고리의 API 요청 비율을 초과하는 경우 요청은ThrottlingException 오류 코드를 반환합니다. 이 오류를 방지하려면 애플리케이션이 높은 속도로 API 요청을 재시도하지 않도록 해야 합니다. 이렇게 하려면 폴링 시 care를 사용하고 지수 백오프 재시도를 사용하면 됩니다.

폴링

애플리케이션에서 업데이트 상태를 확인하기 위해 API 작업을 반복해서 호출해야 할 수 있습니다. 폴링을 시작하기 전에 요청이 완료될 수 있을 때까지 기다려 주세요. 폴링을 시작할 때는 연속적인 요청 사이에 적절한 휴면 간격을 두십시오. 최상의 결과를 얻으려면 수면 간격을 늘리세요.

재시도 또는 일괄 처리

API 요청이 실패하면 애플리케이션에서 다시 시도하거나 여러 리소스 (예: 모든 Amazon EFS 파일 시스템) 를 처리해야 할 수 있습니다. API 요청 비율을 낮추려면 연속적인 요청 사이에 적절한 휴면 간격을 두십시오. 최상의 결과를 얻으려면 수면 간격을 늘리거나 가변적으로 사용합니다.

수면 수면

API 요청을 폴링하거나 재시도해야 하는 경우 지수 백오프 알고리즘을 사용하여 API 호출 간의 휴면 간격을 계산하는 것이 좋습니다. 지수 백오프의 기본 아이디어는 오류 응답이 연이어 나올 때마다 재시도 간 대기 시간을 점진적으로 늘린다는 것입니다. 이 알고리즘에 대한 자세한 내용과 구현 예는 의 오류 재시도 및 지수 백오프를 참조하십시오 Amazon Web Services 일반 참조.AWS