製品へのインスタンスの再割り当て
api/sam/swinventory/reassign
エレメントで POST
操作を使用して、インスタンスを別の製品に再割り当てします。
You must have the Manage Software Classification permission to perform this task.
重要: この REST API は、BigFix 製品にのみ使用してください。 この REST API は、デフォルトのライセンス・メトリックに割り当てられているインスタンスのみを返します。
操作の詳細 | 「説明」 |
---|---|
操作 | /api/sam/swinventory/reassign |
目的 | 別の製品にインスタンスを再割り当てします。 |
HTTP メソッド | POST |
リソース URI | https://server_host_name:port_number/api/sam/swinventory/reassign |
URL リンク関係 | n/a |
URI 照会パラメーター | 適用可能な照会パラメーターのリストについては、以下を参照してください。「照会パラメーター」。 |
要求ヘッダー |
応答の言語のネゴシエーションに使用されます。このヘッダーを指定しない場合、コンテンツはサーバーの言語で戻されます。 |
要求ペイロード | n/a |
要求 Content-Type |
n/a |
応答ヘッダー |
応答のコンテンツの言語を指定します。このヘッダーを指定しない場合、コンテンツはサーバーの言語で戻されます。 |
応答ペイロード | n/a |
応答 Content-Type |
n/a |
正常な HTTP 応答コード |
|
エラーの HTTP 応答コード |
メッセージの本文にはエラー・メッセージと詳細は含まれません。 |
照会パラメーター
照会パラメーターは、検索結果の絞り込みに使用できます。以下の表は、
POST/swinventory/reassign
エレメントに対して使用できる照会パラメーターを示しています。パラメーター | 「説明」 | 必須 | 値 |
---|---|---|---|
productId | インスタンスの再割り当て先となる製品の固有 ID。 製品 ID を取得するには、 |
はい | 数字 |
productInventoryId | 製品に再割り当てされるインスタンスの固有 ID をコンマで区切ったリスト。ID は少なくとも 1 つ指定する必要があります。 | はい | 数字 |
updateTime | インスタンスの最終変更時刻をミリ秒単位で表したタイム・スタンプのリスト。タイム・スタンプはコンマで区切られます。リスト内の最初のタイム・スタンプは最初のインスタンスに対応し、以降も同様です。このパラメーターは、並行するアクションの処理に使用されます。
|
はい | 数字 |
token | 固有のユーザー認証 ID。 | はい | 英数字 |
HTTP 会話の例
- 要求
POST /api/sam/swinventory/reassign?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623 &productInventoryId=200027,300001&productId=72786&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