---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# API de gestion du cycle de vie des CI

# API de gestion du cycle de vie des CI {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 34 minutes de lecture

L'API Gestion du cycle de vie des CI fournit des points de terminaison pour manipuler les états opérationnels des éléments de configuration (CI) et appliquer des actions de CI.
Les interfaces d'API respectent les restrictions et les autorisations spécifiées par les actions de CI non autorisées, les actions de CI compatibles et les transitions opérationnelles non autorisées. Si une interface tente une opération restreinte, l'opération est bloquée, une erreur est signalée et une tâche est créée, le cas échéant.

## Gestion du cycle de vie des CI : DELETE /now/cilifecyclemgmt/actions {#ariaid-title2}

Supprime une action d'élément de configuration (CI) pour une liste de CI.

### Format d'URL {#cilifecyclemgmt-DELETE-actions__section_fcm_jph_dmb}

URL versionnée : /api/now/{api_version}/cilifecyclemgmt/actions

URL par défaut : /api/now/cilifecyclemgmt/actions

### Paramètres de demande pris en charge

{#cilifecyclemgmt-DELETE-actions__entry__2}{#cilifecyclemgmt-DELETE-actions__version-RESTAPI}

| Nom | Description |
|-|-|
| api_version | Facultatif. Version du point de terminaison auquel accéder. Exemple : <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne |
[Tableau 1. Paramètres de chemin d'accès]

{#cilifecyclemgmt-DELETE-actions__entry__6}{#cilifecyclemgmt-DELETE-actions__requestor-id-query-param-desc-entry}

| Nom | Description |
|-|-|
| actionName | Requis. Nom de l'action de l'élément de configuration. Type de données : chaîne |
| ID du demandeur | Requis. Sys_id d'un contexte de workflow ou d'un ID utilisateur opérateur renvoyé à partir du [Gestion du cycle de vie des CI : POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/pysgN3XjX1aXg571hpc2Aw#cilifecyclemgmt-POST-operators "Enregistre un opérateur pour un utilisateur qui ne fait pas partie du workflow.") point de terminaison. Les ID utilisateur opérateurs se trouvent dans la table Utilisateurs avec état inscrit \[statemgmt_register_users\]. Type de données : chaîne |
| sysIds | Requis. Liste de sys_ids de CI séparés par des virgules. Type de données : chaîne |
[Tableau 2. Paramètres de requête]

{#cilifecyclemgmt-DELETE-actions__entry__14}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 3. Paramètres de corps de demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cilifecyclemgmt-DELETE-actions__entry__18}{#cilifecyclemgmt-DELETE-actions__accept-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
[Tableau 4. En-têtes de demandes]

{#cilifecyclemgmt-DELETE-actions__entry__22}

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 5. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cilifecyclemgmt-DELETE-actions__table_od5_2wf_mmb__entry__2}{#cilifecyclemgmt-DELETE-actions__status-codes-200-desc-entry}{#cilifecyclemgmt-DELETE-actions__entry-401-status-code}{#cilifecyclemgmt-DELETE-actions__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été traitée avec succès par le point de terminaison. Examinez le paramètre du corps result.result de la réponse pour vérifier le résultat de l'opération. Si le point de terminaison rencontre des erreurs lors du traitement de la demande, des codes et messages d'erreur s'affichent dans le paramètre corps de la réponse result.errors . |
| 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. |
| 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. |
[Tableau 6. Codes d'état]

{#cilifecyclemgmt-DELETE-actions__table_od5_2wf_mmb}

### Paramètres du corps de réponse (JSON ou XML)

{#cilifecyclemgmt-DELETE-actions__entry__34}

| Nom | Description |
|-|-|
| résultat | Objet encapsulant le résultat de la demande. Type de données : objet "result": { "errors": [Array], "result": "String" } |
| Résultat.Erreurs | Liste des objets dans lesquels chaque objet représente une erreur rencontrée lors du traitement de la demande. Type de données : tableau "errors": [ { "error": "String", "message": "String" } ] |
| Résultat.Erreurs.Erreur | Identificateur d'une erreur de gestion des états rencontrée lors du traitement de la demande. Valeurs possibles : * CI_ACTION_ALREADY_SET * CI_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 {#cilifecyclemgmt-DELETE-actions__ul_ghk_2fk_lmb} Type de données : chaîne |
| résultat.erreurs.message | Message fournissant des détails sur le fichier associé error. Type de données : chaîne |
| résultat.résultat | Marqueur indiquant si l'action de CI a été supprimée avec succès. Valeurs possibles : * vrai : l'action du CI a été supprimée. * faux : l'action de CI n'a pas été supprimée. {#cilifecyclemgmt-DELETE-actions__ul_psg_lsh_dmb} Type de données : chaîne |
[ ]

### Demande cURL

Supprimer une action de CI de deux CI.

    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"

Le corps de réponse confirme que l'action de CI a été supprimée des CI.

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

## Gestion du cycle de vie des CI : DELETE /now/cilifecyclemgmt/operators/{req_id} {#ariaid-title3}

Annule l'inscription d'un opérateur pour les utilisateurs n'appartenant pas au workflow.

### Format d'URL {#cilifecyclemgmt-DELETE-operators__section_xyw_syh_dmb}

URL versionnée : /api/now/{api_version}/cilifecyclemgmt/operators/{req_id}

URL par défaut : /api/now/cilifecyclemgmt/operators/{req_id}

### Paramètres de demande pris en charge

{#cilifecyclemgmt-DELETE-operators__entry__2}{#cilifecyclemgmt-DELETE-operators__version-RESTAPI}{#cilifecyclemgmt-DELETE-operators__req-id-data-type-p}

| Paramètre | Description |
|-|-|
| api_version | Facultatif. Version du point de terminaison auquel accéder. Exemple : <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne |
| req_id | Sys_id d'un contexte de workflow ou d'un ID utilisateur opérateur renvoyé à partir du [Gestion du cycle de vie des CI : POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/pysgN3XjX1aXg571hpc2Aw#cilifecyclemgmt-POST-operators "Enregistre un opérateur pour un utilisateur qui ne fait pas partie du workflow.") point de terminaison. Les ID utilisateur opérateurs se trouvent dans la table Utilisateurs avec état inscrit \[statemgmt_register_users\].{#cilifecyclemgmt-DELETE-operators__req-id-table-p} Type de données : chaîne |
[Tableau 7. Paramètres de chemin d'accès]

{#cilifecyclemgmt-DELETE-operators__entry__8}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 8. Paramètres de requête]

{#cilifecyclemgmt-DELETE-operators__entry__12}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 9. Paramètres de corps de demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cilifecyclemgmt-DELETE-operators__entry__16}{#cilifecyclemgmt-DELETE-operators__accept-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
[Tableau 10. En-têtes de demandes]

{#cilifecyclemgmt-DELETE-operators__entry__20}

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 11. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cilifecyclemgmt-DELETE-operators__table_hsj_2wf_mmb__entry__2}{#cilifecyclemgmt-DELETE-operators__status-codes-200-desc-entry}{#cilifecyclemgmt-DELETE-operators__entry-401-status-code}{#cilifecyclemgmt-DELETE-operators__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été traitée avec succès par le point de terminaison. Examinez le paramètre du corps result.result de la réponse pour vérifier le résultat de l'opération. Si le point de terminaison rencontre des erreurs lors du traitement de la demande, des codes et messages d'erreur s'affichent dans le paramètre corps de la réponse result.errors . |
| 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. |
| 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. |
[Tableau 12. Codes d'état]

{#cilifecyclemgmt-DELETE-operators__table_hsj_2wf_mmb}

### Paramètres du corps de réponse (JSON ou XML)

{#cilifecyclemgmt-DELETE-operators__table_kkt_tlk_lmb__entry__2}

| Nom | Description |
|-|-|
| résultat | Objet encapsulant le résultat de la demande. Type de données : objet "result": { "errors": [Array], "result": "String" } |
| Résultat.Erreurs | Liste des objets dans lesquels chaque objet représente une erreur rencontrée lors du traitement de la demande. Type de données : tableau "errors": [ { "error": "String", "message": "String" } ] |
| Résultat.Erreurs.Erreur | Identificateur d'une erreur de gestion des états rencontrée lors du traitement de la demande. Valeurs possibles : * CI_ACTION_ALREADY_SET * CI_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 {#cilifecyclemgmt-DELETE-operators__ul_ghk_2fk_lmb} Type de données : chaîne |
| résultat.erreurs.message | Message fournissant des détails sur le fichier associé error. Type de données : chaîne |
| résultat.résultat | Marqueur indiquant si l'opérateur a été désinscrit avec succès. Valeurs possibles : * true : l'inscription de l'opérateur a été annulée avec succès. * false : l'opérateur n'a pas été désinscrit. {#cilifecyclemgmt-DELETE-operators__ul_mkt_tlk_lmb} Type de données : chaîne |
[ ]

{#cilifecyclemgmt-DELETE-operators__table_kkt_tlk_lmb}  

### Demande cURL

Annuler l'inscription d'un opérateur par ID d'utilisateur.

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

L'organisme de réponse vérifie que l'opérateur n'était pas enregistré.

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

## Gestion du cycle de vie des CI : GET /now/cilifecyclemgmt/actions/{sys_id} {#ariaid-title4}

Renvoie une liste des actions d'élément de configuration (CI) actives pour le CI spécifié.

### Format d'URL {#cilifecyclemgmt-GET-actions__section_m1y_5xm_dmb}

URL versionnée : /api/now/{api_version}/cilifecyclemgmt/actions/{sys_id}

URL par défaut : /api/now/cilifecyclemgmt/actions/{sys_id}

### Paramètres de demande pris en charge

{#cilifecyclemgmt-GET-actions__entry__2}{#cilifecyclemgmt-GET-actions__version-RESTAPI}

| Nom | Description |
|-|-|
| api_version | Facultatif. Version du point de terminaison auquel accéder. Exemple : <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne |
| sys_id | Sys_id du CI pour lequel renvoyer les actions de CI associées. Type de données : chaîne |
[Tableau 13. Paramètres de chemin d'accès]

{#cilifecyclemgmt-GET-actions__entry__8}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 14. Paramètres de requête]

{#cilifecyclemgmt-GET-actions__entry__12}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 15. Paramètres de corps de demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cilifecyclemgmt-GET-actions__entry__16}{#cilifecyclemgmt-GET-actions__accept-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
[Tableau 16. En-têtes de demandes]

{#cilifecyclemgmt-GET-actions__entry__20}

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 17. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cilifecyclemgmt-GET-actions__table_lrs_cwf_mmb__entry__2}{#cilifecyclemgmt-GET-actions__status-codes-200-desc-entry}{#cilifecyclemgmt-GET-actions__entry-401-status-code}{#cilifecyclemgmt-GET-actions__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été traitée avec succès par le point de terminaison. Examinez le paramètre du corps result.ciActions de la réponse pour vérifier le résultat de l'opération. Si le point de terminaison rencontre des erreurs lors du traitement de la demande, des codes et messages d'erreur s'affichent dans le paramètre corps de la réponse result.errors . |
| 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. |
| 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. |
[Tableau 18. Codes d'état]

{#cilifecyclemgmt-GET-actions__table_lrs_cwf_mmb}

### Paramètres du corps de réponse (JSON ou XML)

{#cilifecyclemgmt-GET-actions__entry__32}

| Nom | Description |
|-|-|
| résultat | Objet encapsulant le résultat de la demande. Type de données : objet "result": { "errors": [Array], "result": "String" } |
| result.ciActions | Liste séparée par des virgules des actions de CI actives pour le CI, ou `no_active_action` si aucune n'a été trouvée. Type de données : chaîne |
| Résultat.Erreurs | Liste des objets dans lesquels chaque objet représente une erreur rencontrée lors du traitement de la demande. Type de données : tableau "errors": [ { "error": "String", "message": "String" } ] |
| Résultat.Erreurs.Erreur | Identificateur d'une erreur de gestion des états rencontrée lors du traitement de la demande. Valeurs possibles : * CI_ACTION_ALREADY_SET * CI_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 {#cilifecyclemgmt-GET-actions__ul_ghk_2fk_lmb} Type de données : chaîne |
| résultat.erreurs.message | Message fournissant des détails sur le fichier associé error. Type de données : chaîne |
| résultat.résultat | Marqueur indiquant si la liste des actions de CI actives a été renvoyée pour tous les CI spécifiés. Valeurs possibles : * vrai : la liste des actions de CI actives a été renvoyée. * faux : la liste des actions de CI actives n'a pas été renvoyée. {#cilifecyclemgmt-GET-actions__ul_psg_lsh_dmb} Type de données : chaîne |
[ ]

### Demande cURL

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

Le corps de la réponse montre qu'aucune action de CI n'est active pour le CI spécifié.

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

## Gestion du cycle de vie des CI : GET /now/cilifecyclemgmt/compatActions {#ariaid-title5}

Détermine si deux actions d'élément de configuration (CI) spécifiées sont compatibles.

### Format d'URL {#cilifecyclemgmt-GET-compatAction__section_rgg_g2n_dmb}

URL versionnée : /api/now/{api_version}/cilifecyclemgmt/compatActions

URL par défaut : /api/now/cilifecyclemgmt/compatActions

### Paramètres de demande pris en charge

{#cilifecyclemgmt-GET-compatAction__entry__2}{#cilifecyclemgmt-GET-compatAction__version-RESTAPI}

| Nom | Description |
|-|-|
| api_version | Facultatif. Version du point de terminaison auquel accéder. Exemple : <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne |
[Tableau 19. Paramètres de chemin d'accès]

{#cilifecyclemgmt-GET-compatAction__entry__6}

| Nom | Description |
|-|-|
| actionName | Requis. Nom de l'action de CI à comparer. Type de données : chaîne |
| otherActionName | Requis. Nom de l'action de CI à comparer. Type de données : chaîne |
[Tableau 20. Paramètres de requête]

{#cilifecyclemgmt-GET-compatAction__entry__12}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 21. Paramètres de corps de demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cilifecyclemgmt-GET-compatAction__entry__16}{#cilifecyclemgmt-GET-compatAction__accept-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
[Tableau 22. En-têtes de demandes]

{#cilifecyclemgmt-GET-compatAction__entry__20}

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 23. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cilifecyclemgmt-GET-compatAction__table_vz1_cwf_mmb__entry__2}{#cilifecyclemgmt-GET-compatAction__status-codes-200-desc-entry}{#cilifecyclemgmt-GET-compatAction__entry-401-status-code}{#cilifecyclemgmt-GET-compatAction__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été traitée avec succès par le point de terminaison. Examinez le paramètre du corps result.result de la réponse pour vérifier le résultat de l'opération. Si le point de terminaison rencontre des erreurs lors du traitement de la demande, des codes et messages d'erreur s'affichent dans le paramètre corps de la réponse result.errors . |
| 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. |
| 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. |
[Tableau 24. Codes d'état]

{#cilifecyclemgmt-GET-compatAction__table_vz1_cwf_mmb}

### Paramètres du corps de réponse (JSON ou XML)

{#cilifecyclemgmt-GET-compatAction__entry__32}

| Nom | Description |
|-|-|
| résultat | Marqueur indiquant si les deux actions de CI spécifiées sont compatibles. Valeurs possibles : * vrai : les actions des CI sont compatibles. * faux : les actions de CI ne sont pas compatibles. {#cilifecyclemgmt-GET-compatAction__ul_hsp_chn_dmb} Type de données : chaîne |
[ ]

### Demande cURL

Vérifiez la compatibilité des actions de CI de mise à jour corrective et de mise en service.

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

Le corps de la réponse confirme que les deux actions de CI sont compatibles.

    {
      "result": true
    }

## Gestion du cycle de vie des CI : GET /now/cilifecyclemgmt/leases/{sys_id}/expired {#ariaid-title6}

Détermine si le bail a expiré pour le demandeur d'une action d'élément de configuration (CI) appliquée au CI spécifié.

### Format d'URL {#cilifecyclemgmt-GET-leases-expired__section_kgl_mjn_dmb}

URL versionnée : /api/now/{api_version}/cilifecyclemgmt/leases/{sys_id}/expired

URL par défaut : /api/now/cilifecyclemgmt/leases/{sys_id}/expired

### Paramètres de demande pris en charge

{#cilifecyclemgmt-GET-leases-expired__entry__2}{#cilifecyclemgmt-GET-leases-expired__version-RESTAPI}

| Nom | Description |
|-|-|
| api_version | Facultatif. Version du point de terminaison auquel accéder. Exemple : <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne |
| sys_id | Sys_id du CI qui est la cible de l'action de CI appliquée. Type de données : chaîne |
[Tableau 25. Paramètres de chemin d'accès]

{#cilifecyclemgmt-GET-leases-expired__entry__8}{#cilifecyclemgmt-GET-leases-expired__requestor-id-query-param-desc-entry}

| Nom | Description |
|-|-|
| actionName | Requis. Nom de l'action de CI appliquée au CI spécifié. Type de données : chaîne |
| ID du demandeur | Requis. Sys_id d'un contexte de workflow ou d'un ID utilisateur opérateur renvoyé à partir du [Gestion du cycle de vie des CI : POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/pysgN3XjX1aXg571hpc2Aw#cilifecyclemgmt-POST-operators "Enregistre un opérateur pour un utilisateur qui ne fait pas partie du workflow.") point de terminaison. Les ID utilisateur opérateurs se trouvent dans la table Utilisateurs avec état inscrit \[statemgmt_register_users\]. Type de données : chaîne |
[Tableau 26. Paramètres de requête]

{#cilifecyclemgmt-GET-leases-expired__entry__14}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 27. Paramètres de corps de demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cilifecyclemgmt-GET-leases-expired__entry__18}{#cilifecyclemgmt-GET-leases-expired__accept-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
[Tableau 28. En-têtes de demandes]

{#cilifecyclemgmt-GET-leases-expired__entry__22}

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 29. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cilifecyclemgmt-GET-leases-expired__table_hwr_bwf_mmb__entry__2}{#cilifecyclemgmt-GET-leases-expired__status-codes-200-desc-entry}{#cilifecyclemgmt-GET-leases-expired__entry-401-status-code}{#cilifecyclemgmt-GET-leases-expired__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été traitée avec succès par le point de terminaison. Examinez le paramètre du corps result.result de la réponse pour vérifier le résultat de l'opération. Si le point de terminaison rencontre des erreurs lors du traitement de la demande, des codes et messages d'erreur s'affichent dans le paramètre corps de la réponse result.errors . |
| 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. |
| 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. |
[Tableau 30. Codes d'état]

{#cilifecyclemgmt-GET-leases-expired__table_hwr_bwf_mmb}

### Paramètres du corps de réponse (JSON ou XML)

{#cilifecyclemgmt-GET-leases-expired__entry__34}

| Nom | Description |
|-|-|
| résultat | Objet encapsulant le résultat de la demande. Type de données : objet "result": { "errors": [Array], "result": "String" } |
| Résultat.Erreurs | Liste des objets dans lesquels chaque objet représente une erreur rencontrée lors du traitement de la demande. Type de données : tableau "errors": [ { "error": "String", "message": "String" } ] |
| Résultat.Erreurs.Erreur | Identificateur d'une erreur de gestion des états rencontrée lors du traitement de la demande. Valeurs possibles : * CI_ACTION_ALREADY_SET * CI_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 {#cilifecyclemgmt-GET-leases-expired__ul_ghk_2fk_lmb} Type de données : chaîne |
| résultat.erreurs.message | Message fournissant des détails sur le fichier associé error. Type de données : chaîne |
| résultat.résultat | Marqueur indiquant si le bail du demandeur de l'action de CI appliquée a expiré. Valeurs possibles : * vrai : le bail du demandeur a expiré. * faux : le bail du demandeur n'a pas expiré. {#cilifecyclemgmt-GET-leases-expired__ul_hsp_chn_dmb} Type de données : chaîne |
[ ]

### Demande 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"

Le corps de la réponse montre que le bail du demandeur de l'action de CI appliquée n'a pas expiré.

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

## Gestion du cycle de vie des CI : GET /now/cilifecyclemgmt/notAllowedAction {#ariaid-title7}

Détermine si une action d'élément de configuration (CI) spécifiée n'est pas autorisée pour un CI d'une classe spécifiée lorsqu'il se trouve dans un état opérationnel spécifié.

### Format d'URL {#cilifecyclemgmt-GET-notAllowedAct__section_wbv_pln_dmb}

URL versionnée : /api/now/{api_version}/cilifecyclemgmt/notAllowedAction

URL par défaut : /api/now/cilifecyclemgmt/notAllowedAction

### Paramètres de demande pris en charge

{#cilifecyclemgmt-GET-notAllowedAct__entry__2}{#cilifecyclemgmt-GET-notAllowedAct__version-RESTAPI}

| Nom | Description |
|-|-|
| api_version | Facultatif. Version du point de terminaison auquel accéder. Exemple : <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne |
[Tableau 31. Paramètres de chemin d'accès]

{#cilifecyclemgmt-GET-notAllowedAct__entry__6}

| Nom | Description |
|-|-|
| actionName | Requis. Nom de l'action de CI à vérifier. Type de données : chaîne |
| ciClass | Requis. Classe CI. Type de données : chaîne |
| opsLabel (en anglais seulement) | Requis. État opérationnel à vérifier. Type de données : chaîne |
[Tableau 32. Paramètres de requête]

{#cilifecyclemgmt-GET-notAllowedAct__entry__14}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 33. Paramètres de corps de demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cilifecyclemgmt-GET-notAllowedAct__entry__18}{#cilifecyclemgmt-GET-notAllowedAct__accept-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
[Tableau 34. En-têtes de demandes]

{#cilifecyclemgmt-GET-notAllowedAct__entry__22}

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 35. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cilifecyclemgmt-GET-notAllowedAct__table_qqg_bwf_mmb__entry__2}{#cilifecyclemgmt-GET-notAllowedAct__status-codes-200-desc-entry}{#cilifecyclemgmt-GET-notAllowedAct__entry-401-status-code}{#cilifecyclemgmt-GET-notAllowedAct__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été traitée avec succès par le point de terminaison. Examinez le paramètre du corps result.result de la réponse pour vérifier le résultat de l'opération. Si le point de terminaison rencontre des erreurs lors du traitement de la demande, des codes et messages d'erreur s'affichent dans le paramètre corps de la réponse result.errors . |
| 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. |
| 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. |
[Tableau 36. Codes d'état]

{#cilifecyclemgmt-GET-notAllowedAct__table_qqg_bwf_mmb}

### Paramètres du corps de réponse (JSON ou XML)

{#cilifecyclemgmt-GET-notAllowedAct__entry__34}

| Nom | Description |
|-|-|
| résultat | Marqueur indiquant si l'action de CI est restreinte (non autorisée) pour les CI du type spécifié lorsqu'ils sont dans l'état opérationnel spécifié. Valeurs possibles : * vrai : l'action de CI est restreinte (non autorisée). * faux : l'action de CI n'est pas restreinte (autorisée). {#cilifecyclemgmt-GET-notAllowedAct__ul_hsp_chn_dmb} Type de données : chaîne |
[ ]

### Demande cURL

Vérifiez si l'action de correction de CI est restreinte (non autorisée) pour les ordinateurs dans l'état opérationnel Récupération d'urgence en veille.

    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"

Le corps de réponse confirme que cette action est restreinte (non autorisée) pour la classe CI spécifiée lorsqu'elle est dans l'état opérationnel spécifié.

    {
      "result": true
    }

## Gestion du cycle de vie des CI : GET /now/cilifecyclemgmt/notAllowedOpsTransition {#ariaid-title8}

Détermine si un élément de configuration (CI) d'une classe spécifiée peut passer d'un état opérationnel spécifié à un deuxième état opérationnel spécifié.

### Format d'URL {#cilifecyclemgmt-GET-notAllowedOps__section_dmp_44n_dmb}

URL versionnée : /api/now/{api_version}/cilifecyclemgmt/notAllowedOpsTransition

URL par défaut : /api/now/cilifecyclemgmt/notAllowedOpsTransition

### Paramètres de demande pris en charge

{#cilifecyclemgmt-GET-notAllowedOps__entry__2}{#cilifecyclemgmt-GET-notAllowedOps__version-RESTAPI}

| Nom | Description |
|-|-|
| api_version | Facultatif. Version du point de terminaison auquel accéder. Exemple : <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne |
[Tableau 37. Paramètres de chemin d'accès]

{#cilifecyclemgmt-GET-notAllowedOps__entry__6}

| Nom | Description |
|-|-|
| ciClass | Requis. Classe CI pour laquelle vérifier les restrictions de transition. Type de données : chaîne |
| opsLabel (en anglais seulement) | Requis. Étiquette de l'état opérationnel du CI actuel. Type de données : chaîne |
| transitionOpsLabel (en anglais seulement) | Requis. Étiquette de l'état opérationnel qui est la cible de la transition. Type de données : chaîne |
[Tableau 38. Paramètres de requête]

{#cilifecyclemgmt-GET-notAllowedOps__entry__14}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 39. Paramètres de corps de demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cilifecyclemgmt-GET-notAllowedOps__entry__18}{#cilifecyclemgmt-GET-notAllowedOps__accept-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
[Tableau 40. En-têtes de demandes]

{#cilifecyclemgmt-GET-notAllowedOps__entry__22}

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 41. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cilifecyclemgmt-GET-notAllowedOps__table_clt_1wf_mmb__entry__2}{#cilifecyclemgmt-GET-notAllowedOps__status-codes-200-desc-entry}{#cilifecyclemgmt-GET-notAllowedOps__entry-401-status-code}{#cilifecyclemgmt-GET-notAllowedOps__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été traitée avec succès par le point de terminaison. Examinez le paramètre du corps result.result de la réponse pour vérifier le résultat de l'opération. Si le point de terminaison rencontre des erreurs lors du traitement de la demande, des codes et messages d'erreur s'affichent dans le paramètre corps de la réponse result.errors . |
| 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. |
| 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. |
[Tableau 42. Codes d'état]

{#cilifecyclemgmt-GET-notAllowedOps__table_clt_1wf_mmb}

### Paramètres du corps de réponse (JSON ou XML)

{#cilifecyclemgmt-GET-notAllowedOps__entry__34}

| Nom | Description |
|-|-|
| résultat | Marqueur indiquant si la transition d'état opérationnel spécifiée est restreinte (non autorisée) pour la classe CI spécifiée. Valeurs possibles : * true : la transition d'état opérationnel est restreinte (non autorisée). * false : la transition d'état opérationnel n'est soumise à aucune restriction (autorisée). {#cilifecyclemgmt-GET-notAllowedOps__ul_hsp_chn_dmb} Type de données : chaîne |
[ ]

### Demande cURL

Vérifiez si la transition de l'état opérationnel Mis hors service à l'état opérationnel Récupération d'urgence en veille est restreinte (non autorisée) pour les CI de serveur 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"

Le corps de la réponse montre que la transition d'état opérationnel spécifiée n'est pas restreinte (autorisée) pour cette classe CI.

    {
      "result": false
    }

## Gestion du cycle de vie des CI : GET /now/cilifecyclemgmt/requestors/{req_id}/valid {#ariaid-title9}

Détermine si l'utilisateur actif du workflow spécifié ou l'utilisateur inscrit est un demandeur valide.

### Format d'URL {#cilifecyclemgmt-GET-req-valid__section_gdl_3d4_dmb}

URL versionnée : /api/now/{api_version}/cilifecyclemgmt/requestors/{req_id}/valid

URL par défaut : /api/now/cilifecyclemgmt/requestors/{req_id}/valid

### Paramètres de demande pris en charge

{#cilifecyclemgmt-GET-req-valid__entry__2}{#cilifecyclemgmt-GET-req-valid__version-RESTAPI}{#cilifecyclemgmt-GET-req-valid__req-id-data-type-p}

| Nom | Description |
|-|-|
| api_version | Facultatif. Version du point de terminaison auquel accéder. Exemple : <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne |
| req_id | Sys_id d'un contexte de workflow ou d'un ID utilisateur opérateur renvoyé à partir du [Gestion du cycle de vie des CI : POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/pysgN3XjX1aXg571hpc2Aw#cilifecyclemgmt-POST-operators "Enregistre un opérateur pour un utilisateur qui ne fait pas partie du workflow.") point de terminaison. Les ID utilisateur opérateurs se trouvent dans la table Utilisateurs avec état inscrit \[statemgmt_register_users\].{#cilifecyclemgmt-GET-req-valid__req-id-table-p} Type de données : chaîne |
[Tableau 43. Paramètres de chemin d'accès]

{#cilifecyclemgmt-GET-req-valid__entry__8}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 44. Paramètres de requête]

{#cilifecyclemgmt-GET-req-valid__entry__12}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 45. Paramètres de corps de demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cilifecyclemgmt-GET-req-valid__entry__16}{#cilifecyclemgmt-GET-req-valid__accept-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
[Tableau 46. En-têtes de demandes]

{#cilifecyclemgmt-GET-req-valid__entry__20}

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 47. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cilifecyclemgmt-GET-req-valid__table_mbj_1wf_mmb__entry__2}{#cilifecyclemgmt-GET-req-valid__status-codes-200-desc-entry}{#cilifecyclemgmt-GET-req-valid__entry-401-status-code}{#cilifecyclemgmt-GET-req-valid__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été traitée avec succès par le point de terminaison. Examinez le paramètre du corps result.result de la réponse pour vérifier le résultat de l'opération. Si le point de terminaison rencontre des erreurs lors du traitement de la demande, des codes et messages d'erreur s'affichent dans le paramètre corps de la réponse result.errors . |
| 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. |
| 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. |
[Tableau 48. Codes d'état]

{#cilifecyclemgmt-GET-req-valid__table_mbj_1wf_mmb}

### Paramètres du corps de réponse (JSON ou XML)

{#cilifecyclemgmt-GET-req-valid__entry__32}

| Nom | Description |
|-|-|
| résultat | Objet encapsulant le résultat de la demande. Type de données : objet "result": { "errors": [Array], "result": "String" } |
| Résultat.Erreurs | Liste des objets dans lesquels chaque objet représente une erreur rencontrée lors du traitement de la demande. Type de données : tableau "errors": [ { "error": "String", "message": "String" } ] |
| Résultat.Erreurs.Erreur | Identificateur d'une erreur de gestion des états rencontrée lors du traitement de la demande. Valeurs possibles : * CI_ACTION_ALREADY_SET * CI_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 {#cilifecyclemgmt-GET-req-valid__ul_ghk_2fk_lmb} Type de données : chaîne |
| résultat.erreurs.message | Message fournissant des détails sur le fichier associé error. Type de données : chaîne |
| résultat.résultat | Marqueur indiquant si l'utilisateur actif du workflow spécifié ou l'utilisateur inscrit est un demandeur valide. Valeurs possibles : * vrai : demandeur valide. * faux : demandeur non valide. {#cilifecyclemgmt-GET-req-valid__ul_hsp_chn_dmb} Type de données : chaîne |
[ ]

### Demande 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
      }
    }

## Gestion du cycle de vie des CI : GET /now/cilifecyclemgmt/statuses/{sys_id} {#ariaid-title10}

Renvoie l'état opérationnel actuel de l'élément de configuration (CI) spécifié.

### Format d'URL {#cilifecyclemgmt-GET-statuses__section_bgd_bf4_dmb}

URL versionnée : /api/now/{api_version}/cilifecyclemgmt/statuses/{sys_id}

URL par défaut : /api/now/cilifecyclemgmt/statuses/{sys_id}

### Paramètres de demande pris en charge

{#cilifecyclemgmt-GET-statuses__entry__2}{#cilifecyclemgmt-GET-statuses__version-RESTAPI}

| Nom | Description |
|-|-|
| api_version | Facultatif. Version du point de terminaison auquel accéder. Exemple : <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne |
| sys_id | Sys_id du CI. Type de données : chaîne |
[Tableau 49. Paramètres de chemin d'accès]

{#cilifecyclemgmt-GET-statuses__entry__8}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 50. Paramètres de requête]

{#cilifecyclemgmt-GET-statuses__entry__12}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 51. Paramètres de corps de demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cilifecyclemgmt-GET-statuses__entry__16}{#cilifecyclemgmt-GET-statuses__accept-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
[Tableau 52. En-têtes de demandes]

{#cilifecyclemgmt-GET-statuses__entry__20}

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 53. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cilifecyclemgmt-GET-statuses__table_pdp_yvf_mmb__entry__2}{#cilifecyclemgmt-GET-statuses__status-codes-200-desc-entry}{#cilifecyclemgmt-GET-statuses__entry-401-status-code}{#cilifecyclemgmt-GET-statuses__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été traitée avec succès par le point de terminaison. Examinez le paramètre du corps result.result de la réponse pour vérifier le résultat de l'opération. Si le point de terminaison rencontre des erreurs lors du traitement de la demande, des codes et messages d'erreur s'affichent dans le paramètre corps de la réponse result.errors . |
| 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. |
| 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. |
[Tableau 54. Codes d'état]

{#cilifecyclemgmt-GET-statuses__table_pdp_yvf_mmb}

### Paramètres du corps de réponse (JSON ou XML)

{#cilifecyclemgmt-GET-statuses__entry__32}

| Nom | Description |
|-|-|
| résultat | Objet encapsulant le résultat de la demande. Type de données : objet "result": { "errors": [Array], "result": "String" } |
| Résultat.Erreurs | Liste des objets dans lesquels chaque objet représente une erreur rencontrée lors du traitement de la demande. Type de données : tableau "errors": [ { "error": "String", "message": "String" } ] |
| Résultat.Erreurs.Erreur | Identificateur d'une erreur de gestion des états rencontrée lors du traitement de la demande. Valeurs possibles : * CI_ACTION_ALREADY_SET * CI_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 {#cilifecyclemgmt-GET-statuses__ul_ghk_2fk_lmb} Type de données : chaîne |
| résultat.erreurs.message | Message fournissant des détails sur le fichier associé error. Type de données : chaîne |
| result.operationalStates | État opérationnel pour le CI spécifié ou `inconnu` si aucun état n'est spécifié. Type de données : chaîne |
[ ]

### Demande 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
      }
    }

## Gestion du cycle de vie des CI : PATCH /now/cilifecyclemgmt/leases/{sys_id} {#ariaid-title11}

Prolonge le délai d'expiration du bail de l'action de l'élément de configuration (CI) spécifié pour l'utilisateur spécifié.
Si le bail précédent a expiré, la nouvelle période de bail commence immédiatement.

### Format d'URL {#cilifecyclemgmt-PATCH-leases__section_c22_hp4_dmb}

URL versionnée : /api/now/{api_version}/cilifecyclemgmt/leases/{sys_id}

URL par défaut : /api/now/cilifecyclemgmt/leases/{sys_id}

### Paramètres de demande pris en charge

{#cilifecyclemgmt-PATCH-leases__entry__2}{#cilifecyclemgmt-PATCH-leases__version-RESTAPI}

| Nom | Description |
|-|-|
| api_version | Facultatif. Version du point de terminaison auquel accéder. Exemple : <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne |
| sys_id | Sys_id du CI pour lequel prolonger le bail. Type de données : chaîne |
[Tableau 55. Paramètres de chemin d'accès]

{#cilifecyclemgmt-PATCH-leases__entry__8}{#cilifecyclemgmt-PATCH-leases__requestor-id-query-param-desc-entry}

| Nom | Description |
|-|-|
| actionName | Requis. Nom de l'action de CI associée. Type de données : chaîne |
| leaseTime | Requis. Durée de validité du bail pour l'action de CI spécifiée dans actionName. Type de données : chaîne Format : HH :MM :SS |
| ID du demandeur | Requis. Sys_id d'un contexte de workflow ou d'un ID utilisateur opérateur renvoyé à partir du [Gestion du cycle de vie des CI : POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/pysgN3XjX1aXg571hpc2Aw#cilifecyclemgmt-POST-operators "Enregistre un opérateur pour un utilisateur qui ne fait pas partie du workflow.") point de terminaison. Les ID utilisateur opérateurs se trouvent dans la table Utilisateurs avec état inscrit \[statemgmt_register_users\]. Type de données : chaîne |
[Tableau 56. Paramètres de requête]

{#cilifecyclemgmt-PATCH-leases__entry__16}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 57. Paramètres de corps de demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cilifecyclemgmt-PATCH-leases__entry__20}{#cilifecyclemgmt-PATCH-leases__accept-RESTAPI}{#cilifecyclemgmt-PATCH-leases__content_type-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
| Content-Type | Format de données du corps de la demande. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
[Tableau 58. En-têtes de demandes]

{#cilifecyclemgmt-PATCH-leases__entry__26}

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 59. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cilifecyclemgmt-PATCH-leases__table_rwq_xvf_mmb__entry__2}{#cilifecyclemgmt-PATCH-leases__status-codes-200-desc-entry}{#cilifecyclemgmt-PATCH-leases__entry-401-status-code}{#cilifecyclemgmt-PATCH-leases__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été traitée avec succès par le point de terminaison. Examinez le paramètre du corps result.result de la réponse pour vérifier le résultat de l'opération. Si le point de terminaison rencontre des erreurs lors du traitement de la demande, des codes et messages d'erreur s'affichent dans le paramètre corps de la réponse result.errors . |
| 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. |
| 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. |
[Tableau 60. Codes d'état]

{#cilifecyclemgmt-PATCH-leases__table_rwq_xvf_mmb}

### Paramètres du corps de réponse (JSON ou XML)

{#cilifecyclemgmt-PATCH-leases__entry__38}

| Nom | Description |
|-|-|
| résultat | Objet encapsulant le résultat de la demande. Type de données : objet "result": { "errors": [Array], "result": "String" } |
| Résultat.Erreurs | Liste des objets dans lesquels chaque objet représente une erreur rencontrée lors du traitement de la demande. Type de données : tableau "errors": [ { "error": "String", "message": "String" } ] |
| Résultat.Erreurs.Erreur | Identificateur d'une erreur de gestion des états rencontrée lors du traitement de la demande. Valeurs possibles : * CI_ACTION_ALREADY_SET * CI_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 {#cilifecyclemgmt-PATCH-leases__ul_ghk_2fk_lmb} Type de données : chaîne |
| résultat.erreurs.message | Message fournissant des détails sur le fichier associé error. Type de données : chaîne |
| résultat.résultat | Marqueur indiquant si la durée du bail a été prolongée. Valeurs possibles : * true : la durée du bail a été prolongée. * faux : la durée du bail n'a pas été prolongée. {#cilifecyclemgmt-PATCH-leases__ul_hsp_chn_dmb} Type de données : chaîne |
[ ]

### Demande cURL

Prolongez de 24 heures la durée de bail d'un demandeur d'action de CI d'application de correctif.

    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
      }
    }

## Gestion du cycle de vie des CI : POST /now/cilifecyclemgmt/actions {#ariaid-title12}

Ajoute une action d'élément de configuration (CI) spécifiée à une liste spécifiée de CI.

### Format d'URL {#cilifecyclemgmt-POST-actions__section_lmz_dv4_dmb}

URL versionnée : /api/now/{api_version}/cilifecyclemgmt/actions

URL par défaut : /api/now/cilifecyclemgmt/actions

### Paramètres de demande pris en charge

{#cilifecyclemgmt-POST-actions__entry__2}{#cilifecyclemgmt-POST-actions__version-RESTAPI}

| Nom | Description |
|-|-|
| api_version | Facultatif. Version du point de terminaison auquel accéder. Exemple : <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne |
[Tableau 61. Paramètres de chemin d'accès]

{#cilifecyclemgmt-POST-actions__entry__6}{#cilifecyclemgmt-POST-actions__requestor-id-query-param-desc-entry}

| Nom | Description |
|-|-|
| actionName | Requis. Nom de l'action de CI à ajouter à la liste. Type de données : chaîne |
| leaseTime | Durée pendant laquelle le bail est valide pour l'action de CI spécifiée. Type de données : chaîne Format : HH :MM :SS |
| oldActionNames | Liste séparée par des virgules des anciennes actions de CI dans lesquelles tous les CI doivent figurer. Type de données : chaîne |
| ID du demandeur | Requis. Sys_id d'un contexte de workflow ou d'un ID utilisateur opérateur renvoyé à partir du [Gestion du cycle de vie des CI : POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/pysgN3XjX1aXg571hpc2Aw#cilifecyclemgmt-POST-operators "Enregistre un opérateur pour un utilisateur qui ne fait pas partie du workflow.") point de terminaison. Les ID utilisateur opérateurs se trouvent dans la table Utilisateurs avec état inscrit \[statemgmt_register_users\]. Type de données : chaîne |
| sysIds | Requis. Liste de sys_ids de CI séparés par des virgules auxquels ajouter l'action de CI. Type de données : chaîne |
[Tableau 62. Paramètres de requête]

{#cilifecyclemgmt-POST-actions__entry__18}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 63. Paramètres de corps de demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cilifecyclemgmt-POST-actions__entry__22}{#cilifecyclemgmt-POST-actions__accept-RESTAPI}{#cilifecyclemgmt-POST-actions__content_type-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
| Content-Type | Format de données du corps de la demande. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
[Tableau 64. En-têtes de demandes]

{#cilifecyclemgmt-POST-actions__entry__28}

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 65. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cilifecyclemgmt-POST-actions__table_wj1_xvf_mmb__entry__2}{#cilifecyclemgmt-POST-actions__status-codes-200-desc-entry}{#cilifecyclemgmt-POST-actions__entry-401-status-code}{#cilifecyclemgmt-POST-actions__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été traitée avec succès par le point de terminaison. Examinez le paramètre du corps result.result de la réponse pour vérifier le résultat de l'opération. Si le point de terminaison rencontre des erreurs lors du traitement de la demande, des codes et messages d'erreur s'affichent dans le paramètre corps de la réponse result.errors . |
| 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. |
| 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. |
[Tableau 66. Codes d'état]

{#cilifecyclemgmt-POST-actions__table_wj1_xvf_mmb}

### Paramètres du corps de réponse (JSON ou XML)

{#cilifecyclemgmt-POST-actions__entry__40}

| Nom | Description |
|-|-|
| résultat | Objet encapsulant le résultat de la demande. Type de données : objet "result": { "errors": [Array], "result": "String" } |
| Résultat.Erreurs | Liste des objets dans lesquels chaque objet représente une erreur rencontrée lors du traitement de la demande. Type de données : tableau "errors": [ { "error": "String", "message": "String" } ] |
| Résultat.Erreurs.Erreur | Identificateur d'une erreur de gestion des états rencontrée lors du traitement de la demande. Valeurs possibles : * CI_ACTION_ALREADY_SET * CI_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 {#cilifecyclemgmt-POST-actions__ul_ghk_2fk_lmb} Type de données : chaîne |
| résultat.erreurs.message | Message fournissant des détails sur le fichier associé error. Type de données : chaîne |
| résultat.résultat | Marqueur indiquant si l'action de CI a été définie pour tous les CI de la liste. Valeurs possibles : * vrai : les actions du CI ont été définies. * faux : les actions de CI n'ont pas été définies. {#cilifecyclemgmt-POST-actions__ul_hsp_chn_dmb} Type de données : chaîne |
[ ]

### Demande cURL

Ajouter une action de CI d'application de correctif à deux CI.

    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
      }
    }

## Gestion du cycle de vie des CI : POST /now/cilifecyclemgmt/operators {#ariaid-title13}

Enregistre un opérateur pour un utilisateur qui ne fait pas partie du workflow.

### Format d'URL {#cilifecyclemgmt-POST-operators__section_b3l_kv4_dmb}

URL versionnée : /api/now/{api_version}/cilifecyclemgmt/operators

URL par défaut : /api/now/cilifecyclemgmt/operators

### Paramètres de demande pris en charge

{#cilifecyclemgmt-POST-operators__entry__2}{#cilifecyclemgmt-POST-operators__version-RESTAPI}

| Nom | Description |
|-|-|
| api_version | Facultatif. Version du point de terminaison auquel accéder. Exemple : <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne |
[Tableau 67. Paramètres de chemin d'accès]

{#cilifecyclemgmt-POST-operators__entry__6}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 68. Paramètres de requête]

{#cilifecyclemgmt-POST-operators__entry__10}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 69. Paramètres de corps de demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cilifecyclemgmt-POST-operators__entry__14}{#cilifecyclemgmt-POST-operators__accept-RESTAPI}{#cilifecyclemgmt-POST-operators__content_type-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
| Content-Type | Format de données du corps de la demande. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
[Tableau 70. En-têtes de demandes]

{#cilifecyclemgmt-POST-operators__entry__20}

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 71. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cilifecyclemgmt-POST-operators__table_oj2_wvf_mmb__entry__2}{#cilifecyclemgmt-POST-operators__status-codes-200-desc-entry}{#cilifecyclemgmt-POST-operators__entry-401-status-code}{#cilifecyclemgmt-POST-operators__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été traitée avec succès par le point de terminaison. Examinez le paramètre du corps result.result de la réponse pour vérifier le résultat de l'opération. Si le point de terminaison rencontre des erreurs lors du traitement de la demande, des codes et messages d'erreur s'affichent dans le paramètre corps de la réponse result.errors . |
| 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. |
| 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. |
[Tableau 72. Codes d'état]

{#cilifecyclemgmt-POST-operators__table_oj2_wvf_mmb}

### Paramètres du corps de réponse (JSON ou XML)

{#cilifecyclemgmt-POST-operators__entry__32}

| Nom | Description |
|-|-|
| résultat | Objet encapsulant le résultat de la demande. Type de données : objet "result": { "errors": [Array], "result": "String" } |
| Résultat.Erreurs | Liste des objets dans lesquels chaque objet représente une erreur rencontrée lors du traitement de la demande. Type de données : tableau "errors": [ { "error": "String", "message": "String" } ] |
| Résultat.Erreurs.Erreur | Identificateur d'une erreur de gestion des états rencontrée lors du traitement de la demande. Valeurs possibles : * CI_ACTION_ALREADY_SET * CI_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 {#cilifecyclemgmt-POST-operators__ul_ghk_2fk_lmb} Type de données : chaîne |
| résultat.erreurs.message | Message fournissant des détails sur le fichier associé error. Type de données : chaîne |
| result.requestorId | GUID pour l'opérateur enregistré. Utilisez cette valeur pour définir les actions de CI et les états opérationnels. Type de données : chaîne |
| résultat.résultat | Marqueur indiquant si l'opérateur a été enregistré avec succès. Valeurs possibles : * true : l'opérateur a été enregistré avec succès. * false : l'opérateur n'a pas été correctement enregistré. {#cilifecyclemgmt-POST-operators__ul_hsp_chn_dmb} Type de données : chaîne |
[ ]

### Demande 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"
      }
    }

## Gestion du cycle de vie des CI : POST /now/cilifecyclemgmt/statuses {#ariaid-title14}

Définit l'état opérationnel pour une liste spécifiée d'éléments de configuration (CI).

### Format d'URL {#cilifecyclemgmt-POST-statuses__section_shp_tw4_dmb}

URL versionnée : /api/now/{api_version}/cilifecyclemgmt/statuses

URL par défaut : /api/now/cilifecyclemgmt/statuses

### Paramètres de demande pris en charge

{#cilifecyclemgmt-POST-statuses__entry__2}{#cilifecyclemgmt-POST-statuses__version-RESTAPI}

| Nom | Description |
|-|-|
| api_version | Facultatif. Version du point de terminaison auquel accéder. Exemple : <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne |
[Tableau 73. Paramètres de chemin d'accès]

{#cilifecyclemgmt-POST-statuses__entry__6}{#cilifecyclemgmt-POST-statuses__requestor-id-query-param-desc-entry}

| Nom | Description |
|-|-|
| oldOpsLabels | Liste séparée par des virgules des anciens états opérationnels de CI dans lesquels tous les CI doivent être inclus. Type de données : chaîne |
| opsLabel (en anglais seulement) | Requis. Étiquette de l'état opérationnel à définir pour les CI spécifiés. Type de données : chaîne |
| ID du demandeur | Requis. Sys_id d'un contexte de workflow ou d'un ID utilisateur opérateur renvoyé à partir du [Gestion du cycle de vie des CI : POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/pysgN3XjX1aXg571hpc2Aw#cilifecyclemgmt-POST-operators "Enregistre un opérateur pour un utilisateur qui ne fait pas partie du workflow.") point de terminaison. Les ID utilisateur opérateurs se trouvent dans la table Utilisateurs avec état inscrit \[statemgmt_register_users\]. Type de données : chaîne |
| sysIds | Requis. Liste séparée par des virgules de sys_ids de CI pour lesquels l'état opérationnel doit être défini. Type de données : chaîne |
[Tableau 74. Paramètres de requête]

{#cilifecyclemgmt-POST-statuses__entry__16}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 75. Paramètres de corps de demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cilifecyclemgmt-POST-statuses__entry__20}{#cilifecyclemgmt-POST-statuses__accept-RESTAPI}{#cilifecyclemgmt-POST-statuses__content_type-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
| Content-Type | Format de données du corps de la demande. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
[Tableau 76. En-têtes de demandes]

{#cilifecyclemgmt-POST-statuses__entry__26}

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 77. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cilifecyclemgmt-POST-statuses__entry__30}{#cilifecyclemgmt-POST-statuses__status-codes-200-desc-entry}{#cilifecyclemgmt-POST-statuses__entry-401-status-code}{#cilifecyclemgmt-POST-statuses__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été traitée avec succès par le point de terminaison. Examinez le paramètre du corps result.result de la réponse pour vérifier le résultat de l'opération. Si le point de terminaison rencontre des erreurs lors du traitement de la demande, des codes et messages d'erreur s'affichent dans le paramètre corps de la réponse result.errors . |
| 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. |
| 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. |
[Tableau 78. Codes d'état]

### Paramètres du corps de réponse (JSON ou XML)

{#cilifecyclemgmt-POST-statuses__entry__38}

| Nom | Description |
|-|-|
| résultat | Objet encapsulant le résultat de la demande. Type de données : objet "result": { "errors": [Array], "result": "String" } |
| Résultat.Erreurs | Liste des objets dans lesquels chaque objet représente une erreur rencontrée lors du traitement de la demande. Type de données : tableau "errors": [ { "error": "String", "message": "String" } ] |
| Résultat.Erreurs.Erreur | Identificateur d'une erreur de gestion des états rencontrée lors du traitement de la demande. Valeurs possibles : * CI_ACTION_ALREADY_SET * CI_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 {#cilifecyclemgmt-POST-statuses__ul_ghk_2fk_lmb} Type de données : chaîne |
| résultat.erreurs.message | Message fournissant des détails sur le fichier associé error. Type de données : chaîne |
| résultat.résultat | Marqueur indiquant si l'état souhaité a été défini pour tous les CI inclus dans la demande. Valeurs possibles : * vrai : état opérationnel défini. * faux : état opérationnel non défini. {#cilifecyclemgmt-POST-statuses__ul_hsp_chn_dmb} Type de données : chaîne |
[ ]

### Demande cURL

Définissez l'état opérationnel `Réparation en cours` pour deux CI.

    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"

Le corps de la réponse indique que l'état opérationnel souhaité a été défini pour les deux CI spécifiés dans la demande.

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