Skip to main content
MPS 태스크의 입력/출력 파일은 Tencent Cloud COS에 저장됩니다. 로컬 파일 업로드, 결과 파일 다운로드, Bucket 내 객체 목록 조회 방법을 설명합니다.

요청 방법

COS API는 동기 API로 즉시 결과를 반환합니다. MPS 태스크와 달리 TaskId 발급/폴링 과정이 없습니다.

요청 파라미터

업로드 (PUT Object)

다운로드 (GET Object)

목록 조회 (GET Bucket)

응답 파라미터

호출 예시

응답 예시

주의사항

업로드 시 Key를 지정하지 않으면 input/<로컬 파일명> 규칙을 사용하고, 다운로드 시 로컬 경로를 지정하지 않으면 ./<객체 파일명>으로 저장합니다. 경로 규칙을 명시하지 않아도 되지만, MPS 입력 규약(input/ 접두사)은 유지하세요.
Bucket과 Region은 환경 변수 TENCENTCLOUD_COS_BUCKET / TENCENTCLOUD_COS_REGION으로 주입하는 것을 권장합니다. MPS API의 InputInfo/OutputStorage에 전달하는 Bucket/Region/Object 값과 동일한 값을 사용해야 태스크가 파일을 찾을 수 있습니다.
목록 조회의 MaxKeys는 1000이 상한입니다. 파일명 검색(부분 일치/정확 일치)은 응답의 Contents를 클라이언트 측에서 필터링합니다.
Last modified on August 16, 2026