동향 및 공지

릴리스 노트

제품 공지

제품 소개

제품 개요

기능 개요

적용 시나리오

제품 장점

기본 개념

리전 및 액세스 도메인

규격 및 제한

제품 요금

과금 개요

과금 방식

과금 항목

프리 티어

과금 예시

청구서 보기 및 다운로드

연체 안내

FAQ

빠른 시작

콘솔 시작하기

COSBrowser 시작하기

사용자 가이드

요청 생성

버킷

객체

데이터 관리

일괄 프로세스

글로벌 가속

모니터링 및 알람

운영 센터

데이터 처리

스마트 툴 박스 사용 가이드

데이터 워크플로

애플리케이션 통합

툴 가이드

툴 개요

환경 설치 및 설정

COSBrowser 툴

COSCLI 툴

COSCMD 툴

COS Migration 툴

FTP Server 툴

Hadoop 툴

COSDistCp 툴

HDFS TO COS 툴

온라인 도구 (Onrain Dogu)

자가 진단 도구

실습 튜토리얼

개요

액세스 제어 및 권한 관리

성능 최적화

AWS S3 SDK를 사용하여 COS에 액세스하기

데이터 재해 복구 백업

도메인 관리 사례

이미지 처리 사례

COS 오디오/비디오 플레이어 사례

데이터 다이렉트 업로드

데이터 보안

데이터 검증

빅 데이터 사례

COS 비용 최적화 솔루션

3rd party 애플리케이션에서 COS 사용

마이그레이션 가이드

로컬 데이터 COS로 마이그레이션

타사 클라우드 스토리지 데이터를 COS로 마이그레이션

URL이 소스 주소인 데이터를 COS로 마이그레이션

COS 간 데이터 마이그레이션

Hadoop 파일 시스템과 COS 간 데이터 마이그레이션

데이터 레이크 스토리지

클라우드 네이티브 데이터 레이크

메타데이터 가속

데이터 레이크 가속기 GooseFS

데이터 처리

데이터 처리 개요

이미지 처리

미디어 처리

콘텐츠 조정

파일 처리

문서 미리보기

장애 처리

RequestId 가져오기

공용 네트워크로 COS에 파일 업로드 시 속도가 느린 문제

COS 액세스 시 403 에러 코드 반환

리소스 액세스 오류

POST Object 자주 발생하는 오류

보안 및 컴플라이언스

데이터 재해 복구

데이터 보안

액세스 관리

자주 묻는 질문

사용자 정의 Headers

PDF

포커스 모드

폰트 크기

마지막 업데이트 시간: 2025-11-18 16:52:54

소개
객체의 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 
사용자 지정 헤더를 사용하는 경우 페이지의 응답 형식을 변경할 수 있음을 알 수 있습니다.

도움말 및 지원

문제 해결에 도움이 되었나요?

더 자세한 내용은 문의하기 또는 티겟 제출 을 통해 문의할 수 있습니다.

피드백

tencent cloud

Cloud Object Storage

사용자 정의 Headers

소개

작업 단계

License 요청 예시

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

요청

응답

객체의 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)만 지원됩니다. 영어 문자의 대문자는 소문자로 변환되며, 밑줄(_)을 포함하는 다른 부호는 지원되지 않습니다.

매개변수	값
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