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 パラメーター

名前	/	必須	型	説明
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 を使用します。

応答

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

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
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"
}

定義

名前	説明
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 が実行されている場合や、検出、監視対象のマシンからのデータ ストリームを監視することによってその存在が推論された場合などです。 マシンが変更されると、以前のバージョンのマシン リソースが保持され、アクセスできるようになります。 依存関係エージェントがその間隔の間 (一部) にデータを報告した場合、または他のマシンで実行されている依存関係エージェントがマシンに関連付けられているアクティビティを報告した場合、マシンは一定期間中に稼働しています。
MachineRebootStatus	依存関係エージェントのインストール後にマシンが再起動されたかどうかを指定します。
MachineResourcesConfiguration	マシンのリソースについて説明します。
MonitoringState	リソースを監視または検出するかどうかを指定するために使用されます。
NetworkConfiguration	マシンのネットワーク構成について説明します。
OperatingSystemConfiguration	コンピューターのオペレーティング システムの構成について説明します。
OperatingSystemFamily	オペレーティング システム ファミリ (Linux、Windows など) を指定します。
Timezone	タイムゾーンについて説明します。
VirtualizationState	マシンが物理、仮想、ハイパーバイザー、または不明かどうかを指定します。
VirtualMachineConfiguration	コンピューターの仮想化関連の構成について説明します。
VirtualMachineType	マシンの仮想化の種類を指定します。

Accuracy

列挙

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

値	説明
actual
estimated

AgentConfiguration

Object

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

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

AzureCloudServiceConfiguration

Object

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

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

AzureCloudServiceRoleType

列挙

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

値	説明
unknown
worker
web

AzureHostingConfiguration

Object

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

名前	型	説明
cloudService	AzureCloudServiceConfiguration	Azure クラウド サービスとしてホストされているマシンに関する情報が含まれています
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

Object

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

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

AzureVmScaleSetConfiguration

Object

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

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

Bitness

列挙

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

値	説明
32bit
64bit

Error

Object

エラーの詳細。

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

ErrorResponse

Object

API からのエラー応答。

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

HypervisorConfiguration

Object

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

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

HypervisorType

列挙

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

値	説明
unknown
hyperv

ImageConfiguration

Object

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

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

Ipv4NetworkInterface

Object

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

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

Ipv6NetworkInterface

Object

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

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

Machine

Object

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

名前	型	説明
etag	string	リソース ETAG。
id	string	リソース識別子。
kind	string: machine	追加のリソースの種類修飾子。
name	string	リソース名。
properties.agent	AgentConfiguration	Dependency Agent の構成。
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	ネットワーク構成 (ips、ゲートウェイ、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

列挙

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

値	説明
unknown
rebooted
notRebooted

MachineResourcesConfiguration

Object

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

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

MonitoringState

列挙

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

値	説明
monitored
discovered

NetworkConfiguration

Object

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

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

OperatingSystemConfiguration

Object

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

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

OperatingSystemFamily

列挙

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

値	説明
unknown
windows
linux
solaris
aix

Timezone

Object

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

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

VirtualizationState

列挙

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

値	説明
unknown
physical
virtual
hypervisor

VirtualMachineConfiguration

Object

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

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

VirtualMachineType

列挙

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

値	説明
unknown
hyperv
ldom
lpar
vmware
virtualPc
xen