Billing Folders

Billing Folders を使うと、Workspace 管理者はフォルダー単位で請求対象の利用状況を追跡・管理できます。

Billing Foldersは プレミアム Enterpriseプランで利用できる機能です。WorkspaceでBilling Foldersを有効にするには、 Roboflow sales team または担当アカウント担当者にお問い合わせください。利用可能なプランの詳細については、 pricing page.

有効にすると、すべての使用量（例: 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へと引き継がれます。

Image Storageの割り当て

image storageは、そのimageを参照しているprojectを含むfolderに割り当てられます。

同じfolder内の複数のproject、または同じ親を持つサブfolder内の複数のprojectでimageが共有されている場合、storageは、そのimageを使用しているすべてのprojectを含む最も深いfolderに割り当てられます:

Workspace
├── Folder A
│   ├── Project 1  ← image.jpg
│   └── Project 2  ← image.jpg (共有)
└── Folder B
    └── Project 3

image.jpg のstorageは Folder A に割り当てられます（それを参照するすべてのprojectを含む最も深いfolder）

異なるroot folder内のproject間で、共通の親folderなしにimageが共有されている場合、storageはworkspaceレベルで割り当てられます:

Workspace
├── Folder A
│   └── Project 1  ← image.jpg
└── Folder B
    └── Project 2  ← image.jpg (共有)

image.jpg のstorageは Workspace に割り当てられます（両方のprojectを含む単一のfolderがないため）

使用量の表示

workspaceのcredit usage pageでfolder別の内訳を含む使用量を確認でき、割り当てフィルターを Foldersに切り替えられます。 billing folderへの使用量のフィルター方法 または 使用量の一般的な表示方法をご確認ください。

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の一時停止機能によって停止されたkeyにのみ影響します。ほかの理由で無効化されたkeyには影響しません。

Folder API Keys

Billing Foldersが有効になると、各folderに自動的に独自のAPI keyが付与されます。これらのkeyは、請求対象の使用量がどのfolderに属するかを内部的に追跡するために使用されます。

• keyの表示: Folder Settingsモーダルを開き、API Keysタブに移動すると、folderに関連付けられたAPI keyを確認できます。

• 自動作成: folderの作成時、またはWorkspaceでBilling Foldersが最初に有効化されたときに、API keyは自動的に作成されます。手動で作成する必要はありません。

一般的なシナリオ

シナリオ	起こること
projectを別のfolderに移動する	そのprojectの今後の使用量は新しいfolderに割り当てられます。過去の使用量は元のfolderに割り当てられたままです。
folderを削除する	folderはworkspaceから削除されます。子projectとサブfolderは親folderに再割り当てされます。過去の使用量データはbilling reportsに保持されます。
新しいfolderを作成する	新しいfolderには、請求の割り当て用のAPI keyが自動的に付与されます。追加の設定は不要です。
Billing Foldersを無効化する	folderレベルの割り当ては停止します。新しい使用量はworkspaceレベルでのみ追跡されます。folderのbilling期間中の過去の使用量データは保持されます。

Usage Report API

次のものを使用して、請求の使用量データをプログラムから問い合わせできます: billing usage report REST API.