REST API를 사용하여 요청 - Amazon Simple Storage Service

새로운 Amazon S3 사용 설명서에 오신 것을 환영합니다! Amazon S3 사용 설명서에는 사용 중지된 세 가지 설명서(Amazon S3 개발자 안내서, Amazon S3 콘솔 사용 설명서, Amazon S3 시작 안내서)에 나온 정보와 지침이 통합되어 있습니다.

REST API를 사용하여 요청

이 단원에는 REST API를 사용하여 Amazon S3 엔드포인트에 요청하는 방법에 대한 정보가 포함되어 있습니다. Amazon S3 엔드포인트 목록은 AWS 일반 참조리전 및 엔드포인트를 참조하세요.

REST API 요청에 대한 S3 호스트 이름 구성

Amazon S3 엔드포인트는 아래에 표시된 구조를 따릅니다.

s3.Region.amazonaws.com

Amazon S3 액세스 포인트 엔드포인트 및 듀얼 스택 엔드포인트도 다음의 표준 구조를 따릅니다.

  • Amazon S3 액세스 포인트s3-accesspoint.Region.amazonaws.com

  • 듀얼 스택s3.dualstack.Region.amazonaws.com

Amazon S3 리전 및 엔드포인트의 전체 목록은 AWS 일반 참조에서 Amazon S3 엔드포인트 및 할당량을 참조하세요.

가상 호스팅 방식 및 경로 방식 요청

REST API를 사용하여 요청할 때 Amazon S3 엔드포인트에 대해 가상 호스팅 방식 또는 경로 방식 URI를 사용할 수 있습니다. 자세한 내용은 버킷의 가상 호스팅 단원을 참조하세요.

예 가상 호스팅 방식 요청

다음은 미국 서부(오레곤) 리전의 examplebucket 버킷에서 puppy.jpg 파일을 삭제하기 위한 가상 호스팅 방식 요청의 예제입니다. 가상 호스팅 방식 요청에 대한 자세한 내용은 가상 호스팅 방식 요청을 참조하십시오.

DELETE /puppy.jpg HTTP/1.1 Host: examplebucket.s3.us-west-2.amazonaws.com Date: Mon, 11 Apr 2016 12:00:00 GMT x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT Authorization: authorization string

예 경로 방식 요청

다음은 경로 방식의 메서드로 동일한 요청을 하는 예제입니다.

DELETE /examplebucket/puppy.jpg HTTP/1.1 Host: s3.us-west-2.amazonaws.com Date: Mon, 11 Apr 2016 12:00:00 GMT x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT Authorization: authorization string

현재 Amazon S3에서는 모든 리전에서 가상 호스팅 방식의 액세스와 경로 방식의 액세스를 지원하지만 변경될 예정입니다(다음 중요 참조).

경로 방식 요청에 대한 자세한 내용은 경로 방식 요청 단원을 참조하세요.

중요

업데이트(2020년 9월 23일) - 고객이 가상 호스팅 방식의 URL로 전환하는 데 필요한 시간을 확보할 수 있도록 경로 방식 URL의 사용 중지를 연기하기로 결정했습니다. 자세한 내용은 AWS 뉴스 블로그에서 Amazon S3 경로 사용 중지 계획 - 나머지 이야기를 참조하세요.

REST API를 사용하여 듀얼 스택 엔드포인트에 요청

REST API를 사용할 때 가상 호스팅 방식 또는 경로 방식 엔드포인트 이름(URI)을 사용하여 듀얼 스택 엔드포인트에 직접 액세스할 수 있습니다. 모든 Amazon S3 듀얼 스택 엔드포인트 이름에는 리전이 포함되어 있습니다. 표준 IPv4-only 엔드포인트와 달리, 가상 호스팅 방식 및 경로 방식 엔드포인트는 모두 리전별 엔드포인트 이름을 사용합니다.

예 가상 호스팅 방식 듀얼 스택 엔드포인트 요청

미국 서부(오레곤) 리전의 examplebucket 버킷에서 puppy.jpg 객체를 검색하는 다음 예제와 같이 REST 요청에 가상 호스팅 방식 엔드포인트를 사용할 수 있습니다.

GET /puppy.jpg HTTP/1.1 Host: examplebucket.s3.dualstack.us-west-2.amazonaws.com Date: Mon, 11 Apr 2016 12:00:00 GMT x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT Authorization: authorization string

예 경로 방식 듀얼 스택 엔드포인트 요청

또는 다음 예제와 같이 요청에 경로 방식 엔드포인트를 사용할 수 있습니다.

GET /examplebucket/puppy.jpg HTTP/1.1 Host: s3.dualstack.us-west-2.amazonaws.com Date: Mon, 11 Apr 2016 12:00:00 GMT x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT Authorization: authorization string

듀얼 스택 엔드포인트에 대한 자세한 내용은 Amazon S3 듀얼 스택 엔드포인트 사용을 참조하십시오.

REST API를 사용하여 요청하는 방법에 대한 자세한 내용은 아래 항목을 참조하세요.