Machines - List Ports

リファレンス

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}/ports?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}/ports?api-version=2015-11-01-preview&startTime={startTime}&endTime={endTime}

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 バージョン。
endTime	query		string date-time	間隔の終了時刻を指定する UTC 日時。指定しない場合、サービスは DateTime.UtcNow を使用します
startTime	query		string date-time	間隔の開始時刻を指定する UTC 日時。指定しない場合、サービスは DateTime.UtcNow - 10m を使用します

応答

名前	型	説明
200 OK	PortCollection	操作は正常に完了しました。
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	ユーザーアカウントの借用

例

SMMachinesListPortsGet

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-999066c5-38c5-4f2f-9ce0-51d738cdc432/ports?api-version=2015-11-01-preview&startTime=2018-01-07T08:01:48.525Z&endTime=2018-01-07T08:01:48.525Z

Sample Response

Status code:: 200

{
  "value": [
    {
      "kind": "port",
      "properties": {
        "monitoringState": "monitored",
        "machine": {
          "kind": "ref:machine",
          "id": "/subscriptions/63BE4E24-FDF0-4E9C-9342-6A5D5A359722/resourceGroups/rg-sm/providers/Microsoft.OperationalInsights/workspaces/D6F79F14-E563-469B-84B5-9286D2803B2F/machines/m-999066c5-38c5-4f2f-9ce0-51d738cdc432",
          "type": "Microsoft.OperationalInsights/workspaces/features/machines",
          "name": "m-999066c5-38c5-4f2f-9ce0-51d738cdc432"
        },
        "displayName": ":8000",
        "ipAddress": "192.168.1.1",
        "portNumber": 8000
      },
      "id": "/subscriptions/63BE4E24-FDF0-4E9C-9342-6A5D5A359722/resourceGroups/rg-sm/providers/Microsoft.OperationalInsights/workspaces/D6F79F14-E563-469B-84B5-9286D2803B2F/machines/m-999066c5-38c5-4f2f-9ce0-51d738cdc432/ports/b-c0a80101_8000",
      "type": "Microsoft.OperationalInsights/workspaces/features/machines/ports",
      "name": "b-c0a80101_8000"
    },
    {
      "kind": "port",
      "properties": {
        "monitoringState": "monitored",
        "machine": {
          "kind": "ref:machine",
          "id": "/subscriptions/63BE4E24-FDF0-4E9C-9342-6A5D5A359722/resourceGroups/rg-sm/providers/Microsoft.OperationalInsights/workspaces/D6F79F14-E563-469B-84B5-9286D2803B2F/machines/m-999066c5-38c5-4f2f-9ce0-51d738cdc432",
          "type": "Microsoft.OperationalInsights/workspaces/features/machines",
          "name": "m-999066c5-38c5-4f2f-9ce0-51d738cdc432"
        },
        "displayName": ":8001",
        "ipAddress": "192.168.1.1",
        "portNumber": 8001
      },
      "id": "/subscriptions/63BE4E24-FDF0-4E9C-9342-6A5D5A359722/resourceGroups/rg-sm/providers/Microsoft.OperationalInsights/workspaces/D6F79F14-E563-469B-84B5-9286D2803B2F/machines/m-999066c5-38c5-4f2f-9ce0-51d738cdc432/ports/b-c0a80101_8001",
      "type": "Microsoft.OperationalInsights/workspaces/features/machines/ports",
      "name": "b-c0a80101_8001"
    },
    {
      "kind": "port",
      "properties": {
        "monitoringState": "monitored",
        "machine": {
          "kind": "ref:machine",
          "id": "/subscriptions/63BE4E24-FDF0-4E9C-9342-6A5D5A359722/resourceGroups/rg-sm/providers/Microsoft.OperationalInsights/workspaces/D6F79F14-E563-469B-84B5-9286D2803B2F/machines/m-999066c5-38c5-4f2f-9ce0-51d738cdc432",
          "type": "Microsoft.OperationalInsights/workspaces/features/machines",
          "name": "m-999066c5-38c5-4f2f-9ce0-51d738cdc432"
        },
        "displayName": ":8002",
        "ipAddress": "192.168.1.1",
        "portNumber": 8002
      },
      "id": "/subscriptions/63BE4E24-FDF0-4E9C-9342-6A5D5A359722/resourceGroups/rg-sm/providers/Microsoft.OperationalInsights/workspaces/D6F79F14-E563-469B-84B5-9286D2803B2F/machines/m-999066c5-38c5-4f2f-9ce0-51d738cdc432/ports/b-c0a80101_8002",
      "type": "Microsoft.OperationalInsights/workspaces/features/machines/ports",
      "name": "b-c0a80101_8002"
    }
  ]
}

定義

名前	説明
ClientGroupReference	クライアントグループへの参照。
Error	エラーの詳細。
ErrorResponse	API からのエラー応答。
MachineReference	マシンへの参照。
MachineReferenceWithHints	マシンの名前とオペレーティングシステムのヒントを含むマシン参照。
MonitoringState	リソースを監視または検出するかどうかを指定するために使用されます。
OperatingSystemFamily	オペレーティングシステムファミリ (Linux、Windows など) を指定します。
Port	ポートリソースは、マシン上のサーバーポートを表します。ポートはアクティブに監視される場合があります。つまり、依存関係エージェントがそのマシン上で実行されているか、検出されたか、監視対象のマシンからのデータストリームを監視することによって、その存在が推論されました。そのポートがその間隔の (部分) の間にアクティビティを関連付けた場合、ポートは一定期間中にライブになります。
PortCollection	ポートリソースのコレクション。
PortReference	ポートへの参照。
ProcessReference	プロセスへの参照。

ClientGroupReference

クライアントグループへの参照。

名前	型	説明
id	string	リソース URI。
kind	string: ref:clientgroup	参照のサブタイプを指定します。
name	string	リソース名。
type	string	リソースの種類修飾子。

Error

エラーの詳細。

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

ErrorResponse

API からのエラー応答。

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

MachineReference

マシンへの参照。

名前	型	説明
id	string	リソース URI。
kind	string: ref:machine	参照のサブタイプを指定します。
name	string	リソース名。
type	string	リソースの種類修飾子。

MachineReferenceWithHints

マシンの名前とオペレーティングシステムのヒントを含むマシン参照。

名前	型	説明
id	string	リソース URI。
kind	string: ref:machinewithhints	参照のサブタイプを指定します。
name	string	リソース名。
properties.displayNameHint	string	最後の既知の表示名。
properties.osFamilyHint	OperatingSystemFamily	最後の既知のオペレーティングシステムファミリ。
type	string	リソースの種類修飾子。

MonitoringState

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

名前	型	説明
discovered	string
monitored	string

OperatingSystemFamily

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

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

Port

ポートリソースは、マシン上のサーバーポートを表します。ポートはアクティブに 監視される場合があります。つまり、依存関係エージェントがそのマシン上で実行されているか、検出 されたか、監視対象のマシンからのデータストリームを監視することによって、その存在が推論されました。そのポートがその間隔の (部分) の間にアクティビティを関連付けた場合、ポートは一定期間中にライブになります。

名前	型	説明
etag	string	リソース ETAG。
id	string	リソース識別子。
kind	string: port	追加のリソースの種類修飾子。
name	string	リソース名。
properties.displayName	string	表示目的で使用する名前。
properties.ipAddress	string	ポートに関連付けられている IP アドレス。現時点では、IPv4 アドレスのみがサポートされています。
properties.machine	ResourceReference: ClientGroupReference MachineReference MachineReferenceWithHints PortReference ProcessReference	このポートをホストしているマシン。
properties.monitoringState	MonitoringState	ポートをアクティブに監視するか、検出するかを指定します。
properties.portNumber	integer	ポート番号。
type	string	リソースの種類。

PortCollection

ポートリソースのコレクション。

名前	型	説明
nextLink	string	次のリソースセットへの URL。
value	Port[]	ポートリソースのコレクション。

PortReference

ポートへの参照。

名前	型	説明
id	string	リソース URI。
kind	string: ref:port	参照のサブタイプを指定します。
name	string	リソース名。
properties.ipAddress	string	ポートの IP アドレス。
properties.machine	MachineReference	ポートをホストしているマシン。
properties.portNumber	integer	ポート番号。
type	string	リソースの種類修飾子。

ProcessReference

プロセスへの参照。

名前	型	説明
id	string	リソース URI。
kind	string: ref:process	参照のサブタイプを指定します。
name	string	リソース名。
properties.machine	MachineReference	プロセスをホストしているマシン。
type	string	リソースの種類修飾子。

次の方法で共有