機能
ライセンス一覧表示
処理概要
システムに登録されているライセンスを一覧表示します。
ライセンスの合計容量が60TB以上である場合、“total_license_capacity”には登録済みライセンスのうち、本製品として有効な容量の上限である60TBを出力します。
“total_license_capacity_real”には無効な容量が含まれた合計容量を出力します。
パラメーター
パラメーター名 | 説明 | 指定 | 形式 | タイプ |
---|---|---|---|---|
token | 認証トークン | 必須 | string | query |
filter_cols | フィルターするカラム名を指定します。 | 任意 | string | query |
filter_vals | filter_colsで指定したカラム名に対して、指定順にフィルターの条件を指定します。 | 任意 | string | query |
sort_cols | ソートするカラム名を指定します。 | 任意 | string | query |
sort_vals | sort_colsで指定したカラム名に対して、指定順にソートの条件を指定します。
[例] | 任意 | string | query |
show_cols | 表示するカラム名を指定します。 | 任意 | string | query |
hide_cols | 非表示にするカラム名を指定します。 | 任意 | string | query |
limit | 表示する項目数を指定します。 | 任意 | integer | query |
offset | 項目の表示開始位置を指定します。 | 任意 | integer | query |
ステータスコード
本REST APIの実行が正常終了した場合は、以下のステータスコードで復帰します。
200
ステータスコードの詳細は、「ステータスコード」を参照してください。
ステータスコードに応じてメッセージが出力されます。メッセージの詳細は、「第2章 メッセージ」を参照してください。
レスポンス詳細
JSON形式のレスポンスとして表示されます。
単一のオブジェクトを返却
表示形式は、「1.1.2.2 レスポンス」の「レスポンスボディー」を参照してください。
コード | キー | 説明 | 表示 | 形式 | 列挙型定数 |
---|---|---|---|---|---|
200 | total_license_capacity | 登録済みライセンスのうち本製品として有効な総容量(TB) | Yes | integer | |
total_license_capacity_real | 登録済みライセンスの実際の総容量(TB) | Yes | integer | ||
licenses | ライセンスの個々の情報 | Yes | オブジェクトの配列 |
licenseのオブジェクト配列は以下のとおりです。
データを格納するキー名: license
キー | 説明 | 表示 | 形式 | 列挙型定数 |
---|---|---|---|---|
id | 登録ライセンスのID | Yes | integer | |
license_type | ライセンス種別
| Yes | enum | REGULAR: TRIAL: |
name | ライセンス名称 | Yes | string | |
capacity | ライセンス容量(TB) | Yes | integer | |
registration_date | ライセンス登録日 | Yes | timestamp | |
expiration_date | ライセンス有効期限 | Yes | timestamp | |
license_validity | ライセンスの有効性
| Yes | boolean |
機能
ライセンス登録
処理概要
システムにライセンスを登録します。
本API発行前のライセンスの合計容量が60TB以上である場合、ライセンスを新規に登録することはできません。なお、本API発行後にライセンスの合計容量が60TB以上になった場合、60TBが有効なライセンス容量として扱われ、60TB超過分の容量は無効となります。
実行ユーザーのロールが“Monitor”の場合は、実行できません。
パラメーター
パラメーター名 | 説明 | 指定 | 形式 | タイプ |
---|---|---|---|---|
token | 認証トークン | 必須 | string | query |
license_key | ライセンスキー(0-9A-Fの32文字)です。 | 必須 | string | query |
ステータスコード
本REST APIの実行が正常終了した場合は、以下のステータスコードで復帰します。
200
ステータスコードの詳細は、「ステータスコード」を参照してください。
ステータスコードに応じてメッセージが出力されます。メッセージの詳細は、「第2章 メッセージ」を参照してください。
レスポンス詳細
JSON形式のレスポンスとして表示されます。
データを格納するキー名: license
単一のオブジェクトを返却
表示形式は、「1.1.2.2 レスポンス」の「レスポンスボディー」を参照してください。
コード | キー | 説明 | 形式 | 列挙型定数 |
---|---|---|---|---|
200 | id | 登録ライセンスのID | integer | |
license_type | ライセンス種別
| enum | REGULAR: TRIAL: | |
name | ライセンス名称 | string | ||
capacity | ライセンス容量(TB) | integer | ||
registration_date | ライセンス登録日 | timestamp | ||
expiration_date | ライセンス有効期限 | timestamp | ||
license_validity | ライセンスの有効性
| boolean |