バンドルまたは割り当てを行うインスタンスの確認

api/sam/swinventory/confirm エレメントに対して POST 操作を使用して、インスタンスのバンドルまたは割り当てを確認します。

You must have the Manage Software Classification permission to perform this task.

重要: この REST API は、BigFix 製品にのみ使用してください。この REST API は、デフォルトのライセンス・メトリックに割り当てられているインスタンスのみを返します。

表 1. 操作の説明
操作の詳細	「説明」
操作	`/api/sam/swinventory/confirm`
目的	インスタンスのバンドルまたは割り当てを確認します。
HTTP メソッド	`POST`
リソース URI	https://`server_host_name`:`port_number`/api/sam/swinventory/confirm
URL リンク関係	n/a
URI 照会パラメーター	適用可能な照会パラメーターのリストについては、以下を参照してください。「照会パラメーター」。
要求ヘッダー	ヘッダー `Accept-Language` (オプション) 値 en-US (英語のみをサポート) 応答の言語のネゴシエーションに使用されます。このヘッダーを指定しない場合、コンテンツはサーバーの言語で戻されます。
要求ペイロード	n/a
要求 `Content-Type`	n/a
応答ヘッダー	ヘッダー `Content-Language` 値 en-US, … 応答のコンテンツの言語を指定します。このヘッダーを指定しない場合、コンテンツはサーバーの言語で戻されます。
応答ペイロード	n/a
応答 `Content-Type`	n/a
正常な HTTP 応答コード	`204 – No content`
エラーの HTTP 応答コード	`400 – “Bad Request”` 照会パラメーターにエラーがあるか、照会パラメーターが欠落している場合 `401 – “Unauthorized”` ユーザーにこの操作の実行が許可されていない場合 `404 – “Not Found”` ユーザーが要求した製品またはバージョンのリリースまたはインスタンスが存在しない場合 `422 – “Unprocessable Entity”` 要求の形式は正しいが、意味エラーのために要求に従うことができない場合メッセージの本文にはエラー・メッセージと詳細は含まれません。

照会パラメーター

照会パラメーターは、検索結果の絞り込みに使用できます。以下の表は、POST/swinventory/confirm エレメントに対して使用できる照会パラメーターを示しています。

表 2. インスタンスを確認するための照会パラメーター
パラメーター	「説明」	必須	値
productInventoryId	確認するインスタンスの固有 ID をコンマで区切ったリスト。ID は少なくとも 1 つ指定する必要があります。	はい	数字
updateTime	インスタンスの最終変更時刻をミリ秒単位で表したタイム・スタンプのリスト。タイム・スタンプはコンマで区切られます。リスト内の最初のタイム・スタンプは最初のインスタンスに対応し、以降も同様です。このパラメーターは、並行するアクションの処理に使用されます。 `swinventory/release/{release_id}/instances` エレメントに対して `GET` 操作を使用すると、更新時刻が取得されます。	はい	数字
token	固有のユーザー認証 ID。	はい	英数字

HTTP 会話の例

要求

POST /api/sam/swinventory/confirm?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623
&productInventoryId=200027,300001&updateTime=1349237658578,1349237658588 HTTP/1.1
Host: localhost:9080
Accept-Language: en-US

応答ヘッダー

HTTP/1.1 204 OK
Content-Type: application/json
Content-Language: en-US