Machines - Get

Referencia

Service:: Service Map

API Version:: 2015-11-01-preview

Devuelve el equipo especificado.

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}

Parámetros de identificador URI

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

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

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

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

Scopes

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

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

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 un equipo o proceso.
Error	Detalles del error.
ErrorResponse	Una 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 de equipo detectado. Se puede supervisar, es decir, un Agente de dependencias se está ejecutando 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 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.

Nombre	Tipo	Description
actual	string
estimated	string

AgentConfiguration

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	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	MachineRebootStatus	Especifica si la máquina se ha reiniciado desde la instalación de Dependency Agent.

AzureCloudServiceConfiguration

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 del servicio en la nube
name	string	Nombre del servicio en la nube
roleName	string	Nombre del rol del servicio en la nube
roleType	AzureCloudServiceRoleType	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.

Nombre	Tipo	Description
unknown	string
web	string
worker	string

AzureHostingConfiguration

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

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

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

Especifica el valor de bits de un equipo o proceso.

Nombre	Tipo	Description
32bit	string
64bit	string

Error

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

Una respuesta de error de la API.

Nombre	Tipo	Description
error	Error	Información de error.

HypervisorConfiguration

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	Identificador único de la máquina de hipervisor tal como lo notifica el sistema de virtualización subyacente.

HypervisorType

Especifica el tipo de hipervisor de una máquina.

Nombre	Tipo	Description
hyperv	string
unknown	string

ImageConfiguration

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

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

Ipv6NetworkInterface

Describe una interfaz de red IPv6.

Nombre	Tipo	Description
ipAddress	string	Dirección IPv6.

Machine

Un recurso de máquina representa un sistema de equipo detectado. Se puede supervisar, es decir, un Agente de dependencias se está ejecutando 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 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.

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	Fecha y hora UTC en la 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 presentació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. Solo está presente 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	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. Solo está presente cuando `virtualizationState` es `virtual`.
properties.virtualizationState	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.

Nombre	Tipo	Description
notRebooted	string
rebooted	string
unknown	string

MachineResourcesConfiguration

Describe los recursos de una máquina.

Nombre	Tipo	Description
cpuSpeed	integer	Velocidad de CPU en megahercios (Mhz).
cpuSpeedAccuracy	Accuracy	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.

Nombre	Tipo	Description
discovered	string
monitored	string

NetworkConfiguration

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

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

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

OperatingSystemFamily

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

Nombre	Tipo	Description
aix	string
linux	string
solaris	string
unknown	string
windows	string

Timezone

Describe una zona horaria.

Nombre	Tipo	Description
fullName	string	Nombre completo de zona horaria.

VirtualizationState

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

Nombre	Tipo	Description
hypervisor	string
physical	string
unknown	string
virtual	string

VirtualMachineConfiguration

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 como lo notifica el sistema de virtualización subyacente.
nativeMachineId	string	Identificador único de la máquina virtual tal como lo notifica 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

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

Nombre	Tipo	Description
hyperv	string
ldom	string
lpar	string
unknown	string
virtualPc	string
vmware	string
xen	string