Lister les incidents associés à une ressource

Ce cas d'utilisation décrit les exigences relatives à la liste des incidents associés aux lecteurs ou aux serveurs périphériques à l'aide de Broadsign Control API via REST.

Note : Les numéros d'identification que nous utilisons dans ces échantillons sont fournis à titre d'illustration. Ils ne sont pas valides. Assurez-vous d’utiliser vos propres numéros d’identification pour vos intégrations. De plus, dans nos exemples, nous utilisons le point de terminaison api-sandbox et le jeton HTTP.

Selon votre cas d’utilisation, utilisez l’une des méthodes suivantes :

  • Pour lister les détails des incidents associés à plusieurs lecteurs ou serveurs périphériques, utilisez GET et la méthode /incident/v3/by_id.
  • Pour lister les détails des incidents associés à un lecteur ou un serveur périphérique spécifique, dont vous fournissez les numéros d'identification comme paramètre de requête, utilisez GET et la méthode /incident/v3.

Pour lister les détails des incidents associés à plusieurs lecteurs ou serveurs périphériques, vous devrez fournir une liste de leurs numéros d'identification séparés par des virgules.

Copier 
curl -X GET 
    'https://api-sandbox.broadsign.com:10889/rest/incident/v3/by_id?not_modified_since=2017-05-05&domain_id=123456789&ids=13501,14501' 
        -H 'authorization: Bearer YourAPIKeyHere' 
        -H 'cache-control: no-cache'
Copier 
{
    "not_modified_since": "2017-10-27T19:43:34Z",
        "incident": [
            {
            "critical_escalation_tm_utc": "",
            "domain_id": 123456789,
            "escalation_status": 1,
            "id": 991,
            "last_status_code_change_utc": "2017-10-27T18:41:31",
            "occurred_on": "2017-10-27T18:41:31",
            "problem_description": "Has not polled since 10/26/17 2:33 PM (UTC).",
            "reported_on": "2017-10-27T18:41:31",
            "resolved_description": "",
            "resolved_on": "",
            "resource_id": 13501,
            "status_code": 3,
            "target_resource_id": 13501,
            "type_code": 204,
            "warning_escalation_tm_utc": ""
            },
            {
            "critical_escalation_tm_utc": "",
            "domain_id": 123456789,
            "escalation_status": 1,
            "id": 981,
            "last_status_code_change_utc": "2017-10-26T14:33:37",
            "occurred_on": "2017-10-26T14:33:26",
            "problem_description": "Full screen off.",
            "reported_on": "2017-10-26T14:33:37",
            "resolved_description": "",
            "resolved_on": "",
            "resource_id": 14501,
            "status_code": 4,
            "target_resource_id": 0,
            "type_code": 3,
            "warning_escalation_tm_utc": ""
            }
        ]
    }

Pour lister les détails des incidents associés à un lecteur ou un serveur périphérique spécifique, vous devrez fournir son identifiant unique dans le paramètre resource_id.

Copier 
curl -X GET 
    'https://api-sandbox.broadsign.com:10889/rest/incident/v3?not_modified_since=2017-05-05&domain_id=123456789&resource_id=13501' 
        -H 'authorization: Bearer YourAPIKeyHere' 
        -H 'cache-control: no-cache'
Copier 
{
    "not_modified_since": "2017-10-27T19:43:34Z",
    "incident": [
        {
        "critical_escalation_tm_utc": "",
        "domain_id": 123456789,
        "escalation_status": 1,
        "id": 991,
        "last_status_code_change_utc": "2017-10-27T18:41:31",
        "occurred_on": "2017-10-27T18:41:31",
        "problem_description": "Has not polled since 10/26/17 2:33 PM (UTC).",
        "reported_on": "2017-10-27T18:41:31",
        "resolved_description": "",
        "resolved_on": "",
        "resource_id": 13501,
        "status_code": 3,
        "target_resource_id": 13501,
        "type_code": 204,
        "warning_escalation_tm_utc": ""
        }
    ]
}