--- sourceDocument: Referência de API do Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference Release : - xanadu ft:locale : - pt-BR ft:publication_title : - Referência de API do Xanadu ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # API aberta de gestão de alarmes # API aberta de gestão de alarmes {#ariaid-title1} * Versão de lançamento: Xanadu * * Atualizado 1 de ago. de 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 29 min. de leitura A API Aberta de gestão de alarmes fornece endpoints para criar, atualizar e recuperar dados das tabelas Eventos \[em_event\] e Alerta \[em_alert\]. A API aberta de gestão de alarmes de telecomunicações (sn_ind_tmf642) é uma implementação ServiceNow® da especificação da API aberta do TM Fórum. Esta API se baseia na [especificação REST da API de gestão de alarmes TMF642 versão 20](https://www.tmforum.org/resources/specification/tmf642-alarm-management-api-user-guide-v4-0/), abril de 2020. O usuário de chamada deve ter para acessar o endpoint `sn_ind_tmf642.alarm_mgmt_integration`. Esta API é fornecida no namespace `sn_ind_tmf642`. A especificação da TM Fórum Open API requer uma resposta síncrona para cada solicitação de entrada que recebe. Aplique correlação e desduplicação no sistema de suporte operacional (OSS) de origem antes de encaminhar cargas para o sistema. Esta API pode ser estendida para fazer personalizações em torno dos parâmetros necessários, validação do corpo da solicitação, operações REST adicionais e mapeamentos de campo. Para obter mais informações, consulte o [Guia do desenvolvedor da API aberta de gestão de alarmes](https://servicenow-prod.fluidtopics.net/RUk~eqOc_uSsQrQe9OJzBw#alarm-mgmt_dev-guide "Use a API aberta de gestão de alarmes para criar e atualizar dados na tabela Eventos [em_event]."). A API aberta de gestão de alarmes tem conformidade certificada pelo TM Fórum. ## API aberta de gestão de alarmes -- GET /sn_ind_tmf642/alarm_mgmt/alarm {#ariaid-title2} Recupera uma lista de todos os registros de alarme das tabelas Eventos \[em_event\] e Alerta \[em_alert\]. ### Formato da URL URL padrão: /api/sn_ind_tmf642/alarm_mgmt/alarm ### Parâmetros de solicitação compatíveis {#alarm-GET-alarm__entry__2} | Nome | Descrição | |-|-| | Nenhum(a) | | [Tabela 1. Parâmetros de caminho] {#alarm-GET-alarm__table_qcn_fkm_qtb__entry__2} | Nome | Descrição | |-|-| | AlarmRaisedTime | Data em que o alarme foi acionado. Somente alarmes com uma data correspondente ao valor deste parâmetro são retornados na resposta. Tipo de dados: cadeia de caracteres | | campos | Lista de campos a serem retornados na resposta. Campos inválidos são ignorados. Campos válidos: * AlarmedObject * AlarmRaisedTime * tipo de alarme * cruzadoInformações sobre limite * externalAlarmId * ID * Severidade percebida * provávelCausa * origem * sourceSystemId * estado * tipo {#alarm-GET-alarm__ul_n1h_htz_54b} Padrão: todos os campos Tipo de dados: cadeia de caracteres | | ID | ID do alarme. Somente alarmes com um ID correspondente ao valor deste parâmetro são retornados na resposta. Localizado no campo Chave de mensagem na tabela Eventos \[em_event\]. Tipo de dados: cadeia de caracteres | | limite | Número máximo de registros a serem retornados. Para solicitações que excedem esse número de registros, use o parâmetro offset para paginar a recuperação do registro. Padrão: 1000 Máximo: 2000 Tipo de dados: número | | deslocamento | Índice inicial no qual os registros serão recuperados. Use este valor para paginar a recuperação do registro. Essa funcionalidade permite a recuperação de todos os registros, independentemente do número de registros, em pequenos blocos gerenciáveis. Padrão: 0 Tipo de dados: número | | provávelCausa | Causa provável do alarme. Somente alarmes com uma causa provável correspondente ao valor deste parâmetro são retornados na resposta. Tipo de dados: cadeia de caracteres | | estado | Estado do alarme. Somente alarmes com um estado correspondente ao valor deste parâmetro são retornados na resposta. Tipo de dados: cadeia de caracteres | | sourceSystemId | ID do sistema de origem do alarme. Somente alarmes com um ID de sistema de origem correspondente ao valor deste parâmetro são retornados na resposta. Tipo de dados: cadeia de caracteres | [Tabela 2. Parâmetros de consulta] {#alarm-GET-alarm__table_qcn_fkm_qtb} {#alarm-GET-alarm__entry__24} | Nome | Descrição | |-|-| | Nenhum(a) | | [Tabela 3. Parâmetros do corpo da solicitação (JSON)] ### Cabeçalhos Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte [Cabeçalhos de REST API compatíveis](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles."). {#alarm-GET-alarm__table_rgh_drm_qtb__entry__2} | Cabeçalho | Descrição | |-|-| | Nenhum(a) | | [Tabela 4. Cabeçalhos da solicitação] {#alarm-GET-alarm__table_rgh_drm_qtb} {#alarm-GET-alarm__table_c2r_4gm_lsb__entry__2}{#alarm-GET-alarm__content-range-row}{#alarm-GET-alarm__content-type-row}{#alarm-GET-alarm__links-pagination-row}{#alarm-GET-alarm__x-total-count-descr} | Cabeçalho | Descrição | |-|-| | Intervalo de conteúdo | Especifica o intervalo de conteúdo retornado em uma chamada paginada. Por exemplo, se `deslocamento=2` e `limite=3`, o valor do cabeçalho Content-Range será `itens 3-5`. | | Tipo de conteúdo | Formato de dados do corpo da resposta. Oferece suporte somente a application/json. | | Link | Contém os links a seguir para navegar pelos resultados da consulta. * primeiro * último * avançar * anterior {#alarm-GET-alarm__ul_zzk_sdm_lsb} | | X-Total-Contagem | Para consultas paginadas, este cabeçalho especifica o número total de registros disponíveis no servidor. | [Tabela 5. Cabeçalhos de resposta] {#alarm-GET-alarm__table_c2r_4gm_lsb} ### Códigos de status Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de códigos de status possíveis usados na REST API, consulte [Códigos de resposta HTTP de REST API](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles."). {#alarm-GET-alarm__table_qbg_4cm_lsb__entry__2}{#alarm-GET-alarm__tmf-get-status-200-p}{#alarm-GET-alarm__tmf-get-status-206-entry}{#alarm-GET-alarm__tmf-get-status-400-entry}{#alarm-GET-alarm__tmf-get-status-404-entry} | Código de status | Descrição | |-|-| | 200 | Solicitação processada com sucesso. Recurso completo retornado na resposta (sem paginação). | | 206 | Recurso parcial retornado em resposta (com paginação). | | 400 | Solicitação incorreta. Possíveis motivos: * Parâmetro de caminho inválido * URI inválido {#alarm-GET-alarm__ul_rys_1gy_fsb} | | 404 | Registro não encontrado. Nenhum registro correspondente aos parâmetros de consulta foi encontrado na tabela. | [Tabela 6. Códigos de status] {#alarm-GET-alarm__table_qbg_4cm_lsb} ### Parâmetros do corpo da resposta (JSON) {#alarm-GET-alarm__table_zjc_fbg_qtb__entry__2}{#alarm-GET-alarm__alm-mgmt-affectedService-entry}{#alarm-GET-alarm__alm-mgmt-affectedServiceHREF-entry}{#alarm-GET-alarm__alm-mgmt-create-alarmobj-href-entry}{#alarm-GET-alarm__alm-mgmt-specificProb-ph} | Nome | Descrição | |-|-| | Serviçoafetado | Lista de objetos que identificam um ou mais serviços afetados pelo alarme. Tipo de dados: matriz "affectedService":[ { "href": "String", "id": "String" }, ] | | Serviçoafetado.href | Referência de URL que fornece detalhes do serviço afetado. Tipo de dados: cadeia de caracteres | | affectedService.id | Identificador do serviço afetado pelo alarme. Este valor é mapeado para o item de configuração (IC) afetado no alerta. Tipo de dados: cadeia de caracteres | | detalhesdoalarme | Detalhes adicionais sobre o alarme. Tipo de dados: cadeia de caracteres | | AlarmedObject | Detalhes do objeto de alarme. "alarmedObject": { "href": "String", "id": "String" } Tipo de dados: objeto | | alarmedObject.id | Identificador exclusivo do objeto de alarme. Este valor é mapeado para um IC no sistema. Tipo de dados: cadeia de caracteres | | AlarmedObject.href | Referência de URL para obter os detalhes do objeto de alarme. Tipo de dados: cadeia de caracteres | | AlarmedObjectType | Tipo ou classe de objeto associado ao evento. Tipo de dados: cadeia de caracteres | | AlarmRaisedTime | Data e hora em que o alarme ocorre em sua origem. Tipo de dados: cadeia de caracteres | | AlarmReportingTime | Data e hora em que o OSS relata seu alarme. Este valor pode ser diferente do valor alarmRaisedTime. Por exemplo, se um sistema de gestão de elementos (EMS) mantiver a lista de alarmes: * O alarmRaisedTime é o tempo de detecção do alarme pelo elemento de rede (NE). * O alarmReportingTime é o tempo de armazenamento do relatório de alarme na lista de alarmes do EMS. {#alarm-GET-alarm__ul_mbt_1rf_ynb} Tipo de dados: cadeia de caracteres | | tipo de alarme | Categoria de alarme. Tipo de dados: cadeia de caracteres | | cruzadoInformações sobre limite | Detalhes sobre o limite ultrapassado. "crossedThresholdInformation": { "direction": "String", "granularity": "String", "indicatorName": "String", "indicatorUnit": "String", "observedValue": "String", "thresholdCrossingDescription": "String", "thresholdId": "String", "thresholdRef": "String" } Tipo de dados: objeto | | CrossThresholdInformation.direction | Direção de cruzamento do limite. Valores possíveis: * PARA CIMA * PARA BAIXO {#alarm-GET-alarm__ul_fsb_jlg_ynb} Tipo de dados: cadeia de caracteres | | cruzadoInformaçõesDeLimite.granularidade | Granularidade na qual o indicador é avaliado para ultrapassar o limite. Por exemplo, `5MINUTES`. Tipo de dados: cadeia de caracteres | | CrossThresholdInformation.IndicatorName | Nome do indicador que ultrapassa o limite do alarme. Tipo de dados: cadeia de caracteres | | cruzadoInformaçõesDeLimite.indicadorUnidade | Unidade de medida do indicador correspondente ao limite ultrapassado. Tipo de dados: cadeia de caracteres | | cruzadoInformaçõesDeLimite.observadoValue | Número que identifica o indicador que ultrapassou o limite. Tipo de dados: cadeia de caracteres | | CrossThresholdInformation.thresholdCrossingDescription | Mais detalhes do limite do alarme de ultrapassagem de limite. Tipo de dados: cadeia de caracteres | | CrossThresholdInformation.thresholdId | Identificador exclusivo do limite que causou o alarme. Tipo de dados: cadeia de caracteres | | CrossThresholdInformation.thresholdRef | URL do objeto de limite. Tipo de dados: cadeia de caracteres | | externalAlarmId | Identificador exclusivo do alarme do sistema de origem que publica o alarme. Tipo de dados: cadeia de caracteres | | href | URL do recurso. Tipo de dados: cadeia de caracteres | | ID | Identificador exclusivo para o sistema para identificar e processar a carga do alarme como um evento. Tipo de dados : cadeia de caracteres | | Severidade percebida | Gravidade do alarme. Valores possíveis: * LIMPAR * CRÍTICO * PRINCIPAL * BAIXO * AVISO {#alarm-GET-alarm__ul_vcp_c4f_ynb} Tipo de dados: cadeia de caracteres | | planejadoIndicaçãoDeIndisponibilidade | Indica que o objeto gerenciado para este alarme está em um estado de indisponibilidade planejada. Por exemplo, manutenção planejada ou fora de serviço. Tipo de dados: cadeia de caracteres | | provávelCausa | Situação mais provável para acionar o alarme. Use com alarmType para qualificar o alarme. Tipo de dados: cadeia de caracteres | | AçõesDeReparopropostas | Se disponível para o sistema, fornece uma ação de reparo para resolver o problema que aciona o alarme. Tipo de dados: cadeia de caracteres | | serviçoAfeta | Sinalizador que indica se o alarme afeta o serviço. Valores válidos: * verdadeiro: o alarme afeta o desempenho ou a disponibilidade do serviço. * falso: o alarme não afeta o serviço. {#alarm-GET-alarm__ul_omz_dnf_ynb} Padrão: falso Tipo de dados: booliano | | sourceSystemId | ID da instância do alarme de origem. Tipo de dados: cadeia de caracteres | | Problema específico | Problema específico que aciona o alarme. Use com probableCause para qualificar o alarme. Tipo de dados: cadeia de caracteres | | estado | Estado do alarme. Valores válidos: * Pronto * Processado * Ignorado * Erro {#alarm-GET-alarm__ul_ilh_3jt_xnb}Se um valor inválido for fornecido, o estado será definido como `Pronto`. Se o estado for `Pronto`, um alerta será criado na tabela Alerta \[em_alert\] e o estado se tornará `Processado`. Se o estado for `Processado`, `Ignorado`ou `Erro`, nenhum alerta será criado. Valor padrão: Pronto Tipo de dados: cadeia de caracteres | [ ] {#alarm-GET-alarm__table_zjc_fbg_qtb} ### Solicitação de cURL Este exemplo recupera todos os alarmes. curl "https://instance.servicenow.com/api/sn_ind_tmf642/alarm_mgmt/alarm" \ --request GET \ --header "Accept:application/json" \ --user 'username':'password' Corpo da resposta. [ { "externalAlarmId": "2212331", "alarmType": "QualityOfServiceAlarm23", "perceivedSeverity": "MAJOR", "probableCause": "ProbB", "sourceSystemId": "checkSB", "alarmedObject": { "id": "vManage_000000", "href": " http://api/alarmedobject/000000" }, "crossedThresholdInformation": { "direction": "111", "granularity": "1234", "indicatorName": "sdfgds", "indicatorUnit": "asdfdsaf", "observedValue": "adsfds", "thresholdId": "12fasdfasdfasd", "thresholdCrossingDescription": "S23rtring", "thresholdRef": "asdfasf" }, "type": "QualityOfServiceAlarm", "ackState": "acknowledged", "specificProblem": "Inbound Traffic threshold crossed", "alarmedObjectType": "ROUTER", "alarmDetails": "Software Failure on SD-WAN Controller vManage_000000", "state": "processed", "alarmChangedTime": "2017-08-15T07:04:15.666Z", "proposedRepairActions": "Switch in standby equipment", "alarmReportingTime": "2017-06-15T07:04:15.666Z", "alarmRaisedTime": "2020-09-15T14:04:15.000Z", "plannedOutageIndication": "IN_SERVICE", "serviceAffecting": true, "affectedService": [ { "id": "SD WAN Enterprise Solutions", "href": "http://api/service/vlan_dot0_dot0" }, { "id": "Santa Clara SD WAN Application Service", "href": "http://api/service/vlan_dot0_dot0" } ], "source": "Alarm Management Open API", "href": "/api/sn_ind_tmf642/alarm_mgmt/alarm/001a0ca629078d10f87759e2f69e4c64_2212331", "id": "001a0ca629078d10f87759e2f69e4c64_2212331" }, { "externalAlarmId": "2212331", "alarmType": "QualityOfServiceAlarm23", "perceivedSeverity": "MAJOR", "probableCause": "ProbB", "sourceSystemId": "checkSB", "alarmedObject": { "id": "vManage_000000", "href": " http://api/alarmedobject/000000" }, "crossedThresholdInformation": { "direction": "111", "granularity": "1234", "indicatorName": "sdfgds", "indicatorUnit": "asdfdsaf", "observedValue": "adsfds", "thresholdId": "12fasdfasdfasd", "thresholdCrossingDescription": "S23rtring", "thresholdRef": "asdfasf" }, "type": "QualityOfServiceAlarm", "ackState": "acknowledged", "specificProblem": "Inbound Traffic threshold crossed", "alarmedObjectType": "ROUTER", "alarmDetails": "Software Failure on SD-WAN Controller vManage_000000", "state": "processed", "alarmChangedTime": "2017-08-15T07:04:15.666Z", "proposedRepairActions": "Switch in standby equipment", "alarmReportingTime": "2017-06-15T07:04:15.666Z", "alarmRaisedTime": "2020-09-15T14:04:15.000Z", "plannedOutageIndication": "IN_SERVICE", "serviceAffecting": true, "affectedService": [ { "id": "SD WAN Enterprise Solutions", "href": "http://api/service/vlan_dot0_dot0" }, { "id": "Santa Clara SD WAN Application Service", "href": "http://api/service/vlan_dot0_dot0" } ], "source": "Alarm Management Open API", "href": "/api/sn_ind_tmf642/alarm_mgmt/alarm/001c84aa29078d10f87759e2f69e4cfa_2212331", "id": "001c84aa29078d10f87759e2f69e4cfa_2212331" } ] ## API aberta de gestão de alarmes -- GET /sn_ind_tmf642/alarm_mgmt/alarm/{id} {#ariaid-title3} Recupera um registro de alarme especificado da tabela Eventos \[em_event\] ou Alerta \[em_alert\]. ### Formato da URL URL padrão: /api/sn_ind_tmf642/alarm_mgmt/alarm/{id} ### Parâmetros de solicitação compatíveis {#alarm-GET-alarm-id__entry__2} | Nome | Descrição | |-|-| | ID | Identificador exclusivo do registro a ser recuperado. Localizado no campo Chave de mensagem na tabela Eventos \[em_event\]. Tipo de dados: cadeia de caracteres | [Tabela 7. Parâmetros de caminho] {#alarm-GET-alarm-id__entry__6} | Nome | Descrição | |-|-| | campos | Lista de campos a serem retornados na resposta. Campos inválidos são ignorados. Campos válidos: * AlarmedObject * AlarmRaisedTime * tipo de alarme * cruzadoInformações sobre limite * externalAlarmId * ID * Severidade percebida * provávelCausa * origem * sourceSystemId * estado * tipo {#alarm-GET-alarm-id__ul_n1h_htz_54b} Valor padrão: todos os campos Tipo de dados: cadeia de caracteres | [Tabela 8. Parâmetros de consulta] {#alarm-GET-alarm-id__entry__10} | Nome | Descrição | |-|-| | Nenhum(a) | | [Tabela 9. Parâmetros do corpo da solicitação (JSON)] ### Cabeçalhos Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte [Cabeçalhos de REST API compatíveis](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles."). {#alarm-GET-alarm-id__entry__14}{#alarm-GET-alarm-id__accept-JSON-only-entry-RESTAPI} | Cabeçalho | Descrição | |-|-| | Aceitar | Formato de dados do corpo da resposta. Oferece suporte somente a application/json. | [Tabela 10. Cabeçalhos da solicitação] {#alarm-GET-alarm-id__entry__18} | Cabeçalho | Descrição | |-|-| | Nenhum(a) | | [Tabela 11. Cabeçalhos de resposta] ### Códigos de status Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de códigos de status possíveis usados na REST API, consulte [Códigos de resposta HTTP de REST API](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles."). {#alarm-GET-alarm-id__entry__22}{#alarm-GET-alarm-id__entry-200-status-code} | Código de status | Descrição | |-|-| | 200 | Bem-sucedido. A solicitação foi processada com sucesso. | | 400 | Solicitação Incorreta. Um tipo de solicitação incorreto ou solicitação malformada foi detectado por um ou mais dos motivos a seguir. * Parâmetro de caminho inválido. * URI inválido. {#alarm-GET-alarm-id__ul_rjf_fqw_rpb} | | 404 | Registro não encontrado. Um registro associado ao ID especificado não foi encontrado na tabela Evento \[em_event\] ou Alerta \[em_alert\]. | [Tabela 12. Códigos de status] ### Parâmetros do corpo da resposta (JSON) {#alarm-GET-alarm-id__table_gtd_dbg_qtb__entry__2}{#alarm-GET-alarm-id__alm-mgmt-affectedService-entry}{#alarm-GET-alarm-id__alm-mgmt-affectedServiceHREF-entry}{#alarm-GET-alarm-id__alm-mgmt-create-alarmobj-href-entry}{#alarm-GET-alarm-id__alm-mgmt-specificProb-ph} | Nome | Descrição | |-|-| | Serviçoafetado | Lista de objetos que identificam um ou mais serviços afetados pelo alarme. Tipo de dados: matriz "affectedService":[ { "href": "String", "id": "String" }, ] | | Serviçoafetado.href | Referência de URL que fornece detalhes do serviço afetado. Tipo de dados: cadeia de caracteres | | affectedService.id | Identificador do serviço afetado pelo alarme. Este valor é mapeado para o item de configuração (IC) afetado no alerta. Tipo de dados: cadeia de caracteres | | detalhesdoalarme | Detalhes adicionais sobre o alarme. Tipo de dados: cadeia de caracteres | | AlarmedObject | Detalhes do objeto de alarme. Tipo de dados: objeto "alarmedObject": { "href": "String", "id": "String" } | | alarmedObject.id | Identificador exclusivo do objeto de alarme. Este valor é mapeado para um IC no sistema. Tipo de dados: cadeia de caracteres | | AlarmedObject.href | Referência de URL para obter os detalhes do objeto de alarme. Tipo de dados: cadeia de caracteres | | AlarmedObjectType | Tipo ou classe de objeto associado ao evento. Tipo de dados: cadeia de caracteres | | AlarmRaisedTime | Data e hora em que o alarme ocorre em sua origem. Tipo de dados: cadeia de caracteres | | AlarmReportingTime | Data e hora em que o OSS relata seu alarme. Este valor pode ser diferente do valor alarmRaisedTime. Por exemplo, se um sistema de gestão de elementos (EMS) mantiver a lista de alarmes: * O alarmRaisedTime é o tempo de detecção do alarme pelo elemento de rede (NE). * O alarmReportingTime é o tempo de armazenamento do relatório de alarme na lista de alarmes do EMS. {#alarm-GET-alarm-id__ul_mbt_1rf_ynb} Tipo de dados: cadeia de caracteres | | tipo de alarme | Categoria de alarme. Tipo de dados: cadeia de caracteres | | cruzadoInformações sobre limite | Detalhes sobre o limite ultrapassado. "crossedThresholdInformation": { "direction": "String", "granularity": "String", "indicatorName": "String", "indicatorUnit": "String", "observedValue": "String", "thresholdCrossingDescription": "String", "thresholdId": "String", "thresholdRef": "String" } Tipo de dados: objeto | | CrossThresholdInformation.direction | Direção de cruzamento do limite. Valores possíveis: * PARA CIMA * PARA BAIXO {#alarm-GET-alarm-id__ul_fsb_jlg_ynb} Tipo de dados: cadeia de caracteres | | cruzadoInformaçõesDeLimite.granularidade | Granularidade na qual o indicador é avaliado para ultrapassar o limite. Por exemplo, `5MINUTES`. Tipo de dados: cadeia de caracteres | | CrossThresholdInformation.IndicatorName | Nome do indicador que ultrapassa o limite do alarme. Tipo de dados: cadeia de caracteres | | cruzadoInformaçõesDeLimite.indicadorUnidade | Unidade de medida do indicador correspondente ao limite ultrapassado. Tipo de dados: cadeia de caracteres | | cruzadoInformaçõesDeLimite.observadoValue | Número que identifica o indicador que ultrapassou o limite. Tipo de dados: cadeia de caracteres | | CrossThresholdInformation.thresholdCrossingDescription | Mais detalhes do limite do alarme de ultrapassagem de limite. Tipo de dados: cadeia de caracteres | | CrossThresholdInformation.thresholdId | Identificador exclusivo do limite que causou o alarme. Tipo de dados: cadeia de caracteres | | CrossThresholdInformation.thresholdRef | URL do objeto de limite. Tipo de dados: cadeia de caracteres | | externalAlarmId | Identificador exclusivo do alarme do sistema de origem que publica o alarme. Tipo de dados: cadeia de caracteres | | href | URL do recurso. Tipo de dados: cadeia de caracteres | | ID | Identificador exclusivo para o sistema para identificar e processar a carga do alarme como um evento. Tipo de dados: cadeia de caracteres | | Severidade percebida | Gravidade do alarme. Valores possíveis: * LIMPAR * CRÍTICO * PRINCIPAL * BAIXO * AVISO {#alarm-GET-alarm-id__ul_vcp_c4f_ynb} Tipo de dados: cadeia de caracteres | | planejadoIndicaçãoDeIndisponibilidade | Indica que o objeto gerenciado para este alarme está em um estado de indisponibilidade planejada. Por exemplo, manutenção planejada ou fora de serviço. Tipo de dados: cadeia de caracteres | | provávelCausa | Situação mais provável para acionar o alarme. Use com alarmType para qualificar o alarme. Tipo de dados: cadeia de caracteres | | AçõesDeReparopropostas | Se disponível para o sistema, fornece uma ação de reparo para resolver o problema que aciona o alarme. Tipo de dados: cadeia de caracteres | | serviçoAfeta | Sinalizador que indica se o alarme afeta o serviço. Valores válidos: * verdadeiro: o alarme afeta o desempenho ou a disponibilidade do serviço. * falso: o alarme não afeta o serviço. {#alarm-GET-alarm-id__ul_omz_dnf_ynb} Padrão: falso Tipo de dados: booliano | | sourceSystemId | ID da instância do alarme de origem. Tipo de dados: cadeia de caracteres | | Problema específico | Problema específico que aciona o alarme. Use com probableCause para qualificar o alarme. Tipo de dados: cadeia de caracteres | | estado | Estado do alarme. Valores válidos: * Pronto * Processado * Ignorado * Erro {#alarm-GET-alarm-id__ul_ilh_3jt_xnb}Se um valor inválido for fornecido, o estado será definido como `Pronto`. Se o estado for `Pronto`, um alerta será criado na tabela Alerta \[em_alert\] e o estado se tornará `Processado`. Se o estado for `Processado`, `Ignorado`ou `Erro`, nenhum alerta será criado. Valor padrão: Pronto Tipo de dados: cadeia de caracteres | [ ] {#alarm-GET-alarm-id__table_gtd_dbg_qtb} ### Solicitação de cURL Este exemplo recupera um alarme. curl "https://instance.servicenow.com/api/sn_ind_tmf642/alarm_mgmt/alarm/001a0ca629078d10f87759e2f69e4c64_2212331" \ --request GET \ --header "Accept:application/json" \ --user 'username':'password' Corpo da resposta. { "externalAlarmId": "2212331", "alarmType": "QualityOfServiceAlarm23", "perceivedSeverity": "MAJOR", "probableCause": "ProbB", "sourceSystemId": "checkSB", "alarmedObject": { "id": "vManage_000000", "href": " http://api/alarmedobject/000000" }, "crossedThresholdInformation": { "direction": "111", "granularity": "1234", "indicatorName": "ind_name", "indicatorUnit": "ind_unit", "observedValue": "232", "thresholdId": "200", "thresholdCrossingDescription": "sample_description", "thresholdRef": "sample_ref" }, "type": "QualityOfServiceAlarm", "ackState": "acknowledged", "specificProblem": "Inbound Traffic threshold crossed", "alarmedObjectType": "ROUTER", "alarmDetails": "Software Failure on SD-WAN Controller vManage_000000", "state": "processed", "alarmChangedTime": "2017-08-15T07:04:15.666Z", "proposedRepairActions": "Switch in standby equipment", "alarmReportingTime": "2017-06-15T07:04:15.666Z", "alarmRaisedTime": "2020-09-15T14:04:15.000Z", "plannedOutageIndication": "IN_SERVICE", "serviceAffecting": true, "affectedService": [ { "id": "SD WAN Enterprise Solutions", "href": "http://api/service/vlan_dot0_dot0" }, { "id": "Santa Clara SD WAN Application Service", "href": "http://api/service/vlan_dot0_dot0" } ], "source": "Alarm Management Open API", "href": "/api/sn_ind_tmf642/alarm_mgmt/alarm/001a0ca629078d10f87759e2f69e4c64_2212331", "id": "001a0ca629078d10f87759e2f69e4c64_2212331" } ## API aberta de gestão de alarmes -- PATCH /sn_ind_tmf642/alarm_mgmt/alarm/{id} {#ariaid-title4} Atualiza um alarme especificado e qualquer alerta associado. Este endpoint grava o corpo da resposta no campo Informações adicionais do registro de evento na tabela Eventos \[em_event\]. ### Formato da URL URL padrão: /api/sn_ind_tmf642/alarm_mgmt/alarm/{id} ### Parâmetros de solicitação compatíveis {#alarm-PATCH__entry__2} | Nome | Descrição | |-|-| | ID | Identificador exclusivo do registro a ser atualizado. Localizado no campo Chave de mensagem na tabela Eventos \[em_event\]. Tipo de dados: cadeia de caracteres | [Tabela 13. Parâmetros de caminho] {#alarm-PATCH__entry__6} | Nome | Descrição | |-|-| | Nenhum(a) | | [Tabela 14. Parâmetros de consulta] {#alarm-PATCH__table_kmr_mjs_xnb__entry__2}{#alarm-PATCH__alm-mgmt-affectedService-entry}{#alarm-PATCH__alm-mgmt-affectedServiceHREF-entry}{#alarm-PATCH__alm-mgmt-perceivedSeverity-desc}{#alarm-PATCH__alm-mgmt-specificProb-ph} | Nome | Descrição | |-|-| | Serviçoafetado | Lista de objetos que identificam um ou mais serviços afetados pelo alarme. Tipo de dados: matriz "affectedService":[ { "href": "String", "id": "String" }, ] | | Serviçoafetado.href | Referência de URL que fornece detalhes do serviço afetado. Tipo de dados: cadeia de caracteres | | affectedService.id | Obrigatório. Identificador do serviço afetado pelo alarme. Este valor é mapeado para o item de configuração (IC) afetado no alerta. Tipo de dados: cadeia de caracteres | | AlarmChangedTime | Indica a última data e hora em que o alarme foi alterado no sistema proprietário do alarme. Qualquer mudança no alarme atualiza este valor, seja proveniente do recurso com alarme ou acionado por uma mudança do cliente. Tipo de dados: cadeia de caracteres | | detalhesdoalarme | Detalhes adicionais sobre o alarme. Tipo de dados: cadeia de caracteres | | alarmeEscalação | Sinalizador que indica uma escalação na gravidade do alarme. Valores válidos: * verdadeiro: há uma escalação na gravidade do alarme. * falso: a severidade do alarme é a mesma ou inferior. {#alarm-PATCH__ul_kkj_4jh_ynb} Padrão: falso Tipo de dados: booliano | | cruzadoInformações sobre limite | Detalhes sobre o limite ultrapassado. "crossedThresholdInformation": { "direction": "String", "granularity": "String", "indicatorName": "String", "indicatorUnit": "String", "observedValue": "String", "thresholdCrossingDescription": "String", "thresholdId": "String", "thresholdRef": "String" } Tipo de dados: objeto | | CrossThresholdInformation.direction | Direção de cruzamento do limite. Valores possíveis: * PARA CIMA * PARA BAIXO {#alarm-PATCH__ul_fsb_jlg_ynb} Tipo de dados: cadeia de caracteres | | cruzadoInformaçõesDeLimite.granularidade | Granularidade na qual o indicador é avaliado para ultrapassar o limite. Por exemplo, `5MINUTES`. Tipo de dados: cadeia de caracteres | | CrossThresholdInformation.IndicatorName | Nome do indicador que ultrapassa o limite do alarme. Tipo de dados: cadeia de caracteres | | cruzadoInformaçõesDeLimite.indicadorUnidade | Unidade de medida do indicador correspondente ao limite ultrapassado. Tipo de dados: cadeia de caracteres | | cruzadoInformaçõesDeLimite.observadoValue | Número que identifica o indicador que ultrapassou o limite. Tipo de dados: cadeia de caracteres | | CrossThresholdInformation.thresholdCrossingDescription | Mais detalhes do limite do alarme de ultrapassagem de limite. Tipo de dados: cadeia de caracteres | | CrossThresholdInformation.thresholdId | Obrigatório. Identificador exclusivo do limite que causou o alarme. Tipo de dados: cadeia de caracteres | | CrossThresholdInformation.thresholdRef | URL do objeto de limite. Tipo de dados: cadeia de caracteres | | href | Referência de URL para o alarme. Tipo de dados: cadeia de caracteres | | Severidade percebida | Obrigatório. Gravidade do alarme. Valores possíveis: * LIMPAR * CRÍTICO * PRINCIPAL * BAIXO * AVISO {#alarm-PATCH__ul_vcp_c4f_ynb} Tipo de dados: cadeia de caracteres | | planejadoIndicaçãoDeIndisponibilidade | Indica que o objeto gerenciado para este alarme está em um estado de indisponibilidade planejada. Por exemplo, manutenção planejada ou fora de serviço. Tipo de dados: cadeia de caracteres | | provávelCausa | Obrigatório. Situação mais provável para acionar o alarme. Use com alarmType para qualificar o alarme. Tipo de dados: cadeia de caracteres | | AçõesDeReparopropostas | Se disponível para o sistema, fornece uma ação de reparo para resolver o problema que aciona o alarme. Tipo de dados: cadeia de caracteres | | serviçoAfeta | Sinalizador que indica se o alarme afeta o serviço. Valores válidos: * verdadeiro: o alarme afeta o desempenho ou a disponibilidade do serviço. * falso: o alarme não afeta o serviço. {#alarm-PATCH__ul_omz_dnf_ynb} Padrão: falso Tipo de dados: booliano | | Problema específico | Problema específico que aciona o alarme. Use com probableCause para qualificar o alarme. Tipo de dados: cadeia de caracteres | [Tabela 15. Parâmetros do corpo da solicitação (JSON)] {#alarm-PATCH__table_kmr_mjs_xnb} ### Cabeçalhos Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte [Cabeçalhos de REST API compatíveis](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles."). {#alarm-PATCH__entry__56}{#alarm-PATCH__accept-JSON-only-entry-RESTAPI}{#alarm-PATCH__content_type-JSON-only-entry-RESTAPI} | Cabeçalho | Descrição | |-|-| | Aceitar | Formato de dados do corpo da resposta. Oferece suporte somente a application/json. | | Tipo de conteúdo | Formato de dados do corpo da solicitação. Oferece suporte somente a application/json. | [Tabela 16. Cabeçalhos da solicitação] {#alarm-PATCH__table_jwc_bxs_xnb__entry__2} | Cabeçalho | Descrição | |-|-| | Nenhum(a) | | [Tabela 17. Cabeçalhos de resposta] {#alarm-PATCH__table_jwc_bxs_xnb} ### Códigos de status Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de códigos de status possíveis usados na REST API, consulte [Códigos de resposta HTTP de REST API](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles."). {#alarm-PATCH__table_ifj_lyb_ynb__entry__2} | Código de status | Descrição | |-|-| | 201 | Bem-sucedido. A solicitação foi processada com sucesso. | | 400 | Solicitação incorreta. Possíveis motivos: * Carga inválida. ID de alarme obrigatório ausente. * Carga inválida. Campo obrigatório ausente:\ . * Carga inválida. Objeto obrigatório ausente. * Evento não criado, com falha. * Não é possível limpar o evento. * Não é possível atualizar o evento. * O evento não existe. {#alarm-PATCH__ul_f4x_sdb_ynb} | [Tabela 18. Códigos de status] {#alarm-PATCH__table_ifj_lyb_ynb} ### Parâmetros do corpo da resposta (JSON) {#alarm-PATCH__entry__72} | Nome | Descrição | |-|-| | AlarmChangedTime | Data e hora em que o alarme foi alterado em GMT no sistema proprietário do alarme. Este valor está no formato GlideDateTime e está no campo Time of event de um registro na tabela Eventos \[em_events\]. Este valor é atualizado quando ocorrem mudanças no alarme do recurso com alarme ou uma mudança de uma atualização do cliente aciona o alarme. Este valor é necessário na resposta. Tipo de dados: cadeia de caracteres | | href | Referência de URL para o alarme. Tipo de dados: cadeia de caracteres | | ID | Identificador exclusivo do alarme. Valor determinado pelo sistema proprietário do alarme. Tipo de dados: cadeia de caracteres | [ ] ### Solicitação de cURL Neste exemplo, a gravidade é reduzida para MINOR. curl "https://.service-now.com/api/sn_ind_tmf642/alarm_mgmt/alarm/6e116bb8db09201087b9a8394b961950_" \ --request PATCH \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ \"href\":\"http://api/alarm/ROUTER_IF@Cisco-0000-0-0-0-0-00-00-0-- Xz0/00@00\", \"externalAlarmId\":\"\", \"alarmType\":\"QualityOfServiceAlarm\", \"type\":\"QualityOfServiceAlarm\", \"ackState\":\"acknowledged\", \"perceivedSeverity\":\"MINOR\", \"probableCause\":\"Threshold crossed\", \"specificProblem\":\"Inbound Traffic threshold crossed\", \"alarmedObjectType\":\"ROUTER\", \"alarmedObject\":{ \"id\":\"vManage_000000\", \"href\":\" http://api/alarmedobject/000000\" }, \"sourceSystemId\":\"SOURCE_SYSTEM_vManage_00000_000_00\", \"alarmDetails\":\"Software Failure on SD-WAN Controller vManage_000000\", \"alarmEscalation\": false, \"state\":\"RAISED\", \"alarmChangedTime\":\"2017-08-15T07:04:15.666Z\", \"proposedRepairActions\":\"Switch in standby equipment\", \"alarmReportingTime\":\"2017-06-15T07:04:15.666Z\", \"alarmRaisedTime\":\"2020-09-15T07:04:15.666Z\", \"plannedOutageIndication\":\"IN_SERVICE\", \"serviceAffecting\":true, \"affectedService\":[ { \"id\":\"SD WAN Enterprise Solutions\", \"href\":\"http://api/service/vlan_dot0_dot0\" }, { \"id\":\"Santa Clara SD WAN Application Service\", \"href\":\"http://api/service/vlan_dot0_dot0\" } ] }" \ --user 'user:'password' Corpo da resposta. { "result": { "alarmChangedTime": "2017-08-15T07:04:15.666Z", "id": "6e116bb8db09201087b9a8394b961950_" } } ## API aberta de gestão de alarmes -- POST /sn_ind_tmf642/alarm_mgmt/alarm {#ariaid-title5} Cria um registro de alarme na tabela Eventos \[em_event\]. Quando o registro do alarme é criado, um ID para o alarme é adicionado ao campo Message key. Um registro de alerta também pode ser criado com base nas [regras de gerenciamento de alertas](https://www.servicenow.com/docs/access?context=alert-management-rule&version=xanadu&pubname=xanadu-it-operations-management&ft:locale=en-US). Este endpoint grava o corpo da resposta no campo Informações adicionais do registro de evento na tabela Eventos \[em_event\]. ### Formato da URL URL padrão: /api/sn_ind_tmf642/alarm_mgmt/alarm ### Parâmetros de solicitação compatíveis {#alarm-POST-create__entry__2} | Nome | Descrição | |-|-| | Nenhum(a) | | [Tabela 19. Parâmetros de caminho] {#alarm-POST-create__entry__6} | Nome | Descrição | |-|-| | Nenhum(a) | | [Tabela 20. Parâmetros de consulta] {#alarm-POST-create__entry__10}{#alarm-POST-create__alm-mgmt-affectedService-entry}{#alarm-POST-create__alm-mgmt-affectedServiceHREF-entry}{#alarm-POST-create__alm-mgmt-create-alarmobj-href-entry}{#alarm-POST-create__alm-mgmt-create-alarmtype}{#alarm-POST-create__alm-mgmt-perceivedSeverity-desc}{#alarm-POST-create__alm-mgmt-specificProb-ph} | Nome | Descrição | |-|-| | Serviçoafetado | Lista de objetos que identificam um ou mais serviços afetados pelo alarme. Tipo de dados: matriz "affectedService":[ { "href": "String", "id": "String" }, ] | | Serviçoafetado.href | Referência de URL que fornece detalhes do serviço afetado. Tipo de dados: cadeia de caracteres | | affectedService.id | Obrigatório. Identificador do serviço afetado pelo alarme. Este valor é mapeado para o item de configuração (IC) afetado no alerta. Tipo de dados: cadeia de caracteres | | detalhesdoalarme | Detalhes adicionais sobre o alarme. Tipo de dados: cadeia de caracteres | | AlarmedObject | Obrigatório. Detalhes do objeto de alarme. "alarmedObject": { "href": "String", "id": "String" } Tipo de dados: objeto | | alarmedObject.id | Obrigatório. Identificador exclusivo do objeto de alarme. Este valor é mapeado para um IC no sistema. Tipo de dados: cadeia de caracteres | | AlarmedObject.href | Referência de URL para obter os detalhes do objeto de alarme. Tipo de dados: cadeia de caracteres | | AlarmedObjectType | Tipo ou classe de objeto associado ao evento. Tipo de dados: cadeia de caracteres | | AlarmRaisedTime | Data e hora em que o alarme ocorre em sua origem. Tipo de dados: cadeia de caracteres | | AlarmReportingTime | Data e hora em que o OSS relata seu alarme. Este valor pode ser diferente do valor alarmRaisedTime. Por exemplo, se um sistema de gestão de elementos (EMS) mantiver a lista de alarmes: * O alarmRaisedTime é o tempo de detecção do alarme pelo elemento de rede (NE). * O alarmReportingTime é o tempo de armazenamento do relatório de alarme na lista de alarmes do EMS. {#alarm-POST-create__ul_mbt_1rf_ynb} Tipo de dados: cadeia de caracteres | | tipo de alarme | Obrigatório. Categoria de alarme. Tipo de dados: cadeia de caracteres | | cruzadoInformações sobre limite | Detalhes sobre o limite ultrapassado. "crossedThresholdInformation": { "direction": "String", "granularity": "String", "indicatorName": "String", "indicatorUnit": "String", "observedValue": "String", "thresholdCrossingDescription": "String", "thresholdId": "String", "thresholdRef": "String" } Tipo de dados: objeto | | CrossThresholdInformation.direction | Direção de cruzamento do limite. Valores possíveis: * PARA CIMA * PARA BAIXO {#alarm-POST-create__ul_fsb_jlg_ynb} Tipo de dados: cadeia de caracteres | | cruzadoInformaçõesDeLimite.granularidade | Granularidade na qual o indicador é avaliado para ultrapassar o limite. Por exemplo, `5MINUTES`. Tipo de dados: cadeia de caracteres | | CrossThresholdInformation.IndicatorName | Nome do indicador que ultrapassa o limite do alarme. Tipo de dados: cadeia de caracteres | | cruzadoInformaçõesDeLimite.indicadorUnidade | Unidade de medida do indicador correspondente ao limite ultrapassado. Tipo de dados: cadeia de caracteres | | cruzadoInformaçõesDeLimite.observadoValue | Número que identifica o indicador que ultrapassou o limite. Tipo de dados: cadeia de caracteres | | CrossThresholdInformation.thresholdCrossingDescription | Mais detalhes do limite do alarme de ultrapassagem de limite. Tipo de dados: cadeia de caracteres | | CrossThresholdInformation.thresholdId | Obrigatório. Identificador exclusivo do limite que causou o alarme. Tipo de dados: cadeia de caracteres | | CrossThresholdInformation.thresholdRef | URL do objeto de limite. Tipo de dados: cadeia de caracteres | | externalAlarmId | Obrigatório. Identificador exclusivo do alarme do sistema de origem que publica o alarme. Tipo de dados: cadeia de caracteres | | ID | Identificador exclusivo para o sistema para identificar e processar a carga do alarme como um evento. Este valor deve estar vazio se for usado na carga útil. O sistema gera este ID exclusivo para o evento e o envia como parte da carga de resposta. Tipo de dados: cadeia de caracteres | | Severidade percebida | Obrigatório. Gravidade do alarme. Valores possíveis: * LIMPAR * CRÍTICO * PRINCIPAL * BAIXO * AVISO {#alarm-POST-create__ul_vcp_c4f_ynb} Tipo de dados: cadeia de caracteres | | planejadoIndicaçãoDeIndisponibilidade | Indica que o objeto gerenciado para este alarme está em um estado de indisponibilidade planejada. Por exemplo, manutenção planejada ou fora de serviço. Tipo de dados: cadeia de caracteres | | provávelCausa | Obrigatório. Situação mais provável para acionar o alarme. Use com alarmType para qualificar o alarme. Tipo de dados: cadeia de caracteres | | AçõesDeReparopropostas | Se disponível para o sistema, fornece uma ação de reparo para resolver o problema que aciona o alarme. Tipo de dados: cadeia de caracteres | | serviçoAfeta | Sinalizador que indica se o alarme afeta o serviço. Valores válidos: * verdadeiro: o alarme afeta o desempenho ou a disponibilidade do serviço. * falso: o alarme não afeta o serviço. {#alarm-POST-create__ul_omz_dnf_ynb} Padrão: falso Tipo de dados: booliano | | sourceSystemId | Obrigatório. ID da instância do alarme de origem. Tipo de dados: cadeia de caracteres | | Problema específico | Problema específico que aciona o alarme. Use com probableCause para qualificar o alarme. Tipo de dados: cadeia de caracteres | | estado | Estado do alarme. Valores válidos: * Pronto * Processado * Ignorado * Erro {#alarm-POST-create__ul_ilh_3jt_xnb}Se um valor inválido for fornecido, o estado será definido como `Pronto`. Se o estado for `Pronto`, um alerta será criado na tabela Alerta \[em_alert\] e o estado se tornará `Processado`. Se o estado for `Processado`, `Ignorado`ou `Erro`, nenhum alerta será criado. Valor padrão: Pronto Tipo de dados: cadeia de caracteres | [Tabela 21. Parâmetros do corpo da solicitação (JSON)] ### Cabeçalhos Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte [Cabeçalhos de REST API compatíveis](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles."). {#alarm-POST-create__entry__72}{#alarm-POST-create__accept-JSON-only-entry-RESTAPI}{#alarm-POST-create__content_type-JSON-only-entry-RESTAPI} | Cabeçalho | Descrição | |-|-| | Aceitar | Formato de dados do corpo da resposta. Oferece suporte somente a application/json. | | Tipo de conteúdo | Formato de dados do corpo da solicitação. Oferece suporte somente a application/json. | [Tabela 22. Cabeçalhos da solicitação] {#alarm-POST-create__table_vrm_1xs_xnb__entry__2} | Cabeçalho | Descrição | |-|-| | Nenhum(a) | | [Tabela 23. Cabeçalhos de resposta] {#alarm-POST-create__table_vrm_1xs_xnb} ### Códigos de status Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de códigos de status possíveis usados na REST API, consulte [Códigos de resposta HTTP de REST API](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles."). {#alarm-POST-create__table_bly_lyb_ynb__entry__2} | Código de status | Descrição | |-|-| | 201 | Bem-sucedido. A solicitação foi processada com sucesso. | | 400 | Solicitação incorreta. Possíveis motivos: * Carga inválida. ID de alarme obrigatório ausente. * Carga inválida. Campo obrigatório ausente:\ . * Carga inválida. Objeto obrigatório ausente. * Evento não criado, com falha. * Não é possível limpar o evento. * Não é possível atualizar o evento. * O evento não existe. {#alarm-POST-create__ul_f4x_sdb_ynb} | [Tabela 24. Códigos de status] {#alarm-POST-create__table_bly_lyb_ynb} ### Parâmetros do corpo da resposta (JSON) {#alarm-POST-create__entry__88}{#alarm-POST-create__d3018e79}{#alarm-POST-create__d3018e92}{#alarm-POST-create__d3018e411}{#alarm-POST-create__d3018e350} | Nome | Descrição | |-|-| | Serviçoafetado | Lista de objetos que identificam um ou mais serviços afetados pelo alarme. Tipo de dados: matriz "affectedService":[ { "href": "String", "id": "String" }, ] | | Serviçoafetado.href | Referência de URL que fornece detalhes do serviço afetado. Tipo de dados: cadeia de caracteres | | affectedService.id | Identificador do serviço afetado pelo alarme. Este valor é mapeado para o item de configuração (IC) afetado no alerta. Tipo de dados: cadeia de caracteres | | detalhesdoalarme | Detalhes adicionais sobre o alarme. Tipo de dados: cadeia de caracteres | | AlarmedObject | Detalhes do objeto de alarme. "alarmedObject": { "href": "String", "id": "String" } Tipo de dados: objeto | | AlarmedObject.id | Identificador exclusivo do objeto de alarme. Este valor é mapeado para um IC no sistema. Tipo de dados: cadeia de caracteres | | AlarmedObject.href | Referência de URL para obter os detalhes do objeto de alarme. Tipo de dados: cadeia de caracteres | | AlarmedObjectType | Tipo ou classe de objeto associado ao evento. Tipo de dados: cadeia de caracteres | | AlarmRaisedTime | Data e hora em que o alarme ocorre em sua origem. Tipo de dados: cadeia de caracteres | | AlarmReportingTime | Data e hora em que o OSS relata seu alarme. Este valor pode ser diferente do valor alarmRaisedTime. Por exemplo, se um sistema de gestão de elementos (EMS) mantiver a lista de alarmes: * O alarmRaisedTime é o tempo de detecção do alarme pelo elemento de rede (NE). * O alarmReportingTime é o tempo de armazenamento do relatório de alarme na lista de alarmes do EMS. {#alarm-POST-create__d3018e467} Tipo de dados: cadeia de caracteres | | tipo de alarme | Categoria de alarme. Tipo de dados: cadeia de caracteres | | cruzadoInformações sobre limite | Detalhes sobre o limite ultrapassado. "crossedThresholdInformation": { "direction": "String", "granularity": "String", "indicatorName": "String", "indicatorUnit": "String", "observedValue": "String", "thresholdCrossingDescription": "String", "thresholdId": "String", "thresholdRef": "String" } Tipo de dados: objeto | | CrossThresholdInformation.direction | Direção de cruzamento do limite. Valores possíveis: * PARA CIMA * PARA BAIXO {#alarm-POST-create__d3018e147} Tipo de dados: cadeia de caracteres | | cruzadoInformaçõesDeLimite.granularidade | Granularidade na qual o indicador é avaliado para ultrapassar o limite. Por exemplo, `5MINUTES`. Tipo de dados: cadeia de caracteres | | CrossThresholdInformation.IndicatorName | Nome do indicador que ultrapassa o limite do alarme. Tipo de dados: cadeia de caracteres | | cruzadoInformaçõesDeLimite.indicadorUnidade | Unidade de medida do indicador correspondente ao limite ultrapassado. Tipo de dados: cadeia de caracteres | | cruzadoInformaçõesDeLimite.observadoValue | Número que identifica o indicador que ultrapassou o limite. Tipo de dados: cadeia de caracteres | | CrossThresholdInformation.thresholdCrossingDescription | Mais detalhes do limite do alarme de ultrapassagem de limite. Tipo de dados: cadeia de caracteres | | CrossThresholdInformation.thresholdId | Identificador exclusivo do limite que causou o alarme. Tipo de dados: cadeia de caracteres | | CrossThresholdInformation.thresholdRef | URL do objeto de limite. Tipo de dados: cadeia de caracteres | | externalAlarmId | Identificador exclusivo do alarme do sistema de origem que publica o alarme. Tipo de dados: cadeia de caracteres | | href | URL do recurso. Tipo de dados: cadeia de caracteres | | ID | Identificador exclusivo para o sistema para identificar e processar a carga do alarme como um evento. Tipo de dados: cadeia de caracteres | | Severidade percebida | Gravidade do alarme. Valores possíveis: * LIMPAR * CRÍTICO * PRINCIPAL * BAIXO * AVISO {#alarm-POST-create__d3018e256} Tipo de dados: cadeia de caracteres | | planejadoIndicaçãoDeIndisponibilidade | Indica que o objeto gerenciado para este alarme está em um estado de indisponibilidade planejada. Por exemplo, manutenção planejada ou fora de serviço. Tipo de dados: cadeia de caracteres | | provávelCausa | Situação mais provável para acionar o alarme. Use com alarmType para qualificar o alarme. Tipo de dados: cadeia de caracteres | | AçõesDeReparopropostas | Se disponível para o sistema, fornece uma ação de reparo para resolver o problema que aciona o alarme. Tipo de dados: cadeia de caracteres | | serviçoAfeta | Sinalizador que indica se o alarme afeta o serviço. Valores válidos: * verdadeiro: o alarme afeta o desempenho ou a disponibilidade do serviço. * falso: o alarme não afeta o serviço. {#alarm-POST-create__d3018e330} Padrão: falso Tipo de dados: booliano | | sourceSystemId | ID da instância do alarme de origem. Tipo de dados: cadeia de caracteres | | Problema específico | Problema específico que aciona o alarme. Use com probableCause para qualificar o alarme. Tipo de dados: cadeia de caracteres | | estado | Estado do alarme. Valores válidos: * Pronto * Processado * Ignorado * Erro {#alarm-POST-create__d3018e558}Se um valor inválido for fornecido, o estado será definido como `Pronto`. Se o estado for `Pronto`, um alerta será criado na tabela Alerta \[em_alert\] e o estado se tornará `Processado`. Se o estado for `Processado`, `Ignorado`ou `Erro`, nenhum alerta será criado. Valor padrão: Pronto Tipo de dados: cadeia de caracteres | [ ] ### Solicitação de cURL Este exemplo cria um alarme. curl "https://.service-now.com/api/sn_ind_tmf642/alarm_mgmt/alarm" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ "href":"http://api/alarm/ROUTER_IF@Cisco-0000-0-0-0-0-00-00-0-- Xz0/00@00", "externalAlarmId":"", "alarmType":"QualityOfServiceAlarm", "type":"QualityOfServiceAlarm", "ackState":"acknowledged", "perceivedSeverity":"CRITICAL", "probableCause":"Threshold crossed", "specificProblem":"Inbound Traffic threshold crossed", "alarmedObjectType":"ROUTER", "alarmedObject":{ "id":"vManage_000000", "href":" http://api/alarmedobject/000000" }, "sourceSystemId":"SOURCE_SYSTEM_vManage_00000_000_00", "alarmDetails":"Software Failure on SD-WAN Controller vManage_000000", "state":"RAISED", "alarmChangedTime":"2017-08-15T07:04:15.666Z", "proposedRepairActions":"Switch in standby equipment", "alarmReportingTime":"2017-06-15T07:04:15.666Z", "alarmRaisedTime":"2020-09-15T07:04:15.666Z", "plannedOutageIndication":"IN_SERVICE", "serviceAffecting":true, "affectedService":[ { "id":"SD WAN Enterprise Solutions", "href":"http://api/service/vlan_dot0_dot0" }, { "id":"Santa Clara SD WAN Application Service", "href":"http://api/service/vlan_dot0_dot0" } ] }" \ --user 'user':'password' Corpo da resposta. { "href":"http://api/alarm/ROUTER_IF@Cisco-0000-0-0-0-0-00-00-0-- Xz0/00@00", "externalAlarmId":"", "alarmType":"QualityOfServiceAlarm", "type":"QualityOfServiceAlarm", "ackState":"acknowledged", "perceivedSeverity":"CRITICAL", "probableCause":"Threshold crossed", "specificProblem":"Inbound Traffic threshold crossed", "alarmedObjectType":"ROUTER", "alarmedObject":{ "id":"vManage_000000", "href":" http://api/alarmedobject/000000" }, "sourceSystemId":"SOURCE_SYSTEM_vManage_00000_000_00", "alarmDetails":"Software Failure on SD-WAN Controller vManage_000000", "state":"RAISED", "alarmChangedTime":"2017-08-15T07:04:15.666Z", "proposedRepairActions":"Switch in standby equipment", "alarmReportingTime":"2017-06-15T07:04:15.666Z", "alarmRaisedTime":"2020-09-15T07:04:15.666Z", "plannedOutageIndication":"IN_SERVICE", "serviceAffecting":true, "affectedService":[ { "id":"SD WAN Enterprise Solutions", "href":"http://api/service/vlan_dot0_dot0" }, { "id":"Santa Clara SD WAN Application Service", "href":"http://api/service/vlan_dot0_dot0" } ] } ## API aberta de gestão de alarmes -- POST /sn_ind_tmf642/alarm_mgmt/alarm/{id}/clear {#ariaid-title6} Limpa um alarme especificado e fecha qualquer alerta associado. ### Formato da URL URL padrão: /api/sn_ind_tmf642/alarm_mgmt/alarm/{id}/clear ### Parâmetros de solicitação compatíveis {#alarm-POST-clear__entry__2} | Nome | Descrição | |-|-| | ID | Identificador exclusivo do alarme a ser limpo. Localizado no campo Chave de mensagem na tabela Eventos \[em_events\]. Tipo de dados: cadeia de caracteres | [Tabela 25. Parâmetros de caminho] {#alarm-POST-clear__entry__6} | Nome | Descrição | |-|-| | Nenhum(a) | | [Tabela 26. Parâmetros de consulta] {#alarm-POST-clear__entry__10} | Nome | Descrição | |-|-| | alarmeClearedTime | Data e hora em que o alarme é apagado na origem. Este valor está no campo Time of event do registro na tabela Eventos \[em_events\]. Tipo de dados: cadeia de caracteres | | limparSystemId | Obrigatório. Nome da instância da qual a operação alarmCleared foi invocada. Tipo de dados: cadeia de caracteres | | limparUsuárioId | Obrigatório. ID exclusivo do usuário que invocou a operação alarmCleared. Este valor está no campo Source do registro na tabela Eventos \[em_events\]. Tipo de dados: cadeia de caracteres | [Tabela 27. Parâmetros do corpo da solicitação (JSON)] ### Cabeçalhos Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte [Cabeçalhos de REST API compatíveis](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles."). {#alarm-POST-clear__entry__18}{#alarm-POST-clear__accept-JSON-only-entry-RESTAPI}{#alarm-POST-clear__content_type-JSON-only-entry-RESTAPI} | Cabeçalho | Descrição | |-|-| | Aceitar | Formato de dados do corpo da resposta. Oferece suporte somente a application/json. | | Tipo de conteúdo | Formato de dados do corpo da solicitação. Oferece suporte somente a application/json. | [Tabela 28. Cabeçalhos da solicitação] {#alarm-POST-clear__entry__24} | Nome | Descrição | |-|-| | Nenhum(a) | | [Tabela 29. Cabeçalhos de resposta] ### Códigos de status Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de códigos de status possíveis usados na REST API, consulte [Códigos de resposta HTTP de REST API](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles."). {#alarm-POST-clear__entry__28} | Código de status | Descrição | |-|-| | 201 | Bem-sucedido. A solicitação foi processada com sucesso. | | 400 | Solicitação incorreta. Possíveis motivos: * Carga inválida. ID de alarme obrigatório ausente. * Carga inválida. Campo obrigatório ausente:\ . * Carga inválida. Objeto obrigatório ausente. * Evento não criado, com falha. * Não é possível limpar o evento. * Não é possível atualizar o evento. * O evento não existe. {#alarm-POST-clear__ul_f4x_sdb_ynb} | [Tabela 30. Códigos de status] ### Parâmetros do corpo da resposta (JSON) {#alarm-POST-clear__entry__34} | Nome | Descrição | |-|-| | alarmeClearedTime | Data e hora em que o alarme é apagado na origem. Este valor está no campo Time of event do registro na tabela Eventos \[em_events\]. Tipo de dados: cadeia de caracteres | | limparSystemId | Nome da instância da qual a operação alarmCleared foi invocada. Tipo de dados: cadeia de caracteres | | limparUsuárioId | ID exclusivo do usuário que invocou a operação alarmCleared. Este valor está no campo Source do registro na tabela Eventos \[em_events\]. Tipo de dados: cadeia de caracteres | | href | URL do alarme. Tipo de dados: cadeia de caracteres | | ID | ID exclusivo no campo Message key de um registro na tabela Eventos \[em_events\]. Tipo de dados: cadeia de caracteres | [ ] ### Solicitação de cURL Este exemplo limpa um alarme. curl "https://.service-now.com/api/sn_ind_tmf642/alarm_mgmt/alarm/6e116bb8db09201087b9a8394b961950_/clear" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ \"alarmClearedTime\": \"2017-08-15 06:04:15\", \"clearSystemId\": \"\", \"clearUserId\": \"SOURCE_SYSTEM_vManage_00000_000_00\" }" \ --user 'user':'password' Corpo da resposta. { "result": { "alarmClearedTime": "2017-08-15 06:04:15", "clearSystemId": "", "clearUserId": "SOURCE_SYSTEM_vManage_00000_000_00", "id": "6e116bb8db09201087b9a8394b961950_" } }