Files
core/docs/import-example-full.json
Michael Chus 657ad64723 Add integration guide for hardware import via JSON
Describes JSON format for importing server hardware data collected
via Redfish API or similar sources. Includes:

- Hardware snapshot format (board, CPUs, memory, storage, PSU, PCIe)
- Automatic LOT classification rules
- Component status handling (OK, Warning, Critical)
- Installation tracking and timeline event generation
- Serial number generation for components without physical serials
- Processing logic and API endpoint specification

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-10 22:50:22 +03:00

358 lines
9.5 KiB
JSON

{
"metadata": {
"import_timestamp": "2026-02-10T15:30:00Z",
"source_system": "datacenter-inventory-v3",
"import_id": "import-20260210-full-example"
},
"lots": [
{
"code": "SSD_NVME_03.84TB_GEN4",
"description": "NVMe SSD 3.84TB Gen4 PCIe"
},
{
"code": "SSD_NVME_07.68TB_GEN4",
"description": "NVMe SSD 7.68TB Gen4 PCIe"
},
{
"code": "DIMM_DDR4_32GB_3200",
"description": "DDR4 32GB 3200MHz RDIMM"
},
{
"code": "DIMM_DDR4_64GB_3200",
"description": "DDR4 64GB 3200MHz RDIMM"
},
{
"code": "CPU_XEON_GOLD_6338",
"description": "Intel Xeon Gold 6338 32C 2.0GHz"
},
{
"code": "CPU_EPYC_7763",
"description": "AMD EPYC 7763 64C 2.45GHz"
},
{
"code": "NIC_25GBE_2PORT",
"description": "25GbE Network Card 2-port"
},
{
"code": "PSU_1600W_PLATINUM",
"description": "1600W Platinum PSU"
}
],
"locations": [
{
"external_id": "DC-MSK-01",
"name": "Moscow DC Rack 01",
"kind": "datacenter"
},
{
"external_id": "DC-MSK-02",
"name": "Moscow DC Rack 02",
"kind": "datacenter"
},
{
"external_id": "DC-SPB-01",
"name": "St. Petersburg DC Rack 01",
"kind": "datacenter"
},
{
"external_id": "WH-MAIN",
"name": "Main Warehouse Storage",
"kind": "warehouse"
},
{
"external_id": "REPAIR-CENTER",
"name": "Component Repair Center",
"kind": "repair_center"
}
],
"assets": [
{
"external_id": "SRV-WEB-001",
"name": "production-web-01.example.com",
"vendor": "Dell",
"model": "PowerEdge R740",
"vendor_serial": "CN7475162Q0123",
"asset_tag": "IT-2023-0456",
"location_external_id": "DC-MSK-01"
},
{
"external_id": "SRV-WEB-002",
"name": "production-web-02.example.com",
"vendor": "Dell",
"model": "PowerEdge R740",
"vendor_serial": "CN7475162Q0124",
"asset_tag": "IT-2023-0457",
"location_external_id": "DC-MSK-01"
},
{
"external_id": "SRV-DB-001",
"name": "production-db-01.example.com",
"vendor": "HPE",
"model": "ProLiant DL380 Gen10",
"vendor_serial": "2M291300NJ",
"asset_tag": "IT-2023-0458",
"location_external_id": "DC-MSK-02"
},
{
"external_id": "SRV-CACHE-001",
"name": "production-cache-01.example.com",
"vendor": "Supermicro",
"model": "SYS-1029P-WTR",
"vendor_serial": "SMC123456789",
"asset_tag": "IT-2024-0001",
"location_external_id": "DC-SPB-01"
},
{
"external_id": "SRV-SPARE-001",
"name": "spare-server-001",
"vendor": "Dell",
"model": "PowerEdge R740",
"vendor_serial": "CN7475162Q9999",
"asset_tag": null,
"location_external_id": "WH-MAIN"
}
],
"components": [
{
"external_id": "SSD-001",
"vendor": "Samsung",
"model": "PM1733",
"vendor_serial": "S5GUNG0N123456",
"lot_code": "SSD_NVME_03.84TB_GEN4",
"first_seen_at": "2023-05-15T10:00:00Z"
},
{
"external_id": "SSD-002",
"vendor": "Samsung",
"model": "PM1733",
"vendor_serial": "S5GUNG0N123457",
"lot_code": "SSD_NVME_03.84TB_GEN4",
"first_seen_at": "2023-05-15T10:00:00Z"
},
{
"external_id": "SSD-003",
"vendor": "Samsung",
"model": "PM1735",
"vendor_serial": "S5GUNG0N789012",
"lot_code": "SSD_NVME_07.68TB_GEN4",
"first_seen_at": "2023-06-01T12:00:00Z"
},
{
"external_id": "SSD-004",
"vendor": "Samsung",
"model": "PM1735",
"vendor_serial": "S5GUNG0N789013",
"lot_code": "SSD_NVME_07.68TB_GEN4",
"first_seen_at": "2023-06-01T12:00:00Z"
},
{
"external_id": "SSD-FAILED-001",
"vendor": "Samsung",
"model": "PM1733",
"vendor_serial": "S5GUNG0N999999",
"lot_code": "SSD_NVME_03.84TB_GEN4",
"first_seen_at": "2023-05-15T10:00:00Z"
},
{
"external_id": "DIMM-001",
"vendor": "Samsung",
"model": "M393A4K40DB3-CWE",
"vendor_serial": "37CD12345601",
"lot_code": "DIMM_DDR4_32GB_3200",
"first_seen_at": "2023-05-15T10:00:00Z"
},
{
"external_id": "DIMM-002",
"vendor": "Samsung",
"model": "M393A4K40DB3-CWE",
"vendor_serial": "37CD12345602",
"lot_code": "DIMM_DDR4_32GB_3200",
"first_seen_at": "2023-05-15T10:00:00Z"
},
{
"external_id": "DIMM-003",
"vendor": "Samsung",
"model": "M393A8G40AB2-CWE",
"vendor_serial": "37CD12345701",
"lot_code": "DIMM_DDR4_64GB_3200",
"first_seen_at": "2023-06-01T12:00:00Z"
},
{
"external_id": "DIMM-004",
"vendor": "Samsung",
"model": "M393A8G40AB2-CWE",
"vendor_serial": "37CD12345702",
"lot_code": "DIMM_DDR4_64GB_3200",
"first_seen_at": "2023-06-01T12:00:00Z"
},
{
"external_id": "CPU-001",
"vendor": "Intel",
"model": "Xeon Gold 6338",
"vendor_serial": "INTEL-6338-001",
"lot_code": "CPU_XEON_GOLD_6338",
"first_seen_at": "2023-05-15T10:00:00Z"
},
{
"external_id": "CPU-002",
"vendor": "Intel",
"model": "Xeon Gold 6338",
"vendor_serial": "INTEL-6338-002",
"lot_code": "CPU_XEON_GOLD_6338",
"first_seen_at": "2023-05-15T10:00:00Z"
},
{
"external_id": "CPU-003",
"vendor": "AMD",
"model": "EPYC 7763",
"vendor_serial": "AMD-7763-001",
"lot_code": "CPU_EPYC_7763",
"first_seen_at": "2023-06-01T12:00:00Z"
},
{
"external_id": "CPU-004",
"vendor": "AMD",
"model": "EPYC 7763",
"vendor_serial": "AMD-7763-002",
"lot_code": "CPU_EPYC_7763",
"first_seen_at": "2023-06-01T12:00:00Z"
},
{
"external_id": "NIC-001",
"vendor": "Mellanox",
"model": "ConnectX-5",
"vendor_serial": "MT2892012345",
"lot_code": "NIC_25GBE_2PORT",
"first_seen_at": "2023-05-15T10:00:00Z"
},
{
"external_id": "NIC-002",
"vendor": "Mellanox",
"model": "ConnectX-5",
"vendor_serial": "MT2892012346",
"lot_code": "NIC_25GBE_2PORT",
"first_seen_at": "2023-05-15T10:00:00Z"
},
{
"external_id": "PSU-001",
"vendor": "Delta",
"model": "DPS-1600AB",
"vendor_serial": "DELTA-PSU-001",
"lot_code": "PSU_1600W_PLATINUM",
"first_seen_at": "2023-05-15T10:00:00Z"
},
{
"external_id": "PSU-002",
"vendor": "Delta",
"model": "DPS-1600AB",
"vendor_serial": "DELTA-PSU-002",
"lot_code": "PSU_1600W_PLATINUM",
"first_seen_at": "2023-05-15T10:00:00Z"
}
],
"installations": [
{
"asset_external_id": "SRV-WEB-001",
"component_external_id": "SSD-001",
"installed_at": "2023-05-15T10:30:00Z",
"removed_at": null
},
{
"asset_external_id": "SRV-WEB-001",
"component_external_id": "SSD-002",
"installed_at": "2023-05-15T10:30:00Z",
"removed_at": null
},
{
"asset_external_id": "SRV-WEB-001",
"component_external_id": "DIMM-001",
"installed_at": "2023-05-15T10:30:00Z",
"removed_at": null
},
{
"asset_external_id": "SRV-WEB-001",
"component_external_id": "DIMM-002",
"installed_at": "2023-05-15T10:30:00Z",
"removed_at": null
},
{
"asset_external_id": "SRV-WEB-001",
"component_external_id": "CPU-001",
"installed_at": "2023-05-15T10:30:00Z",
"removed_at": null
},
{
"asset_external_id": "SRV-WEB-001",
"component_external_id": "CPU-002",
"installed_at": "2023-05-15T10:30:00Z",
"removed_at": null
},
{
"asset_external_id": "SRV-WEB-001",
"component_external_id": "NIC-001",
"installed_at": "2023-05-15T10:30:00Z",
"removed_at": null
},
{
"asset_external_id": "SRV-WEB-001",
"component_external_id": "PSU-001",
"installed_at": "2023-05-15T10:30:00Z",
"removed_at": null
},
{
"asset_external_id": "SRV-WEB-001",
"component_external_id": "PSU-002",
"installed_at": "2023-05-15T10:30:00Z",
"removed_at": null
},
{
"asset_external_id": "SRV-DB-001",
"component_external_id": "SSD-003",
"installed_at": "2023-06-01T12:30:00Z",
"removed_at": null
},
{
"asset_external_id": "SRV-DB-001",
"component_external_id": "SSD-004",
"installed_at": "2023-06-01T12:30:00Z",
"removed_at": null
},
{
"asset_external_id": "SRV-DB-001",
"component_external_id": "DIMM-003",
"installed_at": "2023-06-01T12:30:00Z",
"removed_at": null
},
{
"asset_external_id": "SRV-DB-001",
"component_external_id": "DIMM-004",
"installed_at": "2023-06-01T12:30:00Z",
"removed_at": null
},
{
"asset_external_id": "SRV-DB-001",
"component_external_id": "CPU-003",
"installed_at": "2023-06-01T12:30:00Z",
"removed_at": null
},
{
"asset_external_id": "SRV-DB-001",
"component_external_id": "CPU-004",
"installed_at": "2023-06-01T12:30:00Z",
"removed_at": null
},
{
"asset_external_id": "SRV-DB-001",
"component_external_id": "NIC-002",
"installed_at": "2023-06-01T12:30:00Z",
"removed_at": null
},
{
"asset_external_id": "SRV-WEB-002",
"component_external_id": "SSD-FAILED-001",
"installed_at": "2023-05-20T09:00:00Z",
"removed_at": "2024-01-15T14:30:00Z"
}
]
}