---
sourceDocument: Capacidades da Now Platform da Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/servicenow-platform

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Capacidades da Now Platform da Yokohama

ft:clusterId :

    - platcap

bundleId :

    - platcap

workflow :

    - Platform


---

# APIs de gestão de ciclo de vida

# APIs de gestão de ciclo de vida {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

A Gestão de ciclo de vida do IC fornece um conjunto de APIs de gestão de estados para gerenciar estados operacionais de IC e aplicar ações de IC.

As APIs de Gestão de estados 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 API tentar executar uma operação restrita, a operação será bloqueada, um erro será registrado em log e uma tarefa será criada automaticamente se apropriado.

As APIs de gestão de ciclo de vida podem definir estados operacionais e ações de IC para grupos do CMDB ao usar APIs de gestão de ciclo de vida em massa.

## APIs de registro

* registerOperator() --- método para registrar o operador com a Gestão de estados para usuário sem fluxo de trabalho.
* unregisterOperator(String requestorId) --- método para cancelar o registro do operador para usuários sem fluxo de trabalho.
* isValidRequestor(String requestorId) --- método para determinar se o solicitante especificado é um usuário de fluxo de trabalho ativo válido ou um usuário registrado.
* isLeaseExpired(String requestorId, String ciSysId, String ciActionName) --- método para verificar se o leasing do usuário registrado expirou.
* extendCIActionLease(String requestorId, String ciSysId, String ciActionName, String leaseTime) --- método para estender o tempo de leasing da ação de IC para usuários registrados. Se o leasing anterior já tiver expirado, estenda o leasing a partir de agora.
{#state_mgmt-api__ul_gyt_hdd_pw}

## APIs de estado operacional

* setBulkCIOperationalState(String requestorId, String sysIdList, String opsLabel, String opsStateListOld) --- método para definir o Estado operacional de uma matriz de ICs.
* getOperationalState(String ciSysId) --- método para obter o Estado operacional de IC.
{#state_mgmt-api__ul_xdd_xfd_pw}

## APIs de ações de IC

* addBulkCIAction(String requestorId, String sysIdList, String ciActionName, String ciActionListOld, String leaseTime) --- método para adicionar uma Ação de IC a uma matriz de ICs.
* removeBulkCIAction(String requestorId, String sysIdList, String ciActionName) --- método para remover uma Ação de IC de uma lista de ICs.
* getCIActions(String ciSysId) --- método para obter Ações de IC.
{#state_mgmt-api__ul_kwt_2gd_pw}

## Ação não permitida com base na API do estado operacional {#state_mgmt-api__section_igw_shs_nsb}

isNotAllowedAction(String ciType, String opsLabel, String actionName) --- método para verificar se uma ação de IC específica não é permitida para um Estado operacional específico em um Tipo de IC.

## API de transição de estado operacional não permitida {#state_mgmt-api__section_jgw_shs_nsb}

isNotAllowedOpsTransition(String ciType, String opsLabel, String transitionOpsLabel) --- método para verificar se uma transição de estado operacional específica não é permitida em um Tipo de IC.

## API de ação compatível {#state_mgmt-api__section_kgw_shs_nsb}

isCompatibleCIAction(String actionName, String otherActionName) --- método para verificar se duas ações específicas são compatíveis entre si.  

## Como usar APIs de Gestão de estados

    // 1. Register Operator with State Mgmt
    var output = SNC.StateManagementScriptableApi.registerOperator();
    var jsonUntil = new JSON();
    var result = jsonUntil.decode(output);
    var requestorId = result.requestorId;

    // Get list of sys_ids to update
    var sys_ids;

    // 2. Set list of sys_ids's Operational State to 'Repair in Progress'
    output = SNC.StateManagementScriptableApi.setBulkCIOperationalState(requestorId, sys_ids,'Repair in Progress');
    gs.print(output);

    // 3. Set list of sys_ids's CI Action State to 'Patching'
    output = SNC.StateManagementScriptableApi.addBulkCIAction(requestorId, sys_ids, 'Patching');
    gs.print(output);