CdmSnapshotApi

CdmSnapshotApi fournit des points de terminaison qui vous permettent de publier, d’annuler la publication et de valider à nouveau les instantanés dans Configuration Data Management (CDM).

Vous publiez un instantané afin qu’il puisse être exporté, ce qui permet Intégration et offre en continu (CICD) au pipeline d’accéder aux données de configuration associées et de les utiliser. Les exportateurs ne peuvent exécuter que sur les instantanés publiés. Lorsque les instantanés ne sont plus nécessaires, vous pouvez annuler leur publication afin de réduire la confusion quant à la viabilité de l’instantané.

Vous devez avoir l’un des rôles suivants pour accéder à cette API :

• Scripted REST CDM View ACL (sn_cdm.cdm.viewer)
• ACL de l’éditeur CDM REST scripté (sn_cdm.cdm_editor)

En outre, le module d’extension Configuration Data Management (CDM) doit être activé pour que cette API soit disponible dans une instance.

Pour plus d’informations sur les instantanés, consultez Afficher les instantanés.

CdmSnapshotAPI - POST /sn_cdm/snapshots/{snapshot_id}/publish

Publie un instantané spécifié non publié.

Pour pouvoir publier un instantané, il doit être validé. Vous pouvez utiliser le CdmSnapshotAPI - POST /sn_cdm/snapshots/{snapshot_id}/validate point de terminaison pour valider les instantanés ou les faire valider automatiquement lorsque vous effectuez une validation. Un élément déployable doit être connecté à un service pour publier ses instantanés. En outre, si l’instantané a déjà été publié, la demande échouera.

Format d'URL

URL versionnée : /api/sn_cdm/{api_version}/snapshots/{snapshot_id}/publish

URL par défaut : /api/sn_cdm/snapshots/{snapshot_id}/publish

Paramètres de demande pris en charge

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

Nom	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Exemple : v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne
snapshot_id	Sys_id de l’enregistrement d’instantané à traiter. Situé dans la table Instantané CDM [sn_cdm_snapshot]. 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 une liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

Tableau 4. En-têtes de demandes

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

Tableau 5. En-têtes de réponses

En-tête	Description
Aucun

Codes d'état

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

Tableau 6. Codes d'état

Code d'état	Description
200	Réussi. La demande a été correctement traitée.
400	Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté.
500	Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur.

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

Nom	Description
erreur	Si une erreur s’est produite pendant le traitement, les détails sur l’erreur. Type de données : objet "error": { "detail": "String", "message": "String" }
erreur.détail	Informations supplémentaires sur l’erreur. Type de données : chaîne
message d’erreur	Message d’erreur généré lors de l’essai de traitement de la demande. Type de données : chaîne
statut	État de l’erreur de la demande. Valeurs possibles : échec Type de données : chaîne

Demande cURL

L’exemple suivant montre comment publier l’instantané avec le sys_id 3a168d9dc342301054c1582e1340dd68.

curl "http://instance.servicenow.com/api/sn_cdm/snapshots/3a168d9dc342301054c1582e1340dd68/publish"\ 
--request POST \ 
--header "Accept:application/json" \ 
--header "Content-Type:application/json" \
--user 'username':'password' 

La réponse de réussite et d’échec de la demande de publication est présentée ci-dessous.

// Example of a successful response
{ 
  "" 
}

// Example of an error response
{
  "error": {
    "message": "Error: Unexpected error occurred in publish request.Error:Snapshot not found",
    "detail": ""
  },
  "status": "failure"
}

CdmSnapshotAPI - PUBLIER /sn_cdm/snapshots/{snapshot_id}/annuler la publication

Annule la publication d’un instantané précédemment publié.

Format d'URL

URL versionnée : /api/sn_cdm/{api_version}/snapshots/{snapshot_id}/unpublish

URL par défaut : /api/sn_cdm/snapshots/{snapshot_id}/unpublish

Paramètres de demande pris en charge

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

Nom	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Exemple : v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne
snapshot_id	Sys_id de l’enregistrement d’instantané à traiter. Situé dans la table Instantané CDM [sn_cdm_snapshot]. Type de données : chaîne

Tableau 8. Paramètres de requête

Nom	Description
Néant

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

Tableau 10. En-têtes de demandes

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

Tableau 11. En-têtes de réponses

En-tête	Description
Aucun

Codes d'état

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

Tableau 12. Codes d'état

Code d'état	Description
200	Réussi. La demande a été correctement traitée.
400	Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté.
500	Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur.

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

Nom	Description
erreur	Si une erreur s’est produite pendant le traitement, les détails sur l’erreur. Type de données : objet "error": { "detail": "String", "message": "String" }
erreur.détail	Informations supplémentaires sur l’erreur. Type de données : chaîne
message d’erreur	Message d’erreur généré lors de l’essai de traitement de la demande. Type de données : chaîne
statut	État de l’erreur de la demande. Valeurs possibles : échec Type de données : chaîne

Demande cURL

L’exemple suivant montre comment annuler la publication de l’instantané avec le sys_id 3a168d9dc342301054c1582e1340dd68.

curl "http://instance.servicenow.com/api/sn_cdm/snapshots/3a168d9dc342301054c1582e1340dd68/unpublish"\ 
--request POST \ 
--header "Accept:application/json" \ 
--header "Content-Type:application/json" \
--user 'username':'password' 

L’élément suivant présente une réponse de réussite et d’échec de la demande d’annulation de la publication.

// Example of a successful response
{ 
  "" 
}

// Example of an error response
{
  "error": {
    "message": "Error: Unexpected error occurred in publish request.Error:Snapshot not found",
    "detail": ""
  },
  "status": "failure"
}

CdmSnapshotAPI - POST /sn_cdm/snapshots/{snapshot_id}/validate

Valide un instantané spécifié non publié.

La validation est effectuée en tant que processus asynchrone. L’appel de ce point de terminaison démarre uniquement le processus de validation. Les résultats renvoyés de cet appel indiquent uniquement si le processus de validation a démarré, et non les résultats de la validation proprement dite. Pour savoir si l’instantané a été validé, utilisez l’API Table pour localiser l’instantané et vérifier son état de validation.

Remarque :

Vous ne pouvez pas valider un instantané publié.

Format d'URL

URL versionnée : /api/sn_cdm/{api_version}/snapshots/{snapshot_id}/validate

URL par défaut : /api/sn_cdm/snapshots/{snapshot_id}/validate

Paramètres de demande pris en charge

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

Nom	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Exemple : v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne
snapshot_id	Sys_id de l’enregistrement d’instantané à traiter. Situé dans la table Instantané CDM [sn_cdm_snapshot]. 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 une liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

Tableau 16. En-têtes de demandes

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

Tableau 17. En-têtes de réponses

En-tête	Description
Aucun

Codes d'état

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

Tableau 18. Codes d'état

Code d'état	Description
200	Réussi. La demande a été correctement traitée.
400	Demande incorrecte. L’instantané spécifié est déjà publié ou ne peut pas être localisé.
500	Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur.

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

Nom	Description
erreur	Si une erreur s’est produite pendant le traitement, les détails sur l’erreur. Type de données : objet "error": { "detail": "String", "message": "String" }
erreur.détail	Informations supplémentaires sur l’erreur. Type de données : chaîne
message d’erreur	Message d’erreur généré lors de l’essai de traitement de la demande. Type de données : chaîne
statut	État de l’erreur de la demande. Valeurs possibles : échec Type de données : chaîne

Demande cURL

L’exemple suivant montre comment valider l’instantané avec le sys_id de 3a168d9dc342301054c1582e1340dd68.

curl "http://instance.servicenow.com/api/sn_cdm/snapshots/3a168d9dc342301054c1582e1340dd68/validate"\ 
--request POST \ 
--header "Accept:application/json" \ 
--header "Content-Type:application/json" \
--user 'username':'password' 

L’élément suivant présente à la fois une réponse de réussite et une réponse d’échec à la demande de validation.

// Example of a successful response
{ 
  "" 
}

// Example of an error response
{
  "error": {
    "message": "Invalid Snapshot id:test",
    "detail": ""
  },
  "status": "failure"
}

CdmSnapshotApi - PUT /sn_cdm/snapshots/publish

Publie un instantané spécifié non publié.

Pour pouvoir publier un instantané, il doit être validé. Vous pouvez utiliser le CdmSnapshotApi - PUT /sn_cdm/snapshots/validate point de terminaison pour valider les instantanés ou les faire valider automatiquement lorsque vous effectuez une validation. Un élément déployable doit être connecté à un service pour publier ses instantanés. En outre, si l’instantané a déjà été publié, la demande échouera.

L’appelant de ce point de terminaison doit avoir le rôle d’éditeur CDM.

Format d'URL

URL versionnée : /api/sn_cdm/{api_version}/snapshots/publish

URL par défaut : /api/sn_cdm/snapshots/publish

Paramètres de demande pris en charge

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

Nom	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Exemple : v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne

Tableau 20. Paramètres de requête

Nom	Description
appName	Requis. Nom de l’application Configuration Data Management (CDM) pour laquelle créer l’instantané. Situé dans la table Application CDM [sn_cdm_application]. Type de données : chaîne
deployableName	Requis. Nom de l’élément déployable CDM pour lequel créer l’instantané. Situé dans la table Déployable CDM [sn_cdm_deployable]. Type de données : chaîne
nom	Requis. Nom de l'instantané. Situé dans la table Instantané CDM [sn_cdm_snapshot]. Type de données : chaîne
returnFields	Liste des champs à renvoyer dans le cadre de la réponse. Transmettez les noms des colonnes d’enregistrement tels que sys_id, sys_updated_by ou État. Type de données : tableau Par défaut : tous les champs tels que déterminés par le point de terminaison

Tableau 21. Paramètres de corps de demande

Nom	Description
Néant

En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir une liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

Tableau 22. En-têtes de demandes

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

Tableau 23. En-têtes de réponses

En-tête	Description
Aucun

Codes d'état

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

Tableau 24. Codes d'état

Code d'état	Description
200	Réussi. La demande a été correctement traitée.
400	Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté.
500	Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur.

Paramètres du corps de réponse

Nom	Description
cdm_application_id	Détails sur l’application CDM associée à l’instantané. Type de données : objet "cdm_application_id": { "link": "String", "value": "String" }
cdm_application_id.link	Appel à utiliser pour accéder à l’enregistrement de l’application CDM à l’aide de l’API de table REST. Type de données : chaîne
cdm_application_id.value	Sys_id de l’enregistrement de l’application CDM associée. Situé dans la table Application CDM [sn_cdm_application]. Type de données : chaîne
cdm_deployable_id	Détails sur le déployable CDM associé à l’instantané. Type de données : objet "cdm_deployable_id": { "link": "String", "value": "String" }
cdm_deployable_id.link	Syntaxe d’appel pour interroger cet enregistrement déployable à l’aide de l’API REST de table . Type de données : chaîne
cdm_deployable_id.value	Sys_id de l’enregistrement de l’élément déployable. Situé dans la table Déployable CDM [sn_cdm_deployable]. Type de données : chaîne
changeset_id	Détails sur l’ensemble de changements associé à l’instantané. Type de données : objet "changeset_id": { "link": "String", "value": "String" }
changeset_id.link	Syntaxe d’appel pour interroger cet enregistrement d’ensemble de changements à l’aide de l’API REST de table . Type de données : chaîne
changeset_id.value	Identificateur unique de l’enregistrement de l’ensemble de changements. Situé dans la table Ensemble de changements CDM [sn_cdm_changeset]. Type de données : chaîne
description	Brève description de l’instantané. Type de données : chaîne
erreur	Si une erreur s’est produite pendant le traitement, les détails sur l’erreur. Type de données : objet "error": { "detail": "String", "message": "String" }
erreur.détail	Informations supplémentaires sur l’erreur. Type de données : chaîne
message d’erreur	Message d’erreur généré lors de l’essai de traitement de la demande. Type de données : chaîne
last_published	Date et heure de dernière publication de l’instantané. Type de données : chaîne Format : aaaa-mm-jj hh :mm :ss
last_validated	Date et heure auxquelles l’instantané a été validé pour la dernière fois. Type de données : chaîne Format : aaaa-mm-jj hh :mm :ss
nom	Nom de l'instantané. Type de données : chaîne
Numéro	Numéro unique qui identifie l’instantané. Cette valeur fournit un identificateur explicite pour le mappage. Type de données : chaîne
publié	Marqueur indiquant si l’instantané a été publié. Valeurs possibles : true : l’instantané a été publié. false : l’instantané n’a pas été publié. Type de données : booléennes
sys_created_by	Nom de l’utilisateur qui a créé l’instantané. Type de données : chaîne
sys_created_on	Date et heure de création de l’instantané. Type de données : chaîne Format : aaaa-mm-jj hh :mm :ss
sys_id	Sys_id de l’instantané. Situé dans la table Instantané CDM [sn_cdm_snapshot]. Type de données : chaîne
sys_updated_by	Nom de l’utilisateur qui a mis à jour l’instantané. Type de données : chaîne
sys_updated_on	Date et heure auxquelles l’instantané a été mis à jour pour la dernière fois. Type de données : chaîne Format : aaaa-mm-jj hh :mm :ss
validation	État de validation actuel de l’instantané. Valeurs possibles : execution_error Échoué in_progress not_validated Passé passed_with_exception Demandé Type de données : chaîne

Demande cURL

Cet exemple de code montre comment publier un instantané.

curl "http://instance.servicenow.com/api/sn_cdm/snapshots/publish?deployableName=Development_1&name=Development_1-v1.dpl&appName=testApp" \ 
--request PUT \ 
--header "Accept:application/json" \ 
--user 'username':'password'

Résultats renvoyés :

 
{ 
  "result": { 
    "changeset_id": { 
      "value": "d4b9446e53001110a1d3ddeeff7b126c", 
      "link": "http://instance.servicenow.com/api/now/table/sn_cdm_changeset/d4b9446e53001110a1d3ddeeff7b126c" 
    }, 
    "cdm_deployable_id": { 
      "value": "6dc517a953b70110a1d3ddeeff7b129b", 
      "link": "http://instance.servicenow.com/api/now/table/sn_cdm_deployable/6dc517a953b70110a1d3ddeeff7b129b" 
    }, 
    "description": null, 
    "cdm_application_id": { 
      "value": "62b517a953b70110a1d3ddeeff7b128c", 
      "link": "http://instance.servicenow.com/api/now/table/sn_cdm_application/62b517a953b70110a1d3ddeeff7b128c" 
    }, 
    "published": true, 
    "sys_updated_on": "2022-06-30 12:57:02", 
    "last_published": "2022-06-30 12:57:02", 
    "number": "SNAP0001002", 
    "sys_id": "9017fc2e53801110a1d3ddeeff7b12d7", 
    "sys_updated_by": "admin", 
    "sys_created_on": "2022-06-15 14:19:38", 
    "name": "Development_1-v2.dpl", 
    "last_validated": "2022-06-30 12:56:07", 
    "validation": "passed", 
    "sys_created_by": "admin" 
  } 
}

CdmSnapshotApi - PUT /sn_cdm/snapshots/unpublish

Annule la publication d’un instantané précédemment publié.

Format d'URL

URL versionnée : /api/sn_cdm/{api_version}/snapshots/unpublish

URL par défaut : /api/sn_cdm/snapshots/unpublish

Paramètres de demande pris en charge

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

Nom	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Exemple : v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne

Tableau 26. Paramètres de requête

Nom	Description
appName	Requis. Nom de l’application Configuration Data Management (CDM) pour laquelle créer l’instantané. Situé dans la table Application CDM [sn_cdm_application]. Type de données : chaîne
deployableName	Requis. Nom de l’élément déployable CDM pour lequel créer l’instantané. Situé dans la table Déployable CDM [sn_cdm_deployable]. Type de données : chaîne
nom	Requis. Nom de l'instantané. Situé dans la table Instantané CDM [sn_cdm_snapshot]. Type de données : chaîne
returnFields	Liste des champs à renvoyer dans le cadre de la réponse. Transmettez les noms des colonnes d’enregistrement tels que sys_id, sys_updated_by ou État. Type de données : tableau Par défaut : tous les champs tels que déterminés par le point de terminaison

Tableau 27. Paramètres de corps de demande

Nom	Description
Néant

En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir une liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

Tableau 28. En-têtes de demandes

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

Tableau 29. En-têtes de réponses

En-tête	Description
Aucun

Codes d'état

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

Tableau 30. Codes d'état

Code d'état	Description
200	Réussi. La demande a été correctement traitée.
400	Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté.
500	Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur.

Paramètres du corps de réponse

Nom	Description
cdm_application_id	Détails sur l’application CDM associée à l’instantané. Type de données : objet "cdm_application_id": { "link": "String", "value": "String" }
cdm_application_id.link	Appel à utiliser pour accéder à l’enregistrement de l’application CDM à l’aide de l’API de table REST. Type de données : chaîne
cdm_application_id.value	Sys_id de l’enregistrement de l’application CDM associée. Situé dans la table Application CDM [sn_cdm_application]. Type de données : chaîne
cdm_deployable_id	Détails sur le déployable CDM associé à l’instantané. Type de données : objet "cdm_deployable_id": { "link": "String", "value": "String" }
cdm_deployable_id.link	Syntaxe d’appel pour interroger cet enregistrement déployable à l’aide de l’API REST de table . Type de données : chaîne
cdm_deployable_id.value	Sys_id de l’enregistrement de l’élément déployable. Situé dans la table Déployable CDM [sn_cdm_deployable]. Type de données : chaîne
changeset_id	Détails sur l’ensemble de changements associé à l’instantané. Type de données : objet "changeset_id": { "link": "String", "value": "String" }
changeset_id.link	Syntaxe d’appel pour interroger cet enregistrement d’ensemble de changements à l’aide de l’API REST de table . Type de données : chaîne
changeset_id.value	Identificateur unique de l’enregistrement de l’ensemble de changements. Situé dans la table Ensemble de changements CDM [sn_cdm_changeset]. Type de données : chaîne
description	Brève description de l’instantané. Type de données : chaîne
erreur	Si une erreur s’est produite pendant le traitement, les détails sur l’erreur. Type de données : objet "error": { "detail": "String", "message": "String" }
erreur.détail	Informations supplémentaires sur l’erreur. Type de données : chaîne
message d’erreur	Message d’erreur généré lors de l’essai de traitement de la demande. Type de données : chaîne
last_published	Date et heure de dernière publication de l’instantané. Type de données : chaîne Format : aaaa-mm-jj hh :mm :ss
last_validated	Date et heure auxquelles l’instantané a été validé pour la dernière fois. Type de données : chaîne Format : aaaa-mm-jj hh :mm :ss
nom	Nom de l'instantané. Type de données : chaîne
Numéro	Numéro unique qui identifie l’instantané. Cette valeur fournit un identificateur explicite pour le mappage. Type de données : chaîne
publié	Marqueur indiquant si l’instantané a été publié. Valeurs possibles : true : l’instantané a été publié. false : l’instantané n’a pas été publié. Type de données : booléennes
sys_created_by	Nom de l’utilisateur qui a créé l’instantané. Type de données : chaîne
sys_created_on	Date et heure de création de l’instantané. Type de données : chaîne Format : aaaa-mm-jj hh :mm :ss
sys_id	Sys_id de l’instantané. Situé dans la table Instantané CDM [sn_cdm_snapshot]. Type de données : chaîne
sys_updated_by	Nom de l’utilisateur qui a mis à jour l’instantané. Type de données : chaîne
sys_updated_on	Date et heure auxquelles l’instantané a été mis à jour pour la dernière fois. Type de données : chaîne Format : aaaa-mm-jj hh :mm :ss
validation	État de validation actuel de l’instantané. Valeurs possibles : execution_error Échoué in_progress not_validated Passé passed_with_exception Demandé Type de données : chaîne

Demande cURL

Cet exemple de code montre comment annuler la publication d’un instantané.

Résultats renvoyés :

CdmSnapshotApi - PUT /sn_cdm/snapshots/validate

Valide un instantané non publié spécifié par rapport à ses politiques mappées.

La validation est effectuée en tant que processus asynchrone. L’appel de ce point de terminaison démarre uniquement le processus de validation. Les résultats renvoyés de cet appel indiquent uniquement si le processus de validation a démarré, et non les résultats de la validation proprement dite. Pour savoir si l’instantané a été validé, utilisez l’API Table pour localiser l’instantané et vérifier son état de validation.

Remarque :

Vous ne pouvez pas valider un instantané publié.

L’appelant de ce point de terminaison doit avoir le rôle d’éditeur CDM.

Format d'URL

URL versionnée : /api/sn_cdm/{api_version}/snapshots/validate

URL par défaut : /api/sn_cdm/snapshots/validate

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. 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 32. Paramètres de requête

Nom	Description
appName	Requis. Nom de l’application Configuration Data Management (CDM) pour laquelle créer l’instantané. Situé dans la table Application CDM [sn_cdm_application]. Type de données : chaîne
deployableName	Requis. Nom de l’élément déployable CDM pour lequel créer l’instantané. Situé dans la table Déployable CDM [sn_cdm_deployable]. Type de données : chaîne
nom	Requis. Nom de l'instantané. Situé dans la table Instantané CDM [sn_cdm_snapshot]. Type de données : chaîne
returnFields	Liste des champs à renvoyer dans le cadre de la réponse. Transmettez les noms des colonnes d’enregistrement tels que sys_id, sys_updated_by ou État. Type de données : tableau Par défaut : tous les champs tels que déterminés par le point de terminaison

Tableau 33. Paramètres de corps de demande

Nom	Description
Néant

En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir une liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

Tableau 34. En-têtes de demandes

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

Tableau 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 une 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.
400	Demande incorrecte. L’instantané spécifié est déjà publié ou ne peut pas être localisé.
500	Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur.

Paramètres du corps de réponse

Nom	Description
cdm_application_id	Détails sur l’application CDM associée à l’instantané. Type de données : objet "cdm_application_id": { "link": "String", "value": "String" }
cdm_application_id.link	Appel à utiliser pour accéder à l’enregistrement de l’application CDM à l’aide de l’API de table REST. Type de données : chaîne
cdm_application_id.value	Sys_id de l’enregistrement de l’application CDM associée. Situé dans la table Application CDM [sn_cdm_application]. Type de données : chaîne
cdm_deployable_id	Détails sur le déployable CDM associé à l’instantané. Type de données : objet "cdm_deployable_id": { "link": "String", "value": "String" }
cdm_deployable_id.link	Syntaxe d’appel pour interroger cet enregistrement déployable à l’aide de l’API REST de table . Type de données : chaîne
cdm_deployable_id.value	Sys_id de l’enregistrement de l’élément déployable. Situé dans la table Déployable CDM [sn_cdm_deployable]. Type de données : chaîne
changeset_id	Détails sur l’ensemble de changements associé à l’instantané. Type de données : objet "changeset_id": { "link": "String", "value": "String" }
changeset_id.link	Syntaxe d’appel pour interroger cet enregistrement d’ensemble de changements à l’aide de l’API REST de table . Type de données : chaîne
changeset_id.value	Identificateur unique de l’enregistrement de l’ensemble de changements. Situé dans la table Ensemble de changements CDM [sn_cdm_changeset]. Type de données : chaîne
description	Brève description de l’instantané. Type de données : chaîne
erreur	Si une erreur s’est produite pendant le traitement, les détails sur l’erreur. Type de données : objet "error": { "detail": "String", "message": "String" }
erreur.détail	Informations supplémentaires sur l’erreur. Type de données : chaîne
message d’erreur	Message d’erreur généré lors de l’essai de traitement de la demande. Type de données : chaîne
last_published	Date et heure de dernière publication de l’instantané. Type de données : chaîne Format : aaaa-mm-jj hh :mm :ss
last_validated	Date et heure auxquelles l’instantané a été validé pour la dernière fois. Type de données : chaîne Format : aaaa-mm-jj hh :mm :ss
nom	Nom de l'instantané. Type de données : chaîne
Numéro	Numéro unique qui identifie l’instantané. Cette valeur fournit un identificateur explicite pour le mappage. Type de données : chaîne
publié	Marqueur indiquant si l’instantané a été publié. Valeurs possibles : true : l’instantané a été publié. false : l’instantané n’a pas été publié. Type de données : booléennes
sys_created_by	Nom de l’utilisateur qui a créé l’instantané. Type de données : chaîne
sys_created_on	Date et heure de création de l’instantané. Type de données : chaîne Format : aaaa-mm-jj hh :mm :ss
sys_id	Sys_id de l’instantané. Situé dans la table Instantané CDM [sn_cdm_snapshot]. Type de données : chaîne
sys_updated_by	Nom de l’utilisateur qui a mis à jour l’instantané. Type de données : chaîne
sys_updated_on	Date et heure auxquelles l’instantané a été mis à jour pour la dernière fois. Type de données : chaîne Format : aaaa-mm-jj hh :mm :ss
validation	État de validation actuel de l’instantané. Valeurs possibles : execution_error Échoué in_progress not_validated Passé passed_with_exception Demandé Type de données : chaîne

Demande cURL

Cet exemple de code montre comment valider un instantané.

curl "http://instance.servicenow.com/api/sn_cdm/snapshots/validate?name=Development_1-v2.dpl&deployableName=Development_1&appName=testApp" \ 
--request PUT \ 
--header "Accept:application/json" \ 
--user 'username':'password' 

Résultats renvoyés :

{ 
  "result": { 
    "changeset_id": { 
      "value": "d4b9446e53001110a1d3ddeeff7b126c", 
      "link": "http://instance.servicenow.com/api/now/table/sn_cdm_changeset/d4b9446e53001110a1d3ddeeff7b126c" 
    }, 
    "cdm_deployable_id": { 
      "value": "6dc517a953b70110a1d3ddeeff7b129b", 
      "link": "http://instance.servicenow.com/api/now/table/sn_cdm_deployable/6dc517a953b70110a1d3ddeeff7b129b" 
    }, 
    "description": null, 
    "cdm_application_id": { 
      "value": "62b517a953b70110a1d3ddeeff7b128c", 
      "link": "http://instance.servicenow.com/api/now/table/sn_cdm_application/62b517a953b70110a1d3ddeeff7b128c" 
    }, 
    "published": false, 
    "sys_updated_on": "2022-06-30 12:57:02", 
    "last_published": "2022-06-30 12:57:02", 
    "number": "SNAP0001002", 
    "sys_id": "9017fc2e53801110a1d3ddeeff7b12d7", 
    "sys_updated_by": "admin", 
    "sys_created_on": "2022-06-15 14:19:38", 
    "name": "Development_1-v2.dpl", 
    "last_validated": "2022-06-30 12:56:07", 
    "validation": "passed", 
    "sys_created_by": "admin" 
  } 
}