--- sourceDocument: Référence de l’API Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference Release : - xanadu ft:locale : - fr-FR ft:publication_title : - Référence de l’API Xanadu ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # API d'instance CMDB # API d'instance CMDB {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 42 minutes de lecture L'API d'instance CMDB fournit des points de terminaison pour créer, lire, mettre à jour et supprimer des opérations sur des tables existantes Base de données de gestion des configurations (CMDB) . Vous ne pouvez insérer, mettre à jour ou supprimer qu'un seul enregistrement à la fois. Cette API nécessite que l'utilisateur dispose du rôle ITIL. ## CMDB Instance : DELETE /now/cmdb/instance/{classname}/{sys_id}/relation/{rel_sys_id} {#ariaid-title2} Supprime la relation de l'élément de configuration spécifié (CI). ### Format d'URL {#cmdb-DELETE-instance-relation__section_urs_wnr_cmb} URL versionnée : /api/now/v1/cmdb/instance/{className}/{sys_id}/relation/{rel_sys_id} URL par défaut : /api/now/cmdb/instance/{className}/{sys_id}/relation/{rel_sys_id} ### Paramètres de demande pris en charge {#cmdb-DELETE-instance-relation__entry__2}{#cmdb-DELETE-instance-relation__entry-className-cmdb} | Nom | Description | |-|-| | Nom de classe | CMDB Nom de classe. Il s'agit du nom de la table qui contient les enregistrements CI souhaités, par exemple cmdb_ci_linux_server ou cmdb_ci_apache_web_server. Type de données : chaîne | | rel_sys_id | Sys_id de la relation à supprimer. Type de données : chaîne | | sys_id | Sys_id du CI. Type de données : chaîne | [Tableau 1. Paramètres de chemin d'accès] {#cmdb-DELETE-instance-relation__entry__10} | Nom | Description | |-|-| | Aucun | | [Tableau 2. Paramètres de requête] {#cmdb-DELETE-instance-relation__entry__14} | Nom | Description | |-|-| | Aucun | | [Tableau 3. Paramètres de corps de demande (XML ou JSON)] ### En-têtes Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#cmdb-DELETE-instance-relation__entry__18} | En-tête | Description | |-|-| | Aucun | | [Tableau 4. En-têtes de demandes] {#cmdb-DELETE-instance-relation__entry__22} | En-tête | Description | |-|-| | Aucun | | [Tableau 5. En-têtes de réponses] ### Codes d'état Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#cmdb-DELETE-instance-relation__entry__26}{#cmdb-DELETE-instance-relation__entry-200-status-code}{#cmdb-DELETE-instance-relation__entry-400-status-code}{#cmdb-DELETE-instance-relation__entry-401-status-code}{#cmdb-DELETE-instance-relation__entry-404-status-code}{#cmdb-DELETE-instance-relation__entry-405-status-code}{#cmdb-DELETE-instance-relation__entry-500-status-code} | Code d'état | Description | |-|-| | 200 | Réussi. La demande a été correctement traitée. | | 400 | Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté. | | 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. | | 404 | Introuvable. L'élément demandé est introuvable. | | 405 | Méthode non valide. La fonctionnalité est désactivée. | | 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. | [Tableau 6. Codes d'état] ### Paramètres du corps de réponse (JSON ou XML) {#cmdb-DELETE-instance-relation__entry__40} | Nom | Description | |-|-| | Aucun | | [ ] ### Exemple de demande cURL curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci_linux_server/0f4ac6c4b750230096c3e4f6ee11a9fe/relation/b0dbda5347c12200e0ef563dbb9a718f" \ --request DELETE \ --user 'username':'password' ## CMDB Instance : GET /now/cmdb/instance/{classname} {#ariaid-title3} Renvoie les éléments de configuration (CI) disponibles pour une classe spécifiée Base de données de gestion des configurations (CMDB) (table). ### Format d'URL {#cmdb-GET-instance-classname__section_d25_3qr_cmb} URL versionnée : /api/now/v1/cmdb/instance/{className} URL par défaut : /api/now/cmdb/instance/{className} ### Paramètres de demande pris en charge {#cmdb-GET-instance-classname__entry__2}{#cmdb-GET-instance-classname__entry-className-cmdb} | Nom | Description | |-|-| | Nom de classe | CMDB Nom de classe. Il s'agit du nom de la table qui contient les enregistrements CI souhaités, par exemple cmdb_ci_linux_server ou cmdb_ci_apache_web_server. Type de données : chaîne | [Tableau 7. Paramètres de chemin d'accès] {#cmdb-GET-instance-classname__entry__6}{#cmdb-GET-instance-classname__sysparm-limit-RESTAPI}{#cmdb-GET-instance-classname__sysparm_offset-ph-RESTAPI}{#cmdb-GET-instance-classname__sysparm-query-RESTAPI} | Nom | Description | |-|-| | sysparm_limit | Nombre maximal d'enregistrements à renvoyer. Pour les demandes qui dépassent ce nombre d'enregistrements, utilisez le paramètre sysparm_offset pour paginer la récupération d'enregistrements. Cette limite est appliquée avant l'évaluation de l'ACL. Si aucun enregistrement n'est renvoyé (notamment ceux auxquels vous avez accès), réorganisez l'ordre des enregistrements pour que ceux auxquels vous avez accès soient renvoyés en premier. Remarque : Des valeurs sysparm_limit anormalement élevées peuvent avoir un impact sur les performances du système. Type de données : nombre Par défaut : 10 000 | | sysparm_offset | Index de début des enregistrements pour lequel commencer à récupérer des enregistrements. Utilisez cette valeur pour paginer la récupération des enregistrements. Cette fonctionnalité permet de récupérer tous les enregistrements, quel que soit le nombre d'enregistrements, par petits blocs gérables. Par exemple, lors du premier appel de ce point de terminaison, sysparm_offset est défini sur \<\< 0 \>\>. Pour parcourir simplement tous les enregistrements disponibles, utilisez le paramètre `sysparm_offset=sysparm_offset+sysparm_limit`, jusqu'à atteindre la fin de tous les enregistrements.{#cmdb-GET-instance-classname__sysparm_offset-p-RESTAPI} Ne transmettez pas de nombre négatif dans le sysparm_offset paramètre. Type de données : nombre Par défaut : 0 | | sysparm_query | [Requête codée](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) utilisée pour filtrer l'ensemble de résultats. Vous pouvez utiliser un filtre d'interface utilisateur pour obtenir une requête codée correctement. Syntaxe : `sysparm_query=`. * \ : nom de la colonne de table à laquelle appliquer le filtre. * \ : prend en charge les valeurs suivantes : * = : correspond exactement à \. * != : ne correspond pas à \. * \^ : instructions de requête logiques ET multiples. * \^OR : instructions de requête logiques OU multiples. * LIKE : \ contient la chaîne spécifiée. Fonctionne uniquement pour les champs \ dont les données sont de type chaîne. * STARTSWITH : \ commence par la chaîne spécifiée. Fonctionne uniquement pour les champs \ dont les données sont de type chaîne. * ENDSWITH : \ se termine par la chaîne spécifiée. Fonctionne uniquement pour les champs \ dont les données sont de type chaîne. {#cmdb-GET-instance-classname__ul_bgf_5vz_mlb} \ : valeur avec laquelle établir une correspondance. {#cmdb-GET-instance-classname__ul_g2p_svz_mlb} Tous les paramètres sont sensibles à la casse. Les requêtes peuvent contenir plusieurs entrées, telles que sysparm_query=\\\\[\\\\\]. Par exemple : `(sysparm_query=caller_id=javascript:gs.getUserID()^active=true)` Les requêtes codées prennent également en charge le classement par fonctionnalité. Pour trier les réponses en fonction de certains champs, utilisez les clauses `ORDERBY` et `ORDERBYDESC` dans sysparm_query. Syntaxe : * `ORDERBY` * `ORDERBYDESC` {#cmdb-GET-instance-classname__ul_sq4_rc1_nlb} Par exemple : `sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory` Cette requête filtre tous les enregistrements actifs et classe les résultats par ordre croissant, par nombre, puis dans l'ordre décroissant des catégories. Si une partie de la requête n'est pas valide (par exemple, un nom de champ non valide a été spécifié), l'instance ignore la partie non valide. Puis, elle renvoie les lignes en utilisant uniquement la partie valide de la requête. Vous pouvez contrôler ce comportement à l'aide de la propriété glide.invalid_query.returns_no_rows. Définissez cette propriété sur true pour ne renvoyer aucune ligne dans une requête non valide. Remarque : La propriété glide.invalid_query.returns_no_rows contrôle le comportement de toutes les requêtes dans l'instance, par exemple dans les listes, les scripts (GlideRecord.query()) et les API de service Web. Type de données : chaîne | [Tableau 8. Paramètres de requête] {#cmdb-GET-instance-classname__entry__14} | Nom | Description | |-|-| | Aucun | | [Tableau 9. Paramètres de corps de demande (XML ou JSON)] ### En-têtes Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#cmdb-GET-instance-classname__entry__18}{#cmdb-GET-instance-classname__accept-RESTAPI} | En-tête | Description | |-|-| | Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json | [Tableau 10. En-têtes de demandes] {#cmdb-GET-instance-classname__entry__22} | En-tête | Description | |-|-| | Aucun | | [Tableau 11. En-têtes de réponses] ### Codes d'état Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#cmdb-GET-instance-classname__entry__26}{#cmdb-GET-instance-classname__entry-200-status-code}{#cmdb-GET-instance-classname__entry-400-status-code}{#cmdb-GET-instance-classname__entry-401-status-code}{#cmdb-GET-instance-classname__entry-404-status-code}{#cmdb-GET-instance-classname__entry-405-status-code}{#cmdb-GET-instance-classname__entry-500-status-code} | Code d'état | Description | |-|-| | 200 | Réussi. La demande a été correctement traitée. | | 400 | Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté. | | 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. | | 404 | Introuvable. L'élément demandé est introuvable. | | 405 | Méthode non valide. La fonctionnalité est désactivée. | | 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. | [Tableau 12. Codes d'état] ### Paramètres du corps de réponse (JSON ou XML) {#cmdb-GET-instance-classname__entry__40} | Nom | Description | |-|-| | nom | Nom d'un CI dans la classe spécifiée. Type de données : chaîne | | sys_id | Sys_id du CI. Type de données : chaîne | [ ] ### Exemple de demande cURL curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci_linux_server" \ --request GET \ --header "Accept:application/json" \ --user 'username':'password' "result": [ { "sys_id": "3a290cc60a0a0bb400000bdb386af1cf", "name": "PS LinuxApp01" }, { "sys_id": "3a5dd3dbc0a8ce0100655f1ec66ed42c", "name": "PS LinuxApp02" } ] ## CMDB Instance : GET /now/cmdb/instance/{classname}/{sys_id} {#ariaid-title4} Renvoie les attributs et les informations de relation pour un enregistrement d'élément de configuration (CI) spécifié. ### Format d'URL {#cmdb-GET-instance-classname-sys_id__section_p22_d5r_cmb} URL versionnée : /api/now/{api_version}/cmdb/instance/{className}/{sys_id} URL par défaut : /api/now/cmdb/instance/{className}/{sys_id} ### Paramètres de demande pris en charge {#cmdb-GET-instance-classname-sys_id__entry__2}{#cmdb-GET-instance-classname-sys_id__version-RESTAPI}{#cmdb-GET-instance-classname-sys_id__entry-className-cmdb} | 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 | | Nom de classe | CMDB Nom de classe. Il s'agit du nom de la table qui contient les enregistrements CI souhaités, par exemple cmdb_ci_linux_server ou cmdb_ci_apache_web_server. Type de données : chaîne | | sys_id | Sys_id de l'enregistrement de CI à récupérer. Type de données : chaîne | [Tableau 13. Paramètres de chemin d'accès] {#cmdb-GET-instance-classname-sys_id__entry__10} | Nom | Description | |-|-| | Aucun | | [Tableau 14. Paramètres de requête] {#cmdb-GET-instance-classname-sys_id__entry__14} | Nom | Description | |-|-| | Aucun | | [Tableau 15. Paramètres de corps de demande (XML ou JSON)] ### En-têtes Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#cmdb-GET-instance-classname-sys_id__entry__18}{#cmdb-GET-instance-classname-sys_id__accept-RESTAPI} | En-tête | Description | |-|-| | Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json | [Tableau 16. En-têtes de demandes] {#cmdb-GET-instance-classname-sys_id__entry__22} | En-tête | Description | |-|-| | Aucun | | [Tableau 17. En-têtes de réponses] ### Codes d'état Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#cmdb-GET-instance-classname-sys_id__entry__26}{#cmdb-GET-instance-classname-sys_id__entry-200-status-code}{#cmdb-GET-instance-classname-sys_id__entry-400-status-code}{#cmdb-GET-instance-classname-sys_id__entry-401-status-code}{#cmdb-GET-instance-classname-sys_id__entry-404-status-code}{#cmdb-GET-instance-classname-sys_id__entry-405-status-code}{#cmdb-GET-instance-classname-sys_id__entry-500-status-code} | Code d'état | Description | |-|-| | 200 | Réussi. La demande a été correctement traitée. | | 400 | Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté. | | 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. | | 404 | Introuvable. L'élément demandé est introuvable. | | 405 | Méthode non valide. La fonctionnalité est désactivée. | | 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. | [Tableau 18. Codes d'état] ### Paramètres du corps de réponse (JSON ou XML) {#cmdb-GET-instance-classname-sys_id__table_d5p_jn4_3mb__entry__2}{#cmdb-GET-instance-classname-sys_id__entry-result-error-cmdb-ph}{#cmdb-GET-instance-classname-sys_id__entry-result-error_detail-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-error_message-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-inbound_relations-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-inbound_relations_sys_id-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-inbound_relations_target-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-inbound_relations_target_display_value-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-inbound_relations_target_link-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-inbound_relations_target_value-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-inbound_relations_type-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-inbound_relations_type_display_value-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-inbound_relations_type_link-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-inbound_relations_type_value-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-outbound_relations-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-outbound_relations_sys_id-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-outbound_relations_target-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-outbound_relations_target_display_value-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-outbound_relations_target_link-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-outbound_relations_target_value-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-outbound_relations_type-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-outbound_relations_type_display_value-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-outbound_relations_type_link-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-outbound_relations_type_value-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-status-cmdb} | Nom | Description | |-|-| | attributs | Attributs de données actuellement dans l'enregistrement de CI. Les attributs disponibles dépendent de la classe spécifiée CMDB . Vous pouvez localiser les attributs disponibles dans la table associée CMDB , qui commence généralement par \<\< cmdb_ci \>\>, telle que cmdb_ci_linux_server ou cmdb_ci_mfp_printer. Type de données : objet | | erreur | Informations sur les erreurs rencontrées lors du traitement de la demande de point de terminaison. Type de données : objet "error": { "detail": "String", "message": "String" } | | error.detail | Informations supplémentaires sur l'erreur. Type de données : chaîne | | message.erreur | Message qui identifie l'erreur. Type de données : chaîne | | inbound_relations | Liste des objets qui définissent les relations entrantes associées au CI. Type de données : tableau "inbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ] | | inbound_relations.sys_id | Sys_id de la relation CI entrante. Situé dans la table Relations CI \[cmdb_rel_ci\]. Type de données : chaîne | | inbound_relations.Cible | Informations décrivant la relation entrante cible. Type de données : objet "target": { "display_value": "String", "link": "String", "value": "String" } | | inbound_relations.target.display_value | Nom de la relation entrante à afficher dans une interface utilisateur. Type de données : chaîne | | inbound_relations.target.link | CMDB URL du point de terminaison REST à utiliser pour récupérer la relation entrante à partir de la table Élément de configuration \[cmdb_ci\]. Type de données : chaîne | | inbound_relations.target.value | Sys_id du CI entrant. Situé dans la table Élément de configuration \[cmdb_ci\]. Type de données : chaîne | | inbound_relations.type | Informations sur le type de relation entrante. Type de données : objet "type": { "display_value": "String", "link": "String", "value": "String" } | | inbound_relations.type.display_value | Nom du type entrant à afficher dans une interface utilisateur. Type de données : chaîne | | inbound_relations.type.link | Table URL du point de terminaison REST à utiliser pour récupérer le type de relation entrante à partir de la table Type de relation CI \[cmdb_rel_type\]. Type de données : chaîne | | inbound_relations.type.valeur | Sys_id du type de relation entrante. Situé dans la table Type de relation CI \[cmdb_rel_type\]. Type de données : chaîne | | outbound_relations | Liste des objets qui définissent les relations sortantes associées au CI. Type de données : tableau "outbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ] | | outbound_relations.sys_id | Sys_id de la relation CI de débordement. Situé dans la table Relations CI \[cmdb_rel_ci\]. Type de données : chaîne | | outbound_relations.Cible | Requis. Informations sur la relation sortante cible. Type de données : objet "target": { "display_value": "String", "link": "String", "value": "String" } | | outbound_relations.target.display_value | Nom de la relation sortante à afficher dans une interface utilisateur. Type de données : chaîne | | outbound_relations.target.link | CMDB URL du point de terminaison REST à utiliser pour récupérer la relation sortante de la table d'éléments de configuration \[cmdb_ci\]. Type de données : chaîne | | outbound_relations.target.value | Sys_id du CI sortant. Situé dans la table Élément de configuration \[cmdb_ci\]. Type de données : chaîne | | outbound_relations.type | Informations sur le type de relation sortante. Type de données : objet "type": { "display_value": "String", "link": "String", "value": "String" } | | outbound_relations.type.display_value | Nom du type sortant à afficher dans une interface utilisateur. Type de données : chaîne | | outbound_relations.type.link | Table URL du point de terminaison REST à utiliser pour récupérer la relation sortante de la table Type de relation CI \[cmdb_rel_type\]. Type de données : chaîne | | outbound_relations.type.valeur | Sys_id du type de relation sortante. Situé dans la table Type de relation CI \[cmdb_rel_type\]. Type de données : chaîne | | statut | N'apparaît que si une erreur est rencontrée. État du traitement du point de terminaison. Valeur possible : échec Type de données : chaîne | [Tableau 19. Paramètres de réponses] {#cmdb-GET-instance-classname-sys_id__table_d5p_jn4_3mb} ### Exemple de demande cURL curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci_linux_server/70bc4e11c0a8210d01f074cbe6bd73b4" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { "result": { "outbound_relations": [ { "sys_id": "3a62e64ac0a8ce0100aead1e3fd5439f", "type": { "display_value": "Depends on::Used by", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5", "value": "1a9cb166f1571100a92eb60da2bce5c5" }, "target": { "display_value": "PS ORA01", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f", "value": "3a307c930a0a0bb400353965d0b8861f" } }, { "sys_id": "3a67513fc0a8ce0100914a76cea11b02", "type": { "display_value": "Exchanges data with::Exchanges data with", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/607ad1b2c0a8010e01941856b365af90", "value": "607ad1b2c0a8010e01941856b365af90" }, "target": { "display_value": "PS ORA01", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f", "value": "3a307c930a0a0bb400353965d0b8861f" } } ], "attributes": { "firewall_status": "Intranet", "os_address_width": "", "attested_date": "", "operational_status": "1", "os_service_pack": "", "cpu_core_thread": "", "cpu_manufacturer": "", "sys_updated_on": "2020-07-08 11:16:51", "discovery_source": "", "first_discovered": "", "due_in": "", "used_for": "Production", "invoice_number": "", "gl_account": "", "sys_created_by": "glide.maint", "warranty_expiration": "", "ram": "2048", "cpu_name": "", "cpu_speed": "2800", "owned_by": "", "checked_out": "", "kernel_release": "", "sys_domain_path": "/", "classification": "Production", "disk_space": "40", "object_id": "", "maintenance_schedule": "", "cost_center": "", "attested_by": "", "dns_domain": "", "assigned": "2020-01-04 07:00:00", "purchase_date": "", "life_cycle_stage": "", "short_description": "", "cd_speed": "", "floppy": "", "managed_by": { "display_value": "Lynda Caraway", "link": "https://instance.service-now.com/api/now/table/sys_user/8a826bf03710200044e0bfc8bcbe5d72", "value": "8a826bf03710200044e0bfc8bcbe5d72" }, "os_domain": "", "last_discovered": "", "can_print": "false", "sys_class_name": "cmdb_ci_linux_server", "manufacturer": { "display_value": "Iris", "link": "https://instance.servicenow.com/api/now/table/core_company/c115c2f737e3100044e0bfc8bcbe5d46", "value": "c115c2f737e3100044e0bfc8bcbe5d46" }, "cpu_count": "1", "vendor": { "display_value": "Cloudward Inc", "link": "https://instance.servicenow.com/api/now/table/core_company/3efe8c4c37423000158bbfc8bcbe5d7d", "value": "3efe8c4c37423000158bbfc8bcbe5d7d" }, "life_cycle_stage_status": "", "model_number": "", "assigned_to": "", "start_date": "", "os_version": "2.6.9-22.0.1.ELsmp", "serial_number": "", "cd_rom": "false", "support_group": "", "unverified": "false", "correlation_id": "", "attributes": "", "asset": { "display_value": "P1000091 - Iris 5875", "link": "https://instance.servicenow.com/api/now/table/alm_asset/0bc1ba8837f3100044e0bfc8bcbe5dbb", "value": "0bc1ba8837f3100044e0bfc8bcbe5dbb" }, "form_factor": "", "cpu_core_count": "", "skip_sync": "false", "attestation_score": "", "sys_updated_by": "system", "sys_created_on": "2008-10-26 17:17:28", "sys_domain": { "display_value": "global", "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global", "value": "global" }, "cpu_type": "Intel", "install_date": "2019-08-18 08:00:00", "asset_tag": "P1000091", "dr_backup": "", "hardware_substatus": "", "fqdn": "", "change_control": "", "internet_facing": "false", "delivery_date": "", "hardware_status": "", "install_status": "1", "supported_by": "", "name": "PS LinuxApp01", "subcategory": "", "default_gateway": "", "chassis_type": "", "virtual": "false", "assignment_group": "", "managed_by_group": "", "sys_id": "3a290cc60a0a0bb400000bdb386af1cf", "po_number": "", "checked_in": "", "sys_class_path": "/!!/!2/!(/!!/!0", "mac_address": "", "company": { "display_value": "ACME Corporation", "link": "https://instance.servicenow.com/api/now/table/core_company/e7c1f3d53790200044e0bfc8bcbe5deb", "value": "e7c1f3d53790200044e0bfc8bcbe5deb" }, "justification": "", "department": "", "cost": "45557.5", "comments": "", "os": "Linux Red Hat", "sys_mod_count": "24", "monitor": "false", "model_id": { "display_value": "Iris 5875", "link": "https://instance.servicenow.com/api/now/table/cmdb_model/5f5fbcc3c0a8010e00f3b27814f3b96b", "value": "5f5fbcc3c0a8010e00f3b27814f3b96b" }, "ip_address": "", "duplicate_of": "", "sys_tags": "", "cost_cc": "USD", "order_date": "", "schedule": "", "environment": "", "due": "", "attested": "false", "location": { "display_value": "322 West 52nd Street, New York,NY", "link": "https://instance.servicenow.com/api/now/table/cmn_location/25ab9f690a0a0bb3001c5fec1d0d7bcb", "value": "25ab9f690a0a0bb3001c5fec1d0d7bcb" }, "category": "Do not migrate to asset", "fault_count": "0", "host_name": "", "lease_id": "" }, "inbound_relations": [ { "sys_id": "3a5e4d8ac0a8ce010005145afb730818", "type": { "display_value": "Depends on::Used by", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5", "value": "1a9cb166f1571100a92eb60da2bce5c5" }, "target": { "display_value": "PS Apache01", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a27d4370a0a0bb4006316812bf45439", "value": "3a27d4370a0a0bb4006316812bf45439" } }, { "sys_id": "3a5e4d9cc0a8ce010097f2f5c2f65fd8", "type": { "display_value": "Depends on::Used by", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5", "value": "1a9cb166f1571100a92eb60da2bce5c5" }, "target": { "display_value": "PS Apache02", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a27f1520a0a0bb400ecd6ff7afcf036", "value": "3a27f1520a0a0bb400ecd6ff7afcf036" } }, { "sys_id": "3a5e4d9fc0a8ce0100a3754fac26fe56", "type": { "display_value": "Depends on::Used by", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5", "value": "1a9cb166f1571100a92eb60da2bce5c5" }, "target": { "display_value": "PS Apache03", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a2810c20a0a0bb400268337d6e942ca", "value": "3a2810c20a0a0bb400268337d6e942ca" } } ] } } ## CMDB Instance : POST /now/cmdb/instance/{classname} {#ariaid-title5} Crée un élément de configuration (CI) unique avec les relations sortantes et entrantes spécifiées dans la table spécifiée Base de données de gestion des configurations (CMDB) . Remarque : Si une règle d'identification dépendante est définie pour la CMDB classe, la charge utile d'entrée doit contenir les sys_id d'un CI existant. Par exemple, pour outbound_relations, le target paramètre doit contenir la sys_id d'un CI existant, qui devient alors l'enfant. Car inbound_relations, il devient le parent. "depends_on": { "outbound_relations": { "target": "b4fd7c8437201000deeabfc8bcbe5dc1", "type": "60bc4e22c0a8010e01f074cbe6bd73c3" } } ### Format d'URL {#cmdb-POST-instance__section_z23_pzr_cmb} URL versionnée : /api/now/v1/cmdb/instance/{className} URL par défaut : /api/now/cmdb/instance/{className} ### Paramètres de demande pris en charge {#cmdb-POST-instance__entry__2}{#cmdb-POST-instance__entry-className-cmdb} | Nom | Description | |-|-| | Nom de classe | CMDB Nom de classe. Il s'agit du nom de la table qui contient les enregistrements CI souhaités, par exemple cmdb_ci_linux_server ou cmdb_ci_apache_web_server. Type de données : chaîne | [Tableau 20. Paramètres de chemin d'accès] {#cmdb-POST-instance__entry__6} | Nom | Description | |-|-| | Aucun | | [Tableau 21. Paramètres de requête] {#cmdb-POST-instance__entry__10}{#cmdb-POST-instance__entry-attributes-cmdb}{#cmdb-POST-instance__entry-inbound_relations-cmdb}{#cmdb-POST-instance__entry-inbound_relations_target-cmdb}{#cmdb-POST-instance__entry-inbound_relations_type-cmdb}{#cmdb-POST-instance__entry-request-outbound_relations_target-cmdb}{#cmdb-POST-instance__entry-request-outbound_relations_type-cmdb}{#cmdb-POST-instance__entry-source-cmdb} | Nom | Description | |-|-| | attributs | Attributs de données à définir dans l'enregistrement CI. Les attributs disponibles dépendent de la classe spécifiée CMDB . Vous pouvez localiser les attributs disponibles dans la table associée CMDB , qui commence généralement par \<\< cmdb_ci \>\>, telle que cmdb_ci_linux_server ou cmdb_ci_mfp_printer. Type de données : objet | | inbound_relations | Liste des objets qui définissent les relations entrantes à associer au CI. Type de données : tableau "inbound_relations": [ { "target": "String", "type": "String" } ] | | inbound_relations.Cible | Requis si inbound_relations spécifié. Sys_id de la relation entrante cible à associer au CI spécifié. Situé dans la table Élément de configuration \[cmdb_ci\]. Type de données : chaîne | | inbound_relations.type | Requis si inbound_relations spécifié. Sys_id du type de relation entrante. Situé dans la table Type de relation CI \[cmdb_rel_type\]. Type de données : chaîne Type de données : chaîne | | outbound_relations | Liste des objets qui définissent les relations sortantes à associer au CI. Type de données : tableau "outbound_relations": [ { "target": "String", "type": "String" } ] | | outbound_relations.Cible | Requis si outbound_relations spécifié. Sys_id de la relation sortante cible. Situé dans la table Élément de configuration \[cmdb_ci\]. Type de données : chaîne | | outbound_relations.type | Requis si outbound_relations spécifié. Sys_id du type de relation sortante. Situé dans la table Type de relation CI \[cmdb_rel_type\]. Type de données : chaîne | | source | Requis. Entité qui a mis à jour les informations. Il doit s'agir de l'une des valeurs de choix spécifiées dans le champ discovery_source de la table Élément de configuration \[cmdb_ci\]. Type de données : chaîne | [Tableau 22. Paramètres de corps de demande (XML ou JSON)] ### En-têtes Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#cmdb-POST-instance__entry__28}{#cmdb-POST-instance__accept-RESTAPI}{#cmdb-POST-instance__content_type-RESTAPI} | En-tête | Description | |-|-| | Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json | | Content-Type | Format de données du corps de la demande. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json | [Tableau 23. En-têtes de demandes] {#cmdb-POST-instance__entry__34} | En-tête | Description | |-|-| | Aucun | | [Tableau 24. En-têtes de réponses] ### Codes d'état Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#cmdb-POST-instance__entry__38}{#cmdb-POST-instance__entry-200-status-code}{#cmdb-POST-instance__entry-400-status-code}{#cmdb-POST-instance__entry-401-status-code}{#cmdb-POST-instance__entry-404-status-code}{#cmdb-POST-instance__entry-405-status-code}{#cmdb-POST-instance__entry-500-status-code} | Code d'état | Description | |-|-| | 200 | Réussi. La demande a été correctement traitée. | | 400 | Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté. | | 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. | | 404 | Introuvable. L'élément demandé est introuvable. | | 405 | Méthode non valide. La fonctionnalité est désactivée. | | 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. | [Tableau 25. Codes d'état] ### Paramètres du corps de réponse (JSON ou XML) {#cmdb-POST-instance__table_ags_gn4_3mb__entry__2}{#cmdb-POST-instance__entry-result-error-cmdb-ph}{#cmdb-POST-instance__entry-result-error_detail-cmdb}{#cmdb-POST-instance__entry-result-error_message-cmdb}{#cmdb-POST-instance__entry-result-inbound_relations-cmdb}{#cmdb-POST-instance__entry-result-inbound_relations_sys_id-cmdb}{#cmdb-POST-instance__entry-result-inbound_relations_target-cmdb}{#cmdb-POST-instance__entry-result-inbound_relations_target_display_value-cmdb}{#cmdb-POST-instance__entry-result-inbound_relations_target_link-cmdb}{#cmdb-POST-instance__entry-result-inbound_relations_target_value-cmdb}{#cmdb-POST-instance__entry-result-inbound_relations_type-cmdb}{#cmdb-POST-instance__entry-result-inbound_relations_type_display_value-cmdb}{#cmdb-POST-instance__entry-result-inbound_relations_type_link-cmdb}{#cmdb-POST-instance__entry-result-inbound_relations_type_value-cmdb}{#cmdb-POST-instance__entry-result-outbound_relations-cmdb}{#cmdb-POST-instance__entry-result-outbound_relations_sys_id-cmdb}{#cmdb-POST-instance__entry-result-outbound_relations_target-cmdb}{#cmdb-POST-instance__entry-result-outbound_relations_target_display_value-cmdb}{#cmdb-POST-instance__entry-result-outbound_relations_target_link-cmdb}{#cmdb-POST-instance__entry-result-outbound_relations_target_value-cmdb}{#cmdb-POST-instance__entry-result-outbound_relations_type-cmdb}{#cmdb-POST-instance__entry-result-outbound_relations_type_display_value-cmdb}{#cmdb-POST-instance__entry-result-outbound_relations_type_link-cmdb}{#cmdb-POST-instance__entry-result-outbound_relations_type_value-cmdb}{#cmdb-POST-instance__entry-result-status-cmdb} | Nom | Description | |-|-| | attributs | Attributs de données actuellement dans l'enregistrement de CI. Les attributs disponibles dépendent de la classe spécifiée CMDB . Vous pouvez localiser les attributs disponibles dans la table associée CMDB , qui commence généralement par \<\< cmdb_ci \>\>, telle que cmdb_ci_linux_server ou cmdb_ci_mfp_printer. Type de données : objet | | erreur | Informations sur les erreurs rencontrées lors du traitement de la demande de point de terminaison. Type de données : objet "error": { "detail": "String", "message": "String" } | | error.detail | Informations supplémentaires sur l'erreur. Type de données : chaîne | | message.erreur | Message qui identifie l'erreur. Type de données : chaîne | | inbound_relations | Liste des objets qui définissent les relations entrantes associées au CI. Type de données : tableau "inbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ] | | inbound_relations.sys_id | Sys_id de la relation CI entrante. Situé dans la table Relations CI \[cmdb_rel_ci\]. Type de données : chaîne | | inbound_relations.Cible | Informations décrivant la relation entrante cible. Type de données : objet "target": { "display_value": "String", "link": "String", "value": "String" } | | inbound_relations.target.display_value | Nom de la relation entrante à afficher dans une interface utilisateur. Type de données : chaîne | | inbound_relations.target.link | CMDB URL du point de terminaison REST à utiliser pour récupérer la relation entrante à partir de la table Élément de configuration \[cmdb_ci\]. Type de données : chaîne | | inbound_relations.target.value | Sys_id du CI entrant. Situé dans la table Élément de configuration \[cmdb_ci\]. Type de données : chaîne | | inbound_relations.type | Informations sur le type de relation entrante. Type de données : objet "type": { "display_value": "String", "link": "String", "value": "String" } | | inbound_relations.type.display_value | Nom du type entrant à afficher dans une interface utilisateur. Type de données : chaîne | | inbound_relations.type.link | Table URL du point de terminaison REST à utiliser pour récupérer le type de relation entrante à partir de la table Type de relation CI \[cmdb_rel_type\]. Type de données : chaîne | | inbound_relations.type.valeur | Sys_id du type de relation entrante. Situé dans la table Type de relation CI \[cmdb_rel_type\]. Type de données : chaîne | | outbound_relations | Liste des objets qui définissent les relations sortantes associées au CI. Type de données : tableau "outbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ] | | outbound_relations.sys_id | Sys_id de la relation CI de débordement. Situé dans la table Relations CI \[cmdb_rel_ci\]. Type de données : chaîne | | outbound_relations.Cible | Requis. Informations sur la relation sortante cible. Type de données : objet "target": { "display_value": "String", "link": "String", "value": "String" } | | outbound_relations.target.display_value | Nom de la relation sortante à afficher dans une interface utilisateur. Type de données : chaîne | | outbound_relations.target.link | CMDB URL du point de terminaison REST à utiliser pour récupérer la relation sortante de la table d'éléments de configuration \[cmdb_ci\]. Type de données : chaîne | | outbound_relations.target.value | Sys_id du CI sortant. Situé dans la table Élément de configuration \[cmdb_ci\]. Type de données : chaîne | | outbound_relations.type | Informations sur le type de relation sortante. Type de données : objet "type": { "display_value": "String", "link": "String", "value": "String" } | | outbound_relations.type.display_value | Nom du type sortant à afficher dans une interface utilisateur. Type de données : chaîne | | outbound_relations.type.link | Table URL du point de terminaison REST à utiliser pour récupérer la relation sortante de la table Type de relation CI \[cmdb_rel_type\]. Type de données : chaîne | | outbound_relations.type.valeur | Sys_id du type de relation sortante. Situé dans la table Type de relation CI \[cmdb_rel_type\]. Type de données : chaîne | | statut | N'apparaît que si une erreur est rencontrée. État du traitement du point de terminaison. Valeur possible : échec Type de données : chaîne | [Tableau 26. Paramètres de réponses] {#cmdb-POST-instance__table_ags_gn4_3mb} ### Demande cURL L'exemple de code suivant montre comment appeler ce point de terminaison. curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci_linux_server" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json"\ --user "username":"password" \ --data { "outbound_relations": [ { "type" : "1a9cb166f1571100a92eb60da2bce5c5", "target" : "3a307c930a0a0bb400353965d0b8861f" }, { "type" : "607ad1b2c0a8010e01941856b365af90", "target" : "3a307c930a0a0bb400353965d0b8861f" } ], "attributes": { "name" : "lnux999", "firewall_status": "Intranet" }, "source": "ServiceNow", "inbound_relations": [ { "type" : "1a9cb166f1571100a92eb60da2bce5c5", "target" : "3a27d4370a0a0bb4006316812bf45439" } ] } { "result": { "outbound_relations": [ { "sys_id": "403ff2641b425010593876a61a4bcb4b", "type": { "display_value": "Depends on::Used by", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5", "value": "1a9cb166f1571100a92eb60da2bce5c5" }, "target": { "display_value": "PS ORA01", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f", "value": "3a307c930a0a0bb400353965d0b8861f" } }, { "sys_id": "443ff2641b425010593876a61a4bcb4c", "type": { "display_value": "Exchanges data with::Exchanges data with", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/607ad1b2c0a8010e01941856b365af90", "value": "607ad1b2c0a8010e01941856b365af90" }, "target": { "display_value": "PS ORA01", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f", "value": "3a307c930a0a0bb400353965d0b8861f" } } ], "attributes": { "firewall_status": "Intranet", "os_address_width": "", "attested_date": "", "operational_status": "1", "os_service_pack": "", "cpu_core_thread": "", "cpu_manufacturer": "", "sys_updated_on": "2020-07-13 20:27:28", "discovery_source": "ServiceNow", "first_discovered": "2020-07-13 20:27:28", "due_in": "", "used_for": "Production", "invoice_number": "", "gl_account": "", "sys_created_by": "dora.gray", "warranty_expiration": "", "ram": "", "cpu_name": "", "cpu_speed": "", "owned_by": "", "checked_out": "", "kernel_release": "", "sys_domain_path": "/", "classification": "Production", "disk_space": "", "object_id": "", "maintenance_schedule": "", "cost_center": "", "attested_by": "", "dns_domain": "", "assigned": "", "purchase_date": "", "life_cycle_stage": "", "short_description": "", "cd_speed": "", "floppy": "", "managed_by": "", "os_domain": "", "last_discovered": "2020-07-13 20:27:28", "can_print": "false", "sys_class_name": "cmdb_ci_linux_server", "manufacturer": "", "cpu_count": "", "vendor": "", "life_cycle_stage_status": "", "model_number": "", "assigned_to": "", "start_date": "", "os_version": "", "serial_number": "", "cd_rom": "false", "support_group": "", "unverified": "false", "correlation_id": "", "attributes": "", "asset": "", "form_factor": "", "cpu_core_count": "", "skip_sync": "false", "attestation_score": "", "sys_updated_by": "dora.gray", "sys_created_on": "2020-07-13 20:27:28", "sys_domain": { "display_value": "global", "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global", "value": "global" }, "cpu_type": "", "install_date": "", "asset_tag": "", "dr_backup": "", "hardware_substatus": "", "fqdn": "", "change_control": "", "internet_facing": "true", "delivery_date": "", "hardware_status": "installed", "install_status": "1", "supported_by": "", "name": "lnux299", "subcategory": "Computer", "default_gateway": "", "chassis_type": "", "virtual": "false", "assignment_group": "", "managed_by_group": "", "sys_id": "0c3ff2641b425010593876a61a4bcb39", "po_number": "", "checked_in": "", "sys_class_path": "/!!/!2/!(/!!/!0", "mac_address": "", "company": "", "justification": "", "department": "", "cost": "", "comments": "", "os": "", "sys_mod_count": "0", "monitor": "false", "model_id": "", "ip_address": "", "duplicate_of": "", "sys_tags": "", "cost_cc": "USD", "order_date": "", "schedule": "", "environment": "", "due": "", "attested": "false", "location": "", "category": "Hardware", "fault_count": "0", "host_name": "", "lease_id": "" }, "inbound_relations": [ { "sys_id": "c03ff2641b425010593876a61a4bcb49", "type": { "display_value": "Depends on::Used by", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5", "value": "1a9cb166f1571100a92eb60da2bce5c5" }, "target": { "display_value": "PS Apache01", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a27d4370a0a0bb4006316812bf45439", "value": "3a27d4370a0a0bb4006316812bf45439" } } ] } } ### Demande cURL {#cmdb-POST-instance__example_bbs_f4y_3xb} L'exemple de code suivant montre comment appeler ce point de terminaison pour une classe pour laquelle une règle d'identification dépendante est définie. Ils outbound_relations.target doivent être inclus dans la charge utile et contenir les sys_id d'un CI existant. curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci_linux_server" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json"\ --user "username":"password" \ --data { "attributes": { "name": "test", "sys_class_name":"cmdb_ci_db_mssql_instance", "instance_name":"Iname" }, "source": "ServiceNow", "depends_on": { "outbound_relations": { "target": "b4fd7c8437201000deeabfc8bcbe5dc1", "type": "60bc4e22c0a8010e01f074cbe6bd73c3" } } } } { "result": { "outbound_relations": [ { "sys_id": "505cfa3a53662110af64ddeeff7b1217", "type": { "display_value": "Runs on::Runs", "link": http://instance.servicenow.com/api/now/table/cmdb_rel_type/60bc4e22c0a8010e01f074cbe6bd73c3, "value": "60bc4e22c0a8010e01f074cbe6bd73c3" }, "target": { "display_value": "*ANNIE-IBM", "link": http://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/b4fd7c8437201000deeabfc8bcbe5dc1, "value": "b4fd7c8437201000deeabfc8bcbe5dc1" } } ], "attributes": { "attested_date": "", "operational_status": "1", "running_process_command": "", "sys_updated_on": "2023-05-05 21:28:24", "type": "", "running_process_key_parameters": "", "rp_command_hash": "", "discovery_source": "ServiceNow", "first_discovered": "2023-05-05 21:28:24", "due_in": "", "service_pack": "", "used_for": "Production", "is_clustered": "false", "invoice_number": "", "gl_account": "", "sys_created_by": "admin", "warranty_expiration": "", "owned_by": "", "checked_out": "", "rp_key_parameters_hash": "", "sys_domain_path": "/", "business_unit": "", "version": "", "cpu_sockets": "", "maintenance_schedule": "", "cost_center": "", "attested_by": "", "dns_domain": "", "assigned": "", "purchase_date": "", "life_cycle_stage": "", "short_description": "", "managed_by": "", "port_dynamic": "false", "last_discovered": "2023-05-05 21:28:24", "can_print": "false", "sys_class_name": "cmdb_ci_db_mssql_instance", "manufacturer": "", "cl_port": "", "vendor": "", "life_cycle_stage_status": "", "model_number": "", "config_file": "", "assigned_to": "", "start_date": "", "instance_name": "Iname", "serial_number": "", "engine_edition": "", "support_group": "", "version_name": "", "unverified": "false", "correlation_id": "", "attributes": "", "asset": "", "config_directory": "", "tcp_port": "", "listener_name": "", "skip_sync": "false", "pid": "", "attestation_score": "", "sys_updated_by": "admin", "install_directory": "", "sys_created_on": "2023-05-05 21:28:24", "sys_domain": { "display_value": "global", "link": http://instance.servicenow.com/api/now/table/sys_user_group/global, "value": "global" }, "install_date": "", "asset_tag": "", "fqdn": "", "change_control": "", "delivery_date": "", "install_status": "1", "supported_by": "", "name": "test", "subcategory": "Database", "assignment_group": "", "edition": "", "managed_by_group": "", "sys_id": "185cba3a53662110af64ddeeff7b12af", "po_number": "", "database": "", "checked_in": "", "sys_class_path": "/!!/!(/!2/!,", "mac_address": "", "company": "", "justification": "", "department": "", "cost": "", "comments": "", "attestation_status": "Not Yet Reviewed", "sys_mod_count": "0", "monitor": "false", "model_id": "", "ip_address": "", "duplicate_of": "", "sys_tags": "", "cost_cc": "USD", "order_date": "", "schedule": "", "environment": "", "due": "", "attested": "false", "location": "", "category": "Resource", "fault_count": "0", "lease_id": "" }, "inbound_relations": [] } } ### Demande cURL {#cmdb-POST-instance__example_gj4_45b_kxb} L'exemple de code suivant montre ce qui est renvoyé lorsqu'un sys_id n'est pas transmis pour une classe pour laquelle une règle d'identification dépendante est définie. Le même résultat se produit si la sys_id n'est pas valide. curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci_linux_server" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json"\ --user "username":"password" \ --data "{ "attributes": { "name": "test", "sys_class_name":"cmdb_ci_db_mssql_instance", "instance_name":"Iname" }, "source": "ServiceNow", "depends_on": { "outbound_relations": { "type": "60bc4e22c0a8010e01f074cbe6bd73c3" } } } { "error": { "detail": "Exception while executing request: null Check logs for error trace or enable glide.rest.debug property to verify REST request processing", "message": "Exception while executing request: null" }, "status": "failure" } ## CMDB Instance : PUT /now/cmdb/instance/{classname}/{sys_id} {#ariaid-title6} Met à jour l'enregistrement d'élément de configuration (CI) spécifié avec les paires nom-valeur d'attribut spécifiées. Ce point de terminaison ne crée pas, ne met pas à jour ou ne supprime pas les relations associées. Remarque : Ce point de terminaison n'est pas conforme aux spécifications HTML. Les points de terminaison PUT standard sont destructeurs en ce sens qu'ils suppriment tous les éléments qui ne sont pas inclus dans la requête. Ce point de terminaison ne supprime pas les éléments non spécifiés. ### Format d'URL {#cmdb-PUT-instance__section_o2s_nms_cmb} URL versionnée : /api/now/v1/cmdb/instance/{className}/{sys_id} URL par défaut : /api/now/cmdb/instance/{className}/{sys_id} ### Paramètres de demande pris en charge {#cmdb-PUT-instance__entry__2}{#cmdb-PUT-instance__entry-className-cmdb}{#cmdb-PUT-instance__entry-sys_id-cmdb} | Nom | Description | |-|-| | Nom de classe | CMDB Nom de classe. Il s'agit du nom de la table qui contient les enregistrements CI souhaités, par exemple cmdb_ci_linux_server ou cmdb_ci_apache_web_server. Type de données : chaîne | | sys_id | Sys_id de l'enregistrement CI à mettre à jour. Type de données : chaîne | [Tableau 27. Paramètres de chemin d'accès] {#cmdb-PUT-instance__entry__8} | Nom | Description | |-|-| | Aucun | | [Tableau 28. Paramètres de requête] {#cmdb-PUT-instance__entry__12}{#cmdb-PUT-instance__entry-attributes-cmdb}{#cmdb-PUT-instance__entry-source-cmdb} | Nom | Description | |-|-| | attributs | Attributs de données à remplacer dans l'enregistrement CI. Les attributs disponibles dépendent de la classe spécifiée CMDB . Vous pouvez localiser les attributs disponibles dans la table associée CMDB , qui commence généralement par \<\< cmdb_ci \>\>, telle que cmdb_ci_linux_server ou cmdb_ci_mfp_printer. Type de données : objet | | source | Requis. Entité qui a mis à jour les informations. Il doit s'agir de l'une des valeurs de choix spécifiées dans le champ discovery_source de la table Élément de configuration \[cmdb_ci\]. Type de données : chaîne | [Tableau 29. Paramètres de corps de demande (XML ou JSON)] ### En-têtes Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#cmdb-PUT-instance__entry__18}{#cmdb-PUT-instance__accept-RESTAPI}{#cmdb-PUT-instance__content_type-RESTAPI} | En-tête | Description | |-|-| | Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json | | Content-Type | Format de données du corps de la demande. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json | [Tableau 30. En-têtes de demandes] {#cmdb-PUT-instance__entry__24} | En-tête | Description | |-|-| | Aucun | | [Tableau 31. En-têtes de réponses] ### Codes d'état Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#cmdb-PUT-instance__entry__28}{#cmdb-PUT-instance__entry-200-status-code}{#cmdb-PUT-instance__entry-400-status-code}{#cmdb-PUT-instance__entry-401-status-code}{#cmdb-PUT-instance__entry-404-status-code}{#cmdb-PUT-instance__entry-405-status-code}{#cmdb-PUT-instance__entry-500-status-code} | Code d'état | Description | |-|-| | 200 | Réussi. La demande a été correctement traitée. | | 400 | Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté. | | 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. | | 404 | Introuvable. L'élément demandé est introuvable. | | 405 | Méthode non valide. La fonctionnalité est désactivée. | | 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. | [Tableau 32. Codes d'état] ### Paramètres du corps de réponse (JSON ou XML) {#cmdb-PUT-instance__table_ens_hq4_3mb__entry__2}{#cmdb-PUT-instance__entry-result-error-cmdb-ph}{#cmdb-PUT-instance__entry-result-error_detail-cmdb}{#cmdb-PUT-instance__entry-result-error_message-cmdb}{#cmdb-PUT-instance__entry-result-inbound_relations-cmdb}{#cmdb-PUT-instance__entry-result-inbound_relations_sys_id-cmdb}{#cmdb-PUT-instance__entry-result-inbound_relations_target-cmdb}{#cmdb-PUT-instance__entry-result-inbound_relations_target_display_value-cmdb}{#cmdb-PUT-instance__entry-result-inbound_relations_target_link-cmdb}{#cmdb-PUT-instance__entry-result-inbound_relations_target_value-cmdb}{#cmdb-PUT-instance__entry-result-inbound_relations_type-cmdb}{#cmdb-PUT-instance__entry-result-inbound_relations_type_display_value-cmdb}{#cmdb-PUT-instance__entry-result-inbound_relations_type_link-cmdb}{#cmdb-PUT-instance__entry-result-inbound_relations_type_value-cmdb}{#cmdb-PUT-instance__entry-result-outbound_relations-cmdb}{#cmdb-PUT-instance__entry-result-outbound_relations_sys_id-cmdb}{#cmdb-PUT-instance__entry-result-outbound_relations_target-cmdb}{#cmdb-PUT-instance__entry-result-outbound_relations_target_display_value-cmdb}{#cmdb-PUT-instance__entry-result-outbound_relations_target_link-cmdb}{#cmdb-PUT-instance__entry-result-outbound_relations_target_value-cmdb}{#cmdb-PUT-instance__entry-result-outbound_relations_type-cmdb}{#cmdb-PUT-instance__entry-result-outbound_relations_type_display_value-cmdb}{#cmdb-PUT-instance__entry-result-outbound_relations_type_link-cmdb}{#cmdb-PUT-instance__entry-result-outbound_relations_type_value-cmdb}{#cmdb-PUT-instance__entry-result-status-cmdb} | Nom | Description | |-|-| | attributs | Attributs de données actuellement dans l'enregistrement de CI. Les attributs disponibles dépendent de la classe spécifiée CMDB . Vous pouvez localiser les attributs disponibles dans la table associée CMDB , qui commence généralement par \<\< cmdb_ci \>\>, telle que cmdb_ci_linux_server ou cmdb_ci_mfp_printer. Type de données : objet | | erreur | Informations sur les erreurs rencontrées lors du traitement de la demande de point de terminaison. Type de données : objet "error": { "detail": "String", "message": "String" } | | error.detail | Informations supplémentaires sur l'erreur. Type de données : chaîne | | message.erreur | Message qui identifie l'erreur. Type de données : chaîne | | inbound_relations | Liste des objets qui définissent les relations entrantes associées au CI. Type de données : tableau "inbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ] | | inbound_relations.sys_id | Sys_id de la relation CI entrante. Situé dans la table Relations CI \[cmdb_rel_ci\]. Type de données : chaîne | | inbound_relations.Cible | Informations décrivant la relation entrante cible. Type de données : objet "target": { "display_value": "String", "link": "String", "value": "String" } | | inbound_relations.target.display_value | Nom de la relation entrante à afficher dans une interface utilisateur. Type de données : chaîne | | inbound_relations.target.link | CMDB URL du point de terminaison REST à utiliser pour récupérer la relation entrante à partir de la table Élément de configuration \[cmdb_ci\]. Type de données : chaîne | | inbound_relations.target.value | Sys_id du CI entrant. Situé dans la table Élément de configuration \[cmdb_ci\]. Type de données : chaîne | | inbound_relations.type | Informations sur le type de relation entrante. Type de données : objet "type": { "display_value": "String", "link": "String", "value": "String" } | | inbound_relations.type.display_value | Nom du type entrant à afficher dans une interface utilisateur. Type de données : chaîne | | inbound_relations.type.link | Table URL du point de terminaison REST à utiliser pour récupérer le type de relation entrante à partir de la table Type de relation CI \[cmdb_rel_type\]. Type de données : chaîne | | inbound_relations.type.valeur | Sys_id du type de relation entrante. Situé dans la table Type de relation CI \[cmdb_rel_type\]. Type de données : chaîne | | outbound_relations | Liste des objets qui définissent les relations sortantes associées au CI. Type de données : tableau "outbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ] | | outbound_relations.sys_id | Sys_id de la relation CI de débordement. Situé dans la table Relations CI \[cmdb_rel_ci\]. Type de données : chaîne | | outbound_relations.Cible | Requis. Informations sur la relation sortante cible. Type de données : objet "target": { "display_value": "String", "link": "String", "value": "String" } | | outbound_relations.target.display_value | Nom de la relation sortante à afficher dans une interface utilisateur. Type de données : chaîne | | outbound_relations.target.link | CMDB URL du point de terminaison REST à utiliser pour récupérer la relation sortante de la table d'éléments de configuration \[cmdb_ci\]. Type de données : chaîne | | outbound_relations.target.value | Sys_id du CI sortant. Situé dans la table Élément de configuration \[cmdb_ci\]. Type de données : chaîne | | outbound_relations.type | Informations sur le type de relation sortante. Type de données : objet "type": { "display_value": "String", "link": "String", "value": "String" } | | outbound_relations.type.display_value | Nom du type sortant à afficher dans une interface utilisateur. Type de données : chaîne | | outbound_relations.type.link | Table URL du point de terminaison REST à utiliser pour récupérer la relation sortante de la table Type de relation CI \[cmdb_rel_type\]. Type de données : chaîne | | outbound_relations.type.valeur | Sys_id du type de relation sortante. Situé dans la table Type de relation CI \[cmdb_rel_type\]. Type de données : chaîne | | statut | N'apparaît que si une erreur est rencontrée. État du traitement du point de terminaison. Valeur possible : échec Type de données : chaîne | [Tableau 33. Paramètres de réponses] {#cmdb-PUT-instance__table_ens_hq4_3mb} ### Exemple de demande cURL curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci_linux_server/70bc4e11c0a8210d01f074cbe6bd73b4" \ --request PUT \ --header "Accept:application/json" \ --header "Content-Type:application/json"\ --user "username":"password" \ --data { "attributes": { "firewall_status": "Extranet", "discovery_source": "ServiceNows", "name": "Linux299", "used_for": "Pre-production", "container": "Box" }, "source": "ServiceNow" } { "result": { "outbound_relations": [ { "sys_id": "403ff2641b425010593876a61a4bcb4b", "type": { "display_value": "Depends on::Used by", "link": "https://instance.service-now.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5", "value": "1a9cb166f1571100a92eb60da2bce5c5" }, "target": { "display_value": "PS ORA01", "link": "https://instance.service-now.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f", "value": "3a307c930a0a0bb400353965d0b8861f" } }, { "sys_id": "443ff2641b425010593876a61a4bcb4c", "type": { "display_value": "Exchanges data with::Exchanges data with", "link": "https://instance.service-now.com/api/now/table/cmdb_rel_type/607ad1b2c0a8010e01941856b365af90", "value": "607ad1b2c0a8010e01941856b365af90" }, "target": { "display_value": "PS ORA01", "link": "https://instance.service-now.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f", "value": "3a307c930a0a0bb400353965d0b8861f" } } ], "attributes": { "firewall_status": "Extranet", "os_address_width": "", "attested_date": "", "operational_status": "1", "os_service_pack": "", "cpu_core_thread": "", "cpu_manufacturer": "", "sys_updated_on": "2020-07-13 20:59:40", "discovery_source": "ServiceNow", "first_discovered": "2020-07-13 20:27:28", "due_in": "", "used_for": "Pre-production", "invoice_number": "", "gl_account": "", "sys_created_by": "dora.gray", "warranty_expiration": "", "ram": "", "cpu_name": "", "cpu_speed": "", "owned_by": "", "checked_out": "", "kernel_release": "", "sys_domain_path": "/", "classification": "Production", "disk_space": "", "object_id": "", "maintenance_schedule": "", "cost_center": "", "attested_by": "", "dns_domain": "", "assigned": "", "purchase_date": "", "life_cycle_stage": "", "short_description": "", "cd_speed": "", "floppy": "", "managed_by": "", "os_domain": "", "last_discovered": "2020-07-13 20:59:40", "can_print": "false", "sys_class_name": "cmdb_ci_linux_server", "manufacturer": "", "cpu_count": "", "vendor": "", "life_cycle_stage_status": "", "model_number": "", "assigned_to": "", "start_date": "", "os_version": "", "serial_number": "", "cd_rom": "false", "support_group": "", "unverified": "false", "correlation_id": "", "attributes": "", "asset": { "display_value": "Unknown", "link": "https://instance.service-now.com/api/now/table/alm_asset/21cfba641b425010593876a61a4bcb52", "value": "21cfba641b425010593876a61a4bcb52" }, "form_factor": "", "cpu_core_count": "", "skip_sync": "false", "attestation_score": "", "sys_updated_by": "dora.gray", "sys_created_on": "2020-07-13 20:27:28", "sys_domain": { "display_value": "global", "link": "https://instance.service-now.com/api/now/table/sys_user_group/global", "value": "global" }, "cpu_type": "", "install_date": "", "asset_tag": "", "dr_backup": "", "hardware_substatus": "", "fqdn": "", "change_control": "", "internet_facing": "true", "delivery_date": "", "hardware_status": "installed", "install_status": "1", "supported_by": "", "name": "Linux299", "subcategory": "Computer", "default_gateway": "", "chassis_type": "", "virtual": "false", "assignment_group": "", "managed_by_group": "", "sys_id": "0c3ff2641b425010593876a61a4bcb39", "po_number": "", "checked_in": "", "sys_class_path": "/!!/!2/!(/!!/!0", "mac_address": "", "company": "", "justification": "", "department": "", "cost": "", "comments": "", "os": "", "sys_mod_count": "3", "monitor": "false", "model_id": { "display_value": "Unknown", "link": "https://instance.service-now.com/api/now/table/cmdb_model/0ce0a2681b4e1010593876a61a4bcba6", "value": "0ce0a2681b4e1010593876a61a4bcba6" }, "ip_address": "", "duplicate_of": "", "sys_tags": "", "cost_cc": "USD", "order_date": "", "schedule": "", "environment": "", "due": "", "attested": "false", "location": "", "category": "Hardware", "fault_count": "0", "host_name": "", "lease_id": "" }, "inbound_relations": [ { "sys_id": "c03ff2641b425010593876a61a4bcb49", "type": { "display_value": "Depends on::Used by", "link": "https://instance.service-now.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5", "value": "1a9cb166f1571100a92eb60da2bce5c5" }, "target": { "display_value": "PS Apache01", "link": "https://instance.service-now.com/api/now/cmdb/instance/cmdb_ci/3a27d4370a0a0bb4006316812bf45439", "value": "3a27d4370a0a0bb4006316812bf45439" } } ] } } ## CMDB Instance : POST /now/cmdb/instance/{classname}/{sys_id}/relation {#ariaid-title7} Ajoute une relation entrante et/ou sortante à l'élément de configuration spécifié (CI). Le CI spécifié est le parent. ### Format d'URL {#cmdb-POST-instance-relation__section_hz1_mgs_cmb} URL versionnée : /api/now/v1/cmdb/instance/{className}/{sys_id}/relation URL par défaut : /api/now/cmdb/instance/{className}/{sys_id}/relation ### Paramètres de demande pris en charge {#cmdb-POST-instance-relation__entry__2}{#cmdb-POST-instance-relation__entry-className-cmdb}{#cmdb-POST-instance-relation__entry-sys_id-cmdb} | Nom | Description | |-|-| | Nom de classe | CMDB Nom de classe. Il s'agit du nom de la table qui contient les enregistrements CI souhaités, par exemple cmdb_ci_linux_server ou cmdb_ci_apache_web_server. Type de données : chaîne | | sys_id | Sys_id de l'enregistrement CI à mettre à jour. Type de données : chaîne | [Tableau 34. Paramètres de chemin d'accès] {#cmdb-POST-instance-relation__entry__8} | Nom | Description | |-|-| | Aucun | | [Tableau 35. Paramètres de requête] {#cmdb-POST-instance-relation__entry__12}{#cmdb-POST-instance-relation__entry-inbound_relations-cmdb}{#cmdb-POST-instance-relation__entry-inbound_relations_target-cmdb}{#cmdb-POST-instance-relation__entry-inbound_relations_type-cmdb}{#cmdb-POST-instance-relation__entry-outbound_relations-cmdb}{#cmdb-POST-instance-relation__entry-request-outbound_relations_target-cmdb}{#cmdb-POST-instance-relation__entry-request-outbound_relations_type-cmdb}{#cmdb-POST-instance-relation__entry-source-cmdb} | Nom | Description | |-|-| | inbound_relations | Liste des objets qui définissent les relations entrantes à associer au CI. Type de données : tableau "inbound_relations": [ { "target": "String", "type": "String" } ] | | inbound_relations.Cible | Requis si inbound_relations spécifié. Sys_id de la relation entrante cible à associer au CI spécifié. Situé dans la table Élément de configuration \[cmdb_ci\]. Type de données : chaîne | | inbound_relations.type | Requis si inbound_relations spécifié. Sys_id du type de relation entrante. Situé dans la table Type de relation CI \[cmdb_rel_type\]. Type de données : chaîne Type de données : chaîne | | outbound_relations | Liste des objets qui définissent les relations sortantes à associer au CI. Type de données : tableau "outbound_relations": [ { "target": "String", "type": "String" } ] | | outbound_relations.Cible | Requis si outbound_relations spécifié. Sys_id de la relation sortante cible. Situé dans la table Élément de configuration \[cmdb_ci\]. Type de données : chaîne | | outbound_relations.type | Requis si outbound_relations spécifié. Sys_id du type de relation sortante. Situé dans la table Type de relation CI \[cmdb_rel_type\]. Type de données : chaîne | | source | Requis. Entité qui a mis à jour les informations. Il doit s'agir de l'une des valeurs de choix spécifiées dans le champ discovery_source de la table Élément de configuration \[cmdb_ci\]. Type de données : chaîne | [Tableau 36. Paramètres de corps de demande (XML ou JSON)] ### En-têtes Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#cmdb-POST-instance-relation__entry__28}{#cmdb-POST-instance-relation__accept-RESTAPI}{#cmdb-POST-instance-relation__content_type-RESTAPI} | En-tête | Description | |-|-| | Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json | | Content-Type | Format de données du corps de la demande. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json | [Tableau 37. En-têtes de demandes] {#cmdb-POST-instance-relation__entry__34} | En-tête | Description | |-|-| | Aucun | | [Tableau 38. En-têtes de réponses] ### Codes d'état Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#cmdb-POST-instance-relation__entry__38}{#cmdb-POST-instance-relation__entry-200-status-code}{#cmdb-POST-instance-relation__entry-400-status-code}{#cmdb-POST-instance-relation__entry-401-status-code}{#cmdb-POST-instance-relation__entry-404-status-code}{#cmdb-POST-instance-relation__entry-405-status-code}{#cmdb-POST-instance-relation__entry-500-status-code} | Code d'état | Description | |-|-| | 200 | Réussi. La demande a été correctement traitée. | | 400 | Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté. | | 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. | | 404 | Introuvable. L'élément demandé est introuvable. | | 405 | Méthode non valide. La fonctionnalité est désactivée. | | 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. | [Tableau 39. Codes d'état] ### Paramètres du corps de réponse (JSON ou XML) {#cmdb-POST-instance-relation__table_hj2_qn4_3mb__entry__2}{#cmdb-POST-instance-relation__entry-result-error-cmdb-ph}{#cmdb-POST-instance-relation__entry-result-error_detail-cmdb}{#cmdb-POST-instance-relation__entry-result-error_message-cmdb}{#cmdb-POST-instance-relation__entry-result-inbound_relations-cmdb}{#cmdb-POST-instance-relation__entry-result-inbound_relations_sys_id-cmdb}{#cmdb-POST-instance-relation__entry-result-inbound_relations_target-cmdb}{#cmdb-POST-instance-relation__entry-result-inbound_relations_target_display_value-cmdb}{#cmdb-POST-instance-relation__entry-result-inbound_relations_target_link-cmdb}{#cmdb-POST-instance-relation__entry-result-inbound_relations_target_value-cmdb}{#cmdb-POST-instance-relation__entry-result-inbound_relations_type-cmdb}{#cmdb-POST-instance-relation__entry-result-inbound_relations_type_display_value-cmdb}{#cmdb-POST-instance-relation__entry-result-inbound_relations_type_link-cmdb}{#cmdb-POST-instance-relation__entry-result-inbound_relations_type_value-cmdb}{#cmdb-POST-instance-relation__entry-result-outbound_relations-cmdb}{#cmdb-POST-instance-relation__entry-result-outbound_relations_sys_id-cmdb}{#cmdb-POST-instance-relation__entry-result-outbound_relations_target-cmdb}{#cmdb-POST-instance-relation__entry-result-outbound_relations_target_display_value-cmdb}{#cmdb-POST-instance-relation__entry-result-outbound_relations_target_link-cmdb}{#cmdb-POST-instance-relation__entry-result-outbound_relations_target_value-cmdb}{#cmdb-POST-instance-relation__entry-result-outbound_relations_type-cmdb}{#cmdb-POST-instance-relation__entry-result-outbound_relations_type_display_value-cmdb}{#cmdb-POST-instance-relation__entry-result-outbound_relations_type_link-cmdb}{#cmdb-POST-instance-relation__entry-result-outbound_relations_type_value-cmdb}{#cmdb-POST-instance-relation__entry-result-status-cmdb} | Nom | Description | |-|-| | attributs | Attributs de données actuellement dans l'enregistrement de CI. Les attributs disponibles dépendent de la classe spécifiée CMDB . Vous pouvez localiser les attributs disponibles dans la table associée CMDB , qui commence généralement par \<\< cmdb_ci \>\>, telle que cmdb_ci_linux_server ou cmdb_ci_mfp_printer. Type de données : objet | | erreur | Informations sur les erreurs rencontrées lors du traitement de la demande de point de terminaison. Type de données : objet "error": { "detail": "String", "message": "String" } | | error.detail | Informations supplémentaires sur l'erreur. Type de données : chaîne | | message.erreur | Message qui identifie l'erreur. Type de données : chaîne | | inbound_relations | Liste des objets qui définissent les relations entrantes associées au CI. Type de données : tableau "inbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ] | | inbound_relations.sys_id | Sys_id de la relation CI entrante. Situé dans la table Relations CI \[cmdb_rel_ci\]. Type de données : chaîne | | inbound_relations.Cible | Informations décrivant la relation entrante cible. Type de données : objet "target": { "display_value": "String", "link": "String", "value": "String" } | | inbound_relations.target.display_value | Nom de la relation entrante à afficher dans une interface utilisateur. Type de données : chaîne | | inbound_relations.target.link | CMDB URL du point de terminaison REST à utiliser pour récupérer la relation entrante à partir de la table Élément de configuration \[cmdb_ci\]. Type de données : chaîne | | inbound_relations.target.value | Sys_id du CI entrant. Situé dans la table Élément de configuration \[cmdb_ci\]. Type de données : chaîne | | inbound_relations.type | Informations sur le type de relation entrante. Type de données : objet "type": { "display_value": "String", "link": "String", "value": "String" } | | inbound_relations.type.display_value | Nom du type entrant à afficher dans une interface utilisateur. Type de données : chaîne | | inbound_relations.type.link | Table URL du point de terminaison REST à utiliser pour récupérer le type de relation entrante à partir de la table Type de relation CI \[cmdb_rel_type\]. Type de données : chaîne | | inbound_relations.type.valeur | Sys_id du type de relation entrante. Situé dans la table Type de relation CI \[cmdb_rel_type\]. Type de données : chaîne | | outbound_relations | Liste des objets qui définissent les relations sortantes associées au CI. Type de données : tableau "outbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ] | | outbound_relations.sys_id | Sys_id de la relation CI de débordement. Situé dans la table Relations CI \[cmdb_rel_ci\]. Type de données : chaîne | | outbound_relations.Cible | Requis. Informations sur la relation sortante cible. Type de données : objet "target": { "display_value": "String", "link": "String", "value": "String" } | | outbound_relations.target.display_value | Nom de la relation sortante à afficher dans une interface utilisateur. Type de données : chaîne | | outbound_relations.target.link | CMDB URL du point de terminaison REST à utiliser pour récupérer la relation sortante de la table d'éléments de configuration \[cmdb_ci\]. Type de données : chaîne | | outbound_relations.target.value | Sys_id du CI sortant. Situé dans la table Élément de configuration \[cmdb_ci\]. Type de données : chaîne | | outbound_relations.type | Informations sur le type de relation sortante. Type de données : objet "type": { "display_value": "String", "link": "String", "value": "String" } | | outbound_relations.type.display_value | Nom du type sortant à afficher dans une interface utilisateur. Type de données : chaîne | | outbound_relations.type.link | Table URL du point de terminaison REST à utiliser pour récupérer la relation sortante de la table Type de relation CI \[cmdb_rel_type\]. Type de données : chaîne | | outbound_relations.type.valeur | Sys_id du type de relation sortante. Situé dans la table Type de relation CI \[cmdb_rel_type\]. Type de données : chaîne | | statut | N'apparaît que si une erreur est rencontrée. État du traitement du point de terminaison. Valeur possible : échec Type de données : chaîne | [Tableau 40. Paramètres de réponses] {#cmdb-POST-instance-relation__table_hj2_qn4_3mb} ### Exemple de demande cURL curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci_linux_server/3a290cc60a0a0bb400000bdb386af1cf/relation" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json"\ --user "username":"password" \ --data { "outbound_relations": [ { "type" : "1a9cb166f1571100a92eb60da2bce5c5", "target" : "3a307c930a0a0bb400353965d0b8861f" }, { "type" : "607ad1b2c0a8010e01941856b365af90", "target" : "3a307c930a0a0bb400353965d0b8861f" } ], "source": "ServiceNow", "inbound_relations": [ { "type" : "1a9cb166f1571100a92eb60da2bce5c5", "target" : "3a27d4370a0a0bb4006316812bf45439" } ] } { "result": { "outbound_relations": [ { "sys_id": "403ff2641b425010593876a61a4bcb4b", "type": { "display_value": "Depends on::Used by", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5", "value": "1a9cb166f1571100a92eb60da2bce5c5" }, "target": { "display_value": "PS ORA01", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f", "value": "3a307c930a0a0bb400353965d0b8861f" } }, { "sys_id": "443ff2641b425010593876a61a4bcb4c", "type": { "display_value": "Exchanges data with::Exchanges data with", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/607ad1b2c0a8010e01941856b365af90", "value": "607ad1b2c0a8010e01941856b365af90" }, "target": { "display_value": "PS ORA01", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f", "value": "3a307c930a0a0bb400353965d0b8861f" } } ], "attributes": { "firewall_status": "Active", "os_address_width": "", "attested_date": "", "operational_status": "1", "os_service_pack": "", "cpu_core_thread": "", "cpu_manufacturer": "", "sys_updated_on": "2020-07-13 21:24:05", "discovery_source": "ServiceNow", "first_discovered": "2020-07-13 20:27:28", "due_in": "", "used_for": "Production", "invoice_number": "", "gl_account": "", "sys_created_by": "dora.gray", "warranty_expiration": "", "ram": "", "cpu_name": "", "cpu_speed": "", "owned_by": "", "checked_out": "", "kernel_release": "", "sys_domain_path": "/", "classification": "Production", "disk_space": "", "object_id": "", "maintenance_schedule": "", "cost_center": "", "attested_by": "", "dns_domain": "", "assigned": "", "purchase_date": "", "life_cycle_stage": "", "short_description": "", "cd_speed": "", "floppy": "", "managed_by": "", "os_domain": "", "last_discovered": "2020-07-13 21:24:05", "can_print": "false", "sys_class_name": "cmdb_ci_linux_server", "manufacturer": "", "cpu_count": "", "vendor": "", "life_cycle_stage_status": "", "model_number": "", "assigned_to": "", "start_date": "", "os_version": "", "serial_number": "", "cd_rom": "false", "support_group": "", "unverified": "false", "correlation_id": "", "attributes": "", "asset": { "display_value": "Unknown", "link": "https://instance.servicenow.com/api/now/table/alm_asset/21cfba641b425010593876a61a4bcb52", "value": "21cfba641b425010593876a61a4bcb52" }, "form_factor": "", "cpu_core_count": "", "skip_sync": "false", "attestation_score": "", "sys_updated_by": "dora.gray", "sys_created_on": "2020-07-13 20:27:28", "sys_domain": { "display_value": "global", "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global", "value": "global" }, "cpu_type": "", "install_date": "", "asset_tag": "", "dr_backup": "", "hardware_substatus": "", "fqdn": "", "change_control": "", "internet_facing": "true", "delivery_date": "", "hardware_status": "installed", "install_status": "1", "supported_by": "", "name": "Linux299", "subcategory": "Computer", "default_gateway": "", "chassis_type": "", "virtual": "false", "assignment_group": "", "managed_by_group": "", "sys_id": "0c3ff2641b425010593876a61a4bcb39", "po_number": "", "checked_in": "", "sys_class_path": "/!!/!2/!(/!!/!0", "mac_address": "", "company": "", "justification": "", "department": "", "cost": "", "comments": "", "os": "", "sys_mod_count": "4", "monitor": "false", "model_id": { "display_value": "Unknown", "link": "https://instance.servicenow.com/api/now/table/cmdb_model/0ce0a2681b4e1010593876a61a4bcba6", "value": "0ce0a2681b4e1010593876a61a4bcba6" }, "ip_address": "", "duplicate_of": "", "sys_tags": "", "cost_cc": "USD", "order_date": "", "schedule": "", "environment": "", "due": "", "attested": "false", "location": "", "category": "Hardware", "fault_count": "0", "host_name": "", "lease_id": "" }, "inbound_relations": [ { "sys_id": "c03ff2641b425010593876a61a4bcb49", "type": { "display_value": "Depends on::Used by", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5", "value": "1a9cb166f1571100a92eb60da2bce5c5" }, "target": { "display_value": "PS Apache01", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a27d4370a0a0bb4006316812bf45439", "value": "3a27d4370a0a0bb4006316812bf45439" } } ] } } ## CMDB Instance : PATCH /now/cmdb/instance/{classname}/{sys_id} {#ariaid-title8} Remplace les attributs dans l'enregistrement d'élément de configuration (CI) spécifié par les paires nom-valeur spécifiées. Ce point de terminaison ne crée pas, ne met pas à jour ou ne supprime pas les relations associées. ### Format d'URL {#cmdb-PATCH-instance__section_w3r_dxr_cmb} URL versionnée : /api/now/v1/cmdb/instance/{className}/{sys_id} URL par défaut : /api/now/cmdb/instance/{className}/{sys_id} ### Paramètres de demande pris en charge {#cmdb-PATCH-instance__entry__2}{#cmdb-PATCH-instance__entry-className-cmdb}{#cmdb-PATCH-instance__entry-sys_id-cmdb} | Nom | Description | |-|-| | Nom de classe | CMDB Nom de classe. Il s'agit du nom de la table qui contient les enregistrements CI souhaités, par exemple cmdb_ci_linux_server ou cmdb_ci_apache_web_server. Type de données : chaîne | | sys_id | Sys_id de l'enregistrement CI à mettre à jour. Type de données : chaîne | [Tableau 41. Paramètres de chemin d'accès] {#cmdb-PATCH-instance__entry__8} | Nom | Description | |-|-| | Aucun | | [Tableau 42. Paramètres de requête] {#cmdb-PATCH-instance__entry__12}{#cmdb-PATCH-instance__entry-attributes-cmdb}{#cmdb-PATCH-instance__entry-source-cmdb} | Nom | Description | |-|-| | attributs | Attributs de données à remplacer dans l'enregistrement CI. Les attributs disponibles dépendent de la classe spécifiée CMDB . Vous pouvez localiser les attributs disponibles dans la table associée CMDB , qui commence généralement par \<\< cmdb_ci \>\>, telle que cmdb_ci_linux_server ou cmdb_ci_mfp_printer. Type de données : objet | | source | Requis. Entité qui a mis à jour les informations. Il doit s'agir de l'une des valeurs de choix spécifiées dans le champ discovery_source de la table Élément de configuration \[cmdb_ci\]. Type de données : chaîne | [Tableau 43. Paramètres de corps de demande (XML ou JSON)] ### En-têtes Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#cmdb-PATCH-instance__entry__18}{#cmdb-PATCH-instance__accept-RESTAPI}{#cmdb-PATCH-instance__content_type-RESTAPI} | En-tête | Description | |-|-| | Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json | | Content-Type | Format de données du corps de la demande. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json | [Tableau 44. En-têtes de demandes] {#cmdb-PATCH-instance__entry__24} | En-tête | Description | |-|-| | Aucun | | [Tableau 45. En-têtes de réponses] ### Codes d'état Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#cmdb-PATCH-instance__entry__28}{#cmdb-PATCH-instance__entry-200-status-code}{#cmdb-PATCH-instance__entry-400-status-code}{#cmdb-PATCH-instance__entry-401-status-code}{#cmdb-PATCH-instance__entry-404-status-code}{#cmdb-PATCH-instance__entry-405-status-code}{#cmdb-PATCH-instance__entry-500-status-code} | Code d'état | Description | |-|-| | 200 | Réussi. La demande a été correctement traitée. | | 400 | Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté. | | 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. | | 404 | Introuvable. L'élément demandé est introuvable. | | 405 | Méthode non valide. La fonctionnalité est désactivée. | | 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. | [Tableau 46. Codes d'état] ### Paramètres du corps de réponse (JSON ou XML) {#cmdb-PATCH-instance__table_ojn_3n4_3mb__entry__2}{#cmdb-PATCH-instance__entry-result-error-cmdb-ph}{#cmdb-PATCH-instance__entry-result-error_detail-cmdb}{#cmdb-PATCH-instance__entry-result-error_message-cmdb}{#cmdb-PATCH-instance__entry-result-inbound_relations-cmdb}{#cmdb-PATCH-instance__entry-result-inbound_relations_sys_id-cmdb}{#cmdb-PATCH-instance__entry-result-inbound_relations_target-cmdb}{#cmdb-PATCH-instance__entry-result-inbound_relations_target_display_value-cmdb}{#cmdb-PATCH-instance__entry-result-inbound_relations_target_link-cmdb}{#cmdb-PATCH-instance__entry-result-inbound_relations_target_value-cmdb}{#cmdb-PATCH-instance__entry-result-inbound_relations_type-cmdb}{#cmdb-PATCH-instance__entry-result-inbound_relations_type_display_value-cmdb}{#cmdb-PATCH-instance__entry-result-inbound_relations_type_link-cmdb}{#cmdb-PATCH-instance__entry-result-inbound_relations_type_value-cmdb}{#cmdb-PATCH-instance__entry-result-outbound_relations-cmdb}{#cmdb-PATCH-instance__entry-result-outbound_relations_sys_id-cmdb}{#cmdb-PATCH-instance__entry-result-outbound_relations_target-cmdb}{#cmdb-PATCH-instance__entry-result-outbound_relations_target_display_value-cmdb}{#cmdb-PATCH-instance__entry-result-outbound_relations_target_link-cmdb}{#cmdb-PATCH-instance__entry-result-outbound_relations_target_value-cmdb}{#cmdb-PATCH-instance__entry-result-outbound_relations_type-cmdb}{#cmdb-PATCH-instance__entry-result-outbound_relations_type_display_value-cmdb}{#cmdb-PATCH-instance__entry-result-outbound_relations_type_link-cmdb}{#cmdb-PATCH-instance__entry-result-outbound_relations_type_value-cmdb}{#cmdb-PATCH-instance__entry-result-status-cmdb} | Nom | Description | |-|-| | attributs | Attributs de données actuellement dans l'enregistrement de CI. Les attributs disponibles dépendent de la classe spécifiée CMDB . Vous pouvez localiser les attributs disponibles dans la table associée CMDB , qui commence généralement par \<\< cmdb_ci \>\>, telle que cmdb_ci_linux_server ou cmdb_ci_mfp_printer. Type de données : objet | | erreur | Informations sur les erreurs rencontrées lors du traitement de la demande de point de terminaison. Type de données : objet "error": { "detail": "String", "message": "String" } | | error.detail | Informations supplémentaires sur l'erreur. Type de données : chaîne | | message.erreur | Message qui identifie l'erreur. Type de données : chaîne | | inbound_relations | Liste des objets qui définissent les relations entrantes associées au CI. Type de données : tableau "inbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ] | | inbound_relations.sys_id | Sys_id de la relation CI entrante. Situé dans la table Relations CI \[cmdb_rel_ci\]. Type de données : chaîne | | inbound_relations.Cible | Informations décrivant la relation entrante cible. Type de données : objet "target": { "display_value": "String", "link": "String", "value": "String" } | | inbound_relations.target.display_value | Nom de la relation entrante à afficher dans une interface utilisateur. Type de données : chaîne | | inbound_relations.target.link | CMDB URL du point de terminaison REST à utiliser pour récupérer la relation entrante à partir de la table Élément de configuration \[cmdb_ci\]. Type de données : chaîne | | inbound_relations.target.value | Sys_id du CI entrant. Situé dans la table Élément de configuration \[cmdb_ci\]. Type de données : chaîne | | inbound_relations.type | Informations sur le type de relation entrante. Type de données : objet "type": { "display_value": "String", "link": "String", "value": "String" } | | inbound_relations.type.display_value | Nom du type entrant à afficher dans une interface utilisateur. Type de données : chaîne | | inbound_relations.type.link | Table URL du point de terminaison REST à utiliser pour récupérer le type de relation entrante à partir de la table Type de relation CI \[cmdb_rel_type\]. Type de données : chaîne | | inbound_relations.type.valeur | Sys_id du type de relation entrante. Situé dans la table Type de relation CI \[cmdb_rel_type\]. Type de données : chaîne | | outbound_relations | Liste des objets qui définissent les relations sortantes associées au CI. Type de données : tableau "outbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ] | | outbound_relations.sys_id | Sys_id de la relation CI de débordement. Situé dans la table Relations CI \[cmdb_rel_ci\]. Type de données : chaîne | | outbound_relations.Cible | Requis. Informations sur la relation sortante cible. Type de données : objet "target": { "display_value": "String", "link": "String", "value": "String" } | | outbound_relations.target.display_value | Nom de la relation sortante à afficher dans une interface utilisateur. Type de données : chaîne | | outbound_relations.target.link | CMDB URL du point de terminaison REST à utiliser pour récupérer la relation sortante de la table d'éléments de configuration \[cmdb_ci\]. Type de données : chaîne | | outbound_relations.target.value | Sys_id du CI sortant. Situé dans la table Élément de configuration \[cmdb_ci\]. Type de données : chaîne | | outbound_relations.type | Informations sur le type de relation sortante. Type de données : objet "type": { "display_value": "String", "link": "String", "value": "String" } | | outbound_relations.type.display_value | Nom du type sortant à afficher dans une interface utilisateur. Type de données : chaîne | | outbound_relations.type.link | Table URL du point de terminaison REST à utiliser pour récupérer la relation sortante de la table Type de relation CI \[cmdb_rel_type\]. Type de données : chaîne | | outbound_relations.type.valeur | Sys_id du type de relation sortante. Situé dans la table Type de relation CI \[cmdb_rel_type\]. Type de données : chaîne | | statut | N'apparaît que si une erreur est rencontrée. État du traitement du point de terminaison. Valeur possible : échec Type de données : chaîne | [Tableau 47. Paramètres de réponses] {#cmdb-PATCH-instance__table_ojn_3n4_3mb} ### Exemple de demande cURL curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_class_sw/70bc4e11c0a8210d01f074cbe6bd73b4" \ --request PATCH \ --header "Accept:application/json" \ --header "Content-Type:application/json"\ --user "username":"password"\ --data { "attributes": { "firewall_status": "Active", "name": "Linux299", "used_for": "Production" }, "source": "ServiceNow" } { "result": { "outbound_relations": [ { "sys_id": "403ff2641b425010593876a61a4bcb4b", "type": { "display_value": "Depends on::Used by", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5", "value": "1a9cb166f1571100a92eb60da2bce5c5" }, "target": { "display_value": "PS ORA01", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f", "value": "3a307c930a0a0bb400353965d0b8861f" } }, { "sys_id": "443ff2641b425010593876a61a4bcb4c", "type": { "display_value": "Exchanges data with::Exchanges data with", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/607ad1b2c0a8010e01941856b365af90", "value": "607ad1b2c0a8010e01941856b365af90" }, "target": { "display_value": "PS ORA01", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f", "value": "3a307c930a0a0bb400353965d0b8861f" } } ], "attributes": { "firewall_status": "Active", "os_address_width": "", "attested_date": "", "operational_status": "1", "os_service_pack": "", "cpu_core_thread": "", "cpu_manufacturer": "", "sys_updated_on": "2020-07-13 21:24:05", "discovery_source": "ServiceNow", "first_discovered": "2020-07-13 20:27:28", "due_in": "", "used_for": "Production", "invoice_number": "", "gl_account": "", "sys_created_by": "dora.gray", "warranty_expiration": "", "ram": "", "cpu_name": "", "cpu_speed": "", "owned_by": "", "checked_out": "", "kernel_release": "", "sys_domain_path": "/", "classification": "Production", "disk_space": "", "object_id": "", "maintenance_schedule": "", "cost_center": "", "attested_by": "", "dns_domain": "", "assigned": "", "purchase_date": "", "life_cycle_stage": "", "short_description": "", "cd_speed": "", "floppy": "", "managed_by": "", "os_domain": "", "last_discovered": "2020-07-13 21:24:05", "can_print": "false", "sys_class_name": "cmdb_ci_linux_server", "manufacturer": "", "cpu_count": "", "vendor": "", "life_cycle_stage_status": "", "model_number": "", "assigned_to": "", "start_date": "", "os_version": "", "serial_number": "", "cd_rom": "false", "support_group": "", "unverified": "false", "correlation_id": "", "attributes": "", "asset": { "display_value": "Unknown", "link": "https://instance.servicenow.com/api/now/table/alm_asset/21cfba641b425010593876a61a4bcb52", "value": "21cfba641b425010593876a61a4bcb52" }, "form_factor": "", "cpu_core_count": "", "skip_sync": "false", "attestation_score": "", "sys_updated_by": "dora.gray", "sys_created_on": "2020-07-13 20:27:28", "sys_domain": { "display_value": "global", "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global", "value": "global" }, "cpu_type": "", "install_date": "", "asset_tag": "", "dr_backup": "", "hardware_substatus": "", "fqdn": "", "change_control": "", "internet_facing": "true", "delivery_date": "", "hardware_status": "installed", "install_status": "1", "supported_by": "", "name": "Linux299", "subcategory": "Computer", "default_gateway": "", "chassis_type": "", "virtual": "false", "assignment_group": "", "managed_by_group": "", "sys_id": "0c3ff2641b425010593876a61a4bcb39", "po_number": "", "checked_in": "", "sys_class_path": "/!!/!2/!(/!!/!0", "mac_address": "", "company": "", "justification": "", "department": "", "cost": "", "comments": "", "os": "", "sys_mod_count": "4", "monitor": "false", "model_id": { "display_value": "Unknown", "link": "https://instance.servicenow.com/api/now/table/cmdb_model/0ce0a2681b4e1010593876a61a4bcba6", "value": "0ce0a2681b4e1010593876a61a4bcba6" }, "ip_address": "", "duplicate_of": "", "sys_tags": "", "cost_cc": "USD", "order_date": "", "schedule": "", "environment": "", "due": "", "attested": "false", "location": "", "category": "Hardware", "fault_count": "0", "host_name": "", "lease_id": "" }, "inbound_relations": [ { "sys_id": "c03ff2641b425010593876a61a4bcb49", "type": { "display_value": "Depends on::Used by", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5", "value": "1a9cb166f1571100a92eb60da2bce5c5" }, "target": { "display_value": "PS Apache01", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a27d4370a0a0bb4006316812bf45439", "value": "3a27d4370a0a0bb4006316812bf45439" } } ] } }