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	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

Поток OAuth2 Azure Active Directory

Тип: oauth2
Flow: 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	Описывает образ виртуальной машины компьютера.
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	Указывает, перезагружается ли компьютер после установки агента зависимостей.

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	Домен сбоя виртуальной машины.
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

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

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

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

Ipv4NetworkInterface

Object

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

Имя	Тип	Default value	Описание
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	Конфигурация, связанная с размещением. При обнаружении сведений о размещении для виртуальной машины.
properties.hypervisor	HypervisorConfiguration	Конфигурация, связанная с гипервизором. Присутствует только в том случае, если параметр virtualizationState `hypervisor`.
properties.monitoringState	MonitoringState	Указывает, активно ли компьютер отслеживается или обнаруживается.
properties.networking	NetworkConfiguration	Конфигурация сети (ips, шлюзы, dns и т. д.)
properties.operatingSystem	OperatingSystemConfiguration	Сведения о операционной системе.
properties.resources	MachineResourcesConfiguration	Ресурсы компьютера (память, ЦП и т. д.).
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)	Скорость ЦП в мегагерцах (МГц).
cpuSpeedAccuracy	Accuracy	Описывает точность поля cpuSpeed.
cpus	integer (int32)	Количество ЦП.
physicalMemory	integer (int32)	Физическая память в мегабайтах (МБ).

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

Поделиться через

Machines - Get

Параметры URI

Ответы

Безопасность

azure_auth

Области

Примеры

SMMachinesGetGet

Образец запроса

Пример ответа

Определения

Accuracy

AgentConfiguration

AzureCloudServiceConfiguration

AzureCloudServiceRoleType

AzureHostingConfiguration

AzureServiceFabricClusterConfiguration

AzureVmScaleSetConfiguration

Bitness

Error

ErrorResponse

HypervisorConfiguration

HypervisorType

ImageConfiguration

Ipv4NetworkInterface

Ipv6NetworkInterface

Machine

MachineRebootStatus

MachineResourcesConfiguration

MonitoringState

NetworkConfiguration

OperatingSystemConfiguration

OperatingSystemFamily

Timezone

VirtualizationState

VirtualMachineConfiguration

VirtualMachineType