Contenu
Cet article explique comment mettre à jour des champs spécifiques de l'actif en utilisant l'interface de ligne de commande (CLI) et l'interface de programmation d'application (API) de NinjaOne.
Environnement
- NinjaOne IT Asset Management (ITAM)
- API publique de NinjaOne
- NinjaOne Endpoint Management
Description
Vous pouvez interagir avec les champs de l'actif central via l'API en utilisant les points de terminaison des champs personnalisés et leurs noms internes. En outre, vous pouvez utiliser l'interface CLI de NinjaOne pour récupérer et mettre à jour l'ID et le numéro de série de l'actif.
Sélectionnez une catégorie pour en savoir plus :
- Mise à jour des champs de l'actif de base avec l'interface de programmation
- Mise à jour des champs de l'actif principal avec l'API
- Ressources supplémentaires
Mise à jour des champs de l'actif de base avec l'interface de programmation
Pour interagir avec les champs de la ressource principale via l'interface de gestion, vous devez utiliser les noms de champs internes suivants :
| Nom du champ de l'actif | Nom du champ interne |
|---|---|
| ID de l'actif | itamAssetID |
| Numéro de série de l'actif | itamAssetSerialNumber (numéro de série de l'actif) |
Le bloc de code suivant donne un exemple de la manière dont vous pouvez interagir avec les champs :
ninja-Property-get itamAssetID
ExampleAsset-001
ninja-Property-get itamAssetSerialNumber
1234567890
ninja-Property-set itamAssetID UpdatedAssetID
ninja-Property-set itamAssetSerialNumber UpdatedSerialNumber
Mise à jour des champs de l'actif principal avec l'API
Vous pouvez utiliser l'API publique de NinjaOne pour interagir avec les champs de l'actif principal en utilisant les points de terminaison des champs personnalisés et leurs noms internes :
| Nom du champ de l'actif | Nom du champ interne |
|---|---|
| ID de l'actif | itamAssetId |
| Statut de l'actif | itamAssetStatus |
| Date de l'achat | itamAssetPurchaseDate |
| Montant de l'achat | itamAssetPurchaseAmount |
| Durée de vie prévue | itamAssetExpectedLifetime (durée de vie prévue de l'actif) |
| Date de fin de vie | itamAssetEndOfLifeDate |
| Numéros de série des actifs | itamAssetSerialNumber (numéro de série de l'actif) |
Récupérer les valeurs des champs
Le bloc de code de commande suivant donne un exemple de la manière dont vous pouvez récupérer les valeurs des champs :
$Fields = (Invoke-WebRequest -uri "$($NinjaURL)/v2/device/21/custom-fields" -Method Get -Headers $AuthHeader -ContentType 'application/json').Content | ConvertFrom-Json$Fields | Select itamAssetId, itamAssetStatus, itamAssetPurchaseDate, itamAssetPurchaseAmount, itamAssetExpectedLifetime, itamAssetEndOfLifeDate, itamAssetSerialNumberitamAssetId : UpdateAssetIDitamAssetStatus : In useitamAssetPurchaseDate : 1759316400000itamAssetPurchaseAmount : 1000itamAssetExpectedLifetime : 2 yearsitamAssetEndOfLifeDate : 1822388400000itamAssetSerialNumber : UpdateSerialNumber
Définir les valeurs des champs
Les champs de type date nécessitent un horodatage UTC en millisecondes. La durée de vie prévue doit être indiquée en lettres minuscules.
Le bloc de code de commande suivant donne un exemple de la manière dont vous pouvez définir les valeurs des champs :
$AssetFields = @{ itamAssetId = 'UpdatedViaAPIID' itamAssetStatus = 'Provisioning' itamAssetPurchaseDate = 1759316400000 itamAssetPurchaseAmount = '1500' itamAssetExpectedLifetime = '3 years' itamAssetEndOfLifeDate = 1822388400000 itamAssetSerialNumber = 'UpdatedViaAPISerial'} | ConvertTo-Json$Fields = (Invoke-WebRequest -uri "$($NinjaURL)/v2/device/21/custom-fields" -Method PATCH -Headers $AuthHeader -Body $AssetFields -ContentType 'application/json').Content | ConvertFrom-JsonRessources supplémentaires
Consultez les ressources suivantes pour en savoir plus sur la gestion des actifs dans NinjaOne :