次の方法で共有

Software Inventories - Get

  • リファレンス
サービス:
Defender for Cloud
API バージョン:
2021-05-01-preview

仮想マシンの単一のソフトウェア データを取得します。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceNamespace}/{resourceType}/{resourceName}/providers/Microsoft.Security/softwareInventories/{softwareName}?api-version=2021-05-01-preview

URI パラメーター

名前 / 必須 型 説明
resourceGroupName
 path True

string

ユーザーのサブスクリプション内のリソース グループの名前。 名前では大文字と小文字が区別されません。

正規表現パターン: ^[-\w\._\(\)]+$
resourceName
 path True

string

リソースの名前。
resourceNamespace
 path True

string

リソースの名前空間。
resourceType
 path True

string

リソースの種類。
softwareName
 path True

string

インストールされているソフトウェアの名前。
subscriptionId
 path True

string

Azure サブスクリプション ID

正規表現パターン: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$
api-version
 query True

string

操作の API バージョン

応答

名前 型 説明
200 OK

Software

わかりました
Other Status Codes

CloudError

操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
user_impersonation ユーザー アカウントを偽装する

例

Gets a single software data of the virtual machine

要求のサンプル

GET https://management.azure.com/subscriptions/e5d1b86c-3051-44d5-8802-aa65d45a279b/resourceGroups/EITAN-TESTS/providers/Microsoft.Compute/virtualMachines/Eitan-Test1/providers/Microsoft.Security/softwareInventories/outlook_16.0.10371.20060?api-version=2021-05-01-preview

応答のサンプル

状態コード:
200 
{
  "id": "/subscriptions/e5d1b86c-3051-44d5-8802-aa65d45a279b/resourcegroups/EITAN-TESTS/providers/Microsoft.Compute/virtualMachines/Eitan-Test1/providers/Microsoft.Security/softwareInventories/outlook_16.0.10371.20060",
  "name": "outlook_16.0.10371.20060",
  "type": "Microsoft.Security/softwareInventories",
  "properties": {
    "deviceId": "7bd19ed6b07553e52a2844451bcec68d25963a53",
    "osPlatform": "Windows10",
    "vendor": "microsoft",
    "softwareName": "outlook",
    "version": "16.0.10371.20060",
    "endOfSupportStatus": "None",
    "numberOfKnownVulnerabilities": 0,
    "firstSeenAt": "2021-01-26 15:48:56"
  }
}

定義

名前 説明
CloudError

失敗した操作のエラーの詳細を返す、すべての Azure Resource Manager API の一般的なエラー応答。 (これは、OData エラー応答形式にも従います)。
CloudErrorBody

エラーの詳細。
EndOfSupportStatus

サポート終了の状態。
ErrorAdditionalInfo

リソース管理エラーの追加情報。
Software

ソフトウェア データを表します

CloudError

失敗した操作のエラーの詳細を返す、すべての Azure Resource Manager API の一般的なエラー応答。 (これは、OData エラー応答形式にも従います)。

名前 型 説明
error.additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。
error.code

string

エラー コード。
error.details

CloudErrorBody[]

エラーの詳細。
error.message

string

エラー メッセージ。
error.target

string

エラーターゲット。

CloudErrorBody

エラーの詳細。

名前 型 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。
code

string

エラー コード。
details

CloudErrorBody[]

エラーの詳細。
message

string

エラー メッセージ。
target

string

エラーターゲット。

EndOfSupportStatus

サポート終了の状態。

名前 型 説明
None

string

noLongerSupported

string

upcomingNoLongerSupported

string

upcomingVersionNoLongerSupported

string

versionNoLongerSupported

string

ErrorAdditionalInfo

リソース管理エラーの追加情報。

名前 型 説明
info

object

追加情報。
type

string

追加情報の種類。

Software

ソフトウェア データを表します

名前 型 説明
id

string

リソース ID
name

string

リソース名
properties.deviceId

string

サービス内の仮想マシンの一意識別子。
properties.endOfSupportDate

string

製品が今後サポート終了となる場合のサポート終了日。
properties.endOfSupportStatus

EndOfSupportStatus

サポート終了の状態。
properties.firstSeenAt

string

初めてソフトウェアがデバイスに表示されました。
properties.numberOfKnownVulnerabilities

integer

弱点の数。
properties.osPlatform

string

デバイスで実行されているオペレーティング システムのプラットフォーム。
properties.softwareName

string

ソフトウェア製品の名前。
properties.vendor

string

ソフトウェア ベンダーの名前。
properties.version

string

ソフトウェア製品のバージョン番号。
type

string

リソースの種類