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 dell'applicazione (API) di NinjaOne. 

Ambiente

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

Descrizione

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

Selezionare una categoria per ulteriori informazioni: 

• Aggiornamento dei campi delle risorse principali con CLI
• Aggiornamento dei campi delle risorse principali con l'API
  • Recupera i valori dei campi
  • Imposta i valori dei campi
• Risorse aggiuntive

Aggiornamento dei campi delle risorse principali con CLI

Per interagire con i campi delle risorse principali tramite la CLI, è necessario utilizzare i seguenti nomi di campi 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 delle risorse principali con l'API

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

Recupera valori dei campi

Il seguente blocco di codice di comando 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
$Fields | Select itamAssetId, itamAssetStatus, itamAssetPurchaseDate, itamAssetPurchaseAmount, itamAssetExpectedLifetime, itamAssetEndOfLifeDate, itamAssetSerialNumber

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

Imposta valori campo

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

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

$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

Risorse aggiuntive

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

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