Billing Folders를 사용하면 workspace 관리자가 폴더 수준에서 청구 가능한 사용량을 추적하고 관리할 수 있습니다.
Billing Folders는 프리미엄 기능으로, Enterprise 플랜에서 사용할 수 있습니다. Workspace에서 Billing Folders를 사용하려면 Roboflow 영업팀 또는 계정 담당자에게 문의하세요. 제공되는 플랜에 대한 자세한 내용은 요금 페이지.
를 방문하세요. 활성화되면, 모든 사용량(예: training, inference, image storage, labeling 등)은 자동으로 사용 중인 project를 포함하는 folder에 귀속됩니다. 이를 통해 조직은 팀, 부서 또는 고객 전반에 걸쳐 세분화된 비용 가시성과 지출 통제를 할 수 있습니다.
사용량 귀속 방식
Billing Folders가 활성화되면 workspace의 각 folder는 자체 API key를 받습니다. folder 내 project에서 발생하는 모든 과금 대상 사용량은 해당 folder의 API key 기준으로 추적됩니다. 즉, usage reports와 dashboard에서 각 folder가 얼마나 사용 중인지 정확히 확인할 수 있습니다.
사용량 귀속은 자동으로 이루어집니다. 사용량을 folder에 수동으로 할당할 필요가 없습니다. 사용량은 project에서 상위 folder로 전달됩니다.
이미지 저장소 귀속
이미지 저장소는 해당 이미지를 참조하는 project(s)를 포함하는 folder에 귀속됩니다.
이미지가 같은 folder 내의 여러 project에서 공유되거나, 동일한 상위 folder의 하위 folder들에서 공유되는 경우, 저장소는 해당 이미지를 사용하는 모든 project를 포함하는 가장 깊은 folder에 귀속됩니다:
Workspace
├── Folder A
│ ├── Project 1 ← image.jpg
│ └── Project 2 ← image.jpg (공유됨)
└── Folder B
└── Project 3
image.jpg 저장소는 Folder A에 귀속됩니다(이를 참조하는 모든 project를 포함하는 가장 깊은 folder)
이미지가 공통 상위 folder가 없는 서로 다른 root folder의 project들에서 공유되는 경우, 저장소는 workspace 수준에서 귀속됩니다:
Workspace
├── Folder A
│ └── Project 1 ← image.jpg
└── Folder B
└── Project 2 ← image.jpg (공유됨)
image.jpg 저장소는 Workspace에 귀속됩니다(두 project를 모두 포함하는 단일 folder가 없음)
Workspace 관리자는 folder 내의 모든 과금 대상 사용량을 일시적으로 중지할 수 있습니다. 이는 비용을 관리하거나 실수로 인한 사용을 방지하는 데 유용합니다.
Folder 일시 중지
folder를 일시 중지하려면 Folder Settings 모달을 열고 Pause Folder Usage.
를 전환하세요. folder가 일시 중지되면:
해당 folder에 속한 모든 API key가 비활성화됩니다
해당 folder에 대한 사용량이 발생하는 모든 API 요청은 423 Locked 상태 코드로 거부됩니다
해당 folder에 대해 새로운 과금 대상 사용량이 기록되지 않습니다
Pause All Descendant Folders' Usage를 전환하여 folder와 모든 하위 folder의 사용량을 한 번에 일시 중지할 수도 있습니다. 이렇게 하면 선택한 folder와 그 아래에 중첩된 모든 folder의 API key가 비활성화됩니다.
Folder 재개
일시 중지된 folder를 재개하려면 "Folder Settings" 모달로 돌아가 일시 중지 토글을 끄세요. 그러면 해당 folder의 API key가 다시 활성화되고 정상 동작이 복원됩니다. 마찬가지로 folder와 모든 하위 folder를 한 번에 재개할 수도 있습니다.
재개는 folder 일시 중지 기능으로 인해 일시 중지된 key에만 영향을 줍니다. 다른 이유로 비활성화된 key는 영향을 받지 않습니다.
Folder API Keys
Billing Folders가 활성화되면 각 folder는 자동으로 자체 API key를 받습니다. 이러한 key는 과금 대상 사용량이 어느 folder에 속하는지 추적하기 위해 내부적으로 사용됩니다.
키 보기: Folder Settings 모달을 열고 API Keys 탭으로 이동하면 folder와 연결된 API key를 볼 수 있습니다.
자동 생성: API key는 folder가 생성될 때 또는 workspace에서 Billing Folders가 처음 활성화될 때 자동으로 생성됩니다. 수동으로 생성할 필요가 없습니다.
일반적인 시나리오
시나리오
결과
project를 다른 folder로 이동
해당 project의 향후 사용량은 새 folder에 귀속됩니다. 과거 사용량은 원래 folder에 계속 귀속됩니다.
folder 삭제
folder가 workspace에서 제거됩니다. 하위 project와 sub-folder는 상위 folder로 재할당됩니다. 과거 사용량 데이터는 billing report에 보존됩니다.
새 folder 생성
새 folder에는 billing 귀속을 위한 API key가 자동으로 부여됩니다. 추가 설정은 필요하지 않습니다.
Billing Folders 비활성화
folder 수준 귀속이 중지됩니다. 새로운 사용량은 workspace 수준에서만 추적됩니다. folder billing 기간의 과거 사용량 데이터는 보존됩니다.
