Machines - Get

リファレンス

Service:: Service Map

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

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}

URI パラメーター

名前	/	必須	型	説明
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 日付と時刻。指定しない場合、サービスは DateTime.UtcNow を使用します。

応答

名前	型	説明
200 OK	Machine	操作は正常に完了しました。
Other Status Codes	ErrorResponse	要求の処理中にエラーが発生しました。特定のエラーを特定するには、error.code パラメーターを参照してください。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

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

Scopes

名前	説明
user_impersonation	ユーザーアカウントの借用

例

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

定義

名前	説明
Accuracy	計算の精度を指定します。
AgentConfiguration	マシンにインストールされている依存関係エージェントの構成について説明します。
AzureCloudServiceConfiguration	Azure Cloud Service について説明します
AzureCloudServiceRoleType	Azure Cloud Service ロールの種類を指定するために使用します
AzureHostingConfiguration	Azure でのマシンのホスト方法に関する情報を提供します
AzureServiceFabricClusterConfiguration	Azure Service Fabric クラスターについて説明します
AzureVmScaleSetConfiguration	Azure 仮想マシンスケールセットについて説明します
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

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

名前	型	説明
actual	string
estimated	string

AgentConfiguration

マシンにインストールされている依存関係エージェントの構成について説明します。

名前	型	説明
agentId	string	Health Service エージェントの一意識別子。
clockGranularity	integer	マシンクロックの細分性 (ミリ秒単位)。
dependencyAgentId	string	依存関係エージェントの一意識別子。
dependencyAgentRevision	string	Dependency Agent リビジョン番号。
dependencyAgentVersion	string	依存関係エージェントのバージョン番号。
rebootStatus	MachineRebootStatus	Dependency Agent のインストール後にマシンが再起動されたかどうかを指定します。

AzureCloudServiceConfiguration

Azure Cloud Service について説明します

名前	型	説明
deployment	string	クラウドサービスのデプロイ識別子
instanceId	string	クラウドサービスインスタンス識別子
name	string	[クラウドサービス名]
roleName	string	クラウドサービスロールの名前
roleType	AzureCloudServiceRoleType	Azure Cloud Service ロールの種類を指定するために使用します

AzureCloudServiceRoleType

Azure Cloud Service ロールの種類を指定するために使用します

名前	型	説明
unknown	string
web	string
worker	string

AzureHostingConfiguration

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

名前	型	説明
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	仮想マシン ID (一意識別子)。
vmScaleSet	AzureVmScaleSetConfiguration	Azure 仮想マシンスケールセットとしてホストされているマシンに関する情報が含まれています

AzureServiceFabricClusterConfiguration

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

名前	型	説明
clusterId	string	Service Fabric クラスター識別子。
name	string	Service Fabric クラスター名。

AzureVmScaleSetConfiguration

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

名前	型	説明
deployment	string	仮想マシンスケールセットのデプロイ識別子
instanceId	string	仮想マシンスケールセットインスタンス識別子
name	string	仮想マシンスケールセットの名前
resourceId	string	リソースの一意識別子。

Bitness

マシンまたはプロセスのビット数を指定します。

名前	型	説明
32bit	string
64bit	string

Error

エラーの詳細。

名前	型	説明
code	string	特定のエラーを識別するエラーコード。
message	string	呼び出し元のロケールのエラーメッセージ。

ErrorResponse

API からのエラー応答。

名前	型	説明
error	Error	エラー情報。

HypervisorConfiguration

マシンのハイパーバイザー構成について説明します。

名前	型	説明
hypervisorType	HypervisorType	ハイパーバイザーによって使用される仮想化テクノロジ (hyperv、vmware など) を指定します。
nativeHostMachineId	string	基になる仮想化システムによって報告されるハイパーバイザーマシンの一意識別子。

HypervisorType

マシンのハイパーバイザーの種類を指定します。

名前	型	説明
hyperv	string
unknown	string

ImageConfiguration

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

名前	型	説明
offering	string	VM イメージのオファリング。
publisher	string	VM イメージの発行元。
sku	string	VM イメージの SKU。
version	string	VM イメージのバージョン。

Ipv4NetworkInterface

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

名前	型	既定値	説明
ipAddress	string		IPv4 アドレス。
subnetMask	string	255.255.255.255	IPv4 サブネットマスク。

Ipv6NetworkInterface

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

名前	型	説明
ipAddress	string	IPv6 アドレス。

Machine

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

名前	型	説明
etag	string	リソース ETAG。
id	string	リソース識別子。
kind	string: machine	追加のリソースの種類修飾子。
name	string	リソース名。
properties.agent	AgentConfiguration	Dependency Agent の構成。
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	ネットワーク構成 (ips、ゲートウェイ、dns など)
properties.operatingSystem	OperatingSystemConfiguration	オペレーティングシステム情報。
properties.resources	MachineResourcesConfiguration	マシンリソース (メモリ、CPU など)。
properties.timestamp	string	システムでこのリソースが更新された UTC 日時。
properties.timezone	Timezone	マシンのタイムゾーン。
properties.virtualMachine	VirtualMachineConfiguration	仮想化関連の構成。が `virtual`の場合`virtualizationState`にのみ存在します。
properties.virtualizationState	VirtualizationState	マシンを仮想化するかどうかを指定します。
type	string	リソースの種類。

MachineRebootStatus

依存関係エージェントのインストール後にマシンが再起動されたかどうかを指定します。

名前	型	説明
notRebooted	string
rebooted	string
unknown	string

MachineResourcesConfiguration

マシンのリソースについて説明します。

名前	型	説明
cpuSpeed	integer	メガヘルツ (Mhz) の CPU 速度。
cpuSpeedAccuracy	Accuracy	cpuSpeed フィールドの精度について説明します。
cpus	integer	[CPU 数]:
physicalMemory	integer	物理メモリ (MB 単位)。

MonitoringState

リソースを監視または検出するかどうかを指定するために使用されます。

名前	型	説明
discovered	string
monitored	string

NetworkConfiguration

マシンのネットワーク構成について説明します。

名前	型	説明
defaultIpv4Gateways	string[]	既定の IPv4 ゲートウェイ。
dnsNames	string[]	マシンに関連付けられている DNS 名。
ipv4Interfaces	Ipv4NetworkInterface[]	IPv4 インターフェイス。
ipv6Interfaces	Ipv6NetworkInterface[]	IPv6 インターフェイス。
macAddresses	string[]	すべてのアクティブなネットワークインターフェイスの MAC アドレス。

OperatingSystemConfiguration

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

名前	型	説明
bitness	Bitness	オペレーティングシステムのビット数 (32 ビットまたは 64 ビット)。
family	OperatingSystemFamily	Windows、Linux など
fullName	string	オペレーティングシステムのフルネーム。

OperatingSystemFamily

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

名前	型	説明
aix	string
linux	string
solaris	string
unknown	string
windows	string

Timezone

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

名前	型	説明
fullName	string	タイムゾーンの完全な名前。

VirtualizationState

マシンが物理、仮想、ハイパーバイザー、または不明であるかどうかを指定します。

名前	型	説明
hypervisor	string
physical	string
unknown	string
virtual	string

VirtualMachineConfiguration

マシンの仮想化関連の構成について説明します。

名前	型	説明
nativeHostMachineId	string	基になる仮想化システムによって報告される、この仮想マシンのホストの一意識別子。
nativeMachineId	string	基になる仮想化システムによって報告される仮想マシンの一意識別子。
virtualMachineName	string	仮想マシンの名前。
virtualMachineType	VirtualMachineType	マシンで使用される仮想化テクノロジ (hyperv、vmware など) を指定します。

VirtualMachineType

マシンの仮想化の種類を指定します。

名前	型	説明
hyperv	string
ldom	string
lpar	string
unknown	string
virtualPc	string
vmware	string
xen	string