오브젝트 관리

Classic/VPC 환경에서 이용 가능합니다.

생성한 버킷에 간편하게 객체를 업로드하거나 다운로드할 수 있습니다. 또한 업로드한 객체를 편리하게 관리할 수 있습니다.

객체 업로드

버킷에 객체를 업로드하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 > Services > Storage > Ncloud Storage 메뉴를 차례대로 클릭해 주십시오.
2. Bucket Management 화면에서 객체를 업로드할 버킷을 선택해 주십시오.
3. [오브젝트 관리] 버튼을 클릭하여 오브젝트 관리 화면으로 이동해 주십시오.
4. [파일 올리기] 버튼을 클릭해 주십시오.
5. 업로드 팝업 창이 나타나면 추가할 객체를 드래그 앤 드롭하거나 [파일 추가] 버튼을 클릭하여 원하는 파일을 선택해 주십시오.
   • 객체 이름은 최대 1,024Byte(prefix 포함) 길이의 UTF-8 인코딩을 포함하는 유니코드 문자로 지정 가능
   • 파일 올리기를 통한 객체 업로드는 동시에 100개까지 가능
   • 파일 올리기를 통한 객체 업로드는 1개당 최대 5GB까지 가능
     • 5GB를 초과하는 객체 크기는 API를 통해 최대 5TB까지 업로드 가능
6. 필요에 따라 객체 저장에 대한 옵션을 설정할 수 있습니다.
   • [위치 선택]: 저장할 버킷을 변경하거나 버킷 내의 저장 위치 변경 가능
   • [클래스 변경]: 객체를 저장할 스토리지 클래스 선택
     • Standard Class: 접근 빈도가 높고 빠른 액세스가 필요한 데이터를 위한 스토리지
     • Deep Archive Class: 장기간 거의 액세스하지 않으며 저장 비용 절감이 중요한 데이터를 위한 스토리지
   • [설정]: 객체의 메타데이터 관리값을 설정
     • 시스템 메타 데이터: 시스템에 정의된 메타데이터 키워드를 선택하고 값 입력
     • 유저 메타 데이터: 메타데이터 키워드를 직접 정의하고 값 입력
7. [전송 시작] 버튼을 클릭해 주십시오.
   • [전송 중지]: 진행중인 파일 업로드 작업의 중단
   • 전송이 완료되면 자동으로 창 닫기: 체크한 경우 파일 전송 완료 시 팝업 창이 자동 종료
8. [닫기] 버튼을 클릭해 주십시오.
9. 버킷 목록에서 업로드된 파일을 확인할 수 있습니다.

객체 다운로드

버킷에 저장된 객체를 다운로드하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 > Services > Storage > Ncloud Storage 메뉴를 차례대로 클릭해 주십시오.
2. Bucket Management 화면에서 다운로드할 객체가 있는 버킷을 선택해 주십시오.
3. [보기] 버튼을 클릭하여 오브젝트 관리 화면으로 이동해 주십시오.
4. 목록에서 다운로드할 객체를 선택하고 [다운로드] 버튼을 클릭해 주십시오.
5. 선택한 객체가 로컬 환경으로 다운로드됩니다.

새 폴더 생성

버킷 안에 새로운 폴더를 생성하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 > Services > Storage > Ncloud Storage 메뉴를 차례대로 클릭해 주십시오.
2. Bucket Management 화면에서 폴더를 생성할 버킷을 선택해 주십시오.
3. [보기] 버튼을 클릭하여 오브젝트 관리 화면으로 이동해 주십시오.
4. [새폴더] 버튼을 클릭해 주십시오.
5. 새폴더 생성 팝업 창에서 폴더명을 입력해 주십시오.
   • 폴더명은 폴더에 저장되는 객체명을 포함하여 최대 1,024Byte까지 입력 가능
6. [저장] 버튼을 클릭해 주십시오.

객체 편집

Ncloud Storage 서비스는 저장된 객체를 관리할 수 있는 다양한 편집 기능을 지원합니다. 객체가 저장된 클래스에 따라 지원되는 기능의 일부 제약이 있을 수 있습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 > Services > Storage > Ncloud Storage 메뉴를 차례대로 클릭해 주십시오.

2. Bucket Management 화면이 나타나면 원하는 버킷을 선택해 주십시오.

3. [보기] 버튼을 클릭하여 오브젝트 관리 화면으로 이동해 주십시오.

4. 객체 목록에서 원하는 객체를 선택하여 [편집] 버튼을 클릭해 주십시오.
   

   메뉴 이름	설명
   삭제하기/삭제취소	선택한 객체를 버킷에서 삭제하거나 삭제 중인 객체의 삭제 취소
   복사하기/붙여넣기	선택한 객체의 복사 및 붙여넣기
   복원 시작	Deep Archive Class에 저장된 객체를 Standard Class로 임시 복원
   크기 확인	선택한 객체의 크기 확인
   이름 바꾸기	선택한 객체의 이름 변경
   스토리지 클래스 변경	선택한 객체가 저장된 스토리지 클래스 변경
   메타 데이터 변경	선택한 객체의 메타데이터 추가 또는 삭제

삭제하기/삭제취소

버킷에 저장된 객체를 삭제하거나 진행 중인 삭제 작업을 취소할 수 있습니다. 객체 삭제 또는 삭제 취소하는 방법은 다음과 같습니다.

1. 객체 목록에서 삭제할 객체를 선택하여 [편집] 버튼을 클릭해 주십시오.
2. 삭제하기 메뉴를 선택 후 파일 삭제 팝업 창에서 삭제 대상 파일을 확인해 주십시오.
3. [삭제] 버튼을 클릭하면 선택한 객체가 삭제됩니다.
   • 삭제가 진행 중인 경우에만 편집 메뉴에서 삭제취소 활성화
   • 삭제취소를 클릭하면 삭제 진행 전 객체의 삭제 요청은 취소

복사하기/붙여넣기

객체를 복사하여 동일한 버킷의 특정 폴더 또는 사용자가 소유한 다른 버킷에 붙여넣을 수 있습니다. 콘솔에서는 객체 크기가 5GB 이하만 복사가 가능하며, Deep Archive Class에 저장된 객체는 객체 복원 후 복사가 가능합니다.

1. 객체 목록에서 복사할 객체를 선택하여 [편집] 버튼을 클릭해 주십시오.
2. 복사하기 메뉴를 클릭해 주십시오.
   • 복사한 객체는 Standard Class로 저장됨
3. 다시 한번 [편집] 버튼을 클릭하고 붙여넣기 메뉴를 클릭해 주십시오.
4. 붙여넣기 팝업 창에서 [위치 선택] 버튼을 클릭해 주십시오.
5. 복사한 객체를 저장할 위치를 선택 후 [전송 시작] 버튼을 클릭해 주십시오.
6. 전송 완료 후 [닫기] 버튼을 클릭해 주십시오.

복원 시작

Deep Archive Class에 저장된 객체에 액세스하기 위해서는 객체를 Standard Class에 복원해야 합니다. 객체를 복원하는 방법은 다음과 같습니다.

1. 객체 목록에서 복원할 객체를 선택하고 [편집] 버튼을 클릭해 주십시오.
2. 복원 시작 메뉴를 클릭해 주십시오.
3. 객체를 복원한 사본을 저장할 기간을 입력해 주십시오.
   • 1일 ~ 3650일까지 지정 가능
4. 객체를 선택하여 상세 정보에서 필요한 정보를 확인해 주십시오.
   • 복원 상태: 복원 완료 상태로 변경되면 객체에 액세스 가능
   • 복원 만료 시간: 복원 만료 시간에 복원된 사본은 자동 삭제 (Deep Archive Class에 저장된 기존 객체는 유지)
     • 복원 만료 시간은 복원 작업의 완료 시점을 기준으로 산정
     • 복원된 객체를 사용할 수 있는 기간을 변경하고 싶은 경우, 복원된 객체를 선택하여 편집 > 복원 시작 메뉴를 클릭하고 기간을 입력하면 입력한 날 기준으로 만료일 재설정
       • <예시> 2024-10-12 14시에 복원 만료시간이 2024-10-16 0시로 설정되어 있는 객체의 사용 기간(일)을 1일로 재설정 시 복원 만료 시간은 2024-10-14 0시로 변경됩니다.

크기 확인

버킷에 저장된 객체의 크기를 확인할 수 있습니다. 객체 크기를 확인하는 방법은 다음과 같습니다.

1. 객체 목록에서 크기를 확인할 단일 객체 또는 복수의 객체를 선택하여 [편집] 버튼을 클릭해 주십시오.
   • 폴더는 크기 확인 기능 미지원
2. 크기 확인 메뉴를 클릭해 주십시오.
3. 크기 확인 팝업 창에서 선택한 객체의 크기를 확인해 주십시오.

이름 바꾸기

저장된 객체의 이름을 변경할 수 있습니다. 콘솔에서는 5GB 이하 크기의 객체만 이름 변경이 가능하며, Standard Class에 저장된 객체만 지원합니다. 객체명을 변경하는 방법은 다음과 같습니다.

1. 객체 목록에서 이름을 변경할 객체를 선택하여 [편집] 버튼을 클릭해 주십시오.
2. 이름 바꾸기 메뉴를 클릭해 주십시오.
3. 오브젝트 관리 화면의 객체 목록에서 이름을 입력할 수 있는 창이 활성화됩니다.
4. 변경할 이름을 입력하고 Enter키를 누릅니다.

스토리지 클래스 변경

Ncloud Storage 서비스는 객체의 액세스 빈도와 요구되는 성능에 따라 선택하여 저장할 수 있는 스토리지 클래스를 제공합니다. 사용 목적에 맞는 스토리지 클래스를 선택하면 객체의 비용과 성능 및 가용성을 최적화 할 수 있습니다. 객체가 저장된 스토리지 클래스를 변경하는 방법은 다음과 같습니다.

1. 객체 목록에서 단일 객체 또는 여러 개의 객체를 선택하고 [편집] 버튼을 클릭해 주십시오.
2. 스토리지 클래스 변경 메뉴를 클릭해 주십시오.
3. 클래스 변경 팝업 창이 나타나면 스토리지 클래스를 설정해 주십시오.
   • Standard Class: 자주 접근하는 빈도가 높은 데이터를 저장하기 적합한 클래스
   • Deep Archive Class: 자주 사용하지 않는 장기 보관 데이터를 저장하기 적합한 클래스
4. [전송 시작] 버튼을 클릭해 주십시오.
5. 전송 완료 후 [닫기] 버튼을 클릭해 주십시오.

메타 데이터 변경

객체의 업로드 시 또는 업로드 이후 객체의 메타 데이터를 설정할 수 있습니다. 객체의 메타 데이터를 추가하거나 삭제하는 방법은 다음과 같습니다.

1. 객체 목록에서 객체를 선택하고 [편집] 버튼을 클릭해 주십시오.

2. 메타 데이터 변경 메뉴를 클릭해 주십시오.

3. 메타 데이터 관리 팝업 창에서 선택된 파일의 메타데이터를 설정해 주십시오.

   • 메타데이터 추가: 키워드와 값을 입력하여 [메타데이터 추가] 버튼을 클릭
   • 메타데이터 수정: 메타데이터 목록에서 해당 데이터 행에 있는 [수정] 버튼을 클릭
   • 메타데이터 삭제: 메타데이터 목록에서 해당 데이터 행에 있는 [삭제] 버튼을 클릭

   키워드	설명	사용자의 값 수정 여부
   Accept-Ranges	Range 헤더	불가
   ETag	객체의 특정 버전을 나타내는 엔터티 태그	불가
   Last-Modified	객체 생성일 또는 최종 수정일 중 최근 날짜	불가
   Content-Length	객체 크기(바이트)	불가
   Content-Type	객체 유형	가능

4. [설정] 버튼을 클릭해 주십시오.

버킷 전환

콘솔에서 다른 버킷의 오브젝트 목록을 조회하고 싶으면 오브젝트 관리 화면 내에서 조회할 버킷을 전환할 수 있습니다. 버킷을 전환하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 > Services > Storage > Ncloud Storage 메뉴를 차례대로 클릭해 주십시오.
2. Bucket Management 화면에서 버킷을 선택해 주십시오.
3. [보기] 버튼을 클릭하여 오브젝트 관리 화면으로 이동해 주십시오.
4. [버킷 전환] 버튼을 클릭해 주십시오.
5. 버킷 전환 팝업 창에서 객체 목록 조회를 원하는 버킷을 선택해 주십시오.
6. [확인] 버튼을 클릭해 주십시오.

버전 표시

버전 관리를 사용하면 동일한 객체의 다른 버전에 대해 각각 고유한 버전 ID가 부여되며 특정 버전 ID를 지정하여 객체 작업을 할 수 있습니다. 버전 관리가 적용된 버킷에서 버킷에 저장된 객체의 모든 버전을 조회하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 > Services > Storage > Ncloud Storage 메뉴를 차례대로 클릭해 주십시오.
2. Bucket Management 화면에서 버킷을 선택해 주십시오.
3. [보기] 버튼을 클릭하여 오브젝트 관리 화면으로 이동해 주십시오.
4. 버전 표시 을 클릭하면 버전 ID를 표시하거나 숨길 수 있습니다.
   • 특정 버전을 다운로드 하고 싶은 경우, 해당 버전을 선택하여 [다운로드] 버튼을 클릭
   • 특정 버전을 삭제하고 싶은 경우, 해당 버전을 선택하고 [편집] 버튼 > 삭제하기 메뉴를 클릭
     • 모든 버전을 삭제할 경우 파일 복구 불가

버전 관리가 활성화된 버킷의 객체 작업

버킷 버전 관리가 활성화된 버킷에서의 객체 작업은 다음과 같습니다.

객체 추가

동일한 이름의 객체를 추가하면 새로운 버전 ID가 추가되며, 추가한 객체가 가장 최신의 현재 객체가 됩니다. 이전에 저장되어 있던 객체는 이전 버전으로 버킷에 남아있게 됩니다.

객체 가져오기

버전 표시를 ON하지 않은 경우, 최신 버전의 객체만 보여지며 버전 ID를 지정하지 않은 단순한 GET 요청은 현재 버전의 객체를 가져옵니다. 특정 버전의 객체를 가져오기 위해서는 버전 표시를 ON으로 설정하고 해당 버전의 객체를 지정하여 다운로드 합니다.

이전 버전 복원

버전 표시를 ON하고 이전 버전의 객체를 동일한 버킷으로 복사합니다. 복사된 객체는 해당 객체의 현재 버전이 되어 복원할 수 있습니다. 또는 현재의 객체 버전(최신 버전)을 삭제하여 이전 버전을 현재 버전으로 만들 수 있습니다.

객체 삭제

버전 표시를 OFF로 설정하고 현재 버전의 객체를 삭제하면, Ncloud Storage는 객체를 영구적으로 삭제하지 않고 객체에 새로운 버전 ID를 가진 삭제 마커를 삽입합니다. 삭제 마커가 현재 버전이 되면 GET 요청시 오류가 발생합니다. 버전 관리되는 객체를 영구적으로 삭제하기 위해서는, 버전 표시를 ON으로 설정하고 삭제하고자 하는 버전의 객체를 지정하여 삭제합니다. 객체 삭제를 취소하려면 삭제 마커의 버전 ID를 선택하여 삭제하면 삭제 마커가 삭제되고 이전 버전이 다시 현재 버전이 됩니다.

버전 관리가 일시 중지된 버킷의 객체 작업

버전 관리가 설정된 버킷의 버전관리를 일시 중지한 후 저장된 객체나 버전 관리를 설정하기 전에 저장되어 있던 객체의 버전 ID는 NULL로 저장됩니다. 버전 관리가 일시 중지된 버킷의 객체 작업은 다음과 같습니다.

객체 추가

기존에 버전 ID가 NULL인 객체가 현재 버전인 경우, 동일한 이름의 객체를 추가하면 이전 객체를 덮어씁니다. 하지만 이전의 현재 버전이 버전 ID를 가지고 있는 경우, 객체를 덮어쓰지 않고 이전 버전으로 유지되며 버전 ID가 NULL인 새로운 객체가 현재 버전이 됩니다.

객체 가져오기

버전 관리 설정 여부와 관계 없이 현재 버전의 객체를 반환합니다.

객체 삭제

버전 관리가 일시 중지된 경우, 버전 표시를 OFF한 상태에서 버전 ID가 NULL인 객체만 삭제할 수 있습니다. 버전 ID가 있는 객체가 현재 버전인 경우, 버전 ID가 NULL인 삭제 마커를 삽입하고 이 삭제 마커가 객체의 현재 버전이 됩니다. 객체의 특정 버전을 삭제하고 싶은 경우, 버전 표시를 ON하고 객체의 버전을 지정하면 해당 버전을 삭제할 수 있습니다.