tencent cloud

Cloud Object Storage

문서Cloud Object Storage

API를 통한 ZIP 파일 압축 해제

Download
포커스 모드
폰트 크기
마지막 업데이트 시간: 2025-11-13 18:12:02

준비 작업

1. ZIP 파일 압축 해제 기능은 SCF(Serverless Cloud Function)를 통해 구현됩니다. 사용하기 전에 COS 콘솔ZIP 파일 압축 해제에서 ZIP 파일 압축 해제 함수를 생성해야 합니다. 생성 가이드는 ZIP 파일 압축 해제를 참고하십시오.
2. 함수 생성 후 함수 리스트 작업 열의 사용 안내에 따라 함수 매개변수 설정을 완료합니다. 구체적인 함수 매개변수 설정은 다음을 참고하십시오. 형식은 JSON 문자열입니다.
SCF 인증을 선택하는 함수의 경우, 클라우드 기능을 실행하기 위해 SCF에서 제공하는 인보크(Invoke) 인터페이스를 호출해야 합니다. 이 중 ClientContext 매개변수는 JSON 형식으로 전달합니다. 함수 매개변수 구성 예시를 참고하십시오.
인증 면제를 선택한 함수의 경우 해당 API 게이트웨이에 HTTP 요청을 통해 함수를 호출할 수 있습니다.

함수 매개변수 예시

설명：
실제 사용 시 코드의 주석을 제거해야 합니다.
{
    "bucket": "examplebucket-1250000000",    // ZIP 패키지용 원본 버킷
    "region": "ap-guangzhou",         // ZIP 패키지를 보관하는 원본 버킷의 리전
    "key": "example.zip",              //  ZIP 패키지 이름
    "targetBucket": "examplebucket-1250000000",    // 압축 해제 산출이 최종적으로 전송되는 대상 버킷
    "targetRegion": "ap-guangzhou",         // 압축 해제 산출이 최종적으로 전송되는 대상 버킷의 리전
    "targetPrefix": "target/",              // 최종적으로 전송되는 압축 해제 산출물의 접두사
}
매개변수 설명은 다음과 같습니다.
매개변수 이름
매개변수 설명
유형
필수 입력 여부
bucket
ZIP 패키지를 저장할 원본 버킷. 이름 형식은 BucketName-APPID이며, examplebucket-1250000000과 같은 형식이어야 합니다.
String
Yes
region
ZIP 패키지가 저장되어 있는 원본 버킷이 위치한 리전. 열거 값은 리전 및 액세스 도메인을 참고하십시오.
String
Yes
key
ZIP 패키지 이름(Object 이름). 버킷에서의 객체 고유 식별자입니다. 자세한 내용은 객체 개요를 참고하십시오.
String
Yes
targetBucket
압축 해제 산출이 최종적으로 전송되는 대상 버킷. 이름 형식은 BucketName-APPID이며, examplebucket-1250000000과 같은 형식이어야 합니다.
String
Yes
targetRegion
압축 해제 산출이 최종적으로 전송되는 대상 버킷의 리전. 열거 값은 리전 및 액세스 도메인을 참고하십시오.
String
Yes
targetPrefix
최종적으로 전송되는 압축 해제 산출물의 접두사. 지정된 디렉터리로 전달할 때 슬래시 /로 끝나야 합니다. 기본 값 또는 빈 문자열은 루트 경로로 전송되는 것으로 간주됩니다.
String
No

함수 응답 결과 예시

{
    "code": 0,
    "message": "cos gunzip file success",
    "data":{
        "Bucket": "examplebucket-1250000000",
        "Region": "ap-guangzhou"
    }
}
응답 매개변수 설정 설명:
매개변수 이름
매개변수 설명
유형
code
비즈니스 오류 코드. 0이면 실행 성공, 그렇지 않으면 실행 실패
Number
message
실행 결과의 텍스트 설명. null일 수 있음
String
data
실행 성공 정보. 실행이 성공하면 압축 해제된 산출물의 최종 전송 대상 버킷 정보 포함
Object
error
실행 오류 메시지. 실행 성공 시 null
Object or String

실제 사례

사례1: *.zip 파일의 압축 해제

매개변수 설정

{
  "bucket": "examplebucket-1250000000",
  "region": "ap-guangzhou",
  "key": "example.zip",
  "targetBucket": "examplebucket-1250000000",
  "targetRegion": "ap-guangzhou",
  "targetPrefix": "target/"
}

최종 압축 해제 산출물 위치

target/example.txt

다음 주제: 릴리스 노트

도움말 및 지원

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

피드백