--- title: "오브젝트 관리" slug: "ncloudstorage-use-object" tags: ["Ncloud Storage", "Storage", "객체 관리", "버킷 관리", "오브젝트 관리"] updated: 2026-10-14T01:07:58Z published: 2026-10-14T09:00:24Z canonical: "guide.ncloud-docs.com/ncloudstorage-use-object" --- > ## Documentation Index > Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # 오브젝트 관리 Classic/VPC 환경에서 이용 가능합니다. 생성한 버킷에 객체를 업로드 및 다운로드하고 관리할 수 있습니다. ## 객체 업로드 버킷에 객체를 업로드하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Storage** > **Ncloud Storage** 메뉴를 차례대로 클릭해 주십시오. 2. **Bucket Management** 화면에서 객체를 업로드할 버킷을 선택해 주십시오. 3. **[오브젝트 관리]** 버튼을 클릭해 주십시오. 4. **[파일 올리기]** 버튼을 클릭해 주십시오. 5. **업로드** 팝업 창이 나타나면 추가할 객체를 마우스로 끌고 오거나, **[파일 추가]** 버튼을 클릭하여 업로드할 파일을 선택해 주십시오. - 객체 이름은 UTF-8로 인코딩된 유니코드 문자로 최대 1,024Byte(prefix 포함)까지 지정 가능 - 파일 올리기를 통한 객체 업로드는 동시에 100개까지 가능 - 파일 올리기를 통한 객체 업로드는 1개당 최대 5GB까지 가능 - 5GB를 초과하는 객체는 API를 통해 최대 5TB까지 업로드 가능 6. 필요에 따라 객체 저장에 대한 옵션을 설정할 수 있습니다. - **위치 선택**: 저장할 버킷을 변경하거나 버킷 내의 저장 위치 변경 가능 - **클래스 변경**: 객체를 저장할 스토리지 클래스 선택 - **Standard Class**: 접근 빈도가 높은 데이터를 저장하기 적합한 클래스 - **One Zone-IA Class**: 자주 접근하지 않지만 즉시 조회가 필요하며 단일 가용 구역(Zone)에 보관해 비용을 최적화한 데이터를 저장하기 적합한 클래스 - **Deep Archive Class**: 자주 사용하지 않는 장기 보관 데이터를 저장하기 적합한 클래스 - **암호화 관리**: 객체에 적용할 암호화 유형 선택 - 암호화 설정에 대한 자세한 내용은 [암호화 관리](/docs/ncloudstorage-datamanagement#%EC%95%94%ED%98%B8%ED%99%94%EA%B4%80%EB%A6%AC)를 참조해 주십시오. - **설정**: 객체의 메타데이터 관리값을 설정 - **시스템 메타데이터**: 시스템에 정의된 메타데이터 키워드를 선택하고 값 입력 - **사용자 메타데이터**: 메타데이터 키워드를 직접 정의하고 값 입력 7. **[전송 시작]** 버튼을 클릭해 주십시오. - **[전송 중지]**: 진행 중인 파일 업로드 작업의 중단 - **전송이 완료되면 자동으로 창 닫기**: 체크한 경우 파일 전송 완료 시 팝업 창이 자동 종료 8. **[닫기]** 버튼을 클릭해 주십시오. 9. **오브젝트 관리** 화면에서 업로드된 객체를 확인할 수 있습니다. 참고 Sub Account 계정으로 콘솔에서 객체를 업로드하려면 Change/PutObject와 View/GetObject 권한이 모두 필요합니다. ## 객체 다운로드 버킷에 저장된 객체를 다운로드하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Storage** > **Ncloud Storage** 메뉴를 차례대로 클릭해 주십시오. 2. **Bucket Management** 화면에서 다운로드할 객체가 있는 버킷을 선택해 주십시오. 3. **[오브젝트 관리]** 버튼을 클릭해 주십시오. 4. 다운로드할 객체를 선택한 후, **[다운로드]** 버튼을 클릭해 주십시오. 5. 선택한 객체가 로컬 환경으로 다운로드됩니다. 참고 Deep Archive Class에 저장된 객체는 복원이 완료된 경우에만 다운로드 가능합니다. 객체 복원과 관련된 자세한 내용은 [복원 시작](/docs/ncloudstorage-use-object#%EB%B3%B5%EC%9B%90%EC%8B%9C%EC%9E%91) 가이드를 참조해 주십시오. ## 새 폴더 생성 버킷 안에 새로운 폴더를 생성하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Storage** > **Ncloud Storage** 메뉴를 차례대로 클릭해 주십시오. 2. **Bucket Management** 화면에서 폴더를 생성할 버킷을 선택해 주십시오. 3. **[오브젝트 관리]** 버튼을 클릭해 주십시오. 4. **[새폴더]** 버튼을 클릭해 주십시오. 5. **새폴더 생성** 팝업 창에서 **폴더명**을 입력해 주십시오. - 폴더명은 폴더에 저장되는 객체명을 포함하여 최대 1,024Byte까지 입력 가능 6. **[저장]** 버튼을 클릭해 주십시오. ## 객체 편집 Ncloud Storage 서비스는 저장된 객체를 관리할 수 있는 다양한 편집 기능을 지원합니다. 객체가 저장된 클래스에 따라 지원되는 기능에 일부 제약이 있을 수 있습니다. 객체를 편집하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Storage** > **Ncloud Storage** 메뉴를 차례대로 클릭해 주십시오. 2. **Bucket Management** 화면이 나타나면 원하는 버킷을 선택해 주십시오. 3. **[오브젝트 관리]** 버튼을 클릭해 주십시오. 4. 원하는 객체를 선택한 후, **[편집]** 버튼을 클릭해 주십시오. ![ncloudstorage-use-object_objectedit_ko.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/image-I40EY2UK.png?sv=2026-02-06&spr=https&st=2026-10-26T22%3A51%3A47Z&se=2026-10-26T23%3A51%3A47Z&sr=c&sp=r&sig=sfpzXqg3Jl9kW8BfWcSKgoMvO5kVqqoIWFERDiqqY%2FU%3D) | 메뉴 이름 | 설명 | | --- | --- | | 삭제하기/삭제취소 | 선택한 객체의 [삭제하기 및 삭제취소](/docs/ncloudstorage-use-object#%EC%82%AD%EC%A0%9C%ED%95%98%EA%B8%B0%EC%82%AD%EC%A0%9C%EC%B7%A8%EC%86%8C) | | 복사하기/붙여넣기 | 선택한 객체의 [복사하기 및 붙여넣기](/docs/ncloudstorage-use-object#%EB%B3%B5%EC%82%AC%ED%95%98%EA%B8%B0%EB%B6%99%EC%97%AC%EB%84%A3%EA%B8%B0) | | 복원 시작 | Deep Archive Class에 저장된 객체를 Standard Class로 [임시 복원](/docs/ncloudstorage-use-object#%EB%B3%B5%EC%9B%90%EC%8B%9C%EC%9E%91) | | 크기 확인 | 선택한 객체의 [크기 확인](/docs/ncloudstorage-use-object#%ED%81%AC%EA%B8%B0%ED%99%95%EC%9D%B8) | | 이름 바꾸기 | 선택한 객체의 [이름 변경](/docs/ncloudstorage-use-object#%EC%9D%B4%EB%A6%84%EB%B3%80%EA%B2%BD) | | 스토리지 클래스 변경 | 선택한 객체가 저장된 [스토리지 클래스 변경](/docs/ncloudstorage-use-object#%EC%8A%A4%ED%86%A0%EB%A6%AC%EC%A7%80%ED%81%B4%EB%9E%98%EC%8A%A4%EB%B3%80%EA%B2%BD) | | 메타데이터 변경 | 선택한 객체의 [메타데이터 추가 또는 삭제](/docs/ncloudstorage-use-object#%EB%A9%94%ED%83%80%EB%8D%B0%EC%9D%B4%ED%84%B0%EB%B3%80%EA%B2%BD) | 참고 객체 목록은 한 번에 최대 1,000개까지 조회할 수 있습니다. 버킷 내의 객체가 1,000개를 초과할 경우, 객체 이름 검색 결과가 정상적으로 조회되지 않으면 다음 페이지를 눌러 조회해 주십시오. ### 삭제하기/삭제취소 버킷에 저장된 객체를 삭제하거나 진행 중인 삭제 작업을 취소할 수 있습니다. 객체 삭제 또는 삭제 취소하는 방법은 다음과 같습니다. 1. 객체 목록에서 삭제할 객체를 선택하여 **[편집]** 버튼을 클릭해 주십시오. 2. **삭제하기** 메뉴를 선택한 후, **파일 삭제** 팝업 창에서 삭제 대상 파일을 확인해 주십시오. 3. **[삭제]** 버튼을 클릭하면 선택한 객체가 삭제됩니다. - 삭제가 진행 중인 경우에만 편집 메뉴에서 **[삭제취소]** 버튼 활성화 - **[삭제취소]** 버튼을 클릭하면 삭제 진행 전 객체의 삭제 요청은 취소 주의 한 번 삭제된 객체는 복구가 불가합니다. 삭제 취소 시에도 이미 삭제가 진행된 객체는 복구가 불가하며 아직 삭제되지 않은 객체만 남아 있게 됩니다. 참고 객체가 삭제되지 않을 경우, 다음 사항을 확인해 주십시오. - Object Lock 및 보존 기간(Retention): 설정되어 있으면 보존 만료 전까지 삭제 불가 - Sub Account 권한: 콘솔에서 객체를 삭제하려면 Change/DeleteObject와 View/GetBucketVersioning 권한이 모두 필요 ### 복사하기/붙여넣기 객체를 복사하여 동일한 버킷의 특정 폴더 또는 사용자가 소유한 다른 버킷에 붙여넣을 수 있습니다. 콘솔에서는 5GB 이하인 객체만 복사할 수 있으며, Deep Archive Class에 저장된 객체는 객체 복원 후 복사가 가능합니다. 객체를 복사하여 붙여넣는 방법은 다음과 같습니다. 1. 객체 목록에서 복사할 객체를 선택하여 **[편집]** 버튼을 클릭해 주십시오. 2. **[복사하기]** 버튼을 클릭해 주십시오. 3. 다시 한번 **[편집]** 버튼을 클릭한 후, **[붙여넣기]** 버튼을 클릭해 주십시오. 4. **붙여넣기** 팝업 창에서 **[위치 선택]** 버튼을 클릭해 주십시오. 5. 복사한 객체를 저장할 위치를 선택한 후, **[확인]** 버튼을 클릭해 주십시오. 6. **[클래스 변경]** 버튼을 클릭해서 복사한 객체를 저장할 스토리지 클래스를 선택해 주십시오. 별도로 지정하지 않으면 원본 객체의 스토리지 클래스를 유지합니다. 7. **[전송 시작]** 버튼을 클릭해 주십시오. 8. 전송 완료 후 **[닫기]** 버튼을 클릭해 주십시오. ### 복원 시작 Deep Archive Class에 저장된 객체에 접근하기 위해서는 객체를 Standard Class에 복원해야 합니다. 객체를 복원하는 방법은 다음과 같습니다. 1. 객체 목록에서 복원할 객체를 선택하고 **[편집]** 버튼을 클릭해 주십시오. 2. **복원 시작** 메뉴를 클릭해 주십시오. 3. 객체를 복원한 사본을 저장할 기간을 입력해 주십시오. - 1~3,650일까지 지정 가능 4. 객체를 선택하여 상세 정보에서 필요한 정보를 확인해 주십시오. - **복원 상태**: 복원 완료 상태로 변경되면 객체에 접근 가능 - **복원 만료 시간**: 복원 만료 시간에 복원된 사본은 자동 삭제(Deep Archive Class에 저장된 기존 객체는 유지) - 복원 만료 시간은 복원 작업의 완료 시점을 기준으로 산정 - 복원된 객체의 사용 기간 변경: 복원된 객체를 선택한 후, **편집** > **복원 시작** 메뉴를 차례대로 클릭한 후 기간 입력(입력한 날 기준으로 만료일 재설정) - <예시> 2024-10-12 14시에 복원 만료 시간이 2024-10-16 0시로 설정되어 있는 객체의 사용 기간(일)을 1일로 재설정 시 복원 만료 시간은 2024-10-14 0시로 변경 참고 객체 복원에는 12시간 이상 소요될 수 있습니다. 복원이 완료되면 복원된 기간 동안 객체 사본의 크기만큼 Standard Class 저장 요금이 추가로 부과됩니다. ### 크기 확인 버킷에 저장된 객체의 크기를 확인할 수 있습니다. 객체 크기를 확인하는 방법은 다음과 같습니다. 1. 객체 목록에서 크기를 확인할 단일 객체 또는 복수의 객체를 선택한 후, **[편집]** 버튼을 클릭해 주십시오. - 폴더는 크기 확인 기능 미지원 2. **크기 확인** 메뉴를 클릭해 주십시오. 3. **크기 확인** 팝업 창에서 선택한 객체의 크기를 확인해 주십시오. ### 이름 변경 저장된 객체의 이름을 변경할 수 있습니다. 콘솔에서는 5GB 이하 크기의 객체만 이름 변경이 가능하며, Standard Class 또는 One Zone-IA Class에 저장된 객체만 지원합니다. 객체명을 변경하는 방법은 다음과 같습니다. 1. 객체 목록에서 이름을 변경할 객체를 선택하여 **[편집]** 버튼을 클릭해 주십시오. 2. **[이름 바꾸기]** 버튼을 클릭해 주십시오. 3. 오브젝트 관리 화면의 객체 목록에서 이름을 입력할 수 있는 창이 활성화됩니다. 4. 변경할 이름을 입력한 후, **[Enter]** 키를 눌러 주십시오. ### 스토리지 클래스 변경 Ncloud Storage 서비스는 객체의 접근 빈도와 요구되는 성능에 따라 선택하여 저장할 수 있는 스토리지 클래스를 제공합니다. 사용 목적에 맞는 스토리지 클래스를 선택하면 객체의 비용과 성능 및 가용성을 최적화할 수 있습니다. 객체가 저장된 스토리지 클래스를 변경하는 방법은 다음과 같습니다. 1. 객체 목록에서 단일 객체 또는 여러 개의 객체를 선택하고 **[편집]** 버튼을 클릭해 주십시오. 2. **[스토리지 클래스 변경]** 버튼을 클릭해 주십시오. 3. **클래스 변경** 팝업 창이 나타나면 스토리지 클래스를 설정해 주십시오. - **Standard Class**: 접근 빈도가 높은 데이터를 저장하기 적합한 클래스 - **One Zone-IA Class**: 자주 접근하지 않지만 즉시 조회가 필요하며 단일 가용 구역(Zone)에 보관해 비용을 최적화한 데이터를 저장하기 적합한 클래스 - **Deep Archive Class**: 자주 사용하지 않는 장기 보관 데이터를 저장하기 적합한 클래스 4. **[전송 시작]** 버튼을 클릭해 주십시오. 5. 전송 완료 후 **[닫기]** 버튼을 클릭해 주십시오. 참고 Deep Archive Class에 있는 객체의 클래스 이동은 복원된 객체에 대해서만 가능합니다. [객체 복원](/docs/ncloudstorage-use-object#%EB%B3%B5%EC%9B%90%EC%8B%9C%EC%9E%91)을 진행한 후 원하는 스토리지 클래스를 지정하여 객체를 복사해 주십시오. ### 메타데이터 변경 객체 업로드 시 또는 업로드 이후 객체의 메타데이터를 설정할 수 있습니다. 객체의 메타데이터를 추가하거나 삭제하는 방법은 다음과 같습니다. 1. 객체 목록에서 객체를 선택하고 **[편집]** 버튼을 클릭해 주십시오. 2. **[메타데이터 변경]** 버튼을 클릭해 주십시오. 3. **메타데이터 관리** 팝업 창에서 선택된 파일의 메타데이터를 설정해 주십시오. | 키워드 | 설명 | 값 수정 가능 여부 | | --- | --- | --- | | Accept-Ranges | Range 헤더 | 불가 | | ETag | 객체의 특정 버전을 나타내는 엔터티 태그 | 불가 | | Last-Modified | 객체 생성일 또는 최종 수정일 중 최근 날짜 | 불가 | | Content-Length | 객체 크기(Byte) | 불가 | | Content-Type | 객체 유형 | 가능 | - 메타데이터 추가: 키워드와 값을 입력하여 **[메타데이터 추가]** 버튼 클릭 - 메타데이터 수정: 메타데이터 목록에서 해당 데이터 행에 있는 **[수정]** 버튼 클릭 - 메타데이터 삭제: 메타데이터 목록에서 해당 데이터 행에 있는 **[삭제]** 버튼 클릭 4. **[설정]** 버튼을 클릭해 주십시오. ## 암호화 구성 객체 업로드 시 또는 업로드 이후 객체에 적용된 암호화 유형을 변경할 수 있습니다. 객체의 암호화 유형을 변경하는 방법은 [암호화 관리](/docs/ncloudstorage-datamanagement#%EC%95%94%ED%98%B8%ED%99%94%EA%B4%80%EB%A6%AC) 가이드를 참조해 주십시오. ## 객체 잠금 설정 객체 업로드 시 또는 업로드 이후 개별 객체를 지정한 기간 동안 삭제 및 덮어쓰기로부터 보호할 수 있습니다. 버킷에 기본 보존 정책이 설정되어 있지 않거나 특정 객체에만 별도의 보존 정책을 적용하려는 경우 사용할 수 있습니다. 객체에 잠금 정책을 설정하는 방법은 [객체별 잠금 설정](/docs/ncloudstorage-datamanagement#%EA%B0%9D%EC%B2%B4%EB%B3%84%EC%9E%A0%EA%B8%88%EC%84%A4%EC%A0%95) 가이드를 참조해 주십시오. ## 객체 잠금 법적 보존 설정 법적 보존(Legal Hold) 기능은 보존 기간과 관계없이 객체를 삭제하거나 덮어쓰지 못하도록 보호하는 기능입니다. 법적 보존이 설정된 객체는 명시적으로 해제하기 전까지 보호 상태가 유지됩니다. 객체에 잠금 법적 보존 정책을 설정하는 방법은 [객체 잠금 법적 보존 설정](/docs/ncloudstorage-datamanagement#%EA%B0%9D%EC%B2%B4%EC%9E%A0%EA%B8%88%EB%B2%95%EC%A0%81%EB%B3%B4%EC%A1%B4%EC%84%A4%EC%A0%95) 가이드를 참고해 주십시오. ## 버킷 전환 콘솔에서 다른 버킷의 객체 목록을 조회하려면 **오브젝트 관리** 화면에서 조회할 버킷을 전환할 수 있습니다. 버킷을 전환하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Storage** > **Ncloud Storage** 메뉴를 차례대로 클릭해 주십시오. 2. **Bucket Management** 화면에서 버킷을 선택해 주십시오. 3. **[오브젝트 관리]** 버튼을 클릭해 주십시오. 4. **[버킷 전환]** 버튼을 클릭해 주십시오. 5. **버킷 전환** 팝업 창에서 객체 목록 조회를 원하는 버킷을 선택해 주십시오. 6. **[확인]** 버튼을 클릭해 주십시오. ## 버전 표시 버전 관리를 사용하면 동일한 객체의 각 버전에 고유한 버전 ID가 부여됩니다. 이 버전 ID를 지정하여 특정 버전에 대한 객체 작업을 할 수 있습니다. 버전 관리가 적용된 버킷에서 저장된 객체의 모든 버전을 조회하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Storage** > **Ncloud Storage** 메뉴를 차례대로 클릭해 주십시오. 2. **Bucket Management** 화면에서 버킷을 선택해 주십시오. 3. **[오브젝트 관리]** 버튼을 클릭해 주십시오. 4. **버전 표시** ![i-objectstorage_toggle](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-objectstorage_toggle.png?sv=2026-02-06&spr=https&st=2026-10-26T22%3A51%3A47Z&se=2026-10-26T23%3A51%3A47Z&sr=c&sp=r&sig=sfpzXqg3Jl9kW8BfWcSKgoMvO5kVqqoIWFERDiqqY%2FU%3D)을 클릭하면 버전 ID를 표시하거나 숨길 수 있습니다. - 특정 버전을 다운로드하고 싶은 경우: 해당 버전을 선택한 후, **[다운로드]** 버튼을 클릭 - 특정 버전을 삭제하고 싶은 경우: 해당 버전을 선택한 후, **[편집]** 버튼 > **[삭제하기]** 버튼을 클릭 주의 모든 버전을 삭제하면 객체를 복구할 수 없습니다. 참고 버전 관리 기능을 사용하는 버킷에서의 객체 작업에 대한 자세한 내용은 [버전 관리가 활성화된 버킷의 객체 작업](/docs/ncloudstorage-datamanagement#%EB%B2%84%EC%A0%84%EA%B4%80%EB%A6%AC%EA%B0%80%ED%99%9C%EC%84%B1%ED%99%94%EB%90%9C%EB%B2%84%ED%82%B7%EC%9D%98%EA%B0%9D%EC%B2%B4%EC%9E%91%EC%97%85) 가이드를 참고해 주십시오.