Machines - Get

Devuelve la máquina especificada.

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}

Parámetros de identificador URI

Name In Required Type Description
machineName
path True
  • string

Nombre del recurso de la máquina.

resourceGroupName
path True
  • string

Nombre del grupo de recursos dentro del subscriptionId especificado.

Regex pattern: [a-zA-Z0-9_-]+

subscriptionId
path True
  • string

Identificador de la suscripción de Azure.

workspaceName
path True
  • string

Área de trabajo de OMS que contiene los recursos de interés.

Regex pattern: [a-zA-Z0-9_][a-zA-Z0-9_-]+[a-zA-Z0-9_]

api-version
query True
  • string

Versión de LA API.

timestamp
query
  • string
date-time

Fecha y hora UTC que especifica una instancia de hora relativa a la que se va a evaluar el recurso de la máquina. Cuando no se especifica, el servicio usa DateTime.UtcNow.

Respuestas

Name Type Description
200 OK

La operación se ha completado correctamente.

Other Status Codes

Se produjo un error al procesar la solicitud. Consulte el parámetro error.code para identificar el error específico.

Seguridad

azure_auth

Azure Active Directory Flow OAuth2

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

Scopes

Name Description
user_impersonation suplantar la cuenta de usuario

Ejemplos

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

Definiciones

Accuracy

Especifica la precisión de un cálculo.

AgentConfiguration

Describe la configuración del Agente de dependencias instalado en un equipo.

AzureCloudServiceConfiguration

Describe un servicio en la nube de Azure

AzureCloudServiceRoleType

Se usa para especificar el tipo de un rol de servicio en la nube de Azure

AzureHostingConfiguration

Proporciona información sobre cómo se hospeda una máquina en Azure.

AzureServiceFabricClusterConfiguration

Describe un clúster de Azure Service Fabric

AzureVmScaleSetConfiguration

Describe un conjunto de escalado de máquinas virtuales de Azure

Bitness

Especifica el valor de bits de un equipo o proceso.

Error

Detalles del error.

ErrorResponse

Respuesta de error de la API.

HypervisorConfiguration

Describe la configuración del hipervisor de una máquina.

HypervisorType

Especifica el tipo de hipervisor de una máquina.

ImageConfiguration

Describe la imagen de máquina virtual de una máquina.

Ipv4NetworkInterface

Describe una interfaz de red IPv4.

Ipv6NetworkInterface

Describe una interfaz de red IPv6.

Machine

Un recurso de máquina representa un sistema informático detectado. Se puede supervisar, es decir, que un Agente de dependencia se ejecuta en él o se detecta, es decir, su existencia se infiere observando el flujo de datos de las máquinas supervisadas. A medida que cambian las máquinas, las versiones anteriores del recurso de máquina se conservan y están disponibles para el acceso. Una máquina está activa durante un intervalo de tiempo, si su Agente de dependencia ha notificado datos durante (partes) de ese intervalo o un agente de dependencia que se ejecuta en otras máquinas ha notificado actividad asociada a la máquina.

MachineRebootStatus

Especifica si la máquina se ha reiniciado desde la instalación del agente de dependencia.

MachineResourcesConfiguration

Describe los recursos de una máquina.

MonitoringState

Se usa para especificar si se supervisa o detecta un recurso.

NetworkConfiguration

Describe la configuración de red de una máquina.

OperatingSystemConfiguration

Describe la configuración del sistema operativo de una máquina.

OperatingSystemFamily

Especifica la familia de sistemas operativos, por ejemplo, Linux, Windows, etc.

Timezone

Describe una zona horaria.

VirtualizationState

Especifica si la máquina es física, virtual, hipervisor o desconocida.

VirtualMachineConfiguration

Describe la configuración relacionada con la virtualización de una máquina.

VirtualMachineType

Especifica el tipo de virtualización de una máquina.

Accuracy

Especifica la precisión de un cálculo.

Name Type Description
actual
  • string
estimated
  • string

AgentConfiguration

Describe la configuración del Agente de dependencias instalado en un equipo.

Name Type Description
agentId
  • string

Servicio de mantenimiento identificador único del agente.

clockGranularity
  • integer

Granularidad del reloj de la máquina en milisegundos.

dependencyAgentId
  • string

Identificador único de Dependency Agent.

dependencyAgentRevision
  • string

Número de revisión de Dependency Agent.

dependencyAgentVersion
  • string

Número de versión de Dependency Agent.

rebootStatus

Especifica si la máquina se ha reiniciado desde la instalación de Dependency Agent.

AzureCloudServiceConfiguration

Describe un servicio en la nube de Azure

Name Type Description
deployment
  • string

Identificador de implementación del servicio en la nube

instanceId
  • string

Identificador de instancia del servicio en la nube

name
  • string

Nombre del servicio en la nube

roleName
  • string

Nombre del rol del servicio en la nube

roleType

Se usa para especificar el tipo de un rol de servicio en la nube de Azure

AzureCloudServiceRoleType

Se usa para especificar el tipo de un rol de servicio en la nube de Azure

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

AzureHostingConfiguration

Proporciona información sobre cómo se hospeda una máquina en Azure.

Name Type Description
cloudService

Contiene información sobre las máquinas hospedadas como un servicio en la nube de Azure.

faultDomain
  • string

Dominio de error de la máquina virtual.

image

Imagen de la máquina.

kind string:
  • provider:azure

Calificador de tipo de configuración de hospedaje adicional.

location
  • string

Ubicación geográfica de la máquina virtual.

name
  • string

Nombre del equipo según el proveedor de hospedaje.

provider enum:
  • azure

Proveedor de hospedaje de la máquina virtual.

resourceGroup
  • string

Nombre del grupo de recursos dentro de la suscripción especificada.

resourceId
  • string

Identificador único del recurso.

serviceFabricCluster

Contiene información sobre las máquinas que pertenecen a un clúster de Azure Service Fabric

size
  • string

Tamaño de la máquina virtual.

subscriptionId
  • string

Id. de suscripción.

updateDomain
  • string

Actualice el dominio de la máquina virtual.

vmId
  • string

Identificador de máquina virtual (identificador único).

vmScaleSet

Contiene información sobre las máquinas hospedadas como un conjunto de escalado de máquinas virtuales de Azure.

AzureServiceFabricClusterConfiguration

Describe un clúster de Azure Service Fabric

Name Type Description
clusterId
  • string

Service Fabric identificador de clúster.

name
  • string

Service Fabric nombre del clúster.

AzureVmScaleSetConfiguration

Describe un conjunto de escalado de máquinas virtuales de Azure

Name Type Description
deployment
  • string

Identificador de implementación del conjunto de escalado de máquinas virtuales

instanceId
  • string

Identificador de instancia del conjunto de escalado de máquinas virtuales

name
  • string

Nombre del conjunto de escalado de máquinas virtuales

resourceId
  • string

Identificador único del recurso.

Bitness

Especifica el valor de bits de un equipo o proceso.

Name Type Description
32bit
  • string
64bit
  • string

Error

Detalles del error.

Name Type Description
code
  • string

Código de error que identifica el error específico.

message
  • string

Mensaje de error en la configuración regional del autor de la llamada.

ErrorResponse

Respuesta de error de la API.

Name Type Description
error

Información de error.

HypervisorConfiguration

Describe la configuración del hipervisor de una máquina.

Name Type Description
hypervisorType

Especifica la tecnología de virtualización usada por el hipervisor (hyperv, vmware, etc.)

nativeHostMachineId
  • string

Identificador único de la máquina del hipervisor según lo notificado por el sistema de virtualización subyacente.

HypervisorType

Especifica el tipo de hipervisor de una máquina.

Name Type Description
hyperv
  • string
unknown
  • string

ImageConfiguration

Describe la imagen de máquina virtual de una máquina.

Name Type Description
offering
  • string

Oferta de la imagen de máquina virtual.

publisher
  • string

Editor de la imagen de VM.

sku
  • string

SKU de la imagen de máquina virtual.

version
  • string

Versión de la imagen de máquina virtual.

Ipv4NetworkInterface

Describe una interfaz de red IPv4.

Name Type Default Value Description
ipAddress
  • string

Dirección IPv4.

subnetMask
  • string
255.255.255.255

Máscara de subred IPv4.

Ipv6NetworkInterface

Describe una interfaz de red IPv6.

Name Type Description
ipAddress
  • string

Dirección IPv6.

Machine

Un recurso de máquina representa un sistema informático detectado. Se puede supervisar, es decir, que un Agente de dependencia se ejecuta en él o se detecta, es decir, su existencia se infiere observando el flujo de datos de las máquinas supervisadas. A medida que cambian las máquinas, las versiones anteriores del recurso de máquina se conservan y están disponibles para el acceso. Una máquina está activa durante un intervalo de tiempo, si su Agente de dependencia ha notificado datos durante (partes) de ese intervalo o un agente de dependencia que se ejecuta en otras máquinas ha notificado actividad asociada a la máquina.

Name Type Description
etag
  • string

ETAG de recursos.

id
  • string

Identificador de recursos.

kind string:
  • machine

Calificador de tipo de recurso adicional.

name
  • string

Nombre del recurso.

properties.agent

Configuración de Dependency Agent.

properties.bootTime
  • string

Fecha y hora UTC en que el equipo arranca por última vez

properties.computerName
  • string

Nombre de la máquina, por ejemplo, servidor

properties.displayName
  • string

Nombre que se va a usar con fines de presentación

properties.fullyQualifiedDomainName
  • string

Nombre completo de la máquina, por ejemplo, server.company.com

properties.hosting HostingConfiguration:

Configuración relacionada con el hospedaje. Presente si se detecta información de hospedaje para la máquina virtual.

properties.hypervisor

Configuración relacionada con el hipervisor. Solo se presenta cuando "virtualizationState" es hypervisor.

properties.monitoringState

Especifica si la máquina se supervisa o detecta activamente.

properties.networking

Configuración de red (ips, puertas de enlace, dns, etc.)

properties.operatingSystem

Información del sistema operativo.

properties.resources

Recursos de la máquina (memoria, cpu, etc.).

properties.timestamp
  • string

Fecha y hora UTC en que se actualizó este recurso en el sistema.

properties.timezone

Zona horaria de la máquina.

properties.virtualMachine

Configuración relacionada con la virtualización. Solo se presenta cuando virtualizationState es virtual.

properties.virtualizationState

Especifica si la máquina está virtualizada.

type
  • string

Tipo de recurso.

MachineRebootStatus

Especifica si la máquina se ha reiniciado desde la instalación del agente de dependencia.

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

MachineResourcesConfiguration

Describe los recursos de una máquina.

Name Type Description
cpuSpeed
  • integer

Velocidad de CPU en megahercios (Mhz).

cpuSpeedAccuracy

Describe la precisión del campo cpuSpeed.

cpus
  • integer

Número de CPU.

physicalMemory
  • integer

Memoria física en megabytes (MB).

MonitoringState

Se usa para especificar si se supervisa o detecta un recurso.

Name Type Description
discovered
  • string
monitored
  • string

NetworkConfiguration

Describe la configuración de red de una máquina.

Name Type Description
defaultIpv4Gateways
  • string[]

Puertas de enlace IPv4 predeterminadas.

dnsNames
  • string[]

Nombres DNS asociados a la máquina.

ipv4Interfaces

Interfaces IPv4.

ipv6Interfaces

Interfaces IPv6.

macAddresses
  • string[]

Direcciones MAC de todas las interfaces de red activas.

OperatingSystemConfiguration

Describe la configuración del sistema operativo de una máquina.

Name Type Description
bitness

Bits del sistema operativo (32 o 64 bits).

family

Windows, Linux, etc.

fullName
  • string

Nombre completo del sistema operativo.

OperatingSystemFamily

Especifica la familia de sistemas operativos, por ejemplo, Linux, Windows, etc.

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

Timezone

Describe una zona horaria.

Name Type Description
fullName
  • string

Nombre completo de zona horaria.

VirtualizationState

Especifica si la máquina es física, virtual, hipervisor o desconocida.

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

VirtualMachineConfiguration

Describe la configuración relacionada con la virtualización de una máquina.

Name Type Description
nativeHostMachineId
  • string

Identificador único del host de esta máquina virtual según lo notificado por el sistema de virtualización subyacente.

nativeMachineId
  • string

Identificador único de la máquina virtual según lo notificado por el sistema de virtualización subyacente.

virtualMachineName
  • string

Nombre de la máquina virtual.

virtualMachineType

Especifica la tecnología de virtualización usada por la máquina (hyperv, vmware, etc.).

VirtualMachineType

Especifica el tipo de virtualización de una máquina.

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