Machines - Get

Service:

Service Map

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

With optional parameters:

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	Имя ресурса компьютера.
resourceGroupName	path	True	string	Имя группы ресурсов в указанном subscriptionId. Regex pattern: [a-zA-Z0-9_-]+
subscriptionId	path	True	string	Идентификатор подписки Azure.
workspaceName	path	True	string	Рабочая область OMS, содержащая интересующие вас ресурсы. Regex pattern: [a-zA-Z0-9_][a-zA-Z0-9_-]+[a-zA-Z0-9_]
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

Поток OAuth2 в Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

SMMachinesGetGet

Sample Request

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

Sample Response

Status code:

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	Описывает образ виртуальной машины.
Ipv4NetworkInterface	Описывает сетевой интерфейс IPv4.
Ipv6NetworkInterface	Описывает сетевой интерфейс IPv6.
Machine	Ресурс компьютера представляет обнаруженную компьютерную систему. Его можно отслеживать, т. е. на нем запущен агент зависимостей, или обнаруживать, т. е. его существование было выведено путем наблюдения за потоком данных с отслеживаемых компьютеров. По мере изменения компьютеров предыдущие версии ресурса компьютера сохраняются и становятся доступными для доступа. Компьютер работает в течение определенного интервала времени, если его агент зависимостей передал данные в течение (части) этого интервала, или агент зависимостей, работающий на других компьютерах, сообщил о действиях, связанных с компьютером.
MachineRebootStatus	Указывает, был ли компьютер перезагружен после установки агента зависимостей.
MachineResourcesConfiguration	Описывает ресурсы компьютера.
MonitoringState	Используется для указания того, отслеживаются или обнаруживаются ресурсы.
NetworkConfiguration	Описывает сетевую конфигурацию компьютера.
OperatingSystemConfiguration	Описывает конфигурацию операционной системы компьютера.
OperatingSystemFamily	Указывает семейство операционных систем, например Linux, Windows и т. д.
Timezone	Описывает часовой пояс.
VirtualizationState	Указывает, является ли компьютер физическим, виртуальным, гипервизором или неизвестным.
VirtualMachineConfiguration	Описывает конфигурацию компьютера, связанную с виртуализацией.
VirtualMachineType	Указывает тип виртуализации компьютера.

Accuracy

Указывает точность вычисления.

Имя	Тип	Описание
actual	string
estimated	string

AgentConfiguration

Описывает конфигурацию агента зависимостей, установленного на компьютере.

Имя	Тип	Описание
agentId	string	Уникальный идентификатор агента службы работоспособности.
clockGranularity	integer	Степень детализации машинных часов в миллисекундах.
dependencyAgentId	string	Уникальный идентификатор агента зависимостей.
dependencyAgentRevision	string	Номер редакции агента зависимостей.
dependencyAgentVersion	string	Номер версии агента зависимостей.
rebootStatus	MachineRebootStatus	Указывает, был ли компьютер перезагружен после установки агента зависимостей.

AzureCloudServiceConfiguration

Описание облачной службы Azure

Имя	Тип	Описание
deployment	string	Идентификатор развертывания облачной службы
instanceId	string	Идентификатор экземпляра облачной службы
name	string	Имя облачной службы
roleName	string	Имя роли облачной службы
roleType	AzureCloudServiceRoleType	Используется для указания типа роли облачной службы Azure

AzureCloudServiceRoleType

Используется для указания типа роли облачной службы Azure

Имя	Тип	Описание
unknown	string
web	string
worker	string

AzureHostingConfiguration

Предоставляет сведения о том, как компьютер размещается в Azure.

Имя	Тип	Описание
cloudService	AzureCloudServiceConfiguration	Содержит сведения о компьютерах, размещенных в качестве облачной службы Azure.
faultDomain	string	Домен сбоя виртуальной машины.
image	ImageConfiguration	Изображение компьютера.
kind	string: provider:azure	Дополнительный квалификатор типа конфигурации размещения.
location	string	Географическое расположение виртуальной машины.
name	string	Имя компьютера в соответствии с поставщиком услуг размещения.
provider	enum: azure	Поставщик размещения виртуальной машины.
resourceGroup	string	Имя группы ресурсов в указанной подписке.
resourceId	string	Уникальный идентификатор ресурса.
serviceFabricCluster	AzureServiceFabricClusterConfiguration	Содержит сведения о компьютерах, принадлежащих кластеру Azure Service Fabric.
size	string	Размер виртуальной машины.
subscriptionId	string	Идентификатор подписки.
updateDomain	string	Обновление домена виртуальной машины.
vmId	string	Идентификатор виртуальной машины (уникальный идентификатор).
vmScaleSet	AzureVmScaleSetConfiguration	Содержит сведения о компьютерах, размещенных как масштабируемый набор виртуальных машин Azure.

AzureServiceFabricClusterConfiguration

Описание кластера Azure Service Fabric

Имя	Тип	Описание
clusterId	string	Идентификатор кластера Service Fabric.
name	string	Имя кластера Service Fabric.

AzureVmScaleSetConfiguration

Описание масштабируемого набора виртуальных машин Azure

Имя	Тип	Описание
deployment	string	Идентификатор развертывания масштабируемого набора виртуальных машин
instanceId	string	Идентификатор экземпляра масштабируемого набора виртуальных машин
name	string	Имя масштабируемого набора виртуальных машин
resourceId	string	Уникальный идентификатор ресурса.

Bitness

Указывает разрядность компьютера или процесса.

Имя	Тип	Описание
32bit	string
64bit	string

Error

Сведения об ошибке.

Имя	Тип	Описание
code	string	Код ошибки, определяющий конкретную ошибку.
message	string	Сообщение об ошибке в языковом стандарте вызывающего абонента.

ErrorResponse

Ответ об ошибке от API.

Имя	Тип	Описание
error	Error	Сведения об ошибке.

HypervisorConfiguration

Описывает конфигурацию низкоуровневой оболочки компьютера.

Имя	Тип	Описание
hypervisorType	HypervisorType	Указывает технологию виртуализации, используемую гипервизором (hyperv, vmware и т. д.).
nativeHostMachineId	string	Уникальный идентификатор компьютера низкоуровневой оболочки, сообщаемый базовой системой виртуализации.

HypervisorType

Указывает тип низкоуровневой оболочки компьютера.

Имя	Тип	Описание
hyperv	string
unknown	string

ImageConfiguration

Описывает образ виртуальной машины.

Имя	Тип	Описание
offering	string	Предложение образа виртуальной машины.
publisher	string	Издатель образа виртуальной машины.
sku	string	SKU образа виртуальной машины.
version	string	Версия образа виртуальной машины.

Ipv4NetworkInterface

Описывает сетевой интерфейс IPv4.

Имя	Тип	Значение по умолчанию	Описание
ipAddress	string		«IPv4-адрес».
subnetMask	string	255.255.255.255	Маска подсети IPv4.

Ipv6NetworkInterface

Описывает сетевой интерфейс IPv6.

Имя	Тип	Описание
ipAddress	string	IPv6-адрес.

Machine

Ресурс компьютера представляет обнаруженную компьютерную систему. Его можно отслеживать, т. е. на нем запущен агент зависимостей, или обнаруживать, т. е. его существование было выведено путем наблюдения за потоком данных с отслеживаемых компьютеров. По мере изменения компьютеров предыдущие версии ресурса компьютера сохраняются и становятся доступными для доступа. Компьютер работает в течение определенного интервала времени, если его агент зависимостей передал данные в течение (части) этого интервала, или агент зависимостей, работающий на других компьютерах, сообщил о действиях, связанных с компьютером.

Имя	Тип	Описание
etag	string	ETAG ресурса.
id	string	Идентификатор ресурса.
kind	string: machine	Дополнительный квалификатор типа ресурса.
name	string	Имя ресурса.
properties.agent	AgentConfiguration	Конфигурация агента зависимостей.
properties.bootTime	string	Дата и время последней загрузки компьютера в формате UTC
properties.computerName	string	Имя компьютера, например сервер
properties.displayName	string	Имя, используемое в целях отображения
properties.fullyQualifiedDomainName	string	Полное имя компьютера, например server.company.com
properties.hosting	HostingConfiguration: AzureHostingConfiguration	Конфигурация, связанная с размещением. Отображается при обнаружении сведений о размещении для виртуальной машины.
properties.hypervisor	HypervisorConfiguration	Конфигурация, связанная с гипервизором. Присутствует, только если "virtualizationState" имеет значение hypervisor.
properties.monitoringState	MonitoringState	Указывает, выполняется ли активный мониторинг или обнаружение компьютера.
properties.networking	NetworkConfiguration	Конфигурация сети (IP-адреса, шлюзы, DNS и т. д.)
properties.operatingSystem	OperatingSystemConfiguration	Сведения об операционной системе.
properties.resources	MachineResourcesConfiguration	Ресурсы компьютера (память, ЦП и т. д.).
properties.timestamp	string	Дата и время обновления этого ресурса в системе в формате UTC.
properties.timezone	Timezone	Часовой пояс компьютера.
properties.virtualMachine	VirtualMachineConfiguration	Конфигурация, связанная с виртуализацией. Присутствует, только если virtualizationState имеет значение virtual.
properties.virtualizationState	VirtualizationState	Указывает, виртуализирована ли машина.
type	string	Тип ресурса.

MachineRebootStatus

Указывает, был ли компьютер перезагружен после установки агента зависимостей.

Имя	Тип	Описание
notRebooted	string
rebooted	string
unknown	string

MachineResourcesConfiguration

Описывает ресурсы компьютера.

Имя	Тип	Описание
cpuSpeed	integer	Скорость ЦП в мегагерцах (МГц).
cpuSpeedAccuracy	Accuracy	Описывает точность поля cpuSpeed.
cpus	integer	Количество ЦП.
physicalMemory	integer	Физическая память в мегабайтах (МБ).

MonitoringState

Используется для указания того, отслеживаются или обнаруживаются ресурсы.

Имя	Тип	Описание
discovered	string
monitored	string

NetworkConfiguration

Описывает сетевую конфигурацию компьютера.

Имя	Тип	Описание
defaultIpv4Gateways	string[]	Шлюзы IPv4 по умолчанию.
dnsNames	string[]	DNS-имена, связанные с компьютером.
ipv4Interfaces	Ipv4NetworkInterface[]	Интерфейсы IPv4.
ipv6Interfaces	Ipv6NetworkInterface[]	Интерфейсы IPv6.
macAddresses	string[]	MAC-адреса всех активных сетевых интерфейсов.

OperatingSystemConfiguration

Описывает конфигурацию операционной системы компьютера.

Имя	Тип	Описание
bitness	Bitness	Разрядность операционной системы (32-разрядная или 64-разрядная).
family	OperatingSystemFamily	Windows, Linux и т. д.
fullName	string	Полное имя операционной системы.

OperatingSystemFamily

Указывает семейство операционных систем, например Linux, Windows и т. д.

Имя	Тип	Описание
aix	string
linux	string
solaris	string
unknown	string
windows	string

Timezone

Описывает часовой пояс.

Имя	Тип	Описание
fullName	string	Полное имя часового пояса.

VirtualizationState

Указывает, является ли компьютер физическим, виртуальным, гипервизором или неизвестным.

Имя	Тип	Описание
hypervisor	string
physical	string
unknown	string
virtual	string

VirtualMachineConfiguration

Описывает конфигурацию компьютера, связанную с виртуализацией.

Имя	Тип	Описание
nativeHostMachineId	string	Уникальный идентификатор узла этой виртуальной машины, сообщаемый базовой системой виртуализации.
nativeMachineId	string	Уникальный идентификатор виртуальной машины, сообщаемый базовой системой виртуализации.
virtualMachineName	string	Имя виртуальной машины.
virtualMachineType	VirtualMachineType	Указывает технологию виртуализации, используемую компьютером (hyperv, vmware и т. д.).

VirtualMachineType

Указывает тип виртуализации компьютера.

Имя	Тип	Описание
hyperv	string
ldom	string
lpar	string
unknown	string
virtualPc	string
vmware	string
xen	string