Tema
Este artículo explica cómo actualizar campos específicos de activos utilizando la Interfaz de Línea de Comandos (CLI) y la Interfaz de Programación de Aplicaciones (API) de NinjaOne.
Entorno
- NinjaOne Gestión de Activos de TI (ITAM)
- API pública de NinjaOne
- Gestión de puntos finales NinjaOne
Descripción
Puede interactuar con los campos de activos principales a través de la API utilizando los puntos finales de campo personalizados y sus nombres internos. Además, puede utilizar NinjaOne CLI para obtener y actualizar el ID del activo y el número de serie del activo.
Seleccione una categoría para obtener más información:
- Actualizar campos de activos principales con CLI
- Actualizar campos de activos principales con API
- Recursos adicionales
Actualizar campos de activos principales con CLI
Para interactuar con los campos de activos principales a través de la CLI, debe utilizar los siguientes nombres de campo internos:
| Nombre del campo de activos | Nombre del campo interno |
|---|---|
| Identificación de activos | itamAssetID |
| Número de serie del activo | itamNúmeroSerie |
El siguiente bloque de código proporciona un ejemplo de cómo se puede interactuar con los campos:
ninja-Property-get itamAssetID
ExampleAsset-001
ninja-Property-get itamAssetSerialNumber
1234567890
ninja-Property-set itamAssetID UpdatedAssetID
ninja-Property-set itamAssetSerialNumber UpdatedSerialNumber
Actualizar campos de activos principales con API
Puede utilizar la API pública de NinjaOne para interactuar con los campos de activos principales utilizando los puntos finales de campo personalizados y sus nombres internos:
| Nombre del campo de activos | Nombre del campo interno |
|---|---|
| Identificación de activos | itamAssetId |
| Estado de los activos | itamAssetStatus |
| Fecha de compra | itamFechaDeCompra |
| Importe de la compra | itamImporteDeCompra |
| Vida útil prevista | itamAssetExpectedLifetime |
| Fecha de fin de vida útil | itamFechaFinDeVida |
| Número de serie del activo | itamNúmeroSerie |
Obtener valores de campo
El siguiente bloque de código de comando proporciona un ejemplo de cómo puede obtener valores de campo:
$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
Establecer valores de campo
Los campos de fecha requieren una marca de tiempo UTC en milisegundos. La duración prevista debe introducirse en minúsculas.
El siguiente bloque de código de comando proporciona un ejemplo de cómo puede establecer valores de campo:
$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-JsonRecursos adicionales
Consulte los siguientes recursos para obtener más información sobre la gestión de activos en NinjaOne: