リリースのリストを対象とした製品へのインスタンスの再割り当て

api/sam/swinventory/reassignRelease エレメントで POST 操作を使用することにより、リリースのリストを対象として、製品にインスタンスを再割り当てします。

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

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

表 1. 操作の説明
操作の詳細	「説明」
操作	`/api/sam/swinventory/reassignRelease`
目的	リリースのリストを対象として製品にインスタンスを再割り当てします。
HTTP メソッド	`POST`
リソース URI	https://`server_host_name`:`port_number`/api/sam/swinventory/reassignRelease
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/reassignRelease エレメントに対して使用できる照会パラメーターを示しています。

表 2. リリースに再割り当てするインスタンスを取得するための照会パラメーター
表は、4 つの列と 10 の行から成ります。
パラメーター	「説明」	必須	値
endDate	ディスカバリーの終了日。このパラメーターを指定しない場合は、現在の日付が使用されます。	いいえ	YYYY-MM-DD 形式の日付
name_host_filter	ソフトウェア項目がインストールされているコンピューターの名前。	いいえ	ストリング
name_server_filter	ソフトウェア項目がインストールされているサーバーの名前。	いいえ	ストリング
operating_system_filter	ソフトウェア項目がインストールされているコンピューターのオペレーティング・システム。	いいえ	ストリング
part_number_filter	インポートされた部品番号リストに従ってソフトウェア項目に割り当てられた部品番号。	いいえ	ストリング
product_release_component_filter	ソフトウェア製品、リリース、またはコンポーネントの名前。	いいえ	ストリング
productId	インスタンスの割り当て先となる製品の固有 ID。製品 ID を取得するには、`swinventory/targetBundlesOfReleases` エレメントに対して `GET` 操作を使用します。	はい	数字
releases	固有のリリース ID をコンマで区切ったリスト。ID は少なくとも 1 つ指定する必要があります。	はい	数字
startDate	ディスカバリーの開始日。このパラメーターを指定しない場合は、署名済み監査レポートの対象期間外の最初の日付が使用されます。署名済みのレポートがない場合は、サーバーのインストールの日付が使用されます。	いいえ	YYYY-MM-DD 形式の日付
token	固有のユーザー認証 ID。	はい	英数字

HTTP 会話の例

要求

POST /api/sam/swinventory/reassignRelease
?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623
&releases=67757,95947&productId=67756&startDate=2012-09-29&endDate=2012-10-02
Host: localhost:9080
Accept-Language: en-US

応答ヘッダー

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