API: Obter informações do dispositivo

Solicitar URL

OBTER

https://api.dotcom-monitor.com/config_api_v1/dispositivo/ {device_id}

Obtenha a configuração do dispositivo pelo seu id.

Parâmetros do caminho

campo	Type	Necessário	descrição
device_id	corda	true	A id única de um dispositivo de monitoramento. Para solicitar uma lista de IDs de dispositivos dentro de uma plataforma, consulte API: Obter lista de dispositivos por plataforma.

Para ver um id de dispositivo de dentro de sua conta de monitor de pontocom, abra o dispositivo de destino na lista gerenciador de dispositivos para editar. Na barra de endereços do navegador você verá algo como:

https://user.dotcom-monitor.com/ClientID/DeviceEdit?pid=dc7f4ff2ca944dekjh1078b96707002&deviceId=63698&taskId=132834

O dispositivoId=63698 é o ID do dispositivo.

Resposta de sucesso

Exemplo ServerView/BrowserView Dispositivo JSON Object

{
    "Avoid_Simultaneous_Checks": false,
    "Alert_Silence_Min": 94,
    "False_Positive_Check": false,
    "Locations": [
        1,
        4,
        6,
        14,
        15,
        17,
        19,
        23,
        43,
        71,
        73
    ],
    "Tags": null,
    "ContextParams": [],
    "Send_Uptime_Alert": false,
    "Status_Description": "POSTPONED",
    "Postpone": true,
    "Owner_Device_Id": 0,
    "Frequency": 10800,
    "Filter_Id": 7791,
    "Scheduler_Id": 0,
    "Notifications": {
        "E_Mail_Flag": false,
        "E_Mail_Address": null,
        "E_Mail_TimeInterval_Min": 0,
        "WL_Device_Flag": false,
        "WL_Device_Email_Address": null,
        "WL_Device_TimeInterval_Min": 0,
        "Pager_Flag": false,
        "Pager_Area_Code": null,
        "Pager_Phone": null,
        "Pager_Num_Code": null,
        "Pager_TimeInterval_Min": 0,
        "Phone_Flag": false,
        "Phone_Area_Code": null,
        "Phone_Phone": null,
        "Phone_TimeInterval_Min": 0,
        "SMS_Flag": false,
        "SMS_Phone": null,
        "SMS_TimeInterval_Min": 0,
        "Script_Flag": false,
        "Script_Batch_File_Name": null,
        "Script_TimeInterval_Min": 0,
        "SNMP_TimeInterval_Min": 0,
        "Teams_TimeInterval_Min": 0,
        "Slack_TimeInterval_Min": 0,
        "AlertOps_TimeInterval_Min": 0,
        "PagerDuty_TimeInterval_Min": 0,
        "Notification_Groups": []
    },
    "Id": 47432,
    "Number_Of_Tasks": 1,
    "WaitingForApproval": false,
    "Platform_Id": 1,
    "Package_Id": 52,
    "Name": "FullPageDomain.cs"
}

Descrição dos campos

Use esses campos para especificar informações sobre um dispositivo em suas solicitações de API.

campo

Type

descrição

Avoid_Simultaneous_Checks

booleano

Indica se é permitida a verificação simultânea dos vários locais de monitoramento. Disponível apenas para dispositivos ServerView.

exemplo:

"Avoid_Simultaneous_Checks": true

Alert_Silence_Min

int32

LEIA APENAS. Define o período de tempo em minutos quando todos os alertas são desativados. Para desativar os alertas, use API: Desabilitar alertas para dispositivos ou API: Desativar alertas para vários dispositivos.

exemplo:

"Alert_Silence_Min": 46

False_Positive_Check

booleano

Quando detectado o erro, executamos uma série de verificações para garantir que não seja um alerta falso. Essas verificações podem levar algum tempo, dependendo do tipo de erro e número de tarefas no dispositivo. Isso pode causar algum atraso no alerta de tempo de inatividade. Você pode desativar (estado “verdadeiro” falsa verificação positiva para garantir o alerta de tempo de inatividade imediato, mas pode resultar em alguns alertas “falsos”. Recomendamos NÃO desativar “Falsa verificação positiva”.

exemplo:

"False_Positive_Check": false

Locais

matriz de int32

Uma matriz contendo IDs de localização atribuídos a um dispositivo especificado. Pelo menos um local deve ser especificado nas solicitações.

exemplo:

"Locations": [1, 2, 4, 5, 8]