Ports - List Connections

Szolgáltatás:

Service Map

API-verzió:

2015-11-01-preview

A megadott porton keresztül létrehozott kapcsolatok gyűjteményét adja vissza.

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

Opcionális paraméterekkel:

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-paraméterek

Name	In	Kötelező	Típus	Description
machineName	path	True	string minLength: 3 maxLength: 64	Gépi erőforrás neve.
portName	path	True	string minLength: 3 maxLength: 64	Porterőforrás neve.
resourceGroupName	path	True	string minLength: 1 maxLength: 64 pattern: [a-zA-Z0-9_-]+	Erőforráscsoport neve a megadott subscriptionId azonosítón belül.
subscriptionId	path	True	string	Azure-előfizetés azonosítója.
workspaceName	path	True	string minLength: 3 maxLength: 63 pattern: [a-zA-Z0-9_][a-zA-Z0-9_-]+[a-zA-Z0-9_]	A fontos erőforrásokat tartalmazó OMS-munkaterület.
api-version	query	True	string	API-verzió.
endTime	query		string (date-time)	UTC dátum és idő, amely egy intervallum befejezési idejét adja meg. Ha nincs megadva, a szolgáltatás a DateTime.UtcNow-t használja
startTime	query		string (date-time)	UTC dátum és idő az intervallum kezdő időpontjának megadásával. Ha nincs megadva, a szolgáltatás a DateTime.UtcNow - 10m értéket használja

Válaszok

Name	Típus	Description
200 OK	ConnectionCollection	A művelet sikeresen befejeződött.
Other Status Codes	ErrorResponse	Hiba történt a kérés feldolgozása során. Az adott hiba azonosításához tekintse meg az error.code paramétert.

Biztonság

azure_auth

Azure Active Directory OAuth2-folyamat

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

SMMachinesPortsListConnectionsGet

Mintakérelem

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

Mintaválasz

Állapotkód:

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

Definíciók

Name	Description
ClientGroupReference	Hivatkozás egy ügyfélcsoportra.
Connection	Hálózati kapcsolat.
ConnectionCollection	Kapcsolati erőforrások gyűjteménye.
ConnectionFailureState	Kapcsolati hiba állapota: ok nem jelez hibát failed csak hibákat jelez mixed hibákra és sikerekre is utal
Error	Hiba részletei.
ErrorResponse	Hibaválasz az API-tól.
MachineReference	Hivatkozás egy gépre.
MachineReferenceWithHints	Géphivatkozás a gép nevére és operációs rendszerére mutató hivatkozással.
OperatingSystemFamily	Megadja az operációs rendszer családját, például Linux, Windows stb.
PortReference	Hivatkozás egy portra.
ProcessReference	Hivatkozás egy folyamatra.

ClientGroupReference

Objektum

Hivatkozás egy ügyfélcsoportra.

Name	Típus	Description
id	string	Erőforrás URI-ja.
kind	string: ref:clientgroup	A hivatkozás alosztályát adja meg.
name	string	Erőforrás neve.
type	string	Erőforrástípus-minősítő.

Connection

Objektum

Hálózati kapcsolat.

Name	Típus	Description
id	string	Erőforrás-azonosító.
kind	string: rel:connection	További erőforrástípus-minősítő.
name	string	Erőforrás neve.
properties.destination	ResourceReference: ClientGroupReference MachineReference MachineReferenceWithHints PortReference ProcessReference	A kapcsolat célerőforrása.
properties.endTime	string (date-time)	A kapcsolat befejezési ideje.
properties.failureState	ConnectionFailureState	Megadja, hogy csak sikeres, sikertelen vagy az erőforrás által képviselt két kapcsolat keveréke van-e.
properties.serverPort	PortReference	Hivatkozás arra a kiszolgálóportra, amelyen keresztül létrejött a kapcsolat.
properties.source	ResourceReference: ClientGroupReference MachineReference MachineReferenceWithHints PortReference ProcessReference	A kapcsolat forráserőforrása.
properties.startTime	string (date-time)	Kapcsolat kezdő időpontja.
type	string	Erőforrás típusa.

ConnectionCollection

Objektum

Kapcsolati erőforrások gyűjteménye.

Name	Típus	Description
nextLink	string	A következő erőforráskészlet URL-címe.
value	Connection[]	Kapcsolati erőforrások gyűjteménye.

ConnectionFailureState

Enumerálás

Kapcsolati hiba állapota:

• ok nem jelez hibát
• failed csak hibákat jelez
• mixed hibákra és sikerekre is utal

Érték	Description
ok
failed
mixed

Error

Objektum

Hiba részletei.

Name	Típus	Description
code	string	Az adott hibát azonosító hibakód.
message	string	Hibaüzenet a hívó területi beállításában.

ErrorResponse

Objektum

Hibaválasz az API-tól.

Name	Típus	Description
error	Error	Hibainformációk.

MachineReference

Objektum

Hivatkozás egy gépre.

Name	Típus	Description
id	string	Erőforrás URI-ja.
kind	string: ref:machine	A hivatkozás alosztályát adja meg.
name	string	Erőforrás neve.
type	string	Erőforrástípus-minősítő.

MachineReferenceWithHints

Objektum

Géphivatkozás a gép nevére és operációs rendszerére mutató hivatkozással.

Name	Típus	Description
id	string	Erőforrás URI-ja.
kind	string: ref:machinewithhints	A hivatkozás alosztályát adja meg.
name	string	Erőforrás neve.
properties.displayNameHint	string	Utolsó ismert megjelenítendő név.
properties.osFamilyHint	OperatingSystemFamily	Utolsó ismert operációsrendszer-család.
type	string	Erőforrástípus-minősítő.

OperatingSystemFamily

Enumerálás

Megadja az operációs rendszer családját, például Linux, Windows stb.

Érték	Description
unknown
windows
linux
solaris
aix

PortReference

Objektum

Hivatkozás egy portra.

Name	Típus	Description
id	string	Erőforrás URI-ja.
kind	string: ref:port	A hivatkozás alosztályát adja meg.
name	string	Erőforrás neve.
properties.ipAddress	string	A port IP-címe.
properties.machine	MachineReference	A portot üzemeltető gép.
properties.portNumber	integer (int32)	Portszám.
type	string	Erőforrástípus-minősítő.

ProcessReference

Objektum

Hivatkozás egy folyamatra.

Name	Típus	Description
id	string	Erőforrás URI-ja.
kind	string: ref:process	A hivatkozás alosztályát adja meg.
name	string	Erőforrás neve.
properties.machine	MachineReference	A folyamatot üzemeltető gép.
type	string	Erőforrástípus-minősítő.