リリース・インスタンスを再割り当てできるリリースの取得

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

An icon representing a user. You must have the Manage Software Classification permission to perform this task.
重要: この REST API は、IBM 製品にのみ使用してください。 この REST API は、デフォルトのライセンス・メトリックに割り当てられているインスタンスのみを返します。
表 1. 操作の説明
操作の詳細 「説明」
操作 GET /api/sam/swinventory/targetBundlesOfReleases
目的 要求されたソフトウェア・リリースのインスタンスを再割り当てできる可能性のあるリリースのリストを返します。
HTTP メソッド GET
リソース URI https://server_host_name:port_number/api/sam/swinventory/targetBundlesOfReleases
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/targetBundlesOfReleases エレメントに対して使用できる照会パラメーターを示しています。
表 2. リリース・インスタンスを再割り当てできるリリースを取得するための照会パラメーター
パラメーター 「説明」 必須 値
confirmed_filter バンドル状態の確認。このパラメーターを指定しない場合は、確認済みのソフトウェア・インスタンスと未確認のソフトウェア・インスタンスの両方が表示されます。 いいえ truefalse
endDate ディスカバリーの終了日。このパラメーターを指定しない場合は、現在の日付が使用されます。 いいえ YYYY-MM-DD 形式の日付
name_host_filter ソフトウェア項目がインストールされているコンピューターの名前。 いいえ ストリング
name_server_filter ソフトウェア項目がインストールされているサーバーの名前。 いいえ ストリング
operating_system_filter ソフトウェア項目がインストールされているコンピューターのオペレーティング・システム。 いいえ ストリング
part_number_filter インポートされた部品番号リストに従ってソフトウェア項目に割り当てられた部品番号。 いいえ ストリング
product_release_component_filter ソフトウェア製品、リリース、またはコンポーネントの名前。 いいえ ストリング
releases 固有のリリース ID をコンマで区切ったリスト。 はい 数字
startDate ディスカバリーの開始日。このパラメーターを指定しない場合は、90 日前またはサーバーのインストール日のうち、現在日付に近い方の日付に開始日が設定されます。 いいえ YYYY-MM-DD 形式の日付
token 固有のユーザー認証 ID。
注: このトークンには、ユーザーがアクセス権限を持っているコンピューター・グループに関する情報が含まれています。取得されるデータは、このグループに属するコンピューターからのデータに制限されます。
 はい 英数字

HTTP 会話の例

要求
GET /api/sam/swinventory/targetBundlesOfReleases
?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623
&releases=64050&startDate=2012-09-29&endDate=2012-10-02 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": "72563",
	"isSelected": "false",
	"productInventoryId": "200223",
	"appliedRules": "the relation in the software catalog",
	"productName": "BigFix",
	"id": "72563",
	"branchType": "0",
	"isShared": "false"
}]