API Gestão de mudanças

Gestão de mudanças - EXCLUA /sn_chg_rest/change//task/ task/ task_sys_id

Exclui a tarefa de solicitação de mudança identificada pelos sys_ids especificados.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change//change//task/ task/ task_sys_id

URL padrão: /api/sn_chg_rest/change//task/ task/ task_sys_id

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 1. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
change_sys_id	Sys_id da solicitação de mudança à qual a tarefa está associada. Verifica se a tarefa está realmente associada à solicitação de mudança especificada. Tipo de dados: Cadeia de caracteres Tabela: solicitação de mudança [change_request]
task_sys_id	Sys_id da tarefa de solicitação de mudança a ser excluída. Tipo de dados: Cadeia de caracteres Tabela: Tarefas de mudança [change_task]

Tabela 2. Parâmetros de consulta
Nome	Descrição
Nenhum(a)

Tabela 3. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 4. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 5. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 6. Códigos de status
Código do status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. Não foi possível encontrar o registro especificado.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
pares nome-valor	Todos os campos (chave) com seus valores associados para a tarefa de solicitação de mudança identificada antes da exclusão. Tipo de dados: Objeto
primário	Informações da solicitação de mudança à qual esta tarefa foi associada. Tipo de dados: Objeto `parent: { display_value: "String", value: "String" }`
parent.display_value	Sys_id da tarefa primária a ser exibida em uma IU. Tipo de dados: Cadeia de caracteres
valor.primário	Sys_id da tarefa primária. Tipo de dados: Cadeia de caracteres
sys_id	Informações de sys_id da solicitação de mudança excluída. Tipo de dados: Objeto `sys_id: { display_value: "String", value: "String" }`
sys_id.display_value	Sys_id da solicitação de mudança a ser exibida em uma IU. Tipo de dados: Cadeia de caracteres
sys_id.value	Sys_id da solicitação de mudança. Tipo de dados: Cadeia de caracteres

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/task/12629ec4b750230096c3e4f6ee11a9d5" \
--request DELETE \
--header "Accept:application/json" \ 
--user "username":"password"

{
  result: [
    {
      sys_id: {
        value: "12629ec4b750230096c3e4f6ee11a9d5",
        display_value: "12629ec4b750230096c3e4f6ee11a9d5"
      },
      parent: {
        value: "0f4ac6c4b750230096c3e4f6ee11a9fe", 
        display_value: "CHG0033046 "
      },
      ..., // all valid fields in record, example below
      short_description: {
        value: "Retire both nodes",
        display_value: "Retire both nodes"
      }
    }
  ]
}

Gestão de mudanças - EXCLUA /sn_chg_rest/change/

Exclui a solicitação de mudança associada ao sys_id especificado.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/ sys_id

URL padrão: /api/sn_chg_rest/change/

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 7. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id do registro de solicitação de mudança a ser excluído. Tipo de dados: Cadeia de caracteres Tabela: solicitação de mudança [change_request]

Tabela 8. Parâmetros de consulta
Nome	Descrição
Nenhum(a)

Tabela 9. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 10. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 11. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 12. Códigos de status
Código do status	Descrição
200	Solicitação concluída com sucesso.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. Não foi possível encontrar o registro especificado.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
resultado	Registro de solicitação de mudança que foi excluído. Cada elemento neste objeto corresponde a um campo no registro da tabela Solicitação de mudança [change_request]. Tipo de dados: Objeto

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/b0dbda5347c12200e0ef563dbb9a718f" \
--request DELETE \
--header "Accept:application/json" \
--user "username":"password"

{
  "result":
    {
      "reason": {
        "display_value": "",
        "value": ""
      },
      "parent": {
        "display_value": "",
        "value": ""
      },
      "watch_list": {
        "display_value": "",
        "value": ""
       },
       "proposed_change": {
         "display_value": "",
         "value": ""
       },
       "upon_reject": {
         "display_value": "Cancel all future Tasks",
         "value": "cancel"
       },
       "sys_updated_on": {
         "display_value": "2015-07-06 11:59:27",
         "value": "2015-07-06 18:59:27",
         "display_value_internal": "2015-07-06 11:59:27"
      },
      "type": {
        "display_value": "Standard",
        "value": "standard"
      },
      "approval_history": {
        "display_value": "",
        "value": ""
      },
      "skills": {
        "display_value": "",
        "value": ""
      },
      "test_plan": {
        "display_value": "--Confirm that there are no monitoring alerts for the router",
        "value": "--Confirm that there are no monitoring alerts for the router"
      },
      "number": {
        "display_value": "CHG0000024",
        "value": "CHG0000024"
      },
      "is_bulk": {
        "display_value": "false",
        "value": false
      },
      "cab_delegate": {
        "display_value": "",
        "value": ""
      },
      "requested_by_date": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "ci_class": {
        "display_value": "cmdb_ci",
        "value": "cmdb_ci"
      },
      "state": {
        "display_value": "Closed",
        "value": 3.0
      },
      "sys_created_by": {
        "display_value": "admin",
        "value": "admin"
      },
      "knowledge": {
        "display_value": "false",
        "value": false
      },
      "order": {
        "display_value": "",
        "value": ""
      },
      "phase": {
        "display_value": "Requested",
        "value": "requested"
      },
      "cmdb_ci": {
        "display_value": "",
        "value": ""
      },
      "delivery_plan": {
        "display_value": "",
        "value": ""
      },
      "impact": {
        "display_value": "3 - Low",
        "value": 3.0
      },
      "contract": {
        "display_value": "",
        "value": ""
      },
      "active": {
        "display_value": "false",
        "value": false
      },
      "work_notes_list": {
        "display_value": "",
        "value": ""
      },
      "priority": {
        "display_value": "4 - Low",
        "value": 4.0
      },
      "sys_domain_path": {
        "display_value": "/",
        "value": "/"
      },
      "cab_recommendation": {
        "display_value": "",
        "value": ""
      },
      "production_system": {
        "display_value": "false",
        "value": false
      },
      "rejection_goto": {
        "display_value": "",
        "value": ""
      },
      "review_date": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "requested_by": {
        "display_value": "System Administrator",
        "value": "6816f79cc0a8016401c5a33be04be441"
      },
      "business_duration": {
        "display_value": "",
        "value": ""
      },
      "group_list": {
        "display_value": "",
        "value": ""
      },
      "change_plan": {
        "display_value": "",
        "value": ""
      },
      "approval_set": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "wf_activity": {
        "display_value": "",
        "value": ""
      },
      "implementation_plan": {
        "display_value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform",
        "value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform"
      },
      "universal_request": {
        "display_value": "",
        "value": ""
      },
      "end_date": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "short_description": {
        "display_value": "Reboot the server at 6 am",
        "value": "Reboot the server at 6 am"
      },
      "correlation_display": {
        "display_value": "",
        "value": ""
      },
      "work_start": {
        "display_value": "2015-07-06 11:56:04",
        "value": "2015-07-06 18:56:04",
        "display_value_internal": "2015-07-06 11:56:04"
      },
      "delivery_task": {
        "display_value": "",
        "value": ""
      },
      "outside_maintenance_schedule": {
        "display_value": "false",
        "value": false
      },
      "additional_assignee_list": {
        "display_value": "",
        "value": ""
      },
      "std_change_producer_version": {
        "display_value": "Clear BGP sessions on a Cisco router - 1",
        "value": "16c2273c47010200e90d87e8dee49006"
      },
      "sys_class_name": {
        "display_value": "Change Request",
        "value": "change_request"
      },
      "service_offering": {
        "display_value": "",
        "value": ""
      },
      "closed_by": {
        "display_value": "System Administrator",
        "value": "6816f79cc0a8016401c5a33be04be441"
      },
      "follow_up": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "review_status": {
        "display_value": "",
        "value": ""
      },
      "reassignment_count": {
        "display_value": "2",
        "value": 2.0
      },
      "start_date": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "assigned_to": {
        "display_value": "",
        "value": ""
      },
      "variables": {
        "display_value": "variable_pool",
        "value": "variable_pool"
      },
      "sla_due": {
        "display_value": "UNKNOWN",
        "value": "",
        "display_value_internal": ""
      },
      "comments_and_work_notes": {
        "display_value": "",
        "value": ""
      },
      "escalation": {
        "display_value": "Normal",
        "value": 0.0
      },
      "upon_approval": {
        "display_value": "Proceed to Next Task",
        "value": "proceed"
      },
      "correlation_id": {
        "display_value": "",
        "value": ""
      },
      "made_sla": {
        "display_value": "true",
        "value": true
      },
      "backout_plan": {
        "display_value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work",
        "value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work"
      },
      "conflict_status": {
        "display_value": "Not Run",
        "value": "Not Run"
      },
      "task_effective_number": {
        "display_value": "CHG0000024",
        "value": "CHG0000024"
      },
      "sys_updated_by": {
        "display_value": "admin",
        "value": "admin"
      },
      "opened_by": {
        "display_value": "System Administrator",
        "value": "6816f79cc0a8016401c5a33be04be441"
      },
      "user_input": {
        "display_value": "",
        "value": ""
      },
      "sys_created_on": {
        "display_value": "2015-07-06 11:55:46",
        "value": "2015-07-06 18:55:46",
        "display_value_internal": "2015-07-06 11:55:46"
      },
      "on_hold_task": {
        "display_value": "",
        "value": ""
      },
      "sys_domain": {
        "display_value": "global",
        "value": "global"
      },
      "route_reason": {
        "display_value": "",
        "value": ""
      },
      "closed_at": {
        "display_value": "2015-07-06 11:56:23",
        "value": "2015-07-06 18:56:23",
        "display_value_internal": "2015-07-06 11:56:23"
      },
      "review_comments": {
        "display_value": "",
        "value": ""
      },
      "business_service": {
        "display_value": "",
        "value": ""
      },
      "time_worked": {
        "display_value": "",
        "value": ""
      },
      "chg_model": {
        "display_value": "",
        "value": ""
      },
      "expected_start": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "opened_at": {
        "display_value": "2015-06-09 11:55:46",
        "value": "2015-06-09 18:55:46",
        "display_value_internal": "2015-06-09 11:55:46"
      },
      "work_end": {
        "display_value": "2015-07-06 11:56:10",
        "value": "2015-07-06 18:56:10",
        "display_value_internal": "2015-07-06 11:56:10"
      },
      "phase_state": {
        "display_value": "Open",
        "value": "open"
      },
      "cab_date": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "work_notes": {
        "display_value": "",
        "value": ""
      },
      "close_code": {
        "display_value": "Successful",
        "value": "successful"
      },
      "assignment_group": {
        "display_value": "Network",
        "value": "287ebd7da9fe198100f92cc8d1d2154e"
      },
      "description": {
        "display_value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n",
        "value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n"
      },
      "on_hold_reason": {
        "display_value": "",
        "value": ""
      },
      "calendar_duration": {
        "display_value": "",
        "value": ""
      },
      "close_notes": {
        "display_value": "Completed without issues",
        "value": "Completed without issues"
      },
      "sys_id": {
        "display_value": "b0dbda5347c12200e0ef563dbb9a718f",
        "value": "b0dbda5347c12200e0ef563dbb9a718f"
      },
      "contact_type": {
        "display_value": "Phone",
        "value": "phone"
      },
      "cab_required": {
        "display_value": "false",
        "value": false
      },
      "urgency": {
        "display_value": "3 - Low",
        "value": 3.0
      },
      "scope": {
        "display_value": "Medium",
        "value": 3.0
      },
      "company": {
        "display_value": "",
        "value": ""
      },
      "justification": {
        "display_value": "",
        "value": ""
      },
      "activity_due": {
        "display_value": "UNKNOWN",
        "value": "",
        "display_value_internal": ""
      },
      "comments": {
        "display_value": "",
        "value": ""
      },
      "approval": {
        "display_value": "Approved",
        "value": "approved"
      },
      "due_date": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "sys_mod_count": {
        "display_value": "10",
        "value": 10.0
      },
      "on_hold": {
        "display_value": "false",
        "value": false
      },
      "sys_tags": {
        "display_value": "",
        "value": ""
      },
      "conflict_last_run": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "risk_value": {
        "display_value": "",
        "value": ""
      },
      "unauthorized": {
        "display_value": "false",
        "value": false
      },
      "risk": {
        "display_value": "Moderate",
        "value": 3.0
      },
      "location": {
        "display_value": "",
        "value": ""
      },
      "category": {
        "display_value": "Other",
        "value": "Other"
      },
      "risk_impact_analysis": {
        "display_value": "",
        "value": ""
      }
    }
}

Gestão de mudanças - EXCLUA /sn_chg_rest/change/

Cancela o processo de verificação de conflito em execução para a solicitação de mudança especificada (sys_id).

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/ sys_id/conflict

URL padrão: /api/sn_chg_rest/change//sys_id/conflict

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 13. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id do registro de solicitação de mudança para o qual cancelar o processo de verificação de conflito em execução. Tipo de dados: Cadeia de caracteres Tabela: solicitação de mudança [change_request]

Tabela 14. Parâmetros de consulta
Nome	Descrição
Nenhum(a)

Tabela 15. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 16. Cabeçalhos da solicitação
Cabeçalho	Descrição
Nenhum(a)

Tabela 17. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 18. Códigos de status
Código do status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação incorreta. Falha ao cancelar solicitação.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. Não foi possível encontrar o registro especificado.
500	Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
Nenhum(a)

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/conflict" \
--request DELETE \
--user "username":"password"

None

Gestão de mudanças - EXCLUA /sn_chg_rest/change/emergency/

Exclui a solicitação de mudança de emergência identificada pelo sys_id especificado.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/emergency/ sys_id

URL padrão: /api/sn_chg_rest/change/emergency/

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 19. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id da solicitação de mudança de emergência a ser excluída. Tipo de dados: Cadeia de caracteres Tabela: Solicitação de mudança [ change_request]

Tabela 20. Parâmetros de consulta
Nome	Descrição
Nenhum(a)

Tabela 21. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 22. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 23. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 24. Códigos de status
Código do status	Descrição
200	Solicitação concluída com sucesso.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. Não foi possível encontrar o registro especificado.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
pares nome-valor	Valores para todos os campos na solicitação de mudança associada. Tipo de dados: Objeto
estado	Estado da solicitação de mudança antes da exclusão. Tipo de dados: Objeto `state: { display_value: "String", value: "String" }`
state.display_value	Estado a ser exibido na IU. Tipo de dados: Cadeia de caracteres
state.value	Valor do estado interno. Tipo de dados: Cadeia de caracteres
sys_id	Informações de sys_id para a solicitação de mudança. Tipo de dados: Objeto `sys_id: { display_value: "String", value: "String" }`
sys_id.display_value	Sys_id da solicitação de mudança a ser exibida em uma IU. Tipo de dados: Cadeia de caracteres
sys_id.value	Sys_id da solicitação de mudança. Tipo de dados: Cadeia de caracteres
tipo	Tipo de solicitação de mudança Tipo de dados: Objeto `type: { display_value: "String", value: "String" }`
type.display_value	Altere o tipo a ser exibido em uma IU. O valor é sempre "Emergência". Tipo de dados: Cadeia de caracteres
type.value	Valor do tipo interno. O valor é sempre "emergência". Tipo de dados: Cadeia de caracteres

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/emergency/b0dbda5347c12200e0ef563dbb9a718f" \
--request DELETE \
--header "Accept:application/json" \
--user "username":"password"

{
  result: [
    {
      sys_id: {
        value: "b0dbda5347c12200e0ef563dbb9a718f", 
        display_value: "b0dbda5347c12200e0ef563dbb9a718f"
      },
      state: {
        value: "-5", 
        display_value: "New"
      },
      type: {
        value: "emergency",
        display_value: "Emergency"
      },
      ..., // all valid fields in record, example below
      short_description: {
        value: "Remove server",
        display_value: "Remove server"
      },
    }, 
  ]
}

Gestão de mudanças - EXCLUA /sn_chg_rest/change/normal/

Exclui a solicitação de mudança normal identificada pelo sys_id especificado.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/normal/ sys_id

URL padrão: /api/sn_chg_rest/change/normal/

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 25. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id da solicitação de mudança normal a ser excluída. Tipo de dados: Cadeia de caracteres Tabela: solicitação de mudança [change_request]

Tabela 26. Parâmetros de consulta
Nome	Descrição
Nenhum(a)

Tabela 27. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 28. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 29. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 30. Códigos de status
Código do status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. Não foi possível encontrar o registro especificado.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
pares nome-valor	Valores para todos os campos na solicitação de mudança associada. Tipo de dados: Objeto
estado	Estado da solicitação de mudança antes da exclusão. Tipo de dados: Objeto `state: { display_value: "String", value: "String" }`
state.display_value	Estado a ser exibido na IU. Tipo de dados: Cadeia de caracteres
state.value	Valor do estado interno. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id da solicitação de mudança. Tipo de dados: Cadeia de caracteres
tipo	Tipo de solicitação de mudança Tipo de dados: Objeto `type: { display_value: "String", value: "String" }`
type.display_value	Altere o tipo a ser exibido na IU. O valor é sempre "Normal". Tipo de dados: Cadeia de caracteres
type.value	Valor do tipo interno. O valor é sempre "Normal". Tipo de dados: Cadeia de caracteres

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/normal/b0dbda5347c12200e0ef563dbb9a718f" \
--request DELETE \
--header "Accept:application/json" \
--user "username":"password"

{
  result: [
    {
      sys_id: "b0dbda5347c12200e0ef563dbb9a718f",
      state: {
        value: "-5", 
        display_value: "New"
      },
      type: {
        value: "normal",
        display_value: "Normal"
      },
      ..., // all valid fields in record, example below
      short_description: {
        value: "Remove server",
        display_value: "Remove server"
      },
    }, 
  ]
}

Gestão de mudanças - EXCLUA /sn_chg_rest/change/standard/

Exclui a solicitação de mudança padrão identificada pelo sys_id especificado.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/standard/ sys_id

URL padrão: /api/sn_chg_rest/change/standard/

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 31. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id da solicitação de mudança padrão a ser excluída. Tipo de dados: Cadeia de caracteres Tabela: solicitação de mudança [change_request]

Tabela 32. Parâmetros de consulta
Nome	Descrição
Nenhum(a)

Tabela 33. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 34. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 35. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 36. Códigos de status
Código do status	Descrição
200	Solicitação concluída com sucesso.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. Não foi possível encontrar o registro especificado.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
pares nome-valor	Todos os campos (chave) com os valores associados à solicitação de mudança identificada.
estado	Estado da solicitação de mudança antes da exclusão. Tipo de dados: Objeto `state: { display_value: "String", value: "String" }`
state.display_value	Estado a ser exibido na IU. Tipo de dados: Cadeia de caracteres
state.value	Valor do estado interno. Tipo de dados: Cadeia de caracteres
sys_id	Identificador exclusivo da solicitação de mudança.

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/standard/1c87925347c12200e0ef563dbb9a7177" \
--request DELETE \
--header "Accept:application/json" \
--user "username":"password"

{
  result: [
    {
      sys_id: "1c87925347c12200e0ef563dbb9a7177",
      state: {
        value: "-5", 
        display_value: "New"
      },
      ..., // all valid fields in record, example below
      short_description: {
        value: "Add network switch to cabinet",
        display_value: "Add network switch to cabinet"
      },
    }, 
  ]
}

Gestão de mudanças - OBTER /sn_chg_rest/change/ci/ cmdb_ci_sys_id/schedule

Permite recuperar intervalos de tempo disponíveis por ID do item de configuração e duração, com uma opção para incluir a hora de início planejada.

Função necessária: sn_change_writer.

Nota:

Executar este endpoint não lista as horas de início e término disponíveis. Use o link fornecido no corpo da resposta worker.linkpropriedade para obter os dados de programação.

Consulte também:

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/ci/ cmdb_ci_sys_id]/schedule

URL padrão: /api/sn_chg_rest/change/ci/cmdb_ci_sys_id]/schedule

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 37. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
cmdb_ci_sys_id	Sys_id do registro do item de configuração. Este endpoint não requer uma solicitação de mudança. Tipo de dados: Cadeia de caracteres Tabela: Itens de configuração [cmdb_ci]

Tabela 38. Parâmetros de consulta
Nome	Descrição
duration_in_seconds	Duração da mudança em segundos, ou seja, quanto tempo é necessário para concluir a tarefa de solicitação de mudança. Tipo de dados: Inteiro
planned_start_time	Opcional. Data e hora em que a solicitação de mudança está planejada para iniciar a implementação em UTC. Recupere o início do intervalo de tempo disponível em ou depois desse horário. Se não for fornecido, o sistema usará a hora atual como a hora de início. Formato: aaaa-MM-dd hh:mm:ss Tipo de dados: Cadeia de caracteres

Tabela 39. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 40. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 41. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 42. Códigos de status
Código do status	Descrição
202	O sistema aceitou a solicitação.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada. Possíveis problemas: Não é possível encontrar cmdb_ci com o sys_id fornecido. O registro não existe ou o usuário não tem acesso de leitura a ele. O valor do parâmetro de consulta duration_in_seconds não foi fornecido. Valor de parâmetro de consulta duration_in_seconds ou planned_start_time inválido fornecido.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
erro	Informações sobre todos os erros encontrados ao processar a solicitação de endpoint. Tipo de dados: Objeto `"error": { "detail": "String", "message": "String", "status": "String" }`
error.detail	Informações adicionais sobre o erro. Tipo de dados: Cadeia de caracteres
mensagem.erro	Mensagem que identifica o erro. Tipo de dados: Cadeia de caracteres
mensagens	Informações da mensagem. Tipo de dados: Objeto `"messages": { "errorMessages": [Array], "infoMessages": [Array], "warningMessages": [Array] }`
Messages.erroMessages	Mensagens de erro encontradas ao processar a solicitação. Tipo de dados: Matriz
messages.infoMessages	Mensagens de informação encontradas durante o processamento da solicitação. Tipo de dados: Matriz
Messages.warningMessages	Mensagens de aviso encontradas durante o processamento da solicitação. Tipo de dados: Matriz
solicitação	Solicitação de endpoint original. Tipo de dados: Cadeia de caracteres
estado	Informações sobre o estado atual do trabalhador. Tipo de dados: Objeto `state: { display_value: "String", value: Number }`
state.display_value	Valor de exibição do estado do trabalhador. Esses valores se correlacionam diretamente ao state.valueparâmetro. Valores possíveis: Concluídas Erro Em progresso Aguardando Tipo de dados: Cadeia de caracteres
state.value	Valor numérico do estado do trabalhador. Valores possíveis: 1 2 3 4 Tipo de dados: Número
tipo	Tipo de solicitação. Valor válido: Programação Tipo de dados: Cadeia de caracteres
trabalhador	Informações sobre o trabalhador associado. Tipo de dados: Objeto `"worker": { "link": "String", "sysId": "String" }`
worker.link	Link para recuperar dados de intervalo de tempo.Use o sys_id em OBTENHA /sn_chg_rest/change/worker/ para exibir os resultados. Tipo de dados: Cadeia de caracteres
Worker.SYSID	Sys_id do trabalhador associado à solicitação de mudança. Tipo de dados: Cadeia de caracteres
status	Aparece somente se um erro for encontrado. Status do processamento do endpoint. Valor possível: Falha Tipo de dados: Cadeia de caracteres

Obtenha intervalos de tempo disponíveis

Use o valor fornecido em worker.linkpara obter detalhes da janela de programação. O valor está no seguinte formato:

https://instance.service-now.com/api/sn_chg_rest/change/worker/<worker_sys_id>

Use worker_sys_id em OBTENHA /sn_chg_rest/change/worker/ para exibir os resultados.

O corpo da resposta contém o status e fornece resultados quando o processamento é concluído.

Os resultados do parâmetro do corpo de resposta do trabalhador variam dependendo da disponibilidade do intervalo de tempo.

Se o intervalo de tempo fornecido estiver disponível para a solicitação de mudança no intervalo de tempo programado, a API do trabalhador listará os intervalos de tempo disponíveis no payload.spans propriedade. . payload.spans caso contrário, a propriedade não está listada nos resultados.
Se não houver intervalos de tempo disponíveis para a duração da solicitação de mudança fornecida no intervalo de tempo de programação definido, o. messages.infoMessages declara o seguinte: D
Nota:
O valor padrão do intervalo de tempo de programação de solicitação de mudança é 90 dias. Para mudar este valor, modifique o. change.conflict.next_available.schedule_windowpropriedade. Para obter mais informações, consulte Configure propriedades de análise de conflito .

A seguir OBTENHA /sn_chg_rest/change/worker/ O exemplo mostra a saída fornecida usando o ID fornecido no detalhe worker.link. Os resultados listam períodos de tempo em aberto disponíveis para a duração da tarefa.

{
  "result": {
    "worker": {
      "sysId": "d7d1f2b4a444b010f87712198fe9caae",
      "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/d7d1f2b4a444b010f87712198fe9caae"
    },
    "request": "{\"cmdb_ci_sys_id\":\"82967cdd0ad3370236092104ce988d76\",\"planned_start_time\":\"\",\"duration_in_seconds\":10800,\"timezone\":\"America/Los_Angeles\"}",
    "state": {
      "value": 3,
      "display_value": "Complete"
    },
    "type": "schedule",
    "messages": {
      "errorMessages": [],
      "warningMessages": [],
      "infoMessages": []
    },
    "payload": {
      "spans": [
        {
          "start": {
            "value": "2021-05-15 08:00:00",
            "display_value": "2021-05-15 01:00:00"
          },
          "end": {
            "value": "2021-05-15 11:00:00",
            "display_value": "2021-05-15 04:00:00"
          }
        },
        {
          "start": {
            "value": "2021-05-22 08:00:00",
            "display_value": "2021-05-22 01:00:00"
          },
          "end": {
            "value": "2021-05-22 11:00:00",
            "display_value": "2021-05-22 04:00:00"
          }
        },
        ...
      ]
    }
  }
}

Solicitação de curl

curl "https://instance.service-now.com/api/sn_chg_rest/change/ci/<cmdb_ci_sys_id>/schedule?duration_in_seconds=10800" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

Os resultados incluem detalhes worker.link que você pode usar para executar o sys_id fornecido no endpoint GET /sn_chg_rest/change/worker/.

{
  "result": {
    "worker": {
      "sysId": "1049419c1b4c3010f58a6572604bcb7a",
      "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/1049419c1b4c3010f58a6572604bcb7a"
    },
    "request": "{\"cmdb_ci_sys_id\":\"<cmdb_ci_sys_id>\",\"planned_start_time\":\"\",\"duration_in_seconds\":10800,\"timezone\":\"America/Los_Angeles\"}",
    "state": {
      "value": 1,
      "display_value": "Waiting"
    },
    "type": "schedule",
    "messages": {
      "errorMessages": [],
      "warningMessages": [],
      "infoMessages": []
    }
  }
}

Gestão de mudanças - OBTENHA /sn_chg_rest/change

Recupera uma ou mais solicitações de mudança com base nos critérios especificados.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change

URL padrão: /api/sn_chg_rest/change

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 43. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres

Tabela 44. Parâmetros de consulta
Nome	Descrição
pares nome-valor	Pares nome-valor a serem usados para filtrar o conjunto de resultados. O nome é o campo no qual o valor especificado é filtrado. Este parâmetro é mutuamente exclusivo com sysparm_query. Por exemplo, em vez de usar `"sysparm_query` , você pode simplificar a declaração de chamada usando `verdadeiro` . Você também pode usar o valor de exibição quando o campo for um campo de escolha ou de tipo de referência, como `&state: encerrado` em vez de `&estado: 7` . Para especificar vários pares de chave-valor, separe cada um com um e comercial, como `"true&assigned_to""john.smith"` . Tipo de dados: Cadeia de caracteres
pedido	Campo pelo qual classificar as solicitações de mudança retornadas. Tipo de dados: Cadeia de caracteres Padrão: `nome`
sysparm_offset	Índice de registro inicial para o qual começar a recuperar registros. Use este valor para paginar a recuperação de registro. Esta funcionalidade permite a recuperação de todos os registros, independentemente do número de registros, em pequenos blocos gerenciáveis. Por exemplo, na primeira vez que você chamar este endpoint, sysparm_offsetdefinido como "0". Para simplesmente percorrer todos os registros disponíveis, use `se você não tiver certeza de que você está usando o sysparm_offset` até chegar ao final de todos os registros. Não passe um número negativo em sysparm_offsetparâmetro. Tipo de dados: Número Padrão: 0
sysparm_query	Consulta codificada usado para filtrar o conjunto de resultados. Você pode usar um filtro de IU para obter uma consulta codificada corretamente. Sintaxe: `sysparm_query_query_<col_name> <operator> <value>` . <col_name>: Nome da coluna da tabela a ser filtrada. Compatível com os seguintes valores <operator>: Corresponde exatamente ao <value>. Não corresponde ao <value>. Declarações de consulta lógica E múltipla. OU: Declarações de consulta lógica OU múltipla. CURTIR: O <col_name> contém a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. STARTSWITH: O <col_name> começa com a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. ENDSWITH: O <col_name> termina com a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. <value>: Valor a ser correspondido. Para obter mais operadores, consulte Operators available for filters and queries. Todos os parâmetros diferenciam maiúsculas de minúsculas. As consultas podem conter mais de uma entrada, como `sysparm_query_<col_name> <operator> <value>[<operator> <col_name> <operator> <value>]` . Por exemplo: `(Sysparm_query_caller_id_id_javascript:gs.getUserID() "ative_true")` As consultas codificadas também são compatíveis com a funcionalidade Ordem por. Para classificar respostas com base em determinados campos, use `ORDERBY` e. `ORDERBYDESC` cláusulas em sysparm_query. Sintaxe: `ORDERBY<col_name>` `ORDERBYDESC<col_name>` Por exemplo: `SYsparm_query` Esta consulta filtra todos os registros ativos e ordena os resultados em ordem crescente por número e, em seguida, em ordem decrescente por categoria. Se parte da consulta for inválida, como especificar um nome de campo inválido, a instância ignorará a parte inválida. Em seguida, ele retorna linhas usando somente a parte válida da consulta. Você pode controlar esse comportamento usando a propriedade glide.invalid_query.returns_no_rows. Defina esta propriedade como verdadeira para não retornar linhas em uma consulta inválida. Nota: . glide.invalid_query.returns_no_rowsa propriedade controla o comportamento de todas as consultas na instância, como em listas, scripts ( GlideRecord.query() E APIs de serviço web. Tipo de dados: Cadeia de caracteres
TextSearch	Cadeia de caracteres a ser usada para pesquisar todos os campos de registro de solicitação de mudança normal. Esta pesquisa usa ServiceNow funcionalidade da plataforma de pesquisa de texto completo. Para obter mais informações sobre ServiceNow recursos de pesquisa, consulte Administração de pesquisa . Padrão: `IR_AND_OR_QUERY`

Tabela 45. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 46. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 47. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 48. Códigos de status
Código do status	Descrição
200	Solicitação concluída com sucesso.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Elemento	Descrição
resultado	Lista que contém um ou mais objetos de registro de solicitação de mudança. Cada objeto descreve uma solicitação de mudança. Cada elemento no objeto de solicitação de mudança corresponde a um campo em seu registro associado na tabela Solicitação de mudança [change_request]. Todos os elementos contêm valor e. display_value pares nome-valor. Os campos de data também contêm display_value_internal pares nome-valor. Tipo de dados: Matriz
action_status	Status da ação atual da solicitação de mudança associada. Valores possíveis: 1: Bloqueado internamente 2: Bloqueado pelo cliente 3: Bloqueado internamente e pelo cliente 4: Precisa de atenção Tipo de dados: Número
ativo	Sinalizador que indica se a solicitação de mudança está ativa. Valores possíveis: Verdadeiro: A solicitação de mudança está ativa Falso: A solicitação de mudança não está ativa Tipo de dados: Booliano Padrão: verdadeiro
activity_due	Data e hora em que o caso associado deve ser concluído. Tipo de dados: Cadeia de caracteres
additional_assignee_list	Lista de sys_ids de pessoas adicionais atribuídas para trabalhar na solicitação de mudança. Tipo de dados: Matriz
aprovação	Tipo de processo de aprovação necessário. Tipo de dados: Cadeia de caracteres Padrão: Não solicitado
approval_history	Entrada de registro do histórico de aprovação mais recente. Tipo de dados: Cadeia de caracteres
approval_set	Data e hora em que a ação associada foi aprovada. Tipo de dados: Cadeia de caracteres
assigned_to	Sys_id do usuário atribuído à solicitação de mudança. Tipo de dados: Cadeia de caracteres
assignment_group	Sys_id do grupo atribuído à solicitação de mudança. Tipo de dados: Cadeia de caracteres
backout_plan	Descrição do plano a ser executado se a mudança precisar ser revertida. Tipo de dados: Cadeia de caracteres
business_duration	Tempo em horas de trabalho programadas, dias úteis e semanas de trabalho que levou para concluir a mudança. Tipo de dados: Cadeia de caracteres
business_service	Sys_id do serviço de negócios associado à solicitação de mudança. Localizado na tabela Serviço [cmdb_ci_service]. Tipo de dados: Cadeia de caracteres
cab_date	Data em que o Comitê Consultivo de Mudança (CCM) se reúne. Tipo de dados: Cadeia de caracteres
cab_delegate	Sys_id do usuário que pode substituir o gerente DO CCM durante uma reunião DO CCM. Localizado na tabela Usuário [sys_user] Tipo de dados: Cadeia de caracteres
ccm_recommendation	Descrição das recomendações DO CCM para a solicitação de mudança. Tipo de dados: Cadeia de caracteres Comprimento máximo: 4 000
cab_obrigatório	Sinalizador que indica se o CCM é necessário. Valores possíveis: Verdadeiro: O Comitê consultivo de mudanças é obrigatório. Change Advisory Board não é necessário. Tipo de dados: Booliano Padrão: falso
calendar_duration	Atualmente não usado por Gestão de mudanças. Tipo de dados: Cadeia de caracteres
categoria	Categoria da mudança, por exemplo, hardware, rede ou software. Tipo de dados: Cadeia de caracteres Padrão: Outro
change_plan	Atividades e funções para gerenciar e controlar a solicitação de mudança. Tipo de dados: Cadeia de caracteres
chg_model	Sys_id do modelo de mudança no qual a solicitação de mudança associada se baseou. O Modelo de Mudança define o fluxo de estado, as transições e as atividades de processo que devem ser concluídas para a solicitação de mudança. Tipo de dados: Cadeia de caracteres Tabela: Modelo de mudança [chg_model]
closed_at	Data e hora em que a solicitação de mudança associada foi encerrada. Tipo de dados: Cadeia de caracteres
closed_by	Sys_id da pessoa que fechou a solicitação de mudança. Tipo de dados: Cadeia de caracteres Tabela: Usuário [sys_user]
close_code	Código atribuído à solicitação de mudança quando ela foi fechada. Por exemplo, Bem-sucedido, Bem-sucedido com problemas e malsucedido. Tipo de dados: Cadeia de caracteres
close_notes	Observa que a pessoa inseriu ao fechar a solicitação de mudança. Tipo de dados: Cadeia de caracteres
cmdb_ci	Sys_id do item de configuração associado à solicitação de mudança. Tipo de dados: Cadeia de caracteres Tabela: Item de configuração [cmdb_ci]
comentários	Lista de anotações de trabalho voltadas para o cliente inseridas na solicitação de mudança associada. Tipo de dados: Matriz
comments_and_work_notes	Lista de anotações de trabalho internas e voltadas para o cliente inseridas para a solicitação de mudança associada. Tipo de dados: Matriz Comprimento máximo: 4 000
empresa	Sys_id da empresa associada à solicitação de mudança. Tipo de dados: Cadeia de caracteres Tabela: Empresa [core_company]
conflict_last_run	Data e hora em que o script de detecção de conflito foi executado pela última vez na solicitação de mudança. Tipo de dados: Cadeia de caracteres
conflict_status	Status de conflito atual conforme detectado pelo script de detecção de conflito, como Conflito e Não executado. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 Padrão: Não executado
contact_type	Método no qual a solicitação de mudança foi solicitada inicialmente. Valores possíveis: bate-papo e-mail telefone social web Tipo de dados: Cadeia de caracteres
contrato	Sys_id do contrato associado à solicitação de mudança. Tipo de dados: Cadeia de caracteres Tabela: Contrato [ast_contract]
correlation_display	Nome amigável para correlation_id. Tipo de dados: Cadeia de caracteres Comprimento máximo: 100
correlation_id	GUID (globalmente exclusivo) de um registro de solicitação de mudança correspondente em um sistema de terceiros. Tipo de dados: Cadeia de caracteres Comprimento máximo: 100
delivery_plan	Não está mais em uso. Sys_id do plano de entrega associado à solicitação de mudança. Tipo de dados: Cadeia de caracteres Tabela: Plano de execução [sc_cat_item_delivery_plan]
delivery_task	Não está mais em uso. Sys_id da tarefa de entrega associada à solicitação de mudança. Tipo de dados: Cadeia de caracteres Tabela: Tarefa do plano de execução [sc_cat_item_delivery_task]
descrição	Descrição detalhada da solicitação de mudança. Tipo de dados: Cadeia de caracteres Comprimento máximo: 4 000
due_date	Prazo da tarefa. Não usado pelo processo de solicitação de mudança. Tipo de dados: Cadeia de caracteres
end_date	Data e hora em que a solicitação de mudança deve ser concluída. Tipo de dados: Cadeia de caracteres
escalação	Nível de escalação atual. Valores possíveis: 0: Normal 1: Moderado 2: Alto 3: Atrasado Tipo de dados: Número (inteiro) Padrão: 0
expected_start	Data e hora em que a tarefa deve começar. Não usado pelo processo de solicitação de mudança. Tipo de dados: Cadeia de caracteres
follow_up	Data e hora em que um usuário fez acompanhamento com a pessoa que solicitou a solicitação de mudança. Tipo de dados: Cadeia de caracteres
group_list	Lista de sys_ids e nomes dos grupos associados à solicitação de mudança. Tipo de dados: Matriz Comprimento máximo: 4 000
impacto	O impacto na solicitação de mudança terá no cliente. Valores possíveis: 1: Alto 2: Médio 3: Baixo Tipo de dados: Número (inteiro) Padrão: 3
implementation_plan	Etapas sequenciais a serem executadas para implementar esta mudança. Ele também contém dependências entre as etapas e os detalhes do designado para cada etapa. Tipo de dados: Cadeia de caracteres Comprimento máximo: 4 000
justificativa	Benefícios de implementar esta mudança e o impacto se esta mudança não for implementada. Tipo de dados: Cadeia de caracteres Comprimento máximo: 4 000
conhecimento	Sinalizador que indica se há artigos de base de conhecimento ()KB) associados à solicitação de mudança. Valores possíveis: Verdadeiro: Artigos da base de conhecimento associados Falso: Nenhum artigo da base de conhecimento associado Tipo de dados: Booliano
local	Sys_id e nome do local do equipamento referenciado na solicitação de mudança. Tipo de dados: Cadeia de caracteres Tabela: Local [cmn_location]
made_sla	Não mais usado. Sinalizador que indica se a solicitação de mudança foi implementada em alinhamento com o acordo de nível de serviço associado. Tipo de dados: Booliano
needs_attention	Sinalizador que indica se a solicitação de mudança precisa de atenção. Valores possíveis: Verdadeiro: A solicitação de mudança precisa de atenção adicional. Falso: A solicitação de mudança não precisa de atenção adicional. Tipo de dados: Booliano Padrão: falso
número	Número de mudança atribuído à solicitação de mudança pelo sistema, como CHG0040007. Tipo de dados: Cadeia de caracteres
em_espera	Sinalizador que indica se a solicitação de mudança está em espera no momento. Valores possíveis: Verdadeiro: Em espera Falso: Não está em espera Tipo de dados: Booliano Padrão: falso
on_hold_reason	. on_holdo parâmetro é "verdadeiro", descrição do motivo pelo qual a solicitação de mudança está sendo retida. Tipo de dados: Cadeia de caracteres Comprimento máximo: 4 000
_hold_task	. on_holdo parâmetro é "verdadeiro", lista dos sys_ids das tarefas que devem ser concluídas antes que a espera seja liberada. Tipo de dados: Cadeia de caracteres Comprimento máximo: 4 000
opened_at	Data e hora em que a versão da mudança foi criada. Tipo de dados: Cadeia de caracteres
opened_by	Sys_id e nome do usuário que criou a versão de mudança. Tipo de dados: Cadeia de caracteres Tabela: Usuário [sys_user]
pedido	Não usado por Gestão de mudanças. Campo numérico opcional pelo qual solicitar registros, como ao recuperá-los de um banco de dados. Tipo de dados: Número (inteiro)
outside_maintenance_schedule	Sinalizador que indica se a manutenção por uma empresa externa foi programada para a solicitação de mudança. Valores possíveis: Verdadeiro: Manutenção externa programada Falso: Nenhuma manutenção externa programada Tipo de dados: Booliano Padrão: falso
primário	Sys_id e nome da tarefa primária para esta solicitação de mudança, se houver. Tipo de dados: Cadeia de caracteres Tabela: Tarefa [task]
fase	Fase atual da solicitação de mudança. Isso define o que a mudança está fazendo com mais detalhes. Valores possíveis: aceitar compilação plano solicitado Tipo de dados: Cadeia de caracteres
phase_state	Registros change_phase que devem ser criados para uma mudança. Eles dependem da categoria, de modo que cada tipo de mudança pode ter registros change_phase diferentes. Os registros change_phase fornecem uma oportunidade para controlar o processo de aprovação, pois cada change_phase pode ter uma programação e um conjunto de aprovadores. Valores possíveis: concluir em espera em aberto rejeitado solicitado trabalho em andamento Tipo de dados: Cadeia de caracteres
prioridade	Prioridade da solicitação de mudança. Valores possíveis: 1: Crítico 2: Alto 3: Moderado 4: Baixo Tipo de dados: Número (inteiro) Padrão: 4
production_system	Sinalizador que indica se a solicitação de mudança é para um ServiceNow instância que está em um ambiente de produção. Valores possíveis: Verdadeiro: Ambiente de produção Falso: Ambiente de não produção Tipo de dados: Booliano
motivo	Descrição do motivo pelo qual a solicitação de mudança foi iniciada. Valores possíveis: Requisitos de negócios Upgrade de hardware Legislação Mudança de local Requisitos de rede IC novo ou removido Outro Problema resolvido Produto ou serviço alterado Upgrade de software Solicitado pelo usuário Tipo de dados: Cadeia de caracteres Comprimento máximo: 40
reassignment_count	Número de vezes que a solicitação de mudança foi reatribuída a um novo proprietário. Tipo de dados: Número (inteiro) Padrão: 0
rejection_goto	Sys_id da tarefa a ser executada se a solicitação de mudança for rejeitada. Tipo de dados: Cadeia de caracteres Tabela: Tarefa [task]
requested_by	Sys_id do usuário que solicitou a mudança. Tipo de dados: Cadeia de caracteres Tabela: Usuário [sys_user]
requested_by_date	Data e hora em que a mudança é solicitada para ser implementada por. Tipo de dados: Cadeia de caracteres
review_comments	Comentários inseridos quando a solicitação de mudança foi revisada. Tipo de dados: Cadeia de caracteres Comprimento máximo: 4 000
review_date	Data em que a solicitação de mudança foi revisada. Tipo de dados: Cadeia de caracteres
review_status	Status atual da revisão da solicitação de mudança solicitada. Tipo de dados: Cadeia de caracteres
risco	Nível de risco associado à solicitação de mudança. Valores válidos: 1: Alto 2: Moderado 3: Baixo Tipo de dados: Número Padrão: 3
risk_impact_analysis	Descrição do risco e análise da implementação da solicitação de mudança. Tipo de dados: Cadeia de caracteres Comprimento máximo: 4 000
route_reason	Atualmente não usado por Gestão de mudanças. Motivo pelo qual a solicitação de mudança foi transferida. Valores possíveis: 1: Transferir com resolução 9: Transferência sem resoluções Tipo de dados: Número
scope	Tamanho da solicitação de mudança. Valores possíveis: 1: Massivo 2: Grande 3: Médio 4: Pequeno 5: Tiny Tipo de dados: Número Padrão: 3
service_offering	Sys_id da oferta de serviço associada à solicitação de mudança. As ofertas de serviço definem exclusivamente o nível de serviço em termos de disponibilidade, escopo, preço e opções de pacote. Tipo de dados: Cadeia de caracteres Tabela: Oferta [service_offering]
short_description	Descrição da solicitação de mudança. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40
habilidades	Lista de sys_ids de todas as habilidades necessárias para implementar a solicitação de mudança. Tipo de dados: Matriz Tabela: Habilidade [cmn_skill]
ans_due	Não está mais em uso. Data e hora em que a solicitação de mudança deve ser concluída com base no acordo de nível de serviço associado. Tipo de dados: Cadeia de caracteres
sn_esign_document	Sys_id de qualquer documento assinado eletronicamente anexado à solicitação de mudança. Tipo de dados: Cadeia de caracteres Tabela: Anexo [sys_attachment]
sn_esign_esignature_configuration	Sys_id do modelo de assinatura eletrônica usado para o documento associado. Tipo de dados: Cadeia de caracteres Tabela: Modelo de assinatura eletrônica [sn_esign_configuration]
start_date	Data e hora em que a solicitação de mudança está planejada para iniciar a implementação. Tipo de dados: Cadeia de caracteres
estado	Estado atual da solicitação de mudança. Os valores possíveis são definidos no modelo de mudança. Tipo de dados: Número (inteiro) Padrão: 1
std_change_producer_version	Sys_id do produtor de registro e da proposta de mudança associada à solicitação de mudança. Ele também inclui o número e a porcentagem de solicitações de mudança bem-sucedidas e malsucedidas criadas a partir da proposta. Tipo de dados: Cadeia de caracteres Tabela: Versão do modelo de mudança padrão [std_change_producer_version]
sys_class_name	Nome da tabela na qual a solicitação de mudança está localizada. Tipo de dados: Cadeia de caracteres
sys_created_by	Nome do usuário que criou inicialmente a solicitação de mudança. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40
sys_created_on	Data e hora em que o registro de solicitação de mudança associado foi criado originalmente. Tipo de dados: Cadeia de caracteres
sys_domain	Se estiver usando domínios na instância, o nome do domínio ao qual o registro do módulo de mudança está associado. Tipo de dados: Cadeia de caracteres
sys_domain_path	Se estiver usando domínios na instância, o caminho do domínio no qual o registro do módulo de mudança associado reside. Tipo de dados: Cadeia de caracteres
sys_id	Identificador exclusivo do registro de solicitação de mudança associado. Tipo de dados: Cadeia de caracteres
sys_mod_count	Número de atualizações do caso desde que ele foi criado inicialmente. Tipo de dados: Número (inteiro)
sys_updated_by	Pessoa que atualizou o caso pela última vez. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40
sys_updated_on	Data e hora em que o caso foi atualizado pela última vez. Tipo de dados: Cadeia de caracteres
task_effective_number	Número da Solicitação universal. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40
task_for	Não usado por Gestão de mudanças. Sys_id do usuário para o qual a tarefa foi criada. Tipo de dados: Cadeia de caracteres Tabela: Usuário [sys_user]
test_plan	Descrição do plano de teste associado à mudança. Tipo de dados: Cadeia de caracteres Comprimento máximo: 4 000
time_worked	Quantidade total de tempo trabalhado na solicitação de mudança. Tipo de dados: Cadeia de caracteres
tipo	Tipo de solicitação de mudança. Valores possíveis: emergência normal padrão Tipo de dados: Cadeia de caracteres Comprimento máximo: 40
não autorizado	Sinalizador que indica se a solicitação de mudança não é autorizada Valores possíveis: Verdadeiro: Não autorizado Falso: Autorizado Tipo de dados: Booliano
universal_request	Sys_id da Solicitação universal primária da qual esta solicitação de mudança faz parte. Tipo de dados: Cadeia de caracteres Tabela: Tarefa [task]
approval	Ação a ser realizada se a solicitação de mudança for aprovada. Valores possíveis: do_nothing prosseguir Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 Padrão: Prosseguir
upon_reject	Ação a ser realizada se a solicitação de mudança for rejeitada. Valores possíveis: cancelar goto Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 Padrão: Cancelar
urgência	Urgência da solicitação de mudança. Valores possíveis: 1: Alto 2: Médio 3: Baixo Tipo de dados: Número (inteiro) Padrão: 3
user_input	Entrada adicional do usuário. Tipo de dados: Cadeia de caracteres Comprimento máximo: 4 000
variáveis	Pares nome-valor de variáveis associadas à solicitação de mudança. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40
watch_list	Lista de sys_ids dos usuários que recebem notificações sobre esta solicitação de mudança quando comentários adicionais são adicionados ou se o estado de uma solicitação de mudança é alterado para Resolvido ou Encerrado. Tipo de dados: Matriz Tabela: Usuário [sys_user]
wf_activity	Sys_id do registro de atividade de fluxo de trabalho associado à solicitação de mudança. Tipo de dados: Cadeia de caracteres Tabela: Atividade de fluxo de trabalho [wf_activity]
work_end	Data e hora em que o trabalho terminou na solicitação de mudança. Tipo de dados: Cadeia de caracteres
work_notes	Informações sobre como resolver a solicitação de mudança ou as etapas executadas para resolvê-la. Tipo de dados: Cadeia de caracteres Comprimento máximo: 4 000
work_notes_list	Lista de sys_ids dos usuários internos que recebem notificações sobre esta solicitação de mudança quando anotações de trabalho são adicionadas. Tipo de dados: Matriz Tabela: Usuário [sys_user]
work_start	Data e hora em que o trabalho começou na solicitação de mudança. Tipo de dados: Cadeia de caracteres

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change?sysparm_query=active=true^ORDERBYnumber" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

Para brevidade, os resultados contêm apenas um único registro de solicitação de mudança.

{
  "result": [
    {
      "reason": {
        "display_value": "",
        "value": ""
      },
      "parent": {
        "display_value": "",
        "value": ""
      },
      "watch_list": {
        "display_value": "",
        "value": ""
       },
       "proposed_change": {
         "display_value": "",
         "value": ""
       },
       "upon_reject": {
         "display_value": "Cancel all future Tasks",
         "value": "cancel"
       },
       "sys_updated_on": {
         "display_value": "2015-07-06 11:59:27",
         "value": "2015-07-06 18:59:27",
         "display_value_internal": "2015-07-06 11:59:27"
      },
      "type": {
        "display_value": "Standard",
        "value": "standard"
      },
      "approval_history": {
        "display_value": "",
        "value": ""
      },
      "skills": {
        "display_value": "",
        "value": ""
      },
      "test_plan": {
        "display_value": "--Confirm that there are no monitoring alerts for the router",
        "value": "--Confirm that there are no monitoring alerts for the router"
      },
      "number": {
        "display_value": "CHG0000024",
        "value": "CHG0000024"
      },
      "is_bulk": {
        "display_value": "false",
        "value": false
      },
      "cab_delegate": {
        "display_value": "",
        "value": ""
      },
      "requested_by_date": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "ci_class": {
        "display_value": "cmdb_ci",
        "value": "cmdb_ci"
      },
      "state": {
        "display_value": "Closed",
        "value": 3.0
      },
      "sys_created_by": {
        "display_value": "admin",
        "value": "admin"
      },
      "knowledge": {
        "display_value": "false",
        "value": false
      },
      "order": {
        "display_value": "",
        "value": ""
      },
      "phase": {
        "display_value": "Requested",
        "value": "requested"
      },
      "cmdb_ci": {
        "display_value": "",
        "value": ""
      },
      "delivery_plan": {
        "display_value": "",
        "value": ""
      },
      "impact": {
        "display_value": "3 - Low",
        "value": 3.0
      },
      "contract": {
        "display_value": "",
        "value": ""
      },
      "active": {
        "display_value": "false",
        "value": false
      },
      "work_notes_list": {
        "display_value": "",
        "value": ""
      },
      "priority": {
        "display_value": "4 - Low",
        "value": 4.0
      },
      "sys_domain_path": {
        "display_value": "/",
        "value": "/"
      },
      "cab_recommendation": {
        "display_value": "",
        "value": ""
      },
      "production_system": {
        "display_value": "false",
        "value": false
      },
      "rejection_goto": {
        "display_value": "",
        "value": ""
      },
      "review_date": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "requested_by": {
        "display_value": "System Administrator",
        "value": "6816f79cc0a8016401c5a33be04be441"
      },
      "business_duration": {
        "display_value": "",
        "value": ""
      },
      "group_list": {
        "display_value": "",
        "value": ""
      },
      "change_plan": {
        "display_value": "",
        "value": ""
      },
      "approval_set": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "wf_activity": {
        "display_value": "",
        "value": ""
      },
      "implementation_plan": {
        "display_value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform",
        "value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform"
      },
      "universal_request": {
        "display_value": "",
        "value": ""
      },
      "end_date": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "short_description": {
        "display_value": "Clear BGP sessions on a Cisco router",
        "value": "Clear BGP sessions on a Cisco router"
      },
      "correlation_display": {
        "display_value": "",
        "value": ""
      },
      "work_start": {
        "display_value": "2015-07-06 11:56:04",
        "value": "2015-07-06 18:56:04",
        "display_value_internal": "2015-07-06 11:56:04"
      },
      "delivery_task": {
        "display_value": "",
        "value": ""
      },
      "outside_maintenance_schedule": {
        "display_value": "false",
        "value": false
      },
      "additional_assignee_list": {
        "display_value": "",
        "value": ""
      },
      "std_change_producer_version": {
        "display_value": "Clear BGP sessions on a Cisco router - 1",
        "value": "16c2273c47010200e90d87e8dee49006"
      },
      "sys_class_name": {
        "display_value": "Change Request",
        "value": "change_request"
      },
      "service_offering": {
        "display_value": "",
        "value": ""
      },
      "closed_by": {
        "display_value": "System Administrator",
        "value": "6816f79cc0a8016401c5a33be04be441"
      },
      "follow_up": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "review_status": {
        "display_value": "",
        "value": ""
      },
      "reassignment_count": {
        "display_value": "2",
        "value": 2.0
      },
      "start_date": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "assigned_to": {
        "display_value": "",
        "value": ""
      },
      "variables": {
        "display_value": "variable_pool",
        "value": "variable_pool"
      },
      "sla_due": {
        "display_value": "UNKNOWN",
        "value": "",
        "display_value_internal": ""
      },
      "comments_and_work_notes": {
        "display_value": "",
        "value": ""
      },
      "escalation": {
        "display_value": "Normal",
        "value": 0.0
      },
      "upon_approval": {
        "display_value": "Proceed to Next Task",
        "value": "proceed"
      },
      "correlation_id": {
        "display_value": "",
        "value": ""
      },
      "made_sla": {
        "display_value": "true",
        "value": true
      },
      "backout_plan": {
        "display_value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work",
        "value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work"
      },
      "conflict_status": {
        "display_value": "Not Run",
        "value": "Not Run"
      },
      "task_effective_number": {
        "display_value": "CHG0000024",
        "value": "CHG0000024"
      },
      "sys_updated_by": {
        "display_value": "admin",
        "value": "admin"
      },
      "opened_by": {
        "display_value": "System Administrator",
        "value": "6816f79cc0a8016401c5a33be04be441"
      },
      "user_input": {
        "display_value": "",
        "value": ""
      },
      "sys_created_on": {
        "display_value": "2015-07-06 11:55:46",
        "value": "2015-07-06 18:55:46",
        "display_value_internal": "2015-07-06 11:55:46"
      },
      "on_hold_task": {
        "display_value": "",
        "value": ""
      },
      "sys_domain": {
        "display_value": "global",
        "value": "global"
      },
      "route_reason": {
        "display_value": "",
        "value": ""
      },
      "closed_at": {
        "display_value": "2015-07-06 11:56:23",
        "value": "2015-07-06 18:56:23",
        "display_value_internal": "2015-07-06 11:56:23"
      },
      "review_comments": {
        "display_value": "",
        "value": ""
      },
      "business_service": {
        "display_value": "",
        "value": ""
      },
      "time_worked": {
        "display_value": "",
        "value": ""
      },
      "chg_model": {
        "display_value": "",
        "value": ""
      },
      "expected_start": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "opened_at": {
        "display_value": "2015-06-09 11:55:46",
        "value": "2015-06-09 18:55:46",
        "display_value_internal": "2015-06-09 11:55:46"
      },
      "work_end": {
        "display_value": "2015-07-06 11:56:10",
        "value": "2015-07-06 18:56:10",
        "display_value_internal": "2015-07-06 11:56:10"
      },
      "phase_state": {
        "display_value": "Open",
        "value": "open"
      },
      "cab_date": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "work_notes": {
        "display_value": "",
        "value": ""
      },
      "close_code": {
        "display_value": "Successful",
        "value": "successful"
      },
      "assignment_group": {
        "display_value": "Network",
        "value": "287ebd7da9fe198100f92cc8d1d2154e"
      },
      "description": {
        "display_value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n",
        "value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n"
      },
      "on_hold_reason": {
        "display_value": "",
        "value": ""
      },
      "calendar_duration": {
        "display_value": "",
        "value": ""
      },
      "close_notes": {
        "display_value": "Completed without issues",
        "value": "Completed without issues"
      },
      "sys_id": {
        "display_value": "1766f1de47410200e90d87e8dee490f6",
        "value": "1766f1de47410200e90d87e8dee490f6"
      },
      "contact_type": {
        "display_value": "Phone",
        "value": "phone"
      },
      "cab_required": {
        "display_value": "false",
        "value": false
      },
      "urgency": {
        "display_value": "3 - Low",
        "value": 3.0
      },
      "scope": {
        "display_value": "Medium",
        "value": 3.0
      },
      "company": {
        "display_value": "",
        "value": ""
      },
      "justification": {
        "display_value": "",
        "value": ""
      },
      "activity_due": {
        "display_value": "UNKNOWN",
        "value": "",
        "display_value_internal": ""
      },
      "comments": {
        "display_value": "",
        "value": ""
      },
      "approval": {
        "display_value": "Approved",
        "value": "approved"
      },
      "due_date": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "sys_mod_count": {
        "display_value": "10",
        "value": 10.0
      },
      "on_hold": {
        "display_value": "false",
        "value": false
      },
      "sys_tags": {
        "display_value": "",
        "value": ""
      },
      "conflict_last_run": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "risk_value": {
        "display_value": "",
        "value": ""
      },
      "unauthorized": {
        "display_value": "false",
        "value": false
      },
      "risk": {
        "display_value": "Moderate",
        "value": 3.0
      },
      "location": {
        "display_value": "",
        "value": ""
      },
      "category": {
        "display_value": "Other",
        "value": "Other"
      },
      "risk_impact_analysis": {
        "display_value": "",
        "value": ""
      }
    }
  ]
}

Gestão de mudanças - OBTER /sn_chg_rest/change/

Recupera uma lista de estados disponíveis para a solicitação de mudança especificada, incluindo o estado atual.

Se disponível, ele também fornece como fazer a transição para o próximo estado com base na versão da Gestão de mudanças implementada. Se as mudanças forem orientadas pelo modelo de mudança, o endpoint retornará condições que foram aprovadas ou não. Ele também fornece informações sobre se todas as condições foram aprovadas para uma determinada transição. Essas informações não estão disponíveis para solicitações de mudança orientadas por tipo e legadas.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change//change/change_sys_id/nextstates

URL padrão: /api/sn_chg_rest/change/

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 49. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
change_sys_id	Sys_id da solicitação de mudança. Tipo de dados: Cadeia de caracteres Tabela: solicitação de mudança [change_request]

Tabela 50. Parâmetros de consulta
Nome	Descrição
Nenhum(a)

Tabela 51. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 52. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 53. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 54. Códigos de status
Código do status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
404	Não encontrado. O item solicitado não foi encontrado.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
available_states	Valores para os estados que estão disponíveis para a solicitação de mudança especificada, incluindo o estado atual. Tipo de dados: Matriz
state_label	Pares de chave-valor que associam rótulos aos estados disponíveis. Tipo de dados: Objeto
state_transitions	Informações sobre o que é necessário para fazer a transição para cada estado disponível. Cada distinto "estado para estado" disponível é próprio Matriz com cada conjunto diferente de condições para que o estado esteja em seu próprio objeto. Tipo de dados: Matriz `"state_transitions": [ { "automatic_transition": Boolean, "conditions": [Array], "display_value": "String", "from_state": "String", "sys_id": "String", "to_state": "String", "transition_available": Boolean } ]`
state_transitions.automatic_transition	Sinalizador que indica se a transição para este estado deve ser feita automaticamente. Valores válidos: Verdadeiro: A solicitação de mudança muda automaticamente para este estado. Falso: A solicitação de mudança não faz a transição automaticamente para este estado. Tipo de dados: Booliano
state_transitions.conditions	Lista de condições associadas ao estado . Tipo de dados: Matriz de objetos `"conditions": [ { "condition": {Object}, "passed": Boolean } ]`
state_transitions.conditions.condition	Valores de uma condição específica. Tipo de dados: Objeto `"condition": { "description": "String", "name": "String", "sys_id": "String" }`
state_transitions.conditions.condition.description	Descrição da condição. Tipo de dados: Cadeia de caracteres
state_transitions.conditions.condition.name	Nome da condição. Tipo de dados: Cadeia de caracteres
state_transitions.conditions.condition.sys_id	Sys_id da condição. Tipo de dados: Cadeia de caracteres
state_transitions.conditions.passed	Sinalizador que indica se a solicitação de mudança atendeu à condição associada. Valores válidos: Verdadeiro: Atendeu à condição. Falso: Não atendeu à condição.
state_transitions.display_value	Descrição exibida do estado. Tipo de dados: Cadeia de caracteres
state_transitions.from_state	Valor do estado do qual a solicitação de mudança está em transição. Tipo de dados: Cadeia de caracteres
state_transitions.sys_id	Sys_id do estado de transição. Tipo de dados: Cadeia de caracteres
state_transitions.to_state	Valor do estado para o qual a solicitação de mudança está em transição. Tipo de dados: Cadeia de caracteres
state_transitions.transition_available	Sinalizador que indica se a solicitação de mudança pode fazer a transição de seu estado atual para este estado. Valores válidos: Verdadeiro: Pode fazer a transição para este estado. Falso: Não é possível fazer a transição para este estado.

Solicitação de curl

O exemplo de código a seguir mostra como chamar este endpoint.

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/b0dbda5347c12200e0ef563dbb9a718f"/nextstates \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

Resultados de retorno:

{
  "result": {
    "available_states": [ "0", "4", "-1" ], // State values
    "state_transitions": [
      [
        {
          "sys_id": "7a0d2ccdc343101035ae3f52c1d3ae2e", // sttrm_state_transition sys id
          "display_value": "Implement to Review",
          "from_state": "-1",
          "to_state": "0",
          "transition_available": false, // If true, can move to this state
          "automatic_transition": true, // If true, automatically moves to this state
          "conditions": [
            {
              "passed": false, // If true, change request met this condition
              "condition": {
                "name": "No active Change Tasks",
                "description": null,
                "sys_id": "3c1d2ccdc343101035ae3f52c1d3aea4"
              }
            }
          ]
        },
        {
          "sys_id": "db401481c343101035ae3f52c1d3aedd",
          "display_value": "Implement to Review",
          "from_state": "-1",
          "to_state": "0",
          "transition_available": true,
          "automatic_transition": false,
          "conditions": [
            {
              "passed": true,
              "condition": {
                "name": "Not On hold",
                "description": null,
                "sys_id": "2132deb6c303101035ae3f52c1d3ae8c"
              }
            }
          ]
        }
      ],
      [
        {
          "sys_id": "5327c551c343101035ae3f52c1d3aeec",
          "display_value": "Implement to Canceled",
          "from_state": "-1",
          "to_state": "4",
          "transition_available": true,
          "automatic_transition": false,
          "conditions": []
        }
      ]
    ],
    "state_label": { // state value to label pairs
      "0": "Review",
      "4": "Canceled",
      "-1": "Implement"
    }
  }
}

Gestão de mudanças - OBTENHA /sn_chg_rest/change//schedule

Permite recuperar os intervalos de tempo disponíveis para uma solicitação de mudança.

Função necessária: sn_change_writer.

Nota:

Executar este endpoint não lista as horas de início e término disponíveis. Use o link fornecido no corpo da resposta worker.linkpropriedade para obter os dados de programação.

Consulte também:

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/change_sys_id/schedule

URL padrão: /api/sn_chg_rest/change/

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 55. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
change_sys_id	Sys_id da solicitação de mudança na qual encontrar o próximo intervalo de tempo disponível. A solicitação de mudança selecionada deve ter um item de configuração (cmdb_ci) com horas de início planejadas e de término planejadas. Tabela: solicitação de mudança [change_request]

Tabela 56. Parâmetros de consulta
Nome	Descrição
Nenhum(a)

Tabela 57. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 58. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 59. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 60. Códigos de status
Código do status	Descrição
202	O sistema aceitou a solicitação.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada. Possíveis problemas: A solicitação de mudança especificada não tem os horários de início e término planejados. A solicitação de mudança especificada não tem um item de configuração associado (cmdb_ci). O usuário não tem acesso de leitura aos campos da solicitação de mudança.
404	Não encontrado. Não foi possível encontrar o registro especificado. Possíveis problemas: O sistema não pode encontrar a solicitação de mudança com base nas informações fornecidas. O usuário não tem acesso de leitura ao registro.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
erro	Informações sobre todos os erros encontrados ao processar a solicitação de endpoint. Tipo de dados: Objeto `"error": { "detail": "String", "message": "String", "status": "String" }`
error.detail	Informações adicionais sobre o erro. Tipo de dados: Cadeia de caracteres
mensagem.erro	Mensagem que identifica o erro. Tipo de dados: Cadeia de caracteres
mensagens	Informações da mensagem. Tipo de dados: Objeto `"messages": { "errorMessages": [Array], "infoMessages": [Array], "warningMessages": [Array] }`
Messages.erroMessages	Mensagens de erro encontradas ao processar a solicitação. Tipo de dados: Matriz
messages.infoMessages	Mensagens de informação encontradas durante o processamento da solicitação. Tipo de dados: Matriz
Messages.warningMessages	Mensagens de aviso encontradas durante o processamento da solicitação. Tipo de dados: Matriz
solicitação	Solicitação de endpoint original. Tipo de dados: Cadeia de caracteres
estado	Informações sobre o estado atual do trabalhador. Tipo de dados: Objeto `state: { display_value: "String", value: Number }`
state.display_value	Valor de exibição do estado do trabalhador. Esses valores se correlacionam diretamente ao state.valueparâmetro. Valores possíveis: Concluídas Erro Em progresso Aguardando Tipo de dados: Cadeia de caracteres
state.value	Valor numérico do estado do trabalhador. Valores possíveis: 1 2 3 4 Tipo de dados: Número
tipo	Tipo de solicitação. Valor válido: Programação Tipo de dados: Cadeia de caracteres
trabalhador	Informações sobre o trabalhador associado. Tipo de dados: Objeto `"worker": { "link": "String", "sysId": "String" }`
worker.link	Link para recuperar dados de intervalo de tempo.Use o sys_id em OBTENHA /sn_chg_rest/change/worker/ para exibir os resultados. Tipo de dados: Cadeia de caracteres
Worker.SYSID	Sys_id do trabalhador associado à solicitação de mudança. Tipo de dados: Cadeia de caracteres
status	Aparece somente se um erro for encontrado. Status do processamento do endpoint. Valor possível: Falha Tipo de dados: Cadeia de caracteres

Obtenha intervalos de tempo disponíveis

Use o valor fornecido em worker.linkpara obter detalhes da janela de programação. O valor está no seguinte formato:

https://instance.service-now.com/api/sn_chg_rest/change/worker/<worker_sys_id>

Use worker_sys_id em OBTENHA /sn_chg_rest/change/worker/ para exibir os resultados.

O corpo da resposta contém o status e fornece resultados quando o processamento é concluído.

Os resultados do parâmetro do corpo de resposta do trabalhador variam dependendo da disponibilidade do intervalo de tempo.

Se o intervalo de tempo fornecido estiver disponível para a solicitação de mudança no intervalo de tempo programado, a API do trabalhador listará os intervalos de tempo disponíveis no payload.spans propriedade. . payload.spans caso contrário, a propriedade não está listada nos resultados.
Se não houver intervalos de tempo disponíveis para a duração da solicitação de mudança fornecida no intervalo de tempo de programação definido, o. messages.infoMessages declara o seguinte: D
Nota:
O valor padrão do intervalo de tempo de programação de solicitação de mudança é 90 dias. Para mudar este valor, modifique o. change.conflict.next_available.schedule_windowpropriedade. Para obter mais informações, consulte Configure propriedades de análise de conflito .

A seguir OBTENHA /sn_chg_rest/change/worker/ O exemplo mostra a saída fornecida usando o ID fornecido no detalhe worker.link. Os resultados listam períodos de tempo em aberto disponíveis para a duração da tarefa.

{
  "result": {
    "worker": {
      "sysId": "9b3f62e0a4c87010f87712198fe9cad1",
      "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/9b3f62e0a4c87010f87712198fe9cad1"
    },
    "request": "{\"change_sys_id\":\"87ae5e900a0a2c3e263e8304e727c646\",\"timezone\":\"America/Los_Angeles\"}",
    "state": {
      "value": 3,
      "display_value": "Complete"
    },
    "type": "schedule",
    "messages": {
      "errorMessages": [],
      "warningMessages": [],
      "infoMessages": []
    },
    "payload": {
      "spans": [
        {
          "start": {
            "value": "2021-05-08 08:00:00",
            "display_value": "2021-05-08 01:00:00"
          },
          "end": {
            "value": "2021-05-08 11:00:00",
            "display_value": "2021-05-08 04:00:00"
          }
        },
        {
          "start": {
            "value": "2021-05-15 08:00:00",
            "display_value": "2021-05-15 01:00:00"
          },
          "end": {
            "value": "2021-05-15 11:00:00",
            "display_value": "2021-05-15 04:00:00"
          }
        },
        ...
      ]
    }
  }
}

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/change/{change_sys_id}/schedule" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

Os resultados incluem detalhes worker.link que você pode usar para executar o sys_id fornecido no endpoint GET /sn_chg_rest/change/worker/.

{
  "result": {
    "worker": {
      "sysId": "9b3f62e0a4c87010f87712198fe9cad1",
      "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/9b3f62e0a4c87010f87712198fe9cad1"
    },
    "request": "{\"change_sys_id\":\"87ae5e900a0a2c3e263e8304e727c646\",\"timezone\":\"America/Los_Angeles\"}",
    "state": {
      "value": 1,
      "display_value": "Waiting"
    },
    "type": "schedule",
    "messages": {
      "errorMessages": [],
      "warningMessages": [],
      "infoMessages": []
    }
  }
}

Gestão de mudanças - OBTER /sn_chg_rest/change//change//task

Recupera uma ou mais tarefas associadas a uma solicitação de mudança especificada com base nos critérios especificados.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/(change_sys_id)/task

URL padrão: /api/sn_chg_rest/change//task

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 61. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
change_sys_id	Sys_id da solicitação de mudança cujas tarefas serão recuperadas. Tipo de dados: Cadeia de caracteres Tabela: solicitação de mudança [change_request]

Tabela 62. Parâmetros de consulta
Nome	Descrição
pares de chave-valor	Campos a serem modificados ao criar a solicitação. A chave é o nome do campo no modelo e o valor são as informações a serem preenchidas no campo. Campos que não podem ser modificados e são ignorados se passados: Regras de negócio Campos somente leitura, conforme definido em ACLs Campos que não existem Tipo de dados: Cadeia de caracteres
pedido	Campo pelo qual classificar as solicitações de mudança retornadas. Tipo de dados: Cadeia de caracteres
sysparm_limit	Número máximo de registros a serem retornados. Para solicitações que excedem esse número de registros, use sysparm_offsetparâmetro para paginar a recuperação de registro. Tipo de dados: Número Padrão: 500
sysparm_offset	Índice de registro inicial para o qual começar a recuperar registros. Use este valor para paginar a recuperação de registro. Esta funcionalidade permite a recuperação de todos os registros, independentemente do número de registros, em pequenos blocos gerenciáveis. Por exemplo, na primeira vez que você chamar este endpoint, sysparm_offsetdefinido como "0". Para simplesmente percorrer todos os registros disponíveis, use `se você não tiver certeza de que você está usando o sysparm_offset` até chegar ao final de todos os registros. Não passe um número negativo em sysparm_offsetparâmetro. Tipo de dados: Número Padrão: 0
sysparm_query	Consulta codificada usado para filtrar o conjunto de resultados. Você pode usar um filtro de IU para obter uma consulta codificada corretamente. Sintaxe: `sysparm_query_query_<col_name> <operator> <value>` . <col_name>: Nome da coluna da tabela a ser filtrada. Compatível com os seguintes valores <operator>: Corresponde exatamente ao <value>. Não corresponde ao <value>. Declarações de consulta lógica E múltipla. OU: Declarações de consulta lógica OU múltipla. CURTIR: O <col_name> contém a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. STARTSWITH: O <col_name> começa com a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. ENDSWITH: O <col_name> termina com a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. <value>: Valor a ser correspondido. Para obter mais operadores, consulte Operators available for filters and queries. Todos os parâmetros diferenciam maiúsculas de minúsculas. As consultas podem conter mais de uma entrada, como `sysparm_query_<col_name> <operator> <value>[<operator> <col_name> <operator> <value>]` . Por exemplo: `(Sysparm_query_caller_id_id_javascript:gs.getUserID() "ative_true")` As consultas codificadas também são compatíveis com a funcionalidade Ordem por. Para classificar respostas com base em determinados campos, use `ORDERBY` e. `ORDERBYDESC` cláusulas em sysparm_query. Sintaxe: `ORDERBY<col_name>` `ORDERBYDESC<col_name>` Por exemplo: `SYsparm_query` Esta consulta filtra todos os registros ativos e ordena os resultados em ordem crescente por número e, em seguida, em ordem decrescente por categoria. Se parte da consulta for inválida, como especificar um nome de campo inválido, a instância ignorará a parte inválida. Em seguida, ele retorna linhas usando somente a parte válida da consulta. Você pode controlar esse comportamento usando a propriedade glide.invalid_query.returns_no_rows. Defina esta propriedade como verdadeira para não retornar linhas em uma consulta inválida. Nota: . glide.invalid_query.returns_no_rowsa propriedade controla o comportamento de todas as consultas na instância, como em listas, scripts ( GlideRecord.query() E APIs de serviço web. Tipo de dados: Cadeia de caracteres
TextSearch	Cadeia de caracteres a ser usada para pesquisar todos os campos de registro de tarefa de mudança. Esta pesquisa usa ServiceNowfuncionalidade da plataforma de pesquisa de texto completo e o padrão é `IR_AND_OR_QUERY` . Tipo de dados: Cadeia de caracteres

Tabela 63. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 64. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 65. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 66. Códigos de status
Código do status	Descrição
200	Solicitação concluída com sucesso.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. Não foi possível encontrar o registro especificado.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
pares nome-valor	Todos os campos (chave) com seus valores associados para a tarefa de solicitação de mudança identificada antes da exclusão. Tipo de dados: Objeto
primário	Informações da solicitação de mudança associada à tarefa. Tipo de dados: Objeto `parent: { display_value: "String", value: "String" }`
parent.display_value	Informações da solicitação de mudança a serem exibidas em uma IU. Tipo de dados: Cadeia de caracteres
valor.primário	Sys_id da solicitação de mudança associada à tarefa. Tipo de dados: Cadeia de caracteres
sys_id	Informações de sys_id para a tarefa de solicitação de mudança. Tipo de dados: Objeto `sys_id: { display_value: "String", value: "String" }`
sys_id.display_value	Sys_id da tarefa de solicitação de mudança a ser exibida em uma IU. Tipo de dados: Cadeia de caracteres
sys_id.value	Sys_id da tarefa de solicitação de mudança. Tipo de dados: Cadeia de caracteres

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/task?sysparm_query=active=true^ORDERBYnumber" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

{
    result: [
        {
            sys_id: {
                value: "12629ec4b750230096c3e4f6ee11a9d5",
                display_value: "12629ec4b750230096c3e4f6ee11a9d5"
            },
            parent: {
                value: "0f4ac6c4b750230096c3e4f6ee11a9fe ", 
                display_value: "CHG0033046 "
            },
            ..., // all valid fields in record, example below
            short_description: {
                value: "Retire node",
                display_value: "Retire node"
            }
        }, 
        { // next record found }, ... // and so on
    ]
}

Gestão de mudanças - OBTER /sn_chg_rest/change/

Recupera a solicitação de mudança identificada pelo sys_id especificado.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/ sys_id

URL padrão: /api/sn_chg_rest/change/

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 67. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id do registro de solicitação de mudança. Tipo de dados: Cadeia de caracteres Tabela: solicitação de mudança [change_request]

Tabela 68. Parâmetros de consulta
Nome	Descrição
Nenhum(a)

Tabela 69. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 70. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 71. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 72. Códigos de status
Código do status	Descrição
200	Solicitação concluída com sucesso.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. Não foi possível encontrar o registro especificado.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Elemento	Descrição
resultado	Lista que contém um ou mais objetos de registro de solicitação de mudança. Cada objeto descreve uma solicitação de mudança. Cada elemento no objeto de solicitação de mudança corresponde a um campo em seu registro associado na tabela Solicitação de mudança [change_request]. Todos os elementos contêm valor e. display_value pares nome-valor. Os campos de data também contêm display_value_internal pares nome-valor. Tipo de dados: Matriz
action_status	Status da ação atual da solicitação de mudança associada. Valores possíveis: 1: Bloqueado internamente 2: Bloqueado pelo cliente 3: Bloqueado internamente e pelo cliente 4: Precisa de atenção Tipo de dados: Número
ativo	Sinalizador que indica se a solicitação de mudança está ativa. Valores possíveis: Verdadeiro: A solicitação de mudança está ativa Falso: A solicitação de mudança não está ativa Tipo de dados: Booliano Padrão: verdadeiro
activity_due	Data e hora em que o caso associado deve ser concluído. Tipo de dados: Cadeia de caracteres
additional_assignee_list	Lista de sys_ids de pessoas adicionais atribuídas para trabalhar na solicitação de mudança. Tipo de dados: Matriz
aprovação	Tipo de processo de aprovação necessário. Tipo de dados: Cadeia de caracteres Padrão: Não solicitado
approval_history	Entrada de registro do histórico de aprovação mais recente. Tipo de dados: Cadeia de caracteres
approval_set	Data e hora em que a ação associada foi aprovada. Tipo de dados: Cadeia de caracteres
assigned_to	Sys_id do usuário atribuído à solicitação de mudança. Tipo de dados: Cadeia de caracteres
assignment_group	Sys_id do grupo atribuído à solicitação de mudança. Tipo de dados: Cadeia de caracteres
backout_plan	Descrição do plano a ser executado se a mudança precisar ser revertida. Tipo de dados: Cadeia de caracteres
business_duration	Tempo em horas de trabalho programadas, dias úteis e semanas de trabalho que levou para concluir a mudança. Tipo de dados: Cadeia de caracteres
business_service	Sys_id do serviço de negócios associado à solicitação de mudança. Localizado na tabela Serviço [cmdb_ci_service]. Tipo de dados: Cadeia de caracteres
cab_date	Data em que o Comitê Consultivo de Mudança (CCM) se reúne. Tipo de dados: Cadeia de caracteres
cab_delegate	Sys_id do usuário que pode substituir o gerente DO CCM durante uma reunião DO CCM. Localizado na tabela Usuário [sys_user] Tipo de dados: Cadeia de caracteres
ccm_recommendation	Descrição das recomendações DO CCM para a solicitação de mudança. Tipo de dados: Cadeia de caracteres Comprimento máximo: 4 000
cab_obrigatório	Sinalizador que indica se o CCM é necessário. Valores possíveis: Verdadeiro: O Comitê consultivo de mudanças é obrigatório. Change Advisory Board não é necessário. Tipo de dados: Booliano Padrão: falso
calendar_duration	Atualmente não usado por Gestão de mudanças. Tipo de dados: Cadeia de caracteres
categoria	Categoria da mudança, por exemplo, hardware, rede ou software. Tipo de dados: Cadeia de caracteres Padrão: Outro
change_plan	Atividades e funções para gerenciar e controlar a solicitação de mudança. Tipo de dados: Cadeia de caracteres
chg_model	Sys_id do modelo de mudança no qual a solicitação de mudança associada se baseou. O Modelo de Mudança define o fluxo de estado, as transições e as atividades de processo que devem ser concluídas para a solicitação de mudança. Tipo de dados: Cadeia de caracteres Tabela: Modelo de mudança [chg_model]
closed_at	Data e hora em que a solicitação de mudança associada foi encerrada. Tipo de dados: Cadeia de caracteres
closed_by	Sys_id da pessoa que fechou a solicitação de mudança. Tipo de dados: Cadeia de caracteres Tabela: Usuário [sys_user]
close_code	Código atribuído à solicitação de mudança quando ela foi fechada. Por exemplo, Bem-sucedido, Bem-sucedido com problemas e malsucedido. Tipo de dados: Cadeia de caracteres
close_notes	Observa que a pessoa inseriu ao fechar a solicitação de mudança. Tipo de dados: Cadeia de caracteres
cmdb_ci	Sys_id do item de configuração associado à solicitação de mudança. Tipo de dados: Cadeia de caracteres Tabela: Item de configuração [cmdb_ci]
comentários	Lista de anotações de trabalho voltadas para o cliente inseridas na solicitação de mudança associada. Tipo de dados: Matriz
comments_and_work_notes	Lista de anotações de trabalho internas e voltadas para o cliente inseridas para a solicitação de mudança associada. Tipo de dados: Matriz Comprimento máximo: 4 000
empresa	Sys_id da empresa associada à solicitação de mudança. Tipo de dados: Cadeia de caracteres Tabela: Empresa [core_company]
conflict_last_run	Data e hora em que o script de detecção de conflito foi executado pela última vez na solicitação de mudança. Tipo de dados: Cadeia de caracteres
conflict_status	Status de conflito atual conforme detectado pelo script de detecção de conflito, como Conflito e Não executado. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 Padrão: Não executado
contact_type	Método no qual a solicitação de mudança foi solicitada inicialmente. Valores possíveis: bate-papo e-mail telefone social web Tipo de dados: Cadeia de caracteres
contrato	Sys_id do contrato associado à solicitação de mudança. Tipo de dados: Cadeia de caracteres Tabela: Contrato [ast_contract]
correlation_display	Nome amigável para correlation_id. Tipo de dados: Cadeia de caracteres Comprimento máximo: 100
correlation_id	GUID (globalmente exclusivo) de um registro de solicitação de mudança correspondente em um sistema de terceiros. Tipo de dados: Cadeia de caracteres Comprimento máximo: 100
delivery_plan	Não está mais em uso. Sys_id do plano de entrega associado à solicitação de mudança. Tipo de dados: Cadeia de caracteres Tabela: Plano de execução [sc_cat_item_delivery_plan]
delivery_task	Não está mais em uso. Sys_id da tarefa de entrega associada à solicitação de mudança. Tipo de dados: Cadeia de caracteres Tabela: Tarefa do plano de execução [sc_cat_item_delivery_task]
descrição	Descrição detalhada da solicitação de mudança. Tipo de dados: Cadeia de caracteres Comprimento máximo: 4 000
due_date	Prazo da tarefa. Não usado pelo processo de solicitação de mudança. Tipo de dados: Cadeia de caracteres
end_date	Data e hora em que a solicitação de mudança deve ser concluída. Tipo de dados: Cadeia de caracteres
escalação	Nível de escalação atual. Valores possíveis: 0: Normal 1: Moderado 2: Alto 3: Atrasado Tipo de dados: Número (inteiro) Padrão: 0
expected_start	Data e hora em que a tarefa deve começar. Não usado pelo processo de solicitação de mudança. Tipo de dados: Cadeia de caracteres
follow_up	Data e hora em que um usuário fez acompanhamento com a pessoa que solicitou a solicitação de mudança. Tipo de dados: Cadeia de caracteres
group_list	Lista de sys_ids e nomes dos grupos associados à solicitação de mudança. Tipo de dados: Matriz Comprimento máximo: 4 000
impacto	O impacto na solicitação de mudança terá no cliente. Valores possíveis: 1: Alto 2: Médio 3: Baixo Tipo de dados: Número (inteiro) Padrão: 3
implementation_plan	Etapas sequenciais a serem executadas para implementar esta mudança. Ele também contém dependências entre as etapas e os detalhes do designado para cada etapa. Tipo de dados: Cadeia de caracteres Comprimento máximo: 4 000
justificativa	Benefícios de implementar esta mudança e o impacto se esta mudança não for implementada. Tipo de dados: Cadeia de caracteres Comprimento máximo: 4 000
conhecimento	Sinalizador que indica se há artigos de base de conhecimento ()KB) associados à solicitação de mudança. Valores possíveis: Verdadeiro: Artigos da base de conhecimento associados Falso: Nenhum artigo da base de conhecimento associado Tipo de dados: Booliano
local	Sys_id e nome do local do equipamento referenciado na solicitação de mudança. Tipo de dados: Cadeia de caracteres Tabela: Local [cmn_location]
made_sla	Não mais usado. Sinalizador que indica se a solicitação de mudança foi implementada em alinhamento com o acordo de nível de serviço associado. Tipo de dados: Booliano
needs_attention	Sinalizador que indica se a solicitação de mudança precisa de atenção. Valores possíveis: Verdadeiro: A solicitação de mudança precisa de atenção adicional. Falso: A solicitação de mudança não precisa de atenção adicional. Tipo de dados: Booliano Padrão: falso
número	Número de mudança atribuído à solicitação de mudança pelo sistema, como CHG0040007. Tipo de dados: Cadeia de caracteres
em_espera	Sinalizador que indica se a solicitação de mudança está em espera no momento. Valores possíveis: Verdadeiro: Em espera Falso: Não está em espera Tipo de dados: Booliano Padrão: falso
on_hold_reason	. on_holdo parâmetro é "verdadeiro", descrição do motivo pelo qual a solicitação de mudança está sendo retida. Tipo de dados: Cadeia de caracteres Comprimento máximo: 4 000
_hold_task	. on_holdo parâmetro é "verdadeiro", lista dos sys_ids das tarefas que devem ser concluídas antes que a espera seja liberada. Tipo de dados: Cadeia de caracteres Comprimento máximo: 4 000
opened_at	Data e hora em que a versão da mudança foi criada. Tipo de dados: Cadeia de caracteres
opened_by	Sys_id e nome do usuário que criou a versão de mudança. Tipo de dados: Cadeia de caracteres Tabela: Usuário [sys_user]
pedido	Não usado por Gestão de mudanças. Campo numérico opcional pelo qual solicitar registros, como ao recuperá-los de um banco de dados. Tipo de dados: Número (inteiro)
outside_maintenance_schedule	Sinalizador que indica se a manutenção por uma empresa externa foi programada para a solicitação de mudança. Valores possíveis: Verdadeiro: Manutenção externa programada Falso: Nenhuma manutenção externa programada Tipo de dados: Booliano Padrão: falso
primário	Sys_id e nome da tarefa primária para esta solicitação de mudança, se houver. Tipo de dados: Cadeia de caracteres Tabela: Tarefa [task]
fase	Fase atual da solicitação de mudança. Isso define o que a mudança está fazendo com mais detalhes. Valores possíveis: aceitar compilação plano solicitado Tipo de dados: Cadeia de caracteres
phase_state	Registros change_phase que devem ser criados para uma mudança. Eles dependem da categoria, de modo que cada tipo de mudança pode ter registros change_phase diferentes. Os registros change_phase fornecem uma oportunidade para controlar o processo de aprovação, pois cada change_phase pode ter uma programação e um conjunto de aprovadores. Valores possíveis: concluir em espera em aberto rejeitado solicitado trabalho em andamento Tipo de dados: Cadeia de caracteres
prioridade	Prioridade da solicitação de mudança. Valores possíveis: 1: Crítico 2: Alto 3: Moderado 4: Baixo Tipo de dados: Número (inteiro) Padrão: 4
production_system	Sinalizador que indica se a solicitação de mudança é para um ServiceNow instância que está em um ambiente de produção. Valores possíveis: Verdadeiro: Ambiente de produção Falso: Ambiente de não produção Tipo de dados: Booliano
motivo	Descrição do motivo pelo qual a solicitação de mudança foi iniciada. Valores possíveis: Requisitos de negócios Upgrade de hardware Legislação Mudança de local Requisitos de rede IC novo ou removido Outro Problema resolvido Produto ou serviço alterado Upgrade de software Solicitado pelo usuário Tipo de dados: Cadeia de caracteres Comprimento máximo: 40
reassignment_count	Número de vezes que a solicitação de mudança foi reatribuída a um novo proprietário. Tipo de dados: Número (inteiro) Padrão: 0
rejection_goto	Sys_id da tarefa a ser executada se a solicitação de mudança for rejeitada. Tipo de dados: Cadeia de caracteres Tabela: Tarefa [task]
requested_by	Sys_id do usuário que solicitou a mudança. Tipo de dados: Cadeia de caracteres Tabela: Usuário [sys_user]
requested_by_date	Data e hora em que a mudança é solicitada para ser implementada por. Tipo de dados: Cadeia de caracteres
review_comments	Comentários inseridos quando a solicitação de mudança foi revisada. Tipo de dados: Cadeia de caracteres Comprimento máximo: 4 000
review_date	Data em que a solicitação de mudança foi revisada. Tipo de dados: Cadeia de caracteres
review_status	Status atual da revisão da solicitação de mudança solicitada. Tipo de dados: Cadeia de caracteres
risco	Nível de risco associado à solicitação de mudança. Valores válidos: 1: Alto 2: Moderado 3: Baixo Tipo de dados: Número Padrão: 3
risk_impact_analysis	Descrição do risco e análise da implementação da solicitação de mudança. Tipo de dados: Cadeia de caracteres Comprimento máximo: 4 000
route_reason	Atualmente não usado por Gestão de mudanças. Motivo pelo qual a solicitação de mudança foi transferida. Valores possíveis: 1: Transferir com resolução 9: Transferência sem resoluções Tipo de dados: Número
scope	Tamanho da solicitação de mudança. Valores possíveis: 1: Massivo 2: Grande 3: Médio 4: Pequeno 5: Tiny Tipo de dados: Número Padrão: 3
service_offering	Sys_id da oferta de serviço associada à solicitação de mudança. As ofertas de serviço definem exclusivamente o nível de serviço em termos de disponibilidade, escopo, preço e opções de pacote. Tipo de dados: Cadeia de caracteres Tabela: Oferta [service_offering]
short_description	Descrição da solicitação de mudança. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40
habilidades	Lista de sys_ids de todas as habilidades necessárias para implementar a solicitação de mudança. Tipo de dados: Matriz Tabela: Habilidade [cmn_skill]
ans_due	Não está mais em uso. Data e hora em que a solicitação de mudança deve ser concluída com base no acordo de nível de serviço associado. Tipo de dados: Cadeia de caracteres
sn_esign_document	Sys_id de qualquer documento assinado eletronicamente anexado à solicitação de mudança. Tipo de dados: Cadeia de caracteres Tabela: Anexo [sys_attachment]
sn_esign_esignature_configuration	Sys_id do modelo de assinatura eletrônica usado para o documento associado. Tipo de dados: Cadeia de caracteres Tabela: Modelo de assinatura eletrônica [sn_esign_configuration]
start_date	Data e hora em que a solicitação de mudança está planejada para iniciar a implementação. Tipo de dados: Cadeia de caracteres
estado	Estado atual da solicitação de mudança. Os valores possíveis são definidos no modelo de mudança. Tipo de dados: Número (inteiro) Padrão: 1
std_change_producer_version	Sys_id do produtor de registro e da proposta de mudança associada à solicitação de mudança. Ele também inclui o número e a porcentagem de solicitações de mudança bem-sucedidas e malsucedidas criadas a partir da proposta. Tipo de dados: Cadeia de caracteres Tabela: Versão do modelo de mudança padrão [std_change_producer_version]
sys_class_name	Nome da tabela na qual a solicitação de mudança está localizada. Tipo de dados: Cadeia de caracteres
sys_created_by	Nome do usuário que criou inicialmente a solicitação de mudança. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40
sys_created_on	Data e hora em que o registro de solicitação de mudança associado foi criado originalmente. Tipo de dados: Cadeia de caracteres
sys_domain	Se estiver usando domínios na instância, o nome do domínio ao qual o registro do módulo de mudança está associado. Tipo de dados: Cadeia de caracteres
sys_domain_path	Se estiver usando domínios na instância, o caminho do domínio no qual o registro do módulo de mudança associado reside. Tipo de dados: Cadeia de caracteres
sys_id	Identificador exclusivo do registro de solicitação de mudança associado. Tipo de dados: Cadeia de caracteres
sys_mod_count	Número de atualizações do caso desde que ele foi criado inicialmente. Tipo de dados: Número (inteiro)
sys_updated_by	Pessoa que atualizou o caso pela última vez. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40
sys_updated_on	Data e hora em que o caso foi atualizado pela última vez. Tipo de dados: Cadeia de caracteres
task_effective_number	Número da Solicitação universal. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40
task_for	Não usado por Gestão de mudanças. Sys_id do usuário para o qual a tarefa foi criada. Tipo de dados: Cadeia de caracteres Tabela: Usuário [sys_user]
test_plan	Descrição do plano de teste associado à mudança. Tipo de dados: Cadeia de caracteres Comprimento máximo: 4 000
time_worked	Quantidade total de tempo trabalhado na solicitação de mudança. Tipo de dados: Cadeia de caracteres
tipo	Tipo de solicitação de mudança. Valores possíveis: emergência normal padrão Tipo de dados: Cadeia de caracteres Comprimento máximo: 40
não autorizado	Sinalizador que indica se a solicitação de mudança não é autorizada Valores possíveis: Verdadeiro: Não autorizado Falso: Autorizado Tipo de dados: Booliano
universal_request	Sys_id da Solicitação universal primária da qual esta solicitação de mudança faz parte. Tipo de dados: Cadeia de caracteres Tabela: Tarefa [task]
approval	Ação a ser realizada se a solicitação de mudança for aprovada. Valores possíveis: do_nothing prosseguir Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 Padrão: Prosseguir
upon_reject	Ação a ser realizada se a solicitação de mudança for rejeitada. Valores possíveis: cancelar goto Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 Padrão: Cancelar
urgência	Urgência da solicitação de mudança. Valores possíveis: 1: Alto 2: Médio 3: Baixo Tipo de dados: Número (inteiro) Padrão: 3
user_input	Entrada adicional do usuário. Tipo de dados: Cadeia de caracteres Comprimento máximo: 4 000
variáveis	Pares nome-valor de variáveis associadas à solicitação de mudança. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40
watch_list	Lista de sys_ids dos usuários que recebem notificações sobre esta solicitação de mudança quando comentários adicionais são adicionados ou se o estado de uma solicitação de mudança é alterado para Resolvido ou Encerrado. Tipo de dados: Matriz Tabela: Usuário [sys_user]
wf_activity	Sys_id do registro de atividade de fluxo de trabalho associado à solicitação de mudança. Tipo de dados: Cadeia de caracteres Tabela: Atividade de fluxo de trabalho [wf_activity]
work_end	Data e hora em que o trabalho terminou na solicitação de mudança. Tipo de dados: Cadeia de caracteres
work_notes	Informações sobre como resolver a solicitação de mudança ou as etapas executadas para resolvê-la. Tipo de dados: Cadeia de caracteres Comprimento máximo: 4 000
work_notes_list	Lista de sys_ids dos usuários internos que recebem notificações sobre esta solicitação de mudança quando anotações de trabalho são adicionadas. Tipo de dados: Matriz Tabela: Usuário [sys_user]
work_start	Data e hora em que o trabalho começou na solicitação de mudança. Tipo de dados: Cadeia de caracteres

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/b0dbda5347c12200e0ef563dbb9a718f" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

{
  "result":
    {
      "reason": {
        "display_value": "",
        "value": ""
      },
      "parent": {
        "display_value": "",
        "value": ""
      },
      "watch_list": {
        "display_value": "",
        "value": ""
       },
       "proposed_change": {
         "display_value": "",
         "value": ""
       },
       "upon_reject": {
         "display_value": "Cancel all future Tasks",
         "value": "cancel"
       },
       "sys_updated_on": {
         "display_value": "2015-07-06 11:59:27",
         "value": "2015-07-06 18:59:27",
         "display_value_internal": "2015-07-06 11:59:27"
      },
      "type": {
        "display_value": "Standard",
        "value": "standard"
      },
      "approval_history": {
        "display_value": "",
        "value": ""
      },
      "skills": {
        "display_value": "",
        "value": ""
      },
      "test_plan": {
        "display_value": "--Confirm that there are no monitoring alerts for the router",
        "value": "--Confirm that there are no monitoring alerts for the router"
      },
      "number": {
        "display_value": "CHG0000024",
        "value": "CHG0000024"
      },
      "is_bulk": {
        "display_value": "false",
        "value": false
      },
      "cab_delegate": {
        "display_value": "",
        "value": ""
      },
      "requested_by_date": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "ci_class": {
        "display_value": "cmdb_ci",
        "value": "cmdb_ci"
      },
      "state": {
        "display_value": "Closed",
        "value": 3.0
      },
      "sys_created_by": {
        "display_value": "admin",
        "value": "admin"
      },
      "knowledge": {
        "display_value": "false",
        "value": false
      },
      "order": {
        "display_value": "",
        "value": ""
      },
      "phase": {
        "display_value": "Requested",
        "value": "requested"
      },
      "cmdb_ci": {
        "display_value": "",
        "value": ""
      },
      "delivery_plan": {
        "display_value": "",
        "value": ""
      },
      "impact": {
        "display_value": "3 - Low",
        "value": 3.0
      },
      "contract": {
        "display_value": "",
        "value": ""
      },
      "active": {
        "display_value": "false",
        "value": false
      },
      "work_notes_list": {
        "display_value": "",
        "value": ""
      },
      "priority": {
        "display_value": "4 - Low",
        "value": 4.0
      },
      "sys_domain_path": {
        "display_value": "/",
        "value": "/"
      },
      "cab_recommendation": {
        "display_value": "",
        "value": ""
      },
      "production_system": {
        "display_value": "false",
        "value": false
      },
      "rejection_goto": {
        "display_value": "",
        "value": ""
      },
      "review_date": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "requested_by": {
        "display_value": "System Administrator",
        "value": "6816f79cc0a8016401c5a33be04be441"
      },
      "business_duration": {
        "display_value": "",
        "value": ""
      },
      "group_list": {
        "display_value": "",
        "value": ""
      },
      "change_plan": {
        "display_value": "",
        "value": ""
      },
      "approval_set": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "wf_activity": {
        "display_value": "",
        "value": ""
      },
      "implementation_plan": {
        "display_value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform",
        "value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform"
      },
      "universal_request": {
        "display_value": "",
        "value": ""
      },
      "end_date": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "short_description": {
        "display_value": "Clear BGP sessions on a Cisco router",
        "value": "Clear BGP sessions on a Cisco router"
      },
      "correlation_display": {
        "display_value": "",
        "value": ""
      },
      "work_start": {
        "display_value": "2015-07-06 11:56:04",
        "value": "2015-07-06 18:56:04",
        "display_value_internal": "2015-07-06 11:56:04"
      },
      "delivery_task": {
        "display_value": "",
        "value": ""
      },
      "outside_maintenance_schedule": {
        "display_value": "false",
        "value": false
      },
      "additional_assignee_list": {
        "display_value": "",
        "value": ""
      },
      "std_change_producer_version": {
        "display_value": "Clear BGP sessions on a Cisco router - 1",
        "value": "16c2273c47010200e90d87e8dee49006"
      },
      "sys_class_name": {
        "display_value": "Change Request",
        "value": "change_request"
      },
      "service_offering": {
        "display_value": "",
        "value": ""
      },
      "closed_by": {
        "display_value": "System Administrator",
        "value": "6816f79cc0a8016401c5a33be04be441"
      },
      "follow_up": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "review_status": {
        "display_value": "",
        "value": ""
      },
      "reassignment_count": {
        "display_value": "2",
        "value": 2.0
      },
      "start_date": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "assigned_to": {
        "display_value": "",
        "value": ""
      },
      "variables": {
        "display_value": "variable_pool",
        "value": "variable_pool"
      },
      "sla_due": {
        "display_value": "UNKNOWN",
        "value": "",
        "display_value_internal": ""
      },
      "comments_and_work_notes": {
        "display_value": "",
        "value": ""
      },
      "escalation": {
        "display_value": "Normal",
        "value": 0.0
      },
      "upon_approval": {
        "display_value": "Proceed to Next Task",
        "value": "proceed"
      },
      "correlation_id": {
        "display_value": "",
        "value": ""
      },
      "made_sla": {
        "display_value": "true",
        "value": true
      },
      "backout_plan": {
        "display_value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work",
        "value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work"
      },
      "conflict_status": {
        "display_value": "Not Run",
        "value": "Not Run"
      },
      "task_effective_number": {
        "display_value": "CHG0000024",
        "value": "CHG0000024"
      },
      "sys_updated_by": {
        "display_value": "admin",
        "value": "admin"
      },
      "opened_by": {
        "display_value": "System Administrator",
        "value": "6816f79cc0a8016401c5a33be04be441"
      },
      "user_input": {
        "display_value": "",
        "value": ""
      },
      "sys_created_on": {
        "display_value": "2015-07-06 11:55:46",
        "value": "2015-07-06 18:55:46",
        "display_value_internal": "2015-07-06 11:55:46"
      },
      "on_hold_task": {
        "display_value": "",
        "value": ""
      },
      "sys_domain": {
        "display_value": "global",
        "value": "global"
      },
      "route_reason": {
        "display_value": "",
        "value": ""
      },
      "closed_at": {
        "display_value": "2015-07-06 11:56:23",
        "value": "2015-07-06 18:56:23",
        "display_value_internal": "2015-07-06 11:56:23"
      },
      "review_comments": {
        "display_value": "",
        "value": ""
      },
      "business_service": {
        "display_value": "",
        "value": ""
      },
      "time_worked": {
        "display_value": "",
        "value": ""
      },
      "chg_model": {
        "display_value": "",
        "value": ""
      },
      "expected_start": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "opened_at": {
        "display_value": "2015-06-09 11:55:46",
        "value": "2015-06-09 18:55:46",
        "display_value_internal": "2015-06-09 11:55:46"
      },
      "work_end": {
        "display_value": "2015-07-06 11:56:10",
        "value": "2015-07-06 18:56:10",
        "display_value_internal": "2015-07-06 11:56:10"
      },
      "phase_state": {
        "display_value": "Open",
        "value": "open"
      },
      "cab_date": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "work_notes": {
        "display_value": "",
        "value": ""
      },
      "close_code": {
        "display_value": "Successful",
        "value": "successful"
      },
      "assignment_group": {
        "display_value": "Network",
        "value": "287ebd7da9fe198100f92cc8d1d2154e"
      },
      "description": {
        "display_value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n",
        "value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n"
      },
      "on_hold_reason": {
        "display_value": "",
        "value": ""
      },
      "calendar_duration": {
        "display_value": "",
        "value": ""
      },
      "close_notes": {
        "display_value": "Completed without issues",
        "value": "Completed without issues"
      },
      "sys_id": {
        "display_value": "1766f1de47410200e90d87e8dee490f6",
        "value": "1766f1de47410200e90d87e8dee490f6"
      },
      "contact_type": {
        "display_value": "Phone",
        "value": "phone"
      },
      "cab_required": {
        "display_value": "false",
        "value": false
      },
      "urgency": {
        "display_value": "3 - Low",
        "value": 3.0
      },
      "scope": {
        "display_value": "Medium",
        "value": 3.0
      },
      "company": {
        "display_value": "",
        "value": ""
      },
      "justification": {
        "display_value": "",
        "value": ""
      },
      "activity_due": {
        "display_value": "UNKNOWN",
        "value": "",
        "display_value_internal": ""
      },
      "comments": {
        "display_value": "",
        "value": ""
      },
      "approval": {
        "display_value": "Approved",
        "value": "approved"
      },
      "due_date": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "sys_mod_count": {
        "display_value": "10",
        "value": 10.0
      },
      "on_hold": {
        "display_value": "false",
        "value": false
      },
      "sys_tags": {
        "display_value": "",
        "value": ""
      },
      "conflict_last_run": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "risk_value": {
        "display_value": "",
        "value": ""
      },
      "unauthorized": {
        "display_value": "false",
        "value": false
      },
      "risk": {
        "display_value": "Moderate",
        "value": 3.0
      },
      "location": {
        "display_value": "",
        "value": ""
      },
      "category": {
        "display_value": "Other",
        "value": "Other"
      },
      "risk_impact_analysis": {
        "display_value": "",
        "value": ""
      }
    }
}

Gestão de mudanças - OBTER /sn_chg_rest/change//sys_id/ci

Recupera vários itens de configuração (ICs) associados a uma solicitação de mudança especificada com base no tipo de associação especificado.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/ sys_id/ci

URL padrão: /api/sn_chg_rest/change//sys_id/ci

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 73. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id da solicitação de mudança para a qual os ICs do CMDB associados serão retornados. Tipo de dados: Cadeia de caracteres

Tabela 74. Parâmetros de consulta
Nome	Descrição
association_type	Obrigatório. Tipo de associação entre o IC do CMDB e a solicitação de mudança. Valores válidos: Afetados: ICs afetados pela solicitação de mudança Afetados: Serviços afetados pela solicitação de mudança Oferta: Ofertas de serviço afetadas Tipo de dados: Cadeia de caracteres
pares nome-valor	Pares nome-valor a serem usados para filtrar o conjunto de resultados. O nome é o campo no qual o valor especificado é filtrado. Este parâmetro é mutuamente exclusivo com sysparm_query. Por exemplo, em vez de usar `"sysparm_query` , você pode simplificar a declaração de chamada usando `verdadeiro` . Você também pode usar o valor de exibição quando o campo for um campo de escolha ou de tipo de referência, como `&state: encerrado` em vez de `&estado: 7` . Para especificar vários pares de chave-valor, separe cada um com um e comercial, como `"true&assigned_to""john.smith"` . Tipo de dados: Cadeia de caracteres
sysparm_limit	Número máximo de registros a serem retornados. Para solicitações que excedem esse número de registros, use sysparm_offsetparâmetro para paginar a recuperação de registro. Tipo de dados: Número Padrão: 500
sysparm_offset	Índice de registro inicial para o qual começar a recuperar registros. Use este valor para paginar a recuperação de registro. Esta funcionalidade permite a recuperação de todos os registros, independentemente do número de registros, em pequenos blocos gerenciáveis. Por exemplo, na primeira vez que você chamar este endpoint, sysparm_offsetdefinido como "0". Para simplesmente percorrer todos os registros disponíveis, use `se você não tiver certeza de que você está usando o sysparm_offset` até chegar ao final de todos os registros. Não passe um número negativo em sysparm_offsetparâmetro. Tipo de dados: Número Padrão: 0
sysparm_query	Consulta codificada usado para filtrar o conjunto de resultados. Você pode usar um filtro de IU para obter uma consulta codificada corretamente. Sintaxe: `sysparm_query_query_<col_name> <operator> <value>` . <col_name>: Nome da coluna da tabela a ser filtrada. Compatível com os seguintes valores <operator>: Corresponde exatamente ao <value>. Não corresponde ao <value>. Declarações de consulta lógica E múltipla. OU: Declarações de consulta lógica OU múltipla. CURTIR: O <col_name> contém a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. STARTSWITH: O <col_name> começa com a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. ENDSWITH: O <col_name> termina com a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. <value>: Valor a ser correspondido. Para obter mais operadores, consulte Operators available for filters and queries. Todos os parâmetros diferenciam maiúsculas de minúsculas. As consultas podem conter mais de uma entrada, como `sysparm_query_<col_name> <operator> <value>[<operator> <col_name> <operator> <value>]` . Por exemplo: `(Sysparm_query_caller_id_id_javascript:gs.getUserID() "ative_true")` As consultas codificadas também são compatíveis com a funcionalidade Ordem por. Para classificar respostas com base em determinados campos, use `ORDERBY` e. `ORDERBYDESC` cláusulas em sysparm_query. Sintaxe: `ORDERBY<col_name>` `ORDERBYDESC<col_name>` Por exemplo: `SYsparm_query` Esta consulta filtra todos os registros ativos e ordena os resultados em ordem crescente por número e, em seguida, em ordem decrescente por categoria. Se parte da consulta for inválida, como especificar um nome de campo inválido, a instância ignorará a parte inválida. Em seguida, ele retorna linhas usando somente a parte válida da consulta. Você pode controlar esse comportamento usando a propriedade glide.invalid_query.returns_no_rows. Defina esta propriedade como verdadeira para não retornar linhas em uma consulta inválida. Nota: . glide.invalid_query.returns_no_rowsa propriedade controla o comportamento de todas as consultas na instância, como em listas, scripts ( GlideRecord.query() E APIs de serviço web. Tipo de dados: Cadeia de caracteres

Tabela 75. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 76. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 77. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 78. Códigos de status
Código do status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada. A resposta do erro contém mensagens pertinentes para ajudar a solucionar o problema.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
500	Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
ic_item\|cmdb_ci_service	As variáveis ci_item ou cmdb_ci_service, dependendo do tipo de associação. Tipo de dados: Matriz `ci_item\|cmdb_ci_service : { display_value: "String", value: "String" }`
ic_item\|cmdb_ci_service.value	Sys_id de ci_item ou cmdb_ci_service. Tipo de dados: Cadeia de caracteres
ic_item\|cmdb_ci_service.display_value	Valor de exibição de ci_item ou cmdb_ci_service. Tipo de dados: Cadeia de caracteres
sys_id	Informações do sys_id da solicitação de mudança. Tipo de dados: Objeto `sys_id: { display_value: "String", value: "String" }`
sys_id.value	Sys_id da solicitação de mudança. Tipo de dados: Cadeia de caracteres
sys_id.display_value	Sys_id da solicitação de mudança a ser exibida em uma IU. Tipo de dados: Cadeia de caracteres
<record_fields>	Todos os campos válidos no registro ci_item ou cmdb_ci_service; tabela com base no tipo de associação. Tipo de dados: Objeto

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/c286d61347c12200e0ef563dbb9a71df/ci?association_type=affected" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

{
  result: [
    {
      sys_id: {
        value: "92b8544047810200e90d87e8dee490b0",
        display_value: "92b8544047810200e90d87e8dee490b0"
      },
      ci_item|cmdb_ci_service : {
        value: "3a27d4370a0a0bb4006316812bf45439", 
        display_value: "PS Apache01"
      },
      ..., // all valid fields in record, table based on association type
    }, 
    { // next record found }, ... // and so on
  ]
}

Gestão de mudanças - OBTER /sn_chg_rest/change/

Recupera o status do processo de verificação de conflito de solicitação de mudança em execução no momento ou os resultados do último processo de verificação de conflito concluído para a solicitação de mudança especificada.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/ sys_id/conflict

URL padrão: /api/sn_chg_rest/change//sys_id/conflict

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 79. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id da solicitação de mudança para a qual retornar o status do processo de verificação de conflito em execução/concluído. Tipo de dados: Cadeia de caracteres Tabela: solicitação de mudança [change_request]

Tabela 80. Parâmetros de consulta
Nome	Descrição
Nenhum(a)

Tabela 81. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 82. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 83. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 84. Códigos de status
Código do status	Descrição
200	Status atual do processo de verificação de conflitos; incluindo conflitos, se forem detectados.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. Não foi possível encontrar o registro especificado.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
conflicts	Lista de conflitos encontrados para a solicitação de mudança. Um objeto vazio indica que nenhum conflito foi detectado. Tipo de dados: Matriz
job_status	Status do trabalho de verificação de conflito real. Tipo de dados: Cadeia de caracteres
last_run	Data e hora em que o último processo de verificação de conflito foi iniciado. Tipo de dados: Cadeia de caracteres
record_count	Número de registros verificados. Tipo de dados: Cadeia de caracteres
status	Resultado do processo de verificação de conflitos, como "Conflito" ou "não executado". Nota: Mesmo que a solicitação de mudança não tenha conflitos, este campo será definido como "Conflito". No entanto, o conflictso objeto está vazio. Tipo de dados: Cadeia de caracteres

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/conflict" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

Resposta bem-sucedida - sem conflitos

{
  result: {
    status: "Conflict",
    last_run": "2018-08-30 12:58:05",
    record_count: "1",
    job_status: "2",
    conflicts: []
  }
}

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/conflict" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

Resposta bem-sucedida - com conflitos

{
  result: {
    status: "Conflict",
    last_run": "2018-08-30 12:58:05",
    record_count: "1",
    job_status: "2",
    conflicts: [
      {
        change: {
          display_value: "CHG0030001",
          value: "afbffb24b758230096c3e4f6ee11a972"
        },
        type: {
          display_value: "Not In Maintenance Window",
          value: "not_in_maintenance_window"
        }
        ..., // all valid fields in record, example below
      }
    ]
  }
}

Gestão de mudanças - OBTENHA /sn_chg_rest/change/emergency

Recupera uma ou mais solicitações de mudança de emergência com base nos critérios especificados.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/emergency

URL padrão: /api/sn_chg_rest/change/emergency

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 85. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres

Tabela 86. Parâmetros de consulta
Nome	Descrição
pedido	Campo pelo qual classificar as solicitações de mudança retornadas. Tipo de dados: Cadeia de caracteres Padrão: `número`
sysparm_limit	Número máximo de registros a serem retornados. Para solicitações que excedem esse número de registros, use sysparm_offsetparâmetro para paginar a recuperação de registro. Tipo de dados: Número Padrão: 500
sysparm_offset	Índice de registro inicial para o qual começar a recuperar registros. Use este valor para paginar a recuperação de registro. Esta funcionalidade permite a recuperação de todos os registros, independentemente do número de registros, em pequenos blocos gerenciáveis. Por exemplo, na primeira vez que você chamar este endpoint, sysparm_offsetdefinido como "0". Para simplesmente percorrer todos os registros disponíveis, use `se você não tiver certeza de que você está usando o sysparm_offset` até chegar ao final de todos os registros. Não passe um número negativo em sysparm_offsetparâmetro. Tipo de dados: Número Padrão: 0
sysparm_query	Consulta codificada usado para filtrar o conjunto de resultados. Você pode usar um filtro de IU para obter uma consulta codificada corretamente. Sintaxe: `sysparm_query_query_<col_name> <operator> <value>` . <col_name>: Nome da coluna da tabela a ser filtrada. Compatível com os seguintes valores <operator>: Corresponde exatamente ao <value>. Não corresponde ao <value>. Declarações de consulta lógica E múltipla. OU: Declarações de consulta lógica OU múltipla. CURTIR: O <col_name> contém a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. STARTSWITH: O <col_name> começa com a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. ENDSWITH: O <col_name> termina com a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. <value>: Valor a ser correspondido. Para obter mais operadores, consulte Operators available for filters and queries. Todos os parâmetros diferenciam maiúsculas de minúsculas. As consultas podem conter mais de uma entrada, como `sysparm_query_<col_name> <operator> <value>[<operator> <col_name> <operator> <value>]` . Por exemplo: `(Sysparm_query_caller_id_id_javascript:gs.getUserID() "ative_true")` As consultas codificadas também são compatíveis com a funcionalidade Ordem por. Para classificar respostas com base em determinados campos, use `ORDERBY` e. `ORDERBYDESC` cláusulas em sysparm_query. Sintaxe: `ORDERBY<col_name>` `ORDERBYDESC<col_name>` Por exemplo: `SYsparm_query` Esta consulta filtra todos os registros ativos e ordena os resultados em ordem crescente por número e, em seguida, em ordem decrescente por categoria. Se parte da consulta for inválida, como especificar um nome de campo inválido, a instância ignorará a parte inválida. Em seguida, ele retorna linhas usando somente a parte válida da consulta. Você pode controlar esse comportamento usando a propriedade glide.invalid_query.returns_no_rows. Defina esta propriedade como verdadeira para não retornar linhas em uma consulta inválida. Nota: . glide.invalid_query.returns_no_rowsa propriedade controla o comportamento de todas as consultas na instância, como em listas, scripts ( GlideRecord.query() E APIs de serviço web. Tipo de dados: Cadeia de caracteres
pares de chave-valor	Pares nome-valor a serem usados para filtrar o conjunto de resultados. O nome é o campo no qual o valor especificado é filtrado. Este parâmetro é mutuamente exclusivo com sysparm_query. Por exemplo, em vez de usar `"sysparm_query` , você pode simplificar a declaração de chamada usando `verdadeiro` . Você também pode usar o valor de exibição quando o campo for um campo de escolha ou de tipo de referência, como `&state: encerrado` em vez de `&estado: 7` . Para especificar vários pares de chave-valor, separe cada um com um e comercial, como `"true&assigned_to""john.smith"` . Tipo de dados: Cadeia de caracteres
TextSearch	Cadeia de caracteres a ser usada para pesquisar todos os campos de registro de solicitação de mudança de emergência. Esta pesquisa usa ServiceNow funcionalidade da plataforma de pesquisa de texto completo e o padrão é `IR_AND_OR_QUERY` . Tipo de dados: Cadeia de caracteres

Tabela 87. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 88. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 89. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 90. Códigos de status
Código do status	Descrição
200	Solicitação concluída com sucesso.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
pares nome-valor	Valores para todos os campos na solicitação de mudança associada. Tipo de dados: Objeto
estado	Estado da solicitação de mudança. Tipo de dados: Objeto `state: { display_value: "String", value: "String" }`
state.display_value	Estado a ser exibido em uma IU. Tipo de dados: Cadeia de caracteres
state.value	Valor do estado interno. Tipo de dados: Cadeia de caracteres
sys_id	Informações de sys_id para a solicitação de mudança. Tipo de dados: Objeto `sys_id: { display_value: "String", value: "String" }`
sys_id.display_value	Sys_id da solicitação de mudança a ser exibida em uma IU. Tipo de dados: Cadeia de caracteres
sys_id.value	Sys_id da solicitação de mudança. Tipo de dados: Cadeia de caracteres
tipo	Tipo de solicitação de mudança Tipo de dados: Objeto `type: { display_value: "String", value: "String" }`
type.display_value	Altere o tipo a ser exibido em uma IU. O valor é sempre "Emergência". Tipo de dados: Cadeia de caracteres
type.value	Valor do tipo interno. O valor é sempre "emergência". Tipo de dados: Cadeia de caracteres

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/emergency?sysparm_query=active=true^ORDERBYnumber" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

{
  result: [
    {
      sys_id: {
        value: "1c87925347c12200e0ef563dbb9a7177",
        display_value: "1c87925347c12200e0ef563dbb9a7177"
      },
      state: {
        value: "-5", 
        display_value: "New"
      },
      type: {
        value: "emergency",
        display_value: "Emergency"
      },
      ..., // all valid fields in record, example below
      short_description: {
        value: "Reboot server",
        display_value: "Reboot server"
      },
    }, 
    { // next record found }, ... // and so on
  ]
}

Gestão de mudanças - OBTER /sn_chg_rest/change/emergency/

Recupera a solicitação de mudança de emergência identificada pelo sys_id especificado.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/emergency/ sys_id

URL padrão: /api/sn_chg_rest/change/emergency/

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 91. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id da solicitação de mudança de emergência a ser recuperada. Tipo de dados: Cadeia de caracteres Tabela: solicitação de mudança [change_request]

Tabela 92. Parâmetros de consulta
Nome	Descrição
Nenhum(a)

Tabela 93. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 94. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 95. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 96. Códigos de status
Código do status	Descrição
200	Solicitação concluída com sucesso.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. Não foi possível encontrar o registro especificado.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
pares nome-valor	Valores para todos os campos na solicitação de mudança associada. Tipo de dados: Objeto
estado	Estado da solicitação de mudança. Tipo de dados: Objeto `state: { display_value: "String", value: "String" }`
state.display_value	Estado a ser exibido em uma IU. Tipo de dados: Cadeia de caracteres
state.value	Valor do estado interno. Tipo de dados: Cadeia de caracteres
sys_id	Informações de sys_id para a solicitação de mudança. Tipo de dados: Objeto `sys_id: { display_value: "String", value: "String" }`
sys_id.display_value	Sys_id da solicitação de mudança a ser exibida em uma IU. Tipo de dados: Cadeia de caracteres
sys_id.value	Sys_id da solicitação de mudança. Tipo de dados: Cadeia de caracteres
tipo	Tipo de solicitação de mudança Tipo de dados: Objeto `type: { display_value: "String", value: "String" }`
type.display_value	Altere o tipo a ser exibido em uma IU. O valor é sempre "Emergência". Tipo de dados: Cadeia de caracteres
type.value	Valor do tipo interno. O valor é sempre "emergência". Tipo de dados: Cadeia de caracteres

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/emergency/b0dbda5347c12200e0ef563dbb9a718f" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

{
  result: [
    {
      sys_id: {
        value: "b0dbda5347c12200e0ef563dbb9a718f", 
        display_value: "b0dbda5347c12200e0ef563dbb9a718f"
      },
      state: {
        value: "-5", 
        display_value: "New"
      },
      type: {
        value: "emergency",
        display_value: "Emergency"
      },
      ..., // all valid fields in record, example below
      short_description: {
        value: "Reboot server",
        display_value: "Reboot server"
      },
    },
  ]
}

Gestão de mudanças - OBTENHA /sn_chg_rest/change/model

Recupera um ou mais modelos de mudança com base nos critérios especificados.

Use este endpoint para encontrar um modelo de mudança que melhor se adapte à solicitação de mudança que você está tentando criar. Para obter informações adicionais, consulte Modelos de mudança .

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/model

URL padrão: /api/sn_chg_rest/change/model

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 97. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres

Tabela 98. Parâmetros de consulta
Nome	Descrição
pares nome-valor	Pares nome-valor a serem usados para filtrar o conjunto de resultados. O nome é o campo no qual o valor especificado é filtrado. Este parâmetro é mutuamente exclusivo com sysparm_query. Por exemplo, em vez de usar `"sysparm_query` , você pode simplificar a declaração de chamada usando `verdadeiro` . Você também pode usar o valor de exibição quando o campo for um campo de escolha ou de tipo de referência, como `&state: encerrado` em vez de `&estado: 7` . Para especificar vários pares de chave-valor, separe cada um com um e comercial, como `"true&assigned_to""john.smith"` . Tipo de dados: Cadeia de caracteres
pedido	Campo pelo qual classificar os modelos de mudança retornados. Tipo de dados: Cadeia de caracteres Padrão: `nome`
sysparm_offset	Índice de registro inicial para o qual começar a recuperar registros. Use este valor para paginar a recuperação de registro. Esta funcionalidade permite a recuperação de todos os registros, independentemente do número de registros, em pequenos blocos gerenciáveis. Por exemplo, na primeira vez que você chamar este endpoint, sysparm_offsetdefinido como "0". Para simplesmente percorrer todos os registros disponíveis, use `se você não tiver certeza de que você está usando o sysparm_offset` até chegar ao final de todos os registros. Não passe um número negativo em sysparm_offsetparâmetro. Tipo de dados: Número Padrão: 0
sysparm_query	Consulta codificada usado para filtrar o conjunto de resultados. Você pode usar um filtro de IU para obter uma consulta codificada corretamente. Sintaxe: `sysparm_query_query_<col_name> <operator> <value>` . <col_name>: Nome da coluna da tabela a ser filtrada. Compatível com os seguintes valores <operator>: Corresponde exatamente ao <value>. Não corresponde ao <value>. Declarações de consulta lógica E múltipla. OU: Declarações de consulta lógica OU múltipla. CURTIR: O <col_name> contém a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. STARTSWITH: O <col_name> começa com a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. ENDSWITH: O <col_name> termina com a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. <value>: Valor a ser correspondido. Para obter mais operadores, consulte Operators available for filters and queries. Todos os parâmetros diferenciam maiúsculas de minúsculas. As consultas podem conter mais de uma entrada, como `sysparm_query_<col_name> <operator> <value>[<operator> <col_name> <operator> <value>]` . Por exemplo: `(Sysparm_query_caller_id_id_javascript:gs.getUserID() "ative_true")` As consultas codificadas também são compatíveis com a funcionalidade Ordem por. Para classificar respostas com base em determinados campos, use `ORDERBY` e. `ORDERBYDESC` cláusulas em sysparm_query. Sintaxe: `ORDERBY<col_name>` `ORDERBYDESC<col_name>` Por exemplo: `SYsparm_query` Esta consulta filtra todos os registros ativos e ordena os resultados em ordem crescente por número e, em seguida, em ordem decrescente por categoria. Se parte da consulta for inválida, como especificar um nome de campo inválido, a instância ignorará a parte inválida. Em seguida, ele retorna linhas usando somente a parte válida da consulta. Você pode controlar esse comportamento usando a propriedade glide.invalid_query.returns_no_rows. Defina esta propriedade como verdadeira para não retornar linhas em uma consulta inválida. Nota: . glide.invalid_query.returns_no_rowsa propriedade controla o comportamento de todas as consultas na instância, como em listas, scripts ( GlideRecord.query() E APIs de serviço web. Tipo de dados: Cadeia de caracteres
TextSearch	Cadeia de caracteres a ser usada para pesquisar todos os campos de registro do modelo de mudança. Esta pesquisa usa ServiceNow funcionalidade da plataforma de pesquisa de texto completo. Para obter mais informações sobre ServiceNow recursos de pesquisa, consulte Administração de pesquisa . Tipo de dados: Cadeia de caracteres Padrão: `IR_AND_OR_QUERY`

Tabela 99. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 100. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 101. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 102. Códigos de status
Código do status	Descrição
200	Solicitação concluída com sucesso.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
resultado	Lista que contém um ou mais objetos de registro do modelo de mudança. Cada objeto descreve um modelo de mudança. Cada elemento no objeto do modelo de mudança corresponde a um campo em seu registro associado na tabela Modelo de mudança [chg_model]. Todos os elementos contêm valor e. display_value pares nome-valor. Alguns contêm display_value_internal pares nome-valor. Tipo de dados: Matriz
resultado.ativo	Sinalizador que indica se o registro do modelo de mudança associado está ativo e disponível na instância. Valores válidos: Verdadeiro: O modelo de mudança está ativo. Falso: O modelo de mudança não está ativo. Tipo de dados: Booliano Padrão: verdadeiro
result.available_in_ui	Sinalizador que indica se o registro do modelo de mudança associado está disponível na interface do usuário. Valores válidos: Verdadeiro: O modelo de mudança está disponível na interface do usuário. Falso: O modelo de mudança não está disponível na interface do usuário. Tipo de dados: Booliano Padrão: verdadeiro
resultado.cor	Cor do modelo de mudança associado na página principal da solicitação de mudança. Tipo de dados: Cadeia de caracteres Cbcbccbcb
result.default_change_model	Sinalizador que indica se o registro do modelo de mudança associado é o modelo de mudança padrão. Valores válidos: Verdadeiro: Padrão Falso: Não é o padrão Tipo de dados: Booliano Padrão: falso
result.description	Descrição resumida da finalidade do modelo de mudança. Tipo de dados: Cadeia de caracteres Comprimento máximo: 4 000
result.name	Nome do modelo de mudança. Tipo de dados: Cadeia de caracteres Comprimento máximo: 200
result.record_preset	Pares nome-valor dos campos que devem ser preenchidos automaticamente, com seus valores associados, quando um novo registro de solicitação de mudança é criado. Os valores são separados por símbolos de cursor. Por exemplo: `"Normal"` Tipo de dados: Cadeia de caracteres
result.state_field	Campo da lista de seleção da qual coletar escolhas, com base no fornecido em table_name. Para modelos de mudança, isso é sempre definido como "estado". Tipo de dados: Cadeia de caracteres
resultado.sys_class_name	Mudar o nome da tabela do módulo. Sempre mude Model/chg_model. Tipo de dados: Cadeia de caracteres
resultado.sys_created_by	Nome do usuário que criou inicialmente o registro do módulo de mudança associado. Tipo de dados: Cadeia de caracteres
resultado.sys_created_on	Data e hora em que o registro do módulo de mudança foi criado originalmente. Tipo de dados: Cadeia de caracteres
result.sys_domain	Se estiver usando domínios na instância, o nome do domínio ao qual o registro do módulo de mudança está associado. Tipo de dados: Cadeia de caracteres
resultado.sys_domain_path	Se estiver usando domínios na instância, o caminho do domínio no qual o registro do módulo de mudança associado reside. Tipo de dados: Cadeia de caracteres
sys_id.result.sys_id	Identificador exclusivo do registro do modelo de mudança associado. Tipo de dados: Cadeia de caracteres
resultado.sys_mod_count	Número de vezes que o registro do modelo de mudança associado foi modificado. Tipo de dados: Número
result.sys_name	Nome do modelo de mudança. Sempre igual a nameparâmetro. Tipo de dados: Cadeia de caracteres
result.sys_tags	Marcadores do sistema associados ao registro do modelo de mudança. Tipo de dados: Cadeia de caracteres
resultado.sys_updated_by	Nome do usuário que atualizou o registro do modelo de mudança associado pela última vez. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40
resultado.sys_updated_on	Data e hora em que o registro do modelo de mudança associado foi atualizado pela última vez. Tipo de dados: Cadeia de caracteres
result.table_name	Tabela que define o campo da lista de seleção da qual as escolhas serão coletadas. Para modelos de mudança, isso sempre é definido como "change_request". Tipo de dados: Cadeia de caracteres Comprimento máximo: 80

Solicitação de curl

Este exemplo mostra uma solicitação para obter todos os registros do modelo de mudança.

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/model \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

Para brevidade, esta resposta mostra apenas um único objeto de modelo de mudança.

{
  "result": [
    {
      "record_preset": {
        "display_value": "type=normal^assignment_group=a715cd759f2002002920bde8132e7018^short_description=Automated : Change^EQ",
        "value": "type=normal^assignment_group=a715cd759f2002002920bde8132e7018^short_description=Automated : Change^EQ"
      },
      "color": {
        "display_value": "#488df4",
        "value": "#488df4"
      },
      "default_change_model": {
        "display_value": "false",
        "value": false
      },
      "sys_mod_count": {
        "display_value": "6",
        "value": 6.0
      },
      "description": {
        "display_value": "This model is intended to capture  a record of an automated change.  There are no approvals associated with this change model.\r\n",
        "value": "This model is intended to capture  a record of an automated change.  There are no approvals associated with this change model.\r\n"
      },
      "active": {
        "display_value": "true",
        "value": true
      },
      "sys_updated_on": {
        "display_value": "2020-10-02 06:24:24",
        "value": "2020-10-02 13:24:24",
        "display_value_internal": "2020-10-02 06:24:24"
      },
      "sys_tags": {
        "display_value": "",
        "value": ""
      },
        "table_name": {
        "display_value": "change_request",
        "value": "change_request"
      },
      "sys_class_name": {
        "display_value": "Change Model",
        "value": "chg_model"
      },
      "sys_id": {
        "display_value": "7840d2515323101034d1ddeeff7b12a6",
        "value": "7840d2515323101034d1ddeeff7b12a6"
      },
      "sys_updated_by": {
        "display_value": "admin",
        "value": "admin"
      },
      "available_in_ui": {
        "display_value": "false",
        "value": false
      },
      "state_field": {
        "display_value": "state",
        "value": "state"
      },
      "sys_created_on": {
        "display_value": "2020-09-28 07:33:25",
        "value": "2020-09-28 14:33:25",
        "display_value_internal": "2020-09-28 07:33:25"
      },
      "name": {
        "display_value": "Change Registration",
        "value": "Change Registration"
      },
      "sys_name": {
        "display_value": "Change Registration",
        "value": "Change Registration"
      },
      "sys_created_by": {
        "display_value": "admin",
        "value": "admin"
      }
    }
  ]
}

Gestão de mudanças - OBTENHA /sn_chg_rest/change/model/

Recupera o modelo de mudança identificado pelo sys_id especificado.

Você pode usar este modelo de mudança para criar a solicitação de mudança desejada. Para obter informações adicionais sobre modelos de mudança, consulte Modelos de mudança .

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/model/ sys_id

URL padrão: /api/sn_chg_rest/change/model/

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 103. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id do registro do modelo de mudança a ser recuperado da tabela Modelo de mudança [chg_model]. Tipo de dados: Cadeia de caracteres

Tabela 104. Parâmetros de consulta
Nome	Descrição
Nenhum(a)

Tabela 105. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 106. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 107. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 108. Códigos de status
Código do status	Descrição
200	Solicitação concluída com sucesso.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. Não foi possível encontrar o registro especificado.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
resultado	Objeto de registro do modelo de mudança solicitado. Cada elemento neste objeto corresponde a um campo no registro na tabela Modelo de mudança [chg_model]. Todos os elementos contêm valuee. display_valuepares nome-valor. Alguns contêm display_value_internalpares nome-valor. Tipo de dados: Objeto
resultado.ativo	Sinalizador que indica se o registro do modelo de mudança associado está ativo e disponível na instância. Valores válidos: Verdadeiro: O modelo de mudança está ativo. Falso: O modelo de mudança não está ativo. Tipo de dados: Booliano Padrão: verdadeiro
result.available_in_ui	Sinalizador que indica se o registro do modelo de mudança associado está disponível na interface do usuário. Valores válidos: Verdadeiro: O modelo de mudança está disponível na interface do usuário. Falso: O modelo de mudança não está disponível na interface do usuário. Tipo de dados: Booliano Padrão: verdadeiro
resultado.cor	Cor do modelo de mudança associado na página principal da solicitação de mudança. Tipo de dados: Cadeia de caracteres Cbcbccbcb
result.default_change_model	Sinalizador que indica se o registro do modelo de mudança associado é o modelo de mudança padrão. Valores válidos: Verdadeiro: Padrão Falso: Não é o padrão Tipo de dados: Booliano Padrão: falso
result.description	Descrição resumida da finalidade do modelo de mudança. Tipo de dados: Cadeia de caracteres Comprimento máximo: 4 000
result.name	Nome do modelo de mudança. Tipo de dados: Cadeia de caracteres Comprimento máximo: 200
result.record_preset	Pares nome-valor dos campos que devem ser preenchidos automaticamente, com seus valores associados, quando um novo registro de solicitação de mudança é criado. Os valores são separados por símbolos de cursor. Por exemplo: `"Normal"` Tipo de dados: Cadeia de caracteres
result.state_field	Campo da lista de seleção da qual coletar escolhas, com base no fornecido em table_name. Para modelos de mudança, isso é sempre definido como "estado". Tipo de dados: Cadeia de caracteres
resultado.sys_class_name	Mudar o nome da tabela do módulo. Sempre mude Model/chg_model. Tipo de dados: Cadeia de caracteres
resultado.sys_created_by	Nome do usuário que criou inicialmente o registro do módulo de mudança associado. Tipo de dados: Cadeia de caracteres
resultado.sys_created_on	Data e hora em que o registro do módulo de mudança foi criado originalmente. Tipo de dados: Cadeia de caracteres
result.sys_domain	Se estiver usando domínios na instância, o nome do domínio ao qual o registro do módulo de mudança está associado. Tipo de dados: Cadeia de caracteres
resultado.sys_domain_path	Se estiver usando domínios na instância, o caminho do domínio no qual o registro do módulo de mudança associado reside. Tipo de dados: Cadeia de caracteres
sys_id.result.sys_id	Identificador exclusivo do registro do modelo de mudança associado. Tipo de dados: Cadeia de caracteres
resultado.sys_mod_count	Número de vezes que o registro do modelo de mudança associado foi modificado. Tipo de dados: Número
result.sys_name	Nome do modelo de mudança. Sempre igual a nameparâmetro. Tipo de dados: Cadeia de caracteres
result.sys_tags	Marcadores do sistema associados ao registro do modelo de mudança. Tipo de dados: Cadeia de caracteres
resultado.sys_updated_by	Nome do usuário que atualizou o registro do modelo de mudança associado pela última vez. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40
resultado.sys_updated_on	Data e hora em que o registro do modelo de mudança associado foi atualizado pela última vez. Tipo de dados: Cadeia de caracteres
result.table_name	Tabela que define o campo da lista de seleção da qual as escolhas serão coletadas. Para modelos de mudança, isso sempre é definido como "change_request". Tipo de dados: Cadeia de caracteres Comprimento máximo: 80

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/model/c0efda5347c12200e0ef563dbb9a81e3" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

{
  "result": {
    "record_preset": {
      "display_value": "type=emergency^EQ",
      "value": "type=emergency^EQ"
    },
    "color": {
      "display_value": "#ea3423",
      "value": "#ea3423"
    },
    "default_change_model": {
      "display_value": "false",
      "value": false
    },
    "sys_mod_count": {
      "display_value": "2",
      "value": 2.0
    },
    "description": {
      "display_value": "ITIL Mode 1 Emergency Change",
      "value": "ITIL Mode 1 Emergency Change"
    },
    "active": {
      "display_value": "true",
      "value": true
    },
    "sys_updated_on": {
      "display_value": "2020-09-28 08:53:12",
      "value": "2020-09-28 15:53:12",
      "display_value_internal": "2020-09-28 08:53:12"
    },
    "sys_tags": {
      "display_value": "",
      "value": ""
    },
    "table_name": {
      "display_value": "change_request",
      "value": "change_request"
    },
    "sys_class_name": {
      "display_value": "Change Model",
      "value": "chg_model"
    },
    "sys_id": {
      "display_value": "c0efda5347c12200e0ef563dbb9a81e3",
      "value": "c0efda5347c12200e0ef563dbb9a81e3"
    },
    "sys_updated_by": {
      "display_value": "admin",
      "value": "admin"
    },
    "available_in_ui": {
      "display_value": "true",
      "value": true
    },
    "state_field": {
      "display_value": "state",
      "value": "state"
    },
    "sys_created_on": {
      "display_value": "2020-09-04 09:16:03",
      "value": "2020-09-04 16:16:03",
      "display_value_internal": "2020-09-04 09:16:03"
    },
    "name": {
      "display_value": "Emergency",
      "value": "Emergency"
    },
    "sys_name": {
      "display_value": "Emergency",
      "value": "Emergency"
    },
    "sys_created_by": {
      "display_value": "admin",
      "value": "admin"
    }
  }
}

Gestão de mudanças - OBTER /sn_chg_rest/change/normal

Recupera uma ou mais solicitações de mudança normais com base nos critérios especificados.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/normal

URL padrão: /api/sn_chg_rest/change/normal

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 109. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres

Tabela 110. Parâmetros de consulta
Nome	Descrição
pares nome-valor	Pares nome-valor a serem usados para filtrar o conjunto de resultados. O nome é o campo no qual o valor especificado é filtrado. Este parâmetro é mutuamente exclusivo com sysparm_query. Por exemplo, em vez de usar `"sysparm_query` , você pode simplificar a declaração de chamada usando `verdadeiro` . Você também pode usar o valor de exibição quando o campo for um campo de escolha ou de tipo de referência, como `&state: encerrado` em vez de `&estado: 7` . Para especificar vários pares de chave-valor, separe cada um com um e comercial, como `"true&assigned_to""john.smith"` . Tipo de dados: Cadeia de caracteres
pedido	Campo pelo qual classificar as solicitações de mudança retornadas. Tipo de dados: Cadeia de caracteres
sysparm_limit	Número máximo de registros a serem retornados. Para solicitações que excedem esse número de registros, use sysparm_offsetparâmetro para paginar a recuperação de registro. Tipo de dados: Número Padrão: 500
sysparm_offset	Índice de registro inicial para o qual começar a recuperar registros. Use este valor para paginar a recuperação de registro. Esta funcionalidade permite a recuperação de todos os registros, independentemente do número de registros, em pequenos blocos gerenciáveis. Por exemplo, na primeira vez que você chamar este endpoint, sysparm_offsetdefinido como "0". Para simplesmente percorrer todos os registros disponíveis, use `se você não tiver certeza de que você está usando o sysparm_offset` até chegar ao final de todos os registros. Não passe um número negativo em sysparm_offsetparâmetro. Tipo de dados: Número Padrão: 0
sysparm_query	Consulta codificada usado para filtrar o conjunto de resultados. Você pode usar um filtro de IU para obter uma consulta codificada corretamente. Sintaxe: `sysparm_query_query_<col_name> <operator> <value>` . <col_name>: Nome da coluna da tabela a ser filtrada. Compatível com os seguintes valores <operator>: Corresponde exatamente ao <value>. Não corresponde ao <value>. Declarações de consulta lógica E múltipla. OU: Declarações de consulta lógica OU múltipla. CURTIR: O <col_name> contém a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. STARTSWITH: O <col_name> começa com a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. ENDSWITH: O <col_name> termina com a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. <value>: Valor a ser correspondido. Para obter mais operadores, consulte Operators available for filters and queries. Todos os parâmetros diferenciam maiúsculas de minúsculas. As consultas podem conter mais de uma entrada, como `sysparm_query_<col_name> <operator> <value>[<operator> <col_name> <operator> <value>]` . Por exemplo: `(Sysparm_query_caller_id_id_javascript:gs.getUserID() "ative_true")` As consultas codificadas também são compatíveis com a funcionalidade Ordem por. Para classificar respostas com base em determinados campos, use `ORDERBY` e. `ORDERBYDESC` cláusulas em sysparm_query. Sintaxe: `ORDERBY<col_name>` `ORDERBYDESC<col_name>` Por exemplo: `SYsparm_query` Esta consulta filtra todos os registros ativos e ordena os resultados em ordem crescente por número e, em seguida, em ordem decrescente por categoria. Se parte da consulta for inválida, como especificar um nome de campo inválido, a instância ignorará a parte inválida. Em seguida, ele retorna linhas usando somente a parte válida da consulta. Você pode controlar esse comportamento usando a propriedade glide.invalid_query.returns_no_rows. Defina esta propriedade como verdadeira para não retornar linhas em uma consulta inválida. Nota: . glide.invalid_query.returns_no_rowsa propriedade controla o comportamento de todas as consultas na instância, como em listas, scripts ( GlideRecord.query() E APIs de serviço web. Tipo de dados: Cadeia de caracteres
TextSearch	Cadeia de caracteres a ser usada para pesquisar todos os campos de registro de solicitação de mudança normal. Esta pesquisa usa a funcionalidade da plataforma de pesquisa de texto completo da ServiceNow e o padrão é `IR_AND_OR_QUERY` . Tipo de dados: Cadeia de caracteres

Tabela 111. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 112. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 113. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 114. Códigos de status
Código do status	Descrição
200	Solicitação concluída com sucesso.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
pares nome-valor	Valores para todos os campos na solicitação de mudança associada. Tipo de dados: Objeto
estado	Estado da solicitação de mudança antes da exclusão. Tipo de dados: Objeto `state: { display_value: "String", value: "String" }`
state.display_value	Estado a ser exibido em uma IU. Tipo de dados: Cadeia de caracteres
state.value	Valor do estado interno. Tipo de dados: Cadeia de caracteres
sys_id	Informações de sys_id para a solicitação de mudança. Tipo de dados: Objeto `sys_id: { display_value: "String", value: "String" }`
sys_id.display_value	Sys_id da solicitação de mudança a ser exibida em uma IU. Tipo de dados: Cadeia de caracteres
sys_id.value	Sys_id da solicitação de mudança. Tipo de dados: Cadeia de caracteres
tipo	Tipo de solicitação de mudança Tipo de dados: Objeto `type: { display_value: "String", value: "String" }`
type.display_value	Altere o tipo a ser exibido em uma IU. O valor é sempre "Normal". Tipo de dados: Cadeia de caracteres
type.value	Valor do tipo interno. O valor é sempre "Normal". Tipo de dados: Cadeia de caracteres

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/normal?sysparm_query=active=true^ORDERBYnumber" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

{
  result: [
    {
      sys_id: {
        value: "1c87925347c12200e0ef563dbb9a7177",
        display_value: "1c87925347c12200e0ef563dbb9a7177"
      },
      state: {
        value: "-5", 
        display_value: "New"
      },
      type: {
        value: "normal",
        display_value: "Normal"
      },
      ..., // all valid fields in record, example below
      short_description: {
        value: "Add network switch to cabinet",
        display_value: "Add network switch to cabinet"
      },
    },
    { // next record found }, ... // and so on
  ]
}

Gestão de mudanças - OBTER /sn_chg_rest/change/normal/

Recupera a solicitação de mudança normal identificada pelo sys_id especificado.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/normal/ sys_id

URL padrão: /api/sn_chg_rest/change/normal/

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 115. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id da solicitação de mudança normal a ser recuperada. Tipo de dados: Cadeia de caracteres Tabela: solicitação de mudança [change_request]

Tabela 116. Parâmetros de consulta
Nome	Descrição
Nenhum(a)

Tabela 117. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 118. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 119. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 120. Códigos de status
Código do status	Descrição
200	Solicitação concluída com sucesso.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. Não foi possível encontrar o registro especificado.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
pares nome-valor	Valores para todos os campos na solicitação de mudança associada. Tipo de dados: Objeto
estado	Estado da solicitação de mudança antes da exclusão. Tipo de dados: Objeto `state: { display_value: "String", value: "String" }`
state.display_value	Estado a ser exibido em uma IU. Tipo de dados: Cadeia de caracteres
state.value	Valor do estado interno. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id da solicitação de mudança. Tipo de dados: Cadeia de caracteres
tipo	Tipo de solicitação de mudança Tipo de dados: Objeto `type: { display_value: "String", value: "String" }`
type.display_value	Altere o tipo a ser exibido em uma IU. O valor é sempre "Normal". Tipo de dados: Cadeia de caracteres
type.value	Valor do tipo interno. O valor é sempre "Normal". Tipo de dados: Cadeia de caracteres

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/normal/b0dbda5347c12200e0ef563dbb9a718f" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

{
  result: [
    {
      sys_id: "b0dbda5347c12200e0ef563dbb9a718f",
      state: {
        value: "-5", 
        display_value: "New"
      },
      type: {
        value: "normal",
        display_value: "Normal"
      },
      ..., // all valid fields in record, example below
      short_description: {
        value: "Add network switch to cabinet",
        display_value: "Add network switch to cabinet"
      },
    },
  ]
}

Gestão de mudanças - OBTENHA /sn_chg_rest/change/standard

Recupera uma ou mais solicitações de mudança padrão com base nos critérios especificados.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/standard

URL padrão: /api/sn_chg_rest/change/standard

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 121. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres

Tabela 122. Parâmetros de consulta
Nome	Descrição
pares nome-valor	Pares nome-valor a serem usados para filtrar o conjunto de resultados. O nome é o campo no qual o valor especificado é filtrado. Este parâmetro é mutuamente exclusivo com sysparm_query. Por exemplo, em vez de usar `"sysparm_query` , você pode simplificar a declaração de chamada usando `verdadeiro` . Você também pode usar o valor de exibição quando o campo for um campo de escolha ou de tipo de referência, como `&state: encerrado` em vez de `&estado: 7` . Para especificar vários pares de chave-valor, separe cada um com um e comercial, como `"true&assigned_to""john.smith"` . Tipo de dados: Cadeia de caracteres
pedido	Campo pelo qual classificar as solicitações de mudança retornadas. Tipo de dados: Cadeia de caracteres
sysparm_limit	Número máximo de registros a serem retornados. Para solicitações que excedem esse número de registros, use sysparm_offsetparâmetro para paginar a recuperação de registro. Tipo de dados: Cadeia de caracteres Padrão: 500
sysparm_offset	Índice de registro inicial para o qual começar a recuperar registros. Use este valor para paginar a recuperação de registro. Esta funcionalidade permite a recuperação de todos os registros, independentemente do número de registros, em pequenos blocos gerenciáveis. Por exemplo, na primeira vez que você chamar este endpoint, sysparm_offsetdefinido como "0". Para simplesmente percorrer todos os registros disponíveis, use `se você não tiver certeza de que você está usando o sysparm_offset` até chegar ao final de todos os registros. Não passe um número negativo em sysparm_offsetparâmetro. Tipo de dados: Número Padrão: 0
sysparm_query	Consulta codificada usado para filtrar o conjunto de resultados. Você pode usar um filtro de IU para obter uma consulta codificada corretamente. Sintaxe: `sysparm_query_query_<col_name> <operator> <value>` . <col_name>: Nome da coluna da tabela a ser filtrada. Compatível com os seguintes valores <operator>: Corresponde exatamente ao <value>. Não corresponde ao <value>. Declarações de consulta lógica E múltipla. OU: Declarações de consulta lógica OU múltipla. CURTIR: O <col_name> contém a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. STARTSWITH: O <col_name> começa com a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. ENDSWITH: O <col_name> termina com a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. <value>: Valor a ser correspondido. Para obter mais operadores, consulte Operators available for filters and queries. Todos os parâmetros diferenciam maiúsculas de minúsculas. As consultas podem conter mais de uma entrada, como `sysparm_query_<col_name> <operator> <value>[<operator> <col_name> <operator> <value>]` . Por exemplo: `(Sysparm_query_caller_id_id_javascript:gs.getUserID() "ative_true")` As consultas codificadas também são compatíveis com a funcionalidade Ordem por. Para classificar respostas com base em determinados campos, use `ORDERBY` e. `ORDERBYDESC` cláusulas em sysparm_query. Sintaxe: `ORDERBY<col_name>` `ORDERBYDESC<col_name>` Por exemplo: `SYsparm_query` Esta consulta filtra todos os registros ativos e ordena os resultados em ordem crescente por número e, em seguida, em ordem decrescente por categoria. Se parte da consulta for inválida, como especificar um nome de campo inválido, a instância ignorará a parte inválida. Em seguida, ele retorna linhas usando somente a parte válida da consulta. Você pode controlar esse comportamento usando a propriedade glide.invalid_query.returns_no_rows. Defina esta propriedade como verdadeira para não retornar linhas em uma consulta inválida. Nota: . glide.invalid_query.returns_no_rowsa propriedade controla o comportamento de todas as consultas na instância, como em listas, scripts ( GlideRecord.query() E APIs de serviço web. Tipo de dados: Cadeia de caracteres
TextSearch	Cadeia de caracteres a ser usada para pesquisar todos os campos de registro de solicitação de mudança padrão. Esta pesquisa usa ServiceNow funcionalidade da plataforma de pesquisa de texto completo e o padrão é `IR_AND_OR_QUERY` . Tipo de dados: Cadeia de caracteres

Tabela 123. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 124. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 125. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 126. Códigos de status
Código do status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
pares nome-valor	Todos os campos (chave) com os valores associados à solicitação de mudança identificada. Tipo de dados: Objeto
estado	Estado da solicitação de mudança antes da exclusão. Tipo de dados: Objeto `state: { display_value: "String", value: "String" }`
state.display_value	Estado a ser exibido em uma IU. Tipo de dados: Cadeia de caracteres
state.value	Valor do estado interno. Tipo de dados: Cadeia de caracteres
sys_id	Informações de sys_id para a solicitação de mudança. Tipo de dados: Objeto `sys_id: { display_value: "String", value: "String" }`
sys_id.display_value	Sys_id da solicitação de mudança a ser exibida em uma IU. Tipo de dados: Cadeia de caracteres
sys_id.value	Sys_id da solicitação de mudança. Tipo de dados: Cadeia de caracteres
tipo	Tipo de solicitação de mudança Tipo de dados: Objeto `type: { display_value: "String", value: "String" }`
type.display_value	Altere o tipo a ser exibido em uma IU. O valor é sempre "Padrão". Tipo de dados: Cadeia de caracteres
type.value	Valor do tipo interno. O valor é sempre "padrão". Tipo de dados: Cadeia de caracteres

Solicitação de cURL de amostra

curl "https://instance.service-now.com/api/sn_chg_rest/v1/change/standard?sysparm_query=active=true^ORDERBYnumber" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

{
  result: [
    {
      sys_id: {
        value: "1c87925347c12200e0ef563dbb9a7177",
        display_value: "1c87925347c12200e0ef563dbb9a7177"
      },
      state: {
        value: "-5", 
        display_value: "New"
      },
      type: {
        value: "standard",
        display_value: "Standard"
      },
      ..., // all valid fields in record, example below
      short_description: {
        value: "Add network switch to cabinet",
        display_value: "Add network switch to cabinet"
      },
    }, 
    { // next record found }, ... // and so on
  ]
}

Gestão de mudanças - OBTER /sn_chg_rest/change/standard/

Recupera a solicitação de mudança padrão identificada pelo sys_id especificado.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/standard/ sys_id

URL padrão: /api/sn_chg_rest/change/standard/

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 127. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id da solicitação de mudança padrão a ser recuperada. Tipo de dados: Cadeia de caracteres Tabela: solicitação de mudança [change_request]

Tabela 128. Parâmetros de consulta
Nome	Descrição
Nenhum(a)

Tabela 129. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 130. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 131. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 132. Códigos de status
Código do status	Descrição
200	Solicitação concluída com sucesso.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. Não foi possível encontrar o registro especificado.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
pares nome-valor	Todos os campos (chave) com os valores associados à solicitação de mudança identificada. Tipo de dados: Objeto
estado	Estado da solicitação de mudança antes da exclusão. Tipo de dados: Objeto `state: { display_value: "String", value: "String" }`
state.display_value	Estado a ser exibido em uma IU. Tipo de dados: Cadeia de caracteres
state.value	Valor do estado interno. Tipo de dados: Cadeia de caracteres
sys_id	Informações de sys_id para a solicitação de mudança. Tipo de dados: Objeto `sys_id: { display_value: "String", value: "String" }`
sys_id.display_value	Sys_id da solicitação de mudança a ser exibida em uma IU. Tipo de dados: Cadeia de caracteres
sys_id.value	Sys_id da solicitação de mudança. Tipo de dados: Cadeia de caracteres

Solicitação de curl

curl "https://https://instance.servicenow.com/api/sn_chg_rest/v1/change/standard/b0dbda5347c12200e0ef563dbb9a718f" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

{
  result: [
    {
      sys_id: {
        value: "1c87925347c12200e0ef563dbb9a7177",
        display_value: "1c87925347c12200e0ef563dbb9a7177"
      },
      state: {
        value: "-5", 
        display_value: "New"
      },
      ..., // all valid fields in record, example below
      short_description: {
        value: "Add network switch to cabinet",
        display_value: "Add network switch to cabinet"
      },
    }, 
  ]
}

Gestão de mudanças - OBTENHA /sn_chg_rest/change/standard/template

Recupera um ou mais modelos de mudança padrão com base nos critérios especificados.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/standard/template

URL padrão: /api/sn_chg_rest/change/standard/template

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 133. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres

Tabela 134. Parâmetros de consulta
Nome	Descrição
pares nome-valor	Pares nome-valor a serem usados para filtrar o conjunto de resultados. O nome é o campo no qual o valor especificado é filtrado. Este parâmetro é mutuamente exclusivo com sysparm_query. Por exemplo, em vez de usar `"sysparm_query` , você pode simplificar a declaração de chamada usando `verdadeiro` . Você também pode usar o valor de exibição quando o campo for um campo de escolha ou de tipo de referência, como `&state: encerrado` em vez de `&estado: 7` . Para especificar vários pares de chave-valor, separe cada um com um e comercial, como `"true&assigned_to""john.smith"` . Tipo de dados: Cadeia de caracteres
pedido	Campo pelo qual classificar os modelos de mudança padrão retornados. Tipo de dados: Cadeia de caracteres Padrão: Número
sysparm_limit	Número máximo de registros a serem retornados. Para solicitações que excedem esse número de registros, use sysparm_offsetparâmetro para paginar a recuperação de registro. Tipo de dados: Número Padrão: 500
sysparm_offset	Índice de registro inicial para o qual começar a recuperar registros. Use este valor para paginar a recuperação de registro. Esta funcionalidade permite a recuperação de todos os registros, independentemente do número de registros, em pequenos blocos gerenciáveis. Por exemplo, na primeira vez que você chamar este endpoint, sysparm_offsetdefinido como "0". Para simplesmente percorrer todos os registros disponíveis, use `se você não tiver certeza de que você está usando o sysparm_offset` até chegar ao final de todos os registros. Não passe um número negativo em sysparm_offsetparâmetro. Tipo de dados: Número Padrão: 0
sysparm_query	Consulta codificada usado para filtrar o conjunto de resultados. Você pode usar um filtro de IU para obter uma consulta codificada corretamente. Sintaxe: `sysparm_query_query_<col_name> <operator> <value>` . <col_name>: Nome da coluna da tabela a ser filtrada. Compatível com os seguintes valores <operator>: Corresponde exatamente ao <value>. Não corresponde ao <value>. Declarações de consulta lógica E múltipla. OU: Declarações de consulta lógica OU múltipla. CURTIR: O <col_name> contém a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. STARTSWITH: O <col_name> começa com a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. ENDSWITH: O <col_name> termina com a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. <value>: Valor a ser correspondido. Para obter mais operadores, consulte Operators available for filters and queries. Todos os parâmetros diferenciam maiúsculas de minúsculas. As consultas podem conter mais de uma entrada, como `sysparm_query_<col_name> <operator> <value>[<operator> <col_name> <operator> <value>]` . Por exemplo: `(Sysparm_query_caller_id_id_javascript:gs.getUserID() "ative_true")` As consultas codificadas também são compatíveis com a funcionalidade Ordem por. Para classificar respostas com base em determinados campos, use `ORDERBY` e. `ORDERBYDESC` cláusulas em sysparm_query. Sintaxe: `ORDERBY<col_name>` `ORDERBYDESC<col_name>` Por exemplo: `SYsparm_query` Esta consulta filtra todos os registros ativos e ordena os resultados em ordem crescente por número e, em seguida, em ordem decrescente por categoria. Se parte da consulta for inválida, como especificar um nome de campo inválido, a instância ignorará a parte inválida. Em seguida, ele retorna linhas usando somente a parte válida da consulta. Você pode controlar esse comportamento usando a propriedade glide.invalid_query.returns_no_rows. Defina esta propriedade como verdadeira para não retornar linhas em uma consulta inválida. Nota: . glide.invalid_query.returns_no_rowsa propriedade controla o comportamento de todas as consultas na instância, como em listas, scripts ( GlideRecord.query() E APIs de serviço web. Tipo de dados: Cadeia de caracteres
TextSearch	Cadeia de caracteres a ser usada para pesquisar todos os campos de registro de solicitação de mudança padrão. Esta pesquisa usa a funcionalidade da plataforma de pesquisa de texto completo da ServiceNow e o padrão é `IR_AND_OR_QUERY` . Tipo de dados: Cadeia de caracteres

Tabela 135. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 136. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 137. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 138. Códigos de status
Código do status	Descrição
200	Solicitação concluída com sucesso.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
pares nome-valor	Todos os campos com seus valores associados para o modelo de mudança padrão identificado. Tipo de dados: Objeto
sys_id	Informações de sys_id para a solicitação de mudança. Tipo de dados: Objeto `sys_id: { display_value: "String", value: "String" }`
sys_id.display_value	Sys_id da solicitação de mudança a ser exibida em uma IU. Tipo de dados: Cadeia de caracteres
sys_id.value	Sys_id da solicitação de mudança. Tipo de dados: Cadeia de caracteres
modelo	Informações sobre o modelo de mudança padrão. Tipo de dados: Objeto `template: { display_value: "String", value: "String" }`
template.display_value	Informações do modelo a serem exibidas na IU. Tipo de dados: Cadeia de caracteres
template.value	Sys_id do modelo. Tipo de dados: Cadeia de caracteres

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/standard/template?sysparm_query=active=true^ORDERBYnumber" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

{
  result: [
    {
      sys_id: {
        value: "92b8544047810200e90d87e8dee490b0",
        display_value: "92b8544047810200e90d87e8dee490b0"
      },
      template : {
        value: "1c8e02ec47410200e90d87e8dee49057", 
        display_value: "Add network switch to datacenter cabinet"
      },
      ..., // all valid fields in record, example below
      short_description: {
        value: "Standard change template to add network switch to cabinet",
        display_value: "Standard change template to add network switch to cabinet"
      },
    }, 
    { // next record found }, ... // and so on
  ]
}

Gestão de mudanças - OBTER /sn_chg_rest/change/standard/template/

Recupera o modelo de mudança padrão identificado pelo sys_id especificado.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/standard/template/ sys_id

URL padrão: /api/sn_chg_rest/change/standard/template/

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 139. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id do modelo de mudança padrão a ser recuperado. Tipo de dados: Cadeia de caracteres Tabela: Modelo de mudança padrão [std_change_record_producer]

Tabela 140. Parâmetros de consulta
Nome	Descrição
Nenhum(a)

Tabela 141. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 142. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 143. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 144. Códigos de status
Código do status	Descrição
200	Solicitação concluída com sucesso.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. Não foi possível encontrar o registro especificado.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
pares nome-valor	Todos os campos com seus valores associados para o modelo de mudança padrão identificado. Tipo de dados: Objeto
sys_id	Sys_id da solicitação de mudança. Tipo de dados: Cadeia de caracteres
modelo	Informações sobre o modelo de mudança padrão. Tipo de dados: Objeto `template: { display_value: "String", value: "String" }`
template.display_value	Informações do modelo a serem exibidas em uma IU. Tipo de dados: Cadeia de caracteres
template.value	Sys_id do modelo. Tipo de dados: Cadeia de caracteres

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/standard/template/92b8544047810200e90d87e8dee490b0" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

{
  result: [
    {
      sys_id: "92b8544047810200e90d87e8dee490b0",
      template : {
        value: "1c8e02ec47410200e90d87e8dee49057", 
        display_value: "Add network switch to datacenter cabinet"
      },
      ..., // all valid fields in record, example below
      short_description: {
        value: "Standard change template to add network switch to cabinet",
        display_value: "Standard change template to add network switch to cabinet"
      },
    }, 
  ]
}

Gestão de mudanças - OBTENHA /sn_chg_rest/change/worker/

Recupera o status atual, as informações e os erros do trabalhador assíncrono especificado.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/worker/ sys_id

URL padrão: /api/sn_chg_rest/

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 145. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id do trabalhador assíncrono da gestão de mudanças. Tipo de dados: Cadeia de caracteres Tabela: Trabalhador da gestão de mudanças [chg_mgt_worker]

Tabela 146. Parâmetros de consulta
Nome	Descrição
Nenhum(a)

Tabela 147. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 148. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 149. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 150. Códigos de status
Código do status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. Não foi possível encontrar o registro especificado.
500	Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
mensagens	Informações da mensagem. Tipo de dados: Objeto `"messages": { "errorMessages": [Array], "infoMessages": [Array], "warningMessages": [Array] }`
Messages.erroMessages	Mensagens de erro encontradas ao processar a solicitação. Por exemplo: Cmdb_ci sys_id inválido fornecido Tipo de dados: Matriz
messages.infoMessages	Mensagens de informação encontradas durante o processamento da solicitação. Por exemplo: Cmdb_ci sys_id já associado ao fornecido. Tipo de dados: Matriz
Messages.warningMessages	Mensagens de aviso encontradas durante o processamento da solicitação. Por exemplo: Cmdb_ci sys_id inválido fornecido. Tipo de dados: Matriz
carga	Carga exclusiva fornecida ao usar um sys_id de trabalhador do corpo de resposta bem-sucedida de um endpoint de programação. OBTER /ci/cmdb_ci_sys_id]/schedule OBTENHA /sn_chg_rest/change//change//schedule `"payload": { "spans": [Array] }` Tipo de dados: Objeto
span.carga	Se um período de tempo estiver disponível dentro da duração fornecida no endpoint de programação, a API do trabalhador listará os períodos de tempo disponíveis. `"payload": { "spans": [ { "end": {Object}, "start": {Object} } ] }` Tipo de dados: Matriz
span.start	`"start": { "display_value": "String", "value": "String" }` Tipo de dados: Objeto
span.start.value	Data e hora em que a solicitação de mudança está planejada para iniciar a implementação. Tipo de dados: Cadeia de caracteres
carga.spans.start.display_value	Exibe o valor da hora de início da solicitação de mudança. Formato de hora: aaaa-MM-dd hh:mm:ss Tipo de dados: Cadeia de caracteres
span.end	`"end": { "display_value": "String", "value": "String" }` Tipo de dados: Objeto
span.end.value	Data e hora em que a solicitação de mudança está planejada para conclusão. Formato de hora: aaaa-MM-dd hh:mm:ss Tipo de dados: Cadeia de caracteres
carga.spans.end.display_value	Exibe o valor do tempo de conclusão da solicitação de mudança. Tipo de dados: Cadeia de caracteres
solicitação	Solicitação de endpoint original. Tipo de dados: Cadeia de caracteres
estado	Informações sobre o estado atual do trabalhador. Tipo de dados: Objeto `state: { display_value: "String", value: Number }`
state.display_value	Valor de exibição do estado do trabalhador. Esses valores se correlacionam diretamente ao state.valueparâmetro. Valores possíveis: Concluídas Erro Em progresso Aguardando Tipo de dados: Cadeia de caracteres
state.value	Valor numérico do estado do trabalhador. Valores possíveis: 1 2 3 4 Tipo de dados: Número
tipo	Tipo de associação entre o IC do CMDB e a solicitação de mudança. Tipo de dados: Cadeia de caracteres
trabalhador	Informações sobre o trabalhador associado. Tipo de dados: Objeto `"worker": { "link": "String", "sysId": "String" }`
worker.link	URL para recuperar o status do trabalhador associado e outras informações pertinentes do trabalhador. Tipo de dados: Cadeia de caracteres
Worker.SYSID	Sys_id do trabalhador associado à solicitação de mudança. Tipo de dados: Cadeia de caracteres
<other_params>	Outros parâmetros que são específicos do processo, como ignored_cmdb_ci_sys_ids.

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/worker/0644cd02dbec330084f07ffdbf9619c1" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

{
  "result": {
    "worker": {
      "sysId": "0644cd02dbec330084f07ffdbf9619c1",
      "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/0644cd02dbec330084f07ffdbf9619c1"
    },
    "request": "{\"task\":\"c286d61347c12200e0ef563dbb9a71df\"}",
    "state": {
      "value": 3,
      "display_value": "Complete"
    },
    "type": "impacted",
    "messages": {
      "errorMessages": [],
      "warningMessages": [],
      "infoMessages": []
    }
  }
}

Gestão de mudanças - PATCH /sn_chg_rest/change/

Atualiza a solicitação de mudança identificada pelo sys_id especificado com os pares de chave-valor no corpo ou URL da solicitação.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/ sys_id

URL padrão: /api/sn_chg_rest/change/

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 151. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id da solicitação de mudança a ser modificada. Tipo de dados: Cadeia de caracteres Tabela: solicitação de mudança [change_request]

Tabela 152. Parâmetros de consulta
Nome	Descrição
pares nome-valor	Pares nome-valor que representam os campos a serem atualizados. Os parâmetros do corpo da solicitação substituem os parâmetros de URL. No entanto, os parâmetros obrigatórios devem ser especificados no URL. Tipo de dados: Cadeia de caracteres
encrypted_fields	Lista de campos separados por vírgulas a serem criptografados. Esses campos são criptografados antes de serem armazenados no registro associado. Quando especificado, o endpoint chama o GlideRecord DisplayValue() , em vez de chamar SetValue() método. Por isso, você também pode usar esse parâmetro para passar valores de exibição para campos não criptografados, como campos de referência ou de opção, em vez de passar sys_ids ou valores. Tipo de dados: Cadeia de caracteres

Tabela 153. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
dados	Pares nome-valor que representam os campos a serem atualizados na solicitação de mudança associada. Por exemplo, para atualizar o arquivo de descrição resumida, insira um par nome-valor semelhante ao seguinte: `"short_description": "my short description""` . Tipo de dados: Cadeia de caracteres
encrypted_fields	Lista de campos separados por vírgulas a serem criptografados. Esses campos são criptografados antes de serem armazenados no registro associado. Quando especificado, o endpoint chama o GlideRecord DisplayValue() , em vez de chamar SetValue() método. Por isso, você também pode usar esse parâmetro para passar valores de exibição para campos não criptografados, como campos de referência ou de opção, em vez de passar sys_ids ou valores. Tipo de dados: Cadeia de caracteres

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 .

Tabela 154. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json
Tipo de conteúdo	Formato de dados do corpo da solicitação. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 155. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 156. Códigos de status
Código do status	Descrição
200	Solicitação concluída com sucesso.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. Não foi possível encontrar o registro especificado.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
resultado	Registro de solicitação de mudança atualizado. Cada elemento neste objeto corresponde a um campo no registro na tabela Solicitação de mudança [change_request]. Todos os elementos contêm valuee. display_valuepares nome-valor. Alguns contêm display_value_internalpares nome-valor. Tipo de dados: Objeto

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/b0dbda5347c12200e0ef563dbb9a718f" \
--request PATCH \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--data "{\"short_desription\": \"Reboot the server at 6 am\" }" \
--user "username":"password"

{
  "result":
    {
      "reason": {
        "display_value": "",
        "value": ""
      },
      "parent": {
        "display_value": "",
        "value": ""
      },
      "watch_list": {
        "display_value": "",
        "value": ""
       },
       "proposed_change": {
         "display_value": "",
         "value": ""
       },
       "upon_reject": {
         "display_value": "Cancel all future Tasks",
         "value": "cancel"
       },
       "sys_updated_on": {
         "display_value": "2015-07-06 11:59:27",
         "value": "2015-07-06 18:59:27",
         "display_value_internal": "2015-07-06 11:59:27"
      },
      "type": {
        "display_value": "Standard",
        "value": "standard"
      },
      "approval_history": {
        "display_value": "",
        "value": ""
      },
      "skills": {
        "display_value": "",
        "value": ""
      },
      "test_plan": {
        "display_value": "--Confirm that there are no monitoring alerts for the router",
        "value": "--Confirm that there are no monitoring alerts for the router"
      },
      "number": {
        "display_value": "CHG0000024",
        "value": "CHG0000024"
      },
      "is_bulk": {
        "display_value": "false",
        "value": false
      },
      "cab_delegate": {
        "display_value": "",
        "value": ""
      },
      "requested_by_date": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "ci_class": {
        "display_value": "cmdb_ci",
        "value": "cmdb_ci"
      },
      "state": {
        "display_value": "Closed",
        "value": 3.0
      },
      "sys_created_by": {
        "display_value": "admin",
        "value": "admin"
      },
      "knowledge": {
        "display_value": "false",
        "value": false
      },
      "order": {
        "display_value": "",
        "value": ""
      },
      "phase": {
        "display_value": "Requested",
        "value": "requested"
      },
      "cmdb_ci": {
        "display_value": "",
        "value": ""
      },
      "delivery_plan": {
        "display_value": "",
        "value": ""
      },
      "impact": {
        "display_value": "3 - Low",
        "value": 3.0
      },
      "contract": {
        "display_value": "",
        "value": ""
      },
      "active": {
        "display_value": "false",
        "value": false
      },
      "work_notes_list": {
        "display_value": "",
        "value": ""
      },
      "priority": {
        "display_value": "4 - Low",
        "value": 4.0
      },
      "sys_domain_path": {
        "display_value": "/",
        "value": "/"
      },
      "cab_recommendation": {
        "display_value": "",
        "value": ""
      },
      "production_system": {
        "display_value": "false",
        "value": false
      },
      "rejection_goto": {
        "display_value": "",
        "value": ""
      },
      "review_date": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "requested_by": {
        "display_value": "System Administrator",
        "value": "6816f79cc0a8016401c5a33be04be441"
      },
      "business_duration": {
        "display_value": "",
        "value": ""
      },
      "group_list": {
        "display_value": "",
        "value": ""
      },
      "change_plan": {
        "display_value": "",
        "value": ""
      },
      "approval_set": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "wf_activity": {
        "display_value": "",
        "value": ""
      },
      "implementation_plan": {
        "display_value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform",
        "value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform"
      },
      "universal_request": {
        "display_value": "",
        "value": ""
      },
      "end_date": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "short_description": {
        "display_value": "Reboot the server at 6 am",
        "value": "Reboot the server at 6 am"
      },
      "correlation_display": {
        "display_value": "",
        "value": ""
      },
      "work_start": {
        "display_value": "2015-07-06 11:56:04",
        "value": "2015-07-06 18:56:04",
        "display_value_internal": "2015-07-06 11:56:04"
      },
      "delivery_task": {
        "display_value": "",
        "value": ""
      },
      "outside_maintenance_schedule": {
        "display_value": "false",
        "value": false
      },
      "additional_assignee_list": {
        "display_value": "",
        "value": ""
      },
      "std_change_producer_version": {
        "display_value": "Clear BGP sessions on a Cisco router - 1",
        "value": "16c2273c47010200e90d87e8dee49006"
      },
      "sys_class_name": {
        "display_value": "Change Request",
        "value": "change_request"
      },
      "service_offering": {
        "display_value": "",
        "value": ""
      },
      "closed_by": {
        "display_value": "System Administrator",
        "value": "6816f79cc0a8016401c5a33be04be441"
      },
      "follow_up": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "review_status": {
        "display_value": "",
        "value": ""
      },
      "reassignment_count": {
        "display_value": "2",
        "value": 2.0
      },
      "start_date": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "assigned_to": {
        "display_value": "",
        "value": ""
      },
      "variables": {
        "display_value": "variable_pool",
        "value": "variable_pool"
      },
      "sla_due": {
        "display_value": "UNKNOWN",
        "value": "",
        "display_value_internal": ""
      },
      "comments_and_work_notes": {
        "display_value": "",
        "value": ""
      },
      "escalation": {
        "display_value": "Normal",
        "value": 0.0
      },
      "upon_approval": {
        "display_value": "Proceed to Next Task",
        "value": "proceed"
      },
      "correlation_id": {
        "display_value": "",
        "value": ""
      },
      "made_sla": {
        "display_value": "true",
        "value": true
      },
      "backout_plan": {
        "display_value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work",
        "value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work"
      },
      "conflict_status": {
        "display_value": "Not Run",
        "value": "Not Run"
      },
      "task_effective_number": {
        "display_value": "CHG0000024",
        "value": "CHG0000024"
      },
      "sys_updated_by": {
        "display_value": "admin",
        "value": "admin"
      },
      "opened_by": {
        "display_value": "System Administrator",
        "value": "6816f79cc0a8016401c5a33be04be441"
      },
      "user_input": {
        "display_value": "",
        "value": ""
      },
      "sys_created_on": {
        "display_value": "2015-07-06 11:55:46",
        "value": "2015-07-06 18:55:46",
        "display_value_internal": "2015-07-06 11:55:46"
      },
      "on_hold_task": {
        "display_value": "",
        "value": ""
      },
      "sys_domain": {
        "display_value": "global",
        "value": "global"
      },
      "route_reason": {
        "display_value": "",
        "value": ""
      },
      "closed_at": {
        "display_value": "2015-07-06 11:56:23",
        "value": "2015-07-06 18:56:23",
        "display_value_internal": "2015-07-06 11:56:23"
      },
      "review_comments": {
        "display_value": "",
        "value": ""
      },
      "business_service": {
        "display_value": "",
        "value": ""
      },
      "time_worked": {
        "display_value": "",
        "value": ""
      },
      "chg_model": {
        "display_value": "",
        "value": ""
      },
      "expected_start": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "opened_at": {
        "display_value": "2015-06-09 11:55:46",
        "value": "2015-06-09 18:55:46",
        "display_value_internal": "2015-06-09 11:55:46"
      },
      "work_end": {
        "display_value": "2015-07-06 11:56:10",
        "value": "2015-07-06 18:56:10",
        "display_value_internal": "2015-07-06 11:56:10"
      },
      "phase_state": {
        "display_value": "Open",
        "value": "open"
      },
      "cab_date": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "work_notes": {
        "display_value": "",
        "value": ""
      },
      "close_code": {
        "display_value": "Successful",
        "value": "successful"
      },
      "assignment_group": {
        "display_value": "Network",
        "value": "287ebd7da9fe198100f92cc8d1d2154e"
      },
      "description": {
        "display_value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n",
        "value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n"
      },
      "on_hold_reason": {
        "display_value": "",
        "value": ""
      },
      "calendar_duration": {
        "display_value": "",
        "value": ""
      },
      "close_notes": {
        "display_value": "Completed without issues",
        "value": "Completed without issues"
      },
      "sys_id": {
        "display_value": "b0dbda5347c12200e0ef563dbb9a718f",
        "value": "b0dbda5347c12200e0ef563dbb9a718f"
      },
      "contact_type": {
        "display_value": "Phone",
        "value": "phone"
      },
      "cab_required": {
        "display_value": "false",
        "value": false
      },
      "urgency": {
        "display_value": "3 - Low",
        "value": 3.0
      },
      "scope": {
        "display_value": "Medium",
        "value": 3.0
      },
      "company": {
        "display_value": "",
        "value": ""
      },
      "justification": {
        "display_value": "",
        "value": ""
      },
      "activity_due": {
        "display_value": "UNKNOWN",
        "value": "",
        "display_value_internal": ""
      },
      "comments": {
        "display_value": "",
        "value": ""
      },
      "approval": {
        "display_value": "Approved",
        "value": "approved"
      },
      "due_date": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "sys_mod_count": {
        "display_value": "10",
        "value": 10.0
      },
      "on_hold": {
        "display_value": "false",
        "value": false
      },
      "sys_tags": {
        "display_value": "",
        "value": ""
      },
      "conflict_last_run": {
        "display_value": "",
        "value": "",
        "display_value_internal": ""
      },
      "risk_value": {
        "display_value": "",
        "value": ""
      },
      "unauthorized": {
        "display_value": "false",
        "value": false
      },
      "risk": {
        "display_value": "Moderate",
        "value": 3.0
      },
      "location": {
        "display_value": "",
        "value": ""
      },
      "category": {
        "display_value": "Other",
        "value": "Other"
      },
      "risk_impact_analysis": {
        "display_value": "",
        "value": ""
      }
    }
}

Solicitação de curl

O exemplo a seguir mostra como passar campos criptografados no corpo da solicitação.

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/b0dbda5347c12200e0ef563dbb9a718f" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
    \"encrypted_fields\":\"short_description,description\",
    \"short_description\":\"my short desc\",
    \"description\":\"my desc\"
}" \
--user "username":"password"

Solicitação de curl

O exemplo a seguir mostra como passar campos criptografados como parâmetros de consulta.

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/b0dbda5347c12200e0ef563dbb9a718f?encrypted_fields=short_description%2Cdescription&short_description=my%20short%20desc&description=my%20desc" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{}" \
--user "username":"password"

Gestão de mudanças - PATCH /sn_chg_rest/change/

Permite que o usuário atual aprove ou rejeite um registro de aprovação de solicitação de mudança para a solicitação de mudança especificada.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/ sys_id/approvations

URL padrão: /api/sn_chg_rest/change//sys_id/approvations

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 157. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id da solicitação de mudança à qual a aprovação/rejeição se aplica. Tipo de dados: Cadeia de caracteres Tabela: solicitação de mudança [change_request]

Tabela 158. Parâmetros de consulta
Nome	Descrição
Nenhum(a)

Tabela 159. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
comentários	Necessário se state. `rejeitado` . Motivo pelo qual a mudança foi rejeitada. Tipo de dados: Cadeia de caracteres
estado	Obrigatório. Estado de aprovação. Por exemplo: `"estado": "aprovado""` Valores válidos: aprovado rejeitado Tipo de dados: Cadeia de caracteres

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 .

Tabela 160. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json
Tipo de conteúdo	Formato de dados do corpo da solicitação. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 161. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 162. Códigos de status
Código do status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
400	Solicitação incorreta. Indica um tipo de solicitação incorreto, como o usuário que não tem autoridade para aprovar ou rejeitar a solicitação de mudança.
500	Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
pares nome-valor	Valores para todos os campos na solicitação de mudança associada. Tipo de dados: Objeto
estado	Estado atual da solicitação de mudança. Tipo de dados: Objeto `state: { display_value: "String", value: "String" }`
state.display_value	Estado a ser exibido em uma IU. Tipo de dados: Cadeia de caracteres
state.value	Valor do estado interno. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id da solicitação de mudança que está sendo aprovada/rejeitada. Tipo de dados: Cadeia de caracteres
tipo	Tipo de solicitação de mudança Tipo de dados: Objeto `type: { display_value: "String", value: "String" }`
type.display_value	Altere o tipo a ser exibido em uma IU. Valores possíveis: Emergência Normal Padrão Tipo de dados: Cadeia de caracteres
type.value	Valor do tipo interno. Valores possíveis: emergência normal padrão Tipo de dados: Cadeia de caracteres

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/approvals" \
--request POST \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--data "{\"state\": \"approved\"}" \
--user "username":"password"

{
  result: [
    {
      sys_id: "0f4ac6c4b750230096c3e4f6ee11a9fe",
      state: {
        value: "-2", 
        display_value: "Scheduled"
      },
      type: {
        value: "normal",
        display_value: "Normal"
      },
      ..., // all valid fields in record, single parameter example below
      short_description: {
        value: "Remove server",
        display_value: "Remove server"
      }
    }
  ]
}

Gestão de mudanças - PATCH /sn_chg_rest/change//schedule/first_available

Atualiza as horas de início e término planejadas de uma solicitação de mudança usando o primeiro intervalo de tempo disponível encontrado.

Função necessária: sn_change_writer.

Nota:

Use o link fornecido no corpo da resposta worker.linkpropriedade para exibir o status da programação.

Consulte também:

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change//schedule/first_available

URL padrão: /api/sn_chg_rest/change//schedule/first_available

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 163. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
change_sys_id	Sys_id da solicitação de mudança na qual atualizar com o próximo intervalo de tempo disponível. A solicitação de mudança selecionada deve ter um item de configuração (cmdb_ci). Tipo de dados: Cadeia de caracteres Tabela: Solicitações de mudança [change_request]

Tabela 164. Parâmetros de consulta
Nome	Descrição
Nenhum(a)

Tabela 165. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
duration_in_seconds	Duração da mudança em segundos, ou seja, quanto tempo é necessário para concluir a tarefa de solicitação de mudança. Tipo de dados: Inteiro
planned_start_time	Opcional. Data e hora em que a solicitação de mudança está planejada para iniciar a implementação em UTC. Recupere o início do intervalo de tempo disponível em ou depois desse horário. Se não for fornecido, o sistema usará a hora atual como a hora de início. Formato: aaaa-MM-dd hh:mm:ss Tipo de dados: Cadeia de caracteres

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 .

Tabela 166. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 167. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 168. Códigos de status
Código do status	Descrição
202	O sistema aceitou a solicitação.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada. Possíveis problemas: O valor do parâmetro do corpo duration_in_seconds é inválido ou não foi fornecido. Valor de parâmetro de corpo planned_start_time inválido fornecido. A solicitação de mudança especificada não tem um item de configuração associado (cmdb_ci). O usuário não tem acesso de leitura aos campos da solicitação de mudança.
403	Proibido. O usuário não tem acesso de gravação aos valores de data de início e término planejados da solicitação de mudança.
404	Não encontrado. Não foi possível encontrar o registro especificado. Possíveis problemas: O sistema não pode encontrar a solicitação de mudança com base nas informações fornecidas. O usuário não tem acesso de leitura ao registro.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
erro	Informações sobre todos os erros encontrados ao processar a solicitação de endpoint. Tipo de dados: Objeto `"error": { "detail": "String", "message": "String", "status": "String" }`
error.detail	Informações adicionais sobre o erro. Tipo de dados: Cadeia de caracteres
mensagem.erro	Mensagem que identifica o erro. Tipo de dados: Cadeia de caracteres
mensagens	Informações da mensagem. Tipo de dados: Objeto `"messages": { "errorMessages": [Array], "infoMessages": [Array], "warningMessages": [Array] }`
Messages.erroMessages	Mensagens de erro encontradas ao processar a solicitação. Tipo de dados: Matriz
messages.infoMessages	Mensagens de informação encontradas durante o processamento da solicitação. Tipo de dados: Matriz
Messages.warningMessages	Mensagens de aviso encontradas durante o processamento da solicitação. Tipo de dados: Matriz
solicitação	Solicitação de endpoint original. Tipo de dados: Cadeia de caracteres
estado	Informações sobre o estado atual do trabalhador. Tipo de dados: Objeto `state: { display_value: "String", value: Number }`
state.display_value	Valor de exibição do estado do trabalhador. Esses valores se correlacionam diretamente ao state.valueparâmetro. Valores possíveis: Concluídas Erro Em progresso Aguardando Tipo de dados: Cadeia de caracteres
state.value	Valor numérico do estado do trabalhador. Valores possíveis: 1 2 3 4 Tipo de dados: Número
tipo	Tipo de solicitação. Valor válido: Programação Tipo de dados: Cadeia de caracteres
trabalhador	Informações sobre o trabalhador associado. Tipo de dados: Objeto `"worker": { "link": "String", "sysId": "String" }`
worker.link	Link para recuperar o status da programação de solicitação de mudança. Use o sys_id em OBTENHA /sn_chg_rest/change/worker/ para exibir os resultados. Tipo de dados: Cadeia de caracteres
Worker.SYSID	Sys_id do trabalhador associado à solicitação de mudança. Tipo de dados: Cadeia de caracteres
status	Aparece somente se um erro for encontrado. Status do processamento do endpoint. Valor possível: Falha Tipo de dados: Cadeia de caracteres

Obter status de programação de solicitação de mudança

Use o valor fornecido em worker.linkdeterminar se o registro de mudança foi programado com sucesso para o primeiro intervalo de tempo disponível. O valor está no seguinte formato:

https://instance.service-now.com/api/sn_chg_rest/change/worker/<worker_sys_id>

Use os detalhes worker.link para executar o sys_id fornecido em OBTENHA /sn_chg_rest/change/worker/ para exibir os resultados.

O corpo da resposta contém o status e fornece resultados quando o processamento é concluído.

Se um intervalo de tempo disponível for encontrado, o sistema atualizará a solicitação de mudança com o primeiro intervalo disponível. Quando o estado estiver concluído, o messages.infoMessagesrevela que o primeiro intervalo de tempo disponível foi definido.

Um dos seguintes valores de resposta de programação para messages.infoMessagessão fornecidos no corpo da resposta:

A mudança foi atualizada – A mudança solicitada foi atualizada para o intervalo de tempo.
Nenhum slot encontrado para dias de <number> a partir de agora - Nenhum intervalo de tempo disponível para a duração da solicitação de mudança fornecido dentro do número de dias definido na janela de programação.
Nota:
O valor padrão do intervalo de tempo de programação de solicitação de mudança é 90 dias. Para mudar este valor, modifique o. change.conflict.next_available.schedule_windowpropriedade. Para obter mais informações, consulte Configure propriedades de análise de conflito .

A seguir OBTENHA /sn_chg_rest/change/worker/ O exemplo mostra a saída fornecida usando o ID fornecido no detalhe worker.link. Os resultados indicam que o processamento está concluído e que a solicitação de mudança foi atualizada com o primeiro intervalo de tempo disponível.

{
  "result": {
    "worker": {
      "sysId": "355c62e0a4c87010f87712198fe9cacf",
      "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/355c62e0a4c87010f87712198fe9cacf"
    },
    "request": "{\"change_sys_id\":\"87ae5e900a0a2c3e263e8304e727c646\",\"duration_in_seconds\":10800,\"timezone\":\"America/Los_Angeles\"}",
    "state": {
      "value": 3,
      "display_value": "Complete"
    },
    "type": "schedule",
    "messages": {
      "errorMessages": [],
      "warningMessages": [],
      "infoMessages": [
        "Change has been updated"
      ]
    }
  }
}

Solicitação de curl

curl "https://instance.service-now.com/api/sn_chg_rest/change/87ae5e900a0a2c3e263e8304e727c646/schedule/first_available" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{\"duration_in_seconds\":\"10800\"}" \
--user "username":"password"

Os resultados incluem detalhes worker.link que você pode usar para executar o sys_id fornecido no endpoint GET /sn_chg_rest/change/worker/.

{
  "result": {
    "worker": {
      "sysId": "355c62e0a4c87010f87712198fe9cacf",
      "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/355c62e0a4c87010f87712198fe9cacf"
    },
    "request": "{\"change_sys_id\":\"87ae5e900a0a2c3e263e8304e727c646\",\"duration_in_seconds\":10800,\"timezone\":\"America/Los_Angeles\"}",
    "state": {
      "value": 1,
      "display_value": "Waiting"
    },
    "type": "schedule",
    "messages": {
      "errorMessages": [],
      "warningMessages": [],
      "infoMessages": []
    }
  }
}

Gestão de mudanças - PATCH /sn_chg_rest/change//task/ task/ task_sys_id

Atualiza a tarefa de solicitação de mudança identificada pelos sys_ids especificados com os pares de chave-valor no corpo da solicitação ou na URL.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change//change//task/ task/ task_sys_id

URL padrão: /api/sn_chg_rest/change//task/ task/ task_sys_id

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 169. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
change_sys_id	Sys_id da solicitação de mudança à qual a tarefa está associada. Verifica se a tarefa especificada está associada à solicitação de mudança especificada. Tipo de dados: Cadeia de caracteres Tabela: solicitação de mudança [change_request]
task_sys_id	Sys_id da tarefa a ser modificada. Tipo de dados: Cadeia de caracteres Tabela: Tarefa de mudança [change_task]

Tabela 170. Parâmetros de consulta
Nome	Descrição
pares de chave-valor	Pares nome-valor que representam os campos a serem atualizados. Os parâmetros do corpo da solicitação substituem os parâmetros de URL. No entanto, os parâmetros obrigatórios devem ser especificados no URL. Tipo de dados: Cadeia de caracteres

Tabela 171. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
dados	Pares nome-valor que representam os campos a serem atualizados na solicitação de mudança associada. Por exemplo, para atualizar o arquivo de descrição resumida, insira um par nome-valor semelhante ao seguinte: `"short_description": "my short description""` . Tipo de dados: Cadeia de caracteres

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 .

Tabela 172. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json
Tipo de conteúdo	Formato de dados do corpo da solicitação. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 173. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 174. Códigos de status
Código do status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. Não foi possível encontrar o registro especificado.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
pares nome-valor	Todos os campos (chave) com seus valores associados para a tarefa de solicitação de mudança identificada antes da exclusão. Tipo de dados: Objeto
sys_id	Informações de sys_id para a tarefa de solicitação de mudança. Tipo de dados: Objeto `sys_id: { display_value: "String", value: "String" }`
sys_id.display_value	Sys_id da tarefa de solicitação de mudança a ser exibida em uma IU. Tipo de dados: Cadeia de caracteres
sys_id.value	Sys_id da tarefa de solicitação de mudança. Tipo de dados: Cadeia de caracteres
primário	Informações de identificador exclusivo da solicitação de mudança associada a esta tarefa. Tipo de dados: Objeto `parent: { display_value: "String", value: "String" }`
parent.display_value	Informações da tarefa a serem exibidas em uma IU. Tipo de dados: Cadeia de caracteres
valor.primário	Sys_id da tarefa primária. Tipo de dados: Cadeia de caracteres
__meta.ignoredFields	Pares de chave-valor que foram passados na chamada, mas não foram aplicados à solicitação de mudança, pois não existem no registro de base ou os campos são somente leitura. Tipo de dados: Matriz

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/task/12629ec4b750230096c3e4f6ee11a9d5?short_description=Retire both nodes" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type: application/json" \
--data "{\"state\": \"assess\", \"no_such_field\": \"this will be ignored\" }" \
--user "username":"password"

{
  result: [
    {
      sys_id: {
        value: "12629ec4b750230096c3e4f6ee11a9d5",
        display_value: "12629ec4b750230096c3e4f6ee11a9d5"
      },
      parent: {
        value: "0f4ac6c4b750230096c3e4f6ee11a9fe", 
        display_value: "CHG0033046 "
      },
      ..., // all valid fields in record, example below
      short_description: {
        value: "Retire both nodes",
        display_value: "Retire both nodes"
      }
      __meta: {
        ignoredFields: ["no_such_field"]
      }
    }
  ]
}

Gestão de mudanças - PATCH /sn_chg_rest/change/emergency/

Atualiza a solicitação de mudança de emergência identificada pelo sys_id especificado com os pares de chave-valor no corpo da solicitação ou na URL.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/emergency/ sys_id

URL padrão: /api/sn_chg_rest/change/emergency/

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 175. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id da solicitação de mudança a ser modificada. Tipo de dados: Cadeia de caracteres Tabela: solicitação de mudança [change_request]

Tabela 176. Parâmetros de consulta
Nome	Descrição
pares nome-valor	Pares nome-valor que representam os campos a serem atualizados. Os parâmetros do corpo da solicitação substituem os parâmetros de URL. No entanto, os parâmetros obrigatórios devem ser especificados no URL. Tipo de dados: Cadeia de caracteres

Tabela 177. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
dados	Pares nome-valor que representam os campos a serem atualizados na solicitação de mudança associada. Por exemplo, para atualizar o arquivo de descrição resumida, insira um par nome-valor semelhante ao seguinte: `"short_description": "my short description""` . Tipo de dados: Cadeia de caracteres

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 .

Tabela 178. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json
Tipo de conteúdo	Formato de dados do corpo da solicitação. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 179. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 180. Códigos de status
Código do status	Descrição
200	Solicitação concluída com sucesso.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. Não foi possível encontrar o registro especificado.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
pares nome-valor	Valores para todos os campos na solicitação de mudança associada. Tipo de dados: Cadeia de caracteres
estado	Estado atual da solicitação de mudança. Tipo de dados: Objeto `state: { display_value: "String", value: "String" }`
state.display_value	Estado a ser exibido em uma IU. Tipo de dados: Cadeia de caracteres
state.value	Valor do estado interno. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id da solicitação de mudança. Tipo de dados: Cadeia de caracteres
tipo	Tipo de solicitação de mudança Tipo de dados: Objeto `type: { display_value: "String", value: "String" }`
type.display_value	Altere o tipo a ser exibido em uma IU. O valor é sempre "Emergência". Tipo de dados: Cadeia de caracteres
type.value	Valor do tipo interno. O valor é sempre "emergência". Tipo de dados: Cadeia de caracteres
__meta.ignoredFields	Pares nome-valor que foram passados na chamada, mas não foram aplicados à solicitação de mudança, pois não existem no registro de base ou os campos são somente leitura. Tipo de dados: Matriz

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/emergency/b0dbda5347c12200e0ef563dbb9a718f" \
--request PATCH \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--data "{\"no_such_field\": \"this will be ignored\", }" \
--user "username":"password"

{
  result: [
    {
      sys_id: "b0dbda5347c12200e0ef563dbb9a718f",    },
      state: {
        value: "-4", 
        display_value: "Assess"
      },
      type: {
        value: "emergency",
        display_value: "Emergency"
      },
      ..., // all valid fields in record, example below
      short_description: {
        value: "Reboot server",
        display_value: "Reboot server"
      }
      __meta: {
        ignoredFields: ["no_such_field"]
      }
    }
  ]
}

Gestão de mudanças - PATCH /sn_chg_rest/change/normal/

Atualiza a solicitação de mudança normal identificada pelo sys_id especificado com os parâmetros no corpo da solicitação ou na URL.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/normal/ sys_id

URL padrão: /api/sn_chg_rest/change/normal/

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 181. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id da solicitação de mudança a ser modificada. Tipo de dados: Cadeia de caracteres Tabela: solicitação de mudança [change_request]

Tabela 182. Parâmetros de consulta
Nome	Descrição
pares nome-valor	Pares nome-valor que representam os campos a serem atualizados. Os parâmetros do corpo da solicitação substituem os parâmetros de URL. No entanto, os parâmetros obrigatórios devem ser especificados no URL. Tipo de dados: Cadeia de caracteres

Tabela 183. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
dados	Pares nome-valor que representam os campos a serem atualizados na solicitação de mudança associada. Por exemplo, para atualizar o arquivo de descrição resumida, insira um par nome-valor semelhante ao seguinte: `"short_description": "my short description""` . Tipo de dados: Cadeia de caracteres

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 .

Tabela 184. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json
Tipo de conteúdo	Formato de dados do corpo da solicitação. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 185. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 186. Códigos de status
Código do status	Descrição
200	Solicitação concluída com sucesso.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. Não foi possível encontrar o registro especificado.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
pares nome-valor	Valores para todos os campos na solicitação de mudança associada. Tipo de dados: Objeto
estado	Estado atual da solicitação de mudança. Tipo de dados: Objeto `state: { display_value: "String", value: "String" }`
state.display_value	Estado a ser exibido em uma IU. Tipo de dados: Cadeia de caracteres
state.value	Valor do estado interno. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id da solicitação de mudança. Tipo de dados: Cadeia de caracteres
tipo	Tipo de solicitação de mudança Tipo de dados: Objeto `type: { display_value: "String", value: "String" }`
type.display_value	Altere o tipo a ser exibido em uma IU. O valor é sempre "Normal". Tipo de dados: Cadeia de caracteres
type.value	Valor do tipo interno. O valor é sempre "Normal". Tipo de dados: Cadeia de caracteres
__meta.ignoredFields	Pares nome-valor que foram passados na chamada, mas não foram aplicados à solicitação de mudança, pois não existem no registro de base ou os campos são somente leitura. Tipo de dados: Matriz

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/normal/b0dbda5347c12200e0ef563dbb9a718f?state=assess" \
--request PATCH \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--data "{\"state\": \"assess\", \"no_such_field\": \"this will be ignored\" }" \
--user "username":"password"

{
  result: [
    {
      sys_id: "b0dbda5347c12200e0ef563dbb9a718f",
      state: {
        value: "-4", 
        display_value: "Assess"
      },
      type: {
        value: "normal",
        display_value: "Normal"
      },
      ..., // all valid fields in record, example below
      short_description: {
        value: "Remove server",
        display_value: "Remove server"
      }
      __meta: {
        ignoredFields: ["no_such_field"]
      }
    }
  ]
}

Gestão de mudanças - PATCH /sn_chg_rest/change/standard/

Atualiza a solicitação de mudança padrão identificada pelo sys_id especificado com os parâmetros no corpo da solicitação ou na URL.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/standard/ sys_id

URL padrão: /api/sn_chg_rest/change/standard/

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 187. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id da solicitação de mudança a ser modificada. Tipo de dados: Cadeia de caracteres Tabela: solicitação de mudança [change_request]

Tabela 188. Parâmetros de consulta
Nome	Descrição
pares nome-valor	Pares nome-valor que representam os campos a serem atualizados. Os parâmetros do corpo da solicitação substituem os parâmetros de URL. No entanto, os parâmetros obrigatórios devem ser especificados no URL. Tipo de dados: Cadeia de caracteres

Tabela 189. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
dados	Pares nome-valor que representam os campos a serem atualizados na solicitação de mudança associada. Por exemplo, para atualizar o arquivo de descrição resumida, insira um par nome-valor semelhante ao seguinte: `"short_description": "my short description""` . Tipo de dados: Cadeia de caracteres

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 .

Tabela 190. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json
Tipo de conteúdo	Formato de dados do corpo da solicitação. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 191. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 192. Códigos de status
Código do status	Descrição
200	Solicitação concluída com sucesso.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. Não foi possível encontrar o registro especificado.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
pares nome-valor	Todos os campos (chave) com os valores associados à solicitação de mudança identificada. Tipo de dados: Objeto
estado	Estado da solicitação de mudança. Tipo de dados: Objeto `state: { display_value: "String", value: "String" }`
state.display_value	Estado a ser exibido em uma IU. Tipo de dados: Cadeia de caracteres
state.value	Valor do estado interno. Tipo de dados: Cadeia de caracteres
sys_id	Informações de sys_id para a solicitação de mudança. Tipo de dados: Objeto `sys_id: { display_value: "String", value: "String" }`
sys_id.display_value	Sys_id da solicitação de mudança a ser distribuída em uma IU. Tipo de dados: Cadeia de caracteres
sys_id.value	Sys_id da solicitação de mudança. Tipo de dados: Cadeia de caracteres

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/standard/1c87925347c12200e0ef563dbb9a7177?description=Reboot my email server" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{\"short_description\": \"my short desc\" }" \
--user "username":"password"

{
  result: [
    {
      sys_id: {
        value: "1c87925347c12200e0ef563dbb9a7177",
        display_value: "1c87925347c12200e0ef563dbb9a7177"
      },
      state: {
        value: "-5", 
        display_value: "New"
      },

      ..., // all valid fields in record, example below
      short_description: {
        value: "Reboot my email server",
        display_value: "Reboot my email server"
      },
    } 
  ]
}

Gestão de mudanças - PATCH /sn_chg_rest/change/standard/

Calcula o risco e o impacto da mudança padrão especificada com base em uma avaliação das condições de risco.

Se o plug-in Avaliação de risco de mudança estiver instalado, ele também calculará o risco cumulativo mais alto depois que a avaliação de risco for concluída.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/ sys_id/risk

URL padrão: /api/sn_chg_rest/change//sys_id/risk

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 193. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id da mudança padrão a ser avaliada. Tipo de dados: Cadeia de caracteres Tabela: solicitação de mudança [change_request]

Tabela 194. Parâmetros de consulta
Nome	Descrição
Nenhum(a)

Tabela 195. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 196. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 197. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 198. Códigos de status
Código do status	Descrição
200	Avaliação de risco concluída com sucesso.
400	Falha na avaliação de risco. Os detalhes do tipo de falha estão incluídos nos dados de erro.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. O item solicitado não foi encontrado.
500	Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
impacto	Impacto associado à mudança padrão especificada. Tipo de dados: Objeto `impact: { display_value: "String", value: "String" }`
impact.display_value	Informações de impacto a serem exibidas em uma IU. Tipo de dados: Cadeia de caracteres
valor.impacto	Valor do impacto interno. Tipo de dados: Cadeia de caracteres
pares nome-valor	Todos os campos válidos no registro de mudança padrão. Tipo de dados: Objeto
risco	Risco calculado para a mudança padrão especificada. Tipo de dados: Objeto `risk: { display_value: "String", value: "String" }`
risco.display_value	Informações de risco a serem exibidas em uma IU. Tipo de dados: Cadeia de caracteres
risco.valor	Valor de risco interno. Tipo de dados: Cadeia de caracteres
sys_id	Informações de sys_id para a solicitação de mudança padrão. Tipo de dados: Objeto `sys_id: { display_value: "String", value: "String" }`
sys_id.display_value	Sys_id da solicitação de mudança a ser exibida em uma IU. Tipo de dados: Cadeia de caracteres
sys_id.value	Sys_id da solicitação de mudança. Tipo de dados: Cadeia de caracteres

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/1c87925347c12200e0ef563dbb9a7177/risk" \
--request PATCH \
--header "Accept:application/json" \
--user "username":"password"

{
  sys_id: {
    value: "1c87925347c12200e0ef563dbb9a7177",
    display_value: "1c87925347c12200e0ef563dbb9a7177"
  },
  risk: {
    value: "4", 
    display_value: "Low"
  },
  impact: {
    value: "3",
    display_value: "3 - Low"
  }
  ..., // all valid fields in record
}

Gestão de mudanças - POST /sn_chg_rest/change

Cria um registro de solicitação de mudança com base na solicitação de mudança. A criação de várias solicitações de mudança em uma única chamada não é compatível.

Você pode obter a lista de modelos de mudança disponíveis usando Gestão de mudanças - OBTENHA /sn_chg_rest/change/model ou Gestão de mudanças - OBTENHA /sn_chg_rest/change/model/ endpoints.

Ao criar uma solicitação de mudança, defina o modelo de mudança ( chg_modelou type. Se ambos chg_modele. type, o tipo é simplesmente uma categorização da mudança. Não fornecer pelo menos um desses valores resulta em uma configuração padrão que está sujeita a mudanças por versão. É altamente recomendável definir pelo menos um desses valores.

Os valores podem ser definidos como um parâmetro de consulta ou como parâmetro de corpo da solicitação.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change

URL padrão: /api/sn_chg_rest/change

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 199. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres

Tabela 200. Parâmetros de consulta
Nome	Descrição
pares nome-valor	Pares nome-valor que representam os campos a serem atualizados. Os parâmetros do corpo da solicitação substituem os parâmetros de URL. No entanto, os parâmetros obrigatórios devem ser especificados no URL. Em vez disso, os mesmos valores podem ser definidos como parâmetros do corpo da solicitação. Nota: Ao criar uma solicitação de mudança, defina o modelo de mudança ( chg_modelou type. Se ambos chg_modele. type, o tipo é simplesmente uma categorização da mudança. Não fornecer pelo menos um desses valores resulta em uma configuração padrão que está sujeita a mudanças por versão. É altamente recomendável definir pelo menos um desses valores. Tipo de dados: Cadeia de caracteres
chg_model	Nome de um modelo de mudança listado na tabela Modelo de mudança [chg_model]. Fornecido no seguinte formato: `chg_model: Normal` . Para obter mais informações, consulte Modelos de mudança . Nota: Não fornecer o modelo de mudança ( chg_modelou typeo valor resulta em uma configuração padrão que está sujeita a mudanças por versão. É altamente recomendável definir pelo menos um desses valores. Tipo de dados: Cadeia de caracteres
encrypted_fields	Lista de campos separados por vírgulas a serem criptografados. Esses campos são criptografados antes de serem armazenados no registro associado. Quando especificado, o endpoint chama o GlideRecord DisplayValue() , em vez de chamar SetValue() método. Por isso, você também pode usar esse parâmetro para passar valores de exibição para campos não criptografados, como campos de referência ou de opção, em vez de passar sys_ids ou valores. Tipo de dados: Cadeia de caracteres
tipo	Nome do tipo de solicitação de mudança listado na tabela Escolhas [sys_choice]. . chg_modeltambém está preenchido, este campo é usado somente como uma categorização de mudança. Fornecido no seguinte formato: `Normal` . Para obter mais informações, consulte Adicione um novo tipo de solicitação de mudança . Nota: Não fornecer o modelo de mudança ( chg_modelou typeo valor resulta em uma configuração padrão que está sujeita a mudanças por versão. É altamente recomendável definir pelo menos um desses valores. Tipo de dados: Cadeia de caracteres

Tabela 201. Solicitar parâmetros do corpo (JSON)
Nome	Descrição
Objeto	Pares nome-valor que representam os campos a serem atualizados na solicitação de mudança associada. Por exemplo, para atualizar o arquivo de descrição resumida, insira um par nome-valor semelhante ao seguinte: `"short_description": "my short description""` . Em vez disso, as mesmas propriedades podem ser definidas como parâmetros de consulta. Tipo de dados: Cadeia de caracteres
Object.chg_model	Nome de um modelo de mudança listado na tabela Modelo de mudança [chg_model]. Fornecido como um par nome-valor no seguinte formato: `"Chg_model": "Infraestrutura em nuvem"` Para obter mais informações, consulte Modelos de mudança . Nota: Não fornecer o modelo de mudança ( chg_modelou typeo valor resulta em uma configuração padrão que está sujeita a mudanças por versão. É altamente recomendável definir pelo menos um desses valores. Tipo de dados: Cadeia de caracteres
Object.encrypted_fields	Lista de campos separados por vírgulas a serem criptografados. Esses campos são criptografados antes de serem armazenados no registro associado. Quando especificado, o endpoint chama o GlideRecord DisplayValue() , em vez de chamar SetValue() método. Por isso, você também pode usar esse parâmetro para passar valores de exibição para campos não criptografados, como campos de referência ou de opção, em vez de passar sys_ids ou valores. Tipo de dados: Cadeia de caracteres
Object.type	Nome do tipo de solicitação de mudança listado na tabela Escolhas [sys_choice]. . chg_modeltambém está preenchido, este campo é usado somente como uma categorização de mudança. Fornecido como um par nome-valor no seguinte formato: `"tipo": "emergência"` Para obter mais informações, consulte Adicione um novo tipo de solicitação de mudança . Nota: Não fornecer o modelo de mudança ( chg_modelou typeo valor resulta em uma configuração padrão que está sujeita a mudanças por versão. É altamente recomendável definir pelo menos um desses valores. Tipo de dados: Cadeia de caracteres

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 .

Tabela 202. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json
Tipo de conteúdo	Formato de dados do corpo da solicitação. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 203. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 204. Códigos de status
Código do status	Descrição
200	Solicitação concluída com sucesso.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. Não foi possível encontrar o registro especificado.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
resultado	Novo registro de solicitação de mudança. Os elementos deste objeto correspondem ao formato de registro na tabela Solicitação de mudança [change_request]. Todos os valores não especificados na solicitação são definidos com seus padrões ou estão vazios/nulos. Tipo de dados: Objeto

Solicitação de curl

O exemplo a seguir mostra como criar um registro de solicitação de mudança com base no modelo de mudança padrão e no tipo padrão. Neste exemplo, a solicitação de mudança é orientada pelo modelo e o campo de tipo é usado somente como uma categorização.

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
    \"chg_model\" : \"Standard\",
    \"description\" : \"Describes the change request.\",
    \"short_description\" : \"My change request\",
    \"type\" : \"Standard\"
}" \
--user "username":"password"

Os resultados mostram que o registro foi adicionado com sucesso à tabela Solicitação de mudança [change_request] com o valor CHG0030022 .

{
  "result": 
    "upon_reject": {
      "display_value": "Cancel all future Tasks",
      "value": "cancel"
    },
    "sys_updated_on": {
      "display_value": "2022-12-08 17:18:57",
      "value": "2022-12-09 01:18:57",
      "display_value_internal": "2022-12-08 17:18:57"
    },
    "type": {
      "display_value": "Standard",
      "value": "standard"
    }
    "number": {
      "display_value": "CHG0030022",
      "value": "CHG0030022"
    },
    "is_bulk": {
      "display_value": "false",
      "value": false
    }
    "ci_class": {
      "display_value": "cmdb_ci",
      "value": "cmdb_ci"
    },
    "state": {
      "display_value": "New",
      "value": -5
    },
    "sys_created_by": {
      "display_value": "admin",
      "value": "admin"
    },
    "knowledge": {
      "display_value": "false",
      "value": false
    },
    "phase": {
      "display_value": "Requested",
      "value": "requested"
    }
    "impact": {
      "display_value": "3 - Low",
      "value": 3
    },
    "active": {
      "display_value": "true",
      "value": true
    },
    "priority": {
      "display_value": "4 - Low",
      "value": 4
    },
    "sys_domain_path": {
      "display_value": "/",
      "value": "/"
    },
    "production_system": {
      "display_value": "false",
      "value": false
    },
    "requested_by": {
      "display_value": "System Administrator",
      "value": "6816f79cc0a8016401c5a33be04be441"
    }
    "short_description": {
      "display_value": "My change request",
      "value": "My change request"
    },
    "sys_class_name": {
      "display_value": "Change Request",
      "value": "change_request"
    },
    "reassignment_count": {
      "display_value": "0",
      "value": 0
    },
    "variables": {
      "display_value": "variable_pool",
      "value": "variable_pool"
    },
    "sla_due": {
      "display_value": "UNKNOWN",
      "value": "",
      "display_value_internal": ""
    },
    "escalation": {
      "display_value": "Normal",
      "value": 0
    },
    "upon_approval": {
      "display_value": "Proceed to Next Task",
      "value": "proceed"
    },
    "conflict_status": {
      "display_value": "Not Run",
      "value": "Not Run"
    },
    "task_effective_number": {
      "display_value": "CHG0030022",
      "value": "CHG0030022"
    },
    "sys_updated_by": {
      "display_value": "admin",
      "value": "admin"
    },
    "opened_by": {
      "display_value": "System Administrator",
      "value": "6816f79cc0a8016401c5a33be04be441"
    },
    "sys_created_on": {
      "display_value": "2022-12-08 17:18:57",
      "value": "2022-12-09 01:18:57",
      "display_value_internal": "2022-12-08 17:18:57"
    },
    "sys_domain": {
      "display_value": "global",
      "value": "global"
    },
    "chg_model": {
      "display_value": "Standard",
      "value": "e55d0bfec343101035ae3f52c1d3ae49"
    },
    "opened_at": {
      "display_value": "2022-12-08 17:18:57",
      "value": "2022-12-09 01:18:57",
      "display_value_internal": "2022-12-08 17:18:57"
    },
    "description": {
      "display_value": "Describes the change request.",
      "value": "Describes the change request."
    },
    "sys_id": {
      "display_value": "2ac52dd77c6b1510f877be3b096e64fe",
      "value": "2ac52dd77c6b1510f877be3b096e64fe"
    },
    "cab_required": {
      "display_value": "false",
      "value": false
    },
    "urgency": {
      "display_value": "3 - Low",
      "value": 3
    },
    "scope": {
      "display_value": "Medium",
      "value": 3
    },
    "activity_due": {
      "display_value": "UNKNOWN",
      "value": "",
      "display_value_internal": ""
    },
    "approval": {
      "display_value": "Not Yet Requested",
      "value": "not requested"
    },
  }
}

Solicitação de curl

O exemplo a seguir mostra como passar campos criptografados no corpo da solicitação.

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
    \"encrypted_fields\":\"short_description,description\",
    \"short_description\":\"my short desc\",
    \"description\":\"my desc\"
}" \
--user "username":"password"

Solicitação de curl

O exemplo a seguir mostra como passar campos criptografados como parâmetros de consulta.

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change?encrypted_fields=short_description%2Cdescription&short_description=my%20short%20desc&description=my%20desc" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{}" \
--user "username":"password"

Gestão de mudanças - POST /sn_chg_rest/change/

Cria a associação entre uma solicitação de mudança e Configuration Management Database (CMDB) Itens de configuração (IC).

A criação da associação é feita de forma assíncrona, o que significa que uma resposta é fornecida imediatamente e contém detalhes para o trabalhador. O trabalhador faz o trabalho real após a resposta.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/ sys_id/ci

URL padrão: /api/sn_chg_rest/change//sys_id/ci

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 205. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id da solicitação de mudança a ser associada ao IC do CMDB. Tipo de dados: Cadeia de caracteres

Tabela 206. Parâmetros de consulta
Nome	Descrição
Nenhum(a)

Tabela 207. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
association_type	Obrigatório. Tipo de associação entre o IC do CMDB e a solicitação de mudança. Valores válidos: Afetados: ICs afetados pela solicitação de mudança Afetados: Serviços afetados pela solicitação de mudança Oferta: Ofertas de serviço afetadas Tipo de dados: Cadeia de caracteres
cmdb_ci_sys_ids	Obrigatório. Lista de sys_ids de IC do CMDB a serem associados à solicitação de mudança. Tipo de dados: Cadeia de caracteres separada por vírgulas ou matriz
refresh_impacted_services	Sinalizador usado quando `association_type: afetado` Preencher os serviços afetados com base na lista de ICs afetados. Valores válidos: Verdadeiro: Preencha os serviços afetados com base na lista de ICs afetados Falso: Não preencha automaticamente os serviços afetados Tipo de dados: Booliano Padrão: falso

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 .

Tabela 208. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json
Tipo de conteúdo	Formato de dados do corpo da solicitação. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 209. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 210. Códigos de status
Código do status	Descrição
202	Aceito. A solicitação foi aceita para processamento.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada. A resposta do erro contém mensagens pertinentes para ajudar a solucionar o problema.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. O item solicitado não foi encontrado.
500	Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
mensagens	Informações da mensagem. Tipo de dados: Objeto `"messages": { "errorMessages": [Array], "infoMessages": [Array], "warningMessages": [Array] }`
Messages.erroMessages	Mensagens de erro encontradas ao processar a solicitação. Por exemplo: Cmdb_ci sys_id inválido fornecido Tipo de dados: Matriz
messages.infoMessages	Mensagens de informação encontradas durante o processamento da solicitação. Por exemplo: Cmdb_ci sys_id já associado ao fornecido. Tipo de dados: Matriz
Messages.warningMessages	Mensagens de aviso encontradas durante o processamento da solicitação. Por exemplo: Cmdb_ci sys_id inválido fornecido. Tipo de dados: Matriz
solicitação	Solicitação de endpoint original. Tipo de dados: Cadeia de caracteres
estado	Informações sobre o estado atual do trabalhador. `state: { display_value: "String", value: "String" }`
state.display_value	Valor de exibição do estado do trabalhador. Esses valores se correlacionam diretamente ao state.valueelemento. Valores possíveis: Concluídas Erro Em progresso Aguardando Tipo de dados: Cadeia de caracteres
state.value	Valor numérico do estado do trabalhador. Valores possíveis: 1 2 3 4 Tipo de dados: Número
tipo	Tipo de associação entre o IC do CMDB e a solicitação de mudança. Tipo de dados: Cadeia de caracteres
trabalhador	Informações sobre o trabalhador associado. Tipo de dados: Objeto `"worker": { "link": "String", "sysId": "String" }`
worker.link	URL para recuperar o status do trabalhador associado e outras informações pertinentes do trabalhador. Tipo de dados: Cadeia de caracteres
Worker.SYSID	Sys_id do trabalhador associado à solicitação de mudança. Tipo de dados: Cadeia de caracteres

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/c286d61347c12200e0ef563dbb9a71df/ci" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{cmdb_ci_sys_ids:'caf043a3b7fb23000999e4f6ee11a9c0,06f043a3b7fb23000999e4f6ee11a9c1', association_type:'affected'}" \
--user "username":"password"

{
  "result": {
    "worker": {
      "sysId": "f490f4c6dbac330084f07ffdbf961952",
      "link": "instance.service-now.com/api/sn_chg_rest/change/worker/f490f4c6dbac330084f07ffdbf961952"
    },
    "request": "{\"cmdb_ci_sys_ids\":[\"caf043a3b7fb23000999e4f6ee11a9c0\",\"06f043a3b7fb23000999e4f6ee11a9c1\"],\"association_type\":\"affected\",\"task\":\"c286d61347c12200e0ef563dbb9a71df\"}",
    "state": {
      "value": 1,
      "display_value": "Waiting"
    },
    "type": "affected",
    "messages": {
      "errorMessages": [],
      "warningMessages": [],
      "infoMessages": []
    }
  }
}

Gestão de mudanças - POST /sn_chg_rest/change/

Inicia um processo de verificação de conflito de solicitação de mudança para a solicitação de mudança especificada (sys_id).

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/ sys_id/conflict

URL padrão: /api/sn_chg_rest/change//sys_id/conflict

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 211. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id da solicitação de gestão de mudanças para a qual iniciar o processo de verificação de conflitos. Para obter informações adicionais sobre o processo de verificação de conflitos, consulte Detecção de conflitos . Tipo de dados: Cadeia de caracteres Tabela: solicitação de mudança [change_request]

Tabela 212. Parâmetros de consulta
Nome	Descrição
Nenhum(a)

Tabela 213. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 214. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 215. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 216. Códigos de status
Código do status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação Incorreta. A solicitação não pôde ser iniciada devido a erros não resolvidos. A mensagem retornada pode fornecer detalhes adicionais.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. O item solicitado não foi encontrado.
500	Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
resultado	Sys_id do processo de verificação de conflito de solicitação de mudança. Tipo de dados: Cadeia de caracteres

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/conflict" \
--request POST \
--header "Accept:application/json" \
--user "username":"password"

{
    result: "c0b5afe4b710230096c3e4f6ee11a93f"
}

Gestão de mudanças - POST /sn_chg_rest/change/emergency

Cria uma solicitação de mudança de emergência com base no registro de solicitação de mudança de emergência padrão. Várias criações de solicitação de mudança de emergência em uma única chamada não são compatíveis.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/emergency

URL padrão: /api/sn_chg_rest/change/emergency

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 217. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres

Tabela 218. Parâmetros de consulta
Nome	Descrição
pares de chave-valor	Pares de chave-valor de campos a serem modificados ao criar a solicitação. A chave é o nome do campo no modelo e o valor são as informações a serem preenchidas no campo. Campos que não podem ser modificados e são ignorados se passados: Regras de negócio Campos somente leitura, conforme definido em ACLs Campos que não existem Tipo de dados: Cadeia de caracteres

Tabela 219. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 220. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 221. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 222. Códigos de status
Código do status	Descrição
200	Solicitação concluída com sucesso.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
pares nome-valor	Pares nome-valor dos campos que foram criados na solicitação de mudança de emergência. Tipo de dados: Objeto
estado	Estado da solicitação de mudança antes da exclusão. Tipo de dados: Objeto `state: { display_value: "String", value: "String" }`
state.display_value	Estado a ser exibido em uma IU. O valor é sempre "Novo". Tipo de dados: Cadeia de caracteres
state.value	Valor do estado interno. O valor é sempre "-5". Tipo de dados: Cadeia de caracteres
sys_id	Sys_id da solicitação de mudança de emergência recém-criada. Tipo de dados: Cadeia de caracteres
tipo	Tipo de solicitação de mudança Tipo de dados: Objeto `type: { display_value: "String", value: "String" }`
type.display_value	Altere o tipo a ser exibido em uma IU. O valor é sempre "Emergência". Tipo de dados: Cadeia de caracteres
type.value	Valor do tipo interno. O valor é sempre "emergência". Tipo de dados: Cadeia de caracteres
__meta.ignoredFields	Pares de chave-valor que foram passados na chamada, mas não foram aplicados à solicitação de mudança, pois não existem no registro de base ou os campos são somente leitura. Tipo de dados: Matriz

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/emergency?no_such_field=something&description=test&short_description=Reboot server" \
--request POST \
--header "Accept:application/json" \
--user "username":"password"

{
  result: [
    {
      sys_id: "b0dbda5347c12200e0ef563dbb9a718f",
      state: {
        value: "-5", 
        display_value: "New"
      },
      type: {
        value: "emergency",
        display_value: "Emergency"
      },
      ..., // all valid fields in record, example below
      short_description: {
        value: "Reboot server",
        display_value: "Reboot server"
      }
      __meta: {
        ignoredFields: ["no_such_field"]
      }
    }
  ]
}

Gestão de mudanças - POST /sn_chg_rest/change/normal

Cria uma solicitação de mudança normal com base no registro de solicitação de mudança normal padrão. Várias criações normais de solicitação de mudança em uma única chamada não são compatíveis.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/normal

URL padrão: /api/sn_chg_rest/change/normal

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 223. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres

Tabela 224. Parâmetros de consulta
Nome	Descrição
pares de chave-valor	Campos a serem modificados ao criar a solicitação. A chave é o nome do campo no modelo e o valor são as informações a serem preenchidas no campo. Campos que não podem ser modificados e são ignorados se passados: Regras de negócio Campos somente leitura, conforme definido em ACLs Campos que não existem Tipo de dados: Cadeia de caracteres

Tabela 225. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 226. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 227. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 228. Códigos de status
Código do status	Descrição
200	Solicitação concluída com sucesso.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
pares nome-valor	Valores para todos os campos na solicitação de mudança associada. Tipo de dados: Objeto
estado	Estado da solicitação de mudança recém-criada. Tipo de dados: Objeto `state: { display_value: "String", value: "String" }`
state.display_value	Estado a ser exibido em uma IU. O valor é sempre "Novo". Tipo de dados: Cadeia de caracteres
state.value	Valor do estado interno. O valor é sempre "-5". Tipo de dados: Cadeia de caracteres
sys_id	Sys_id da solicitação de mudança normal recém-criada. Tipo de dados: Cadeia de caracteres
tipo	Tipo de solicitação de mudança Tipo de dados: Objeto `type: { display_value: "String", value: "String" }`
type.display_value	Altere o tipo a ser exibido em uma IU. O valor é sempre "Normal". Tipo de dados: Cadeia de caracteres
type.value	Valor do tipo interno. O valor é sempre "Normal". Tipo de dados: Cadeia de caracteres
__meta.ignoredFields	Pares de chave-valor que foram passados na chamada, mas não foram aplicados à solicitação de mudança, pois não existem no registro de base ou os campos são somente leitura. Tipo de dados: Matriz

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/normal?no_such_field=something&description=test&short_description=Remove server" \
--request POST \
--header "Accept:application/json" \
--user "username":"password"

{
  result: [
    {
      sys_id: "b0dbda5347c12200e0ef563dbb9a718f",
      state: {
        value: "-5", 
        display_value: "New"
      },
      type: {
        value: "normal",
        display_value: "Normal"
      },
      ..., // all valid fields in record, example below
      short_description: {
        value: "Remove server",
        display_value: "Remove server"
      }
      __meta: {
        ignoredFields: ["no_such_field"]
      }
    }
  ]
}

Gestão de mudanças - POST /sn_chg_rest/change//refresh_impacted_services

Preenche a lista relacionada de serviços/itens de configuração (ICs) afetados com base no IC primário.

O IC primário aparece no formulário Solicitação de mudança e na lista relacionada de ICs afetados.

Nota:

Todos os itens de trabalho para este endpoint são executados de forma assíncrona.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/(sys_id)/refresh_impacted_services

URL padrão: /api/sn_chg_rest/change//refresh_impacted_services

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 229. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id da solicitação de mudança a ser usada para atualizar os serviços afetados. Tipo de dados: Cadeia de caracteres

Tabela 230. Parâmetros de consulta
Nome	Descrição
Nenhum(a)

Tabela 231. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 232. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json
Tipo de conteúdo	Formato de dados do corpo da solicitação. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 233. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 234. Códigos de status
Código do status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. Não foi possível encontrar o registro especificado.
500	Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
mensagens	Informações da mensagem. Tipo de dados: Objeto `"messages": { "errorMessages": [Array], "infoMessages": [Array], "warningMessages": [Array] }`
Messages.erroMessages	Mensagens de erro encontradas ao processar a solicitação. Por exemplo: Cmdb_ci sys_id inválido fornecido Tipo de dados: Matriz
messages.infoMessages	Mensagens de informação encontradas durante o processamento da solicitação. Por exemplo: Cmdb_ci sys_id já associado ao fornecido. Tipo de dados: Matriz
Messages.warningMessages	Mensagens de aviso encontradas durante o processamento da solicitação. Por exemplo: Cmdb_ci sys_id inválido fornecido. Tipo de dados: Matriz
solicitação	Solicitação de endpoint original. Tipo de dados: Cadeia de caracteres
estado	Informações sobre o estado atual do trabalhador. Tipo de dados: Objeto `state: { display_value: "String", value: "String" }`
state.display_value	Valor de exibição do estado do trabalhador. Esses valores se correlacionam diretamente ao state.valueelemento. Valores possíveis: Concluídas Erro Em progresso Aguardando Tipo de dados: Cadeia de caracteres
state.value	Valor numérico do estado do trabalhador. Valores possíveis: 1 2 3 4 Tipo de dados: Número
tipo	Tipo de associação entre o IC do CMDB e a solicitação de mudança. Tipo de dados: Cadeia de caracteres
trabalhador	Informações sobre o trabalhador associado. Tipo de dados: Objeto `"worker": { "link": "String", "sysId": "String" }`
worker.link	URL para recuperar o status do trabalhador associado e outras informações pertinentes do trabalhador. Tipo de dados: Cadeia de caracteres
Worker.SYSID	Sys_id do trabalhador associado à solicitação de mudança. Tipo de dados: Cadeia de caracteres

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/c286d61347c12200e0ef563dbb9a71df/refresh_impacted_services" \ 
--request POST \ 
--header "Accept:application/json" \
--header "Content-Type:application/json" \ 
--user "username":"password"

{ 
  result: { 
    worker: { 
      sysId: "aa31c308b75033000999e4f6ee11a9c2", 
      link: "http://instance.service-now.com/api/sn_chg_rest/change/worker/aa31c308b75033000999e4f6ee11a9c2" 
    }, 
    request: "", 
    state: { 
      value: 1, 
      display_value: "Waiting" 
    }, 
    type: "impacted", 
    messages: { 
      errorMessages: [], 
      warningMessages: [], 
      infoMessages: [] 
    } 
  } 
}

Gestão de mudanças - POST /sn_chg_rest/change/standard/

Cria uma solicitação de mudança padrão com base em um modelo de mudança padrão existente, conforme especificado pelo sys_id do modelo aprovado. Várias criações de solicitação de mudança padrão em uma única chamada não são compatíveis.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/standard/

URL padrão: /api/sn_chg_rest/change/standard/

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 235. Parâmetros de caminho
Parâmetro	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
standard_change_template_id	Sys_id do modelo de mudança padrão no qual basear a nova solicitação de mudança padrão. Tipo de dados: Cadeia de caracteres Tabela: Modelo de mudança padrão [std_change_record_producer]

Tabela 236. Parâmetros de consulta
Parâmetro	Descrição
pares nome-valor	Campos no modelo de mudança padrão especificado a serem modificados ao criar a solicitação. A chave é o nome do campo no modelo e o valor são as informações a serem preenchidas no campo. Campos que não podem ser modificados e são ignorados se passados: Descrição Plano de reversão Plano de testes Plano de implementação Campos somente leitura, conforme definido em ACLs Campos que não existem no modelo de mudança padrão especificado Tipo de dados: Cadeia de caracteres

Tabela 237. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 238. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 239. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

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 .

Tabela 240. Códigos de status
Código do status	Descrição
200	Solicitação concluída com sucesso.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. Não foi possível encontrar o registro especificado.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Corpo da resposta

A API retorna esses elementos JSON ou XML no corpo da resposta.

Tabela 241. Elementos retornados no corpo da resposta
Elemento	Descrição
pares nome-valor	Pares nome-valor dos campos que foram criados na solicitação de mudança padrão. Tipo de dados: Objeto
sys_id	Informações de sys_id da solicitação de mudança padrão recém-criada. Tipo de dados: Objeto `sys_id: { display_value: "String", value: "String" }`
sys_id.display_value	Sys_id da solicitação de mudança padrão a ser exibida em uma IU. Tipo de dados: Cadeia de caracteres
sys_id.value	Sys_id da solicitação de mudança padrão. Tipo de dados: Cadeia de caracteres
__meta.ignoredFields	Pares de chave-valor que foram passados na chamada, mas não foram aplicados à solicitação de mudança, pois não existem no registro de base ou os campos são somente leitura. Tipo de dados: Matriz

Solicitação de cURL de amostra

curl "https://instance.servicenow.com" \
--request POST \
--header "Accept:application/json" \
--user "username":"password"

{
  result: [
    {
      sys_id: {
        value: "1c87925347c12200e0ef563dbb9a7177",
        display_value: "1c87925347c12200e0ef563dbb9a7177"
      },
      ..., // all valid fields in record, example below
      short_description: {
        value: "Add network switch to cabinet",
        display_value: "Add network switch to cabinet"
      }
      __meta: {
        ignoredFields: ["no_such_field"]
      }
    }
  ]
}

Gestão de mudanças - POST /sn_chg_rest/change/

Cria uma tarefa de solicitação de mudança com base no registro de tarefa de solicitação de mudança padrão e a associa à solicitação de mudança especificada. Várias criações de tarefa de solicitação de mudança em uma única chamada não são compatíveis.

Formato de URL

URL com controle de versão: /api/sn_chg_rest//change/(change_sys_id)/task

URL padrão: /api/sn_chg_rest/change//task

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 242. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, `v1` ou `v2` . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres
change_sys_id	Sys_id da solicitação de mudança à qual esta tarefa será associada. Tipo de dados: Cadeia de caracteres Tabela: solicitação de mudança [change_request]

Tabela 243. Parâmetros de consulta
Nome	Descrição
pares de chave-valor	Campos a serem modificados ao criar a solicitação. A chave é o nome do campo no modelo e o valor são as informações a serem preenchidas no campo. Campos que não podem ser modificados e são ignorados se passados: Regras de negócio Campos somente leitura, conforme definido em ACLs Campos que não existem Tipo de dados: Cadeia de caracteres

Tabela 244. Solicitar parâmetros do corpo (XML ou JSON)
Nome	Descrição
Nenhum(a)

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 .

Tabela 245. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 246. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 247. Códigos de status
Código do status	Descrição
200	Solicitação concluída com sucesso.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. Não foi possível encontrar o registro especificado.
500	Erro Interno do servidor. Ocorreu um erro de lógica no código do lado do servidor.

Parâmetros do corpo da resposta (JSON ou XML)


Nome	Descrição
pares nome-valor	Pares nome-valor dos campos que foram criados na tarefa de solicitação de mudança. Tipo de dados: Objeto
primário	Informações da solicitação de mudança associada à tarefa. Tipo de dados: Objeto `parent: { display_value: "String", value: "String" }`
parent.display_value	Informações a serem exibidas na IU da solicitação de mudança associada à tarefa. Tipo de dados: Cadeia de caracteres
valor.primário	Sys_id da solicitação de mudança associada à tarefa. Tipo de dados: Cadeia de caracteres
sys_id	Informações de sys_id da tarefa de solicitação de mudança recém-criada. Tipo de dados: Objeto `sys_id: { display_value: "String", value: "String" }`
sys_id.display_value	Sys_id da tarefa de solicitação de mudança a ser exibida em uma IU. Tipo de dados: Cadeia de caracteres
sys_id.value	Sys_id da tarefa de solicitação de mudança. Tipo de dados: Cadeia de caracteres
__meta.ignoredFields	Pares de chave-valor que foram passados na chamada, mas não foram aplicados à solicitação de mudança, pois não existem no registro de base ou os campos são somente leitura. Tipo de dados: Matriz

Solicitação de curl

curl "https://instance.servicenow.com/api/now/change/0f4ac6c4b750230096c3e4f6ee11a9fe/task?short_description=Retire node&no_such_field=test" \
--request POST \
--header "Accept:application/json" \
--user "username":"password"

{
  result: [
    {
      sys_id: {
        value: "12629ec4b750230096c3e4f6ee11a9d5",
        display_value: "12629ec4b750230096c3e4f6ee11a9d5"
      },
      parent: {
        value: "0f4ac6c4b750230096c3e4f6ee11a9fe ", 
        display_value: "CHG0033046 "
      },
      ..., // all valid fields in record, example below
      short_description: {
        value: "Retire node",
        display_value: "Retire node"
      }
      __meta.ignoredFields": ["no_such_field"]
    }
  ]
}