NinjaOne ITAM: Utilizar secuencias de comandos API para acceder a los campos de los activos principales

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

• Gestión de activos de TI (ITAM) de NinjaOne
• API pública de NinjaOne
• Gestión de terminales de NinjaOne

Descripción

Puede interactuar con los campos principales de los activos a través de la API utilizando los puntos finales de los campos personalizados y sus nombres internos. Además, puede utilizar la CLI de NinjaOne para recuperar y actualizar el ID del activo y el número de serie del activo. 

Selecciona una categoría para obtener más información: 

• Actualizar campos principales de activos con la CLI
• Actualizar campos principales de activos con la API
  • Obtener valores de campo
  • Establecer valores de campo
• Recursos adicionales

Actualizar campos principales de activos con la CLI

Para interactuar con los campos principales de los activos a través de la CLI, debe utilizar los siguientes nombres de campos internos: 

El siguiente bloque de código ofrece 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 básicos de activos con la API

Puede utilizar la API pública de NinjaOne para interactuar con los campos principales de los activos utilizando los puntos finales de los campos personalizados y sus nombres internos: 

Obtener valores de campo

El siguiente bloque de código de comando ofrece un ejemplo de cómo se pueden recuperar los valores de los campos: 

$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 uso
itamAssetPurchaseDate     : 1759316400000
itamAssetPurchaseAmount   : 1000
itamAssetExpectedLifetime : 2 años
itamAssetEndOfLifeDate    : 1822388400000
itamAssetSerialNumber     : UpdateSerialNumber

Establecer valores de campo

Los campos de fecha requieren una marca de tiempo UTC en milisegundos. La vida útil prevista debe introducirse utilizando letras minúsculas.

El siguiente bloque de código de comando ofrece un ejemplo de cómo se pueden establecer los valores de los campos: 

$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

Recursos adicionales

Consulte los siguientes recursos para obtener más información sobre la gestión de activos en NinjaOne:

• Gestión de activos de TI de NinjaOne: Catálogo de recursos
• Trabajar con dispositivos no gestionados en NinjaOne (ITAM)
• Operaciones de la API pública de NinjaOne
• Uso de la interfaz de línea de comandos (CLI) en NinjaOne