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 Required Type Description
machineName
path True
  • string

マシンリソース名。

resourceGroupName
path True
  • string

指定された subscriptionId 内のリソースグループ名。

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

subscriptionId
path True
  • string

Azure サブスクリプションの識別子。

workspaceName
path True
  • string

目的のリソースが含まれている OMS ワークスペース。

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

api-version
query True
  • string

API バージョン。

timestamp
query
  • string
date-time

コンピューターリソースの評価に関連する時間インスタンスを指定する UTC 日時。 指定しない場合、サービスは UtcNow を使用します。

応答

Name Type Description
200 OK

操作は正常に完了しました。

Other Status Codes

要求の処理中にエラーが発生しました。 特定のエラーを特定するには、エラーコードを参照してください。

セキュリティ

azure_auth

Azure Active DirectoryOAuth2 Flow

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

Scopes

Name Description
user_impersonation ユーザー アカウントを偽装する

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

定義

Accuracy

計算の精度を指定します。

AgentConfiguration

コンピューターにインストールされている Dependency Agent の構成について説明します。

AzureCloudServiceConfiguration

Azure クラウド サービスについて説明します

AzureCloudServiceRoleType

Azure クラウド サービス ロールの種類を指定するために使用されます

AzureHostingConfiguration

Azure でのマシンのホスト方法に関する情報を提供します。

AzureServiceFabricClusterConfiguration

Azure Service Fabric クラスターについて説明します

AzureVmScaleSetConfiguration

Azure 仮想マシン スケール セットについて説明します

Bitness

コンピューターまたはプロセスのビット数を指定します。

Error

エラーの詳細。

ErrorResponse

API からのエラー応答。

HypervisorConfiguration

コンピューターのハイパーバイザー構成について説明します。

HypervisorType

コンピューターのハイパーバイザーの種類を指定します。

ImageConfiguration

マシンの VM イメージについて説明します。

Ipv4NetworkInterface

IPv4 ネットワークインターフェイスについて説明します。

Ipv6NetworkInterface

IPv6 ネットワークインターフェイスについて説明します。

Machine

コンピューターリソースは、検出されたコンピューターシステムを表します。 監視 することができます。つまり、Dependency Agent が実行されているか、検出 されたことを示します。つまり、監視対象のコンピューターからデータストリームを観察することによってその存在が推測されています。 マシンが変更されると、以前のバージョンのマシンリソースが保持され、アクセスできるようになります。 コンピューターは、時間間隔の間、Dependency Agent がその間隔の間にデータを報告した場合、または他のコンピューターで実行されている依存関係エージェントがそのコンピューターに関連付けられているアクティビティを報告した場合に、一定の時間内にライブします。

MachineRebootStatus

Dependency agent のインストール後にマシンを再起動したかどうかを指定します。

MachineResourcesConfiguration

コンピューターのリソースについて説明します。

MonitoringState

リソースが監視されるか、検出されるかを指定するために使用します。

NetworkConfiguration

コンピューターのネットワーク構成について説明します。

OperatingSystemConfiguration

コンピューターのオペレーティングシステムの構成について説明します。

OperatingSystemFamily

オペレーティングシステムファミリ (Linux、Windows など) を指定します。

Timezone

タイムゾーンについて説明します。

VirtualizationState

コンピューターが物理、仮想、ハイパーバイザー、不明のいずれであるかを指定します。

VirtualMachineConfiguration

仮想化に関連するコンピューターの構成について説明します。

VirtualMachineType

コンピューターの仮想化の種類を指定します。

Accuracy

計算の精度を指定します。

Name Type Description
actual
  • string
estimated
  • string

AgentConfiguration

コンピューターにインストールされている Dependency Agent の構成について説明します。

Name Type Description
agentId
  • string

ヘルス サービスエージェントの一意の識別子。

clockGranularity
  • integer

コンピュータークロックの粒度 (ミリ秒単位)。

dependencyAgentId
  • string

Dependency Agent 一意識別子です。

dependencyAgentRevision
  • string

Dependency Agent リビジョン番号。

dependencyAgentVersion
  • string

Dependency Agent のバージョン番号。

rebootStatus

Dependency Agent のインストール以降にコンピューターが再起動されたかどうかを指定します。

AzureCloudServiceConfiguration

Azure クラウド サービスについて説明します

Name Type Description
deployment
  • string

クラウド サービスのデプロイ識別子

instanceId
  • string

Cloud Service インスタンス識別子

name
  • string

[クラウド サービス名]

roleName
  • string

クラウド サービス ロールの名前

roleType

Azure クラウド サービス ロールの種類を指定するために使用されます

AzureCloudServiceRoleType

Azure クラウド サービス ロールの種類を指定するために使用されます

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

AzureHostingConfiguration

Azure でのマシンのホスト方法に関する情報を提供します。

Name Type Description
cloudService

Azure クラウドサービスとしてホストされているマシンに関する情報が含まれています。

faultDomain
  • string

VM の障害ドメイン。

image

コンピューターのイメージ。

kind string:
  • provider:azure

追加のホスティング構成の種類修飾子。

location
  • string

VM の地理的な場所。

name
  • string

ホスティングプロバイダーに応じたコンピューター名。

provider enum:
  • azure

VM のホスティング プロバイダー。

resourceGroup
  • string

指定されたサブスクリプション内のリソースグループ名。

resourceId
  • string

リソースの一意識別子。

serviceFabricCluster

Azure Service Fabric Cluster に属するマシンに関する情報が含まれる

size
  • string

VM のサイズ。

subscriptionId
  • string

[サブスクリプション ID] が表示されます。

updateDomain
  • string

VM のドメインを更新します。

vmId
  • string

仮想マシン ID (一意の識別子)。

vmScaleSet

Azure 仮想マシン スケール セットとしてホストされているマシンに関する情報が含まれる

AzureServiceFabricClusterConfiguration

Azure Service Fabric クラスターについて説明します

Name Type Description
clusterId
  • string

Service Fabric識別子。

name
  • string

Service Fabricクラスター名。

AzureVmScaleSetConfiguration

Azure 仮想マシン スケール セットについて説明します

Name Type Description
deployment
  • string

仮想マシン スケール セットのデプロイ識別子

instanceId
  • string

仮想マシン スケール セットのインスタンス識別子

name
  • string

仮想マシン スケール セット名

resourceId
  • string

リソースの一意識別子。

Bitness

コンピューターまたはプロセスのビット数を指定します。

Name Type Description
32bit
  • string
64bit
  • string

Error

エラーの詳細。

Name Type Description
code
  • string

特定のエラーを識別するエラーコード。

message
  • string

呼び出し元のロケールのエラーメッセージ。

ErrorResponse

API からのエラー応答。

Name Type Description
error

エラー情報。

HypervisorConfiguration

コンピューターのハイパーバイザー構成について説明します。

Name Type Description
hypervisorType

ハイパーバイザーによって使用される仮想化テクノロジ (hyperv、vmware など) を指定します。

nativeHostMachineId
  • string

基になる仮想化システムによって報告された、ハイパーバイザーコンピューターの一意の識別子。

HypervisorType

コンピューターのハイパーバイザーの種類を指定します。

Name Type Description
hyperv
  • string
unknown
  • string

ImageConfiguration

マシンの VM イメージについて説明します。

Name Type Description
offering
  • string

VM イメージのオファリング。

publisher
  • string

VM イメージの発行元。

sku
  • string

VM イメージの SKU。

version
  • string

VM イメージのバージョン。

Ipv4NetworkInterface

IPv4 ネットワークインターフェイスについて説明します。

Name Type Description
ipAddress
  • string

IPv4 アドレス。

subnetMask
  • string

IPv4 サブネットマスク。

Ipv6NetworkInterface

IPv6 ネットワークインターフェイスについて説明します。

Name Type Description
ipAddress
  • string

IPv6 アドレス。

Machine

コンピューターリソースは、検出されたコンピューターシステムを表します。 監視 することができます。つまり、Dependency Agent が実行されているか、検出 されたことを示します。つまり、監視対象のコンピューターからデータストリームを観察することによってその存在が推測されています。 マシンが変更されると、以前のバージョンのマシンリソースが保持され、アクセスできるようになります。 コンピューターは、時間間隔の間、Dependency Agent がその間隔の間にデータを報告した場合、または他のコンピューターで実行されている依存関係エージェントがそのコンピューターに関連付けられているアクティビティを報告した場合に、一定の時間内にライブします。

Name Type Description
etag
  • string

リソース ETAG。

id
  • string

リソース識別子。

kind string:
  • machine

追加のリソースの種類の修飾子。

name
  • string

リソース名。

properties.agent

構成を Dependency Agent します。

properties.bootTime
  • string

コンピューターが最後に起動した日時 (UTC)

properties.computerName
  • string

コンピューターの名前 (例: サーバー)

properties.displayName
  • string

表示目的で使用する名前

properties.fullyQualifiedDomainName
  • string

コンピューターの完全修飾名 (例: server.company.com)

properties.hosting HostingConfiguration:

ホスティング関連の構成。 VM のホスト情報が検出された場合に表示されます。

properties.hypervisor

ハイパーバイザー関連の構成。 ' VirtualizationState ' がの場合にのみ存在 hypervisor します。

properties.monitoringState

コンピューターがアクティブに監視または検出されているかどうかを指定します。

properties.networking

ネットワーク構成 (ip、ゲートウェイ、dns など)

properties.operatingSystem

オペレーティングシステムの情報。

properties.resources

マシンリソース (メモリ、cpu など)。

properties.timestamp
  • string

このリソースがシステムで更新された UTC 日時。

properties.timezone

コンピューターのタイムゾーン。

properties.virtualMachine

仮想化に関連する構成。 がの場合にのみ存在 virtualizationState virtual します。

properties.virtualizationState

コンピューターが仮想化されているかどうかを指定します。

type
  • string

リソースの種類。

MachineRebootStatus

Dependency agent のインストール後にマシンを再起動したかどうかを指定します。

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

MachineResourcesConfiguration

コンピューターのリソースについて説明します。

Name Type Description
cpuSpeed
  • integer

CPU 速度 (Mhz)。

cpuSpeedAccuracy

CpuSpeed フィールドの精度について説明します。

cpus
  • integer

[CPU 数]:

physicalMemory
  • integer

物理メモリ (mb)。

MonitoringState

リソースが監視されるか、検出されるかを指定するために使用します。

Name Type Description
discovered
  • string
monitored
  • string

NetworkConfiguration

コンピューターのネットワーク構成について説明します。

Name Type Description
defaultIpv4Gateways
  • string[]

既定の IPv4 ゲートウェイ。

dnsNames
  • string[]

コンピューターに関連付けられている DNS 名。

ipv4Interfaces

IPv4 インターフェイス。

ipv6Interfaces

IPv6 インターフェイス。

macAddresses
  • string[]

すべてのアクティブなネットワークインターフェイスの MAC アドレス。

OperatingSystemConfiguration

コンピューターのオペレーティングシステムの構成について説明します。

Name Type Description
bitness

オペレーティングシステムのビット数 (32 ビットまたは64ビット)。

family

Windows、Linux など。

fullName
  • string

オペレーティングシステムのフルネーム。

OperatingSystemFamily

オペレーティングシステムファミリ (Linux、Windows など) を指定します。

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

Timezone

タイムゾーンについて説明します。

Name Type Description
fullName
  • string

タイムゾーンの完全な名前。

VirtualizationState

コンピューターが物理、仮想、ハイパーバイザー、不明のいずれであるかを指定します。

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

VirtualMachineConfiguration

仮想化に関連するコンピューターの構成について説明します。

Name Type Description
nativeHostMachineId
  • string

基になる仮想化システムによって報告された、この仮想マシンのホストの一意の識別子。

nativeMachineId
  • string

基になる仮想化システムによって報告された仮想マシンの一意の識別子。

virtualMachineName
  • string

仮想マシンの名前。

virtualMachineType

コンピューターによって使用される仮想化テクノロジ (hyperv、vmware など) を指定します。

VirtualMachineType

コンピューターの仮想化の種類を指定します。

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