# Utilization bands for VMs, Cloud SQL and GKE

Source: https://docs.levelfour.ai/api-reference/google-cloud/get-providers-gcp-utilization-summary


## GET /api/v1/providers/gcp/utilization/summary

### Authentication

Send `Authorization: Bearer <token>`.

### Responses

#### 200: Successful Response

- `success` (boolean, default `true`)
- `timestamp` (string, required)
- `data` (object, required)
  - `vm` (object, required): Bands on the p95 of daily max CPU over 30 days
    - `total` (integer, required)
    - `bands` (array of object, required)
      - `band` (one of `idle`, `low`, `moderate`, `high`, required)
      - `count` (integer, required)
  - `sql` (object, required)
    - `total` (integer, required)
    - `bands` (array of object, required)
      - `band` (one of `idle`, `low`, `moderate`, `high`, required)
      - `count` (integer, required)
  - `gke` (object, required)
    - `node_cpu_pct` (number, nullable, required)
    - `node_memory_pct` (number, nullable, required)
    - `namespaces` (array of object, required)
      - `cluster` (string, required)
      - `namespace` (string, required)
      - `cpu_request_utilization` (number, nullable, required)
      - `memory_request_utilization` (number, nullable, required)
  - `coverage` (object, required)
    - `projects_complete` (integer, required)
    - `projects_total` (integer, required)
    - `ops_agent_share` (number, nullable, required): Percent of VMs reporting memory through the Ops Agent

#### Errors

- `400`: Bad Request
- `401`: Authentication Error
- `403`: Authorization Error
- `404`: Not Found
- `409`: Conflict
- `422`: Validation Error
- `429`: Rate Limit Exceeded
- `500`: Internal Server Error

Body of `400`, `401`, `403`, `404`, `409`, `422`, `429`, `500`:

- `success` (`false`, required)
- `error` (object, required)
  - `code` (string, required)
  - `message` (string, required)
  - `details` (any)
- `timestamp` (date-time string, required)