Tovanix
Tovanix

오브젝트 스토리지 사용 안내

이 안내는 Tovanix 오브젝트 스토리지의 개통과 사용법을 다룹니다:

  • S3와 호환되며 아웃바운드 트래픽은 따로 과금하지 않습니다. 계정 단위로 구독하며 월 요금에 일정한 저장 용량과 요청 횟수가 포함되고, 넘는 부분은 날마다 잔액에서 정산합니다.
  • 버킷을 만들 때 위치와 스토리지 등급을 고르며, 시스템이 버킷 이름에 접두어를 자동으로 붙여 전체에서 유일하게 만듭니다.
  • 버킷마다 읽기 전용이나 읽기·쓰기 액세스 키를 여러 개 발급할 수 있으며, Secret은 한 번만 보여 주고 새 키는 동기화되기까지 시간이 걸립니다.
  • 콘솔에서 올리고 내려받으며 큰 파일은 자동으로 나누어 올리고, 공개 액세스, CORS, 수명 주기, 마이그레이션, 잠금을 설정할 수 있습니다.
  • 만료 당일부터 읽기 전용이 되고 발급한 키는 폐기되며, 만료 후 7일이 지나도록 갱신하지 않으면 데이터를 비우고 지웁니다.

무엇이고 어떻게 과금하나

오브젝트 스토리지는 S3와 호환됩니다. 버킷마다 독립된 액세스 키를 발급하므로 기존 S3 SDK와 도구를 그대로 연결할 수 있으며, 아웃바운드 트래픽은 따로 과금하지 않습니다. '클라우드 서비스 → 버킷'에서 구매 기간(1, 3, 6, 12개월)을 고르고 '바로 사용 설정'을 누릅니다. 계정 단위로 구독하며, 개통한 뒤 버킷을 여러 개 만들 수 있습니다.

  • 월 요금에는 일정한 저장 용량과 월 요청 횟수가 포함되며 버킷 수에는 상한이 있습니다. 넘는 부분은 저장 용량과 요청 횟수(A 클래스와 B 클래스로 나뉨)에 따라 과금합니다. 정확한 수치는 개통 화면에 표시된 것을 따릅니다.
  • 사용량은 하루에 한 번(UTC 기준 날짜) 수집합니다. '이번 달 초과 요금(예상)'은 수집된 사용량으로 어림한 값이며 월 요금은 들어가지 않습니다.
  • 넘는 부분은 날마다 계정 잔액에서 정산하므로 잔액이 마이너스가 될 수 있으며, 마이너스가 되면 알림을 받습니다. 잔액을 넉넉히 유지하세요.

버킷 만들기

'버킷' 화면에서 '버킷 만들기'를 누릅니다. 이름에는 영문 소문자, 숫자, 하이픈만 쓸 수 있으며, 시스템이 앞에 접두어를 자동으로 붙여 전체에서 유일하게 만들지만 내게는 항상 내가 지은 이름이 보입니다. 위치는 '자동'(시스템이 가까운 곳을 고름)을 고르거나 지역을 직접 지정할 수 있고, 스토리지 등급은 '표준'이나 '저빈도 액세스' 중에서 고릅니다.

버킷 목록에는 버킷마다 사용량, 위치, 스토리지 등급이 나옵니다. 이름을 누르면 상세 화면으로 들어가며, '객체', '액세스 키', '지표', '설정' 네 탭으로 나뉩니다.

액세스 키

  • 버킷의 '액세스 키' 탭에서 '키 발급'을 누르고 권한으로 '읽기·쓰기'나 '읽기 전용'을 고릅니다. 발급한 키는 이 버킷 하나에만 접근할 수 있고 어떤 S3 SDK나 도구에도 넣을 수 있으며, 버킷 하나에 키를 여러 개 발급할 수 있습니다.
  • Secret Access Key는 발급할 때 한 번만 보여 주고 창을 닫으면 다시 볼 수 없으니 바로 복사해 두세요. '설정으로 복사'를 눌러도 됩니다.
  • 새 키가 스토리지 노드에 동기화되기까지 시간이 걸리며, 화면에 대략 몇 초인지 나옵니다. 그동안 호출하면 401이 돌아오는데, 키를 잘못 넣은 것이 아니니 잠시 뒤 다시 시도하면 됩니다.
  • 버킷 '설정'의 '일반'에 S3 엔드포인트와 버킷의 전체 이름이 있으며, 연결할 때 필요합니다. 더 쓰지 않는 키는 '폐기'를 누르세요. 연결 방법과 코드 예제는 오브젝트 스토리지 API 문서(/docs/objstore)를 보세요.

콘솔에서 파일 관리하기

버킷의 '객체' 탭에서 '새 폴더', 파일 '업로드', '폴더 업로드'를 할 수 있고, 내려받기, 링크 복사, 삭제, 이름 접두어로 거르기도 할 수 있습니다. 큰 파일은 자동으로 나누어 올리며, 파일 경로는 최대 1024바이트입니다. 파일이나 폴더를 여러 개 체크하면 한꺼번에 지울 수 있습니다.

버킷을 처음 열 때는 임시 액세스 자격 증명을 준비해야 하며 30초쯤 걸리고, 끝나면 자동으로 이어집니다. '지표' 탭에는 이 버킷의 사용량이 나오며 데이터는 하루에 한 번 갱신되므로, 새로 만든 버킷은 다음 날부터 데이터가 보입니다.

버킷 설정

버킷 상세의 '설정' 탭은 아래 항목으로 나뉩니다.

  • 일반 — 버킷의 전체 이름, S3 엔드포인트, 위치, 스토리지 등급, 만든 시각을 봅니다.
  • 공개 액세스 — 켜면 버킷 안의 모든 객체를 누구나 공개적으로 읽을 수 있습니다. '공개 개발 URL'은 테스트에만 알맞으니 실제로 쓸 때는 '사용자 지정 도메인'을 연결하세요. 사용자 지정 도메인은 내 명의이면서 DNS를 이 플랫폼에서 관리하는 도메인만 연결할 수 있습니다.
  • CORS — 웹 페이지가 이 버킷을 직접 읽고 써야 할 때(프런트엔드에서 바로 올리기, 바로 읽기) CORS를 설정해야 합니다. 출처에는 와일드카드 *를 넣을 수 없습니다.
  • 수명 주기 — 접두어와 일수에 따라 객체를 자동으로 지우거나 저빈도 액세스로 옮기거나, 끝나지 않은 분할 업로드를 정리합니다. 버킷마다 끝나지 않은 분할 업로드를 정리하는 규칙을 하나씩 두기를 권합니다.
  • 마이그레이션 — 다른 곳에 있는 내 S3 버킷에서 접근이 일어날 때마다 데이터를 조금씩 옮겨 옵니다. 이 버킷에 아직 없는 파일을 읽으면 원본 버킷에서 실시간으로 가져와 저장하므로 서비스를 멈출 필요가 없습니다. 원본 버킷의 이름, 지역, 액세스 키를 넣어야 하며 읽기 권한만 있으면 됩니다. 플랫폼은 이 키를 원본 버킷을 읽는 데만 쓰고 보관하지 않습니다. 옮겨 온 데이터는 이 버킷의 저장 용량을 차지하고 요청 횟수에 들어가며, 마이그레이션을 꺼도 이미 옮겨 온 파일은 이 버킷에 남습니다.
  • 잠금 — 보관 기간 동안 접두어에 맞는 파일은 지우거나 덮어쓸 수 없으며, 나도 플랫폼 고객센터도 지울 수 없고 그동안 평소처럼 과금됩니다. 일 단위로 정하며 최대 일수는 화면에 표시된 것을 따르고, 영구 잠금은 제공하지 않습니다.
  • 미완료 업로드 — 큰 파일을 올리다 끊기면 이미 올라간 조각이 남으며, 이 조각은 저장 용량으로 과금되지만 파일 목록에는 나오지 않습니다. 여기서 확인하고 24시간이 지난 조각을 정리할 수 있습니다.
  • 위험 작업 — '버킷 비우기'는 버킷 안의 파일을 모두 지우며 되돌릴 수 없습니다. 버킷을 지우려면 먼저 비워야 하며, 지울 때 이 버킷의 키가 모두 함께 폐기됩니다.

갱신과 만료

  • '버킷' 화면에서 '갱신'을 누르고 기간을 골라 결제합니다. 지금은 자동 갱신이 없으며, 만료 전에 플랫폼이 알림을 보냅니다.
  • 만료 당일부터 버킷은 읽기 전용이 됩니다. 둘러보기, 내려받기, 삭제, 비우기는 여전히 할 수 있지만, 업로드, 설정 변경, 새 버킷 만들기, 새 키 발급은 할 수 없습니다.
  • 만료되면 이미 발급한 액세스 키는 폐기되므로, 갱신한 뒤 다시 발급해야 합니다.

만료 후 7일이 지나도록 갱신하지 않으면 플랫폼이 버킷의 데이터를 비우고 지우며 되돌릴 수 없고, 지운 뒤 알림을 보냅니다. 남겨야 할 데이터는 그 전에 내려받거나 갱신하세요.

자주 나는 문제 가리기

  • 새로 발급한 키로 호출하면 401이 돌아옴 — 새 키가 아직 스토리지 노드에 동기화되는 중 — 화면 안내에 따라 조금 기다린 뒤 다시 시도하고, 키를 거듭 새로 만들지 마세요.
  • 청구에 저장 요금이 있는데 버킷에는 그만큼 파일이 보이지 않음 — 업로드가 끊기며 남은 조각이 있고, 이 조각은 파일 목록에 나오지 않음 — '설정 → 미완료 업로드'에서 확인하고 정리하세요.
  • 버킷 삭제에 실패함 — 버킷에 아직 파일이 있거나, 잠금 기간 중인 파일이 있음 — 먼저 '버킷 비우기'를 하세요. 잠금이 있다고 나오면 '설정 → 잠금'에서 규칙을 보세요. 보관 기간 중인 파일은 기간이 끝나야 지울 수 있습니다.
  • 버킷을 열 때 임시 액세스 자격 증명을 준비하고 있다고 나옴 — 처음 열 때는 임시 자격 증명을 준비해야 함 — 30초쯤 걸리며 끝나면 자동으로 이어지니 화면을 새로 고칠 필요가 없습니다.
  • 버킷 수 상한에 이르렀다고 나옴 — 내 명의의 버킷 수가 상한에 이름 — 더 쓰지 않는 버킷을 지운 뒤 새로 만드세요.
  • 계정 잔액이 마이너스가 됨 — 포함량을 넘는 부분을 날마다 잔액에서 정산함 — 충전해 잔액을 채우세요. '버킷' 화면에서 이번 달 초과 요금 예상을 볼 수 있습니다.

자주 묻는 질문

파일을 내려받으면 트래픽 요금이 따로 붙나요?

붙지 않습니다. 아웃바운드 트래픽은 따로 과금하지 않습니다. 요금은 월 요금, 그리고 포함량을 넘는 저장 용량과 요청 횟수에서 나옵니다.

만료되면 데이터가 바로 지워지나요?

바로 지워지지 않습니다. 만료 당일부터 버킷이 읽기 전용이 되어 내려받기와 정리를 할 수 있고, 만료 후 7일이 지나도록 갱신하지 않아야 비우고 지우며, 되돌릴 수 없습니다.

Secret Access Key를 잃어버렸어요.

발급할 때 한 번만 보여 주므로 잃어버리면 되찾을 수 없습니다. 옛 키를 폐기하고 새 키를 발급하세요.

관련 페이지: 헬프 센터 · 가이드와 자주 묻는 질문 · S3 호환 오브젝트 스토리지 · 오브젝트 스토리지 API

불러오는 중…