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

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

An icon representing a user. 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 該当なし
応答ヘッダー
ヘッダー
Content-Language
値
en-US, …

応答のコンテンツの言語を指定します。このヘッダーを指定しない場合、コンテンツはサーバーの言語で戻されます。
応答ペイロード 該当なし
応答 Content-Type 該当なし
正常な 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 を取得するには、GET エレメントに対して swinventory/targetBundlesOfReleases 操作を使用します。

 あり 数字
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