ソフトウェア・インスタンスを再割り当てできるリリースの取得

要求されたソフトウェア・インスタンスを再割り当てできるリリースに関する情報を要求するには、api/sam/swinventory/targetBundlesOfInstances エレメントに対して GET 操作を使用します。

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

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

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

照会パラメーター

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

表 2. ソフトウェア・インスタンスを再割り当てできるリリースを取得するための照会パラメーター
パラメーター	「説明」	必須	値
productInventoryId	固有の製品 ID をコンマで区切ったリスト。	はい	数字
token	固有のユーザー認証 ID。注: このトークンには、ユーザーがアクセス権限を持っているコンピューター・グループに関する情報が含まれています。取得されるデータは、このグループに属するコンピューターからのデータに制限されます。	はい	英数字

HTTP 会話の例

要求

GET /api/sam/swinventory/targetBundlesOfInstances
?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623&productInventoryId=200032 HTTP/1.1
Host: localhost:9080
Accept: application/json
Accept-Language: en-US

応答ヘッダー

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

応答の本文 (JSON)

[{
	"productId": "69558",
	"isSelected": "false",
	"productInventoryId": "200032",
	"appliedRules": "the relation in the software catalog,
	the stand-alone product discovery",
	"productName": "BigFix Smart Analytics System 2050 Departmental Base Remote Standby Server 1.0",
	"id": "69558",
	"branchType": "0",
	"isShared": "false"
}]