Term Description
최신 업데이트：2025-08-19 10:11:18
이 섹션에서는 API 작업 시 자주 사용되는 용어들을 소개합니다.
버킷(bucket)
버킷은 CDNetworks Object Storage에서 사용하는 가상 스토리지 디스크 개념입니다. 각 버킷은 여러 파일을 저장할 수 있으며, 버킷 이름은 해당 버킷을 구분하는 유일한 식별자입니다.
API 안내: API 문서에서는 Bucket 대신 bucket 을 사용합니다.
파일명(key)
파일명은 CDNetworks Object Storage 플랫폼이 리소스를 식별하기 위해 사용하는 이름입니다. 파일명은 아래 기준을 따라야 합니다.
- 최대 1000바이트까지 허용
- 파일명 시작과 끝에 / 문자를 사용할 수 없음
- /…/ 또는 /./ 와 같은 특수 문자열을 포함할 수 없음
일반 파일 시스템과는 다르게 Object Storage는 평면 파일 시스템(Flat File System) 구조를 가지고 있습니다. 디렉토리 개념이 없지만, 파일명에 경로처럼 보이도록 문자를 사용함으로써 가상 경로를 만들 수 있습니다. 이 점이 일반 파일명과 Object Storage에서의 파일명이 조금 다른 부분입니다.
가상 경로를 포함한 파일명 예시: book/2.jpg
API 안내: 본 문서에서 파일명은 key로 표시됩니다.
리소스
리소스는 CDNetworks Object Storage에 저장된 데이터 단위입니다. 각 리소스에는 고유한 접근 경로가 있습니다. 이 경로는 버킷에 할당된 도메인 이름과 파일명을 조합해 구성됩니다.
# 접근 경로 예시
http://<도메인>/{key}
EncodeEntryURI 형식
EncodeEntryURI는 버킷 이름과 리소스 이름을 지정하는 방식입니다.
# 구문 규칙
EntryURI=<bucket>:<key>
EncodeEntryURI=Urlsafe_Base64_Encode(EntryURI)
치환 변수
특수 치환 변수
특수 치환 변수는 CDNetworks Object Storage에서 사전 정의된 변수들로, $(변수이름) 형태로 작성합니다. 플랫폼이 해당 변수를 감지하면 실제 값으로 자동 대체하여 반환 결과에 포함합니다.
참고: 특수 치환 변수의 지원 여부나 상세 내용은 실제 적용 시나리오별로 상이할 수 있습니다. 상세 지원 현황은 관련 시나리오 문서를 참고하세요.
예시
saveKey: $(year)/$(month)/$(hash)
예를 들어, 현재 날짜가 2016년 4월일 경우 업로드된 파일은 2016/04/<file-hash>로 저장됩니다.
특수 변수 설명
| 변수 | 설명 |
|---|---|
$(fname) |
업로드된 파일의 원래 파일명 |
$(hash) |
리소스의 Etag |
$(mimeType) |
리소스의 MIME 타입 (예: JPG는 image/jpg) |
$(suffix) |
원본 파일의 확장자, 없으면 기본값은 unknown |
$(uuid) |
랜덤 숫자 |
$(year) |
업로드 연도 (예: 2015) |
$(month) |
업로드 월 (예: 01) |
$(day) |
업로드 일 (예: 01) |
$(hour) |
업로드 시 (예: 01) |
$(min) |
업로드 분 (예: 01) |
$(sec) |
업로드 초 (예: 01) |
커스텀 치환 변수
커스텀 치환 변수는 클라이언트가 업로드 요청 시 $(x:변수이름) 형태로 지정할 수 있습니다. 오브젝트 스토리지 플랫폼은 해당 요청에서 같은 이름의 파라미터 값을 찾아 이 변수에 대입합니다.
참고: 커스텀 변수는 반드시 UTF-8 포맷이어야 하며, & 기호를 포함하면 제대로 해석되지 않고 깨질 수 있습니다.
예를 들어, callbackBody에 아래와 같이 커스텀 치환 변수를 설정할 수 있습니다:
position=$(x:position)&message=$(x:message)
여기서 $(x:position)과 $(x:message)는 커스텀 변수이고, 예를 들어 x:position=4, x:message=upload로 요청한다면, 서버는 callbackBody 내 해당 부분을 해당 값들로 대체합니다.
도메인명 설명
업로드 도메인
업로드 도메인으로 파일을 업로드하려면 CDNetworks 콘솔에 로그인한 후
“Object Storage Service -> Buckets -> Overview -> Domain Names”을 확인하세요.
관리 도메인
관리 도메인으로 파일 작업(예: 오디오/비디오 처리, 파일 삭제 등)을 하려면, CDNetworks 콘솔에 로그인해
“Object Storage Service -> Buckets -> Overview -> Domain Names”에서 확인할 수 있습니다.
CNAME용 오리진 도메인
이 도메인은 CDN 가속용 도메인입니다. 사용자는 이 도메인을 Object Storage 버킷에 바인딩하여 해당 도메인으로 파일을 접근할 수 있습니다.
로그인 후 “Object Storage Service -> Buckets -> Overview -> Domain Names”에서 확인하세요.
이 세 가지 도메인명 정보 조회 방법은 Obtain Domains 문서를 참고하세요.
스크립트 표기 규칙
API 문서에서는 이해를 돕기 위해 다음과 같은 표기 규칙을 따릅니다.
치환 문자:
꺾쇠괄호 < >로 둘러싼 문자는 실제 사용 시 값으로 바꿔야 하며, 문서상 구분을 위한 표기일 뿐 실제 적용 시에는 괄호 없이 사용합니다.
예: *<deadline string>*은 "deadline"에 해당하는 문자열로 교체해야 함을 의미합니다.