ES
Español
English
Português
    Modificar

    Modifica un registro específico.

    Detalle de la petición:

    • URI: /api/cmdb/ci/{id}
    • Tipo: PATCH
    • Encabezados requeridos:
      • UrlAsms {host}
      • Content-Type: application/json
      • TokenAsms: Bearer {token}

    Parámetros de identificador URI

    https://{host}/api/cmdb/ci/{id}

    Identificador Tipo Obligatorio Descripción
    host string SI Representa el dominio del ambiente en el que se encuentra la API
    id integer SI Representa el identificador del elemento de configuración

    Cuerpo de la petición:

    
{
  "acceptDate": "2025-06-09T17:07:12.366Z",
  "additionalFields": [
    {
      "fieldId": 0,
      "values": [
        "string"
      ]
    }
  ],
  "assetTag": "string",
  "barCode": "string",
  "brandId": 0,
  "categoryId": 0,
  "checkInDate": "2025-06-09T17:07:12.366Z",
  "costCenterId": 0,
  "description": "string",
  "impactId": 0,
  "licenseNumber": "string",
  "locationId": 0,
  "manufacturerId": 0,
  "modelId": 0,
  "name": "string",
  "price": 0,
  "providerId": 0,
  "reasonId": 0,
  "responsibilityDate": "2025-06-09T17:07:12.367Z",
  "responsibleId": 0,
  "rfid": "string",
  "riskId": 0,
  "serial": "string",
  "stateId": 0,
  "unitId": 0,
  "unitSize": "string"
}

    Donde:

    Nombre Identificador Tipo Descripción
    Additional Fields additionalFields array Campos adicionales del caso, según el caso recuperado
    Acceptance date acceptDate date-time Fecha de aceptación
    Asset tag assetTag integer Asset tag
    Bar code barCode string Código de barras
    Brand ID brandId integer Identificador de la marca
    CI type categoryId int Tipo del elemento de configuración
    Date of delivery to the company checkInDate date-time Fecha de entrega a la empresa
    Cost center ID costCenterId integer Identificador del centro de costos
    Description description string Descripción del caso
    Impact ID impactId integer Identificador del impacto
    License number licenseNumber string Numero de licencia
    Location locationId integer Localización del elemento de configuración
    Manufacturer ID manufacturerId integer Identificador del fabricante
    Initial date of responsibility responsibilityDate date-time Fecha inicial de responsabilidad
    Measure unit ID unitId integer Identificador de la unidad de medida
    Measure unit value unitSize string Valor de la unidad de medida
    Model ID modelId integer Identificador del modelo
    Name name string Nombre del item de configuración
    Price price number Precio
    Provider ID providerId integer Identificador del proveedor
    Reason ID reasonId integer Identificador de la razón de cambio
    Responsible ID responsibleId integer Identificador del responsable
    RFID rfid string RFID
    Risk ID riskId integer Identificador del riesgo
    Serial serial string Serial
    Status ID stateId integer Identificador del estado

    Las propiedades requeridas dependen de la configuración asignada

    Campos Adicionales

    
{
    "additionalField": [
        {
            "fieldId": 0,
            "values": [
               "string"
            ]
        }
    ]                
}

    Donde:

    -fieldId: Id del campo adicional.
    -Values: Valor del campo adicional, los valores que retorna son similares a los ingresados cuando se crea o se actualiza un registro, este valor depende del tipo de campo, para mas información consulte: Campos adicionales

    Respuesta:

    
{
    "id": 0,
}

    Donde:

    Nombre Identificador Tipo Descripción
    ID id integer Identificador del sistema para el registro.