s3

S3의 HTTP 응답 헤더 설정

S3에서 특정 쿼리 문자열 파라미터를 통해 HTTP 헤더에 영향을 미치는 경우가 있다. 이러한 쿼리 문자열 파라미터는 요청 시 지정되며, 응답의 HTTP 헤더에 반영된다. 대표적인 예로 response-content-disposition을 포함한 몇 가지 파라미터가 있다. 이들 파라미터를 통해 S3 객체를 요청할 때 응답의 HTTP 헤더를 제어할 수 있다. 주요 파라미터와 그 역할은 다음과 같다:

1. response-content-type:

   • 이 파라미터를 사용하여 응답의 Content-Type 헤더를 지정할 수 있다.
   • 예: https://bucket-name.s3.amazonaws.com/object-key?response-content-type=application/pdf
   • 위의 URL을 통해 요청하면 응답의 Content-Type 헤더는 application/pdf로 설정된다.

2. response-content-language:

   • 이 파라미터를 사용하여 응답의 Content-Language 헤더를 지정할 수 있다.
   • 예: https://bucket-name.s3.amazonaws.com/object-key?response-content-language=en-US
   • 위의 URL을 통해 요청하면 응답의 Content-Language 헤더는 en-US로 설정된다.

3. response-expires:

   • 이 파라미터를 사용하여 응답의 Expires 헤더를 지정할 수 있다.
   • 예: https://bucket-name.s3.amazonaws.com/object-key?response-expires=Wed%2C%2021%20Oct%202020%2007%3A28%3A00%20GMT
   • 위의 URL을 통해 요청하면 응답의 Expires 헤더는 Wed, 21 Oct 2020 07:28:00 GMT로 설정된다.

4. response-cache-control:

   • 이 파라미터를 사용하여 응답의 Cache-Control 헤더를 지정할 수 있다.
   • 예: https://bucket-name.s3.amazonaws.com/object-key?response-cache-control=no-cache
   • 위의 URL을 통해 요청하면 응답의 Cache-Control 헤더는 no-cache로 설정된다.

5. response-content-disposition:

   • 이 파라미터를 사용하여 응답의 Content-Disposition 헤더를 지정할 수 있다. 이는 브라우저에서 파일을 다운로드할 때 사용자가 볼 수 있는 파일 이름을 지정하는 데 유용하다.
   • 예: https://bucket-name.s3.amazonaws.com/object-key?response-content-disposition=attachment%3B%20filename%3D%22example.pdf%22
   • 위의 URL을 통해 요청하면 응답의 Content-Disposition 헤더는 attachment; filename=“example.pdf”로 설정된다.

6. response-content-encoding:

   • 이 파라미터를 사용하여 응답의 Content-Encoding 헤더를 지정할 수 있다.
   • 예: https://bucket-name.s3.amazonaws.com/object-key?response-content-encoding=gzip
   • 위의 URL을 통해 요청하면 응답의 Content-Encoding 헤더는 gzip으로 설정된다.