リリースに再割り当てするインスタンスの取得
特定のリリースに再割り当てできるターゲット・インスタンスに関する情報を要求するには、api/sam/swinventory/targetInstances
エレメントに対して GET
操作を使用します。
You must have the Manage Software Classification permission to perform this task.
重要: この REST API は、IBM 製品にのみ使用してください。 この REST API は、デフォルトのライセンス・メトリックに割り当てられているインスタンスのみを返します。
操作の詳細 | 「説明」 |
---|---|
操作 | GET /api/sam/swinventory/targetInstances |
目的 | 特定のリリースに再割り当てできるターゲット・インスタンスのリストを返します。 |
HTTP メソッド | GET |
リソース URI | https://server_host_name:port_number/api/sam/swinventory/targetInstances |
URL リンク関係 | n/a |
URI 照会パラメーター | 適用可能な照会パラメーターのリストについては、以下を参照してください。照会パラメーター。 |
要求ヘッダー |
応答の言語のネゴシエーションに使用されます。このヘッダーを指定しない場合、コンテンツはサーバーの言語で戻されます。 |
要求ペイロード | n/a |
要求 Content-Type |
|
応答ヘッダー |
応答のコンテンツ・タイプを指定します。 |
応答のコンテンツの言語を指定します。このヘッダーを指定しない場合、コンテンツはサーバーの言語で戻されます。 |
|
応答ペイロード | targetInstances element |
応答 Content-Type |
|
正常な HTTP 応答コード |
|
エラーの HTTP 応答コード |
メッセージの本文にはエラー・メッセージと詳細が含まれます。 |
照会パラメーター
照会パラメーターは、検索結果の絞り込みに使用できます。以下の表は、
GET/swinventory/targetInstances
エレメントに対して使用できる照会パラメーターを示しています。パラメーター | 「説明」 | 必須 | 値 |
---|---|---|---|
releaseId | リリースの固有 ID。 | はい | 数字 |
token | 固有のユーザー認証 ID。 注: このトークンには、ユーザーがアクセス権限を持っているコンピューター・グループに関する情報が含まれています。取得されるデータは、このグループに属するコンピューターからのデータに制限されます。 |
はい | 英数字 |
HTTP 会話の例
- 要求
GET /api/sam/swinventory/targetInstances ?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623&releaseId=72717 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)
[{ "componentNameVersion": "BigFix Tivoli Directory Server (SP) 6.0", "hostname": "Agent20", "path": "C:\Documents and Settings\Administrator\Signatures", "updateTime": "1349270690593", "productInventoryId": "200027", "appliedRules": "the relation in the software catalog, the infrastructure co-location", "productId": "72717", "id": "200027", "productNameVersion": "IBM WebSphere Process Server Hypervisor Edition for Novell SLES for x86 6.2", "isShared": "false" }]