Ports - List Connections

サービス:: 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}/ports/{portName}/connections?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/{portName}/connections?api-version=2015-11-01-preview&startTime={startTime}&endTime={endTime}

URI パラメーター

名前	/	必須	型	説明
machineName	path	True	string minLength: 3 maxLength: 64	マシンリソース名。
portName	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 バージョン。
endTime	query		string (date-time)	間隔の終了時刻を指定する UTC 日時。指定されていない場合、サービスは DateTime.UtcNow を使用します
startTime	query		string (date-time)	間隔の開始時刻を指定する UTC 日時。指定されていない場合、サービスは DateTime.UtcNow - 10m を使用します

応答

名前	型	説明
200 OK	ConnectionCollection	操作が正常に完了しました。
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	ユーザーアカウントを偽装する

例

SMMachinesPortsListConnectionsGet

要求のサンプル

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/ports/b-c0a8010a_10000/connections?api-version=2015-11-01-preview&startTime=2018-01-08T23:05:16.7985488Z&endTime=2018-01-08T23:07:16.7985488Z

応答のサンプル

状態コード:: 200

{
  "value": [
    {
      "kind": "rel:connection",
      "properties": {
        "source": {
          "kind": "ref:process",
          "properties": {
            "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-9b60b5e7-fb98-4864-9a1f-51d26407f99b",
              "type": "Microsoft.OperationalInsights/workspaces/features/machines",
              "name": "m-9b60b5e7-fb98-4864-9a1f-51d26407f99b"
            }
          },
          "id": "/subscriptions/63BE4E24-FDF0-4E9C-9342-6A5D5A359722/resourceGroups/rg-sm/providers/Microsoft.OperationalInsights/workspaces/D6F79F14-E563-469B-84B5-9286D2803B2F/machines/m-9b60b5e7-fb98-4864-9a1f-51d26407f99b/processes/p-d642fef420c5baa4c72f53de9426f1ed699899e2",
          "type": "Microsoft.OperationalInsights/workspaces/features/machines/processes",
          "name": "p-d642fef420c5baa4c72f53de9426f1ed699899e2"
        },
        "destination": {
          "kind": "ref:process",
          "properties": {
            "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-A4AB1C69-03E9-42D2-B822-B42555569FB4",
              "type": "Microsoft.OperationalInsights/workspaces/features/machines",
              "name": "m-A4AB1C69-03E9-42D2-B822-B42555569FB4"
            }
          },
          "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/processes/p-f1dd514e73cda65d9a19a977aa4a9f6959427ab0",
          "type": "Microsoft.OperationalInsights/workspaces/features/machines/processes",
          "name": "p-f1dd514e73cda65d9a19a977aa4a9f6959427ab0"
        },
        "serverPort": {
          "kind": "ref:port",
          "properties": {
            "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-A4AB1C69-03E9-42D2-B822-B42555569FB4",
              "type": "Microsoft.OperationalInsights/workspaces/features/machines",
              "name": "m-A4AB1C69-03E9-42D2-B822-B42555569FB4"
            },
            "ipAddress": "192.168.1.10",
            "portNumber": 10000
          },
          "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/ports/b-c0a8010a_10000",
          "type": "Microsoft.OperationalInsights/workspaces/features/machines/ports",
          "name": "b-c0a8010a_10000"
        },
        "failureState": "ok"
      },
      "id": "/subscriptions/63BE4E24-FDF0-4E9C-9342-6A5D5A359722/resourceGroups/rg-sm/providers/Microsoft.OperationalInsights/workspaces/D6F79F14-E563-469B-84B5-9286D2803B2F/connections/m@m-9b60b5e7-fb98-4864-9a1f-51d26407f99b@p@p-d642fef420c5baa4c72f53de9426f1ed699899e2!m@m-A4AB1C69-03E9-42D2-B822-B42555569FB4@p@p-f1dd514e73cda65d9a19a977aa4a9f6959427ab0!m@m-A4AB1C69-03E9-42D2-B822-B42555569FB4@b@b-c0a8010a_10000",
      "type": "Microsoft.OperationalInsights/workspaces/features/connections",
      "name": "m@m-9b60b5e7-fb98-4864-9a1f-51d26407f99b@p@p-d642fef420c5baa4c72f53de9426f1ed699899e2!m@m-A4AB1C69-03E9-42D2-B822-B42555569FB4@p@p-f1dd514e73cda65d9a19a977aa4a9f6959427ab0!m@m-A4AB1C69-03E9-42D2-B822-B42555569FB4@b@b-c0a8010a_10000"
    },
    {
      "kind": "rel:connection",
      "properties": {
        "source": {
          "kind": "ref:clientgroup",
          "id": "/subscriptions/63BE4E24-FDF0-4E9C-9342-6A5D5A359722/resourceGroups/rg-sm/providers/Microsoft.OperationalInsights/workspaces/D6F79F14-E563-469B-84B5-9286D2803B2F/clientGroups/m!m-A4AB1C69-03E9-42D2-B822-B42555569FB4!b!b-c0a8010a_10000",
          "type": "Microsoft.OperationalInsights/workspaces/features/clientGroups",
          "name": "m!m-A4AB1C69-03E9-42D2-B822-B42555569FB4!b!b-c0a8010a_10000"
        },
        "destination": {
          "kind": "ref:process",
          "properties": {
            "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-A4AB1C69-03E9-42D2-B822-B42555569FB4",
              "type": "Microsoft.OperationalInsights/workspaces/features/machines",
              "name": "m-A4AB1C69-03E9-42D2-B822-B42555569FB4"
            }
          },
          "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/processes/p-f1dd514e73cda65d9a19a977aa4a9f6959427ab0",
          "type": "Microsoft.OperationalInsights/workspaces/features/machines/processes",
          "name": "p-f1dd514e73cda65d9a19a977aa4a9f6959427ab0"
        },
        "serverPort": {
          "kind": "ref:port",
          "properties": {
            "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-A4AB1C69-03E9-42D2-B822-B42555569FB4",
              "type": "Microsoft.OperationalInsights/workspaces/features/machines",
              "name": "m-A4AB1C69-03E9-42D2-B822-B42555569FB4"
            },
            "ipAddress": "192.168.1.10",
            "portNumber": 10000
          },
          "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/ports/b-c0a8010a_10000",
          "type": "Microsoft.OperationalInsights/workspaces/features/machines/ports",
          "name": "b-c0a8010a_10000"
        },
        "failureState": "ok"
      },
      "id": "/subscriptions/63BE4E24-FDF0-4E9C-9342-6A5D5A359722/resourceGroups/rg-sm/providers/Microsoft.OperationalInsights/workspaces/D6F79F14-E563-469B-84B5-9286D2803B2F/connections/c@m@m-A4AB1C69-03E9-42D2-B822-B42555569FB4@b@b-c0a8010a_10000!m@m-A4AB1C69-03E9-42D2-B822-B42555569FB4@p@p-f1dd514e73cda65d9a19a977aa4a9f6959427ab0!m@m-A4AB1C69-03E9-42D2-B822-B42555569FB4@b@b-c0a8010a_10000",
      "type": "Microsoft.OperationalInsights/workspaces/features/connections",
      "name": "c@m@m-A4AB1C69-03E9-42D2-B822-B42555569FB4@b@b-c0a8010a_10000!m@m-A4AB1C69-03E9-42D2-B822-B42555569FB4@p@p-f1dd514e73cda65d9a19a977aa4a9f6959427ab0!m@m-A4AB1C69-03E9-42D2-B822-B42555569FB4@b@b-c0a8010a_10000"
    }
  ]
}

定義

名前	説明
ClientGroupReference	クライアントグループへの参照。
Connection	ネットワーク接続。
ConnectionCollection	接続リソースのコレクション。
ConnectionFailureState	接続エラーの状態: エラーがないことを示す `ok` エラーのみを示す `failed` `mixed` は失敗と成功の両方を示します
Error	エラーの詳細。
ErrorResponse	API からのエラー応答。
MachineReference	マシンへの参照。
MachineReferenceWithHints	コンピューターの名前とオペレーティングシステムのヒントを含むマシン参照。
OperatingSystemFamily	オペレーティングシステムファミリ (Linux、Windows など) を指定します。
PortReference	ポートへの参照。
ProcessReference	プロセスへの参照。

ClientGroupReference

Object

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

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

Connection

Object

ネットワーク接続。

名前	型	説明
id	string	リソース識別子。
kind	string: rel:connection	追加のリソースの種類修飾子。
name	string	リソース名。
properties.destination	ResourceReference: ClientGroupReference MachineReference MachineReferenceWithHints PortReference ProcessReference	リレーションシップの宛先リソース。
properties.endTime	string (date-time)	リレーションシップの終了時刻。
properties.failureState	ConnectionFailureState	成功、失敗、またはこのリソースで表される両方の接続の組み合わせのみが存在するかどうかを指定します。
properties.serverPort	PortReference	この接続が確立されているサーバーポートへの参照。
properties.source	ResourceReference: ClientGroupReference MachineReference MachineReferenceWithHints PortReference ProcessReference	リレーションシップのソースリソース。
properties.startTime	string (date-time)	リレーションシップの開始時刻。
type	string	リソースの種類。

ConnectionCollection

Object

接続リソースのコレクション。

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

ConnectionFailureState

列挙

接続エラーの状態:

エラーがないことを示す ok
エラーのみを示す failed
mixed は失敗と成功の両方を示します

値	説明
ok
failed
mixed

Error

Object

エラーの詳細。

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

ErrorResponse

Object

API からのエラー応答。

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

MachineReference

Object

マシンへの参照。

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

MachineReferenceWithHints

Object

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

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

OperatingSystemFamily

列挙

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

値	説明
unknown
windows
linux
solaris
aix

PortReference

Object

ポートへの参照。

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

ProcessReference

Object

プロセスへの参照。

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