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 매개 변수

Name	In(다음 안에)	필수	형식	Description
machineName	path	True	string minLength: 3 maxLength: 64	컴퓨터 리소스 이름입니다.
resourceGroupName	path	True	string minLength: 1 maxLength: 64 pattern: [a-zA-Z0-9_-]+	지정된 subscriptionId 내의 리소스 그룹 이름입니다.
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를 사용합니다.

응답

Name	형식	Description
200 OK	Machine	작업이 성공적으로 완료되었습니다.
Other Status Codes	ErrorResponse	요청을 처리하는 동안 오류가 발생했습니다. 특정 오류를 식별하려면 error.code 매개 변수를 참조하세요.

보안

azure_auth

Azure Active Directory OAuth2 흐름

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

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

정의

Name	Description
Accuracy	계산의 정확도를 지정합니다.
AgentConfiguration	컴퓨터에 설치된 종속성 에이전트의 구성에 대해 설명합니다.
AzureCloudServiceConfiguration	Azure Cloud Service에 대해 설명합니다.
AzureCloudServiceRoleType	Azure 클라우드 서비스 역할의 유형을 지정하는 데 사용됩니다.
AzureHostingConfiguration	컴퓨터가 Azure에서 호스트되는 방법에 대한 정보를 제공합니다.
AzureServiceFabricClusterConfiguration	Azure Service Fabric 클러스터에 대해 설명합니다.
AzureVmScaleSetConfiguration	Azure Virtual Machine Scale Set에 대해 설명합니다.
Bitness	컴퓨터 또는 프로세스의 비트 수를 지정합니다.
Error	오류 세부 정보입니다.
ErrorResponse	API의 오류 응답입니다.
HypervisorConfiguration	컴퓨터의 하이퍼바이저 구성에 대해 설명합니다.
HypervisorType	컴퓨터의 하이퍼바이저 유형을 지정합니다.
ImageConfiguration	컴퓨터의 VM 이미지를 설명합니다.
Ipv4NetworkInterface	IPv4 네트워크 인터페이스에 대해 설명합니다.
Ipv6NetworkInterface	IPv6 네트워크 인터페이스에 대해 설명합니다.
Machine	컴퓨터 리소스는 검색된 컴퓨터 시스템을 나타냅니다. 모니터링되는, 즉 종속성 에이전트가 실행 중이거나 검색된 , 즉 모니터링되는 컴퓨터에서 데이터 스트림을 관찰하여 해당 존재가 유추되었을 수 있습니다. 컴퓨터가 변경되면 이전 버전의 컴퓨터 리소스가 유지되고 액세스할 수 있습니다. 종속성 에이전트가 해당 간격의 일부 동안 데이터를 보고했거나 다른 컴퓨터에서 실행되는 종속성 에이전트가 컴퓨터와 연결된 활동을 보고한 경우 컴퓨터는 시간 간격 동안 라이브 상태가 됩니다.
MachineRebootStatus	종속성 에이전트 설치 이후 컴퓨터가 다시 부팅되었는지를 지정합니다.
MachineResourcesConfiguration	컴퓨터의 리소스에 대해 설명합니다.
MonitoringState	리소스를 모니터링하거나 검색할지 여부를 지정하는 데 사용됩니다.
NetworkConfiguration	컴퓨터의 네트워크 구성에 대해 설명합니다.
OperatingSystemConfiguration	컴퓨터의 운영 체제 구성에 대해 설명합니다.
OperatingSystemFamily	운영 체제 패밀리(예: Linux, Windows 등)를 지정합니다.
Timezone	표준 시간대를 설명합니다.
VirtualizationState	컴퓨터가 물리적, 가상, 하이퍼바이저 또는 알 수 없는지 여부를 지정합니다.
VirtualMachineConfiguration	머신의 가상화 관련 구성에 대해 설명합니다.
VirtualMachineType	머신의 가상화 유형을 지정합니다.

Accuracy

열거형

계산의 정확도를 지정합니다.

값	Description
actual
estimated

AgentConfiguration

Object

컴퓨터에 설치된 종속성 에이전트의 구성에 대해 설명합니다.

Name	형식	Description
agentId	string	Health Service Agent 고유 식별자입니다.
clockGranularity	integer (int32)	컴퓨터 시계 세분성(밀리초)입니다.
dependencyAgentId	string	종속성 에이전트 고유 식별자입니다.
dependencyAgentRevision	string	종속성 에이전트 수정 번호입니다.
dependencyAgentVersion	string	종속성 에이전트 버전 번호입니다.
rebootStatus	MachineRebootStatus	종속성 에이전트 설치 이후 컴퓨터를 다시 부팅했는지 여부를 지정합니다.

AzureCloudServiceConfiguration

Object

Azure Cloud Service에 대해 설명합니다.

Name	형식	Description
deployment	string	클라우드 서비스 배포 식별자
instanceId	string	클라우드 서비스 인스턴스 식별자
name	string	클라우드 서비스 이름
roleName	string	클라우드 서비스 역할 이름
roleType	AzureCloudServiceRoleType	Azure 클라우드 서비스 역할의 유형을 지정하는 데 사용됩니다.

AzureCloudServiceRoleType

열거형

Azure 클라우드 서비스 역할의 유형을 지정하는 데 사용됩니다.

값	Description
unknown
worker
web

AzureHostingConfiguration

Object

컴퓨터가 Azure에서 호스트되는 방법에 대한 정보를 제공합니다.

Name	형식	Description
cloudService	AzureCloudServiceConfiguration	Azure Cloud Service로 호스트되는 머신에 대한 정보를 포함합니다.
faultDomain	string	VM의 장애 도메인입니다.
image	ImageConfiguration	컴퓨터의 이미지입니다.
kind	string: provider:azure	추가 호스팅 구성 유형 한정자입니다.
location	string	VM의 지리적 위치입니다.
name	string	호스팅 공급자에 따른 컴퓨터 이름입니다.
provider	enum: azure	VM의 호스팅 공급자입니다.
resourceGroup	string	지정된 구독 내의 리소스 그룹 이름입니다.
resourceId	string	리소스의 고유 식별자입니다.
serviceFabricCluster	AzureServiceFabricClusterConfiguration	Azure Service Fabric 클러스터에 속한 머신에 대한 정보를 포함합니다.
size	string	VM의 크기입니다.
subscriptionId	string	구독 ID가 표시됩니다.
updateDomain	string	VM의 도메인을 업데이트합니다.
vmId	string	Virtual Machine ID(고유 식별자)입니다.
vmScaleSet	AzureVmScaleSetConfiguration	Azure Virtual Machine Scale Set으로 호스트되는 머신에 대한 정보를 포함합니다.

AzureServiceFabricClusterConfiguration

Object

Azure Service Fabric 클러스터에 대해 설명합니다.

Name	형식	Description
clusterId	string	Service Fabric 클러스터 식별자입니다.
name	string	Service Fabric 클러스터 이름입니다.

AzureVmScaleSetConfiguration

Object

Azure Virtual Machine Scale Set에 대해 설명합니다.

Name	형식	Description
deployment	string	Virtual Machine Scale Set 배포 식별자
instanceId	string	Virtual Machine Scale Set 인스턴스 식별자
name	string	Virtual Machine Scale Set 이름
resourceId	string	리소스의 고유 식별자입니다.

Bitness

열거형

컴퓨터 또는 프로세스의 비트 수를 지정합니다.

값	Description
32bit
64bit

Error

Object

오류 세부 정보입니다.

Name	형식	Description
code	string	특정 오류를 식별하는 오류 코드입니다.
message	string	호출자 로캘의 오류 메시지입니다.

ErrorResponse

Object

API의 오류 응답입니다.

Name	형식	Description
error	Error	오류 정보입니다.

HypervisorConfiguration

Object

컴퓨터의 하이퍼바이저 구성에 대해 설명합니다.

Name	형식	Description
hypervisorType	HypervisorType	하이퍼바이저에서 사용하는 가상화 기술(hyperv, vmware 등)을 지정합니다.
nativeHostMachineId	string	기본 가상화 시스템에서 보고한 하이퍼바이저 머신의 고유 식별자입니다.

HypervisorType

열거형

컴퓨터의 하이퍼바이저 유형을 지정합니다.

값	Description
unknown
hyperv

ImageConfiguration

Object

컴퓨터의 VM 이미지를 설명합니다.

Name	형식	Description
offering	string	VM 이미지 제공
publisher	string	VM 이미지의 게시자입니다.
sku	string	VM 이미지의 SKU입니다.
version	string	VM 이미지의 버전입니다.

Ipv4NetworkInterface

Object

IPv4 네트워크 인터페이스에 대해 설명합니다.

Name	형식	Default value	Description
ipAddress	string		IPv4 주소입니다.
subnetMask	string	255.255.255.255	IPv4 서브넷 마스크.

Ipv6NetworkInterface

Object

IPv6 네트워크 인터페이스에 대해 설명합니다.

Name	형식	Description
ipAddress	string	IPv6 주소입니다.

Machine

Object

컴퓨터 리소스는 검색된 컴퓨터 시스템을 나타냅니다. 모니터링되는, 즉 종속성 에이전트가 실행 중이거나 검색된 , 즉 모니터링되는 컴퓨터에서 데이터 스트림을 관찰하여 해당 존재가 유추되었을 수 있습니다. 컴퓨터가 변경되면 이전 버전의 컴퓨터 리소스가 유지되고 액세스할 수 있습니다. 종속성 에이전트가 해당 간격의 일부 동안 데이터를 보고했거나 다른 컴퓨터에서 실행되는 종속성 에이전트가 컴퓨터와 연결된 활동을 보고한 경우 컴퓨터는 시간 간격 동안 라이브 상태가 됩니다.

Name	형식	Description
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	호스팅 관련 구성입니다. VM에 대한 호스팅 정보가 검색되면 표시됩니다.
properties.hypervisor	HypervisorConfiguration	하이퍼바이저 관련 구성. 'virtualizationState'가 `hypervisor`경우에만 표시됩니다.
properties.monitoringState	MonitoringState	컴퓨터가 적극적으로 모니터링되는지 또는 검색되는지를 지정합니다.
properties.networking	NetworkConfiguration	네트워크 구성(IP, 게이트웨이, dns 등)
properties.operatingSystem	OperatingSystemConfiguration	운영 체제 정보입니다.
properties.resources	MachineResourcesConfiguration	컴퓨터 리소스(메모리, cpu 등).
properties.timestamp	string (date-time)	시스템에서 이 리소스가 업데이트된 UTC 날짜 및 시간입니다.
properties.timezone	Timezone	컴퓨터의 표준 시간대입니다.
properties.virtualMachine	VirtualMachineConfiguration	가상화 관련 구성입니다. `virtualizationState` `virtual`경우에만 표시됩니다.
properties.virtualizationState	VirtualizationState	머신이 가상화되는지 여부를 지정합니다.
type	string	리소스 종류입니다.

MachineRebootStatus

열거형

종속성 에이전트 설치 이후 컴퓨터가 다시 부팅되었는지를 지정합니다.

값	Description
unknown
rebooted
notRebooted

MachineResourcesConfiguration

Object

컴퓨터의 리소스에 대해 설명합니다.

Name	형식	Description
cpuSpeed	integer (int32)	메가헤르츠(Mhz)의 CPU 속도입니다.
cpuSpeedAccuracy	Accuracy	cpuSpeed 필드의 정확도를 설명합니다.
cpus	integer (int32)	CPU 수입니다.
physicalMemory	integer (int32)	실제 메모리(MB)입니다.

MonitoringState

열거형

리소스를 모니터링하거나 검색할지 여부를 지정하는 데 사용됩니다.

값	Description
monitored
discovered

NetworkConfiguration

Object

컴퓨터의 네트워크 구성에 대해 설명합니다.

Name	형식	Description
defaultIpv4Gateways	string[]	기본 IPv4 게이트웨이.
dnsNames	string[]	컴퓨터와 연결된 DNS 이름입니다.
ipv4Interfaces	Ipv4NetworkInterface[]	IPv4 인터페이스.
ipv6Interfaces	Ipv6NetworkInterface[]	IPv6 인터페이스.
macAddresses	string[]	모든 활성 네트워크 인터페이스의 MAC 주소입니다.

OperatingSystemConfiguration

Object

컴퓨터의 운영 체제 구성에 대해 설명합니다.

Name	형식	Description
bitness	Bitness	운영 체제 비트(32비트 또는 64비트).
family	OperatingSystemFamily	Windows, Linux 등
fullName	string	운영 체제 전체 이름입니다.

OperatingSystemFamily

열거형

운영 체제 패밀리(예: Linux, Windows 등)를 지정합니다.

값	Description
unknown
windows
linux
solaris
aix

Timezone

Object

표준 시간대를 설명합니다.

Name	형식	Description
fullName	string	표준 시간대 전체 이름입니다.

VirtualizationState

열거형

컴퓨터가 물리적, 가상, 하이퍼바이저 또는 알 수 없는지 여부를 지정합니다.

값	Description
unknown
physical
virtual
hypervisor

VirtualMachineConfiguration

Object

머신의 가상화 관련 구성에 대해 설명합니다.

Name	형식	Description
nativeHostMachineId	string	기본 가상화 시스템에서 보고한 이 가상 머신 호스트의 고유 식별자입니다.
nativeMachineId	string	기본 가상화 시스템에서 보고한 가상 머신의 고유 식별자입니다.
virtualMachineName	string	가상 머신의 이름입니다.
virtualMachineType	VirtualMachineType	컴퓨터에서 사용하는 가상화 기술(hyperv, vmware 등)을 지정합니다.

VirtualMachineType

열거형

머신의 가상화 유형을 지정합니다.

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