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

Sujet

Cet article explique comment mettre à jour certains champs d'un élément à l'aide de l'interface de ligne de commande (CLI) et de l'interface de programmation d'application (API) de NinjaOne. 

Environnement

• Gestion des actifs informatiques (ITAM) de 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 d'actif et le numéro de série de l'actif. 

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

• Mettre à jour les champs principaux des actifs à l'aide de la CLI
• Mettre à jour les champs principaux des actifs via l'API
  • Récupérer les valeurs des champs
  • Définir les valeurs des champs
• Ressources supplémentaires

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

Pour interagir avec les champs principaux des ressources via l’interface de ligne de commande (CLI), vous devez utiliser les noms de champs internes suivants : 

Le bloc de code suivant fournit un exemple illustrant comment interagir avec ces 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 principaux des actifs via l'API

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

Récupération des valeurs des champs

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 contenir 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 illustrant comment 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