API Intégration continue/Livraison continue (CICD)

L’API CICD fournit des points de terminaison qui permettent l’intégration avec des outils courants DevOps pour la création de pipelines. Ces outils incluent Jenkins, Azure Pipelines, GitLab, , GitHub ActionsAtlassian Bamboo/Pipelines, etc.

Il offre aux intégrateurs la possibilité de créer CICD des pipelines pour Now Platform les applications pilotées par des workflows de demande pull/merge typiques du développement axé sur la source. Il exploite le contrôle de source, le référentiel d’applications et Framework de tests automatisés les fonctionnalités.

L’API CI/CD fournit les domaines de produits et de fonctionnalités suivants :

• Contrôle de source

  Appliquez les modifications à distance d’une application liée à un référentiel Git distant via la fonctionnalité Contrôle de source de Studio, sur une instance spécifique.

  Importe une application à l’aide de l’URL du référentiel et du nom de branche spécifiés.

• Référentiel d’applications : disponible pour les applications incluses dans le périmètre, l’application globale, les personnalisations d’application pour les applications incluses dans le périmètre et via les modules d’extension ServiceNow Store.
  • Publiez une application à partir d’une instance dans le référentiel d’applications connecté.
  • Installez une application sur une instance à partir du référentiel d’applications connecté.
  • Restaurer une application qui a été installée via le contexte de restauration.
• Lot
  • Définissez un fichier manifeste JSON pour installer plusieurs applications par lots.
  • Restaurez l’intégralité de l’installation par lots via le contexte de restauration.
  • Renvoie les résultats d’une installation par lots en fonction d’un identificateur de résultat spécifié.
• Modules d'extension
  • Activez un module d’extension.
  • Restaurer un module d’extension via le contexte de restauration.
• Framework de tests automatisés (ATF)
  • Démarrez une suite de tests ATF.
  • Obtenez le résultat de réussite/d’échec d’une suite de tests ATF.
• Analyse d’instance
  • Démarrez une analyse d’instance (complète, analyse de points sur la table, analyse de points sur l’enregistrement, application incluse dans le périmètre, ensemble de mises à jour, combinaison de ces éléments.)
  • Obtenez le résultat de réussite/d’échec d’une exécution d’analyse d’instance.
• Progression

  Obtenez le pourcentage d’achèvement sur une instance pour les processus initiés par d’autres appels de point de terminaison. Vous pouvez utiliser cette fonctionnalité pour interroger jusqu’à la progression terminée avant de passer à l’étape suivante.

Cette API utilise un modèle de réponse asynchrone. Lorsque vous appelez un point de terminaison, par exemple pour exécuter une suite de tests /sn_cicd/testsuite/run, le point de terminaison déclenche la fonction associée, par exemple le démarrage de l’exécution de la suite de tests. Le point de terminaison renvoie ensuite un message de réponse contenant l’état d’exécution de la fonction demandée, généralement En attente, ainsi qu’un identificateur et un lien uniques. Utilisez ces informations pour obtenir des informations supplémentaires sur la progression, la source, les résultats et/ou les conclusions de la demande. En fonction de la demande de fonction, vous pouvez utiliser l’un des moyens suivants pour obtenir des informations supplémentaires sur une demande :

• Appelez le point de terminaison /sn_cicd/progress/{progress_id} à l’aide du links.progress.id paramètre renvoyé par le point de terminaison initial.
• Appelez le point de terminaison /sn_cicd/testsuite/results/{result_id} à l’aide du links.result.id paramètre renvoyé par le point de terminaison initial.
• Appelez le point de terminaison /sn_cicd/instance_scan/result/{progress_id} à l’aide du links.progress.id paramètre renvoyé par le point de terminaison initial.
• Appelez le point de terminaison /sn_cicd/sc/apply_stash/{stash_id} à l’aide du paramètre renvoyé par le links.stash.id point de terminaison /sn_cicd/progress/{progress_id} .
• Lien vers le links.<progress/result/source/findings>.url paramètre renvoyé par le point de terminaison initial.

Remarque :

Pour installer une application à partir d’un référentiel, l’application doit d’abord être publiée dans le référentiel à l’aide du point de terminaison /sn_cicd/app_repo/publish . Une fois publiée, toute instance connectée à ce référentiel peut alors installer et restaurer l’application. Si l’application n’est pas publiée en premier, la demande d’installation échoue.

Le rôle sn_cicd.sys_ci_automation ou admin est requis pour utiliser cette API.

À partir de , Tokyoles CICD points de terminaison d’API qui doivent obtenir le verrou à l’échelle de l’instance/mutex pour effectuer l’opération demandée utiliseront une file d’attente, plutôt que de rejeter les demandes lorsque le verrou/le mutex à l’échelle de l’instance est occupé. Plusieurs CICD pipelines effectuent simultanément des demandes sans détecter le rejet ni la nouvelle tentative, et peuvent simplement surveiller la progression comme ils le feraient pour des demandes réussies précédemment. Ce comportement est activé par défaut.

La file d’attente actuelle peut être inspectée par un utilisateur disposant du rôle administrateur en accédant à la file d’attente des opérations de l’application > diagnosticsystème. À partir de là, la file d’attente peut être mise en pause et reprise par l’administrateur pour permettre d’autres opérations manuelles qui peuvent nécessiter le verrouillage/mutex à l’échelle de l’instance.

Remarque :

En cas de pause, toutes les opérations en cours sont exécutées jusqu’à leur terme, mais aucune nouvelle opération n’est démarrée. L’API continuera d’accepter et de mettre en file d’attente les nouvelles demandes. Une opération en attente peut également être annulée avant le début de son exécution en mettant à jour le suivi d’exécution répertorié sur un état Annulé. Si, pour une raison quelconque, une opération ne peut pas avoir lieu après le délai d’expiration spécifié dans com.glide.update_operation.job_cancel_timeout_minutes (par défaut : 48 heures), elle sera annulée.

Lorsqu’une mise à niveau est planifiée, la file d’attente passe à un état de mise à niveau en pause deux heures avant la mise à niveau, sauf si elle est remplacée par la propriété com.glide.update_operation.queue_upgrade_window. Cela permet à toute opération en cours de se terminer avant le début de la mise à niveau.

Remarque :

La file d’attente reprend automatiquement lorsque la mise à niveau est terminée.

Pour plus d’informations sur CICD, voir :

• Continuous Integration and Continuous Delivery (CICD) Spoke
• https://plugins.jenkins.io/servicenow-cicd/
• https://marketplace.visualstudio.com/items?itemName=ServiceNow.vss-services-servicenow-cicd
• https://github.com/marketplace?type=actions&query=servicenow
• https://hub.docker.com/r/servicenowdevx/sncicd-gitlab-docker

CI/CD : OBTENIR /sn_cicd/app/batch/results/{result_id}

Renvoie les résultats d’une installation par lots en fonction d’un identificateur de résultat spécifié.

Appelez cette méthode après avoir appelé le point de terminaison /sn_cicd/app/batch/install pour obtenir les résultats de l’installation par lots. Utilisez la valeur renvoyée dans le links.results.id paramètre des résultats de retour du point de terminaison /sn_cicd/app/batch/install comme point de result_id terminaison pour ce point de terminaison. Vous pouvez également appeler le point de terminaison /api/sn_cicd/progress/{progress_id} pour obtenir des informations sur la progression de l’installation si elle n’est pas encore terminée.

Format d'URL

URL versionnée : /api/sn_cicd/{api_version}/app/batch/results/{result_id}

URL par défaut : /api/sn_cicd/app/batch/results/{result_id}

Remarque :

Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

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. Par 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
result_id	Sys_id de l’installation par lots pour laquelle les informations de résultats doivent être renvoyées. Cette valeur est renvoyée dans le links.results.id paramètre du point de terminaison /sn_cicd/app/batch/install . Type de données : chaîne

Tableau 2. Paramètres de requête

Nom	Description
Néant

Tableau 3. Paramètres de corps de demande (XML ou JSON)

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

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 la 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.
401	Les informations d’identification de l’utilisateur sont incorrectes.
403	Interdit. L’utilisateur n’est pas un administrateur ou n’a pas le rôle sn_cicd.sys_ci_automation.
404	Introuvable. L’élément demandé est introuvable.
405	Méthode non valide. La fonctionnalité est inactive.
500	Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande.

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

Nom	Description
erreur	Message d’erreur avec détails sur l’erreur. Type de données : chaîne
batch_items	Tableau JSON, où chaque objet fournit des détails sur l’installation d’un package. Type de données : tableau "batch_items" [{ "customization_version": "String", "id": "String", "install_date": "String", "name": "String", "notes": "String", "state": "String", "status_message": "String", "type": "String", "url": "String", "version": "String" }]
batch_items.customization_version	Applicable uniquement lorsque le batch_items.type paramètre est défini sur Application ou Module d’extension et que le requested_customization_version paramètre est transmis dans la demande d’installation par lots. Version du package de personnalisation de l’application de stockage ou du module d’extension inclus ServiceNow dans le périmètre à installer, tel que 1.0.2 ou 2.3. Type de données : chaîne
batch_items.id	Sys_id de l’application ou l’identificateur du module d’extension à installer. Identique au paramètre dans l’appel packages.id de point de terminaison /sn_cicd/app/batch/install d’initiation. Type de données : chaîne
batch_items.date_installation	Date et heure d’installation du package. Vide si la demande est toujours en cours. Type de données : chaîne
batch_items.nom	Nom du package. Type de données : chaîne
batch_items.notes	Notes spécifiées par l’utilisateur à propos du package. Identique au paramètre dans l’appel packages.notes de point de terminaison /sn_cicd/app/batch/install d’initiation. Type de données : chaîne
batch_items.état	État actuel de l’installation du package associé. Valeurs possibles : Échoué En cours Installé Non valide Prêt Restauré Type de données : chaîne
batch_items.message_état	Décrit toutes les erreurs qui se sont produites lors de l’installation du package et/ou des personnalisations. Type de données : chaîne
batch_items.type	Type d’application. Identique au paramètre dans l’appel packages.type de point de terminaison /sn_cicd/app/batch/install d’initiation. Valeurs valides : l'application module d'extension Type de données : chaîne
batch_items.url	URL de l’enregistrement d’installation du package associé sur votre ServiceNow instance. Type de données : chaîne
batch_items.version	Version du package à installer, par exemple 1.0.2 ou 2.3. Identique au paramètre dans l’appel packages.requested_version de point de terminaison /sn_cicd/app/batch/install d’initiation. Type de données : chaîne
batch_plan	Décrit le plan de lots d’installation. Type de données : objet "batch_plan": { "id": "String", "name": "String", "notes": "String", "state": "String", "url": "String" }
batch_plan.id	Sys_id des informations sur les résultats de retour. Même valeur que ce qui a été transmis dans le paramètre de result_id demande. Type de données : chaîne
batch_plan.nom	Nom descriptif spécifié par l’utilisateur pour cette demande par lots. Identique au paramètre dans l’appel name de point de terminaison /sn_cicd/app/batch/install d’initiation. Type de données : chaîne
batch_plan.notes	Notes transmises lorsque l’installation par lots a été invoquée. Identique au paramètre dans l’appel notes de point de terminaison /sn_cicd/app/batch/install d’initiation. Type de données : chaîne
batch_plan.état	État actuel de l’installation globale par lots. Valeurs possibles : Échoué En cours Installé Non valide Installation partielle Prêt Restauré Type de données : chaîne
batch_plan.url	URL de l’enregistrement du plan d’installation par lots sur votre ServiceNow instance. Type de données : chaîne

Demande cURL

Cet exemple vérifie l’état d’un plan d’installation par lots appelé Release 2.0 IT Operations.

curl 'instance.servicenow.com/api/sn_cicd/app/batch/results/df24b1e9db2d0110b5e3f6c5ae97c561 \
--request GET \
--header 'Accept: application/json' \
--user 'username':'password' 

{
"result": {
  "batch_plan": {
    "name":“Release 2.0 IT Operations”,
    "id": "df24b1e9db2d0110b5e3f6c5ae97c561",
    "url": "https://instance.service-now.com/sys_batch_install_plan.do?sys_id=df24b1e9db2d0110b5e3f6c5ae97c561",
    "state": "Installed",
    "notes": "User specified notes for batch install plan",
  }
  "batch_items": [
    {
      "name": "com.sn_cicd_spoke",
      "type": "Application",
      "version": "7.0.0",
      "state": "Installed",
      "install_date": "2020-08-31 15:30:01",
      "id": "c159b1e9db1c0010b5e3f6c5ae961903",
      "url":"https://instance.service-now.com/sys_batch_install_item.do?sys_id=c159b1e9db1c0010b5e3f6c5ae961903",
      "notes" : ""
    },
    {
      "name": "Customization for CSM App1",
      "type": "Application",
      "version": "1.0.0",
      "state": "Installed",
      "install_date": "2020-08-31 15:32:01",
      "id": "e824b1e9db2d1001b5e3f6c5ae97d628",
      "url": "https://instance.service-now.com/sys_batch_install_item.do?sys_id=e824b1e9db2d1001b5e3f6c5ae97d628",
      "notes": "Customized headers.",
      "customization_version": "2.1.1”,
      "status_message": ""

    }]
  }
}

CI/CD : OBTENIR /sn_cicd/instance_scan/résultat/{progress_id}

Renvoie la progression et l’état actuels de la fonction d’analyse d’instance CI/CD associée à un ID d’avancement transmis. Appelez cette méthode après avoir appelé l’un des autres points de terminaison CI/CD d’analyse d’instance tels que /sn_cicd/instance_scan/full_scan ou /sn_cicd/instance_scan/point_scan.

Remarque :

Ce point de terminaison fait partie de l’API de service d’exécution d’analyse d’instance CICD et est utilisé sous l’espace de noms sn_cicd .

Format d'URL

URL versionnée : /api/sn_cicd/{api_version}/instance_scan/result/{progress_id}

URL par défaut : /api/sn_cicd/instance_scan/result/{progress_id}

Remarque :

Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

Paramètres de demande pris en charge

Tableau 7. Paramètres

Paramètre	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Par 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
progress_id	Identificateur unique de la fonction pour laquelle renvoyer des informations sur la progression. Cette valeur est renvoyée dans le links.progress.id paramètre du point de terminaison à l’origine de l’action, tel que /sn_cicd/instance_scan/full_scan ou /sn_cicd/instance_scan/point_scan. Type de données : chaîne

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.

Tableau 8. 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 9. En-têtes de réponses

En-tête	Description
Aucun

Codes d'état

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.

Tableau 10. Codes d'état

Code d'état	Description
200	Réussi. La demande a été correctement traitée.
401	Les informations d’identification de l’utilisateur sont incorrectes.
403	Interdit. L’utilisateur n’est pas un administrateur ou n’a pas le rôle sn_cicd.sys_ci_automation.
500	Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande.

Corps de la demande

L’API accepte ces éléments JSON ou XML dans le corps de la demande.

Tableau 11. Éléments acceptés dans le corps de la demande

Élément	Description
Néant

Corps de réponse

L’API renvoie ces éléments JSON ou XML dans le corps de la réponse.

Tableau 12. Éléments renvoyés dans le corps de réponse

Élément	Description
erreur	Message d’erreur avec détails sur l’erreur. Type de données : chaîne
Liens	Informations sur les liens et les sys_ids associés à l’ensemble de mises à jour. Type de données : objet "links": { "progress": {Object} }
liens.résultats	Objet contenant des informations sur les conclusions de l’analyse d’instance.
liens.résultats.étiquette	Informations supplémentaires sur les résultats de l’analyse d’instance.
liens.résultats.url	URL à utiliser pour récupérer une liste des enregistrements qui n’ont pas respecté les vérifications.
Liens.Progression	Informations sur la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : objet "progress": { "id": "String", "url": "String" }
links.progress.id	Identificateur unique du détail de progression.
liens.progression.url	URL à utiliser pour récupérer les détails de la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : chaîne
liens.résultats	ID et URL des résultats de l’exécution. Type de données : objet "results": { "id": "String", "url": "String" }
links.results.id	Sys_id de l’enregistrement des résultats de l’analyse d’instance.
liens.resultats.url	URL à utiliser pour obtenir les résultats de l’analyse d’instance.
statut	Numéro représentant l’état d’exécution de l’action exécutée sur l’ensemble de mises à jour. Correspond au status_label descripteur. Valeurs possibles : 0 : en attente 1 : En cours d’exécution 2 : Réussi 3 : Échec 4 : Annulé Type de données : chaîne
status_detail	Message détaillé sur l’état d’exécution, le cas échéant. Correspond au champ detailed_message de la table Suivi de l’exécution [sys_execution_tracker]. Type de données : chaîne
status_label	État d’exécution de l’action de l’ensemble de mises à jour. Correspond au status nombre. Valeurs possibles : Annulé Échoué En attente En cours d'exécution Réussi Type de données : chaîne
status_message	Informations supplémentaires sur le motif d’échec de l’opération. Renvoie une chaîne vide si l’opération réussit. Type de données : chaîne

Exemple de demande cURL

curl 'instance.service-now.com/api/sn_cicd/instance_scan/result/a74c70a11b7800103d374087bc4bcb28' \
--request GET \
--header 'Accept: application/json' \
--user 'username':'password'

{
    "result": {
        "links": {
            "findings": {
                "url": "https://instance.service-now.com/api/now/table/scan_finding?sysparm_query%3Dresult%3D6f4cf8651b7800103d374087bc4bcb41%5EORDERBYsys_id",
                "label": "First 10,000 findings"
            },
            "progress": {
                "id": "a74c70a11b7800103d374087bc4bcb28",
                "url": "https://instance.service-now.com/api/sn_cicd/progress/a74c70a11b7800103d374087bc4bcb28"
            },
            "results": {
                "id": "a74c70a11b7800103d374087bc4bcb28",
                "url": "https://instance.service-now.com/api/sn_cicd/instance_scan/result/a74c70a11b7800103d374087bc4bcb28"
            }
        },
        "status": "2",
        "status_label": "Successful",
        "status_message": "",
        "status_detail": "",
        "error": ""
    }
}

CI/CD : OBTENIR /sn_cicd/progression/{progress_id}

Renvoie la progression et l’état actuels de la Intégration et offre en continu (CICD) fonction associée à un ID de progression spécifié.

Appelez cette méthode après avoir appelé l’un des points de terminaison CICD asynchrones tels que /sn_cicd/app_repo/publish, /sn_cicd/app_repo/install, /sn_cicd/testsuite/run ou /sn_cicd/sc/apply_stash.

Format d'URL

URL versionnée : /api/sn_cicd/{api_version}/progress/{progress_id}

URL par défaut : /api/sn_cicd/progress/{progress_id}

Remarque :

Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

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. Par 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
progress_id	Identificateur unique de la fonction pour laquelle renvoyer des informations sur la progression. Cette valeur est renvoyée dans le links.progress.id paramètre du point de terminaison à l’origine de l’action, par exemple /sn_cicd/app_repo/publish, /sn_cicd/app_repo/install, /sn_cicd/testsuite/run ou /sn_cicd/sc/apply_stash. Type de données : chaîne

Tableau 14. Paramètres de requête

Nom	Description
Néant

Tableau 15. Paramètres de corps de demande (XML ou JSON)

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

Tableau 16. 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 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 la 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.
401	Les informations d’identification de l’utilisateur sont incorrectes.
403	Interdit. L’utilisateur n’est pas un administrateur ou n’a pas le rôle sn_cicd.sys_ci_automation.
404	Introuvable. L’élément demandé est introuvable.
405	Méthode non valide. La fonctionnalité est inactive.
409	Conflit. L’élément demandé n’est pas unique.
500	Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande.

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

Nom	Description
erreur	Message d’erreur avec détails sur l’erreur. Type de données : chaîne
Liens	Informations sur les liens et les sys_ids associés à l’ensemble de mises à jour. Type de données : objet "links": { "progress": {Object} }
Liens.Progression	Informations sur la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : objet "progress": { "id": "String", "url": "String" }
links.progress.id	Sys_id contenant les détails de progression de l’opération. Vous pouvez utiliser cette valeur lors de l’appel du point CI/CD : OBTENIR /sn_cicd/progression/{progress_id}de terminaison . Type de données : chaîne
liens.progression.url	URL à utiliser pour récupérer les détails de la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : chaîne
liens.résultats	ID et URL des résultats de l’exécution. Type de données : objet "results": { "id": "String", "url": "String" }
links.results.id	Sys_id des informations sur les résultats. Utilisez cette valeur pour l’appel du point de terminaison des résultats associé. Type de données : chaîne
liens.resultats.url	URL à utiliser pour obtenir les résultats de l’exécution du point de terminaison. Type de données : chaîne
liens.source	Sys_id informations sur l’URL et l’enregistrement source dans la table Suivi de l’exécution [sys_execution_tracker]. Type de données : objet "source": { "id": "String", "url": "String" }
links.source.id	Identificateur unique de l’enregistrement source. Table : table Suivi des exécutions [sys_execution_tracker] Type de données : chaîne
liens.source.url	URL à utiliser pour obtenir les informations sources dans la table Suivi des exécutions [sys_execution_tracker]. Type de données : chaîne
liens.dissimulation	Si un a été créé au cours d’une opération apply_changes , cet objet contient des informations sur la dissimulation. Cet objet n’est pas renvoyé si aucune dissimulation n’a été créée. Type de données : objet "stash": { "id": "String", "url": "String" }
links.stash.id	Identificateur unique de la dissimulation créée. Utilisez cette valeur lors de l’appel du point de CI/CD : POST /sn_cicd/SC/apply_stash/{stash_id} terminaison pour appliquer la dissimulation. Type de données : chaîne
lien.cachette.url	URL de la dissimulation associée. Type de données : chaîne
percent_complete	Pourcentage de la demande terminée. Type de données : nombre
status	Numéro représentant l’état d’exécution de l’action exécutée sur l’ensemble de mises à jour. Correspond au status_label descripteur. Valeurs possibles : 0 : en attente 1 : En cours d’exécution 2 : Réussi 3 : Échec 4 : Annulé Type de données : chaîne
status_detail	Message détaillé sur l’état d’exécution, le cas échéant. Correspond au champ detailed_message de la table Suivi de l’exécution [sys_execution_tracker]. Type de données : chaîne
status_label	État d’exécution de l’action de l’ensemble de mises à jour. Correspond au status nombre. Valeurs possibles : Annulé Échoué En attente En cours d'exécution Réussi Type de données : chaîne
status_message	Description supplémentaire de l’état actuel de l’action, si disponible. Type de données : chaîne

Obtenir la progression d’une exécution de suite de tests

curl 'instance.servicenow.com/api/sn_cicd/progress/a4fae8911bdc00103d374087bc4bcbbd' \
--request GET \
--header 'Accept: application/json' \
--user 'username':'password'

Progression de l’appel d’application des modifications.

{
    "result": {
        "links": {
            "progress": {
                "id": "a4fae8911bdc00103d374087bc4bcbbd",
                "url": "https://instance.servicenow.com/api/sn_cicd/progress/a4fae8911bdc00103d374087bc4bcbbd"
            },
            "source": {
                "id": "59c4c4d11b5c00103d374087bc4bcb26",
                "url": "https://instance.servicenow.com/api/now/table/sys_app/59c4c4d11b5c00103d374087bc4bcb26"
            }
        },
        "status": "2",
        "status_label": "Successful",
        "status_message": "This operation succeeded",
        "status_detail": "Successfully applied commit 1f14e11a7dedcbfa194beb5875fcdaa15ed8accb from source control",
        "error": "",
        "percent_complete": 100
    }
}

Obtenez la progression d’un appel d’application des changements. Dans ce cas, il y avait des changements non enregistrés/non validés sur l’instance dans Studio, une dissimulation a donc été créée pour conserver les changements non enregistrés

curl 'instance.servicenow.com/api/sn_cicd/progress/a4fae8911bdc00103d374087bc4bcbbd' \
--request GET \
--header 'Accept: application/json' \
--user 'username':'password'

Progression fournissant des informations sur la dissimulation créée.

{
"result": {
   "links": {
      "progress": {
         "id": "5b12eca4e0429110f8771827f8fd36a4",
         "url": "https://instance.servicenow.com/api/sn_cicd/progress/5b12eca4e0429110f8771827f8fd36a4"
       },
       "stash": {
         "id": "fc2224e4e0429110f8771827f8fd3634",
         "url": "https://instance.servicenow.com/api/sn_cicd/sc/apply_stash/fc2224e4e0429110f8771827f8fd3634"
}
    },
    "status": "2",
    "status_label": "Successful",
    "status_message": "This operation succeeded",
    "status_detail": "Successfully applied commit fa5626f6f1f7fef677c16b4a0dd8b22ba8a6e311 from source control",
    "error": "",
    "percent_complete": 100
  }
}

Demande cURL

curl 'instance.servicenow.com/api/sn_cicd/progress/5b12eca4e0429110f8771827f8fd36a4' \
--request GET \
--header 'Accept: application/json' \
--user 'username':'password'

Progression de l’exécution d’une suite de tests (/sn_cicd/testsuite/run).

{
"result": {
   "links": {
      "progress": {
         "id": "e891389d1b1040103d374087bc4bcb75",
         "url": "https://instance.servicenow.com/api/sn_cicd/progress/e891389d1b1040103d374087bc4bcb75"
       },
       "results": {
         "id": "2891389d1b1040103d374087bc4bcb09",
         "url": "https://instance.servicenow.com/api/sn_cicd/testsuite/results/2891389d1b1040103d374087bc4bcb09"
       }
    },
    "status": "2",
    "status_label": "Successful",
    "status_message": "Suite passed",
    "status_detail": "Suite passed",
    "error": "",
    "percent_complete": 100
  }
}

CI/CD : OBTENIR /sn_cicd/TESTSUITE/RESULTS/{result_id}

Renvoie les résultats d’une exécution de suite de tests en fonction d’un identificateur de résultats spécifié.

Appelez ce point de terminaison après avoir appelé /sn_cicd/progress/{progress_id} pour obtenir le résultat de la suite de tests exécutée.

Format d'URL

URL versionnée : /api/sn_cicd/{api_version}/testsuite/results/{result_id}

URL par défaut : /api/sn_cicd/testsuite/results/{result_id}

Remarque :

Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

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. Par 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
result_id	Identificateur unique des résultats de la suite de tests à récupérer. L’appel de point de terminaison /sn_cicd/progress/{progress_id} correspondant renvoie ces informations. Type de données : chaîne

Tableau 20. Paramètres de requête

Nom	Description
Néant

Tableau 21. Paramètres de corps de demande (XML ou JSON)

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

Tableau 22. 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 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 la 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.
401	Les informations d’identification de l’utilisateur sont incorrectes.
403	Interdit. L’utilisateur n’est pas un administrateur ou n’a pas le rôle sn_cicd.sys_ci_automation.
404	Introuvable. L’élément demandé est introuvable.
405	Méthode non valide. La fonctionnalité est inactive.
409	Conflit. L’élément demandé n’est pas unique.
500	Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande.

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

Nom	Description
child_suite_results	Résultats des suites de tests imbriquées. Le format de ce contenu est le même que celui du test parent.
erreur	Message d'erreur. Type de données : chaîne
Liens	Objet contenant tous les liens et les sys_ids associés à la réponse. Type de données : objet
liens.résultats	Objet contenant les informations sur les résultats. Type de données : objet
links.results.id	Identificateur unique des informations de résultats. Utilisez cette valeur lors de l’appel du point de terminaison /sn_cicd/testsuite/results/{result_id}. Type de données : chaîne
liens.resultats.url	URL à utiliser pour obtenir les résultats de l’exécution du point de terminaison, tels que les résultats. Type de données : chaîne
percent_complete	Pourcentage de la demande terminée.
rolledup_test_error_count	Nombre de tests avec des erreurs. Type de données : nombre
rolledup_test_failure_count	Nombre de tests ayant échoué. Type de données : nombre
rolledup_test_skip_count	Nombre de tests ignorés. Type de données : nombre
rolledup_test_success_count	Nombre de tests qui se sont exécutés avec succès. Type de données : nombre
statut	État d’exécution numérique. Utilisé avec status_label, par exemple 0 : en attente. Valeurs : 0 (en attente) 1 (en cours d’exécution) 2 (Réussi) 3 (Échec) 4 (annulé) Type de données : chaîne
status_detail	Informations supplémentaires sur l’état actuel. Type de données : chaîne
status_label	Description de l’état d’exécution. Utilisé avec status, par exemple 0 : en attente. Valeurs : En attente En cours d'exécution Réussi Échoué Annulé Type de données : chaîne
status_message	Description de l’état actuel. Type de données : chaîne
test_suite_duration	Durée nécessaire à l’exécution de la suite de tests. Unité : Secondes Type de données : chaîne
test_suite_name	Nom de la suite de tests. Type de données : chaîne
test_suite_status	État de la suite de tests. Type de données : chaîne

Demande cURL

curl 'instance.servicenow.com/api/sn_cicd/testsuite/results/2891389d1b1040103d374087bc4bcb09' \
--request GET \
--header 'Accept: application/json' \
--user 'username':'password'

{
"result": {
   "links": {
       "results": {
           "id": "2891389d1b1040103d374087bc4bcb09",
           "url": "https://instance.servicenow.com/sys_atf_test_suite_result.do?sys_id=2891389d1b1040103d374087bc4bcb09"
       }
   },
   "status": "2",
   "status_label": "Successful",
   "status_message": "",
   "status_detail": "",
   "error": "",
   "test_suite_status": "success",
   "test_suite_duration": "1 Second",
   "rolledup_test_success_count": 1,
   "rolledup_test_failure_count": 0,
   "rolledup_test_error_count": 0,
   "rolledup_test_skip_count": 0,
   "test_suite_name": "Quick Test",
   "child_suite_results": []
 }
}

CI/CD : PUBLIER /sn_cicd/app/lot/installer

Installe deux packages ou plus dans un seul lot spécifié.

Un lot peut contenir n’importe quelle combinaison des types suivants :

• Application :
  • Applications incluses dans le périmètre qui n’appartiennent ServiceNow Store pas à votre entreprise
  • Applications incluses dans le périmètre ou globales dans le référentiel d’applications qui appartiennent à votre société
  • Vos personnalisations d’application pour les applications du magasin dans le référentiel d’applications
• ServiceNow module d’extension :

  Personnalisations d’application pour les applications incluses dans le périmètre qui ont été empaquetées dans un module d’extension et publiées dans le référentiel d’applications.

Remarque :

Ce point de terminaison utilise un modèle de réponse asynchrone. Lorsque vous appelez un point de terminaison, la fonction associée est lancée, par exemple en démarrant l’exécution du plan d’installation par lots. Le point de terminaison renvoie ensuite un message de réponse contenant l’état d’exécution de la fonction demandée, généralement En attente, ainsi qu’un identificateur et un lien uniques. Utilisez ces informations pour obtenir des informations supplémentaires sur la progression ou les résultats de la demande.

Format d'URL

URL versionnée : /api/sn_cicd/{api_version}/app/batch/install

URL par défaut : /api/sn_cicd/app/batch/install

Remarque :

Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

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. Par 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
Néant

Tableau 27. Paramètres de corps de demande (XML ou JSON)

Nom	Description
nom	Requis. Nom descriptif spécifié par l’utilisateur pour cette demande par lots. Type de données : chaîne
notes	L’utilisateur a spécifié des remarques supplémentaires sur le plan d’installation par lots. Type de données : chaîne Valeur par défaut : nul
packages	Requis. Tableau JSON, où chaque objet spécifie les détails d’un package à installer. Type de données : tableau "packages": [{ "id": "String", "load_demo_data": Boolean, "notes": "String", "requested_customization_version": "String", "requested_version": "String", "type": "String" }]
packages.id	Requis. Sys_id de l’application ou l’identificateur du module d’extension à installer. Type de données : chaîne
packages.load_demo_data	Marqueur indiquant si les données de démonstration sont chargées lors de l’installation du package. Valeurs valides : vrai : les données de démonstration doivent être chargées. false : les données de démonstration ne doivent pas être chargées. Type de données : booléennes Valeur par défaut : false
packages.notes	Notes spécifiées par l’utilisateur à propos du package. Type de données : chaîne Valeur par défaut : nul
packages.requested_customization_version	Version de la personnalisation de l’application en fonction de l’application du magasin ou du module d’extension inclus ServiceNow dans le périmètre à installer, par exemple 1.0.2 ou 2.3. Type de données : chaîne Par défaut : aucune. Si ce paramètre n’est pas défini, le système ne recherche pas de personnalisations pour l’application.
packages.requested_version	Requis si packages.type est défini sur Application ; ignoré si défini sur Module d’extension. Version du package à installer, par exemple 1.0.2 ou 2.3. Type de données : chaîne
packages.type	Requis. Type de package. Valeurs valides : l'application module d'extension Type de données : chaîne

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.

Tableau 28. 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 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 la 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.
401	Les informations d’identification de l’utilisateur sont incorrectes.
403	Interdit. L’utilisateur n’est pas un administrateur ou n’a pas le rôle sn_cicd.sys_ci_automation.
405	Méthode non valide. La fonctionnalité est désactivée.

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

Nom	Description
erreur	Message d’erreur avec détails sur l’erreur. Type de données : chaîne
Liens	Tous les liens et sys_ids associés à la réponse. Type de données : objet "links": { "progress": {Object}, "results": {Object}, "rollback": {Object} }
Liens.Progression	Informations sur la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : objet "progress": { "id": "String", "url": "String" }
links.progress.id	Sys_id contenant les détails de progression de l’opération. Vous pouvez utiliser cette valeur lors de l’appel du point CI/CD : OBTENIR /sn_cicd/progression/{progress_id}de terminaison . Type de données : chaîne
liens.progression.url	URL à utiliser pour récupérer les détails de la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : chaîne
liens.résultats	Décrit les informations sur le lien des résultats. Type de données : objet "results": { "id": "String", "url": "String" }
links.results.id	Sys_id des résultats de l’appel de point de terminaison par lots. Utilisez cette valeur lors de l’appel du point de terminaison spécifié links.results.url dans pour interroger les résultats de l’installation par lots. Type de données : chaîne
liens.resultats.url	URL à utiliser pour récupérer les résultats de l’installation par lots. Type de données : chaîne
liens.rollback	Décrit les informations de restauration de l’installation par lots. Type de données : objet "rollback": { "id": "String" }
links.rollback.id	Sys_id des détails de restauration pour les packages installés. Utilisez ce paramètre pour restaurer l’installation des packages spécifiés à leurs versions précédentes à l’aide du point de terminaison /sn_cicd/app/batch/rollback/{rollback_id} . Remarque : L’aptitude de restauration n’est disponible qu’une fois l’installation terminée. Type de données : chaîne
percent_complete	Pourcentage de la demande terminée. Type de données : nombre
status	Numéro représentant l’état d’exécution de l’action exécutée sur l’ensemble de mises à jour. Correspond au status_label descripteur. Valeurs possibles : 0 : en attente 1 : En cours d’exécution 2 : Réussi 3 : Échec 4 : Annulé Type de données : chaîne
status_detail	Message détaillé sur l’état d’exécution, le cas échéant. Correspond au champ detailed_message de la table Suivi de l’exécution [sys_execution_tracker]. Type de données : chaîne
status_label	État d’exécution de l’action de l’ensemble de mises à jour. Correspond au status nombre. Valeurs possibles : Annulé Échoué En attente En cours d'exécution Réussi Type de données : chaîne
status_message	Description supplémentaire de l’état actuel de l’action, si disponible. Type de données : chaîne

Demande cURL

Cet exemple lance une installation par lots appelée Release 2.2 Deployment qui contient trois packages (un de chaque type) à installer.

curl 'instance.servicenow.com/api/sn_cicd/app/batch/install \
--request POST \
--header 'Accept: application/json' \
--user 'username':'password' \
--data { "name": "Release 2.2 Deployment",
 "packages": [
   {
     "id": "syd_id_abcefghi",
     "type": "application",
     "load_demo_data": false,
     "requested_version": "1.0.2",
     "notes": "User specific text to describe this application install"
   },
   { 
     "id": "syd_id_defabcde",
     "type": "application",
     "requested_version": "1.0.0",
     "requested_customization_version": "2.0.7",
     "notes": "Customization for CSM App1"
   },
   {
     "id": "com.glide.some.plugin",
     "type": "plugin",
     "load_demo_data": true,
     "notes": "Plugin related notes"
   }]
 }

{
"result": {
   "links": {
     "progress": {
       "id": "c159b1e9db1c0010b5e3f6c5ae961903",
       "url": "https://instance.servicenow.com/api/sn_cicd/progress/c159b1e9db1c0010b5e3f6c5ae961903"
     },
     "results": {
       "id": "df24b1e9db2d0110b5e3f6c5ae97c561",
       "url": "https://instance.servicenow.com/api/sn_cicd/app/batch/results/df24b1e9db2d0110b5e3f6c5ae97c561"
     },
     "rollback":{
       "id": "a329f82e871da64c724ba21c82a764f2"
     },
   },
   "status": "0",
   "status_label": "Pending",
   "status_message": "",
   "status_detail": "",
   "error": "",
   "percent_complete": 0
  }
}

CI/CD : POST /sn_cicd/app/batch/rollback/{rollback_id}

Restaure tous les packages associés à une installation par lots spécifique à leurs versions précédentes.

Ce point de terminaison fonctionne conjointement avec le point de terminaison /sn_cicd/app/batch/install . Le rollback_id est fourni dans les résultats de retour de ce point de terminaison. Lorsque ce point de terminaison est appelé, il restaure tous les packages spécifiés dans l’installation associée ; Vous ne pouvez pas restaurer des packages individuels. S’il n’y a pas de version précédente, le point de terminaison désinstalle le package associé.

Remarque :

Ce point de terminaison utilise un modèle de réponse asynchrone. Lorsque vous appelez un point de terminaison, la fonction associée est lancée, par exemple en démarrant l’exécution du plan d’installation par lots. Le point de terminaison renvoie ensuite un message de réponse contenant l’état d’exécution de la fonction demandée, généralement En attente, ainsi qu’un identificateur et un lien uniques. Utilisez ces informations pour obtenir des informations supplémentaires sur la progression ou les résultats de la demande.

Format d'URL

URL versionnée : /api/sn_cicd/{api_version}/app/batch/rollback/{rollback_id}

URL par défaut : /api/sn_cicd/app/batch/rollback/{rollback_id}

Remarque :

Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

Paramètres de demande pris en charge

Tableau 31. Paramètres de chemin d'accès

Nom	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Par 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
rollback_id	Sys_id du plan d’installation par lots pour lequel restaurer les packages installés à leurs versions précédentes. Cette valeur est renvoyée dans le links.rollback.id paramètre du point de terminaison /sn_cicd/app/batch/install . Type de données : chaîne

Tableau 32. Paramètres de requête

Nom	Description
Néant

Tableau 33. Paramètres de corps de demande (XML ou JSON)

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

Tableau 34. 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 35. 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 la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

Tableau 36. Codes d'état

Code d'état	Description
200	Réussi. La demande a été correctement traitée.
401	Les informations d’identification de l’utilisateur sont incorrectes.
403	Interdit. L’utilisateur n’est pas un administrateur ou n’a pas le rôle sn_cicd.sys_ci_automation.
404	Introuvable. L’élément demandé est introuvable.
405	Méthode non valide. La fonctionnalité est inactive.
500	Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande.

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

Nom	Description
erreur	Message d’erreur avec détails sur l’erreur. Type de données : chaîne
Liens	Tous les liens et sys_ids associés à la réponse. Type de données : objet "links": { "progress": {Object} }
Liens.Progression	Informations sur la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : objet "progress": { "id": "String", "url": "String" }
links.progress.id	Sys_id contenant les détails de progression de l’opération. Vous pouvez utiliser cette valeur lors de l’appel du point CI/CD : OBTENIR /sn_cicd/progression/{progress_id}de terminaison . Type de données : chaîne
liens.progression.url	URL à utiliser pour récupérer les détails de la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : chaîne
percent_complete	Pourcentage de la demande terminée. Type de données : nombre
status	Numéro représentant l’état d’exécution de l’action exécutée sur l’ensemble de mises à jour. Correspond au status_label descripteur. Valeurs possibles : 0 : en attente 1 : En cours d’exécution 2 : Réussi 3 : Échec 4 : Annulé Type de données : chaîne
status_detail	Message détaillé sur l’état d’exécution, le cas échéant. Correspond au champ detailed_message de la table Suivi de l’exécution [sys_execution_tracker]. Type de données : chaîne
status_label	État d’exécution de l’action de l’ensemble de mises à jour. Correspond au status nombre. Valeurs possibles : Annulé Échoué En attente En cours d'exécution Réussi Type de données : chaîne
status_message	Description supplémentaire de l’état actuel de l’action, si disponible. Type de données : chaîne

Demande cURL

Cet exemple restaure la version précédente de tous les packages du plan de lots d’installation spécifié.

curl 'instance.servicenow.com/api/sn_cicd/app/batch/rollback/a329f82e871da64c724ba21c82a764f2 \
--request POST \
--header 'Accept: application/json' \
--user 'username':'password'

{
"result": {
   "links": {
     "progress": {
       "id": "c159b1e9db1c0010b5e3f6c5ae961903",
       "url": "https://instance.servicenow.com/api/sn_cicd/progress/c159b1e9db1c0010b5e3f6c5ae961903"
     },
   "status": "0",
   "status_label": "Pending",
   "status_message": "",
   "status_detail": "",
   "error": "",
   "percent_complete": 0
  }
}

CI/CD : POST/sn_cicd/app_repo/install

Installe l’application spécifiée à partir du référentiel d’applications sur l’instance appelant le point de terminaison.

À l’aide de ce point de terminaison, vous pouvez installer un système de base et des applications non modifiés et ServiceNow Store personnalisésServiceNow, des modules d’extension personnalisés ServiceNow et vos propres ServiceNow applications.

Vous trouverez ci-dessous les paramètres que vous devez transmettre pour implémenter des cas d’utilisation spécifiques. Tous les paramètres qui ne sont pas spécifiés ne sont pas transmis et utilisent les valeurs par défaut associées.

• Pour installer uniquement l’application de base et non les personnalisations d’application correspondantes.
  • sys_id : Sys_id de l’application de base qui a été personnalisée.
  • base_app_version : version de l’application de base à installer.
• Pour installer une version spécifiée des personnalisations d’application et installer automatiquement la version d’application de base recommandée. La version d’application de base recommandée est la version de l’application de base installée sur l’instance au moment de la dernière publication des personnalisations. Chaque version des personnalisations d’application dispose d’une version d’application de base recommandée correspondante.
  • sys_id : Sys_id de l’application qui a été personnalisée.
  • auto_upgrade_base_app : vrai
  • Version : version des personnalisations de l’application à installer.
• Pour installer la dernière version des personnalisations d’application et sa version d’application de base recommandée correspondante.
  • sys_id : Sys_id de l’application qui a été personnalisée.
  • auto_upgrade_base_app : vrai
• Pour installer la dernière version des personnalisations d’application, mais pas mettre à niveau l’application de base vers les personnalisations d’application version d’application recommandée.
  • sys_id : Sys_id de l’application qui a été personnalisée.
  • auto_upgrade_base_app : faux
• Pour installer les personnalisations de l’application avec le module d’extension inclus ServiceNow dans le périmètre de la version actuelle.
  • scope : champ d’application du module d’extension qui a été personnalisé OU
  • sys_id : Sys_id de l’application qui a été personnalisée. Il ne s’agit pas de l’ID du module d’extension.
  • Version : version des personnalisations de l’application à installer.
• Pour installer les personnalisations d’application pour un module d’extension inclus dans le périmètre déjà installé et activé.
  • sys_id : Sys_id de l’application qui a été personnalisée. Il ne s’agit pas de l’ID du module d’extension.
  • auto_upgrade_base_app : faux
  • Version : version des personnalisations de l’application à installer.

Étant donné que les modules d’extension de base ne peuvent avoir qu’une seule version par version familiale, les auto_upgrade_base_app paramètres et base_app_version ne s’appliquent pas aux installations de personnalisation d’application pour les modules d’extension. Pour activer un module d’extension pour la première fois sur une instance, utilisez plutôt le point de terminaison /sn_cicd/plugin/{plugin_id}/activate .

Remarque :

Ce point de terminaison utilise un modèle de réponse asynchrone. Lorsque vous appelez un point de terminaison, la fonction associée est lancée, par exemple en démarrant l’exécution du plan d’installation par lots. Le point de terminaison renvoie ensuite un message de réponse contenant l’état d’exécution de la fonction demandée, généralement En attente, ainsi qu’un identificateur et un lien uniques. Utilisez ces informations pour obtenir des informations supplémentaires sur la progression ou les résultats de la demande.

Format d'URL

URL versionnée : /api/sn_cicd/{api_version}/app_repo/install

URL par défaut : /api/sn_cicd/app_repo/install

Remarque :

Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

Paramètres de demande pris en charge

Tableau 37. Paramètres de chemin d'accès

Nom	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Par 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 38. Paramètres de requête

Nom	Description
auto_upgrade_base_app	Applicable uniquement si vous avez l’intention d’installer des personnalisations d’application et que l’application de base a été créée sur une version ultérieure à la version actuellement installée. Marqueur indiquant si l’application de base associée doit être automatiquement mise à niveau vers une version ultérieure. Valeurs valides : vrai : mettre à niveau automatiquement l’application de base associée. faux : laissez l’application de base telle que la version actuellement installée sur l’instance. Type de données : booléennes Valeur par défaut : false
base_app_version	Version de l’application de base à installer. Une application de base est une application tierce disponible dans leServiceNow Store. Si l’application n’a aucune personnalisation d’application, ou si l’application a des personnalisations d’application et que vous ne mettez à jour que l’application de base, entrez la version mise à jour de l’application dans ce paramètre. Si vous mettez à jour des personnalisations d’application, ne transmettez pas ce paramètre, mais transmettez-le version plutôt. Type de données : chaîne Valeur par défaut : nul
périmètre	Requis si sys_id n’est pas spécifié. Nom du périmètre de l’application, par exemple x_aah_custom_app. Type de données : chaîne Table : dans le champ d’application de la table Application personnalisée [sys_app] ou de l’application du magasin [sys_store_app].
sys_id	Requis si scope n’est pas spécifié. Sys_id de l’application à installer. Type de données : chaîne Table : dans le champ ID système, dans la table Application personnalisée [sys_app] ou dans la table Application du magasin [sys_store_app].
version	Version de l’application à installer. Type de données : chaîne Par défaut : si le base_app_version paramètre est vide et défini sur vrai, installe les toutes dernières personnalisations de l’application auto_upgrade_base_app et sa version d’application de base recommandée (tant qu’il ne passe pas à une version antérieure de l’application de base). Si le auto_upgrade_base_app paramètre est faux, installe les personnalisations de l’application, mais l’application de base n’est pas mise à niveau. Si le base_app_version paramètre est défini, seule l’application de base est installée.

Tableau 39. Paramètres de corps de demande (XML ou JSON)

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

Tableau 40. 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 41. 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 la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

Tableau 42. Codes d'état

Code d'état	Description
200	Réussi. La demande a été correctement traitée.
401	Les informations d’identification de l’utilisateur sont incorrectes.
403	Interdit. L’utilisateur n’est pas un administrateur ou n’a pas le rôle sn_cicd.sys_ci_automation.
404	Introuvable. L’élément demandé est introuvable.
405	Méthode non valide. La fonctionnalité est inactive.
409	Conflit. L’élément demandé n’est pas unique.
500	Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande.

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

Nom	Description
erreur	Message d’erreur avec détails sur l’erreur. Type de données : chaîne
Liens	Informations sur les liens et les sys_ids associés à l’ensemble de mises à jour. Type de données : objet "links": { "progress": {Object} }
Liens.Progression	Informations sur la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : objet "progress": { "id": "String", "url": "String" }
links.progress.id	Sys_id contenant les détails de progression de l’opération. Vous pouvez utiliser cette valeur lors de l’appel du point CI/CD : OBTENIR /sn_cicd/progression/{progress_id}de terminaison . Type de données : chaîne
liens.progression.url	URL à utiliser pour récupérer les détails de la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : chaîne
percent_complete	Pourcentage de la demande terminée. Type de données : nombre
rollback_version	Si disponible, la version précédemment installée. S’il n’est pas disponible, la valeur est null. Type de données : chaîne
statut	Numéro représentant l’état d’exécution de l’action exécutée sur l’ensemble de mises à jour. Correspond au status_label descripteur. Valeurs possibles : 0 : en attente 1 : En cours d’exécution 2 : Réussi 3 : Échec 4 : Annulé Type de données : chaîne
status_detail	Message détaillé sur l’état d’exécution, le cas échéant. Correspond au champ detailed_message de la table Suivi de l’exécution [sys_execution_tracker]. Type de données : chaîne
status_label	État d’exécution de l’action de l’ensemble de mises à jour. Correspond au status nombre. Valeurs possibles : Annulé Échoué En attente En cours d'exécution Réussi Type de données : chaîne
status_message	Description supplémentaire de l’état actuel de l’action, si disponible. Type de données : chaîne

Demande cURL

curl 'instance.servicenow.com/api/sn_cicd/app_repo/install?sys_id=2d146921dbd80010caf55268dc9619d8' \
--request POST \
--header 'Accept: application/json' \
--user 'username':'password'

{
"result": {
   "links": {
     "progress": {
        "id": "c159b1e9db1c0010b5e3f6c5ae961903",
        "url": "https://instance.servicenow.com/api/sn_cicd/progress/c159b1e9db1c0010b5e3f6c5ae961903"
      }
   },
   "status": "0",
   "status_label": "Pending",
   "status_message": "",
   "status_detail": "",
   "error": "",
   "percent_complete": 0,
   "rollback_version": "1.1.0"
  }
}

CI/CD : POST/sn_cicd/app_repo/PUBLIER

Publie l’application spécifiée et tous ses artefacts dans le référentiel d’applications.

Remarque :

Si des modifications non validées sont apportées aux fichiers suivis lorsque vous appelez ce point de terminaison, il renvoie un code d’état 400 Bad Request. Vous pouvez valider les changements manuellement ou Studio appeler le point de CI/CD : POST /sn_cicd/SC/apply_changes terminaison pour dissimuler les changements. Les changements qui ne sont pas suivis dans la table Mises à jour du client [sys_update_xml] sont validés automatiquement après leur publication dans le référentiel d’applications. Pour en savoir plus sur la mise en page des changements dans la table Mises à jour du client et pour obtenir une description des changements qui ne sont pas représentés dans cette table, reportez-vous à la section Customer Updates table.

Format d'URL

URL versionnée : /api/sn_cicd/{api_version}/app_repo/publish

URL par défaut : /api/sn_cicd/app_repo/publish

Remarque :

Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

Paramètres de demande pris en charge

Tableau 43. Paramètres de chemin d'accès

Nom	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Par 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 44. Paramètres de requête

Nom	Description
dev_notes	Notes du développeur à stocker avec l’application. Type de données : chaîne
périmètre	Requis si sys_id n’est pas spécifié. Le périmètre de l’application. Type de données : chaîne Table : dans le champ d’application de la table Application personnalisée [sys_app].
sys_id	Requis si scope n’est pas spécifié. La sys_id de l’application à stocker dans le référentiel. Type de données : chaîne Table : dans le champ ID système de la table Application personnalisée [sys_app].
version	Version sous laquelle stocker l’application. Si le numéro de version est transmis, le processus de publication utilise cette version et met à jour la version d’application locale si elle est différente. Si le numéro de version n’est pas transmis, le processus de publication utilise la version actuelle de l’application locale et échoue si cette version existe dans le référentiel d’applications. Type de données : chaîne

Tableau 45. Paramètres de corps de demande (XML ou JSON)

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

Tableau 46. 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 47. 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 la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

Tableau 48. Codes d'état

Code d'état	Description
200	Réussi. La demande a été correctement traitée.
400	La demande a échoué. Problèmes possibles : La version de l’application n’est pas correcte ou constitue une version antérieure. L’application est connectée au contrôle de source et contient des changements non validés qui doivent être résolus. Consultez le message d’erreur renvoyé pour plus d’informations.
401	Les informations d’identification de l’utilisateur sont incorrectes.
403	Interdit. L’utilisateur n’est pas un administrateur ou n’a pas le rôle sn_cicd.sys_ci_automation.
404	Introuvable. L’élément demandé est introuvable.
405	Méthode non valide. La fonctionnalité est inactive.
409	Conflit. L’élément demandé n’est pas unique.
500	Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande.

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

Nom	Description
erreur	Message d’erreur avec détails sur l’erreur. Type de données : chaîne
Liens	Informations sur les liens et les sys_ids associés à l’ensemble de mises à jour. Type de données : objet "links": { "progress": {Object} }
Liens.Progression	Informations sur la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : objet "progress": { "id": "String", "url": "String" }
links.progress.id	Sys_id contenant les détails de progression de l’opération. Vous pouvez utiliser cette valeur lors de l’appel du point CI/CD : OBTENIR /sn_cicd/progression/{progress_id}de terminaison . Type de données : chaîne
liens.progression.url	URL à utiliser pour récupérer les détails de la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : chaîne
percent_complete	Pourcentage de la demande terminée. Type de données : nombre
status	Message détaillé sur l’état d’exécution, le cas échéant. Correspond au champ detailed_message de la table Suivi de l’exécution [sys_execution_tracker]. Type de données : chaîne
status_detail	Message détaillé sur l’état d’exécution, le cas échéant. Correspond au champ detailed_message de la table Suivi de l’exécution [sys_execution_tracker]. Type de données : chaîne
status_label	État d’exécution de l’action de l’ensemble de mises à jour. Correspond au status nombre. Valeurs possibles : Annulé Échoué En attente En cours d'exécution Réussi Type de données : chaîne
status_message	Description supplémentaire de l’état actuel de l’action, si disponible. Type de données : chaîne

L’exemple suivant montre comment publier l’application avec le sys_id spécifié et tous ses artefacts dans le référentiel d’applications.

curl 'instance.servicenow.com/api/sn_cicd/app_repo/publish?sys_id=4dd9686d1b9800103d374087bc4bcb3d' \
--request POST \
--header 'Accept: application/json' \
--user 'username':'password'

{
"result": {
   "links": {
       "progress": {
           "id": "d174f8e11bd800103d374087bc4bcbd9",
           "url": "https://instance.service-now.com/api/sn_cicd/progress/d174f8e11bd800103d374087bc4bcbd9"
        }
    },
    "status": "0",
    "status_label": "Pending",
    "status_message": "",
    "status_detail": "",
    "error": "",
    "percent_complete": 0
  }
}

CI/CD : POST /sn_cicd/app_repo/rollback

Lance une restauration d’une application spécifiée vers une version spécifiée.

Remarque :

La fonctionnalité de restauration n’est disponible qu’une fois l’installation terminée.

Format d'URL

URL versionnée : /api/sn_cicd/{api_version}/app_repo/rollback

URL par défaut : /api/sn_cicd/app_repo/rollback

Remarque :

Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

Paramètres de demande pris en charge

Tableau 49. Paramètres de chemin d'accès

Nom	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Par 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 50. Paramètres de requête

Nom	Description
périmètre	Requis si sys_id n’est pas spécifié. Nom du périmètre de l’application à restaurer. Type de données : chaîne
sys_id	Requis si scope n’est pas spécifié. L’sys_id de l’application à restaurer. Type de données : chaîne
version	Requis. Version de l’application attendue après l’opération de restauration. Si la demande vise à restaurer une installation de personnalisation d’application, définissez ce champ sur la version de l’application de base que le système est censé avoir après l’opération de restauration. Type de données : chaîne

Tableau 51. Paramètres de corps de demande (XML ou JSON)

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

Tableau 52. 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 53. 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 la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

Tableau 54. Codes d'état

Code d'état	Description
200	Réussi. La demande a été correctement traitée.
401	Les informations d’identification de l’utilisateur sont incorrectes.
403	Interdit. L’utilisateur n’est pas un administrateur ou n’a pas le rôle sn_cicd.sys_ci_automation.
405	Méthode non valide. La fonctionnalité est inactive.
500	Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande.

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

Nom	Description
erreur	Message d’erreur avec détails sur l’erreur. Type de données : chaîne
Liens	Informations sur les liens et les sys_ids associés à l’ensemble de mises à jour. Type de données : objet "links": { "progress": {Object} }
Liens.Progression	Informations sur la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : objet "progress": { "id": "String", "url": "String" }
links.progress.id	Sys_id contenant les détails de progression de l’opération. Vous pouvez utiliser cette valeur lors de l’appel du point CI/CD : OBTENIR /sn_cicd/progression/{progress_id}de terminaison . Type de données : chaîne
liens.progression.url	URL à utiliser pour récupérer les détails de la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : chaîne
percent_complete	Pourcentage de la demande terminée. Type de données : nombre
status	Numéro représentant l’état d’exécution de l’action exécutée sur l’ensemble de mises à jour. Correspond au status_label descripteur. Valeurs possibles : 0 : en attente 1 : En cours d’exécution 2 : Réussi 3 : Échec 4 : Annulé Type de données : chaîne
status_detail	Message détaillé sur l’état d’exécution, le cas échéant. Correspond au champ detailed_message de la table Suivi de l’exécution [sys_execution_tracker]. Type de données : chaîne
status_label	État d’exécution de l’action de l’ensemble de mises à jour. Correspond au status nombre. Valeurs possibles : Annulé Échoué En attente En cours d'exécution Réussi Type de données : chaîne
status_message	Description supplémentaire de l’état actuel de l’action, si disponible. Type de données : chaîne

Demande cURL

curl 'instance.servicenow.com/api/sn_cicd/app_repo/rollback?sys_id=2d146921dbd80010caf55268dc9619d8&version=1.1.0' \
--request POST \
--header 'Accept: application/json' \
--user 'username':'password'

{
"result": {
   "links": {
      "progress": {
          "id": "f7ddb1eddb1c0010b5e3f6c5ae9619c1",
          "url": "https://instance.service-now.com/api/sn_cicd/progress/f7ddb1eddb1c0010b5e3f6c5ae9619c1"
       }
   },
   "status": "0",
   "status_label": "Pending",
   "status_message": "",
   "status_detail": "",
   "error": "",
   "percent_complete": 0
  }
}

CI/CD : POST /sn_cicd/instance_scan/full_scan

Exécute toutes les vérifications actives présentes dans votre instance.

Vous pouvez exécuter les vérifications fournies ou Instance Scan créer vos propres vérifications. Pour plus d’informations, consultez Analyse d’instance.

Remarque :

Ce point de terminaison fait partie de l’API de service d’exécution d’analyse d’instance CICD et est utilisé sous l’espace de noms sn_cicd .

Format d'URL

URL versionnée : /api/sn_cicd/{api_version}/instance_scan/full_scan

URL par défaut : /api/sn_cicd/instance_scan/full_scan

Remarque :

Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

Paramètres de demande pris en charge

Tableau 55. Paramètres

Paramètre	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Par 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

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.

Tableau 56. 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 57. En-têtes de réponses

En-tête	Description
Aucun

Codes d'état

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.

Tableau 58. Codes d'état

Code d'état	Description
200	Réussi. La demande a été correctement traitée.
401	Les informations d’identification de l’utilisateur sont incorrectes.
403	Interdit. L’utilisateur n’est pas un administrateur ou n’a pas le rôle sn_cicd.sys_ci_automation.
500	Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande.

Corps de la demande

L’API accepte ces éléments JSON ou XML dans le corps de la demande.

Tableau 59. Éléments acceptés dans le corps de la demande

Élément	Description
Néant

Corps de réponse

L’API renvoie ces éléments JSON ou XML dans le corps de la réponse.

Tableau 60. Éléments renvoyés dans le corps de réponse

Élément	Description
erreur	Message d’erreur avec détails sur l’erreur. Type de données : chaîne
Liens	Informations sur les liens et les sys_ids associés à l’ensemble de mises à jour. Type de données : objet "links": { "progress": {Object} }
Liens.Progression	Informations sur la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : objet "progress": { "id": "String", "url": "String" }
links.progress.id	Identificateur unique du détail de progression. Utilisez cette valeur lors de l’appel du point de terminaison /sn_cicd/instance_scan/result/{progress_id}.
liens.progression.url	URL à utiliser pour récupérer les détails de la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : chaîne
statut	Numéro représentant l’état d’exécution de l’action exécutée sur l’ensemble de mises à jour. Correspond au status_label descripteur. Valeurs possibles : 0 : en attente 1 : En cours d’exécution 2 : Réussi 3 : Échec 4 : Annulé Type de données : chaîne
status_detail	Message détaillé sur l’état d’exécution, le cas échéant. Correspond au champ detailed_message de la table Suivi de l’exécution [sys_execution_tracker]. Type de données : chaîne
status_label	État d’exécution de l’action de l’ensemble de mises à jour. Correspond au status nombre. Valeurs possibles : Annulé Échoué En attente En cours d'exécution Réussi Type de données : chaîne
status_message	Informations supplémentaires sur le motif d’échec de l’opération. Renvoie une chaîne vide si l’opération réussit. Type de données : chaîne

Exemple de demande cURL

curl 'instance.service-now.com/api/sn_cicd/instance_scan/full_scan' \
--request POST \
--header 'Accept: application/json' \
--user 'username':'password'

{
"result": {
   "links": {
       "progress": {
           "id": "a4fae8911bdc00103d374087bc4bcbbd",
           "url": "https://instance.service-now/api/sn_cicd/progress/a4fae8911bdc00103d374087bc4bcbbd"
        }
    },
    "status": "0",
    "status_label": "Pending",
    "status_message": "",
    "status_detail": "",
    "error": ""
  }
}

CI/CD : POST /sn_cicd/instance_scan/point_scan

Exécute toutes les vérifications applicables par rapport à un enregistrement spécifié.

Par exemple, si vous exécutez une analyse de points par rapport à un élément de catalogue, seuls les contrôles applicables à la table Élément de catalogue s’exécutent et seul l’enregistrement spécifié est analysé.

Vous pouvez exécuter les vérifications fournies ou Instance Scan créer vos propres vérifications. Pour plus d’informations, consultez Analyse d’instance.

Remarque :

Ce point de terminaison fait partie de l’API de service d’exécution d’analyse d’instance CICD et est utilisé sous l’espace de noms sn_cicd .

Format d'URL

URL versionnée : /api/sn_cicd/{api_version}/instance_scan/point_scan

URL par défaut : /api/sn_cicd/instance_scan/point_scan

Remarque :

Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

Paramètres de demande pris en charge

Tableau 61. Paramètres

Paramètre	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Par 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
target_table	Requis. Nom de la table dans laquelle se trouve l’enregistrement à analyser, tel que « Incident ». Type de données : chaîne
target_sys_id	Requis. L’sys_id de l’enregistrement dans la table spécifiée à analyser. Type de données : chaîne

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.

Tableau 62. 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 63. En-têtes de réponses

En-tête	Description
Aucun

Codes d'état

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.

Tableau 64. Codes d'état

Code d'état	Description
200	Réussi. La demande a été correctement traitée.
400	Demande incorrecte. Paramètres de requête non valides ou vides.
401	Les informations d’identification de l’utilisateur sont incorrectes.
403	Interdit. L’utilisateur n’est pas un administrateur ou n’a pas le rôle sn_cicd.sys_ci_automation.
500	Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande.

Corps de la demande

L’API accepte ces éléments JSON ou XML dans le corps de la demande.

Tableau 65. Éléments acceptés dans le corps de la demande

Élément	Description
Néant

Corps de réponse

L’API renvoie ces éléments JSON ou XML dans le corps de la réponse.

Tableau 66. Éléments renvoyés dans le corps de réponse

Élément	Description
erreur	Message d’erreur avec détails sur l’erreur. Type de données : chaîne
Liens	Informations sur les liens et les sys_ids associés à l’ensemble de mises à jour. Type de données : objet "links": { "progress": {Object} }
Liens.Progression	Informations sur la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : objet "progress": { "id": "String", "url": "String" }
links.progress.id	Identificateur unique du détail de progression. Utilisez cette valeur lors de l’appel du point de terminaison /sn_cicd/instance_scan/result/{progress_id}.
liens.progression.url	URL à utiliser pour récupérer les détails de la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : chaîne
statut	Numéro représentant l’état d’exécution de l’action exécutée sur l’ensemble de mises à jour. Correspond au status_label descripteur. Valeurs possibles : 0 : en attente 1 : En cours d’exécution 2 : Réussi 3 : Échec 4 : Annulé Type de données : chaîne
status_detail	Message détaillé sur l’état d’exécution, le cas échéant. Correspond au champ detailed_message de la table Suivi de l’exécution [sys_execution_tracker]. Type de données : chaîne
status_label	État d’exécution de l’action de l’ensemble de mises à jour. Correspond au status nombre. Valeurs possibles : Annulé Échoué En attente En cours d'exécution Réussi Type de données : chaîne
status_message	Informations supplémentaires sur le motif d’échec de l’opération. Renvoie une chaîne vide si l’opération réussit. Type de données : chaîne

Exemple de demande cURL

curl 'instance.service-now.com/api/sn_cicd/instance_scan/point_scan?target_table=incident&target_sys_id=2d146921dbd80010caf55268dc9619d8' \
--request POST \
--header 'Accept: application/json' \
--user 'username':'password'

{
"result": {
   "links": {
       "progress": {
           "id": "a4fae8911bdc00103d374087bc4bcbbd",
           "url": "https://instance.service-now/api/sn_cicd/progress/a4fae8911bdc00103d374087bc4bcbbd"
        }
    },
    "status": "0",
    "status_label": "Pending",
    "status_message": "",
    "status_detail": "",
    "error": ""
  }
}

CI/CD : POST /sn_cicd/instance_scan/suite_scan/combo/{combo_sys_id}

Exécute une analyse à l’aide d’une suite et d’une cible (applications incluses dans le périmètre ou ensembles de mises à jour) qui ont déjà été exécutées précédemment.

Avant d’appeler ce point de terminaison, vous devez appeler les points de terminaison /sn_cicd/instance_scan/suite_scan/{suite_sys_id}/scoped_apps ou /sn_cicd/instance_scan/suite_scan/{suite_sys_id}/update_sets ou exécuter une analyse de suite dans l’interface utilisateur.

Remarque :

Ce point de terminaison fait partie de l’API de service d’exécution d’analyse d’instance CICD et est utilisé sous l’espace de noms sn_cicd .

Format d'URL

URL versionnée : /api/sn_cicd/{api_version}/instance_scan/suite_scan/combo/{combo_sys_id}

URL par défaut : /api/sn_cicd/instance_scan/suite_scan/combo/{combo_sys_id}

Remarque :

Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

Paramètres de demande pris en charge

Tableau 67. Paramètres de chemin d'accès

Nom	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Par 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
combo_sys_id	Sys_id de l’analyse à exécuter. L’analyse doit être existante et vous souhaitez l’exécuter à nouveau. Type de données : chaîne Tableau : Combo [scan_combo]

Tableau 68. Paramètres de requête

Nom	Description
Néant

Tableau 69. Paramètres de corps de demande (XML ou JSON)

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

Tableau 70. 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 71. 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 la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

Tableau 72. Codes d'état

Code d'état	Description
200	Réussi. La demande a été correctement traitée.
401	Les informations d’identification de l’utilisateur sont incorrectes.
403	Interdit. L’utilisateur n’est pas un administrateur ou n’a pas le rôle sn_cicd.sys_ci_automation.
500	Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande.

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

Élément	Description
erreur	Message d’erreur avec détails sur l’erreur. Type de données : chaîne
Liens	Informations sur les liens et les sys_ids associés à l’ensemble de mises à jour. Type de données : objet "links": { "progress": {Object} }
Liens.Progression	Informations sur la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : objet "progress": { "id": "String", "url": "String" }
links.progress.id	Identificateur unique du détail de progression. Utilisez cette valeur lors de l’appel du point de terminaison /sn_cicd/instance_scan/result/{progress_id}. Type de données : chaîne
liens.progression.url	URL à utiliser pour récupérer les détails de la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : chaîne
statut	Numéro représentant l’état d’exécution de l’action exécutée sur l’ensemble de mises à jour. Correspond au status_label descripteur. Valeurs possibles : 0 : en attente 1 : En cours d’exécution 2 : Réussi 3 : Échec 4 : Annulé Type de données : chaîne
status_detail	Message détaillé sur l’état d’exécution, le cas échéant. Correspond au champ detailed_message de la table Suivi de l’exécution [sys_execution_tracker]. Type de données : chaîne
status_label	État d’exécution de l’action de l’ensemble de mises à jour. Correspond au status nombre. Valeurs possibles : Annulé Échoué En attente En cours d'exécution Réussi Type de données : chaîne
status_message	Informations supplémentaires sur le motif d’échec de l’opération. Renvoie une chaîne vide si l’opération réussit. Type de données : chaîne

Demande cURL

curl "https://instance.servicenow.com/api/sn_cicd/instance_scan/suite_scan/combo/245d29cc1bd32010178aed72604bcb4b" \
--request POST \
--header "Accept:application/json" \
--user 'username':'password'

Corps de réponse : réussite.

{
  "result": {
    "links": {
      "progress": {
        "id": "c08be5c71b1b2010178aed72604bcb6e",
        "url": "https://instance.servicenow.com/api/sn_cicd/progress/c08be5c71b1b2010178aed72604bcb6e"
      }
    },
    "status": "0",
    "status_label": "Pending",
    "status_message": "",
    "status_detail": "",
    "error": ""
  }
}

CI/CD : POST /sn_cicd/instance_scan/suite_scan/{suite_sys_id}/scoped_apps

Exécute toutes les vérifications actives dans une suite par rapport à une liste d’applications incluses dans le périmètre.

Remarque :

Ce point de terminaison fait partie de l’API de service d’exécution d’analyse d’instance CICD et est utilisé sous l’espace de noms sn_cicd .

Format d'URL

URL versionnée : /api/sn_cicd/{api_version}/instance_scan/suite_scan/{suite_sys_id}/scoped_apps

URL par défaut : /api/sn_cicd/instance_scan/suite_scan/{suite_sys_id}/scoped_apps

Remarque :

Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

Paramètres de demande pris en charge

Tableau 73. Paramètres de chemin d'accès

Nom	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Par 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
suite_sys_id	Sys_id de la suite à exécuter. Type de données : chaîne Tableau : Suite [scan_check_suite]

Tableau 74. Paramètres de requête

Nom	Description
Néant

Tableau 75. Paramètres de corps de demande (XML ou JSON)

Nom	Description
app_scope_sys_ids	Requis. Une liste des sys_ids des applications incluses dans le périmètre à analyser. Ne peut pas être un tableau vide. Type de données : tableau app_scope_sys_ids: ["String", "String", "String"] Table : Application [sys_scope]

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.

Tableau 76. 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
Content-Type	Format de données du corps de la demande. Prend uniquement en charge application/json.

Tableau 77. 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 la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

Tableau 78. Codes d'état

Code d'état	Description
200	Réussi. La demande a été correctement traitée.
401	Les informations d’identification de l’utilisateur sont incorrectes.
403	Interdit. L’utilisateur n’est pas un administrateur ou n’a pas le rôle sn_cicd.sys_ci_automation.
500	Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande.

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

Élément	Description
erreur	Message d’erreur avec détails sur l’erreur. Type de données : chaîne
Liens	Informations sur les liens et les sys_ids associés à l’ensemble de mises à jour. Type de données : objet "links": { "progress": {Object} }
Liens.Progression	Informations sur la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : objet "progress": { "id": "String", "url": "String" }
links.progress.id	Identificateur unique du détail de progression. Utilisez cette valeur lors de l’appel du point de terminaison /sn_cicd/instance_scan/result/{progress_id}. Type de données : chaîne
liens.progression.url	URL à utiliser pour récupérer les détails de la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : chaîne
statut	Numéro représentant l’état d’exécution de l’action exécutée sur l’ensemble de mises à jour. Correspond au status_label descripteur. Valeurs possibles : 0 : en attente 1 : En cours d’exécution 2 : Réussi 3 : Échec 4 : Annulé Type de données : chaîne
status_detail	Message détaillé sur l’état d’exécution, le cas échéant. Correspond au champ detailed_message de la table Suivi de l’exécution [sys_execution_tracker]. Type de données : chaîne
status_label	État d’exécution de l’action de l’ensemble de mises à jour. Correspond au status nombre. Valeurs possibles : Annulé Échoué En attente En cours d'exécution Réussi Type de données : chaîne
status_message	Informations supplémentaires sur le motif d’échec de l’opération. Renvoie une chaîne vide si l’opération réussit. Type de données : chaîne

Demande cURL

Cet exemple exécute toutes les vérifications actives au sein d’une suite par rapport à une application incluse dans le périmètre.

curl "https://instance.servicenow.com/api/sn_cicd/instance_scan/suite_scan/833655cc1b94101046e87733cd4bcb4e/scoped_apps" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{app_scope_sys_ids: [\"078e8020950f12a215a92e8ad9b346e0\"]}" \
--user 'username':'password'

Corps de réponse : réussite.

{
  "result": {
    "links": {
      "progress": {
        "id": "147fc14b1b572010178aed72604bcbca",
        "url": "https://instance.servicenow.com/api/sn_cicd/progress/147fc14b1b572010178aed72604bcbca"
      }
    },
    "status": "0",
    "status_label": "Pending",
    "status_message": "",
    "status_detail": "",
    "error": ""
  }
}

CI/CD : POST /sn_cicd/instance_scan/suite_scan/{suite_sys_id}/update_sets

Exécute toutes les vérifications actives dans une suite par rapport à une liste d’ensembles de mises à jour.

Remarque :

Ce point de terminaison fait partie de l’API de service d’exécution d’analyse d’instance CICD et est utilisé sous l’espace de noms sn_cicd .

Format d'URL

URL versionnée : /api/sn_cicd/{api_version}/instance_scan/suite_scan/{suite_sys_id}/update_sets

URL par défaut : /api/sn_cicd/instance_scan/suite_scan/{suite_sys_id}/update_sets

Remarque :

Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

Paramètres de demande pris en charge

Tableau 79. Paramètres de chemin d'accès

Nom	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Par 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
suite_sys_id	Sys_id de la suite à exécuter. Type de données : chaîne Tableau : Suite [scan_check_suite]

Tableau 80. Paramètres de requête

Nom	Description
Néant

Tableau 81. Paramètres de corps de demande (XML ou JSON)

Nom	Description
update_set_sys_ids	Requis. Liste des sys_ids des ensembles de mises à jour à analyser. Ne peut pas être un tableau vide. Type de données : tableau update_set_sys_ids: ["String", "String", "String"] Table : Ensemble de mises à jour [sys_update_set]

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.

Tableau 82. 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
Content-Type	Format de données du corps de la demande. Prend uniquement en charge application/json.

Tableau 83. 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 la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

Tableau 84. Codes d'état

Code d'état	Description
200	Réussi. La demande a été correctement traitée.
401	Les informations d’identification de l’utilisateur sont incorrectes.
403	Interdit. L’utilisateur n’est pas un administrateur ou n’a pas le rôle sn_cicd.sys_ci_automation.
500	Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande.

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

Élément	Description
erreur	Message d’erreur avec détails sur l’erreur. Type de données : chaîne
Liens	Informations sur les liens et les sys_ids associés à l’ensemble de mises à jour. Type de données : objet "links": { "progress": {Object} }
Liens.Progression	Informations sur la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : objet "progress": { "id": "String", "url": "String" }
links.progress.id	Identificateur unique du détail de progression. Utilisez cette valeur lors de l’appel du point de terminaison /sn_cicd/instance_scan/result/{progress_id}. Type de données : chaîne
liens.progression.url	URL à utiliser pour récupérer les détails de la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : chaîne
statut	Numéro représentant l’état d’exécution de l’action exécutée sur l’ensemble de mises à jour. Correspond au status_label descripteur. Valeurs possibles : 0 : en attente 1 : En cours d’exécution 2 : Réussi 3 : Échec 4 : Annulé Type de données : chaîne
status_detail	Message détaillé sur l’état d’exécution, le cas échéant. Correspond au champ detailed_message de la table Suivi de l’exécution [sys_execution_tracker]. Type de données : chaîne
status_label	État d’exécution de l’action de l’ensemble de mises à jour. Correspond au status nombre. Valeurs possibles : Annulé Échoué En attente En cours d'exécution Réussi Type de données : chaîne
status_message	Informations supplémentaires sur le motif d’échec de l’opération. Renvoie une chaîne vide si l’opération réussit. Type de données : chaîne

Demande cURL

Cet exemple exécute toutes les vérifications actives dans une suite par rapport à un ensemble de mises à jour.

curl "https://instance.servicenow.com/api/sn_cicd/instance_scan/suite_scan/833655cc1b94101046e87733cd4bcb4e/update_sets" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{update_set_sys_ids: [\"7abef63c1b572010178aed72604bcbfd\"]}" \
--user 'username':'password'

Corps de réponse : réussite.

{
  "result": {
    "links": {
      "progress": {
        "id": "d27511031b972010178aed72604bcb72",
        "url": "https://instance.servicenow.com/api/sn_cicd/progress/d27511031b972010178aed72604bcb72"
      }
    },
    "status": "0",
    "status_label": "Pending",
    "status_message": "",
    "status_detail": "",
    "error": ""
  }
}

CI/CD : POST /sn_cicd/plugin/{plugin_id}/activate

Active le module d’extension spécifié.

Format d'URL

URL versionnée : /api/sn_cicd/{api_version}/plugin/{plugin_id}/activate

URL par défaut : /api/sn_cicd/plugin/{plugin_id}/activate

Remarque :

Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

Paramètres de demande pris en charge

Tableau 85. Paramètres de chemin d'accès

Nom	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Par 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
plugin_id	Identificateur unique du module d’extension. Vous pouvez localiser cet identifiant sur la page Plugins dans la carte du plugin souhaité ; identifiés par le nom « ID ». Type de données : chaîne

Tableau 86. Paramètres de requête

Nom	Description
Néant

Tableau 87. Paramètres de corps de demande (XML ou JSON)

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

Tableau 88. 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 89. 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 la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

Tableau 90. Codes d'état

Code d'état	Description
200	Réussi. La demande a été correctement traitée.
401	Les informations d’identification de l’utilisateur sont incorrectes.
403	Interdit. L’utilisateur n’est pas un administrateur ou n’a pas le rôle sn_cicd.sys_ci_automation.
404	Introuvable. L’élément demandé est introuvable.
405	Méthode non valide. La fonctionnalité est inactive.
409	Conflit. L’élément demandé n’est pas unique.
500	Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande.

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

Nom	Description
erreur	Message d’erreur avec détails sur l’erreur. Type de données : chaîne
Liens	Informations sur les liens et les sys_ids associés à l’ensemble de mises à jour. Type de données : objet "links": { "progress": {Object} }
Liens.Progression	Informations sur la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : objet "progress": { "id": "String", "url": "String" }
links.progress.id	Sys_id contenant les détails de progression de l’opération. Vous pouvez utiliser cette valeur lors de l’appel du point CI/CD : OBTENIR /sn_cicd/progression/{progress_id}de terminaison . Type de données : chaîne
liens.progression.url	URL à utiliser pour récupérer les détails de la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : chaîne
liens.résultats	ID et URL des résultats de l’exécution. Type de données : objet "results": { "id": "String", "url": "String" }
links.results.id	Sys_id des informations sur les résultats. Utilisez cette valeur pour l’appel du point de terminaison des résultats associé. Type de données : chaîne
liens.resultats.url	URL à utiliser pour obtenir les résultats de l’exécution du point de terminaison. Type de données : chaîne
percent_complete	Pourcentage de la demande terminée. Type de données : nombre
status	Numéro représentant l’état d’exécution de l’action exécutée sur l’ensemble de mises à jour. Correspond au status_label descripteur. Valeurs possibles : 0 : en attente 1 : En cours d’exécution 2 : Réussi 3 : Échec 4 : Annulé Type de données : chaîne
status_detail	Message détaillé sur l’état d’exécution, le cas échéant. Correspond au champ detailed_message de la table Suivi de l’exécution [sys_execution_tracker]. Type de données : chaîne
status_label	État d’exécution de l’action de l’ensemble de mises à jour. Correspond au status nombre. Valeurs possibles : Annulé Échoué En attente En cours d'exécution Réussi Type de données : chaîne
status_message	Description supplémentaire de l’état actuel de l’action, si disponible. Type de données : chaîne

Demande cURL

curl 'instance.servicenow.com/api/sn_cicd/plugin/com.glide.web_service_aggregate/activate' \
--request POST \
--header 'Accept: application/json' \
--user 'username':'password'

{
"result": {
   "links": {
      "progress": {
          "id": "5b3f052ddb580010caf55268dc961963",
          "url": "https://instance.service-now.com/api/sn_cicd/progress/5b3f052ddb580010caf55268dc961963"
       }
   },
   "status": "0",
   "status_label": "Pending",
   "status_message": "",
   "status_detail": "",
   "error": "",
   "percent_complete": 0
  }
}

CI/CD : POST /sn_cicd/plugin/{plugin_id}/rollback

Restaure le module d’extension spécifié à la version installée précédente. Si aucune version antérieure n’a été installée, renvoie une erreur.

Format d'URL

URL versionnée : /api/sn_cicd/{api_version}plugin/{plugin_id}/rollback

URL par défaut : /api/sn_cicd/plugin/{plugin_id}/rollback

Remarque :

Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

Paramètres de demande pris en charge

Tableau 91. Paramètres de chemin d'accès

Nom	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Par 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
plugin_id	Identificateur unique du module d’extension. Vous pouvez localiser cet identifiant sur la page Plugins dans la carte du plugin souhaité ; identifiés par le nom « ID ». Type de données : chaîne

Tableau 92. Paramètres de requête

Nom	Description
Néant

Tableau 93. Paramètres de corps de demande (XML ou JSON)

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

Tableau 94. 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 95. 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 la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

Tableau 96. Codes d'état

Code d'état	Description
200	Réussi. La demande a été correctement traitée.
401	Les informations d’identification de l’utilisateur sont incorrectes.
403	Interdit. L’utilisateur n’est pas un administrateur ou n’a pas le rôle sn_cicd.sys_ci_automation.
404	Introuvable. L’élément demandé est introuvable.
405	Méthode non valide. La fonctionnalité est inactive.
409	Conflit. L’élément demandé n’est pas unique.
500	Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande.

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

Nom	Description
erreur	Message d’erreur avec détails sur l’erreur. Type de données : chaîne
Liens	Informations sur les liens et les sys_ids associés à l’ensemble de mises à jour. Type de données : objet "links": { "progress": {Object} }
Liens.Progression	Informations sur la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : objet "progress": { "id": "String", "url": "String" }
links.progress.id	Sys_id contenant les détails de progression de l’opération. Vous pouvez utiliser cette valeur lors de l’appel du point CI/CD : OBTENIR /sn_cicd/progression/{progress_id}de terminaison . Type de données : chaîne
liens.progression.url	URL à utiliser pour récupérer les détails de la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : chaîne
percent_complete	Pourcentage de la demande terminée. Type de données : nombre
status	Numéro représentant l’état d’exécution de l’action exécutée sur l’ensemble de mises à jour. Correspond au status_label descripteur. Valeurs possibles : 0 : en attente 1 : En cours d’exécution 2 : Réussi 3 : Échec 4 : Annulé Type de données : chaîne
status_detail	Message détaillé sur l’état d’exécution, le cas échéant. Correspond au champ detailed_message de la table Suivi de l’exécution [sys_execution_tracker]. Type de données : chaîne
status_label	État d’exécution de l’action de l’ensemble de mises à jour. Correspond au status nombre. Valeurs possibles : Annulé Échoué En attente En cours d'exécution Réussi Type de données : chaîne
status_message	Description supplémentaire de l’état actuel de l’action, si disponible. Type de données : chaîne

Demande cURL

curl 'instance.servicenow.com/api/sn_cicd/plugin/com.glide.web_service_aggregate/rollback' \
--request POST \
--header 'Accept: application/json' \
--user 'username':'password'

{
"result": {
   "links": {
      "progress": {
         "id": "6185dd61db980010caf55268dc961916",
          "url": "https://instance.service-now.com/api/sn_cicd/progress/6185dd61db980010caf55268dc961916"
        }
    },
    "status": "0",
    "status_label": "Pending",
    "status_message": "",
    "status_detail": "",
    "error": "",
    "percent_complete": 0
  }
}

CI/CD : POST /sn_cicd/SC/apply_changes

Commence à appliquer les modifications à partir d’un contrôle de source distant à une application locale spécifiée ou à une application-personnalisation spécifiée.

Format d'URL

URL versionnée : /api/sn_cicd/{api_version}/sc/apply_changes

URL par défaut : /api/sn_cicd/sc/apply_changes

Remarque :

Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

Paramètres de demande pris en charge

Tableau 97. Paramètres de chemin d'accès

Nom	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Par 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 98. Paramètres de requête

Nom	Description
auto_upgrade_base_app	Applicable uniquement lorsque les changements sont appliqués à la personnalisation de l’application et que la dernière validation sur le référentiel Git repose sur une version ultérieure à celle de l’application de base actuellement installée sur l’instance locale. Marqueur indiquant si le système doit mettre à niveau automatiquement l’application de base vers une version ultérieure. Type de données : booléennes Par défaut : true
branch_name	Nom de la branche dans le système de contrôle de source à partir de laquelle acquérir l’application. Type de données : chaîne Par défaut : branche par défaut spécifiée sur le système de contrôle de source.
périmètre	Requis si sys_id n’est pas spécifié. Nom du périmètre de l’application auquel appliquer les changements, par exemple x_aah_custom_app. Vous pouvez localiser cette valeur dans le champ de la scope table Application personnalisée [sys_app] ou de la table Application du magasin [sys_store_app] pour la personnalisation de l’application. Type de données : chaîne
sys_id	Requis si scope n’est pas spécifié. Le sys_id de l’application auquel appliquer les changements. Vous pouvez localiser cette valeur dans le champ de la Sys ID table Application personnalisée [sys_app] ou de la table Application du magasin [sys_store_app] pour la personnalisation de l’application. Type de données : chaîne

Tableau 99. Paramètres de corps de demande (XML ou JSON)

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

Tableau 100. 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 101. 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 la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

Tableau 102. Codes d'état

Code d'état	Description
200	Réussi. La demande a été correctement traitée.
401	Les informations d’identification de l’utilisateur sont incorrectes.
403	Interdit. L’utilisateur n’est pas un administrateur ou n’a pas le rôle sn_cicd.sys_ci_automation.
404	Introuvable. L’élément demandé est introuvable.
405	Méthode non valide. La fonctionnalité est inactive.
409	Conflit. L’élément demandé n’est pas unique.
500	Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande.

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

Nom	Description
erreur	Message d’erreur avec détails sur l’erreur. Type de données : chaîne
Liens	Informations sur les liens et les sys_ids associés à l’ensemble de mises à jour. Type de données : objet "links": { "progress": {Object} }
Liens.Progression	Informations sur la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : objet "progress": { "id": "String", "url": "String" }
links.progress.id	Sys_id contenant les détails de progression de l’opération. Vous pouvez utiliser cette valeur lors de l’appel du point CI/CD : OBTENIR /sn_cicd/progression/{progress_id}de terminaison . Type de données : chaîne
liens.progression.url	URL à utiliser pour récupérer les détails de la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : chaîne
percent_complete	Pourcentage de la demande terminée. Type de données : nombre
status	Numéro représentant l’état d’exécution de l’action exécutée sur l’ensemble de mises à jour. Correspond au status_label descripteur. Valeurs possibles : 0 : en attente 1 : En cours d’exécution 2 : Réussi 3 : Échec 4 : Annulé Type de données : chaîne
status_detail	Message détaillé sur l’état d’exécution, le cas échéant. Correspond au champ detailed_message de la table Suivi de l’exécution [sys_execution_tracker]. Type de données : chaîne
status_label	État d’exécution de l’action de l’ensemble de mises à jour. Correspond au status nombre. Valeurs possibles : Annulé Échoué En attente En cours d'exécution Réussi Type de données : chaîne
status_message	Informations supplémentaires sur le motif d’échec de l’opération. Renvoie une chaîne vide si l’opération réussit. Type de données : chaîne

Demande cURL

curl 'https://instance.servicenow.com/api/sn_cicd/sc/apply_changes?app_sys_id=043db024db737300a9a754e4dc961915' \
--request POST \
--header 'Accept: application/json' \
--user 'username':'password'

{
"result": {
   "links": {
       "progress": {
           "id": "a4fae8911bdc00103d374087bc4bcbbd",
           "url": "https://instance.service-now/api/sn_cicd/progress/a4fae8911bdc00103d374087bc4bcbbd"
        }
    },
    "status": "0",
    "status_label": "Pending",
    "status_message": "",
    "status_detail": "",
    "error": "",
    "percent_complete": 0
  }
}

CI/CD : POST /sn_cicd/SC/apply_stash/{stash_id}

Commence à appliquer une « dissimulation » de changements précédemment générée à partir d’un contrôle de source distant à une application locale spécifiée ou à une application-personnalisation spécifiée.

Ce point de terminaison fonctionne conjointement avec POST/api/sn_cicd/sc/apply_changes et CI/CD : OBTENIR /sn_cicd/progression/{progress_id} les points de terminaison. Lorsque le point de terminaison POST /api/sn_cicd/sc/apply_changes est appelé, toutes les modifications non enregistrées ou non validées sur App Engine Studio l’instance associée sont enregistrées dans la base de données en tant que dissimulation.

Pour déterminer si une dissimulation a été créée lors de l’application initiale des changements, il faut appeler le point de terminaison GET /sn_cicd/progress/{progress_id} . Si une dissimulation a été créée, le sys_id (stash_id) et l’URL de la dissimulation sont renvoyés. Pour appliquer les changements dissimulés à l’application associée, appelez ce point de terminaison apply_stash à l’aide du point de stash_id terminaison de progression .

Format d'URL

URL versionnée : /api/sn_cicd/{api_version}/sc/apply_stash/{stash_id}

URL par défaut : /api/sn_cicd/sc/apply_stash/{stash_id}

Remarque :

Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

Paramètres de demande pris en charge

Tableau 103. Paramètres de chemin d'accès

Nom	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Par 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
stash_id	Identificateur unique de la dissimulation à appliquer. Cette valeur est renvoyée dans le links.stash.id paramètre de l’appel de point de terminaison correspondant CI/CD : OBTENIR /sn_cicd/progression/{progress_id} . Type de données : chaîne

Tableau 104. Paramètres de requête

Nom	Description
Néant

Tableau 105. Paramètres de corps de demande (XML ou JSON)

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

Tableau 106. 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
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 107. 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 la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

Tableau 108. Codes d'état

Code d'état	Description
200	Réussi. La demande a été correctement traitée.
401	Les informations d’identification de l’utilisateur sont incorrectes.
403	Interdit. L’utilisateur n’est pas un administrateur ou n’a pas le rôle sn_cicd.sys_ci_automation.
404	Introuvable. L’élément demandé est introuvable.
405	Méthode non valide. La fonctionnalité est inactive.
409	Conflit. L’élément demandé n’est pas unique.
500	Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande.

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

Nom	Description
erreur	Message d’erreur avec détails sur l’erreur. Type de données : chaîne
Liens	Informations sur les liens et les sys_ids associés à l’ensemble de mises à jour. Type de données : objet "links": { "progress": {Object} }
Liens.Progression	Informations sur la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : objet "progress": { "id": "String", "url": "String" }
links.progress.id	Sys_id contenant les détails de progression de l’opération. Vous pouvez utiliser cette valeur lors de l’appel du point CI/CD : OBTENIR /sn_cicd/progression/{progress_id}de terminaison . Type de données : chaîne
liens.progression.url	URL à utiliser pour récupérer les détails de la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : chaîne
percent_complete	Pourcentage de la demande terminée. Type de données : nombre
status	Numéro représentant l’état d’exécution de l’action exécutée sur l’ensemble de mises à jour. Correspond au status_label descripteur. Valeurs possibles : 0 : en attente 1 : En cours d’exécution 2 : Réussi 3 : Échec 4 : Annulé Type de données : chaîne
status_detail	Message détaillé sur l’état d’exécution, le cas échéant. Correspond au champ detailed_message de la table Suivi de l’exécution [sys_execution_tracker]. Type de données : chaîne
status_label	État d’exécution de l’action de l’ensemble de mises à jour. Correspond au status nombre. Valeurs possibles : Annulé Échoué En attente En cours d'exécution Réussi Type de données : chaîne
status_message	Description supplémentaire de l’état actuel de l’action, si disponible. Type de données : chaîne

Demande cURL

L’exemple de code suivant montre comment appeler le point de terminaison apply_stash pour stash_id fc2224e4e0429110f8771827f8fd3634.

curl "https://instance.servicenow.com/api/sn_cicd/sc/apply_stash/fc2224e4e0429110f8771827f8fd3634"\
--request POST \
--header "Accept:application/json" \
--header "Content_Type:application/json" \
--user 'username':'password'

La dissimulation est en attente, donc pas encore appliquée.

{
  "result": {
    "links": {
      "progress": {
        "id": "6b04ec28e0429110f8771827f8fd36a4",
        "url": "https://instance.servicenow.com/api/sn_cicd/progress/6b04ec28e0429110f8771827f8fd36a4"
      }
    },
    "status": "0",
    "status_label": "Pending",
    "status_message": "",
    "status_detail": "",
    "error": "",
    "percent_complete": 0
  }
}

CI/CD : POST /sn_cicd/SC/IMPORT

Importe une application à l’aide de l’URL du référentiel et du nom de branche spécifiés.

Utilisez ce point de terminaison pour importer une application à partir du contrôle de source dans l’instance appelante afin de pouvoir ensuite utiliser Intégration et offre en continu (CICD) des points de terminaison, tels que /sn_cicd/sc/apply_changes, pour déployer l’application dans des environnements supérieurs.

Remarque :

Avant d’utiliser ce point de terminaison, un référentiel Git configuré par une autre instance à l’aide de Link to source control doit être disponible.

Format d'URL

URL versionnée : /api/sn_cicd/{api_version}/sc/import

URL par défaut : /api/sn_cicd/sc/import

Remarque :

Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

Paramètres de demande pris en charge

Tableau 109. Paramètres de chemin d'accès

Nom	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Par 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 110. Paramètres de requête

Nom	Description
auto_upgrade_base_app	S’applique uniquement lorsque l’application importée est une personnalisation d’application et que la dernière validation sur le référentiel Git repose sur une version ultérieure à celle de l’application de base actuellement installée sur l’instance locale. Marqueur indiquant si le système doit mettre à niveau automatiquement l’application de base vers une version ultérieure. Valeurs valides : vrai : mise à niveau automatique de l’application de base. faux : ne mettez pas à niveau automatiquement l’application de base. Type de données : booléennes Valeur par défaut : vrai
branch_name	Requis. Nom de la branche dans le système de contrôle de source à partir de laquelle importer l’application. Type de données : chaîne
credential_sys_id	Sys_id des informations d’identification ayant accès au référentiel Git. Type de données : chaîne Par défaut : Sys_id défini dans les propriétés système glide.source_control.default_basic_auth_credential_sys_id ou glide.source_control.default_ssh_private_key_credential_sys_id, selon que le repo_url paramètre est un référentiel https ou ssh. Par défaut, cette propriété est vide.
mid_server_sys_id	Sys_id du Serveur MID à utiliser pour les opérations de contrôle de source pour cette application. Type de données : chaîne Valeur par défaut : chaîne vide/NULL
repo_url	Requis. URL du référentiel Git à partir duquel importer l’application. Type de données : chaîne

Tableau 111. Paramètres de corps de demande (XML ou JSON)

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

Tableau 112. 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 113. 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 la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

Tableau 114. Codes d'état

Code d'état	Description
200	Réussi. La demande a été correctement traitée.
401	Les informations d’identification de l’utilisateur sont incorrectes.
403	Interdit. L’utilisateur n’est pas un administrateur ou n’a pas le rôle sn_cicd.sys_ci_automation.
404	Introuvable. L’élément demandé est introuvable.
405	Méthode non valide. La fonctionnalité est inactive.
409	Conflit. L’élément demandé n’est pas unique.
500	Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande.

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

Nom	Description
erreur	Message d’erreur avec détails sur l’erreur. Type de données : chaîne
Liens	Informations sur les liens et les sys_ids associés à l’ensemble de mises à jour. Type de données : objet "links": { "progress": {Object} }
Liens.Progression	Informations sur la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : objet "progress": { "id": "String", "url": "String" }
links.progress.id	Sys_id contenant les détails de progression de l’opération. Vous pouvez utiliser cette valeur lors de l’appel du point CI/CD : OBTENIR /sn_cicd/progression/{progress_id}de terminaison . Type de données : chaîne
liens.progression.url	URL à utiliser pour récupérer les détails de la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : chaîne
percent_complete	Pourcentage de la demande terminée. Type de données : nombre
status	Numéro représentant l’état d’exécution de l’action exécutée sur l’ensemble de mises à jour. Correspond au status_label descripteur. Valeurs possibles : 0 : en attente 1 : En cours d’exécution 2 : Réussi 3 : Échec 4 : Annulé Type de données : chaîne
status_detail	Message détaillé sur l’état d’exécution, le cas échéant. Correspond au champ detailed_message de la table Suivi de l’exécution [sys_execution_tracker]. Type de données : chaîne
status_label	État d’exécution de l’action de l’ensemble de mises à jour. Correspond au status nombre. Valeurs possibles : Annulé Échoué En attente En cours d'exécution Réussi Type de données : chaîne
status_message	Description supplémentaire de l’état actuel de l’action, si disponible. Type de données : chaîne

Demande cURL

L’exemple suivant montre comment importer l’application située à https://code.devsnc.com/some-user/ncRegrApp1.git dans le main_branch.

curl "https://instance.servicenow.com/api/sn_cicd/sc/import?repo_url=https%3A%2F%2Fcode.devsnc.com%2Fsome-user%2FncRegrApp1.git&branch_name=main_branch&credential_sys_id=af9b6d6180feb010f8779c30d4dd6b6b" \
--request POST \
--header "Accept:application/json" \
--user 'admin':'admin'

Renvoie la progression de l’importation.

{
  "result": {
    "links": {
      "progress": {
        "id": "a18c06ea64f23010f87769cd983d4574",
        "url": "https://instance.servicenow.com/api/sn_cicd/progress/a18c06ea64f23010f87769cd983d4574"
      }
    },
    "status": "0",
    "status_label": "Pending",
    "status_message": "",
    "status_detail": "",
    "error": "",
    "percent_complete": 0
  }
}

CI/CD : POST/sn_cicd/SuiteDeTest/Exécuter

Démarre une suite de tests automatisée spécifiée. La suite de tests s’exécute sur l’instance à partir de laquelle le point de terminaison a été appelé.

Remarque :

Si la suite que vous exécutez contient des tests d’interface utilisateur, vous devez avoir un exécuteur de test client planifié ouvert ou être en mesure de configurer l’exécution de l’exécuteur de test sans tête. Pour en savoir plus, consultez Navigateur sans en-tête pour Framework de tests automatisés.

Format d'URL

URL versionnée : /api/sn_cicd/{api_version}/testsuite/run

URL par défaut : /api/sn_cicd/testsuite/run

Remarque :

Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

Paramètres de demande pris en charge

Tableau 115. Paramètres de chemin d'accès

Nom	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Par 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 116. Paramètres de requête

Nom	Description
browser_name	Nom du navigateur à utiliser pour exécuter le test client. Cette valeur doit correspondre à ce qui est spécifié dans l’exécuteur de test du client planifié. Pour plus d’informations sur les tests exécutables de clients planifiés, consultez Tests exécutables de clients planifiés. Type de données : chaîne Valeurs valides : (doit être en minuscules) N'importe lequel chrome Firefox bordure Ie safari Par défaut : n’importe lequel
browser_version	Valeur de départ de la version du navigateur spécifiée dans browser_name à utiliser pour exécuter le test. Par exemple, si vous entrez « 9 », toutes les versions 9.x.x.x sont activées. Cette valeur doit correspondre à ce qui est spécifié dans l’exécuteur de test du client planifié. Type de données : chaîne
is_performance_run	Facultatif. Marqueur indiquant s’il faut exécuter la suite de tests en tant que test de performance (exécution de performance). Valeurs valides : vrai : exécute la suite de tests comme un test de performance. false : exécute la suite de tests avec le comportement par défaut d’un test standard et fonctionnel de l’instance. Valeur par défaut : false
os_name	Nom du système d’exploitation sous lequel exécuter la suite de tests. Cette valeur doit correspondre à ce qui est spécifié dans l’exécuteur de test du client planifié. Type de données : chaîne
os_version	Valeur de départ de la version du système d’exploitation sous laquelle exécuter la suite de tests. Par exemple, si vous entrez « 8 », toutes les versions 8.x.x.x sont activées. Cette valeur doit correspondre à ce qui est spécifié dans l’exécuteur de test du client planifié. Type de données : chaîne
run_in_cloud	Facultatif. Marqueur indiquant s’il faut exécuter la suite de tests dans l’exécuteur dans le cloud ou manuellement. Valeurs valides : true : exécute la suite de tests à l’aide de l’exécuteur dans le cloud. false : exécute la suite de tests à l’aide du test exécutable manuel. Valeur par défaut : false
test_suite_sys_id	Requis si test_suite_name n’est pas spécifié. La sys_id de la suite de tests à exécuter. Type de données : chaîne Table : Test [sys_atf_test_suite]
test_suite_name	Requis si test_suite_sys_id n’est pas spécifié. Nom de la suite de tests à exécuter. Type de données : chaîne Tableau :Test [sys_atf_test_suite]

Tableau 117. Paramètres de corps de demande (XML ou JSON)

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

Tableau 118. 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 119. 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 la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

Tableau 120. Codes d'état

Code d'état	Description
200	Réussi. La demande a été correctement traitée.
401	Les informations d’identification de l’utilisateur sont incorrectes.
403	Interdit. L’utilisateur n’est pas un administrateur ou n’a pas le rôle sn_cicd.sys_ci_automation.
404	Introuvable. L’élément demandé est introuvable.
405	Méthode non valide. La fonctionnalité est inactive.
409	Conflit. L’élément demandé n’est pas unique.
500	Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande.

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

Nom	Description
erreur	Message d’erreur avec détails sur l’erreur. Type de données : chaîne
Liens	Informations sur les liens et les sys_ids associés à l’ensemble de mises à jour. Type de données : objet "links": { "progress": {Object} }
Liens.Progression	Informations sur la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : objet "progress": { "id": "String", "url": "String" }
links.progress.id	Sys_id contenant les détails de progression de l’opération. Vous pouvez utiliser cette valeur lors de l’appel du point CI/CD : OBTENIR /sn_cicd/progression/{progress_id}de terminaison . Type de données : chaîne
liens.progression.url	URL à utiliser pour récupérer les détails de la progression de l’opération exécutée sur l’ensemble de mises à jour. Type de données : chaîne
liens.résultats	ID et URL des résultats de l’exécution. Type de données : objet "results": { "id": "String", "url": "String" }
links.results.id	Sys_id des informations sur les résultats. Utilisez cette valeur pour l’appel du point de terminaison des résultats associé. Type de données : chaîne
liens.resultats.url	URL à utiliser pour obtenir les résultats de l’exécution du point de terminaison. Type de données : chaîne
percent_complete	Pourcentage de la demande terminée. Type de données : nombre
status	Numéro représentant l’état d’exécution de l’action exécutée sur l’ensemble de mises à jour. Correspond au status_label descripteur. Valeurs possibles : 0 : en attente 1 : En cours d’exécution 2 : Réussi 3 : Échec 4 : Annulé Type de données : chaîne
status_detail	Message détaillé sur l’état d’exécution, le cas échéant. Correspond au champ detailed_message de la table Suivi de l’exécution [sys_execution_tracker]. Type de données : chaîne
status_label	État d’exécution de l’action de l’ensemble de mises à jour. Correspond au status nombre. Valeurs possibles : Annulé Échoué En attente En cours d'exécution Réussi Type de données : chaîne
status_message	Description supplémentaire de l’état actuel de l’action, si disponible. Type de données : chaîne

Demande cURL

curl 'https://instance.servicenow.com/api/sn_cicd/testsuite/run?test_suite_sys_id=632e43900b20220050192f15d6673a7e' \
--request POST \
--header 'Accept: application/json' \
--user 'username':'password'

{
"result": {
   "links": {
       "progress": {
           "id": "0578a8d91bdc00103d374087bc4bcbcc",
           "url": "https://instance.service-now.com/api/sn_cicd/progress/0578a8d91bdc00103d374087bc4bcbcc"
        }
   },
   "status": "0",
   "status_label": "Pending",
   "status_message": "",
   "status_detail": "",
   "error": "",
   "percent_complete": 0
  }
}

Réponse à l’échec :

{
"result": {
    "status": "3",
    "status_label": "Failed",
    "status_message": "",
    "status_detail": "",
    "error": "Scheduled test/suite execution is disabled. Change the value of property 'sn_atf.schedule.enabled' to true to enable it"
  }
}