Storage > Object Storage > 콘솔 사용 가이드

컨테이너

컨테이너 생성

컨테이너를 만듭니다. 오브젝트 스토리지에 오브젝트를 업로드하려면 반드시 하나 이상의 컨테이너가 필요합니다.

항목 설명
이름 컨테이너 이름은 영문 255자, 한글 85자로 제한됩니다.
컨테이너 접근 정책 PRIVATE: 허가된 사용자만 컨테이너 내부의 오브젝트에 접근할 수 있습니다.
PUBLIC: 공개 URL을 통해 누구나 컨테이너 내부의 오브젝트에 접근할 수 있습니다.
스토리지 클래스 Standard: 기본 클래스입니다.

컨테이너 삭제

선택한 컨테이너를 삭제합니다. 컨테이너를 삭제하기 전에 컨테이너가 비어 있는지 확인해야 합니다. 컨테이너 안에 오브젝트가 남아 있는 경우 삭제되지 않습니다.

컨테이너 상세 정보

선택한 컨테이너의 상세 정보를 조회합니다. 컨테이너의 기본 정보와 설정 등의 정보를 확인할 수 있습니다.

컨테이너 설정

선택한 컨테이너의 설정을 변경합니다.

분류 항목 설명
기본 설정 컨테이너 접근 정책 PRIVATE: 허가된 사용자만 컨테이너 내부의 오브젝트에 접근할 수 있습니다.
PUBLIC: 공개 URL을 통해 누구나 컨테이너 내부의 오브젝트에 접근할 수 있습니다.
오브젝트 수명 주기 오브젝트의 수명 주기를 일 단위로 입력합니다. 공란으로 두면 수명 주기 설정이 해제됩니다.
오브젝트 수명 주기를 설정한 컨테이너에 업로드한 오브젝트는 설정된 수명 주기가 지난 후 자동으로 삭제됩니다.
오브젝트
버전 관리 정책
버전 관리 정책 버전 관리 정책을 사용으로 설정하면 컨테이너에 저장된 오브젝트를 업데이트 할 때 지정한 컨테이너에 이전 버전을 보관할 수 있습니다.
아카이브 컨테이너 오브젝트의 이전 버전을 보관할 컨테이너를 입력합니다.
아카이빙 오브젝트
수명 주기
오브젝트의 이전 버전의 수명 주기를 일 단위로 입력합니다. 공란으로 두면 수명 주기 설정이 해제됩니다.
수명 주기가 설정된 이후 보관된 오브젝트의 이전 버전은 설정된 수명 주기가 지난 후 자동으로 삭제됩니다.
정적 웹 사이트 설정 인덱스 문서 정적 웹 사이트의 인덱스 문서 오브젝트를 입력합니다. 오브젝트가 폴더 내에 있다면 폴더 경로를 포함해 입력해야 합니다.
오류 문서 정적 웹 사이트의 오류 문서 오브젝트의 접미사(suffix)를 입력합니다. 오류 문서 접미사에는 폴더 경로가 포함될 수 없습니다.

[주의] 버전 관리 정책을 설정했다면 아카이브 컨테이너를 원본 컨테이너보다 먼저 삭제하면 안 됩니다. 원본 컨테이너의 오브젝트가 업데이트 또는 삭제할 때 아카이브 컨테이너에 이전 버전을 저장할 수 없어 오류가 발생하게 됩니다. 아카이브 컨테이너를 먼저 삭제해서 오류가 발생했다면 아카이브 컨테이너를 새로 생성하거나, 원본 컨테이너의 버전 관리 정책을 해제해 문제를 해결할 수 있습니다.


[참고] 컨테이너의 접근 정책을 PUBLIC으로 설정하고 인덱스 문서와 오류 문서를 입력하면 컨테이너에서 정적 웹 사이트 호스팅을 할 수 있습니다. 정적 웹 사이트 URL은 컨테이너 목록에서 URL 복사 버튼을 클릭해 얻을 수 있습니다.


[참고] 정적 웹 사이트의 오류 문서 이름은 {에러 코드}{접미사} 형태입니다. 예를 들어 오류 문서를 error.html로 설정했다면, 404 에러가 발생했을 때 보여줄 오류 문서의 이름은 404error.html이 됩니다. 각 오류 상황에 맞게 오류 문서를 업로드해 사용할 수 있습니다. 오류 문서를 정의하지 않거나, 에러 코드에 맞는 오류 문서 오브젝트가 없다면 웹 브라우저의 기본 오류 문서가 표시됩니다.

오브젝트

폴더 생성

폴더를 생성합니다. 폴더는 컨테이너의 오브젝트를 그룹으로 묶기 위한 가상의 단위입니다. Windows의 폴더나 Linux의 디렉터리와 유사하게 계층적으로 오브젝트를 관리할 수 있도록 도와줍니다. 폴더 이름은 영문 255자, 한글 85자로 제한됩니다.

[참고] 오브젝트 스토리지의 폴더는 파일 시스템이 제공하는 디렉터리와는 개념이 다릅니다. 편의를 위해 제공하는 의사(pseudo) 폴더입니다. 폴더를 생성하면 실제로는 {폴더-이름}/라는 빈 오브젝트가 만들어 집니다. 폴더 안의 오브젝트는 {폴더-이름}/{오브젝트-이름} 형태의 이름을 가집니다. 오브젝트 복사 기능을 이용하여 새로운 폴더로 오브젝트를 복사하면 {폴더-이름}/ 형태의 빈 오브젝트 없이 바로 {폴더-이름}/{오브젝트-이름} 형태의 오브젝트가 만들어집니다. 따라서 이 복사된 오브젝트를 삭제할 경우 폴더까지 삭제된 것처럼 보이게 됩니다. 미리 만든 폴더로 복사할 때는 폴더의 오브젝트를 삭제하더라도 폴더가 남아 있습니다.

폴더 삭제

폴더를 삭제합니다. 폴더를 삭제하기 전에 폴더가 비어 있는지 확인해야 합니다. 폴더 안에 오브젝트가 남아 있는 경우 삭제되지 않습니다.

오브젝트 업로드

모든 오브젝트는 컨테이너 안에 업로드해야 합니다. 오브젝트 하나의 최대 용량은 5GB로 제한됩니다.

[참고] 웹 콘솔에서는 5GB를 초과하는 파일은 업로드할 수 없습니다. 업로드할 오브젝트의 용량이 5GB를 초과한다면 split 등의 명령줄 도구를 사용해 나누거나, 사용자 애플리케이션에서 5GB 이하의 크기로 나누어 업로드하도록 프로그래밍해야 합니다. 자세한 사용 방법은 API 가이드의 멀티파트 업로드를 참고합니다.

오브젝트 다운로드

선택한 오브젝트를 다운로드합니다. 컨테이너를 만들 때 컨테이너 접근 정책을 PRIVATE으로 설정했다면 허용된 사용자만 오브젝트에 접근할 수 있습니다. PUBLIC으로 설정했다면 목록에서 URL 복사 버튼을 클릭해 오브젝트의 공개 URL을 확인할 수 있습니다. 이 URL로 오브젝트의 하이퍼링크를 만들거나, 오브젝트를 직접 다운로드할 수 있습니다.

하이퍼 링크 예시
  • 웹 페이지 작성
  • # cat > index.html
    <html>
    <body> hello world!
    <a href="https://api-storage.cloud.toast.com/v1/{account}/{container}/{object}">Download</a>
    </body>
    </html>
    
  • Python3의 http 모듈을 이용해 웹 서버 실행
  • # python -m http.server
    Serving HTTP on :: port 8000 (http://[::]:8000/) ...
    
  • 웹 브라우저를 통해 http://localhost:8000에 접속한 다음 Download를 클릭하여 정상적으로 파일이 다운로드되는 것을 확인

오브젝트 복사

오브젝트를 복사하여 새로운 오브젝트를 만듭니다. 복사할 오브젝트가 있는 컨테이너에 새로운 이름의 오브젝트를 만들거나, 다른 컨테이너에 오브젝트를 복사할 수 있습니다.

오브젝트 삭제

선택한 오브젝트를 삭제합니다.

접두어 검색

검색 창에 접두어를 입력하고 검색 버튼을 클릭하면 입력한 접두어로 시작하는 컨테이너, 폴더, 오브젝트를 검색할 수 있습니다. 컨테이너 목록에서는 컨테이너를, 오브젝트 목록에서는 폴더와 오브젝트를 검색합니다.

TOP