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
- Gestione delle risorse IT (ITAM) NinjaOne
- API pubblica di NinjaOne
- Gestione degli endpoint NinjaOne
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 dell'asset e il numero di serie dell'asset.
Selezionate una categoria per saperne di più:
- Aggiornare i campi delle risorse principali con la CLI
- Aggiornare i campi delle risorse principali con l'API
- Risorse aggiuntive
Aggiornare i campi delle risorse principali con la CLI
Per interagire con i campi delle risorse principali tramite la CLI, è necessario utilizzare i seguenti nomi di campo interni:
| Nome del campo dell'asset | Nome del campo interno |
|---|---|
| ID risorsa | itamAssetID |
| Numero di serie del bene | itamAssetSerialNumber |
Il seguente blocco di codice fornisce un esempio di come si può 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
Aggiornare i 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:
| Nome del campo dell'asset | Nome del campo interno |
|---|---|
| ID risorsa | itamAssetId |
| Stato risorsa | itamAssetStatus |
| Data di acquisto | itamAssetData di acquisto |
| Importo dell'acquisto | itamAssetImporto d'acquisto |
| Durata prevista | itamAssetDurata prevista |
| Data di fine vita | itamAssetEndOfLifeDate |
| Numeri di serie delle risorse | itamAssetSerialNumber |
Recuperare i valori dei campi
Il seguente blocco di codice di comando fornisce un esempio di come si possono 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, itamAssetSerialNumberitamAssetId : UpdateAssetIDitamAssetStatus : In useitamAssetPurchaseDate : 1759316400000itamAssetPurchaseAmount : 1000itamAssetExpectedLifetime : 2 yearsitamAssetEndOfLifeDate : 1822388400000itamAssetSerialNumber : UpdateSerialNumber
Impostare i valori dei campi
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 si possono 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-JsonRisorse aggiuntive
Per saperne di più sulla gestione delle risorse in NinjaOne, consultate le seguenti risorse: