NinjaOne ITAM : Utiliser des scripts API pour accéder aux champs des ressources de base

Sujet

Cet article explique comment mettre à jour des champs spécifiques des ressources à l'aide de l'interface de ligne de commande (CLI) et de l'interface de programmation d'applications (API) de NinjaOne. 

Environnement

• Gestion des actifs informatiques (ITAM) NinjaOne
• API publique NinjaOne
• Gestion des terminaux NinjaOne

Description

Vous pouvez interagir avec les champs principaux des actifs via l'API en utilisant les points de terminaison des champs personnalisés et leurs noms internes. De plus, vous pouvez utiliser l'interface CLI de NinjaOne pour récupérer et mettre à jour l'ID de l'actif et son numéro de série. 

Sélectionnez une catégorie pour en savoir plus : 

• Mettre à jour les champs principaux des actifs avec l'interface CLI
• Mettre à jour les champs principaux des actifs avec l'API
  • Récupérer les valeurs des champs
  • Définir les valeurs des champs
• Ressources supplémentaires

Mettre à jour les champs principaux des ressources à l'aide de l'interface CLI

Pour interagir avec les champs principaux des ressources via l'interface CLI, vous devez utiliser les noms de champs internes suivants : 

Le bloc de code suivant fournit un exemple illustrant comment 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

Mettre à jour les champs principaux des actifs via l'API

Vous pouvez utiliser l'API publique de NinjaOne pour interagir avec les champs principaux des actifs en utilisant les points de terminaison des champs personnalisés et leurs noms internes : 

Récupération des valeurs de champ

Le bloc de code de commande suivant fournit un exemple illustrant comment 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, itamAssetSerialNumber

itamAssetId               : UpdateAssetID
itamAssetStatus           : En cours d'utilisation
itamAssetPurchaseDate     : 1759316400000
itamAssetPurchaseAmount   : 1000
itamAssetExpectedLifetime : 2 ans
itamAssetEndOfLifeDate    : 1822388400000
itamAssetSerialNumber     : UpdateSerialNumber

Définir les valeurs des champs

Les champs de date doivent être renseignés avec un horodatage UTC en millisecondes. La durée de vie prévue doit être saisie en minuscules.

Le bloc de code de commande suivant fournit 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-Json

Ressources supplémentaires

Consultez les ressources suivantes pour en savoir plus sur la gestion des actifs dans NinjaOne :

• Gestion des actifs informatiques NinjaOne : Catalogue de ressources
• Utilisation des appareils non gérés dans NinjaOne (ITAM)
• Opérations de l'API publique NinjaOne
• Utilisation de l'interface de ligne de commande (CLI) dans NinjaOne