Ports - List Connections

Service:

Service Map

Version d'API:

2015-11-01-preview

Retourne une collection de connexions établies via le port spécifié.

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

Avec des paramètres facultatifs:

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}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
machineName	path	True	string minLength: 3 maxLength: 64	Nom de la ressource de l’ordinateur.
portName	path	True	string minLength: 3 maxLength: 64	Nom de la ressource de port.
resourceGroupName	path	True	string minLength: 1 maxLength: 64 pattern: [a-zA-Z0-9_-]+	Nom du groupe de ressources dans l’id d’abonnement spécifié.
subscriptionId	path	True	string	Identificateur d’abonnement Azure.
workspaceName	path	True	string minLength: 3 maxLength: 63 pattern: [a-zA-Z0-9_][a-zA-Z0-9_-]+[a-zA-Z0-9_]	Espace de travail OMS contenant les ressources intéressantes.
api-version	query	True	string	Version de l’API.
endTime	query		string (date-time)	Date et heure UTC spécifiant l’heure de fin d’un intervalle. Lorsqu’il n’est pas spécifié, le service utilise DateTime.UtcNow
startTime	query		string (date-time)	Date et heure UTC spécifiant l’heure de début d’un intervalle. Lorsqu’il n’est pas spécifié, le service utilise DateTime.UtcNow - 10m

Réponses

Nom	Type	Description
200 OK	ConnectionCollection	L’opération s’est terminée avec succès.
Other Status Codes	ErrorResponse	Une erreur s’est produite lors du traitement de la demande. Consultez le paramètre error.code pour identifier l’erreur spécifique.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

SMMachinesPortsListConnectionsGet

Exemple de requête

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

Exemple de réponse

Code d’état:

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

Définitions

Nom	Description
ClientGroupReference	Référence à un groupe client.
Connection	Une connexion réseau.
ConnectionCollection	Collection de ressources Connection.
ConnectionFailureState	État d’échec de connexion : ok indique aucun échec failed indique uniquement les échecs mixed indique les échecs et les réussites
Error	Détails de l’erreur.
ErrorResponse	Réponse d’erreur de l’API.
MachineReference	Référence à un ordinateur.
MachineReferenceWithHints	Référence d’ordinateur avec un indicateur du nom et du système d’exploitation de l’ordinateur.
OperatingSystemFamily	Spécifie la famille de systèmes d’exploitation, par exemple, Linux, Windows, etc.
PortReference	Référence à un port.
ProcessReference	Référence à un processus.

ClientGroupReference

Object

Référence à un groupe client.

Nom	Type	Description
id	string	URI de ressource.
kind	string: ref:clientgroup	Spécifie la sous-classe de la référence.
name	string	Nom de la ressource.
type	string	Qualificateur de type de ressource.

Connection

Object

Une connexion réseau.

Nom	Type	Description
id	string	Identificateur de ressource.
kind	string: rel:connection	Qualificateur de type de ressource supplémentaire.
name	string	Nom de la ressource.
properties.destination	ResourceReference: ClientGroupReference MachineReference MachineReferenceWithHints PortReference ProcessReference	Ressource de destination de la relation.
properties.endTime	string (date-time)	Heure de fin de relation.
properties.failureState	ConnectionFailureState	Spécifie s’il n’y a que des connexions réussies, ayant échoué ou un mélange des deux connexions représentées par cette ressource.
properties.serverPort	PortReference	Référence au port du serveur via lequel cette connexion a été établie.
properties.source	ResourceReference: ClientGroupReference MachineReference MachineReferenceWithHints PortReference ProcessReference	Ressource source de la relation.
properties.startTime	string (date-time)	Heure de début de la relation.
type	string	Type de ressource.

ConnectionCollection

Object

Collection de ressources Connection.

Nom	Type	Description
nextLink	string	URL de l’ensemble de ressources suivant.
value	Connection[]	Collection de ressources Connection.

ConnectionFailureState

Énumération

État d’échec de connexion :

• ok indique aucun échec
• failed indique uniquement les échecs
• mixed indique les échecs et les réussites

Valeur	Description
ok
failed
mixed

Error

Object

Détails de l’erreur.

Nom	Type	Description
code	string	Code d’erreur identifiant l’erreur spécifique.
message	string	Message d’erreur dans les paramètres régionaux de l’appelant.

ErrorResponse

Object

Réponse d’erreur de l’API.

Nom	Type	Description
error	Error	Informations sur l’erreur.

MachineReference

Object

Référence à un ordinateur.

Nom	Type	Description
id	string	URI de ressource.
kind	string: ref:machine	Spécifie la sous-classe de la référence.
name	string	Nom de la ressource.
type	string	Qualificateur de type de ressource.

MachineReferenceWithHints

Object

Référence d’ordinateur avec un indicateur du nom et du système d’exploitation de l’ordinateur.

Nom	Type	Description
id	string	URI de ressource.
kind	string: ref:machinewithhints	Spécifie la sous-classe de la référence.
name	string	Nom de la ressource.
properties.displayNameHint	string	Nom d’affichage connu.
properties.osFamilyHint	OperatingSystemFamily	Dernière famille de système d’exploitation connue.
type	string	Qualificateur de type de ressource.

OperatingSystemFamily

Énumération

Spécifie la famille de systèmes d’exploitation, par exemple, Linux, Windows, etc.

Valeur	Description
unknown
windows
linux
solaris
aix

PortReference

Object

Référence à un port.

Nom	Type	Description
id	string	URI de ressource.
kind	string: ref:port	Spécifie la sous-classe de la référence.
name	string	Nom de la ressource.
properties.ipAddress	string	Adresse IP du port.
properties.machine	MachineReference	Machine hébergeant le port.
properties.portNumber	integer (int32)	Numéro de port.
type	string	Qualificateur de type de ressource.

ProcessReference

Object

Référence à un processus.

Nom	Type	Description
id	string	URI de ressource.
kind	string: ref:process	Spécifie la sous-classe de la référence.
name	string	Nom de la ressource.
properties.machine	MachineReference	Machine hébergeant le processus.
type	string	Qualificateur de type de ressource.