다음을 통해 공유


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(다음 안에) 필수 형식 Description
machineName
path True

string

컴퓨터 리소스 이름입니다.

resourceGroupName
path True

string

지정된 subscriptionId 내의 리소스 그룹 이름입니다.

regex 패턴: [a-zA-Z0-9_-]+

subscriptionId
path True

string

Azure 구독 식별자입니다.

workspaceName
path True

string

관심 있는 리소스가 포함된 OMS 작업 영역입니다.

regex 패턴: [a-zA-Z0-9_][a-zA-Z0-9_-]+[a-zA-Z0-9_]

api-version
query True

string

API 버전.

timestamp
query

string

date-time

머신 리소스를 평가할 시간을 기준으로 instance 시간을 지정하는 UTC 날짜 및 시간입니다. 지정하지 않으면 서비스에서 DateTime.UtcNow를 사용합니다.

응답

Name 형식 Description
200 OK

Machine

작업이 성공적으로 완료되었습니다.

Other Status Codes

ErrorResponse

이 요청을 처리하는 동안 오류가 발생했습니다. 특정 오류를 식별하려면 error.code 매개 변수를 참조하세요.

보안

azure_auth

Azure Active Directory OAuth2 Flow

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

범위

Name Description
user_impersonation 사용자 계정 가장

예제

SMMachinesGetGet

샘플 요청

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

샘플 응답

{
  "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 Cloud Service 역할의 유형을 지정하는 데 사용됩니다.

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

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

Name 형식 Description
actual

string

estimated

string

AgentConfiguration

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

Name 형식 Description
agentId

string

Health Service Agent 고유 식별자입니다.

clockGranularity

integer

컴퓨터 클록 세분성(밀리초)입니다.

dependencyAgentId

string

종속성 에이전트 고유 식별자입니다.

dependencyAgentRevision

string

종속성 에이전트 수정 번호입니다.

dependencyAgentVersion

string

종속성 에이전트 버전 번호입니다.

rebootStatus

MachineRebootStatus

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

AzureCloudServiceConfiguration

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

Name 형식 Description
deployment

string

클라우드 서비스 배포 식별자

instanceId

string

Cloud Service instance 식별자

name

string

클라우드 서비스 이름

roleName

string

Cloud Service 역할 이름

roleType

AzureCloudServiceRoleType

Azure Cloud Service 역할의 유형을 지정하는 데 사용됩니다.

AzureCloudServiceRoleType

Azure Cloud Service 역할의 유형을 지정하는 데 사용됩니다.

Name 형식 Description
unknown

string

web

string

worker

string

AzureHostingConfiguration

컴퓨터가 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

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

Name 형식 Description
clusterId

string

Service Fabric 클러스터 식별자입니다.

name

string

Service Fabric 클러스터 이름입니다.

AzureVmScaleSetConfiguration

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

Name 형식 Description
deployment

string

Virtual Machine Scale Set 배포 식별자

instanceId

string

Virtual Machine Scale Set instance 식별자

name

string

Virtual Machine Scale Set 이름

resourceId

string

리소스의 고유 식별자입니다.

Bitness

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

Name 형식 Description
32bit

string

64bit

string

Error

오류 세부 정보입니다.

Name 형식 Description
code

string

특정 오류를 식별하는 오류 코드입니다.

message

string

호출자 로캘의 오류 메시지입니다.

ErrorResponse

API의 오류 응답입니다.

Name 형식 Description
error

Error

오류 정보입니다.

HypervisorConfiguration

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

Name 형식 Description
hypervisorType

HypervisorType

하이퍼바이저에서 사용하는 가상화 기술(하이퍼바이저, vmware 등)을 지정합니다.

nativeHostMachineId

string

기본 가상화 시스템에서 보고한 하이퍼바이저 머신의 고유 식별자입니다.

HypervisorType

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

Name 형식 Description
hyperv

string

unknown

string

ImageConfiguration

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

Name 형식 Description
offering

string

VM 이미지 제공.

publisher

string

VM 이미지의 게시자입니다.

sku

string

VM 이미지의 SKU입니다.

version

string

VM 이미지의 버전입니다.

Ipv4NetworkInterface

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

Name 형식 Default value Description
ipAddress

string

IPv4 주소.

subnetMask

string

255.255.255.255

IPv4 서브넷 마스크.

Ipv6NetworkInterface

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

Name 형식 Description
ipAddress

string

IPv6 주소입니다.

Machine

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

Name 형식 Description
etag

string

리소스 ETAG.

id

string

리소스 식별자.

kind string:

machine

추가 리소스 종류 한정자입니다.

name

string

리소스 이름입니다.

properties.agent

AgentConfiguration

종속성 에이전트 구성.

properties.bootTime

string

머신이 마지막으로 부팅된 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

시스템에서 이 리소스가 업데이트된 UTC 날짜 및 시간입니다.

properties.timezone

Timezone

컴퓨터의 표준 시간대입니다.

properties.virtualMachine

VirtualMachineConfiguration

가상화 관련 구성. 가 인 경우에만 virtualizationState 을 표시합니다 virtual.

properties.virtualizationState

VirtualizationState

머신이 가상화되는지 여부를 지정합니다.

type

string

리소스 종류.

MachineRebootStatus

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

Name 형식 Description
notRebooted

string

rebooted

string

unknown

string

MachineResourcesConfiguration

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

Name 형식 Description
cpuSpeed

integer

메가헤르츠(Mhz)의 CPU 속도입니다.

cpuSpeedAccuracy

Accuracy

cpuSpeed 필드의 정확도를 설명합니다.

cpus

integer

CPU 수 -

physicalMemory

integer

실제 메모리(MB)입니다.

MonitoringState

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

Name 형식 Description
discovered

string

monitored

string

NetworkConfiguration

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

Name 형식 Description
defaultIpv4Gateways

string[]

기본 IPv4 게이트웨이.

dnsNames

string[]

컴퓨터와 연결된 DNS 이름입니다.

ipv4Interfaces

Ipv4NetworkInterface[]

IPv4 인터페이스.

ipv6Interfaces

Ipv6NetworkInterface[]

IPv6 인터페이스.

macAddresses

string[]

모든 활성 네트워크 인터페이스의 MAC 주소입니다.

OperatingSystemConfiguration

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

Name 형식 Description
bitness

Bitness

운영 체제 비트 수(32비트 또는 64비트).

family

OperatingSystemFamily

Windows, Linux 등

fullName

string

운영 체제 전체 이름입니다.

OperatingSystemFamily

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

Name 형식 Description
aix

string

linux

string

solaris

string

unknown

string

windows

string

Timezone

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

Name 형식 Description
fullName

string

표준 시간대 전체 이름입니다.

VirtualizationState

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

Name 형식 Description
hypervisor

string

physical

string

unknown

string

virtual

string

VirtualMachineConfiguration

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

Name 형식 Description
nativeHostMachineId

string

기본 가상화 시스템에서 보고한 이 가상 머신 호스트의 고유 식별자입니다.

nativeMachineId

string

기본 가상화 시스템에서 보고한 가상 머신의 고유 식별자입니다.

virtualMachineName

string

가상 머신의 이름입니다.

virtualMachineType

VirtualMachineType

컴퓨터에서 사용하는 가상화 기술(hyperv, vmware 등)을 지정합니다.

VirtualMachineType

컴퓨터의 가상화 유형을 지정합니다.

Name 형식 Description
hyperv

string

ldom

string

lpar

string

unknown

string

virtualPc

string

vmware

string

xen

string