リリース用のインスタンスの割り当ての確認

POST エレメントに対して api/sam/swinventory/confirmRelease 操作を使用して、リリース用のインスタンスの割り当てを確認します。

An icon representing a user. You must have the Manage Software Classification permission to perform this task.
重要: この REST API は BigFix 製品にのみ使用してください。この REST API は、デフォルトのライセンス・メトリックに割り当てられたインスタンスのみを返します。
操作の詳細 説明
操作 api/sam/swinventory/confirmRelease
目的 リリース用のインスタンスの割り当てを確認します。
HTTP メソッド POST
リソース URI https://server_host_name:port_number/api/sam/swinventory/confirmRelease
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/confirmRelease エレメントに対して使用できる照会パラメーターを示しています。
パラメーター 説明 必須 値
endDate ディスカバリーの終了日。このパラメーターを指定しない場合は、現在の日付が使用されます。 なし YYYY-MM-DD 形式の日付
name_host_filter ソフトウェア項目がインストールされているコンピューターの名前 なし 文字列
name_server_filter ソフトウェア項目がインストールされているサーバーの名前 なし 文字列
operating_system_filter ソフトウェア項目がインストールされているコンピューターのオペレーティング・システム なし 文字列
part_number_filter インポートされた部品番号リストに従ってソフトウェア項目に割り当てられた部品番号。 なし 文字列
product_release_component_filter ソフトウェア製品、ソフトウェア・リリース、またはコンポーネントの名前 なし 文字列
releases 固有のリリース ID のリスト。各 ID はコンマで区切られます。ID を少なくとも 1 つを入力する必要があります。 あり 数字
startDate ディスカバリーの開始日。このパラメーターを指定しない場合は、署名済み監査レポートの対象期間外の最初の日付が使用されます。署名済みのレポートがない場合は、サーバーのインストールの日付が使用されます。 なし YYYY-MM-DD 形式の日付
token 固有のユーザー認証 ID。 あり 英数字

HTTP 会話の例

要求
POST /api/sam/swinventory/confirmRelease
?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623&releases=95185
&startDate=2012-10-18&endDate=2013-01-26 HTTP/1.1
Host: localhost:9080
Accept-Language: en-US
応答ヘッダー
HTTP/1.1 204 OK
Content-Type: application/json
Content-Language: en-US