Ports - List Connections

Serviço:

Service Map

Versão da API:

2015-11-01-preview

Retorna uma coleção de conexões estabelecidas através da porta especificada.

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

Com parâmetros opcionais:

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 do URI

Name	Em	Necessário	Tipo	Description
machineName	path	True	string minLength: 3 maxLength: 64	Nome do recurso da máquina.
portName	path	True	string minLength: 3 maxLength: 64	Nome do recurso de porta.
resourceGroupName	path	True	string minLength: 1 maxLength: 64 pattern: [a-zA-Z0-9_-]+	Nome do grupo de recursos dentro do subscriptionId especificado.
subscriptionId	path	True	string	Identificador de assinatura do Azure.
workspaceName	path	True	string minLength: 3 maxLength: 63 pattern: [a-zA-Z0-9_][a-zA-Z0-9_-]+[a-zA-Z0-9_]	Espaço de trabalho do OMS contendo os recursos de interesse.
api-version	query	True	string	Versão da API.
endTime	query		string (date-time)	Data e hora UTC especificando a hora de término de um intervalo. Quando não especificado, o serviço usa DateTime.UtcNow
startTime	query		string (date-time)	Data e hora UTC especificando a hora de início de um intervalo. Quando não especificado o serviço usa DateTime.UtcNow - 10m

Respostas

Name	Tipo	Description
200 OK	ConnectionCollection	A operação foi concluída com êxito.
Other Status Codes	ErrorResponse	Ocorreu um erro durante o processamento do pedido. Consulte o parâmetro error.code para identificar o erro específico.

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

SMMachinesPortsListConnectionsGet

Pedido de amostra

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

Resposta da amostra

Código de estado:

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

Definições

Name	Description
ClientGroupReference	Referência a um grupo de clientes.
Connection	Uma conexão de rede.
ConnectionCollection	Coleção de recursos de conexão.
ConnectionFailureState	Estado de falha de conexão: ok indica que não há falhas failed indica apenas falhas mixed indica fracassos e sucessos
Error	Detalhes do erro.
ErrorResponse	Uma resposta de erro da API.
MachineReference	Referência a uma máquina.
MachineReferenceWithHints	Uma referência de máquina com uma dica do nome e do sistema operacional da máquina.
OperatingSystemFamily	Especifica a família de sistemas operacionais, por exemplo, Linux, Windows, etc.
PortReference	Referência a uma porta.
ProcessReference	Referência a um processo.

ClientGroupReference

Object

Referência a um grupo de clientes.

Name	Tipo	Description
id	string	URI do recurso.
kind	string: ref:clientgroup	Especifica a subclasse da referência.
name	string	Nome do recurso.
type	string	Qualificador de tipo de recurso.

Connection

Object

Uma conexão de rede.

Name	Tipo	Description
id	string	Identificador de recurso.
kind	string: rel:connection	Qualificador de tipo de recurso adicional.
name	string	Nome do recurso.
properties.destination	ResourceReference: ClientGroupReference MachineReference MachineReferenceWithHints PortReference ProcessReference	Recurso de destino da relação.
properties.endTime	string (date-time)	Hora do fim do relacionamento.
properties.failureState	ConnectionFailureState	Especifica se há apenas conexões bem-sucedidas, com falha ou uma mistura de ambas as conexões representadas por esse recurso.
properties.serverPort	PortReference	Referência à porta do servidor através da qual esta ligação foi estabelecida.
properties.source	ResourceReference: ClientGroupReference MachineReference MachineReferenceWithHints PortReference ProcessReference	Recurso de origem da relação.
properties.startTime	string (date-time)	Hora de início do relacionamento.
type	string	Tipo de recurso.

ConnectionCollection

Object

Coleção de recursos de conexão.

Name	Tipo	Description
nextLink	string	A URL para o próximo conjunto de recursos.
value	Connection[]	Coleção de recursos de conexão.

ConnectionFailureState

Enumeração

Estado de falha de conexão:

• ok indica que não há falhas
• failed indica apenas falhas
• mixed indica fracassos e sucessos

Valor	Description
ok
failed
mixed

Error

Object

Detalhes do erro.

Name	Tipo	Description
code	string	Código de erro que identifica o erro específico.
message	string	Mensagem de erro na localidade do chamador.

ErrorResponse

Object

Uma resposta de erro da API.

Name	Tipo	Description
error	Error	Informações de erro.

MachineReference

Object

Referência a uma máquina.

Name	Tipo	Description
id	string	URI do recurso.
kind	string: ref:machine	Especifica a subclasse da referência.
name	string	Nome do recurso.
type	string	Qualificador de tipo de recurso.

MachineReferenceWithHints

Object

Uma referência de máquina com uma dica do nome e do sistema operacional da máquina.

Name	Tipo	Description
id	string	URI do recurso.
kind	string: ref:machinewithhints	Especifica a subclasse da referência.
name	string	Nome do recurso.
properties.displayNameHint	string	Último nome de exibição conhecido.
properties.osFamilyHint	OperatingSystemFamily	Última família de sistemas operativos conhecida.
type	string	Qualificador de tipo de recurso.

OperatingSystemFamily

Enumeração

Especifica a família de sistemas operacionais, por exemplo, Linux, Windows, etc.

Valor	Description
unknown
windows
linux
solaris
aix

PortReference

Object

Referência a uma porta.

Name	Tipo	Description
id	string	URI do recurso.
kind	string: ref:port	Especifica a subclasse da referência.
name	string	Nome do recurso.
properties.ipAddress	string	Endereço IP da porta.
properties.machine	MachineReference	Máquina que hospeda a porta.
properties.portNumber	integer (int32)	Número da porta.
type	string	Qualificador de tipo de recurso.

ProcessReference

Object

Referência a um processo.

Name	Tipo	Description
id	string	URI do recurso.
kind	string: ref:process	Especifica a subclasse da referência.
name	string	Nome do recurso.
properties.machine	MachineReference	Máquina que hospeda o processo.
type	string	Qualificador de tipo de recurso.