ページの先頭行へ戻る
Cloud Storage Gateway V1.2.0 リファレンスガイド
FUJITSU Software

1.2.5 ライセンス

1.2.5.1 GET /v1/licenses

機能

ライセンス一覧表示

処理概要

システムに登録されているライセンスを一覧表示します。

ライセンスの合計容量が60TB以上である場合、“total_license_capacity”には登録済みライセンスのうち、本製品として有効な容量の上限である60TBを出力します。

“total_license_capacity_real”には無効な容量が含まれた合計容量を出力します。

パラメーター

パラメーター名

説明

指定

形式

タイプ

token

認証トークン

必須

string

query

filter_cols

フィルターするカラム名を指定します。
“,”で連結して複数のカラムを指定することが可能です。
[例]
id,license_type

任意

string

query

filter_vals

filter_colsで指定したカラム名に対して、指定順にフィルターの条件を指定します。
数値の場合、“~”で範囲を指定することが可能です。
[例]
1~*,REGULAR

任意

string

query

sort_cols

ソートするカラム名を指定します。
[例]
id,license_type

任意

string

query

sort_vals

sort_colsで指定したカラム名に対して、指定順にソートの条件を指定します。

  • 昇順: asc

  • 降順: desc

[例]
asc,asc,desc

任意

string

query

show_cols

表示するカラム名を指定します。
[例]
id,license_type

任意

string

query

hide_cols

非表示にするカラム名を指定します。
[例]
id,license_type

任意

string

query

limit

表示する項目数を指定します。

任意

integer

query

offset

項目の表示開始位置を指定します。

任意

integer

query

ステータスコード

本REST APIの実行が正常終了した場合は、以下のステータスコードで復帰します。

ステータスコードの詳細は、「ステータスコード」を参照してください。

ステータスコードに応じてメッセージが出力されます。メッセージの詳細は、「第2章 メッセージ」を参照してください。

レスポンス詳細

JSON形式のレスポンスとして表示されます。

表示形式は、「1.1.2.2 レスポンス」の「レスポンスボディー」を参照してください。

コード

キー

説明

表示

形式

列挙型定数

200

total_license_capacity

登録済みライセンスのうち本製品として有効な総容量(TB)

Yes

integer

total_license_capacity_real

登録済みライセンスの実際の総容量(TB)

Yes

integer

licenses

ライセンスの個々の情報

Yes

オブジェクトの配列

licenseのオブジェクト配列は以下のとおりです。

1.2.5.2 POST /v1/licenses

機能

ライセンス登録

処理概要

システムにライセンスを登録します。

本API発行前のライセンスの合計容量が60TB以上である場合、ライセンスを新規に登録することはできません。なお、本API発行後にライセンスの合計容量が60TB以上になった場合、60TBが有効なライセンス容量として扱われ、60TB超過分の容量は無効となります。

実行ユーザーのロールが“Monitor”の場合は、実行できません。

パラメーター

パラメーター名

説明

指定

形式

タイプ

token

認証トークン

必須

string

query

license_key

ライセンスキー(0-9A-Fの32文字)です。
[例]
00112233445566778899AABBCCDDEEFF

必須

string

query

ステータスコード

本REST APIの実行が正常終了した場合は、以下のステータスコードで復帰します。

ステータスコードの詳細は、「ステータスコード」を参照してください。

ステータスコードに応じてメッセージが出力されます。メッセージの詳細は、「第2章 メッセージ」を参照してください。

レスポンス詳細

JSON形式のレスポンスとして表示されます。

表示形式は、「1.1.2.2 レスポンス」の「レスポンスボディー」を参照してください。

コード

キー

説明

形式

列挙型定数

200

id

登録ライセンスのID

integer

license_type

ライセンス種別

  • 正規ライセンス

  • トライアルライセンス

enum

REGULAR:
正規ライセンス

TRIAL:
トライアルライセンス

name

ライセンス名称

string

capacity

ライセンス容量(TB)

integer

registration_date

ライセンス登録日
(YYYY-MM-DDThh:mm:ss+hh:mm)

timestamp

expiration_date

ライセンス有効期限
(トライアルの場合だけ)
(YYYY-MM-DDThh:mm:ss+hh:mm)

timestamp

license_validity

ライセンスの有効性

  • true : 有効

  • false : 無効

boolean