Uncompress zip Package
최신 업데이트：2025-08-20 11:11:16
이 인터페이스는 오브젝트 스토리지 플랫폼에서 압축 파일을 해제(압축 해제)하는 기능을 제공합니다. 압축 해제 후에는 해당 공간(버킷)에 결과 파일들의 정보를 담은 list 파일이 기본적으로 생성됩니다.
요청 설명
요청 형식
POST /fops
Host: <MgrDomain>
Authorization: <accessToken>
Management Credential 파라미터
<path>:/fops
<body>:<RequestParams> (즉, 요청 본문 전체)
헤더 설명
| 파라미터 | 필수 | 설명 |
|---|---|---|
| Host | 예 | 관리 도메인 명 (콘솔에서 확인) |
| Authorization | 예 | 관리 인증 정보 |
요청 본문 형식
아래와 같은 쿼리스트링 형태의 파라미터를 request body에 전달합니다.
bucket=<Urlsafe_Base64_Encoded_Bucket>&key=<Urlsafe_Base64_Encoded_Key>&fops=<Urlsafe_Base64_Encoded_Fops>¬ifyURL=<Urlsafe_Base64_Encoded_PersistentNotifyUrl>&force=<Force>&separate=<Separate>
요청 파라미터 설명
| 파라미터 | 필수 | 설명 |
|---|---|---|
| bucket | 예 | 버킷(공간) 이름 (Base64 인코딩) |
| key | 예 | 압축 해제할 파일 이름 (Base64 인코딩) |
| fops | 예 | 처리 파라미터 목록. Decompression Ops 파라미터 포맷 참고. 여러 처리 시 세미콜론(;)으로 구분 |
| notifyURL | 아니오 | 처리 결과 알림을 받을 URL (Base64 인코딩). 알림 데이터 포맷 참고 |
| force | 아니오 | 1: 이미 결과가 있어도 강제 재처리(덮어쓰기), 0: 이미 있으면 처리하지 않음(기본값) |
| separate | 아니오 | 1: 각 인스트럭션 처리 후 알림, 0: 전체 완료 후 한번만 알림(기본값) |
응답 설명
- 요청 성공 시:
{ "persistentId": <persistentId> }
| 필드명 | 필수 | 설명 |
|---|---|---|
| persistentId | 예 | 처리 작업(압축 해제 등) ID |
- 요청 실패 시:
{
"code": "<code string>",
"message": "<ErrMsg string>"
}
| 필드명 | 필수 | 설명 |
|---|---|---|
| code | 예 | HTTP 응답 코드 |
| message | 예 | 압축 해제 처리 실패 안내 메시지 |
List 파일 설명
압축 해제 작업 성공 이후, 같은 버킷 내에 압축 해제 결과내역을 담은 list 파일이 기본적으로 생성됩니다.
기본 파일명 포맷: 랜덤번호 + 타임스탬프 + 압축파일명.list
파일 내용 포맷
url \t key \t status
| 파라미터 | 타입 | 설명 |
|---|---|---|
| url | string | 해제된 파일의 접근 경로 |
| key | string | 리소스 위치 식별자(공간명:파일명 형식, 예: video:1.txt) |
| status | int | 상태 코드 0=신규 파일, 1=덮어쓰기, 2=기존 유지, 3=압축해제 예외, -1=압축 해제 파일 저장 실패 |
예시
curl -v -X POST -d "bucket=aW1hZ2Vz&key=dGVzdC56aXA&fops=ZGVjb21wcmVzc2lvbi96aXA=&force=1&separate=0" -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:NmNlYmI5YzczMjlkN2MxYTYxNWYyMjE4MDMxZTVjMWQ3ZjlkZTVmOA==" --url "http://mgrDomain/fops"
이 문서의 내용이 도움이 되었습니까?
예
아니오