메뉴
Amazon Simple Storage Service
개발자 안내서 (API Version 2006-03-01)

REST API를 사용하여 요청

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

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

예 가상 호스팅 방식 요청

다음은 examplebucket 버킷에서 puppy.jpg 파일을 삭제하기 위한 가상 호스팅 방식의 요청에 대한 예제입니다.

Copy
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

예 경로 방식 요청

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

Copy
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는 모든 리전에서 버킷 액세스에 대해 가상 호스팅 방식과 경로 방식 액세스를 지원합니다. 하지만 경로 방식 구문을 사용할 경우 버킷에 액세스할 때 리전별 엔드포인트를 사용해야 합니다. 예를 들어 EU에 mybucket이라는 버킷이 상주하고 경로 방식 구문을 사용하려는 경우 객체 이름이 EU(아일랜드)puppy.jpg이면 올바른 URI는 http://s3-eu-west-1.amazonaws.com/mybucket/puppy.jpg입니다.

다음 중 하나를 사용하는 경로 방식 구문으로 미국 동부(버지니아 북부) 리전 외부의 버킷에 액세스하려고 할 경우 리소스에 대한 올바른 URI를 나타내는 메시지, HTTP 응답 코드 307 임시 리디렉션이 수신됩니다.

  • http://s3.amazonaws.com

  • 버킷이 상주하는 리전이 아닌 다른 리전의 엔드포인트. 예를 들어 미국 서부(캘리포니아 북부 지역)지역에서 생성된 http://s3-eu-west-1.amazonaws.com을 사용하는 경우.

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

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

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

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

Copy
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

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

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

Copy
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 듀얼 스택 엔드포인트 사용을 참조하십시오.