リリース用のインスタンスの割り当ての確認
api/sam/swinventory/confirmRelease エレメントに対して POST 操作を使用して、リリース用のインスタンスの割り当てを確認します。
You must have the Manage Software Classification permission to perform this task.重要: この REST API は、BigFix 製品にのみ使用してください。 この REST API は、デフォルトのライセンス・メトリックに割り当てられているインスタンスのみを返します。
| 操作の詳細 | 「説明」 |
|---|---|
| 操作 | api/sam/swinventory/confirmRelease |
| 目的 | リリース用のインスタンスの割り当てを確認します。 |
| HTTP メソッド | POST |
| リソース URI | https://server_host_name:port_number/api/sam/swinventory/confirmRelease |
| URL リンク関係 | n/a |
| URI 照会パラメーター | いいえ |
| 要求ヘッダー |
応答の言語のネゴシエーションに使用されます。このヘッダーを指定しない場合、コンテンツはサーバーの言語で戻されます。 |
| 要求ペイロード | n/a |
要求 Content-Type |
n/a |
| 応答ヘッダー |
応答のコンテンツの言語を指定します。このヘッダーを指定しない場合、コンテンツはサーバーの言語で戻されます。 |
| 応答ペイロード | n/a |
応答 Content-Type |
n/a |
| 正常な HTTP 応答コード |
|
| エラーの HTTP 応答コード |
メッセージの本文にはエラー・メッセージと詳細は含まれません。 |
照会パラメーター
以下の表は、
POST/swinventory/confirmRelease エレメントに対して使用できる照会パラメーターを示しています。| パラメーター | 「説明」 | 必須 | 値 |
|---|---|---|---|
| endDate | ディスカバリーの終了日。このパラメーターを指定しない場合は、現在の日付が使用されます。 | いいえ | YYYY-MM-DD 形式の日付 |
| name_host_filter | ソフトウェア項目がインストールされているコンピューターの名前 | いいえ | ストリング |
| name_server_filter | ソフトウェア項目がインストールされているサーバーの名前 | いいえ | ストリング |
| operating_system_filter | ソフトウェア項目がインストールされているコンピューターのオペレーティング・システム | いいえ | ストリング |
| part_number_filter | インポートされた部品番号リストに従ってソフトウェア項目に割り当てられた部品番号。 | いいえ | ストリング |
| product_release_component_filter | ソフトウェア製品、ソフトウェア・リリース、またはコンポーネントの名前 | いいえ | ストリング |
| releases | 固有のリリース ID のリスト。各 ID はコンマで区切られます。ID を少なくとも 1 つを入力する必要があります。 | はい | 数字 |
| startDate | ディスカバリーの開始日。このパラメーターを指定しない場合は、署名済み監査レポートの対象期間外の最初の日付が使用されます。署名済みのレポートがない場合は、サーバーのインストールの日付が使用されます。 | いいえ | YYYY-MM-DD 形式の日付 |
| token | 固有のユーザー認証 ID。 | はい | 英数字 |
HTTP 会話の例
- 要求
POST /api/sam/swinventory/confirmRelease ?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623&releases=95185 &startDate=2012-10-18&endDate=2013-01-26 HTTP/1.1 Host: localhost:9080 Accept-Language: en-US- 応答ヘッダー
HTTP/1.1 204 OK Content-Type: application/json Content-Language: en-US