파일 업로드하기

페이지 이동경로

파일 업로드하기

Object Storage에서 파일은 객체의 형태(Key-Value 구조)로 저장되며, 객체를 담을 수 있는 컨테이너인 버킷(Bucket)에 포함됩니다. Object Storage 서비스에서 버킷에 파일(객체)을 업로드하는 방법은 다음과 같습니다.

폴더 만들기(선택 작업)

파일을 폴더별로 관리하고 싶은 경우, 폴더를 생성할 수 있습니다.

  1. 카카오 i 클라우드 콘솔에서 Object Storage 메뉴를 선택합니다.
  2. Bucket 탭에서 폴더를 생성할 버킷을 클릭합니다.
  3. 객체 탭에서 [폴더 만들기] 버튼을 클릭합니다.
  4. 폴더 생성 팝업창에서 정보를 입력하고, [생성] 버튼을 클릭합니다.

    이미지. 폴더 만들기 이미지 폴더 만들기

파일 업로드하기

버킷에 파일을 업로드할 수 있습니다.

  • 한 번에 업로드할 수 있는 최대 파일의 수: 1,000 개
  • 한 번에 업로드할 수 있는 단일 파일 용량: 50 GB
  • 동시에 전송되는 파일의 최대 수: 5 개
  • 파일 크기가 5GB 이상일 경우, SLO 멀티파트 업로드로 진행
  • 이어올리기 기능은 제공하지 않음

안내
업로드 진행 중 또는 손상 등의 이유로 불완전한 객체의 경우 메타 데이터 수정 / 이름 바꾸기 / 복사 / 이동 기능을, 업로드를 마친 멀티 파트 업로드 객체의 경우 이름 바꾸기 / 복사 / 이동 기능을 사용할 수 없습니다.

주의
같은 이름의 파일이지만 다른 용량의 파일을 덮어쓰기로 업로드할 경우 세그먼트 파일이 남아 있을 수 있습니다.
반드시 기존 파일 삭제 후 재업로드를 권장합니다.

  1. 카카오 i 클라우드 콘솔에서 Object Storage 메뉴를 선택합니다.
  2. Bucket 탭에서 파일을 업로드할 버킷을 클릭합니다.
  3. 객체 탭에서 [파일 업로드] 버튼을 클릭합니다.

    이미지. 파일 업로드 버튼 이미지 파일 업로드

  4. 파일 업로드에서 [파일 추가]/[폴더 추가] 버튼을 클릭하여 객체를 업로드한 후, 업로드한 객체를 설정합니다.

    이미지. 파일 업로드탭 이미지 파일 업로드하기

    구분 설명  
    ① 객체 추가 [파일 추가] 버튼 개별 파일을 업로드
      [폴더 추가] 버튼 폴더 단위로 업로드
    - 선택한 폴더의 모든 하위 파일이 업로드됨
    ⓶ 객체 설정 파일 업로드할 파일 목록
      메타 데이터 객체에 대한 메타데이터를 설정할 경우, [메타 데이터 추가하기] 버튼을 클릭하여 유형, 키, 값을 입력하며 자세한 설명은 메타 데이터 추가하기를 참고
    - 유형: 메타 데이터 타입을 지정
      ㄴ 시스템 정의: 객체에 대한 정보를 Object Storage 시스템에 전달
      ㄴ 사용자 정의: 사용자가 임의로 Key를 변경함으로써 원하는 객체로 분류
    - : 파일을 인식할 수 있는 고유의 식별자
    - : 선택한 키(Key)에 대한 Value 값
      중복 처리 객체에 대한 중복 처리에 대한 옵션을 설정
    - 건너뛰기: 중복된 객체는 업로드하지 않음
    - 덮어쓰기: 중복된 객체를 덮어씌움
      추가 옵션 체크박스 선택 시, 파일 업로드가 끝나면 자동으로 파일 업로드가 닫힘
  5. 객체 업로드 및 설정을 완료하고 [업로드] 버튼을 클릭한 후, 업로드 결과를 확인합니다.

    이미지. 업로드 결과 이미지 객체 업로드 결과 확인하기

| 메타 데이터 추가하기

파일 업로드 시 객체를 설명하는 메타 데이터를 설정할 수 있습니다.
메타 데이터는 객체에 대한 정보를 Object Storage 시스템에 전달하는 목적의 시스템 정의와 사용자가 임의로 등록할 수 있는 사용자 정의로 구분됩니다. 시스템 정의는 선택할 수 있는 Key가 고정되며 파일의 MIME 타입을 지정하거나 압축 방식을 지정할 때 사용할 수 있습니다. 사용자 정의는 사용자가 임의로 Key 이름을 변경할 수 있으며, 사용자가 파일을 분류하거나 조건에 따른 파일 관리 기능을 구현할 때 임의로 추가하여 사용할 수 있습니다.

메타 데이터 추가하기

구분 설명
유형(Type) 시스템 정의/사용자 정의 중 선택하여 메타 데이터 타입을 지정
- 시스템 정의(시스템 메타 데이터): 파일을 올릴 때 자동으로 지정되는 메타 데이터 타입으로, Key 값은 수정되지 않으며 Value만 입력 가능
- 사용자 정의(사용자 메타 데이터): 사용자가 임의로 Key-Value 값을 지정하여 등록할 수 있는 메타 데이터 타입
키(Key) 파일을 인식할 수 있는 고유의 식별자

< Type시스템 정의으로 선택 시 >
- Content-Type: 객체의 MIME type을 지정
- Content-Disposition: 브라우저에 대한 재정의 동작을 지정
- Content-Encoding: 어떤 알고리즘에 의해 인코딩이 되었는지를 명시

< Type사용자 정의로 선택 시>
- X-Object-Meta-{name}: 버킷 메타 정보로, 사용자가 지정할 메타 데이터 이름을 {name}에 입력
값(Value) 선택한 Key에 대한 Value 값
[휴지통] 아이콘 클릭 시 해당 메타 데이터 삭제