llm-automation-docs-and-remediation-engine/requirements/api_endpoints.md

API Endpoints e Comandi per Raccolta Dati

1. VMware vSphere API

1.1 REST API Endpoints

# Base URL
BASE_URL="https://vcenter.domain.local/rest"

# Authentication
curl -X POST $BASE_URL/com/vmware/cis/session \
  -u 'automation@vsphere.local:password'

# Get all VMs
curl -X GET $BASE_URL/vcenter/vm \
  -H "vmware-api-session-id: ${SESSION_ID}"

# Get VM details
curl -X GET $BASE_URL/vcenter/vm/${VM_ID} \
  -H "vmware-api-session-id: ${SESSION_ID}"

# Get hosts
curl -X GET $BASE_URL/vcenter/host \
  -H "vmware-api-session-id: ${SESSION_ID}"

# Get datastores
curl -X GET $BASE_URL/vcenter/datastore \
  -H "vmware-api-session-id: ${SESSION_ID}"

# Get clusters
curl -X GET $BASE_URL/vcenter/cluster \
  -H "vmware-api-session-id: ${SESSION_ID}"

1.2 PowerCLI Commands

# Connect
Connect-VIServer -Server vcenter.domain.local -User automation@vsphere.local

# Get all VMs with details
Get-VM | Select-Object Name, PowerState, NumCpu, MemoryGB, @{N='UsedSpaceGB';E={[math]::Round($_.UsedSpaceGB,2)}}, VMHost, ResourcePool | Export-Csv -Path vms.csv

# Get hosts
Get-VMHost | Select-Object Name, ConnectionState, PowerState, Version, NumCpu, MemoryTotalGB, @{N='MemoryUsageGB';E={[math]::Round($_.MemoryUsageGB,2)}} | Export-Csv -Path hosts.csv

# Get datastores
Get-Datastore | Select-Object Name, Type, CapacityGB, FreeSpaceGB, @{N='PercentFree';E={[math]::Round(($_.FreeSpaceGB/$_.CapacityGB*100),2)}} | Export-Csv -Path datastores.csv

# Get performance stats
Get-Stat -Entity (Get-VM) -Stat cpu.usage.average,mem.usage.average -Start (Get-Date).AddDays(-7) -IntervalMins 5 | Export-Csv -Path performance.csv

---

2. Proxmox VE API

2.1 REST API

# Base URL
PROXMOX_URL="https://proxmox.domain.local:8006/api2/json"

# Get ticket (authentication)
curl -k -d "username=automation@pam&password=password" \
  $PROXMOX_URL/access/ticket

# Get nodes
curl -k -H "Cookie: PVEAuthCookie=${TICKET}" \
  $PROXMOX_URL/nodes

# Get VMs on node
curl -k -H "Cookie: PVEAuthCookie=${TICKET}" \
  $PROXMOX_URL/nodes/${NODE}/qemu

# Get containers
curl -k -H "Cookie: PVEAuthCookie=${TICKET}" \
  $PROXMOX_URL/nodes/${NODE}/lxc

# Get storage
curl -k -H "Cookie: PVEAuthCookie=${TICKET}" \
  $PROXMOX_URL/nodes/${NODE}/storage

# Get cluster status
curl -k -H "Cookie: PVEAuthCookie=${TICKET}" \
  $PROXMOX_URL/cluster/status

2.2 CLI Commands

# List VMs
pvesh get /cluster/resources --type vm

# VM status
qm status ${VMID}

# Container list
pct list

# Storage info
pvesm status

# Node info
pvesh get /nodes/${NODE}/status

---

3. Network Devices

3.1 Cisco IOS Commands

# Via SSH
ssh admin@switch.domain.local

# System information
show version
show inventory
show running-config

# Interfaces
show interfaces status
show interfaces description
show interfaces counters errors
show ip interface brief

# VLANs
show vlan brief
show vlan id ${VLAN_ID}

# Spanning Tree
show spanning-tree summary
show spanning-tree root

# Routing
show ip route
show ip protocols

# CDP/LLDP
show cdp neighbors detail
show lldp neighbors

# Performance
show processes cpu history
show memory statistics
show environment all

3.2 HP/Aruba Switch Commands

# System info
show system
show version
show running-config

# Interfaces
show interfaces brief
show interfaces status

# VLANs
show vlans

# Spanning tree
show spanning-tree

# Logging
show log

---

4. Firewall APIs

4.1 pfSense/OPNsense API

# Base URL
FW_URL="https://firewall.domain.local/api"

# Get system info
curl -X GET "${FW_URL}/core/system/status" \
  -H "Authorization: Bearer ${API_TOKEN}"

# Get interfaces
curl -X GET "${FW_URL}/interfaces/overview/export" \
  -H "Authorization: Bearer ${API_TOKEN}"

# Get firewall rules
curl -X GET "${FW_URL}/firewall/filter/searchRule" \
  -H "Authorization: Bearer ${API_TOKEN}"

# Get VPN status
curl -X GET "${FW_URL}/ipsec/sessions" \
  -H "Authorization: Bearer ${API_TOKEN}"

4.2 Fortinet FortiGate API

# Base URL
FORTI_URL="https://fortigate.domain.local/api/v2"

# System status
curl -X GET "${FORTI_URL}/monitor/system/status" \
  -H "Authorization: Bearer ${API_TOKEN}"

# Interface stats
curl -X GET "${FORTI_URL}/monitor/system/interface/select" \
  -H "Authorization: Bearer ${API_TOKEN}"

# Firewall policies
curl -X GET "${FORTI_URL}/cmdb/firewall/policy" \
  -H "Authorization: Bearer ${API_TOKEN}"

# VPN status
curl -X GET "${FORTI_URL}/monitor/vpn/ipsec" \
  -H "Authorization: Bearer ${API_TOKEN}"

---

5. Storage Arrays

5.1 Pure Storage API

# Base URL
PURE_URL="https://array.domain.local/api"

# Get array info
curl -X GET "${PURE_URL}/1.19/array" \
  -H "api-token: ${API_TOKEN}"

# Get volumes
curl -X GET "${PURE_URL}/1.19/volume" \
  -H "api-token: ${API_TOKEN}"

# Get hosts
curl -X GET "${PURE_URL}/1.19/host" \
  -H "api-token: ${API_TOKEN}"

# Get performance metrics
curl -X GET "${PURE_URL}/1.19/array/monitor?action=monitor" \
  -H "api-token: ${API_TOKEN}"

5.2 NetApp ONTAP API

# Base URL
NETAPP_URL="https://netapp.domain.local/api"

# Get cluster info
curl -X GET "${NETAPP_URL}/cluster" \
  -u "admin:password"

# Get volumes
curl -X GET "${NETAPP_URL}/storage/volumes" \
  -u "admin:password"

# Get aggregates
curl -X GET "${NETAPP_URL}/storage/aggregates" \
  -u "admin:password"

# Get performance
curl -X GET "${NETAPP_URL}/cluster/counter/tables/volume" \
  -u "admin:password"

5.3 Generic SAN Commands

# Via SSH to array management interface

# Show system info
show system
show controller
show disk

# Show volumes/LUNs
show volumes
show luns
show mappings

# Show performance
show statistics
show disk-statistics

---

6. Monitoring Systems

6.1 Zabbix API

# Base URL
ZABBIX_URL="https://zabbix.domain.local/api_jsonrpc.php"

# Authenticate
curl -X POST $ZABBIX_URL \
  -H "Content-Type: application/json-rpc" \
  -d '{
    "jsonrpc": "2.0",
    "method": "user.login",
    "params": {
      "user": "automation",
      "password": "password"
    },
    "id": 1
  }'

# Get hosts
curl -X POST $ZABBIX_URL \
  -H "Content-Type: application/json-rpc" \
  -d '{
    "jsonrpc": "2.0",
    "method": "host.get",
    "params": {
      "output": ["hostid", "host", "status"]
    },
    "auth": "'${AUTH_TOKEN}'",
    "id": 1
  }'

# Get problems
curl -X POST $ZABBIX_URL \
  -H "Content-Type: application/json-rpc" \
  -d '{
    "jsonrpc": "2.0",
    "method": "problem.get",
    "params": {
      "recent": true
    },
    "auth": "'${AUTH_TOKEN}'",
    "id": 1
  }'

6.2 Prometheus API

# Base URL
PROM_URL="http://prometheus.domain.local:9090"

# Query instant
curl -X GET "${PROM_URL}/api/v1/query?query=up"

# Query range
curl -X GET "${PROM_URL}/api/v1/query_range?query=node_cpu_seconds_total&start=2024-01-01T00:00:00Z&end=2024-01-02T00:00:00Z&step=15s"

# Get targets
curl -X GET "${PROM_URL}/api/v1/targets"

# Get alerts
curl -X GET "${PROM_URL}/api/v1/alerts"

6.3 Nagios/Icinga API

# Icinga2 API
ICINGA_URL="https://icinga.domain.local:5665"

# Get hosts
curl -k -u "automation:password" \
  "${ICINGA_URL}/v1/objects/hosts"

# Get services
curl -k -u "automation:password" \
  "${ICINGA_URL}/v1/objects/services"

# Get problems
curl -k -u "automation:password" \
  "${ICINGA_URL}/v1/objects/services?filter=service.state!=0"

---

7. Backup Systems

7.1 Veeam API

# Connect to Veeam server
Connect-VBRServer -Server veeam.domain.local -User automation

# Get backup jobs
Get-VBRJob | Select-Object Name, JobType, IsScheduleEnabled, LastResult

# Get backup sessions
Get-VBRBackupSession | Where-Object {$_.CreationTime -gt (Get-Date).AddDays(-7)} | Select-Object Name, JobName, Result, CreationTime

# Get restore points
Get-VBRRestorePoint | Select-Object VMName, CreationTime, Type

# Get repositories
Get-VBRBackupRepository | Select-Object Name, Path, @{N='FreeGB';E={[math]::Round($_.GetContainer().CachedFreeSpace.InGigabytes,2)}}

7.2 CommVault API

# Base URL
CV_URL="https://commvault.domain.local/webconsole/api"

# Login
curl -X POST "${CV_URL}/Login" \
  -H "Content-Type: application/json" \
  -d '{"username":"automation","password":"password"}'

# Get jobs
curl -X GET "${CV_URL}/Job?clientName=${CLIENT}" \
  -H "Authtoken: ${TOKEN}"

# Get clients
curl -X GET "${CV_URL}/Client" \
  -H "Authtoken: ${TOKEN}"

---

8. Database Queries

8.1 Asset Management DB

-- MySQL/MariaDB queries for asset database

-- Get all racks
SELECT 
    rack_id,
    location,
    total_units,
    occupied_units,
    (total_units - occupied_units) AS available_units,
    max_power_kw,
    ROUND(occupied_units * 100.0 / total_units, 2) AS utilization_percent
FROM racks
ORDER BY location, rack_id;

-- Get all servers
SELECT 
    s.hostname,
    s.serial_number,
    s.model,
    s.cpu_model,
    s.cpu_cores,
    s.ram_gb,
    s.rack_id,
    s.rack_unit,
    s.status,
    s.environment
FROM servers s
ORDER BY s.rack_id, s.rack_unit;

-- Get network devices
SELECT 
    n.hostname,
    n.device_type,
    n.vendor,
    n.model,
    n.management_ip,
    n.firmware_version,
    n.rack_id,
    n.status
FROM network_devices n
ORDER BY n.device_type, n.hostname;

-- Get contracts
SELECT 
    c.vendor,
    c.service_type,
    c.contract_type,
    c.start_date,
    c.end_date,
    DATEDIFF(c.end_date, NOW()) AS days_to_expiry,
    c.annual_cost
FROM contracts c
WHERE c.end_date > NOW()
ORDER BY c.end_date;

8.2 Database Server Queries

-- MySQL - Database sizes
SELECT 
    table_schema AS 'Database',
    ROUND(SUM(data_length + index_length) / 1024 / 1024 / 1024, 2) AS 'Size_GB'
FROM information_schema.tables
GROUP BY table_schema
ORDER BY SUM(data_length + index_length) DESC;

-- PostgreSQL - Database sizes
SELECT 
    datname AS database_name,
    pg_size_pretty(pg_database_size(datname)) AS size
FROM pg_database
ORDER BY pg_database_size(datname) DESC;

-- SQL Server - Database sizes
SELECT 
    DB_NAME(database_id) AS DatabaseName,
    (size * 8.0 / 1024) AS SizeMB
FROM sys.master_files
WHERE type = 0
ORDER BY size DESC;

---

9. Cloud Provider APIs

9.1 AWS (Boto3)

import boto3

# EC2 instances
ec2 = boto3.client('ec2')
instances = ec2.describe_instances()

# S3 buckets
s3 = boto3.client('s3')
buckets = s3.list_buckets()

# RDS databases
rds = boto3.client('rds')
databases = rds.describe_db_instances()

# Cost Explorer
ce = boto3.client('ce')
cost = ce.get_cost_and_usage(
    TimePeriod={'Start': '2024-01-01', 'End': '2024-01-31'},
    Granularity='MONTHLY',
    Metrics=['UnblendedCost']
)

9.2 Azure (SDK)

from azure.identity import DefaultAzureCredential
from azure.mgmt.compute import ComputeManagementClient
from azure.mgmt.storage import StorageManagementClient

credential = DefaultAzureCredential()

# VMs
compute_client = ComputeManagementClient(credential, subscription_id)
vms = compute_client.virtual_machines.list_all()

# Storage accounts
storage_client = StorageManagementClient(credential, subscription_id)
storage_accounts = storage_client.storage_accounts.list()

---

10. SNMP OIDs Reference

10.1 Common System OIDs

# System description
.1.3.6.1.2.1.1.1.0  # sysDescr

# System uptime
.1.3.6.1.2.1.1.3.0  # sysUpTime

# System name
.1.3.6.1.2.1.1.5.0  # sysName

# System location
.1.3.6.1.2.1.1.6.0  # sysLocation

10.2 UPS OIDs (RFC 1628)

# UPS identity
.1.3.6.1.2.1.33.1.1.1.0  # upsIdentManufacturer
.1.3.6.1.2.1.33.1.1.2.0  # upsIdentModel

# Battery status
.1.3.6.1.2.1.33.1.2.1.0  # upsBatteryStatus
.1.3.6.1.2.1.33.1.2.2.0  # upsSecondsOnBattery
.1.3.6.1.2.1.33.1.2.3.0  # upsEstimatedMinutesRemaining

# Input
.1.3.6.1.2.1.33.1.3.3.1.3  # upsInputVoltage
.1.3.6.1.2.1.33.1.3.3.1.4  # upsInputCurrent
.1.3.6.1.2.1.33.1.3.3.1.6  # upsInputTruePower

# Output
.1.3.6.1.2.1.33.1.4.4.1.2  # upsOutputVoltage
.1.3.6.1.2.1.33.1.4.4.1.3  # upsOutputCurrent
.1.3.6.1.2.1.33.1.4.4.1.4  # upsOutputPower
.1.3.6.1.2.1.33.1.4.4.1.5  # upsOutputPercentLoad

10.3 Network Interface OIDs

# Interface description
.1.3.6.1.2.1.2.2.1.2  # ifDescr

# Interface status
.1.3.6.1.2.1.2.2.1.8  # ifOperStatus

# Interface traffic
.1.3.6.1.2.1.2.2.1.10  # ifInOctets
.1.3.6.1.2.1.2.2.1.16  # ifOutOctets

# Interface errors
.1.3.6.1.2.1.2.2.1.14  # ifInErrors
.1.3.6.1.2.1.2.2.1.20  # ifOutErrors

---

11. Example Collection Script

11.1 Complete Data Collection

#!/bin/bash
# collect_all_data.sh - Orchestrate all data collection

OUTPUT_DIR="/tmp/datacenter-collection-$(date +%Y%m%d_%H%M%S)"
mkdir -p $OUTPUT_DIR

echo "Starting datacenter data collection..."

# VMware
echo "Collecting VMware data..."
python3 collect_vmware.py > $OUTPUT_DIR/vmware.json

# Network devices
echo "Collecting network configurations..."
./collect_network.sh > $OUTPUT_DIR/network.json

# Storage
echo "Collecting storage data..."
python3 collect_storage.py > $OUTPUT_DIR/storage.json

# Monitoring
echo "Collecting monitoring data..."
./collect_monitoring.sh > $OUTPUT_DIR/monitoring.json

# Databases
echo "Querying databases..."
mysql -h db.local -u reader -pPASS asset_db < queries.sql > $OUTPUT_DIR/asset_db.csv

# SNMP devices
echo "Polling SNMP devices..."
./poll_snmp.sh > $OUTPUT_DIR/snmp.json

echo "Collection complete. Data saved to: $OUTPUT_DIR"
tar -czf $OUTPUT_DIR.tar.gz $OUTPUT_DIR

---

12. Rate Limiting Reference

12.1 Vendor Rate Limits

Vendor	Endpoint	Limit	Time Window
VMware vCenter	REST API	100 req	per minute
Zabbix	API	300 req	per minute
Pure Storage	REST API	60 req	per minute
Cisco DNA Center	API	10 req	per second
AWS	API (varies)	10-100 req	per second

12.2 Retry Strategy

import time
from functools import wraps

def rate_limited_retry(max_retries=3, backoff_factor=2):
    def decorator(func):
        @wraps(func)
        def wrapper(*args, **kwargs):
            for attempt in range(max_retries):
                try:
                    return func(*args, **kwargs)
                except RateLimitException:
                    if attempt == max_retries - 1:
                        raise
                    wait_time = backoff_factor ** attempt
                    logger.warning(f"Rate limited. Waiting {wait_time}s before retry {attempt+1}/{max_retries}")
                    time.sleep(wait_time)
                except Exception as e:
                    logger.error(f"Error: {e}")
                    raise
        return wrapper
    return decorator

---

Documento Versione: 1.0
Ultimo Aggiornamento: 2025-01-XX
Maintainer: Automation Team