> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.nvidia.com/fleet-intel/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/fleet-intel/_mcp/server. # Get event counts bucketed by time GET /v1/events/buckets Returns time-bucketed event counts for histogram display. The server picks a clean bucket interval based on the maxBuckets hint. Reference: https://docs.nvidia.com/fleet-intel/fleet-intel/api-explorer/events/get-v-1-events-buckets ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: fleet-intelligence version: 1.0.0 paths: /v1/events/buckets: get: operationId: getV1EventsBuckets summary: Get event counts bucketed by time description: >- Returns time-bucketed event counts for histogram display. The server picks a clean bucket interval based on the maxBuckets hint. tags: - events parameters: - name: startTime in: query description: >- Start time in RFC3339 format (required for absolute mode, e.g., 2024-01-01T01:00:00Z). Cannot be more than 1 year in the past. required: false schema: type: string - name: endTime in: query description: >- End time in RFC3339 format (required for absolute mode, e.g., 2024-01-01T01:00:00Z) required: false schema: type: string - name: timeMode in: query description: Time mode for range selection. Defaults to absolute. required: false schema: $ref: '#/components/schemas/V1EventsBucketsGetParametersTimeMode' - name: window in: query description: >- Relative duration window (required for relative mode). Valid units: h, m, s (e.g. 24h, 1h30m, 90m). 'd' is not supported; use hours instead (e.g. 168h for 7 days) required: false schema: type: string - name: nodeUUID in: query description: Filter by node UUID (optional) required: false schema: type: string - name: component in: query description: Filter by component (optional) required: false schema: type: string - name: maxBuckets in: query description: 'Maximum number of buckets (default: 100, max: 1000)' required: false schema: type: integer default: 100 responses: '200': description: Time-bucketed event counts content: application/json: schema: $ref: '#/components/schemas/models.EventBucketsResponse' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/models.ErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/models.ErrorResponse' '403': description: Forbidden - UAM authorization denied content: application/json: schema: $ref: '#/components/schemas/models.ErrorResponse' '499': description: Client Closed Request - request was canceled by the client content: application/json: schema: $ref: '#/components/schemas/models.ErrorResponse' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/models.ErrorResponse' '503': description: Service Unavailable content: application/json: schema: $ref: '#/components/schemas/models.ErrorResponse' components: schemas: V1EventsBucketsGetParametersTimeMode: type: string enum: - absolute - relative title: V1EventsBucketsGetParametersTimeMode models.EventBucket: type: object properties: count: type: integer endTime: type: string firstEventTime: type: string startTime: type: string title: models.EventBucket models.EventBucketsResponse: type: object properties: bucketInterval: type: string buckets: type: array items: $ref: '#/components/schemas/models.EventBucket' title: models.EventBucketsResponse models.KASRequestStatus: type: object properties: requestId: type: string description: Request ID for tracing statusCode: type: string description: Status code from KAS statusDescription: type: string description: Status description from KAS description: >- RequestStatus contains KAS-specific error details This is added to reflect the field in OpenAPI docs for UI reference and not populated by our code If KAS returns an error, the request will not be forwarded to the backend title: models.KASRequestStatus models.ErrorResponse: type: object properties: details: type: string description: Detailed error information error: type: string description: Error message or type requestStatus: $ref: '#/components/schemas/models.KASRequestStatus' description: >- Standard error response returned by all API endpoints. For KAS API errors, requestStatus fields are populated. title: models.ErrorResponse ``` ## Examples **Response** ```json { "bucketInterval": "15m", "buckets": [ { "count": 3, "endTime": "2024-01-01T00:01:00Z", "firstEventTime": "2024-01-01T00:00:30Z", "startTime": "2024-01-01T00:00:00Z" } ] } ``` **SDK Code** ```python import requests url = "https://api.example.com/v1/events/buckets" response = requests.get(url) print(response.json()) ``` ```javascript const url = 'https://api.example.com/v1/events/buckets'; const options = {method: 'GET'}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.example.com/v1/events/buckets" req, _ := http.NewRequest("GET", url, nil) res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.example.com/v1/events/buckets") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.example.com/v1/events/buckets") .asString(); ``` ```php request('GET', 'https://api.example.com/v1/events/buckets'); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.example.com/v1/events/buckets"); var request = new RestRequest(Method.GET); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let request = NSMutableURLRequest(url: NSURL(string: "https://api.example.com/v1/events/buckets")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```