tencent cloud

PrevNext

피드백

키워드를 검색하세요

Recent Pages

문서
Cloud Object Storage
    문서
    Download PDF

    사용자 정의 Headers

    마지막 업데이트 시간:2024-06-24 16:12:04
    PDF 다운로드

      소개

      객체의 HTTP 헤더(메타데이터 헤더)는 서버가 HTTP 프로토콜로 HTML 자료를 브라우저에 전송하기 전 보내는 문자열입니다. HTTP 헤더(메타데이터 헤더) 수정을 통해서 페이지의 응답 형식이나 설정 정보를 전달할 수 있습니다. 캐시 시간 수정이 그 예입니다. 객체의 HTTP 헤더 수정으로 객체 자체를 수정할 수 없습니다.
      설명：
      아카이브(ARCHIVE), 딥 아카이브(DEEP ARCHIVE) 유형의 객체는 업로드 시 사용자 정의 Headers 설정만 지원되고 업로드된 객체에 대한 사용자 정의 Headers 설정은 지원되지 않습니다.

      작업 단계

      1. COS 콘솔에 로그인합니다.
      2. 왼쪽 사이드바에서 버킷 리스트를 클릭합니다.
      3. 객체가 속한 버킷을 찾아 해당 버킷 이름을 클릭합니다.
      4. 왼쪽 사이드바에서 파일 리스트를 클릭합니다.
      5. 사용자 지정 헤더가 필요한 객체를 찾고, 그 오른쪽에 있는 작업 열에서 추가 > 사용자 지정 헤더를 클릭하여 설정합니다. 다중 객체에 대한 사용자 지정 헤더가 필요하시면 다수의 객체를 선택하고, 위에 있는 추가 작업 > 사용자 지정 헤더를 클릭하여 설정합니다.
      6. 팝업 창에서 설정할 메타데이터 헤더 매개변수 유형을 선택하고 해당 메타데이터 값을 입력한 후 확인을 클릭합니다. COS는 설정을 위해 다음 6개의 객체 HTTP 헤더 식별자를 제공합니다. 헤더 설정 설명은 다음과 같습니다.
      HTTP 헤더
      설명
      예시
      Content-Type
      파일의 MIME 정보
      image/jpeg
      Cache-Control
      파일의 캐시 메커니즘
      no-cache: 캐시를 직접 사용하는 것이 아니라 먼저 서버에서 Object 업데이트되었는지 여부를 확인해야 합니다. Object가 업데이트된 경우 캐시가 만료되었음을 의미하므로 서버에서 Object를 다시 다운로드해야 합니다. Object가 업데이트되지 않은 경우 캐시가 만료되지 않았음을 의미하므로 로컬 캐시를 사용합니다.
      max-age=200: 캐시 내용의 상대적 만료시간, 단위는 초.
      Content-Disposition
      MIME 프로토콜의 확장
      inline: 파일 내용을 직접 미리보기.
      attachment: 원 파일 이름의 형식으로 브라우저 지정 경로로 다운로드.
      attachment; filename="FileName": 사용자 지정 파일 이름의 형식으로 브라우저 지정 경로로 다운로드. FileName은 다운로드된 파일 이름의 사용자 지정에 사용되며, 예를 들면 example.jpg입니다. 첨부 파일 이름이 중국어인 경우 URL 코딩이 필요합니다. 예시 attachment; filename* = UTF-8' '%E4%B8%AD%E6%96%87.txt
      Content-Encoding
      파일의 코딩 포맷
      gzip
      주의: Header의 Content-Encoding을 gzip으로 변경하였지만 파일 자체가 사전에 gzip으로 압축되지 않았기 때문에 디코딩 에러가 발생할 수 있습니다.
      Expires
      캐시의 만료일 제어
      Wed, 21 Oct 2015 07:28:00 GMT
      x-cos-meta-\\[사용자 지정 접미사\\]
      사용자 지정 내용
      x-cos-meta-via: homepage
      주의: 헤더 이름은 마이너스 부호(-), 숫자, 영어(a～z)만 지원됩니다. 영어 문자의 대문자는 소문자로 변환되며, 밑줄(_)을 포함하는 다른 부호는 지원되지 않습니다.

      License 요청 예시

      APPID 1250000000으로 examplebucket-1250000000이라는 이름의 버킷을 생성하고 객체 exampleobject.txt를 버킷 루트 디렉터리에 업로드하였다고 가정해봅니다.

      객체의 HTTP 헤더 사용자 미지정

      객체의 HTTP 헤더가 사용자 정의되지 않은 경우 브라우저나 클라이언트에 다운로드할 때 얻는 객체 헤더 예시는 아래와 같습니다.

      요청

      GET /exampleobject.txt HTTP/1.1
      Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
      Date: Fri, 10 Apr 2020 09:35:16 GMT
      Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1586511316;1586518516&q-key-time=1586511316;1586518516&q-header-list=date;host&q-url-param-list=&q-signature=1bd1898e241fb978df336dc68aaef4c0acae****
      Connection: close

      응답

      HTTP/1.1 200 OK
      Content-Type: text/plain
      Access-Control-Allow-Origin: *
      Last-Modified: Fri, 10 Apr 2020 09:35:05 GMT

      객체의 HTTP 헤더 사용자 지정

      작업 절차，를 참고하여 아래 사용자 지정 헤더 구성을 추가하십시오.
      매개변수
      값
      Content-Type
      image/jpeg
      Cache-Control
      no-cache
      Content-Disposition
      attachment; filename* = UTF-8' '%E4%B8%AD%E6%96%87.jpeg
      x-cos-meta-md5
      1234
      요청을 다시 보내는 경우 브라우저나 클라이언트에서 얻을 수 있는 객체 헤더 예시는 아래와 같습니다.

      요청

      GET /exampleobject.txt HTTP/1.1
      Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
      Date: Fri, 10 Apr 2020 09:35:16 GMT
      Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1586511316;1586518516&q-key-time=1586511316;1586518516&q-header-list=date;host&q-url-param-list=&q-signature=1bd1898e241fb978df336dc68aaef4c0acae****
      Connection: close

      응답

      HTTP/1.1 200 OK
      Cache-Control: no-cache
      Content-Type: image/jpeg
      Content-Disposition: attachment; filename* = UTF-8' '%E4%B8%AD%E6%96%87.jpeg
      x-cos-meta-md5: 1234
      Access-Control-Allow-Origin: *
      Last-Modified: Fri, 10 Apr 2020 09:35:05 GMT
      사용자 지정 헤더를 사용하는 경우 페이지의 응답 형식을 변경할 수 있음을 알 수 있습니다.
      문의하기

      고객의 업무에 전용 서비스를 제공해드립니다.

      문의하기
      기술 지원

      더 많은 도움이 필요하시면, 티켓을 통해 연락 바랍니다. 티켓 서비스는 연중무휴 24시간 제공됩니다.

      티켓 제출
      연중무휴 24시간 전화 지원
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      개인정보 처리방침서비스 약관쿠키 정책