Machines - Get

服务:

Service Map

API 版本:

2015-11-01-preview

返回指定的计算机。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/features/serviceMap/machines/{machineName}?api-version=2015-11-01-preview

具有可选参数:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/features/serviceMap/machines/{machineName}?api-version=2015-11-01-preview&timestamp={timestamp}

URI 参数

名称	在	必需	类型	说明
machineName	path	True	string minLength: 3 maxLength: 64	计算机资源名称。
resourceGroupName	path	True	string minLength: 1 maxLength: 64 pattern: [a-zA-Z0-9_-]+	指定 subscriptionId 中的资源组名称。
subscriptionId	path	True	string	Azure 订阅标识符。
workspaceName	path	True	string minLength: 3 maxLength: 63 pattern: [a-zA-Z0-9_][a-zA-Z0-9_-]+[a-zA-Z0-9_]	包含相关资源的 OMS 工作区。
api-version	query	True	string	API 版本。
timestamp	query		string (date-time)	指定一个时间实例相对于计算计算机资源的 UTC 日期和时间。 如果未指定，服务将使用 DateTime.UtcNow。

响应

名称	类型	说明
200 OK	Machine	作已成功完成。
Other Status Codes	ErrorResponse	处理请求时出错。 请参阅 error.code 参数来标识特定错误。

安全性

azure_auth

Azure Active Directory OAuth2 流

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

SMMachinesGetGet

示例请求

HTTP

GET https://management.azure.com/subscriptions/63BE4E24-FDF0-4E9C-9342-6A5D5A359722/resourceGroups/rg-sm/providers/Microsoft.OperationalInsights/workspaces/D6F79F14-E563-469B-84B5-9286D2803B2F/features/serviceMap/machines/m-A4AB1C69-03E9-42D2-B822-B42555569FB4?api-version=2015-11-01-preview&timestamp=2018-01-07T07:01:16.1556059Z

示例响应

状态代码:

200

{
  "kind": "machine",
  "properties": {
    "monitoringState": "monitored",
    "virtualizationState": "unknown",
    "displayName": "my machine"
  },
  "id": "/subscriptions/63BE4E24-FDF0-4E9C-9342-6A5D5A359722/resourceGroups/rg-sm/providers/Microsoft.OperationalInsights/workspaces/D6F79F14-E563-469B-84B5-9286D2803B2F/machines/m-A4AB1C69-03E9-42D2-B822-B42555569FB4",
  "type": "Microsoft.OperationalInsights/workspaces/features/machines",
  "name": "m-A4AB1C69-03E9-42D2-B822-B42555569FB4"
}

定义

名称	说明
Accuracy	指定计算的准确性。
AgentConfiguration	描述计算机上安装的依赖项代理的配置。
AzureCloudServiceConfiguration	介绍 Azure 云服务
AzureCloudServiceRoleType	用于指定 Azure 云服务角色的类型
AzureHostingConfiguration	提供有关如何在 Azure 中托管计算机的信息
AzureServiceFabricClusterConfiguration	介绍 Azure Service Fabric 群集
AzureVmScaleSetConfiguration	介绍 Azure 虚拟机规模集
Bitness	指定计算机或进程的位数。
Error	错误详细信息。
ErrorResponse	API 的错误响应。
HypervisorConfiguration	描述计算机的虚拟机监控程序配置。
HypervisorType	指定计算机的虚拟机监控程序类型。
ImageConfiguration	描述计算机的 VM 映像。
Ipv4NetworkInterface	描述 IPv4 网络接口。
Ipv6NetworkInterface	描述 IPv6 网络接口。
Machine	计算机资源表示发现的计算机系统。 它可以 监视，即依赖项代理在其上运行，或 发现，即通过观察受监视计算机的数据流来推断其存在。 当计算机发生更改时，将保留计算机资源的早期版本并可供访问。 如果某台计算机在间隔期间报告了数据（部件），或者在其他计算机上运行的依赖项代理报告了与计算机关联的活动，则计算机在一段时间内处于实时状态。
MachineRebootStatus	指定自安装依赖项代理以来计算机是否已重新启动。
MachineResourcesConfiguration	描述计算机的资源。
MonitoringState	用于指定是否监视或发现资源。
NetworkConfiguration	描述计算机的网络配置。
OperatingSystemConfiguration	描述计算机的作系统配置。
OperatingSystemFamily	指定作系统系列，例如 Linux、Windows 等。
Timezone	描述时区。
VirtualizationState	指定计算机是物理、虚拟、虚拟机监控程序还是未知计算机。
VirtualMachineConfiguration	描述计算机与虚拟化相关的配置。
VirtualMachineType	指定计算机的虚拟化类型。

Accuracy

枚举

指定计算的准确性。

值	说明
actual
estimated

AgentConfiguration

Object

描述计算机上安装的依赖项代理的配置。

名称	类型	说明
agentId	string	运行状况服务代理唯一标识符。
clockGranularity	integer (int32)	计算机时钟粒度（以毫秒为单位）。
dependencyAgentId	string	依赖项代理唯一标识符。
dependencyAgentRevision	string	依赖项代理修订号。
dependencyAgentVersion	string	依赖项代理版本号。
rebootStatus	MachineRebootStatus	指定自 Dependency Agent 安装以来计算机是否已重新启动。

AzureCloudServiceConfiguration

Object

介绍 Azure 云服务

名称	类型	说明
deployment	string	云服务部署标识符
instanceId	string	云服务实例标识符
name	string	云服务名称
roleName	string	云服务角色名称
roleType	AzureCloudServiceRoleType	用于指定 Azure 云服务角色的类型

AzureCloudServiceRoleType

枚举

用于指定 Azure 云服务角色的类型

值	说明
unknown
worker
web

AzureHostingConfiguration

Object

提供有关如何在 Azure 中托管计算机的信息

名称	类型	说明
cloudService	AzureCloudServiceConfiguration	包含有关作为 Azure 云服务托管的计算机的信息
faultDomain	string	VM 的容错域。
image	ImageConfiguration	计算机的映像。
kind	string: provider:azure	其他托管配置类型限定符。
location	string	VM 的地理位置。
name	string	根据宿主提供程序的计算机名称。
provider	enum: azure	VM 的托管提供程序。
resourceGroup	string	指定订阅中的资源组名称。
resourceId	string	资源的唯一标识符。
serviceFabricCluster	AzureServiceFabricClusterConfiguration	包含有关属于 Azure Service Fabric 群集的计算机的信息
size	string	VM 的大小。
subscriptionId	string	订阅 ID。
updateDomain	string	更新 VM 的域。
vmId	string	虚拟机 ID（唯一标识符）。
vmScaleSet	AzureVmScaleSetConfiguration	包含有关作为 Azure 虚拟机规模集托管的计算机的信息

AzureServiceFabricClusterConfiguration

Object

介绍 Azure Service Fabric 群集

名称	类型	说明
clusterId	string	Service Fabric 群集标识符。
name	string	Service Fabric 群集名称。

AzureVmScaleSetConfiguration

Object

介绍 Azure 虚拟机规模集

名称	类型	说明
deployment	string	虚拟机规模集部署标识符
instanceId	string	虚拟机规模集实例标识符
name	string	虚拟机规模集名称
resourceId	string	资源的唯一标识符。

Bitness

枚举

指定计算机或进程的位数。

值	说明
32bit
64bit

Error

Object

错误详细信息。

名称	类型	说明
code	string	标识特定错误的错误代码。
message	string	调用方区域设置中的错误消息。

ErrorResponse

Object

API 的错误响应。

名称	类型	说明
error	Error	错误信息。

HypervisorConfiguration

Object

描述计算机的虚拟机监控程序配置。

名称	类型	说明
hypervisorType	HypervisorType	指定虚拟机监控程序使用的虚拟化技术（hyperv、vmware 等）
nativeHostMachineId	string	基础虚拟化系统报告的虚拟机监控程序计算机的唯一标识符。

HypervisorType

枚举

指定计算机的虚拟机监控程序类型。

值	说明
unknown
hyperv

ImageConfiguration

Object

描述计算机的 VM 映像。

名称	类型	说明
offering	string	VM 映像的产品/服务。
publisher	string	VM 映像的发布者。
sku	string	VM 映像的 SKU。
version	string	VM 映像的版本。

Ipv4NetworkInterface

Object

描述 IPv4 网络接口。

名称	类型	默认值	说明
ipAddress	string		IPv4 地址。
subnetMask	string	255.255.255.255	IPv4 子网掩码。

Ipv6NetworkInterface

Object

描述 IPv6 网络接口。

名称	类型	说明
ipAddress	string	IPv6 地址。

Machine

Object

计算机资源表示发现的计算机系统。 它可以 监视，即依赖项代理在其上运行，或 发现，即通过观察受监视计算机的数据流来推断其存在。 当计算机发生更改时，将保留计算机资源的早期版本并可供访问。 如果某台计算机在间隔期间报告了数据（部件），或者在其他计算机上运行的依赖项代理报告了与计算机关联的活动，则计算机在一段时间内处于实时状态。

名称	类型	说明
etag	string	资源 ETAG。
id	string	资源标识符。
kind	string: machine	其他资源类型限定符。
name	string	资源名称。
properties.agent	AgentConfiguration	依赖项代理配置。
properties.bootTime	string (date-time)	上次启动计算机的 UTC 日期和时间
properties.computerName	string	计算机的名称，例如服务器
properties.displayName	string	用于显示目的的名称
properties.fullyQualifiedDomainName	string	计算机的完全限定名称，例如 server.company.com
properties.hosting	HostingConfiguration: AzureHostingConfiguration	与托管相关的配置。 如果发现 VM 的托管信息，则存在此情况。
properties.hypervisor	HypervisorConfiguration	与虚拟机监控程序相关的配置。 仅当“virtualizationState”为 hypervisor时显示。
properties.monitoringState	MonitoringState	指定是主动监视还是发现计算机。
properties.networking	NetworkConfiguration	网络配置（ips、网关、dns 等）
properties.operatingSystem	OperatingSystemConfiguration	作系统信息。
properties.resources	MachineResourcesConfiguration	计算机资源（内存、cpu 等）。
properties.timestamp	string (date-time)	在系统中更新此资源的 UTC 日期和时间。
properties.timezone	Timezone	计算机的时区。
properties.virtualMachine	VirtualMachineConfiguration	与虚拟化相关的配置。 仅当 virtualizationStatevirtual时才存在。
properties.virtualizationState	VirtualizationState	指定计算机是否虚拟化。
type	string	资源类型。

MachineRebootStatus

枚举

指定自安装依赖项代理以来计算机是否已重新启动。

值	说明
unknown
rebooted
notRebooted

MachineResourcesConfiguration

Object

描述计算机的资源。

名称	类型	说明
cpuSpeed	integer (int32)	兆赫（Mhz）的 CPU 速度。
cpuSpeedAccuracy	Accuracy	描述 cpuSpeed 字段的准确性。
cpus	integer (int32)	CPU 数。
physicalMemory	integer (int32)	物理内存（MB）。

MonitoringState

枚举

用于指定是否监视或发现资源。

值	说明
monitored
discovered

NetworkConfiguration

Object

描述计算机的网络配置。

名称	类型	说明
defaultIpv4Gateways	string[]	默认 IPv4 网关。
dnsNames	string[]	与计算机关联的 DNS 名称。
ipv4Interfaces	Ipv4NetworkInterface[]	IPv4 接口。
ipv6Interfaces	Ipv6NetworkInterface[]	IPv6 接口。
macAddresses	string[]	所有活动网络接口的 MAC 地址。

OperatingSystemConfiguration

Object

描述计算机的作系统配置。

名称	类型	说明
bitness	Bitness	作系统位（32 位或 64 位）。
family	OperatingSystemFamily	Windows、Linux 等
fullName	string	作系统全名。

OperatingSystemFamily

枚举

指定作系统系列，例如 Linux、Windows 等。

值	说明
unknown
windows
linux
solaris
aix

Timezone

Object

描述时区。

名称	类型	说明
fullName	string	时区全名。

VirtualizationState

枚举

指定计算机是物理、虚拟、虚拟机监控程序还是未知计算机。

值	说明
unknown
physical
virtual
hypervisor

VirtualMachineConfiguration

Object

描述计算机与虚拟化相关的配置。

名称	类型	说明
nativeHostMachineId	string	基础虚拟化系统报告的此虚拟机主机的唯一标识符。
nativeMachineId	string	基础虚拟化系统报告的虚拟机的唯一标识符。
virtualMachineName	string	虚拟机的名称。
virtualMachineType	VirtualMachineType	指定计算机使用的虚拟化技术（hyperv、vmware 等）

VirtualMachineType

枚举

指定计算机的虚拟化类型。

值	说明
unknown
hyperv
ldom
lpar
vmware
virtualPc
xen