객체 간편 다운로드
마지막 업데이트 시간:2025-10-13 16:29:33
적용 시나리오
COS(Cloud Object Storage)에서 객체 다운로드 요청을 직접 시작할 수 있습니다. 다음 기능이 지원됩니다.
전체 객체 다운로드: GET 요청을 시작하여 전체 객체 데이터를 다운로드합니다.
객체의 일부 다운로드: GET 요청에서 Range 요청 헤더를 사용하여 객체의 특정 바이트 범위를 검색합니다. 여러 범위 검색은 지원되지 않습니다.
객체의 메타데이터는 객체의 콘텐츠와 함께 HTTP 응답 헤더로 반환됩니다. GET 요청은 URL 매개변수를 사용하여 응답에서 특정 메타데이터 값 덮어쓰기를 지원합니다.
예를 들어 Content-Disposition의 응답 값을 덮어쓸 수 있습니다. 수정을 지원하는 응답 헤더는 다음과 같습니다.
Content-Type
Content-Language
Expires
Cache-Control
Content - Disposition
Content-Encoding
사용 방법
COS 콘솔 사용
단일 객체 다운로드
1. COS 콘솔에 로그인합니다.
2. 왼쪽 사이드바에서 버킷 리스트를 클릭합니다.
3. 객체가 속한 버킷을 찾아 해당 버킷 이름을 클릭합니다.
4. 왼쪽 사이드바에서 파일 리스트를 클릭합니다.
5. 대상 객체를 찾고 다음 옵션을 선택하여 필요에 따라 다운로드합니다.
객체 오른쪽에 있는 작업 열에서 다운로드를 클릭합니다.
객체를 선택하고 상단의 추가 작업 > 다운로드를 클릭합니다.
객체 오른쪽의 작업 열에서 세부 정보를 클릭하여 파일 세부 정보 페이지로 들어간 다음 객체 다운로드를 클릭합니다.
임시 링크 복사를 클릭하고 링크를 브라우저에 붙여넣고 Enter 키를 누를 수도 있습니다.
설명：
객체가 저장된 버킷이 개인 읽기/쓰기인 경우 여기에 복사된 주소 끝에 서명이 자동으로 계산되어 추가됩니다. 서명을 생성하는 방법에 대한 자세한 내용은 서명 요청을 참고하십시오.
서명이 있는 임시 링크는 세부 정보를 보기 위해 클릭한 순간부터 1시간 동안 유효합니다. 새로고침을 클릭하여 서명의 유효 기간을 새로 고칠 수 있습니다.
기본적으로 다운로드한 객체가 브라우저 직접 열기를 지원하는 경우 임시 링크에 액세스하면 객체를 다운로드하는 대신 직접 미리보기 할 수 있습니다.
객체 및 폴더 일괄 다운로드
설명：
COS 콘솔에서는 개별 객체만 다운로드할 수 있습니다. 여러 객체 또는 폴더를 일괄적으로 다운로드하려면 COSBrowser 클라이언트를 설치하는 것이 좋습니다. 다음은 COSBrowser 클라이언트와 함께 콘솔에서 객체 또는 폴더를 일괄적으로 다운로드하는 방법입니다.
1. COS 콘솔에 로그인합니다.
2. 왼쪽 사이드바에서 버킷 리스트를 클릭합니다.
3. 객체가 속한 버킷을 찾아 해당 버킷 이름을 클릭합니다.
4. 왼쪽 사이드바에서 파일 리스트를 클릭합니다.
5. 여러 객체를 선택하고 상단의 더 많은 작업 > 다운로드를 클릭합니다.
6. 팝업 알림에 따라 설치하거나 COSBrowser 클라이언트를 열어 로그인합니다.
7. COSBrowser를 열고 파일 저장 위치를 선택하면 선택한 파일이 자동으로 다운로드 대기열에 들어가 다운로드가 시작됩니다. 오른쪽 상단의 전송 아이콘을 클릭하여 다운로드 진행 상황을 확인할 수 있습니다.
REST API 사용
SDK 사용
SDK에서 객체 다운로드 메소드를 직접 호출합니다. 자세한 내용은 아래의 해당 프로그래밍 언어에 대한 SDK 문서를 참고하십시오.
피드백