通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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 Flow

类型: oauth2
流向: implicit
授权 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 资源管理器 API 的常见错误响应，以返回失败操作的错误详细信息。 （这也遵循 OData 错误响应格式）。
CloudErrorBody

错误详细信息。
EndOfSupportStatus

支持状态结束。
ErrorAdditionalInfo

资源管理错误附加信息。
Software

表示软件数据

CloudError

所有 Azure 资源管理器 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

资源类型