Machines - Get

Servicio:: Service Map

Versión de la API:: 2015-11-01-preview

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

Con parámetros opcionales:

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

Nombre	En	Requerido	Tipo	Description
machineName	path	True	string minLength: 3 maxLength: 64	Nombre del recurso de máquina.
resourceGroupName	path	True	string minLength: 1 maxLength: 64 pattern: [a-zA-Z0-9_-]+	Nombre del grupo de recursos dentro del subscriptionId especificado.
subscriptionId	path	True	string	Identificador de suscripción de Azure.
workspaceName	path	True	string minLength: 3 maxLength: 63 pattern: [a-zA-Z0-9_][a-zA-Z0-9_-]+[a-zA-Z0-9_]	Área de trabajo de OMS que contiene los recursos de interés.
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

Nombre	Tipo	Description
200 OK	Machine	La operación se completó correctamente.
Other Status Codes	ErrorResponse	Error al procesar la solicitud. Consulte el parámetro error.code para identificar el error específico.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

SMMachinesGetGet

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre	Description
Accuracy	Especifica la precisión de un cálculo.
AgentConfiguration	Describe la configuración de Dependency Agent instalada 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 una máquina 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, un Agente de dependencias se ejecuta en él o detectado, es decir, su existencia se infirió 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 Dependency Agent ha notificado datos durante (partes) de ese intervalo, o bien 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 dependencias.
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

Enumeración

Especifica la precisión de un cálculo.

Valor	Description
actual
estimated

AgentConfiguration

Object

Describe la configuración de Dependency Agent instalada en un equipo.

Nombre	Tipo	Description
agentId	string	Identificador único del Agente del servicio de mantenimiento.
clockGranularity	integer (int32)	Granularidad del reloj de la máquina en milisegundos.
dependencyAgentId	string	Identificador único de Dependency Agent.
dependencyAgentRevision	string	Número de revisión del Agente de dependencias.
dependencyAgentVersion	string	Número de versión de Dependency Agent.
rebootStatus	MachineRebootStatus	Especifica si la máquina se ha reiniciado desde la instalación de Dependency Agent.

AzureCloudServiceConfiguration

Object

Describe un servicio en la nube de Azure

Nombre	Tipo	Description
deployment	string	Identificador de implementación del servicio en la nube
instanceId	string	Identificador de instancia de Servicio en la nube
name	string	Nombre del servicio en la nube
roleName	string	Nombre del rol de servicio en la nube
roleType	AzureCloudServiceRoleType	Se usa para especificar el tipo de un rol de servicio en la nube de Azure

AzureCloudServiceRoleType

Enumeración

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

Valor	Description
unknown
worker
web

AzureHostingConfiguration

Object

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

Nombre	Tipo	Description
cloudService	AzureCloudServiceConfiguration	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	ImageConfiguration	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	AzureServiceFabricClusterConfiguration	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	AzureVmScaleSetConfiguration	Contiene información sobre las máquinas hospedadas como un conjunto de escalado de máquinas virtuales de Azure.

AzureServiceFabricClusterConfiguration

Object

Describe un clúster de Azure Service Fabric

Nombre	Tipo	Description
clusterId	string	Identificador del clúster de Service Fabric.
name	string	Nombre del clúster de Service Fabric.

AzureVmScaleSetConfiguration

Object

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

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

Enumeración

Especifica el valor de bits de una máquina o proceso.

Valor	Description
32bit
64bit

Error

Object

Detalles del error.

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

Object

Respuesta de error de la API.

Nombre	Tipo	Description
error	Error	Información de error.

HypervisorConfiguration

Object

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

Nombre	Tipo	Description
hypervisorType	HypervisorType	Especifica la tecnología de virtualización usada por el hipervisor (hyperv, vmware, etc.)
nativeHostMachineId	string	El identificador único de la máquina del hipervisor tal y como indica el sistema de virtualización subyacente.

HypervisorType

Enumeración

Especifica el tipo de hipervisor de una máquina.

Valor	Description
unknown
hyperv

ImageConfiguration

Object

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

Nombre	Tipo	Description
offering	string	Oferta de la imagen de máquina virtual.
publisher	string	Publicador de la imagen de máquina virtual.
sku	string	SKU de la imagen de máquina virtual.
version	string	Versión de la imagen de máquina virtual.

Ipv4NetworkInterface

Object

Describe una interfaz de red IPv4.

Nombre	Tipo	Valor predeterminado	Description
ipAddress	string		Dirección IPv4.
subnetMask	string	255.255.255.255	Máscara de subred IPv4.

Ipv6NetworkInterface

Object

Describe una interfaz de red IPv6.

Nombre	Tipo	Description
ipAddress	string	Dirección IPv6.

Machine

Object

Un recurso de máquina representa un sistema informático detectado. Se puede supervisar, es decir, un Agente de dependencias se ejecuta en él o detectado, es decir, su existencia se infirió 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 Dependency Agent ha notificado datos durante (partes) de ese intervalo, o bien un agente de dependencia que se ejecuta en otras máquinas ha notificado actividad asociada a la máquina.

Nombre	Tipo	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	AgentConfiguration	Configuración de Dependency Agent.
properties.bootTime	string (date-time)	Fecha y hora UTC en que se ha arrancado por última vez la máquina
properties.computerName	string	Nombre de la máquina, por ejemplo, servidor
properties.displayName	string	Nombre que se va a usar con fines de visualización
properties.fullyQualifiedDomainName	string	Nombre completo de la máquina, por ejemplo, server.company.com
properties.hosting	HostingConfiguration: AzureHostingConfiguration	Configuración relacionada con el hospedaje. Presente si se detecta información de hospedaje para la máquina virtual.
properties.hypervisor	HypervisorConfiguration	Configuración relacionada con el hipervisor. Presente solo cuando "virtualizationState" es `hypervisor`.
properties.monitoringState	MonitoringState	Especifica si la máquina se supervisa o detecta activamente.
properties.networking	NetworkConfiguration	Configuración de red (ips, puertas de enlace, dns, etc.)
properties.operatingSystem	OperatingSystemConfiguration	Información del sistema operativo.
properties.resources	MachineResourcesConfiguration	Recursos de la máquina (memoria, cpu, etc.).
properties.timestamp	string (date-time)	Fecha y hora UTC en que se actualizó este recurso en el sistema.
properties.timezone	Timezone	Zona horaria de la máquina.
properties.virtualMachine	VirtualMachineConfiguration	Configuración relacionada con la virtualización. Presente solo cuando `virtualizationState` es `virtual`.
properties.virtualizationState	VirtualizationState	Especifica si la máquina está virtualizada.
type	string	Tipo de recurso.

MachineRebootStatus

Enumeración

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

Valor	Description
unknown
rebooted
notRebooted

MachineResourcesConfiguration

Object

Describe los recursos de una máquina.

Nombre	Tipo	Description
cpuSpeed	integer (int32)	Velocidad de CPU en megahercios (Mhz).
cpuSpeedAccuracy	Accuracy	Describe la precisión del campo cpuSpeed.
cpus	integer (int32)	Número de CPU.
physicalMemory	integer (int32)	Memoria física en megabytes (MB).

MonitoringState

Enumeración

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

Valor	Description
monitored
discovered

NetworkConfiguration

Object

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

Nombre	Tipo	Description
defaultIpv4Gateways	string[]	Puertas de enlace IPv4 predeterminadas.
dnsNames	string[]	Nombres DNS asociados a la máquina.
ipv4Interfaces	Ipv4NetworkInterface[]	Interfaces IPv4.
ipv6Interfaces	Ipv6NetworkInterface[]	Interfaces IPv6.
macAddresses	string[]	Direcciones MAC de todas las interfaces de red activas.

OperatingSystemConfiguration

Object

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

Nombre	Tipo	Description
bitness	Bitness	Bitness del sistema operativo (32 o 64 bits).
family	OperatingSystemFamily	Windows, Linux, etc.
fullName	string	Nombre completo del sistema operativo.

OperatingSystemFamily

Enumeración

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

Valor	Description
unknown
windows
linux
solaris
aix

Timezone

Object

Describe una zona horaria.

Nombre	Tipo	Description
fullName	string	Nombre completo de zona horaria.

VirtualizationState

Enumeración

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

Valor	Description
unknown
physical
virtual
hypervisor

VirtualMachineConfiguration

Object

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

Nombre	Tipo	Description
nativeHostMachineId	string	Identificador único del host de esta máquina virtual, tal y como indica el sistema de virtualización subyacente.
nativeMachineId	string	Identificador único de la máquina virtual tal como lo indica el sistema de virtualización subyacente.
virtualMachineName	string	Nombre de la máquina virtual.
virtualMachineType	VirtualMachineType	Especifica la tecnología de virtualización usada por la máquina (hyperv, vmware, etc.)

VirtualMachineType

Enumeración

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

Valor	Description
unknown
hyperv
ldom
lpar
vmware
virtualPc
xen

Compartir a través de

Machines - Get

Parámetros de identificador URI

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

SMMachinesGetGet

Solicitud de ejemplo

Respuesta de muestra

Definiciones

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