ライセンス
license カテゴリの 1 個の API オペレーションを扱います。
| メソッド | パス | 説明 |
|---|---|---|
| GET | /v1/license | このインストールのライセンス、その状態、上限に対する現在の数 |
GET /v1/license
ダッシュボードのフッターと runlot license が読み取る情報です(docs/onprem-delivery.md §6.5)。
サインインしているユーザーなら誰でも呼び出せます。認証情報は /v1/me と同じ bearer 資格情報です。管理者専用にしていない理由は、フッターがすべてのページで全員に表示されることと、ライセンスが実際に頼っている抑止力が、顧客自身の名前がすべての画面に表示されることだからです(§6.8)。ここにシークレットはありません。署名は返されず、ライセンスファイルのパスも返されません。
SaaS、およびライセンスファイルが設定されていないデプロイでは、応答は onPrem: false、state: "none"、上限はすべてゼロとなり、どの画面にも何も表示されません。state が欠けることはありません。ライセンスが見つからない・解析できない・猶予期間を過ぎて失効している場合は、理由とともに restricted になります。ライセンスの問題が「ライセンス機能なし」と表示されてしまうと、誰も報告しなくなるためです。
operationId getLicense
| ステータスコード | 説明 | レスポンスボディ |
|---|---|---|
| 200 | このインストールが現在読み取っているライセンス | License |
| 401 | — | — |