Ports - List Connections

Servicio:

Service Map

Versión de la API:

2015-11-01-preview

Devuelve una colección de conexiones establecidas a través del puerto especificado.

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

Con parámetros opcionales:

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}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
machineName	path	True	string minLength: 3 maxLength: 64	Nombre del recurso de máquina.
portName	path	True	string minLength: 3 maxLength: 64	Nombre del recurso de puerto.
resourceGroupName	path	True	string minLength: 1 maxLength: 64 pattern: [a-zA-Z0-9_-]+	Nombre del grupo de recursos dentro del subscriptionId especificado.
subscriptionId	path	True	string	Identificador de suscripción de Azure.
workspaceName	path	True	string minLength: 3 maxLength: 63 pattern: [a-zA-Z0-9_][a-zA-Z0-9_-]+[a-zA-Z0-9_]	Área de trabajo de OMS que contiene los recursos de interés.
api-version	query	True	string	Versión de la API.
endTime	query		string (date-time)	Fecha y hora UTC que especifican la hora de finalización de un intervalo. Cuando no se especifica, el servicio usa DateTime.UtcNow
startTime	query		string (date-time)	Fecha y hora UTC que especifican la hora de inicio de un intervalo. Cuando no se especifica, el servicio usa DateTime.UtcNow - 10m

Respuestas

Nombre	Tipo	Description
200 OK	ConnectionCollection	La operación se completó correctamente.
Other Status Codes	ErrorResponse	Error al procesar la solicitud. Consulte el parámetro error.code para identificar el error específico.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

SMMachinesPortsListConnectionsGet

Solicitud de ejemplo

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

Respuesta de muestra

status code:

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

Definiciones

Nombre	Description
ClientGroupReference	Referencia a un grupo de clientes.
Connection	Una conexión de red.
ConnectionCollection	Colección de recursos de conexión.
ConnectionFailureState	Estado de error de conexión: ok indica que no hay errores failed indica solo errores mixed indica errores y éxitos
Error	Detalles del error.
ErrorResponse	Respuesta de error de la API.
MachineReference	Referencia a una máquina.
MachineReferenceWithHints	Referencia de máquina con una sugerencia del nombre y el sistema operativo de la máquina.
OperatingSystemFamily	Especifica la familia de sistemas operativos, por ejemplo, Linux, Windows, etc.
PortReference	Referencia a un puerto.
ProcessReference	Referencia a un proceso.

ClientGroupReference

Object

Referencia a un grupo de clientes.

Nombre	Tipo	Description
id	string	URI del recurso.
kind	string: ref:clientgroup	Especifica la subclase de la referencia.
name	string	Nombre del recurso.
type	string	Calificador de tipo de recurso.

Connection

Object

Una conexión de red.

Nombre	Tipo	Description
id	string	Identificador de recursos.
kind	string: rel:connection	Calificador de tipo de recurso adicional.
name	string	Nombre del recurso.
properties.destination	ResourceReference: ClientGroupReference MachineReference MachineReferenceWithHints PortReference ProcessReference	Recurso de destino de la relación.
properties.endTime	string (date-time)	Hora de finalización de la relación.
properties.failureState	ConnectionFailureState	Especifica si solo hay un error correcto o una combinación de ambas conexiones representadas por este recurso.
properties.serverPort	PortReference	Referencia al puerto del servidor a través del cual se ha establecido esta conexión.
properties.source	ResourceReference: ClientGroupReference MachineReference MachineReferenceWithHints PortReference ProcessReference	Recurso de origen de la relación.
properties.startTime	string (date-time)	Hora de inicio de la relación.
type	string	Tipo de recurso.

ConnectionCollection

Object

Colección de recursos de conexión.

Nombre	Tipo	Description
nextLink	string	Dirección URL del siguiente conjunto de recursos.
value	Connection[]	Colección de recursos de conexión.

ConnectionFailureState

Enumeración

Estado de error de conexión:

• ok indica que no hay errores
• failed indica solo errores
• mixed indica errores y éxitos

Valor	Description
ok
failed
mixed

Error

Object

Detalles del error.

Nombre	Tipo	Description
code	string	Código de error que identifica el error específico.
message	string	Mensaje de error en la configuración regional del autor de la llamada.

ErrorResponse

Object

Respuesta de error de la API.

Nombre	Tipo	Description
error	Error	Información de error.

MachineReference

Object

Referencia a una máquina.

Nombre	Tipo	Description
id	string	URI del recurso.
kind	string: ref:machine	Especifica la subclase de la referencia.
name	string	Nombre del recurso.
type	string	Calificador de tipo de recurso.

MachineReferenceWithHints

Object

Referencia de máquina con una sugerencia del nombre y el sistema operativo de la máquina.

Nombre	Tipo	Description
id	string	URI del recurso.
kind	string: ref:machinewithhints	Especifica la subclase de la referencia.
name	string	Nombre del recurso.
properties.displayNameHint	string	Nombre para mostrar conocido por última vez.
properties.osFamilyHint	OperatingSystemFamily	Última familia de sistemas operativos conocidos.
type	string	Calificador de tipo de recurso.

OperatingSystemFamily

Enumeración

Especifica la familia de sistemas operativos, por ejemplo, Linux, Windows, etc.

Valor	Description
unknown
windows
linux
solaris
aix

PortReference

Object

Referencia a un puerto.

Nombre	Tipo	Description
id	string	URI del recurso.
kind	string: ref:port	Especifica la subclase de la referencia.
name	string	Nombre del recurso.
properties.ipAddress	string	Dirección IP del puerto.
properties.machine	MachineReference	Máquina que hospeda el puerto.
properties.portNumber	integer (int32)	Número de puerto.
type	string	Calificador de tipo de recurso.

ProcessReference

Object

Referencia a un proceso.

Nombre	Tipo	Description
id	string	URI del recurso.
kind	string: ref:process	Especifica la subclase de la referencia.
name	string	Nombre del recurso.
properties.machine	MachineReference	Máquina que hospeda el proceso.
type	string	Calificador de tipo de recurso.