NinjaOne ITAM: Usare gli script API per accedere ai campi delle risorse principali

Argomento

Questo articolo spiega come aggiornare campi specifici delle risorse utilizzando l'interfaccia della riga di comando (CLI) e l'interfaccia di programmazione delle applicazioni (API) di NinjaOne. 

Ambiente

• NinjaOne IT Asset Management (ITAM)
• API pubblica di NinjaOne
• NinjaOne Endpoint management

Descrizione

È possibile interagire con i campi principali delle risorse tramite l'API utilizzando gli endpoint dei campi personalizzati e i relativi nomi interni. Inoltre, è possibile utilizzare la CLI di NinjaOne per recuperare e aggiornare l'ID della risorsa e il numero di serie della risorsa. 

Selezionare una categoria per ulteriori informazioni: 

• Aggiornamento dei campi principali delle risorse con la CLI
• Aggiornamento dei campi principali delle risorse tramite API
  • Recupero dei valori dei campi
  • Imposta i valori dei campi
• Risorse aggiuntive

Aggiornamento dei campi principali delle risorse tramite CLI

Per interagire con i campi principali delle risorse tramite la CLI, è necessario utilizzare i seguenti nomi di campo interni: 

Il seguente blocco di codice fornisce un esempio di come è possibile interagire con i campi: 

ninja-Property-get itamAssetID
ExampleAsset-001

ninja-Property-get itamAssetSerialNumber
1234567890

ninja-Property-set itamAssetID UpdatedAssetID

ninja-Property-set itamAssetSerialNumber UpdatedSerialNumber

Aggiornamento dei campi principali delle risorse tramite API

È possibile utilizzare l’API pubblica di NinjaOne per interagire con i campi principali delle risorse utilizzando gli endpoint dei campi personalizzati e i relativi nomi interni: 

Recupero dei valori dei campi

Il seguente blocco di codice fornisce un esempio di come è possibile recuperare i valori dei campi: 

$Fields = (Invoke-WebRequest -uri "$($NinjaURL)/v2/device/21/custom-fields" -Method Get -Headers $AuthHeader -ContentType 'application/json').Content | ConvertFrom-Json
$Campi | Seleziona itamAssetId, itamAssetStatus, itamAssetPurchaseDate, itamAssetPurchaseAmount, itamAssetExpectedLifetime, itamAssetEndOfLifeDate, itamAssetSerialNumber

itamAssetId               : UpdateAssetID
itamAssetStatus           : In uso
itamAssetPurchaseDate     : 1759316400000
itamAssetPurchaseAmount   : 1000
itamAssetExpectedLifetime : 2 anni
itamAssetEndOfLifeDate    : 1822388400000
itamAssetSerialNumber     : UpdateSerialNumber

Impostazione dei valori dei campi

I campi data richiedono un timestamp UTC espresso in millisecondi. La durata prevista deve essere inserita utilizzando lettere minuscole.

Il seguente blocco di codice fornisce un esempio di come è possibile impostare i valori dei campi: 

$AssetFields = @{
    itamAssetId = 'UpdatedViaAPIID'
    itamAssetStatus = 'Provisioning'
    itamAssetPurchaseDate = 1759316400000
    itamAssetPurchaseAmount = '1500'
    itamAssetExpectedLifetime = '3 anni'
    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

Risorse aggiuntive

Per ulteriori informazioni sulla gestione delle risorse in NinjaOne, consultare le seguenti risorse:

• Gestione delle risorse IT in NinjaOne: Catalogo delle risorse
• Utilizzo dei dispositivi non gestiti in NinjaOne (ITAM)
• Operazioni API pubbliche di NinjaOne
• Uso dell'interfaccia a riga di comando (CLI) in NinjaOne