vm_products
SIDfm プロダクトとローカルプロダクトを一括取得するためのエンドポイントです。
| エンドポイント | vm_products |
| 機能 | SIDfm プロダクトとローカルプロダクトを一括取得 |
| 実装バージョン | 2.9.0 |
| 認証 | 有り |
| HTTP メソッド | GET/POST |
パラメータ
| 入力値 | 機能 | 入力値の型 | デフォルト値 | ||||||
|---|---|---|---|---|---|---|---|---|---|
| q[api_key] |
パラメータで認証を行う場合に API キーを指定します。 X-API-Key としてリクエストヘッダに API キーを設定した場合は、このパラメータは X-API-Key での認証に失敗した場合にのみ参照されます。 |
String | なし | ||||||
| q[offset] | 取得するデータの先頭位置を指定します。 | Number | 0 | ||||||
| q[per_page] |
1～200 の値で、1 度に取得するデータの数を指定します。指定した値が 1～200 を超えている場合は 10 として扱われます。 ※ 全データ数の指定は不可です。 |
Number | 10 | ||||||
| q[order] |
一覧データのソート順を指定します。 下記の文字列に _asc を付けると昇順、_desc を付けると降順となります。(例: name_asc)
|
String | name_asc | ||||||
| q[filters][name] | 取得するプロダクトを名前で絞り込みます。 | String | なし | ||||||
| q[filters][is_support_end] | 取得するプロダクトをサポート終了状況で絞り込みます。true, false で指定します。 | Boolean | なし | ||||||
| q[filters][version] | 取得するプロダクトをバージョンで絞り込みます。 | Number | なし |
レスポンス
| key | value の内容 | value の型 |
|---|---|---|
| success | 認証の成否 | Boolean |
| response | エラー等の補足情報 | Hash |
| total_size | 取得した履歴の数 | Number |
| products | プロダクト一覧 | Array<Hash> |
| name | プロダクト名 | String |
| is_support_end | プロダクトのサポート終了状況 | Boolean |
| is_local | ローカルプロダクトの場合 true、SIDfm プロダクトの場合 false | Boolean |
| versions | プロダクトのバージョン一覧 | Hash |
| fullname | バージョン名 | String |
| is_support_end | バージョンのサポート終了状況 | Boolean |
| is_local | ローカルプロダクトの場合 true、SIDfm プロダクトの場合 false | Boolean |
レスポンス例
"{
""success""=>true,
""response""=>{},
""vm_products""=>[
{
""id""=>3276,
""name""=>""A10 Networks ACOS"",
""is_support_end""=>false,
""is_local""=>false,
""versions""=>[
{
""fullname""=>""A10 Networks ACOS 4.1.x"",
""is_support_end""=>false,
""is_local""=>false
}
}
}
}