Machines - Get

Возвращает указанный компьютер.

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

Name In Required Type Description
machineName
path True
  • string

Имя ресурса компьютера.

resourceGroupName
path True
  • string

Имя группы ресурсов в указанном идентификаторе подписки.

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.

Ответы

Name Type Description
200 OK

Операция выполнена успешно.

Other Status Codes

При обработке этого запроса возникла ошибка. Чтобы определить конкретную ошибку, см. параметр error.code.

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

azure_auth

Flow OAuth2 Azure Active Directory

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

Scopes

Name Description
user_impersonation олицетворения учетной записи пользователя

Примеры

SMMachinesGetGet

Sample Request

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

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

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

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

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

Name Type Description
actual
  • string
estimated
  • string

AgentConfiguration

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

Name Type Description
agentId
  • string

уникальный идентификатор агента служба работоспособности.

clockGranularity
  • integer

Степень детализации часов компьютера в миллисекундах.

dependencyAgentId
  • string

Уникальный идентификатор агента зависимостей.

dependencyAgentRevision
  • string

Номер редакции агента зависимостей.

dependencyAgentVersion
  • string

Номер версии агента зависимостей.

rebootStatus

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

AzureCloudServiceConfiguration

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

Name Type Description
deployment
  • string

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

instanceId
  • string

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

name
  • string

Имя облачной службы

roleName
  • string

Имя роли облачной службы

roleType

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

AzureCloudServiceRoleType

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

Name Type Description
unknown
  • string
web
  • string
worker
  • string

AzureHostingConfiguration

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

Name Type Description
cloudService

Содержит сведения о компьютерах, размещенных как облачная служба Azure.

faultDomain
  • string

Домен сбоя виртуальной машины.

image

Изображение компьютера.

kind string:
  • provider:azure

Дополнительный квалификатор типа конфигурации размещения.

location
  • string

Географическое расположение виртуальной машины.

name
  • string

Имя компьютера в соответствии с поставщиком услуг размещения.

provider enum:
  • azure

Поставщик размещения виртуальной машины.

resourceGroup
  • string

Имя группы ресурсов в указанной подписке.

resourceId
  • string

Уникальный идентификатор ресурса.

serviceFabricCluster

Содержит сведения о компьютерах, принадлежащих кластеру Azure Service Fabric

size
  • string

Размер виртуальной машины.

subscriptionId
  • string

Идентификатор подписки.

updateDomain
  • string

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

vmId
  • string

Идентификатор виртуальной машины (уникальный идентификатор).

vmScaleSet

Содержит сведения о компьютерах, размещенных в качестве масштабируемого набора виртуальных машин Azure.

AzureServiceFabricClusterConfiguration

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

Name Type Description
clusterId
  • string

Service Fabric идентификатор кластера.

name
  • string

Service Fabric имя кластера.

AzureVmScaleSetConfiguration

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

Name Type Description
deployment
  • string

Идентификатор развертывания масштабируемого набора виртуальных машин

instanceId
  • string

Идентификатор экземпляра масштабируемого набора виртуальных машин

name
  • string

Имя масштабируемого набора виртуальных машин

resourceId
  • string

Уникальный идентификатор ресурса.

Bitness

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

Name Type Description
32bit
  • string
64bit
  • string

Error

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

Name Type Description
code
  • string

Код ошибки, определяющий конкретную ошибку.

message
  • string

Сообщение об ошибке в языковом стандарте вызывающего объекта.

ErrorResponse

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

Name Type Description
error

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

HypervisorConfiguration

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

Name Type Description
hypervisorType

Задает технологию виртуализации, используемую гипервизором (hyperv, vmware и т. д.)

nativeHostMachineId
  • string

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

HypervisorType

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

Name Type Description
hyperv
  • string
unknown
  • string

ImageConfiguration

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

Name Type Description
offering
  • string

Предложение образа виртуальной машины.

publisher
  • string

Publisher образа виртуальной машины.

sku
  • string

Номер SKU образа виртуальной машины.

version
  • string

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

Ipv4NetworkInterface

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

Name Type Default Value Description
ipAddress
  • string

«IPv4-адрес».

subnetMask
  • string
255.255.255.255

Маска подсети IPv4.

Ipv6NetworkInterface

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

Name Type Description
ipAddress
  • string

IPv6-адрес.

Machine

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

Name Type Description
etag
  • string

ETAG ресурса.

id
  • string

Идентификатор ресурса.

kind string:
  • machine

Дополнительный квалификатор типа ресурса.

name
  • string

Имя ресурса.

properties.agent

Конфигурация агента зависимостей.

properties.bootTime
  • string

Дата и время последней загрузки компьютера в формате UTC

properties.computerName
  • string

Имя компьютера, например сервер

properties.displayName
  • string

Имя, используемое для отображения

properties.fullyQualifiedDomainName
  • string

Полное имя компьютера, например server.company.com

properties.hosting HostingConfiguration:

Конфигурация, связанная с размещением. Отображается, если сведения о размещении обнаружены для виртуальной машины.

properties.hypervisor

Конфигурация, связанная с гипервизором. Присутствует только в том случае, если параметр virtualizationState имеет значение hypervisor.

properties.monitoringState

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

properties.networking

Конфигурация сети (ips, шлюзы, dns и т. д.)

properties.operatingSystem

Сведения об операционной системе.

properties.resources

Ресурсы компьютера (память, ЦП и т. д.).

properties.timestamp
  • string

Дата и время обновления этого ресурса в формате UTC.

properties.timezone

Часовой пояс компьютера.

properties.virtualMachine

Конфигурация, связанная с виртуализацией. Присутствует только в том случае virtualizationStatevirtual.

properties.virtualizationState

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

type
  • string

Тип ресурса.

MachineRebootStatus

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

Name Type Description
notRebooted
  • string
rebooted
  • string
unknown
  • string

MachineResourcesConfiguration

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

Name Type Description
cpuSpeed
  • integer

Скорость ЦП в мегагерц (МГц).

cpuSpeedAccuracy

Описывает точность поля cpuSpeed.

cpus
  • integer

Количество ЦП.

physicalMemory
  • integer

Физическая память в мегабайтах (МБ).

MonitoringState

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

Name Type Description
discovered
  • string
monitored
  • string

NetworkConfiguration

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

Name Type Description
defaultIpv4Gateways
  • string[]

Шлюзы IPv4 по умолчанию.

dnsNames
  • string[]

DNS-имена, связанные с компьютером.

ipv4Interfaces

Интерфейсы IPv4.

ipv6Interfaces

Интерфейсы IPv6.

macAddresses
  • string[]

MAC-адреса всех активных сетевых интерфейсов.

OperatingSystemConfiguration

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

Name Type Description
bitness

Разрядность операционной системы (32-разрядная или 64-разрядная).

family

Windows, Linux и т. д.

fullName
  • string

Полное имя операционной системы.

OperatingSystemFamily

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

Name Type Description
aix
  • string
linux
  • string
solaris
  • string
unknown
  • string
windows
  • string

Timezone

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

Name Type Description
fullName
  • string

Полное имя часового пояса.

VirtualizationState

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

Name Type Description
hypervisor
  • string
physical
  • string
unknown
  • string
virtual
  • string

VirtualMachineConfiguration

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

Name Type Description
nativeHostMachineId
  • string

Уникальный идентификатор узла этой виртуальной машины, сообщаемый базовой системой виртуализации.

nativeMachineId
  • string

Уникальный идентификатор виртуальной машины, сообщаемой базовой системой виртуализации.

virtualMachineName
  • string

Имя виртуальной машины.

virtualMachineType

Указывает технологию виртуализации, используемую компьютером (hyperv, vmware и т. д.)

VirtualMachineType

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

Name Type Description
hyperv
  • string
ldom
  • string
lpar
  • string
unknown
  • string
virtualPc
  • string
vmware
  • string
xen
  • string