Get compute zones | NVIDIA Fleet Intelligence Documentation

{
  "computezones": [
    {
      "alertOverview": {
        "criticalCount": 2,
        "infoCount": 15,
        "lastCriticalAlert": "2024-01-15T14:15:00Z",
        "lastWarningAlert": "2024-01-15T14:28:00Z",
        "totalCount": 24,
        "unknownCount": 15,
        "warningCount": 7
      },
      "contact": {
        "email": "admin@example.com",
        "pic": "John Doe"
      },
      "cpuCoresCount": 160,
      "createdAt": "2024-01-10T08:45:00Z",
      "degradedNodesCount": 2,
      "geoLocation": {
        "city": "Baltimore",
        "country": "United States",
        "latitude": 39.0458,
        "longitude": -76.6413,
        "region": "us-east-1"
      },
      "gpusCount": 80,
      "healthPercentage": 95,
      "healthState": "Healthy",
      "healthyNodesCount": 38,
      "id": "cz-us-east-1",
      "metrics": [
        {
          "aggregation": "average",
          "description": "System memory metrics",
          "lastUpdated": "2024-01-15T14:30:00Z",
          "name": "memory",
          "unit": "percent",
          "value": 72.3
        }
      ],
      "name": "US East 1 ComputeZone",
      "nodeGroupsCount": 20,
      "nodesCount": 40,
      "tags": [
        "ml-training",
        "gpu-intensive",
        "high-memory"
      ],
      "type": "datacenter",
      "unhealthyNodesCount": 0,
      "unknownNodesCount": 0,
      "updatedAt": "2024-01-15T14:30:00Z"
    }
  ],
  "hasMore": false,
  "page": 0,
  "pageSize": 10,
  "total": 0
}

Get list of compute zones with optional filtering and different view modes. Use view=detail for comprehensive metrics and view=basic for essential fields (ID, Name, Type, GeoLocation, Contact, timestamps)

Query parameters

viewenumOptionalDefaults to detail

View mode: ‘detail’ for comprehensive metrics (default) or ‘basic’ for essential fields

Allowed values:

includeMetricsbooleanOptionalDefaults to true

[DETAIL VIEW ONLY] Include metrics in response (default: true). Set to false for better performance when metrics are not needed.

computeZoneIdslist of stringsOptional

List of compute zone IDs to filter (comma-separated)

pageintegerOptionalDefaults to 0

Page number (default: 0)

pageSizeintegerOptionalDefaults to 20

Page size (default: 20, max: 100)

Response

Basic view response (view=basic)

models.ComputeZonesResponseobject

models.ListComputeZonesResponseobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

499

Client Closed Request Error

500

Internal Server Error

503

Service Unavailable Error