CdmPoliciesApi

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 17 minutes de lecture

    • CdmPoliciesApi fournit des points de terminaison qui vous permettent de gérer les mappages de politiques des déployables dans Configuration Data Management (CDM). Les politiques correctement mappées à un élément déployable sont exécutées lorsqu’un instantané de l’élément déployable est validé.

    Vous devez avoir l’un des rôles suivants pour accéder aux points de terminaison de cette API :
    • Scripted REST CDM Afficher ACL
    • Scripted REST CDM Admin ACL

    En outre, le module d’extension Configuration Data Management (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 politiques à un élément déployable.

    CdmPoliciesApi - SUPPRIMER /sn_cdm/policies/mappings

    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

    Tableau 1. Paramètres de chemin d'accès
    Nom Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Exemple : v1 ou v2. 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 2. Paramètres de requête
    Nom Description
    appName Requis. Nom de l’application Configuration Data Management (CDM) dont le mappage à la politique doit être supprimé. Situé dans la table Application CDM [sn_cdm_application].

    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 3. Paramètres de corps de demande
    Nom Description
    Néant

    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 une liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 4. En-têtes de demandes
    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 5. En-têtes de réponses
    En-tête Description
    Aucun

    Codes d'état

    Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir une liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 6. Codes d'état
    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.

    Paramètres du corps de réponse

    Nom Description
    erreur Si une erreur s’est produite pendant le traitement, les détails sur l’erreur.

    Type de données : objet

    "error": {
  "detail": "String",
  "message": "String"
}
    erreur.détail Informations supplémentaires sur l’erreur.

    Type de données : chaîne
    message d’erreur Message d’erreur généré lors de l’essai 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 : GET /sn_cdm/policies/mappings/inputs/resolved

    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 politiques à un déployable et Validation et correction des données de configuration.

    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

    Tableau 7. Paramètres de chemin d'accès
    Nom Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Exemple : v1 ou v2. 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 8. Paramètres de requête
    Nom Description
    appName Requis. Nom de l’application Configuration Data Management (CDM) associée au déployable pour lequel retourner les entrées de politique résolues. Situé dans la table Application CDM [sn_cdm_application].

    Type de données : chaîne
    deployableName Requis. Nom de l’élément déployable CDM pour lequel la politique résolue doit être renvoyée. 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 9. Paramètres de corps de demande
    Nom Description
    Néant

    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 une liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 10. En-têtes de demandes
    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 11. En-têtes de réponses
    En-tête Description
    Aucun

    Codes d'état

    Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir une liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 12. Codes d'état
    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.

    Paramètres du corps de réponse

    Nom Description
    résultat Liste de paires nom-valeur de toutes les entrées résolues pour le mappage de stratégie 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/policies/mappings

    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

    Tableau 13. Paramètres de chemin d'accès
    Nom Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Exemple : v1 ou v2. 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 14. Paramètres de requête
    Nom Description
    appName Requis. Nom de l’application Configuration Data Management (CDM) pour laquelle mapper la politique. Situé dans la table Application CDM [sn_cdm_application].

    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 tels que déterminés par le point de terminaison
    Tableau 15. Paramètres de corps de demande
    Nom Description
    Néant

    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 une liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 16. En-têtes de demandes
    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 17. En-têtes de réponses
    En-tête Description
    Aucun

    Codes d'état

    Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir une liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 18. Codes d'état
    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.

    Paramètres du corps de réponse

    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 document_ref associé au nœud.

    Type de données : objet

    "document_ref": {
  "link": "String",
  "value": "String"
}
    document_ref.link 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 à l’élément 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 sur l’erreur.

    Type de données : objet

    "error": {
  "detail": "String",
  "message": "String"
}
    erreur.détail Informations supplémentaires sur l’erreur.

    Type de données : chaîne
    message d’erreur Message d’erreur généré lors de l’essai de traitement de la demande.

    Type de données : chaîne
    exception Si une exception existe 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 politique pour la dernière fois.

    Type de données : objet

    "last_updated_by": {
  "link": "String",
  "value": "String"
}
    last_updated_by.link Syntaxe d’appel pour interroger l’enregistrement utilisateur à l’aide de l’API REST de 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 explicite 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 de création du mappage.

    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 de la dernière mise à jour du mappage.

    Type de données : chaîne

    Format : aaaa-mm-jj hh :mm :ss

    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/policies/mappings/inputs/additional-deployables

    Met à jour la variable d’entrée additionalDeployablesInput d’un Configuration Data Management mappage de politique (CDM).

    La variable d’entrée additionalDeployablesInput contient les éléments 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 politiques à 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/inputs/additional-deployables

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

    Paramètres de demande pris en charge

    Tableau 19. Paramètres de chemin d'accès
    Nom Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Exemple : v1 ou v2. 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 20. Paramètres de requête
    Nom Description
    additionalDéployables 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 l’élément déployable est associé. Situé dans la table Application CDM [sn_cdm_application].

    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 pour laquelle mettre à jour la variable d’entrée additionalDeployablesInput. Situé dans la table Application CDM [sn_cdm_application].

    Type de données : chaîne
    deployableName Requis. Nom de l’élément 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 tels que déterminés par le point de terminaison
    Tableau 21. Paramètres de corps de demande
    Nom Description
    Néant

    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 une liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 22. En-têtes de demandes
    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 23. En-têtes de réponses
    En-tête Description
    Aucun

    Codes d'état

    Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir une liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 24. Codes d'état
    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.

    Paramètres du corps de réponse

    Nom Description
    io_definition Détails sur l’enregistrement de définition d’E/S PaCE associé.

    Pour plus d’informations sur PaCE, consultez Administration des politiques dans Configuration DevOps.

    Type de données : objet

    "io_definition": {
  "link": "String",
  "value": "String"
}
    io_definition.link Syntaxe d’appel pour interroger cet enregistrement de définition d’E/S PaCE à l’aide de l’API REST de table .

    Type de données : chaîne
    io_definition.value Sys_id de l’enregistrement de définition PaCE I/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 :
    • true : la variable d’entrée de mappage associée n’est actuellement pas utilisée.
    • false : la variable d’entrée de mappage associée est actuellement utilisée.

    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 plus d’informations sur PaCE, consultez Administration des politiques dans Configuration DevOps.

    Type de données : objet

    "policy_mapping": {
  "link": "String",
  "value": "String"
}
    policy_mapping.link 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 de mappage de stratégie PaCE. 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 de la dernière mise à jour de la variable d’entrée de mappage.

    Type de données : chaîne

    Format : aaaa-mm-jj hh :mm :ss

    Demande cURL

    L’exemple suivant montre comment ajouter des éléments 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/policies/mappings/inputs

    Met à jour une variable d’entrée spécifiée pour un mappage de Configuration Data Management politique (CDM).

    Pour plus d’informations sur les mappages de stratégie, consultez Mapper les politiques à 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/inputs

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

    Paramètres de demande pris en charge

    Tableau 25. Paramètres de chemin d'accès
    Nom Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Exemple : v1 ou v2. 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 26. Paramètres de requête
    Nom Description
    appName Requis. Nom de l’application CDM dont les entrées de mappage de politique doivent être mises à jour. Situé dans la table Application CDM [sn_cdm_application].

    Type de données : chaîne
    deployableName Requis. Nom du déployable CDM pour lequel mettre à jour les entrées de mappage de politique. 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. Le type de données se trouve 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 tels que déterminés par le point de terminaison
    Tableau 27. Paramètres de corps de demande
    Nom Description
    Néant

    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 une liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 28. En-têtes de demandes
    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 29. En-têtes de réponses
    En-tête Description
    Aucun

    Codes d'état

    Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir une liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 30. Codes d'état
    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.

    Paramètres du corps de réponse

    Nom Description
    io_definition Détails sur l’enregistrement de définition d’E/S PaCE associé.

    Pour plus d’informations sur PaCE, consultez Administration des politiques dans Configuration DevOps.

    Type de données : objet

    "io_definition": {
  "link": "String",
  "value": "String"
}
    io_definition.link Syntaxe d’appel pour interroger cet enregistrement de définition d’E/S PaCE à l’aide de l’API REST de table .

    Type de données : chaîne
    io_definition.value Sys_id de l’enregistrement de définition PaCE I/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 :
    • true : la variable d’entrée de mappage associée n’est actuellement pas utilisée.
    • false : la variable d’entrée de mappage associée est actuellement utilisée.

    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 plus d’informations sur PaCE, consultez Administration des politiques dans Configuration DevOps.

    Type de données : objet

    "policy_mapping": {
  "link": "String",
  "value": "String"
}
    policy_mapping.link 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 de mappage de stratégie PaCE. 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 de la dernière mise à jour de la variable d’entrée de mappage.

    Type de données : chaîne

    Format : aaaa-mm-jj hh :mm :ss

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