REST API - Modifier un CI
Sommaire
PUT /configuration-items/{ci_id}
- Cette méthode permet de modifier un élément de configuration (CI) déterminé.
exemple /configuration-items/9479
Remarques
voir Conventions de l'API REST Service Manager
- Vous devez fournir un tableau au format JSON dans le corps de la requête HTTP.
- En cas de succès, un code de statut HTTP 201 est retourné et un lien URL (HREF) vers la ressource modifiée est fourni.
CommonNotes_JSONandFields
Format JSON / Format des champs :
- Les noms de champs sont ceux du modèle de données Service Manager.
exemple available_field_1
- Pour mettre à jour un champ, respectez le format JSON suivant : "field_name":"value".
- Les noms d’objets JSON, y compris ceux représentant les champs de la base Service Manager, ne sont pas sensibles à la casse.
exemple field_name, Field_Name et FIELD_NAME sont équivalents
Liste des paramètres / champs
Paramètres obligatoires
- Dans l’URL, vous devez utiliser le paramètre ci-dessous.
- Dans le corps de la requête HTTP, vous devez utiliser au moins l'un des champs optionnels. Sinon une erreur est retournée.
| Paramètre | Type | Description / Exemple |
|---|---|---|
| ci_id | integer | Identifiant du CI |
Paramètres optionnels
Aucun
Champs optionnels
- Dans le corps de la requête HTTP, vous pouvez utiliser tous les champs de la table AM_ASSET.
- En plus des champs fournis par EasyVista, vous pouvez aussi affecter des valeurs aux champs que vous avez ajoutés dans la base Service Manager. Il s’agit des champs préfixés par e_.
exemple e_field_name_xyz
Codes de statut HTTP de la méthode
StatusHeader
Note : Un code erreur Timeout est renvoyé et la méthode échoue si le serveur ne répond pas à la requête du web service REST au bout d'un certain temps (par défaut, 60 secondes).
| Code | Erreur | Description |
|---|
Status201
| 201 | Created (Créé) | Requête traitée avec succès et création d’un élément. |
Status401
| 401 | Unauthorized (Non autorisé) | Processus d'authentification pour accéder à la ressource incorrect : Login/Mot de passe incorrect, Session non valide, Compte Service Manager incorrect.
exemple { "error": "Invalid Login / Password" } |
Status405
| 405 | Method not allowed (Méthode non autorisée) | Méthode de requête non autorisée : non supportée ou pas appropriée pour la ressource.
exemple { "error": "Invalid input parameter" } |
Exemples
Exemple de corps de requête HTTP
{
"asset_label": "New CI via REST API - Updated",
"purchase_price": "2 000,00",
"automatic_renewal": "",
"estimated_percentage_use": "90",
"installation_date": "21/05/2019",
"available_field_1": "Available for custom use - Updated",
"comment_asset": "You can even update the comment update"
}
"asset_label": "New CI via REST API - Updated",
"purchase_price": "2 000,00",
"automatic_renewal": "",
"estimated_percentage_use": "90",
"installation_date": "21/05/2019",
"available_field_1": "Available for custom use - Updated",
"comment_asset": "You can even update the comment update"
}
Résultat avec un code de statut retourné 201
{
"HREF": "https://{your_server}/api/v1/{your_account}/configuration-items/9504"
}
"HREF": "https://{your_server}/api/v1/{your_account}/configuration-items/9504"
}
ConventionsAPI
Conventions de l'API REST
| Convention | Signification | |
|---|---|---|
| Orange | Paramètres utilisés dans la chaîne d’une requête HTTP et qui ne correspondent pas à des champs de la base Service Manager.
exemple Méthode Voir une liste de biens https://{your_server}/api/v1/{your_account}/assets?max_rows=3&fields=asset_tag |
|
| Noir et Gras | Paramètres utilisés dans l’URL d’une requête HTTP et qui correspondent à des champs de la base Service Manager.
exemple Méthode Voir un bien https://{your_server}/api/v1/{your_account}/assets/{asset_id} |
|
| Vert | Paramètres utilisés dans le corps d’une requête HTTP et qui représentent des noms d’objets JSON correspondant à des champs de la base Service Manager ; ils permettent d’affecter ou de modifier une valeur de champ dans la base.
exemple Méthode Terminer un ticket { "closed": { "end_date": "11/20/2016 12:12:12", } } |
|
| Paramètres utilisés dans le corps d’une requête HTTP et qui représentent des noms d’objets JSON ne correspondant pas à des champs de la base Service Manager.
exemple Méthode Reprendre un ticket { "restarted": { "comment": "string (required)" } } |
||