API de Gestão de ciclo de vida de IC

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 36 min. de leitura

    • . Gestão do ciclo de vida do 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 aderem às 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 em log e uma tarefa será criada, se apropriado.

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

    Remove uma ação de item de configuração (IC) para 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 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
    Tabela 2. Parâmetros de consulta
    Nome Descrição
    actionName Obrigatório. Nome da ação do item de configuração.

    Tipo de dados: Cadeia de caracteres
    Solicitante Obrigató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 do IC - POST /now/cilifecyclemgmt/operators endpoint.

    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 Obrigatório. Lista separada por vírgulas de sys_ids de IC.

    Tipo de dados: Cadeia de caracteres
    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 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, os códigos de erro e as 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"
}
    resultado.erros Lista de objetos em que cada objeto representa um erro encontrado durante o processamento da 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
    • DUPLICATE_SYS_ID
    • INCOMPATIBLE_CI_ACTION
    • INVALID_CI_ACTION
    • INVALID_DELETE
    • INVALID_INPUT_PARAMETERS
    • INVALID_LEASETIME
    • INVALID_OPS_STATE
    • INVALID_OPS_STATE_TRANSITION
    • INVALID_REQUESTOR
    • INVALID_REQUESTOR_FOR_CI
    • INVALID_SYS_ID
    • MUTEX_UNAVAILABLE
    • NOT_ALLOWED_CI_ACTION
    • OPS_STATE_NOT_SET
    • UNPRIORITIZED_OPS_STATE
    • UNSUPPORTED_SYS_ID

    Tipo de dados: Cadeia de caracteres
    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

    Remover 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 do IC - EXCLUA /now/cilifecyclemgmt/operators/

    Cancela o registro de um operador para usuários que não são do 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 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
    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
    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 do IC - POST /now/cilifecyclemgmt/operators endpoint.

    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. 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 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, os códigos de erro e as 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"
}
    resultado.erros Lista de objetos em que cada objeto representa um erro encontrado durante o processamento da 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
    • DUPLICATE_SYS_ID
    • INCOMPATIBLE_CI_ACTION
    • INVALID_CI_ACTION
    • INVALID_DELETE
    • INVALID_INPUT_PARAMETERS
    • INVALID_LEASETIME
    • INVALID_OPS_STATE
    • INVALID_OPS_STATE_TRANSITION
    • INVALID_REQUESTOR
    • INVALID_REQUESTOR_FOR_CI
    • INVALID_SYS_ID
    • MUTEX_UNAVAILABLE
    • NOT_ALLOWED_CI_ACTION
    • OPS_STATE_NOT_SET
    • UNPRIORITIZED_OPS_STATE
    • UNSUPPORTED_SYS_ID

    Tipo de dados: Cadeia de caracteres
    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 do IC - OBTENHA /now/cilifecyclemgmt/actions/

    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//cilifecyclemgmt/actions/

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

    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 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. 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
    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 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 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, os códigos de erro e as 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"
}
    Result.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
    resultado.erros Lista de objetos em que cada objeto representa um erro encontrado durante o processamento da 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
    • DUPLICATE_SYS_ID
    • INCOMPATIBLE_CI_ACTION
    • INVALID_CI_ACTION
    • INVALID_DELETE
    • INVALID_INPUT_PARAMETERS
    • INVALID_LEASETIME
    • INVALID_OPS_STATE
    • INVALID_OPS_STATE_TRANSITION
    • INVALID_REQUESTOR
    • INVALID_REQUESTOR_FOR_CI
    • INVALID_SYS_ID
    • MUTEX_UNAVAILABLE
    • NOT_ALLOWED_CI_ACTION
    • OPS_STATE_NOT_SET
    • UNPRIORITIZED_OPS_STATE
    • UNSUPPORTED_SYS_ID

    Tipo de dados: Cadeia de caracteres
    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 de ciclo de vida de IC - OBTENHA /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//cilifecyclemgmt/compacActions

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

    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
    Tabela 20. Parâmetros de consulta
    Nome Descrição
    actionName Obrigatório. Nome da ação de IC a ser comparada.

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

    Tipo de dados: Cadeia de caracteres
    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 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, os códigos de erro e as 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 patch 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 de ciclo de vida de IC - OBTER /now/cilifecyclemgmt/leases/

    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//cilifecyclemgmt/leases/sys_id/expired

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

    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 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 Obrigatório. Nome da ação de IC aplicada ao IC especificado.

    Tipo de dados: Cadeia de caracteres
    Solicitante Obrigató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 do IC - POST /now/cilifecyclemgmt/operators endpoint.

    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. 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 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, os códigos de erro e as 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"
}
    resultado.erros Lista de objetos em que cada objeto representa um erro encontrado durante o processamento da 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
    • DUPLICATE_SYS_ID
    • INCOMPATIBLE_CI_ACTION
    • INVALID_CI_ACTION
    • INVALID_DELETE
    • INVALID_INPUT_PARAMETERS
    • INVALID_LEASETIME
    • INVALID_OPS_STATE
    • INVALID_OPS_STATE_TRANSITION
    • INVALID_REQUESTOR
    • INVALID_REQUESTOR_FOR_CI
    • INVALID_SYS_ID
    • MUTEX_UNAVAILABLE
    • NOT_ALLOWED_CI_ACTION
    • OPS_STATE_NOT_SET
    • UNPRIORITIZED_OPS_STATE
    • UNSUPPORTED_SYS_ID

    Tipo de dados: Cadeia de caracteres
    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 de ciclo de vida de IC - OBTENHA /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 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
    Tabela 32. Parâmetros de consulta
    Nome Descrição
    actionName Obrigatório. Nome da ação de IC a ser verificada.

    Tipo de dados: Cadeia de caracteres
    ciClass Obrigatório. Classe de IC.

    Tipo de dados: Cadeia de caracteres
    OpsLabel Obrigatório. Estado operacional a ser verificado.

    Tipo de dados: Cadeia de caracteres
    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 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, os códigos de erro e as 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 em 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 está no estado operacional especificado.

    {
  "result": true
}

    Gestão de ciclo de vida de IC - OBTENHA /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 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
    Tabela 38. Parâmetros de consulta
    Nome Descrição
    ciClass Obrigatório. Classe de IC para verificar restrições de transição.

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

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

    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
    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, os códigos de erro e as 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 de 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 permitida) para ICs do 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 de estado operacional especificada é irrestrita (permitida) para esta classe de IC.

    {
  "result": false
}

    Gestão do ciclo de vida do IC - OBTENHA /now/cilifecyclemgmt/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//cilifecyclemgmt/req_id/valid

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

    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
    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 do IC - POST /now/cilifecyclemgmt/operators endpoint.

    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. 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 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, os códigos de erro e as 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"
}
    resultado.erros Lista de objetos em que cada objeto representa um erro encontrado durante o processamento da 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
    • DUPLICATE_SYS_ID
    • INCOMPATIBLE_CI_ACTION
    • INVALID_CI_ACTION
    • INVALID_DELETE
    • INVALID_INPUT_PARAMETERS
    • INVALID_LEASETIME
    • INVALID_OPS_STATE
    • INVALID_OPS_STATE_TRANSITION
    • INVALID_REQUESTOR
    • INVALID_REQUESTOR_FOR_CI
    • INVALID_SYS_ID
    • MUTEX_UNAVAILABLE
    • NOT_ALLOWED_CI_ACTION
    • OPS_STATE_NOT_SET
    • UNPRIORITIZED_OPS_STATE
    • UNSUPPORTED_SYS_ID

    Tipo de dados: Cadeia de caracteres
    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 do IC - OBTENHA /now/cilifecyclemgmt/status/

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

    Formato de URL

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

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

    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
    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. 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 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, os códigos de erro e as 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"
}
    resultado.erros Lista de objetos em que cada objeto representa um erro encontrado durante o processamento da 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
    • DUPLICATE_SYS_ID
    • INCOMPATIBLE_CI_ACTION
    • INVALID_CI_ACTION
    • INVALID_DELETE
    • INVALID_INPUT_PARAMETERS
    • INVALID_LEASETIME
    • INVALID_OPS_STATE
    • INVALID_OPS_STATE_TRANSITION
    • INVALID_REQUESTOR
    • INVALID_REQUESTOR_FOR_CI
    • INVALID_SYS_ID
    • MUTEX_UNAVAILABLE
    • NOT_ALLOWED_CI_ACTION
    • OPS_STATE_NOT_SET
    • UNPRIORITIZED_OPS_STATE
    • UNSUPPORTED_SYS_ID

    Tipo de dados: Cadeia de caracteres
    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 do IC - PATCH /now/cilifecyclemgmt/leases/

    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//cilifecyclemgmt/leases/

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

    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
    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 Obrigatório. Nome da ação de IC associada.

    Tipo de dados: Cadeia de caracteres
    Leasing Time Obrigatório. Duração de tempo em que o leasing é válido para a ação de IC especificada em actionName.

    Tipo de dados: Cadeia de caracteres

    FORMATO: HH:MM:SS
    Solicitante Obrigató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 do IC - POST /now/cilifecyclemgmt/operators endpoint.

    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. 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
    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 Códigos de resposta HTTP da REST API .

    Tabela 60. Códigos de status
    Código do 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, os códigos de erro e as 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"
}
    resultado.erros Lista de objetos em que cada objeto representa um erro encontrado durante o processamento da 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
    • DUPLICATE_SYS_ID
    • INCOMPATIBLE_CI_ACTION
    • INVALID_CI_ACTION
    • INVALID_DELETE
    • INVALID_INPUT_PARAMETERS
    • INVALID_LEASETIME
    • INVALID_OPS_STATE
    • INVALID_OPS_STATE_TRANSITION
    • INVALID_REQUESTOR
    • INVALID_REQUESTOR_FOR_CI
    • INVALID_SYS_ID
    • MUTEX_UNAVAILABLE
    • NOT_ALLOWED_CI_ACTION
    • OPS_STATE_NOT_SET
    • UNPRIORITIZED_OPS_STATE
    • UNSUPPORTED_SYS_ID

    Tipo de dados: Cadeia de caracteres
    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

    Estender a duração de um leasing de 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 do IC - POST /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 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
    Tabela 62. Parâmetros de consulta
    Nome Descrição
    actionName Obrigatório. Nome da ação de IC a ser adicionada à lista.

    Tipo de dados: Cadeia de caracteres
    Leasing Time Duração de tempo em que 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
    Solicitante Obrigató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 do IC - POST /now/cilifecyclemgmt/operators endpoint.

    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 Obrigató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. 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
    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 Códigos de resposta HTTP da REST API .

    Tabela 66. Códigos de status
    Código do 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, os códigos de erro e as 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"
}
    resultado.erros Lista de objetos em que cada objeto representa um erro encontrado durante o processamento da 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
    • DUPLICATE_SYS_ID
    • INCOMPATIBLE_CI_ACTION
    • INVALID_CI_ACTION
    • INVALID_DELETE
    • INVALID_INPUT_PARAMETERS
    • INVALID_LEASETIME
    • INVALID_OPS_STATE
    • INVALID_OPS_STATE_TRANSITION
    • INVALID_REQUESTOR
    • INVALID_REQUESTOR_FOR_CI
    • INVALID_SYS_ID
    • MUTEX_UNAVAILABLE
    • NOT_ALLOWED_CI_ACTION
    • OPS_STATE_NOT_SET
    • UNPRIORITIZED_OPS_STATE
    • UNSUPPORTED_SYS_ID

    Tipo de dados: Cadeia de caracteres
    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 do 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 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
    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
    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 Códigos de resposta HTTP da REST API .

    Tabela 72. Códigos de status
    Código do 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, os códigos de erro e as 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"
}
    resultado.erros Lista de objetos em que cada objeto representa um erro encontrado durante o processamento da 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
    • DUPLICATE_SYS_ID
    • INCOMPATIBLE_CI_ACTION
    • INVALID_CI_ACTION
    • INVALID_DELETE
    • INVALID_INPUT_PARAMETERS
    • INVALID_LEASETIME
    • INVALID_OPS_STATE
    • INVALID_OPS_STATE_TRANSITION
    • INVALID_REQUESTOR
    • INVALID_REQUESTOR_FOR_CI
    • INVALID_SYS_ID
    • MUTEX_UNAVAILABLE
    • NOT_ALLOWED_CI_ACTION
    • OPS_STATE_NOT_SET
    • UNPRIORITIZED_OPS_STATE
    • UNSUPPORTED_SYS_ID

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

    Tipo de dados: Cadeia de caracteres
    Result.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 do IC - POST /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//cilifecyclemgmt/status

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

    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
    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 Obrigatório. Rótulo do estado operacional a ser definido para os ICs especificados.

    Tipo de dados: Cadeia de caracteres
    Solicitante Obrigató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 do IC - POST /now/cilifecyclemgmt/operators endpoint.

    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 Obrigató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. 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
    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 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 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, os códigos de erro e as 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"
}
    resultado.erros Lista de objetos em que cada objeto representa um erro encontrado durante o processamento da 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
    • DUPLICATE_SYS_ID
    • INCOMPATIBLE_CI_ACTION
    • INVALID_CI_ACTION
    • INVALID_DELETE
    • INVALID_INPUT_PARAMETERS
    • INVALID_LEASETIME
    • INVALID_OPS_STATE
    • INVALID_OPS_STATE_TRANSITION
    • INVALID_REQUESTOR
    • INVALID_REQUESTOR_FOR_CI
    • INVALID_SYS_ID
    • MUTEX_UNAVAILABLE
    • NOT_ALLOWED_CI_ACTION
    • OPS_STATE_NOT_SET
    • UNPRIORITIZED_OPS_STATE
    • UNSUPPORTED_SYS_ID

    Tipo de dados: Cadeia de caracteres
    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 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
  }
}