Utiliser les API des services d’application
Les services d’application fournissent des API qui vous permettent d’effectuer des opérations telles que la création et la mise à jour d’un instance de service, le remplissage de CI à partir du CMDB, et la récupération des détails d’un instance de service.
Rôle requis : app_service_admin
Une instance de service est un ensemble d'applications interconnectées et d'hôtes qui sont configurés pour offrir un service à l'organisation. Les instances de service peuvent être internes, comme les services de messagerie d'entreprise, ou destinés aux clients, comme un site Web d'organisation.Créer un service d'application
Utilisation de l’API REST createOrUpdateService - POST pour créer un instance de service adapté à votre organisation si celui-ci ServiceNow CMDB contient déjà les CI composant le service. En règle générale, c’est le cas lorsque vous avez ajouté manuellement des CI directement dans le CMDB, ou que vous avez utilisé l’application Découverte pour détecter des CI et stocker des informations à leur sujet dans le CMDB. Vous pouvez également utiliser cette API pour créer un instance de service conteneur de CI détectés à l’aide de non-applicationsServiceNow .
Par défaut, lors de la instance de service création, toutes les connexions de CI sont de type Depends on::Used by relation. Vous pouvez modifier ce type par défaut en modifiant la valeur de la propriété sa.it_service.manual_ci_rel_type .
- La CMDB contient tous les CI qui composent le service d’application.
- Vous disposez des sys_id de chaque CI compris dans le service d’application que vous souhaitez créer.
- Vous comprenez la hiérarchie que forment les CI.
La table Service d’application mappé [cmdb_ci_service_discovered] contient tous les services y compris que instance de service vous créez à l’aide des API.
Vous pouvez également créer manuellement un à l’aide de instance de service l’interface utilisateur, comme décrit dans .Créer une instance de service (service d’application)
Récupérer du contenu à partir d’un service d’application
Utilisez l’API getContent - GET REST pour récupérer une liste des CI et des relations entre eux, pour un service d’application qui a été créé manuellement.
API supplémentaires
addCI() : Ajouter un CI à un instance de service fichier .
Pour connaître les restrictions sur l’ajout des CI et d’autres détails sur l’ajout d’un CI à un , reportez-vous à la instance de service section Ajouter manuellement des CI à un service d’application.
addManualConnection() : ajouter une connexion créée manuellement à un service d’application.
migrateManualToApplicationService() : convertir un service manuel en service d’application.
populateApplicationService() : renseigner un service d’application avec des CI et des relations à partir du point d’entrée désigné.
removeCI() : supprimer un CI créé manuellement d’un service d’application.
removeManualConnection() : supprimer une connexion créée manuellement et le CI connecté d’un service d’application.