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


---

# CdmPoliciesApi

# CdmPoliciesApi {#ariaid-title1}

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

CdmPoliciesApi fournit des points de terminaison qui vous permettent de gérer les mappages de politiques des déployables dans Gestion des données de configuration (CDM). Les politiques correctement mappées à un élément déployable sont exécutées lorsqu'un instantané du déployable est validé.  
Vous devez avoir l'un des rôles suivants pour accéder aux points de terminaison de cette API :

* REST scripté CDM : afficher ACL
* ACL administrateur CDM REST scripté

En outre, le module d'extension Gestion des données de configuration (CDM) doit être activé pour que cette API soit disponible dans une instance.

Pour plus d'informations sur les mappages de stratégies, consultez [Mapper les stratégies à un élément déployable](https://www.servicenow.com/docs/access?context=cdm-deployable-map-policy-to&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US).

## CdmPoliciesApi : SUPPRIMER /sn_cdm/politiques/mappages {#ariaid-title2}

Supprime le mappage d'une politique spécifiée à un élément déployable.
L'appelant de ce point de terminaison doit avoir le rôle administrateur CDM.

### Format d'URL

URL versionnée : /api/sn_cdm/{api_version}/policies/mappings

URL par défaut : /api/sn_cdm/policies/mappings

### Paramètres de demande pris en charge

{#policies-DELETE-mappings__entry__2}{#policies-DELETE-mappings__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]

{#policies-DELETE-mappings__entry__6}{#policies-DELETE-mappings__appName-policy-entry}{#policies-DELETE-mappings__deployableName-policy-entry}{#policies-DELETE-mappings__policyName-policy-entry}

| Nom | Description |
|-|-|
| appName | Requis. Nom de l'application (CDM) dont le Gestion des données de configuration mappage à la politique doit être supprimé. Situé dans la table \[sn_cdm_application\] de l'application CDM. Type de données : chaîne |
| deployableName | Requis. Nom de l'élément déployable CDM dont le mappage doit être supprimé à la politique. Situé dans la table Déployable CDM \[sn_cdm_deployable\]. Type de données : chaîne |
| policyName | Requis. Nom de la politique associée. Situé dans la table Politique \[sn_pace_policy\]. Type de données : chaîne |
[Tableau 2. Paramètres de requête]

{#policies-DELETE-mappings__entry__14}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 3. Paramètres du corps de la demande]

### 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.").
{#policies-DELETE-mappings__entry__18}{#policies-DELETE-mappings__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]

{#policies-DELETE-mappings__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.").
{#policies-DELETE-mappings__entry__26}{#policies-DELETE-mappings__entry-200-status-code}{#policies-DELETE-mappings__entry-400-status-code}{#policies-DELETE-mappings__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été correctement traitée. |
| 400 | Demande incorrecte. Le paramètre transmis n'est policyName pas valide. |
| 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]

### Paramètres du corps de réponse

{#policies-DELETE-mappings__entry__34}

| Nom | Description |
|-|-|
| erreur | Si une erreur s'est produite pendant le traitement, les détails de l'erreur. Type de données : objet "error": { "detail": "String", "message": "String" } |
| error.detail | Informations supplémentaires sur l'erreur. Type de données : chaîne |
| message.erreur | Message d'erreur qui a été généré lors de la tentative de traitement de la demande. Type de données : chaîne |
[ ]

### Demande cURL

L'exemple de code suivant montre comment supprimer un mappage de stratégie.

    curl "http://instance.servicenow.com/api/sn_cdm/policies/mappings?deployableName=Development_1&policyName=testALPolicy1&appName=testApp" \ 
    --request DELETE \ 
    --header "Accept:application/json" \ 
    --user 'username':'password'

Pour une suppression réussie du mappage, aucune réponse autre que le code d'état HTTP n'est renvoyée.

    None - results defined by the HTTP status code

## CdmPoliciesApi : OBTENIR /sn_cdm/politiques/mappages/entrées/résolu {#ariaid-title3}

Renvoie les entrées résolues pour un mappage de politique spécifié d'un élément déployable.
Pour plus d'informations sur les mappages de stratégies, consultez [Mapper les stratégies à un déployable](https://www.servicenow.com/docs/access?context=cdm-deployable-map-policy-to&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US) et [Validation et correction des données de configuration](https://www.servicenow.com/docs/access?context=cdm-validating-cfg-data&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US).

L'appelant de ce point de terminaison doit avoir le rôle de visionneur CDM.

### Format d'URL

URL versionnée : /api/sn_cdm/{api_version}/policies/mappings/inputs/resolved

URL par défaut : /api/sn_cdm/policies/mappings/inputs/resolved

### Paramètres de demande pris en charge

{#policies-GET-map-input-resolved__entry__2}{#policies-GET-map-input-resolved__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 7. Paramètres de chemin d'accès]

{#policies-GET-map-input-resolved__entry__6}{#policies-GET-map-input-resolved__appName-policy-row}{#policies-GET-map-input-resolved__deployableName-policy-row}{#policies-GET-map-input-resolved__policyName-policy-entry}

| Nom | Description |
|-|-|
| appName | Requis. Nom de l'application Gestion des données de configuration (CDM) associée au déployable pour laquelle renvoyer les entrées de politique résolues. Situé dans la table \[sn_cdm_application\] de l'application CDM. Type de données : chaîne |
| deployableName | Requis. Nom de l'élément déployable CDM pour lequel renvoyer la politique résolue. Situé dans la table Déployable CDM \[sn_cdm_deployable\]. Type de données : chaîne |
| policyName | Requis. Nom de la politique associée. Situé dans la table Politique \[sn_pace_policy\]. Type de données : chaîne |
[Tableau 8. Paramètres de requête]

{#policies-GET-map-input-resolved__entry__14}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 9. Paramètres du corps de la demande]

### 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.").
{#policies-GET-map-input-resolved__entry__18}{#policies-GET-map-input-resolved__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]

{#policies-GET-map-input-resolved__entry__22}

| 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.").
{#policies-GET-map-input-resolved__entry__26}{#policies-GET-map-input-resolved__entry-200-status-code}{#policies-GET-map-input-resolved__entry-400-status-code}{#policies-GET-map-input-resolved__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été correctement traitée. |
| 400 | Demande incorrecte. Le paramètre transmis n'est policyName pas valide. |
| 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]

### Paramètres du corps de réponse

{#policies-GET-map-input-resolved__entry__34}

| Nom | Description |
|-|-|
| résultat | Liste de paires nom-valeur de toutes les entrées résolues pour le mappage de politique spécifié. Par exemple : `{"input_name >> : << user_1 >>, << input_password >> : << >> }` Type de données : objet |
[ ]

### Demande cURL

L'exemple suivant montre comment utiliser ce point de terminaison pour obtenir les entrées de politique résolues.

    curl "http://instance.servicenow.com/api/sn_cdm/policies/mappings/inputs/resolved?policyName=testALPolicy1&deployableName=Development_1&appName=testApp" \ 
    --request GET \ 
    --header "Accept:application/json" \ 
    --user 'username':'password'

Renvoyer le résultat :

    { 
      "result": { 
        "key1": "someVal", 
        "additionalDeployablesInput": "[{\"id\":\"e7e34a531b501110636e0fe0604bcba9\",\"label\":\"testApp-Development_2\"}]" 
      } 
    }

## CdmPoliciesApi : POST /sn_cdm/politiques/mappages {#ariaid-title4}

Mappe une politique spécifiée à un élément déployable.
L'appelant de ce point de terminaison doit avoir le rôle administrateur CDM.

### Format d'URL

URL versionnée : /api/sn_cdm/{api_version}/policies/mappings

URL par défaut : /api/sn_cdm/policies/mappings

### Paramètres de demande pris en charge

{#policies-POST-mappings__entry__2}{#policies-POST-mappings__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 13. Paramètres de chemin d'accès]

{#policies-POST-mappings__id_ds3_yyg_15b__entry__2}{#policies-POST-mappings__appName-policy-entry}{#policies-POST-mappings__deployableName-policy-entry}{#policies-POST-mappings__policyName-policy-entry}{#policies-POST-mappings__cdm_apps-returnFields-entry}

| Nom | Description |
|-|-|
| appName | Requis. Nom de l'application Gestion des données de configuration (CDM) pour laquelle mapper la politique. Situé dans la table \[sn_cdm_application\] de l'application CDM. Type de données : chaîne |
| deployableName | Requis. Nom du déployable CDM pour lequel mapper la politique. Situé dans la table Déployable CDM \[sn_cdm_deployable\]. Type de données : chaîne |
| policyName | Requis. Nom de la politique associée. Situé dans la table Politique \[sn_pace_policy\]. Type de données : chaîne |
| returnFields | Liste des champs à renvoyer dans le cadre de la réponse. Transmettez les noms des colonnes d'enregistrement tels que sys_id, sys_updated_by ou état. Type de données : tableau Par défaut : tous les champs déterminés par le point de terminaison |
[Tableau 14. Paramètres de requête]

{#policies-POST-mappings__id_ds3_yyg_15b} {#policies-POST-mappings__entry__16}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 15. Paramètres du corps de la demande]

### 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.").
{#policies-POST-mappings__entry__20}{#policies-POST-mappings__accept-JSON-only-entry-RESTAPI}{#policies-POST-mappings__content_type-JSON-only-entry-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Prend uniquement en charge application/json. |
| Content-Type | Format de données du corps de la demande. Prend uniquement en charge application/json. |
[Tableau 16. En-têtes de demandes]

{#policies-POST-mappings__entry__26}

| 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.").
{#policies-POST-mappings__entry__30}{#policies-POST-mappings__entry-200-status-code}{#policies-POST-mappings__entry-400-status-code}{#policies-POST-mappings__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été correctement traitée. |
| 400 | Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté. |
| 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]

### Paramètres du corps de réponse

{#policies-POST-mappings__id_b5l_rbh_15b__entry__2}{#policies-POST-mappings__sys_created_by-policies-entry}{#policies-POST-mappings__sys_created_onpolicies-entry}{#policies-POST-mappings__sys_id-policies-entry}{#policies-POST-mappings__sys_updated_by-policies-entry}{#policies-POST-mappings__sys_updated_on-policies-entry}

| Nom | Description |
|-|-|
| description | Description du mappage. Type de données : chaîne |
| document | Sys_id du document. Type de données : chaîne |
| document_ref | Détails de l'enregistrement de document_ref associé au nœud. Type de données : objet "document_ref": { "link": "String", "value": "String" } |
| document_ref.lien | Syntaxe d'appel pour interroger l'enregistrement déployable mappé à la politique à l'aide de l'API REST de table . PaCE Utilise ce champ pour stocker la référence au déployable mappé à une politique. Type de données : chaîne |
| document_ref.sys_id | Sys_id de l'enregistrement déployable mappé à la politique. Type de données : chaîne |
| erreur | Si une erreur s'est produite pendant le traitement, les détails de l'erreur. Type de données : objet "error": { "detail": "String", "message": "String" } |
| error.detail | Informations supplémentaires sur l'erreur. Type de données : chaîne |
| message.erreur | Message d'erreur qui a été généré lors de la tentative de traitement de la demande. Type de données : chaîne |
| exception | Si une exception se produit lors de la tentative de mappage, le lien vers l'enregistrement d'exception. Type de données : chaîne |
| exception_allowed | Marqueur indiquant si des exceptions sont autorisées pour la politique. Valeurs possibles : * true : les exceptions sont autorisées. * false : les exceptions ne sont pas autorisées. Type de données : booléennes |
| input_status | État des entrées. Valeurs possibles : * non valide * valide Type de données : chaîne |
| last_updated_by | Détails de l'utilisateur qui a mis à jour le mappage de stratégie pour la dernière fois. Type de données : objet "last_updated_by": { "link": "String", "value": "String" } |
| last_updated_by.lien | Syntaxe d'appel pour interroger l'enregistrement utilisateur à l'aide de l'API REST Table . Type de données : chaîne |
| last_updated_by.sys_id | Sys_id de l'enregistrement de l'utilisateur. Situé dans la table Utilisateur \[sys_user\]. Type de données : chaîne |
| Numéro | Numéro unique qui identifie le mappage. Cette valeur fournit un identificateur lisible par l'homme pour le mappage. Type de données : chaîne |
| policy | Détails de l'enregistrement de politique associé au mappage. Type de données : objet "policy": { "link": "String", "value": "String" } |
| policy.link | Syntaxe d'appel pour interroger l'enregistrement de politique mappé à la politique à l'aide de l'API REST de table . Type de données : chaîne |
| policy.sys_id | Sys_id de l'enregistrement de politique. Situé dans la table Politique \[sn_pace_policy\]. Type de données : chaîne |
| motif | Description du motif de l'état actuel. Type de données : chaîne |
| État | État actuel du mappage. Valeurs possibles : * Actif * inactif Type de données : chaîne |
| sys_class_name | Nom de table du mappage de stratégies. Type de données : chaîne |
| sys_created_by | Nom de l'utilisateur qui a créé le mappage. Type de données : chaîne |
| sys_created_on | Date et heure auxquelles le mappage a été créé. Type de données : chaîne Format : aaaa-mm-jj hh :mm :ss |
| sys_id | Sys_id du mappage. Situé dans la table Mappage de stratégie \[sn_pace_policy_mapping\]. Type de données : chaîne |
| sys_updated_by | Nom de l'utilisateur qui a mis à jour le mappage. Type de données : chaîne |
| sys_updated_on | Date et heure auxquelles le mappage a été mis à mis à jour. Type de données : chaîne Format : aaaa-mm-jj hh :mm :ss |
[ ]

{#policies-POST-mappings__id_b5l_rbh_15b}  

### Demande cURL

Cet exemple de code montre comment mapper une politique spécifique à un élément déployable.

    curl "http://instance.servicenow.com/api/sn_cdm/policies/mappings?appName=testApp&deployableName=Development_1&policyName=testALPolicy1" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --user 'username':'password'

Résultats renvoyés :

    { 
      "result": { 
        "exception": null, 
        "reason": null, 
        "exception_allowed": "--", 
        "document": "0be34a531b501110636e0fe0604bcb21", 
        "input_status": "valid", 
        "description": null, 
        "sys_updated_on": "2022-06-30 14:07:37", 
        "sys_class_name": "sn_cdm_pace_policy_mapping", 
        "sys_id": "ea24469f1b101110636e0fe0604bcbed", 
        "number": "MAP0001001", 
        "last_updated_by": { 
          "value": "48630e131b501110636e0fe0604bcb53", 
          "link": "https://instance.servicenow.com/api/now/table/sys_user/48630e131b501110636e0fe0604bcb53" 
        }, 
        "sys_updated_by": "admin", 
        "sys_created_on": "2022-06-30 14:07:37", 
        "document_ref": { 
          "value": "0be34a531b501110636e0fe0604bcb21", 
          "link": "https://instance.servicenow.com/api/now/table/sn_cdm_deployable/0be34a531b501110636e0fe0604bcb21" 
        }, 
        "state": "active", 
        "sys_created_by": "admin", 
        "policy": { 
          "value": "12a3c2531b501110636e0fe0604bcb9b", 
          "link": "https://instance.servicenow.com/api/now/table/sn_pace_policy/12a3c2531b501110636e0fe0604bcb9b" 
        } 
      } 
    }

## CdmPoliciesApi : PUT /sn_cdm/politiques/mappages/entrées/déployables-supplémentaires {#ariaid-title5}

Met à jour la variable d'entrée additionalDeployablesInput d'un Gestion des données de configuration mappage de politique (CDM).
La variable d'entrée additionalDeployablesInput contient les déployables supplémentaires que vous pouvez affecter à un mappage de stratégie existant. Elles sont similaires aux entrées de mappage, mais elles ont une structure de tableau spécifique.

Pour plus d'informations sur les mappages de stratégies, consultez [Mapper les stratégies à un élément déployable](https://www.servicenow.com/docs/access?context=cdm-deployable-map-policy-to&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US).

L'appelant de ce point de terminaison doit avoir le rôle administrateur CDM.

### Format d'URL

URL versionnée : /api/sn_cdm/{api_version}/policies/mappings/inputs/additional-deployables

URL par défaut : /api/sn_cdm/policies/mappings/inputs/additional-deployables

### Paramètres de demande pris en charge

{#policies-PUT-map-input-add-deploy__entry__2}{#policies-PUT-map-input-add-deploy__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]

{#policies-PUT-map-input-add-deploy__entry__6}{#policies-PUT-map-input-add-deploy__appName-policy-row}{#policies-PUT-map-input-add-deploy__deployableName-policy-row}{#policies-PUT-map-input-add-deploy__policyName-policy-entry}{#policies-PUT-map-input-add-deploy__cdm_apps-returnFields-entry}

| Nom | Description |
|-|-|
| additionalDeployables | Requis. Liste des déployables à ajouter à la variable d'entrée additionalDeployablesInput. Type de données : tableau d'objets "additionalDeployables": [ { "appName": "String", "deployableName": "String" } ] |
| additionalDeployables.appName | Requis. Nom de l'application CDM à laquelle le déployable est associé. Situé dans la table \[sn_cdm_application\] de l'application CDM. Type de données : chaîne |
| additionalDeployables.deployableName | Requis. Nom de l'élément déployable CDM à ajouter à la variable d'entrée additionalDeployablesInput. Situé dans la table Déployable CDM \[sn_cdm_deployable\]. Type de données : chaîne |
| appName | Requis. Nom de l'application CDM dont la variable d'entrée additionalDeployablesInput doit être mise à jour. Situé dans la table \[sn_cdm_application\] de l'application CDM. Type de données : chaîne |
| deployableName | Requis. Nom du déployable CDM pour lequel mettre à jour la variable d'entrée additionalDeployablesInput. Situé dans la table Déployable CDM \[sn_cdm_deployable\]. Type de données : chaîne |
| policyName | Requis. Nom de la politique associée. Situé dans la table Politique \[sn_pace_policy\]. Type de données : chaîne |
| returnFields | Liste des champs à renvoyer dans le cadre de la réponse. Transmettez les noms des colonnes d'enregistrement tels que sys_id, sys_updated_by ou état. Type de données : tableau Par défaut : tous les champs déterminés par le point de terminaison |
[Tableau 20. Paramètres de requête]

{#policies-PUT-map-input-add-deploy__entry__22}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 21. Paramètres du corps de la demande]

### 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.").
{#policies-PUT-map-input-add-deploy__entry__26}{#policies-PUT-map-input-add-deploy__accept-JSON-only-entry-RESTAPI}{#policies-PUT-map-input-add-deploy__content_type-JSON-only-entry-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Prend uniquement en charge application/json. |
| Content-Type | Format de données du corps de la demande. Prend uniquement en charge application/json. |
[Tableau 22. En-têtes de demandes]

{#policies-PUT-map-input-add-deploy__entry__32}

| 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.").
{#policies-PUT-map-input-add-deploy__entry__36}{#policies-PUT-map-input-add-deploy__entry-200-status-code}{#policies-PUT-map-input-add-deploy__entry-400-status-code}{#policies-PUT-map-input-add-deploy__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été correctement traitée. |
| 400 | Demande incorrecte. Le paramètre transmis n'est policyName pas valide. |
| 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]

### Paramètres du corps de réponse

{#policies-PUT-map-input-add-deploy__id_jx1_px2_c5b__entry__2}

| Nom | Description |
|-|-|
| io_definition | Détails sur l'enregistrement de définition E/S associé.PaCE Pour en savoir plus sur , reportez-vous à PaCEla section [Policy as Code Engine (PaCE)](https://www.servicenow.com/docs/access?context=pace-managing-policies&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US). Type de données : objet "io_definition": { "link": "String", "value": "String" } |
| io_definition.lien | Syntaxe d'appel pour interroger cet PaCE enregistrement de définition d'E/S à l'aide de l'API REST de table . Type de données : chaîne |
| io_definition.valeur | Sys_id de l'enregistrement de définition d'E PaCE /S. Situé dans la table Mappage d'E/S \[sn_pace_io_mapping\]. Type de données : chaîne |
| is_unused | Marqueur indiquant si la variable d'entrée de mappage est inutilisée. Valeurs possibles : * vrai : la variable d'entrée de mappage associée n'est pas utilisée actuellement. * false : la variable d'entrée de mappage associée est actuellement utilisée. {#policies-PUT-map-input-add-deploy__ul_gcm_t1l_25b} Type de données : booléennes |
| mapped_value | Valeur actuelle de la variable d'entrée de mappage. Type de données : tableau d'objets ou chaîne |
| policy_mapping | Détails sur l'enregistrement de mappage de stratégie PaCE . Pour en savoir plus sur , reportez-vous à PaCEla section [Policy as Code Engine (PaCE)](https://www.servicenow.com/docs/access?context=pace-managing-policies&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US). Type de données : objet "policy_mapping": { "link": "String", "value": "String" } |
| policy_mapping.lien | Syntaxe d'appel pour interroger l'enregistrement de mappage de politique à l'aide de l'API REST de table . Type de données : chaîne |
| policy_mapping.valeur | Sys_id de l'enregistrement PaCE de mappage de stratégie. Situé dans la table Mappage de stratégie \[sn_pace_policy_mapping\]. Type de données : chaîne |
| sys_created_by | Nom de l'utilisateur qui a créé la variable d'entrée de mappage. Type de données : chaîne |
| sys_created_on | Date et heure de création de la variable d'entrée de mappage. Type de données : chaîne Format : aaaa-mm-jj hh :mm :ss |
| sys_id | Sys_id de l'enregistrement de mappage associé. Situé dans la table Mappage d'E/S \[sn_pace_io_mapping\]. Type de données : chaîne |
| sys_updated_by | Nom de l'utilisateur qui a mis à jour la variable d'entrée de mappage. Type de données : chaîne |
| sys_updated_on | Date et heure auxquelles la variable d'entrée de mappage a été mise à mis à jour. Type de données : chaîne Format : aaaa-mm-jj hh :mm :ss |
[ ]

{#policies-PUT-map-input-add-deploy__id_jx1_px2_c5b}  

### Demande cURL

L'exemple suivant montre comment ajouter des déployables à une variable d'entrée additionalDeployablesInput.

    curl "https://instance.servicenow.com/api/sn_cdm/policies/mappings/inputs/additional-deployables?additionalDeployables=%5B%7B%22appName%22%3A%20%22testApp%22%2C%20%22deployableName%22%3A%22Development_2%22%7D%5D&policyName=testALPolicy1&deployableName=Development_1&appName=testApp" \ 
    --request PUT \ 
    --header "Accept:application/json" \ 
    --user 'admin':'admin

Renvoyer le résultat :

    { 
      "result": { 
        "sys_id": "6bb746171b501110636e0fe0604bcb1c", 
        "policy_mapping": { 
          "value": "6bb746171b501110636e0fe0604bcb1b", 
          "link": "https://instance.servicenow.com/api/now/table/sn_cdm_pace_policy_mapping/6bb746171b501110636e0fe0604bcb1b" 
        }, 
        "sys_updated_by": "ameya", 
        "sys_created_on": "2022-06-30 14:23:15", 
        "io_definition": { 
          "value": "4d0b061b1b501110636e0fe0604bcb2f", 
          "link": "https://instance.servicenow.com/api/now/table/sn_pace_io_definition/4d0b061b1b501110636e0fe0604bcb2f" 
        }, 
        "mapped_value": "[{\"id\":\"e7e34a531b501110636e0fe0604bcba9\",\"label\":\"testApp-Development_2\"}]", 
        "sys_updated_on": "2022-06-30 14:53:21", 
        "sys_created_by": "ameya", 
        "is_unused": false 
      } 
    } 

## CdmPoliciesApi : PUT /sn_cdm/politiques/mappages/entrées {#ariaid-title6}

Met à jour une variable d'entrée spécifiée pour un mappage de Gestion des données de configuration politique (CDM).
Pour plus d'informations sur les mappages de police, consultez [Mapper les politiques à un élément déployable](https://www.servicenow.com/docs/access?context=cdm-deployable-map-policy-to&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US).

L'appelant de ce point de terminaison doit avoir le rôle administrateur CDM.

### Format d'URL

URL versionnée : /api/sn_cdm/{api_version}/policies/mappings/inputs

URL par défaut : /api/sn_cdm/policies/mappings/inputs

### Paramètres de demande pris en charge

{#policies-PUT-mappings-inputs__entry__2}{#policies-PUT-mappings-inputs__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 25. Paramètres de chemin d'accès]

{#policies-PUT-mappings-inputs__entry__6}{#policies-PUT-mappings-inputs__appName-policy-row}{#policies-PUT-mappings-inputs__deployableName-policy-row}{#policies-PUT-mappings-inputs__policyName-policy-entry}{#policies-PUT-mappings-inputs__cdm_apps-returnFields-entry}

| Nom | Description |
|-|-|
| appName | Requis. Nom de l'application CDM dont les entrées de mappage de stratégie doivent être mises à jour. Situé dans la table \[sn_cdm_application\] de l'application CDM. Type de données : chaîne |
| deployableName | Requis. Nom du déployable CDM dont les entrées de mappage de stratégie doivent être mises à jour. Situé dans la table Déployable CDM \[sn_cdm_deployable\]. Type de données : chaîne |
| Nom d'entrée | Requis. Nom de la variable d'entrée à mettre à jour. Les variables d'entrée disponibles sont définies dans la table Mappage d'E/S \[sn_pace_io_mapping\]. Type de données : chaîne |
| valeur d'entrée | Requis. Valeur à affecter à la variable d'entrée. Type de données : dépend de la variable d'entrée. Vous pouvez trouver le type de données dans la table Mappage d'E/S \[sn_pace_io_mapping\]. |
| policyName | Requis. Nom de la politique associée. Situé dans la table Politique \[sn_pace_policy\]. Type de données : chaîne |
| returnFields | Liste des champs à renvoyer dans le cadre de la réponse. Transmettez les noms des colonnes d'enregistrement tels que sys_id, sys_updated_by ou état. Type de données : tableau Par défaut : tous les champs déterminés par le point de terminaison |
[Tableau 26. Paramètres de requête]

{#policies-PUT-mappings-inputs__entry__20}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 27. Paramètres du corps de la demande]

### 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.").
{#policies-PUT-mappings-inputs__entry__24}{#policies-PUT-mappings-inputs__accept-JSON-only-entry-RESTAPI}{#policies-PUT-mappings-inputs__content_type-JSON-only-entry-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Prend uniquement en charge application/json. |
| Content-Type | Format de données du corps de la demande. Prend uniquement en charge application/json. |
[Tableau 28. En-têtes de demandes]

{#policies-PUT-mappings-inputs__entry__30}

| 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.").
{#policies-PUT-mappings-inputs__entry__34}{#policies-PUT-mappings-inputs__entry-200-status-code}{#policies-PUT-mappings-inputs__entry-400-status-code}{#policies-PUT-mappings-inputs__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été correctement traitée. |
| 400 | Demande incorrecte. Le paramètre transmis n'est policyName pas valide. |
| 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]

### Paramètres du corps de réponse

{#policies-PUT-mappings-inputs__id_tny_nx2_c5b__entry__2}

| Nom | Description |
|-|-|
| io_definition | Détails sur l'enregistrement de définition E/S associé.PaCE Pour en savoir plus sur , reportez-vous à PaCEla section [Policy as Code Engine (PaCE)](https://www.servicenow.com/docs/access?context=pace-managing-policies&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US). Type de données : objet "io_definition": { "link": "String", "value": "String" } |
| io_definition.lien | Syntaxe d'appel pour interroger cet PaCE enregistrement de définition d'E/S à l'aide de l'API REST de table . Type de données : chaîne |
| io_definition.valeur | Sys_id de l'enregistrement de définition d'E PaCE /S. Situé dans la table Mappage d'E/S \[sn_pace_io_mapping\]. Type de données : chaîne |
| is_unused | Marqueur indiquant si la variable d'entrée de mappage est inutilisée. Valeurs possibles : * vrai : la variable d'entrée de mappage associée n'est pas utilisée actuellement. * false : la variable d'entrée de mappage associée est actuellement utilisée. {#policies-PUT-mappings-inputs__ul_gcm_t1l_25b} Type de données : booléennes |
| mapped_value | Valeur actuelle de la variable d'entrée de mappage. Type de données : tableau d'objets ou chaîne |
| policy_mapping | Détails sur l'enregistrement de mappage de stratégie PaCE . Pour en savoir plus sur , reportez-vous à PaCEla section [Policy as Code Engine (PaCE)](https://www.servicenow.com/docs/access?context=pace-managing-policies&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US). Type de données : objet "policy_mapping": { "link": "String", "value": "String" } |
| policy_mapping.lien | Syntaxe d'appel pour interroger l'enregistrement de mappage de politique à l'aide de l'API REST de table . Type de données : chaîne |
| policy_mapping.valeur | Sys_id de l'enregistrement PaCE de mappage de stratégie. Situé dans la table Mappage de stratégie \[sn_pace_policy_mapping\]. Type de données : chaîne |
| sys_created_by | Nom de l'utilisateur qui a créé la variable d'entrée de mappage. Type de données : chaîne |
| sys_created_on | Date et heure de création de la variable d'entrée de mappage. Type de données : chaîne Format : aaaa-mm-jj hh :mm :ss |
| sys_id | Sys_id de l'enregistrement de mappage associé. Situé dans la table Mappage d'E/S \[sn_pace_io_mapping\]. Type de données : chaîne |
| sys_updated_by | Nom de l'utilisateur qui a mis à jour la variable d'entrée de mappage. Type de données : chaîne |
| sys_updated_on | Date et heure auxquelles la variable d'entrée de mappage a été mise à mis à jour. Type de données : chaîne Format : aaaa-mm-jj hh :mm :ss |
[ ]

{#policies-PUT-mappings-inputs__id_tny_nx2_c5b}  

### Demande cURL

L'exemple suivant montre comment mettre à jour la variable d'entrée key1 associée à testALPolicy.

    curl "http://instance.servicenow.com/api/sn_cdm/policies/mappings/inputs?policyName=testALPolicy1&appName=testApp&inputValue=value1&inputName=key1&deployableName=Development_1" \ 
    --request PUT \ 
    --header "Accept:application/json" \ 
    --user 'username':'password'

Résultats renvoyés :

    { 
      "result": { 
        "sys_id": "631b861b1b501110636e0fe0604bcb6f", 
        "policy_mapping": { 
          "value": "6bb746171b501110636e0fe0604bcb1b", 
          "link": "https://instance.servicenow.com/api/now/table/sn_cdm_pace_policy_mapping/6bb746171b501110636e0fe0604bcb1b" 
        }, 
        "sys_updated_by": "admin", 
        "sys_created_on": "2022-06-30 14:38:00", 
        "io_definition": { 
          "value": "fe1b061b1b501110636e0fe0604bcb90", 
          "link": "https://instance.servicenow.comm/api/now/table/sn_pace_io_definition/fe1b061b1b501110636e0fe0604bcb90" 
        }, 
        "mapped_value": "someVal", 
        "sys_updated_on": "2022-06-30 14:39:21", 
        "sys_created_by": "admin", 
        "is_unused": false 
      } 
    }