API de Gestão do ciclo de vida de IC

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 35 min. de leitura

    • . Gestão do ciclo de vida de IC A API fornece endpoints para manipular estados operacionais de item de configuração (IC) e aplicar ações de IC.

    As interfaces de API seguem as restrições e permissões especificadas por ações de IC não permitidas, ações de IC compatíveis e transições operacionais não permitidas. Se uma interface tentar uma operação restrita, a operação será bloqueada, um erro será registrado e uma tarefa será criada, se apropriado.

    Gestão do ciclo de vida de IC - EXCLUIR /now/cilifecyclemgmt/actions

    Remove uma ação de item de configuração (IC) de uma lista de ICs.

    Formato de URL

    URL com controle de versão: /api/now//cilifecyclemgmt/actions

    URL padrão: /api/now/cilifecyclemgmt/actions

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para APIs REST com script, há informações adicionais de versão no 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 para acessar. 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 2. Parâmetros de consulta
    Nome Descrição
    actionName Necessário. Nome da ação do item de configuração.

    Tipo de dados: Cadeia de caracteres
    SolicitorId Necessário. Sys_id de um contexto de fluxo de trabalho ou um ID de usuário do operador retornado do Gestão do ciclo de vida de IC - POST /now/cilifecyclemgmt/operatorsendpoint.

    Os IDs de usuário do operador estão localizados na tabela Usuários registrados do estado do IC [statemgmt_register_users].

    Tipo de dados: Cadeia de caracteres
    sysIds Necessário. Lista separada por vírgulas de sys_ids de IC.

    Tipo de dados: Cadeia de caracteres
    Tabela 3. Parâmetros do corpo da solicitação (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 da 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 REST API códigos de resposta HTTP .

    Tabela 6. Códigos de status
    Código de status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso pelo endpoint.

    Revise o corpo da resposta result.resultparâmetro para verificar o resultado da operação.

    Se o endpoint encontrar erros ao processar a solicitação, códigos de erro e mensagens serão exibidos no corpo da resposta result.errorsparâmetro.
    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
    resultado Objeto encapsulando o resultado da solicitação.

    Tipo de dados: Objeto

    "result": {
  "errors": [Array],
  "result": "String"
}
    erros.resultado Lista de objetos em que cada objeto representa um erro encontrado ao processar a solicitação.

    Tipo de dados: Matriz

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    erro.resultado.erros.erro Identificador de um erro de gestão de estado encontrado ao processar a solicitação.
    Valores possíveis:
    • IC_ACTION_ALREADY_SET
    • IC_ACTION_NOT_SET
    • DUPLICATE_CI_ACTION_RECORD
    • DUPLICATE_OPS_STATE_RECORD
    • SYS_ID DUPLICADO
    • INCOMPATIBLE_CI_ACTION
    • INVALID_CI_ACTION
    • INVALID_DELETE
    • INVALID_INPUT_PARAMETERS
    • INVALID_LEASETIME
    • INVALID_OPS_STATE
    • INVALID_OPS_STATE_TRANSION
    • INVALID_REQUESTOR
    • INVALID_REQUESTOR_FOR_CI
    • INVALID_SYS_ID
    • MUTEX_UNAVAILABLE
    • NOT_ALLOWED_CI_ACTION
    • OPS_STATE_NOT_SET
    • _OPS_STATE_INPRIORIZADO
    • SYS_ID_SUPPORTED

    Tipo de dados: Cadeia de caracteres
    mensagem.resultado.erros.mensagem Mensagem fornecendo detalhes sobre o associado error.

    Tipo de dados: Cadeia de caracteres
    resultado.resultado Sinalizador que indica se a ação de IC foi removida com sucesso.
    Valores possíveis:
    • Verdadeiro: A ação de IC foi removida.
    • Falso: A ação de IC não foi removida.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    Remova uma ação de IC de dois ICs.

    curl --request DELETE \
'https://instance.service-now.com/api/now/cilifecyclemgmt/actions?actionName=Patching&requestorId=621b5a09309e5010f877773aa7167c0a&sysIds=00a9a80d3790200044e0bfc8bcbe5d1c,d0fdbc8437201000deeabfc8bcbe5d33' \
--header 'Accept: application/json' \
--user "username":"password"

    O corpo da resposta confirma que a ação de IC foi removida dos ICs.

    {
  "result": {
    "result": true
  }
}

    Gestão do ciclo de vida de IC - EXCLUA /now/cilifecyclemgmt/operators/(req_id)

    Cancela o registro de um operador para usuários que não são de fluxo de trabalho.

    Formato de URL

    URL com controle de versão: /api/now/

    URL padrão: /api/now/cilifecyclemgmt/operators/

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

    Parâmetros de solicitação compatíveis

    Tabela 7. Parâmetros de caminho
    Parâmetro Descrição
    api_version Opcional. Versão do endpoint para acessar. 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
    req_id Sys_id de um contexto de fluxo de trabalho ou um ID de usuário do operador retornado do Gestão do ciclo de vida de IC - POST /now/cilifecyclemgmt/operatorsendpoint.

    Os IDs de usuário do operador estão localizados na tabela Usuários registrados do estado do IC [statemgmt_register_users].

    Tipo de dados: Cadeia de caracteres
    Tabela 8. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 9. Parâmetros do corpo da solicitação (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 da 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 REST API códigos de resposta HTTP .

    Tabela 12. Códigos de status
    Código de status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso pelo endpoint.

    Revise o corpo da resposta result.resultparâmetro para verificar o resultado da operação.

    Se o endpoint encontrar erros ao processar a solicitação, códigos de erro e mensagens serão exibidos no corpo da resposta result.errorsparâmetro.
    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
    resultado Objeto encapsulando o resultado da solicitação.

    Tipo de dados: Objeto

    "result": {
  "errors": [Array],
  "result": "String"
}
    erros.resultado Lista de objetos em que cada objeto representa um erro encontrado ao processar a solicitação.

    Tipo de dados: Matriz

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    erro.resultado.erros.erro Identificador de um erro de gestão de estado encontrado ao processar a solicitação.
    Valores possíveis:
    • IC_ACTION_ALREADY_SET
    • IC_ACTION_NOT_SET
    • DUPLICATE_CI_ACTION_RECORD
    • DUPLICATE_OPS_STATE_RECORD
    • SYS_ID DUPLICADO
    • INCOMPATIBLE_CI_ACTION
    • INVALID_CI_ACTION
    • INVALID_DELETE
    • INVALID_INPUT_PARAMETERS
    • INVALID_LEASETIME
    • INVALID_OPS_STATE
    • INVALID_OPS_STATE_TRANSION
    • INVALID_REQUESTOR
    • INVALID_REQUESTOR_FOR_CI
    • INVALID_SYS_ID
    • MUTEX_UNAVAILABLE
    • NOT_ALLOWED_CI_ACTION
    • OPS_STATE_NOT_SET
    • _OPS_STATE_INPRIORIZADO
    • SYS_ID_SUPPORTED

    Tipo de dados: Cadeia de caracteres
    mensagem.resultado.erros.mensagem Mensagem fornecendo detalhes sobre o associado error.

    Tipo de dados: Cadeia de caracteres
    resultado.resultado Sinalizador que indica se o registro do operador foi cancelado com sucesso.
    Valores possíveis:
    • Verdadeiro: O registro do operador foi cancelado com sucesso.
    • Falso: O registro do operador não foi cancelado com sucesso.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    Cancele o registro de um operador por ID de usuário.

    curl --request DELETE \
"https://instance.service-now.com/api/now/cilifecyclemgmt/operators/3cf1b3cc30121010f877773aa7167c6e" \
--header "Accept: application/json" \
--user "username":"password"

    O corpo da resposta verifica se o operador não foi registrado.

    {
  "result": {
    "result": true
  }
}

    Gestão do ciclo de vida de IC - OBTER /now/cilifecyclemgmt/actions/(sys_id)

    Retorna uma lista de ações de item de configuração (IC) ativas para o IC especificado.

    Formato de URL

    URL com controle de versão: /api/now/

    URL padrão: /api/now/cilifecyclemgmt/actions/

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para APIs REST com script, há informações adicionais de versão no 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 para acessar. 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 IC para o qual retornar ações de IC associadas.

    Tipo de dados: Cadeia de caracteres
    Tabela 14. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 15. Parâmetros do corpo da solicitação (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 da REST API compatíveis .

    Tabela 16. 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 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 REST API códigos de resposta HTTP .

    Tabela 18. Códigos de status
    Código de status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso pelo endpoint.

    Revise o corpo da resposta result.ciActionsparâmetro para verificar o resultado da operação.

    Se o endpoint encontrar erros ao processar a solicitação, códigos de erro e mensagens serão exibidos no corpo da resposta result.errorsparâmetro.
    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
    resultado Objeto encapsulando o resultado da solicitação.

    Tipo de dados: Objeto

    "result": {
  "errors": [Array],
  "result": "String"
}
    CiActions.ciActions Lista separada por vírgulas de ações de IC ativas para o IC, ou no_active_action se nenhum for encontrado.

    Tipo de dados: Cadeia de caracteres
    erros.resultado Lista de objetos em que cada objeto representa um erro encontrado ao processar a solicitação.

    Tipo de dados: Matriz

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    erro.resultado.erros.erro Identificador de um erro de gestão de estado encontrado ao processar a solicitação.
    Valores possíveis:
    • IC_ACTION_ALREADY_SET
    • IC_ACTION_NOT_SET
    • DUPLICATE_CI_ACTION_RECORD
    • DUPLICATE_OPS_STATE_RECORD
    • SYS_ID DUPLICADO
    • INCOMPATIBLE_CI_ACTION
    • INVALID_CI_ACTION
    • INVALID_DELETE
    • INVALID_INPUT_PARAMETERS
    • INVALID_LEASETIME
    • INVALID_OPS_STATE
    • INVALID_OPS_STATE_TRANSION
    • INVALID_REQUESTOR
    • INVALID_REQUESTOR_FOR_CI
    • INVALID_SYS_ID
    • MUTEX_UNAVAILABLE
    • NOT_ALLOWED_CI_ACTION
    • OPS_STATE_NOT_SET
    • _OPS_STATE_INPRIORIZADO
    • SYS_ID_SUPPORTED

    Tipo de dados: Cadeia de caracteres
    mensagem.resultado.erros.mensagem Mensagem fornecendo detalhes sobre o associado error.

    Tipo de dados: Cadeia de caracteres
    resultado.resultado Sinalizador que indica se a lista de ações de IC ativas foi retornada para todos os ICs especificados.
    Valores possíveis:
    • Verdadeiro: A lista de ações de IC ativas foi retornada.
    • Falso: A lista de ações de IC ativas não foi retornada.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    curl --request GET \
'https://instance.service-now.com/api/now/cilifecyclemgmt/actions/00a9a80d3790200044e0bfc8bcbe5d1c' \
--header 'Accept: application/json' \
--user "username":"password"

    O corpo da resposta mostra que nenhuma ação de IC está ativa para o IC especificado.

    {
  "result": {
    "ciActions": [
      "no_active_action"
    ],
    "result": true
  }
}

    Gestão do ciclo de vida de IC - OBTER /now/cilifecyclemgmt/compacActions

    Determina se duas ações de item de configuração (IC) especificadas são compatíveis.

    Formato de URL

    URL com controle de versão: /api/now/

    URL padrão: /api/now/cilifecyclemgmt/compactActions

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para APIs REST com script, há informações adicionais de versão no 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 para acessar. 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 20. Parâmetros de consulta
    Nome Descrição
    actionName Necessário. Nome da ação de IC a ser comparada.

    Tipo de dados: Cadeia de caracteres
    OtherActionName Necessário. Nome da ação de IC a ser comparada.

    Tipo de dados: Cadeia de caracteres
    Tabela 21. Parâmetros do corpo da solicitação (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 da 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 REST API códigos de resposta HTTP .

    Tabela 24. Códigos de status
    Código de status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso pelo endpoint.

    Revise o corpo da resposta result.resultparâmetro para verificar o resultado da operação.

    Se o endpoint encontrar erros ao processar a solicitação, códigos de erro e mensagens serão exibidos no corpo da resposta result.errorsparâmetro.
    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
    resultado Sinalizador que indica se as duas ações de IC especificadas são compatíveis.
    Valores possíveis:
    • Verdadeiro: As ações de IC são compatíveis.
    • Falso: As ações de IC não são compatíveis.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    Verifique a compatibilidade das ações de IC de aplicação de patches e provisionamento.

    curl --request GET \
'https://instance.service-now.com/api/now/cilifecyclemgmt/compatActions?actionName=Patching&otherActionName=Provisioning' \
--header 'Accept: application/json' \
--user "username":"password"

    O corpo da resposta confirma que as duas ações de IC são compatíveis.

    {
  "result": true
}

    Gestão do ciclo de vida de IC - OBTER /now/cilifecyclemgmt/leases/(sys_id)/expired

    Determina se o leasing expirou para o solicitante de uma ação de item de configuração (IC) aplicada ao IC especificado.

    Formato de URL

    URL com controle de versão: /api/now/

    URL padrão: /api/now/cilifecyclemgmt/leases/

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para APIs REST com script, há informações adicionais de versão no 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 para acessar. 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 IC que é o destino da ação de IC aplicada.

    Tipo de dados: Cadeia de caracteres
    Tabela 26. Parâmetros de consulta
    Nome Descrição
    actionName Necessário. Nome da ação de IC aplicada ao IC especificado.

    Tipo de dados: Cadeia de caracteres
    SolicitorId Necessário. Sys_id de um contexto de fluxo de trabalho ou um ID de usuário do operador retornado do Gestão do ciclo de vida de IC - POST /now/cilifecyclemgmt/operatorsendpoint.

    Os IDs de usuário do operador estão localizados na tabela Usuários registrados do estado do IC [statemgmt_register_users].

    Tipo de dados: Cadeia de caracteres
    Tabela 27. Parâmetros do corpo da solicitação (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 da 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 REST API códigos de resposta HTTP .

    Tabela 30. Códigos de status
    Código de status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso pelo endpoint.

    Revise o corpo da resposta result.resultparâmetro para verificar o resultado da operação.

    Se o endpoint encontrar erros ao processar a solicitação, códigos de erro e mensagens serão exibidos no corpo da resposta result.errorsparâmetro.
    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
    resultado Objeto encapsulando o resultado da solicitação.

    Tipo de dados: Objeto

    "result": {
  "errors": [Array],
  "result": "String"
}
    erros.resultado Lista de objetos em que cada objeto representa um erro encontrado ao processar a solicitação.

    Tipo de dados: Matriz

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    erro.resultado.erros.erro Identificador de um erro de gestão de estado encontrado ao processar a solicitação.
    Valores possíveis:
    • IC_ACTION_ALREADY_SET
    • IC_ACTION_NOT_SET
    • DUPLICATE_CI_ACTION_RECORD
    • DUPLICATE_OPS_STATE_RECORD
    • SYS_ID DUPLICADO
    • INCOMPATIBLE_CI_ACTION
    • INVALID_CI_ACTION
    • INVALID_DELETE
    • INVALID_INPUT_PARAMETERS
    • INVALID_LEASETIME
    • INVALID_OPS_STATE
    • INVALID_OPS_STATE_TRANSION
    • INVALID_REQUESTOR
    • INVALID_REQUESTOR_FOR_CI
    • INVALID_SYS_ID
    • MUTEX_UNAVAILABLE
    • NOT_ALLOWED_CI_ACTION
    • OPS_STATE_NOT_SET
    • _OPS_STATE_INPRIORIZADO
    • SYS_ID_SUPPORTED

    Tipo de dados: Cadeia de caracteres
    mensagem.resultado.erros.mensagem Mensagem fornecendo detalhes sobre o associado error.

    Tipo de dados: Cadeia de caracteres
    resultado.resultado Sinalizador que indica se o leasing do solicitante da ação de IC aplicada expirou.
    Valores possíveis:
    • Verdadeiro: O leasing do solicitante expirou.
    • Falso: O leasing do solicitante não expirou.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    curl --request GET \
'https://instance.service-now.com/api/now/cilifecyclemgmt/leases/00a9a80d3790200044e0bfc8bcbe5d1c/expired?actionName=Patching&requestorId=621b5a09309e5010f877773aa7167c0a' \
--header 'Accept: application/json' \
--user "username":"password"

    O corpo da resposta mostra que o leasing do solicitante da ação de IC aplicada não expirou.

    {
  "result": {
    "result": false
  }
}

    Gestão do ciclo de vida de IC - OBTER /now/cilifecyclemgmt/notAllowedAction

    Determina se uma ação de item de configuração (IC) especificada não é permitida para um IC de uma classe especificada quando em um estado operacional especificado.

    Formato de URL

    URL com controle de versão: /api/now/

    URL padrão: /api/now/cilifecyclemgmt/notAllowedAction

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para APIs REST com script, há informações adicionais de versão no 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 para acessar. 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 32. Parâmetros de consulta
    Nome Descrição
    actionName Necessário. Nome da ação de IC a ser verificada.

    Tipo de dados: Cadeia de caracteres
    ciClass Necessário. Classe de IC.

    Tipo de dados: Cadeia de caracteres
    OpsLabel Necessário. Estado operacional a ser verificado.

    Tipo de dados: Cadeia de caracteres
    Tabela 33. Parâmetros do corpo da solicitação (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 da 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 REST API códigos de resposta HTTP .

    Tabela 36. Códigos de status
    Código de status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso pelo endpoint.

    Revise o corpo da resposta result.resultparâmetro para verificar o resultado da operação.

    Se o endpoint encontrar erros ao processar a solicitação, códigos de erro e mensagens serão exibidos no corpo da resposta result.errorsparâmetro.
    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
    resultado Sinalizador que indica se a ação de IC é restrita (não permitida) para ICs do tipo especificado quando no estado operacional especificado.
    Valores possíveis:
    • Verdadeiro: A ação de IC é restrita (não permitida).
    • Falso: A ação de IC é irrestrita (permitida).

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    Verifique se a ação de IC de patch é restrita (não permitida) para computadores no estado operacional de espera de DR.

    curl --request GET \
"https://instance.service-now.com/api/now/cilifecyclemgmt/notAllowedAction?actionName=Patching&ciClass=cmdb_ci_computer&opsLabel=DR+Standby" \
--header "Accept: application/json" \
--user "username":"password"

    O corpo da resposta confirma que esta ação é restrita (não permitida) para a classe de IC especificada quando no estado operacional especificado.

    {
  "result": true
}

    Gestão do ciclo de vida de IC - OBTER /now/cilifecyclemgmt/notAllowedOpsTransition

    Determina se um item de configuração (IC) de uma classe especificada pode fazer a transição de um estado operacional especificado para um segundo estado operacional especificado.

    Formato de URL

    URL com controle de versão: /api/now/

    URL padrão: /api/now/cilifecyclemgmt/notAllowedOpsTransition

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para APIs REST com script, há informações adicionais de versão no 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 para acessar. 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 38. Parâmetros de consulta
    Nome Descrição
    ciClass Necessário. Classe de IC para verificar restrições de transição.

    Tipo de dados: Cadeia de caracteres
    OpsLabel Necessário. Rótulo do estado operacional do IC atual.

    Tipo de dados: Cadeia de caracteres
    TransitionOpsLabel Necessário. Rótulo do estado operacional que é o destino da transição.

    Tipo de dados: Cadeia de caracteres
    Tabela 39. Parâmetros do corpo da solicitação (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 da 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 REST API códigos de resposta HTTP .

    Tabela 42. Códigos de status
    Código de status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso pelo endpoint.

    Revise o corpo da resposta result.resultparâmetro para verificar o resultado da operação.

    Se o endpoint encontrar erros ao processar a solicitação, códigos de erro e mensagens serão exibidos no corpo da resposta result.errorsparâmetro.
    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
    resultado Sinalizador que indica se a transição do estado operacional especificada é restrita (não permitida) para a classe de IC especificada.
    Valores possíveis:
    • Verdadeiro: A transição do estado operacional é restrita (não permitida).
    • Falso: A transição do estado operacional é irrestrita (permitida).

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    Verifique se a transição do estado operacional descontinuado para o estado operacional em espera de DR é restrita (não permitido) para ICs de servidor Linux.

    curl --request GET \
"https://instance.service-now.com/api/now/cilifecyclemgmt/notAllowedOpsTransition?ciClass=cmdb_ci_computer&opsLabel=Retired&transitionOpsLabel=DR+Standby" \
--header "Accept: application/json" \
--user "username":"password"

    O corpo da resposta mostra que a transição do estado operacional especificada é irrestrita (permitida) para esta classe de IC.

    {
  "result": false
}

    Gestão do ciclo de vida de IC - OBTER /now/cilifecyclemgmt/solicitantes/(req_id)/valid

    Determina se o usuário de fluxo de trabalho ativo especificado ou o usuário registrado é um solicitante válido.

    Formato de URL

    URL com controle de versão: /api/now/

    URL padrão: /api/now/cilifecyclemgmt/req_id/valid

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para APIs REST com script, há informações adicionais de versão no 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 para acessar. 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
    req_id Sys_id de um contexto de fluxo de trabalho ou um ID de usuário do operador retornado do Gestão do ciclo de vida de IC - POST /now/cilifecyclemgmt/operatorsendpoint.

    Os IDs de usuário do operador estão localizados na tabela Usuários registrados do estado do IC [statemgmt_register_users].

    Tipo de dados: Cadeia de caracteres
    Tabela 44. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 45. Parâmetros do corpo da solicitação (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 da 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 REST API códigos de resposta HTTP .

    Tabela 48. Códigos de status
    Código de status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso pelo endpoint.

    Revise o corpo da resposta result.resultparâmetro para verificar o resultado da operação.

    Se o endpoint encontrar erros ao processar a solicitação, códigos de erro e mensagens serão exibidos no corpo da resposta result.errorsparâmetro.
    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
    resultado Objeto encapsulando o resultado da solicitação.

    Tipo de dados: Objeto

    "result": {
  "errors": [Array],
  "result": "String"
}
    erros.resultado Lista de objetos em que cada objeto representa um erro encontrado ao processar a solicitação.

    Tipo de dados: Matriz

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    erro.resultado.erros.erro Identificador de um erro de gestão de estado encontrado ao processar a solicitação.
    Valores possíveis:
    • IC_ACTION_ALREADY_SET
    • IC_ACTION_NOT_SET
    • DUPLICATE_CI_ACTION_RECORD
    • DUPLICATE_OPS_STATE_RECORD
    • SYS_ID DUPLICADO
    • INCOMPATIBLE_CI_ACTION
    • INVALID_CI_ACTION
    • INVALID_DELETE
    • INVALID_INPUT_PARAMETERS
    • INVALID_LEASETIME
    • INVALID_OPS_STATE
    • INVALID_OPS_STATE_TRANSION
    • INVALID_REQUESTOR
    • INVALID_REQUESTOR_FOR_CI
    • INVALID_SYS_ID
    • MUTEX_UNAVAILABLE
    • NOT_ALLOWED_CI_ACTION
    • OPS_STATE_NOT_SET
    • _OPS_STATE_INPRIORIZADO
    • SYS_ID_SUPPORTED

    Tipo de dados: Cadeia de caracteres
    mensagem.resultado.erros.mensagem Mensagem fornecendo detalhes sobre o associado error.

    Tipo de dados: Cadeia de caracteres
    resultado.resultado Sinalizador que indica se o usuário de fluxo de trabalho ativo especificado ou o usuário registrado é um solicitante válido.
    Valores possíveis:
    • Verdadeiro: Solicitante válido.
    • Falso: Solicitante inválido.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    curl --request GET \
'https://instance.service-now.com/api/now/cilifecyclemgmt/requestors/4cab9b95301a9010f877773aa7167ca9/valid' \
--header 'Accept: application/json' \
--user "username":"password"
    {
  "result": {
    "result": true
  }
}

    Gestão do ciclo de vida de IC - OBTER /now/cilifecyclemgmt/status/(sys_id)

    Retorna o estado operacional atual do item de configuração (IC) especificado.

    Formato de URL

    URL com controle de versão: /api/now/

    URL padrão: /api/now/cilifecyclemgmt/status/

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para APIs REST com script, há informações adicionais de versão no 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 para acessar. 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 IC.

    Tipo de dados: Cadeia de caracteres
    Tabela 50. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 51. Parâmetros do corpo da solicitação (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 da 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 REST API códigos de resposta HTTP .

    Tabela 54. Códigos de status
    Código de status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso pelo endpoint.

    Revise o corpo da resposta result.resultparâmetro para verificar o resultado da operação.

    Se o endpoint encontrar erros ao processar a solicitação, códigos de erro e mensagens serão exibidos no corpo da resposta result.errorsparâmetro.
    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
    resultado Objeto encapsulando o resultado da solicitação.

    Tipo de dados: Objeto

    "result": {
  "errors": [Array],
  "result": "String"
}
    erros.resultado Lista de objetos em que cada objeto representa um erro encontrado ao processar a solicitação.

    Tipo de dados: Matriz

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    erro.resultado.erros.erro Identificador de um erro de gestão de estado encontrado ao processar a solicitação.
    Valores possíveis:
    • IC_ACTION_ALREADY_SET
    • IC_ACTION_NOT_SET
    • DUPLICATE_CI_ACTION_RECORD
    • DUPLICATE_OPS_STATE_RECORD
    • SYS_ID DUPLICADO
    • INCOMPATIBLE_CI_ACTION
    • INVALID_CI_ACTION
    • INVALID_DELETE
    • INVALID_INPUT_PARAMETERS
    • INVALID_LEASETIME
    • INVALID_OPS_STATE
    • INVALID_OPS_STATE_TRANSION
    • INVALID_REQUESTOR
    • INVALID_REQUESTOR_FOR_CI
    • INVALID_SYS_ID
    • MUTEX_UNAVAILABLE
    • NOT_ALLOWED_CI_ACTION
    • OPS_STATE_NOT_SET
    • _OPS_STATE_INPRIORIZADO
    • SYS_ID_SUPPORTED

    Tipo de dados: Cadeia de caracteres
    mensagem.resultado.erros.mensagem Mensagem fornecendo detalhes sobre o associado error.

    Tipo de dados: Cadeia de caracteres
    Result.operationalstates Estado operacional para o IC especificado ou desconhecido se nenhum estado for especificado.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    curl --request GET 'https://instance.service-now.com/api/now/cilifecyclemgmt/statuses/aac0b1213784200044e0bfc8bcbe5de3' \
--header 'Accept: application/json' \
--user "username":"password"
    {
  "result": {
    "operationalState": "Repair in Progress",
    "result": true
  }
}

    Gestão do ciclo de vida de IC - PATCH /now/cilifecyclemgmt/leases/(sys_id)

    Estende o tempo de expiração do leasing da ação do item de configuração (IC) especificado para o usuário especificado.

    Se o leasing anterior tiver expirado, o novo tempo de leasing começará imediatamente.

    Formato de URL

    URL com controle de versão: /api/now/

    URL padrão: /api/now/cilifecyclemgmt/leases/

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para APIs REST com script, há informações adicionais de versão no 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 para acessar. 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 IC para o qual estender o leasing.

    Tipo de dados: Cadeia de caracteres
    Tabela 56. Parâmetros de consulta
    Nome Descrição
    actionName Necessário. Nome da ação de IC associada.

    Tipo de dados: Cadeia de caracteres
    Leasing Necessário. Tempo durante o qual o leasing é válido para a ação de IC especificada em actionName.

    Tipo de dados: Cadeia de caracteres

    FORMATO: HH:MM:SS
    SolicitorId Necessário. Sys_id de um contexto de fluxo de trabalho ou um ID de usuário do operador retornado do Gestão do ciclo de vida de IC - POST /now/cilifecyclemgmt/operatorsendpoint.

    Os IDs de usuário do operador estão localizados na tabela Usuários registrados do estado do IC [statemgmt_register_users].

    Tipo de dados: Cadeia de caracteres
    Tabela 57. Parâmetros do corpo da solicitação (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 da 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
    Tipo de conteúdo Formato de dados do corpo da solicitação. 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 REST API códigos de resposta HTTP .

    Tabela 60. Códigos de status
    Código de status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso pelo endpoint.

    Revise o corpo da resposta result.resultparâmetro para verificar o resultado da operação.

    Se o endpoint encontrar erros ao processar a solicitação, códigos de erro e mensagens serão exibidos no corpo da resposta result.errorsparâmetro.
    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
    resultado Objeto encapsulando o resultado da solicitação.

    Tipo de dados: Objeto

    "result": {
  "errors": [Array],
  "result": "String"
}
    erros.resultado Lista de objetos em que cada objeto representa um erro encontrado ao processar a solicitação.

    Tipo de dados: Matriz

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    erro.resultado.erros.erro Identificador de um erro de gestão de estado encontrado ao processar a solicitação.
    Valores possíveis:
    • IC_ACTION_ALREADY_SET
    • IC_ACTION_NOT_SET
    • DUPLICATE_CI_ACTION_RECORD
    • DUPLICATE_OPS_STATE_RECORD
    • SYS_ID DUPLICADO
    • INCOMPATIBLE_CI_ACTION
    • INVALID_CI_ACTION
    • INVALID_DELETE
    • INVALID_INPUT_PARAMETERS
    • INVALID_LEASETIME
    • INVALID_OPS_STATE
    • INVALID_OPS_STATE_TRANSION
    • INVALID_REQUESTOR
    • INVALID_REQUESTOR_FOR_CI
    • INVALID_SYS_ID
    • MUTEX_UNAVAILABLE
    • NOT_ALLOWED_CI_ACTION
    • OPS_STATE_NOT_SET
    • _OPS_STATE_INPRIORIZADO
    • SYS_ID_SUPPORTED

    Tipo de dados: Cadeia de caracteres
    mensagem.resultado.erros.mensagem Mensagem fornecendo detalhes sobre o associado error.

    Tipo de dados: Cadeia de caracteres
    resultado.resultado Sinalizador que indica se o tempo de leasing foi estendido.
    Valores possíveis:
    • Verdadeiro: O tempo de leasing foi estendido.
    • Falso: O tempo de leasing não foi estendido.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    Estenda a duração de um leasing do solicitante de ação de IC de patch em 24 horas.

    curl --request PATCH 'https://instance.service-now.com/api/now/cilifecyclemgmt/leases/affd3c8437201000deeabfc8bcbe5dc3?actionName=Patching&leaseTime=24:00:00&requestorId=e7c3402d305a9010f877773aa7167c2a' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--user "username":"password"
    {
  "result": {
    "result": true
  }
}

    Gestão do ciclo de vida de IC - PUBLICAR /now/cilifecyclemgmt/actions

    Adiciona uma ação de item de configuração (IC) especificada a uma lista especificada de ICs.

    Formato de URL

    URL com controle de versão: /api/now//cilifecyclemgmt/actions

    URL padrão: /api/now/cilifecyclemgmt/actions

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para APIs REST com script, há informações adicionais de versão no 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 para acessar. 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 62. Parâmetros de consulta
    Nome Descrição
    actionName Necessário. Nome da ação de IC a ser adicionada à lista.

    Tipo de dados: Cadeia de caracteres
    Leasing Tempo durante o qual o leasing é válido para a ação de IC especificada.

    Tipo de dados: Cadeia de caracteres

    FORMATO: HH:MM:SS
    OldActionNames Lista separada por vírgulas de ações de IC antigas nas quais todos os ICs devem estar.

    Tipo de dados: Cadeia de caracteres
    SolicitorId Necessário. Sys_id de um contexto de fluxo de trabalho ou um ID de usuário do operador retornado do Gestão do ciclo de vida de IC - POST /now/cilifecyclemgmt/operatorsendpoint.

    Os IDs de usuário do operador estão localizados na tabela Usuários registrados do estado do IC [statemgmt_register_users].

    Tipo de dados: Cadeia de caracteres
    sysIds Necessário. Lista separada por vírgulas de sys_ids de IC à qual a ação de IC será adicionada.

    Tipo de dados: Cadeia de caracteres
    Tabela 63. Parâmetros do corpo da solicitação (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 da 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
    Tipo de conteúdo Formato de dados do corpo da solicitação. 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 REST API códigos de resposta HTTP .

    Tabela 66. Códigos de status
    Código de status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso pelo endpoint.

    Revise o corpo da resposta result.resultparâmetro para verificar o resultado da operação.

    Se o endpoint encontrar erros ao processar a solicitação, códigos de erro e mensagens serão exibidos no corpo da resposta result.errorsparâmetro.
    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
    resultado Objeto encapsulando o resultado da solicitação.

    Tipo de dados: Objeto

    "result": {
  "errors": [Array],
  "result": "String"
}
    erros.resultado Lista de objetos em que cada objeto representa um erro encontrado ao processar a solicitação.

    Tipo de dados: Matriz

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    erro.resultado.erros.erro Identificador de um erro de gestão de estado encontrado ao processar a solicitação.
    Valores possíveis:
    • IC_ACTION_ALREADY_SET
    • IC_ACTION_NOT_SET
    • DUPLICATE_CI_ACTION_RECORD
    • DUPLICATE_OPS_STATE_RECORD
    • SYS_ID DUPLICADO
    • INCOMPATIBLE_CI_ACTION
    • INVALID_CI_ACTION
    • INVALID_DELETE
    • INVALID_INPUT_PARAMETERS
    • INVALID_LEASETIME
    • INVALID_OPS_STATE
    • INVALID_OPS_STATE_TRANSION
    • INVALID_REQUESTOR
    • INVALID_REQUESTOR_FOR_CI
    • INVALID_SYS_ID
    • MUTEX_UNAVAILABLE
    • NOT_ALLOWED_CI_ACTION
    • OPS_STATE_NOT_SET
    • _OPS_STATE_INPRIORIZADO
    • SYS_ID_SUPPORTED

    Tipo de dados: Cadeia de caracteres
    mensagem.resultado.erros.mensagem Mensagem fornecendo detalhes sobre o associado error.

    Tipo de dados: Cadeia de caracteres
    resultado.resultado Sinalizador que indica se a ação de IC foi definida para todos os ICs na lista.
    Valores possíveis:
    • Verdadeiro: Ações de IC foram definidas.
    • Falso: As ações de IC não foram definidas.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    Adicione uma ação de IC de patch a dois ICs.

    curl --request POST \
"https://instance.service-now.com/api/now/cilifecyclemgmt/actions?actionName=Patching&requestorId=621b5a09309e5010f877773aa7167c0a&sysIds=00a9a80d3790200044e0bfc8bcbe5d1c,d0fdbc8437201000deeabfc8bcbe5d33" \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--user "username":"password"
    {
  "result": {
    "result": true
  }
}

    Gestão do ciclo de vida de IC - POST /now/cilifecyclemgmt/operators

    Registra um operador para um usuário que não é de fluxo de trabalho.

    Formato de URL

    URL com controle de versão: /api/now//cilifecyclemgmt/operators

    URL padrão: /api/now/cilifecyclemgmt/operators

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para APIs REST com script, há informações adicionais de versão no 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 para acessar. 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 68. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 69. Parâmetros do corpo da solicitação (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 da 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
    Tipo de conteúdo Formato de dados do corpo da solicitação. 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 REST API códigos de resposta HTTP .

    Tabela 72. Códigos de status
    Código de status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso pelo endpoint.

    Revise o corpo da resposta result.resultparâmetro para verificar o resultado da operação.

    Se o endpoint encontrar erros ao processar a solicitação, códigos de erro e mensagens serão exibidos no corpo da resposta result.errorsparâmetro.
    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
    resultado Objeto encapsulando o resultado da solicitação.

    Tipo de dados: Objeto

    "result": {
  "errors": [Array],
  "result": "String"
}
    erros.resultado Lista de objetos em que cada objeto representa um erro encontrado ao processar a solicitação.

    Tipo de dados: Matriz

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    erro.resultado.erros.erro Identificador de um erro de gestão de estado encontrado ao processar a solicitação.
    Valores possíveis:
    • IC_ACTION_ALREADY_SET
    • IC_ACTION_NOT_SET
    • DUPLICATE_CI_ACTION_RECORD
    • DUPLICATE_OPS_STATE_RECORD
    • SYS_ID DUPLICADO
    • INCOMPATIBLE_CI_ACTION
    • INVALID_CI_ACTION
    • INVALID_DELETE
    • INVALID_INPUT_PARAMETERS
    • INVALID_LEASETIME
    • INVALID_OPS_STATE
    • INVALID_OPS_STATE_TRANSION
    • INVALID_REQUESTOR
    • INVALID_REQUESTOR_FOR_CI
    • INVALID_SYS_ID
    • MUTEX_UNAVAILABLE
    • NOT_ALLOWED_CI_ACTION
    • OPS_STATE_NOT_SET
    • _OPS_STATE_INPRIORIZADO
    • SYS_ID_SUPPORTED

    Tipo de dados: Cadeia de caracteres
    mensagem.resultado.erros.mensagem Mensagem fornecendo detalhes sobre o associado error.

    Tipo de dados: Cadeia de caracteres
    RequestorId.requestorId GUID do operador registrado. Use este valor para definir ações de IC e estados operacionais.

    Tipo de dados: Cadeia de caracteres
    resultado.resultado Sinalizador que indica se o operador foi registrado com sucesso.
    Valores possíveis:
    • Verdadeiro: O operador foi registrado com sucesso.
    • Falso: O operador não foi registrado com sucesso.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    curl --request POST \
"https://instance.service-now.com/api/now/cilifecyclemgmt/operators" \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--user "username":"password"
    {
  "result": {
    "result": true,
    "requestorId": "6f992b8430121010f877773aa7167c42"
  }
}

    Gestão do ciclo de vida de IC - PUBLICAR /now/cilifecyclemgmt/status

    Define o estado operacional de uma lista especificada de itens de configuração (ICs).

    Formato de URL

    URL com controle de versão: /api/now/

    URL padrão: /api/now/cilifecyclemgmt/status

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para APIs REST com script, há informações adicionais de versão no 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 para acessar. 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 74. Parâmetros de consulta
    Nome Descrição
    OldOpsLabels Lista separada por vírgulas de estados operacionais de IC antigos nos quais todos os ICs devem ser incluídos.

    Tipo de dados: Cadeia de caracteres
    OpsLabel Necessário. Rótulo do estado operacional a ser definido para os ICs especificados.

    Tipo de dados: Cadeia de caracteres
    SolicitorId Necessário. Sys_id de um contexto de fluxo de trabalho ou um ID de usuário do operador retornado do Gestão do ciclo de vida de IC - POST /now/cilifecyclemgmt/operatorsendpoint.

    Os IDs de usuário do operador estão localizados na tabela Usuários registrados do estado do IC [statemgmt_register_users].

    Tipo de dados: Cadeia de caracteres
    sysIds Necessário. Lista separada por vírgulas de sys_ids de ICs para os quais o estado operacional será definido.

    Tipo de dados: Cadeia de caracteres
    Tabela 75. Parâmetros do corpo da solicitação (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 da 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
    Tipo de conteúdo Formato de dados do corpo da solicitação. 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 REST API códigos de resposta HTTP .

    Tabela 78. Códigos de status
    Código de status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso pelo endpoint.

    Revise o corpo da resposta result.resultparâmetro para verificar o resultado da operação.

    Se o endpoint encontrar erros ao processar a solicitação, códigos de erro e mensagens serão exibidos no corpo da resposta result.errorsparâmetro.
    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
    resultado Objeto encapsulando o resultado da solicitação.

    Tipo de dados: Objeto

    "result": {
  "errors": [Array],
  "result": "String"
}
    erros.resultado Lista de objetos em que cada objeto representa um erro encontrado ao processar a solicitação.

    Tipo de dados: Matriz

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    erro.resultado.erros.erro Identificador de um erro de gestão de estado encontrado ao processar a solicitação.
    Valores possíveis:
    • IC_ACTION_ALREADY_SET
    • IC_ACTION_NOT_SET
    • DUPLICATE_CI_ACTION_RECORD
    • DUPLICATE_OPS_STATE_RECORD
    • SYS_ID DUPLICADO
    • INCOMPATIBLE_CI_ACTION
    • INVALID_CI_ACTION
    • INVALID_DELETE
    • INVALID_INPUT_PARAMETERS
    • INVALID_LEASETIME
    • INVALID_OPS_STATE
    • INVALID_OPS_STATE_TRANSION
    • INVALID_REQUESTOR
    • INVALID_REQUESTOR_FOR_CI
    • INVALID_SYS_ID
    • MUTEX_UNAVAILABLE
    • NOT_ALLOWED_CI_ACTION
    • OPS_STATE_NOT_SET
    • _OPS_STATE_INPRIORIZADO
    • SYS_ID_SUPPORTED

    Tipo de dados: Cadeia de caracteres
    mensagem.resultado.erros.mensagem Mensagem fornecendo detalhes sobre o associado error.

    Tipo de dados: Cadeia de caracteres
    resultado.resultado Sinalizador que indica se o estado desejado foi definido para todos os ICs incluídos na solicitação.
    Valores possíveis:
    • Verdadeiro: Conjunto de estados operacionais.
    • Falso: Estado operacional não definido.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    Defina o. Reparo em andamento Estado operacional para dois ICs.

    curl --request POST \
"https://instance.service-now.com/api/now/cilifecyclemgmt/statuses?opsLabel=Repair%20in%20Progress&requestorId=23d58bc030121010f877773aa7167c83&sysIds=affd3c8437201000deeabfc8bcbe5dc3,aac0b1213784200044e0bfc8bcbe5de3" \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--user "username":"password"

    O corpo da resposta mostra que o estado operacional desejado foi definido para ambos os ICs especificados na solicitação.

    {
  "result": {
    "result": true
  }
}