> ## Documentation Index
> Fetch the complete documentation index at: https://docs.edisglobal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CPU Usage

> This endpoint retrieves the CPU usage statistics for the specified KVM VPS.  
The `api_host` parameter, obtained from the **"Create AUTH-session"** response,  
is dynamically set in the URL.  
Provide the `signature`, `kvm_id`, and `valid_until` parameters obtained  
from the same response to access CPU usage data.




## OpenAPI

````yaml post /kvm/v2/get/cpu_usage
openapi: 3.0.0
info:
  title: EDIS Global Management API
  description: >
    Use the API to access and manage your VPS services, including power control,
    rDNS, and VNC management.  

    **Authentication:** Enable API access on any KVM VPS you own. Then use the
    provided credentials to authenticate your requests.
  version: 1.0.0
servers:
  - url: https://{api_host}
    description: Dynamic API host returned from the AUTH session endpoint.
    variables:
      api_host:
        default: api_host.edisglobal.com
        description: >-
          Enter the full API host exactly as returned by /kvm/v2/get/auth (for
          example: 12345.edisglobal.com)
security: []
tags:
  - name: Authentication
    description: Create an AUTH Session
  - name: Power Management
    description: KVM Power Management
  - name: Installation
    description: ISO, Turnkey, Reinstall
  - name: Settings
    description: KVM System Settings
  - name: Collect Information
    description: KVM VPS Details.
  - name: VNC Management
    description: KVM VNC Access
  - name: PTR
    description: KVM Reverse DNS
  - name: Traffic Pool
    description: Traffic Pool Management
  - name: Hooks
    description: KVM Webhook Management
paths:
  /kvm/v2/get/cpu_usage:
    post:
      tags:
        - Collect Information
      summary: Get CPU usage
      description: >
        This endpoint retrieves the CPU usage statistics for the specified KVM
        VPS.  

        The `api_host` parameter, obtained from the **"Create AUTH-session"**
        response,  

        is dynamically set in the URL.  

        Provide the `signature`, `kvm_id`, and `valid_until` parameters
        obtained  

        from the same response to access CPU usage data.
      operationId: getCpuUsage
      requestBody:
        description: >
          Required parameters to fetch CPU usage statistics for a KVM VPS.  

          All parameters must be passed in the request body as
          `application/x-www-form-urlencoded`.
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/get_cpu_usage_body'
        required: true
      responses:
        '200':
          description: CPU usage data retrieved successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/inline_response_200_12'
        '400':
          description: Bad Request - Invalid parameters or missing fields.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/inline_response_400_8'
components:
  schemas:
    get_cpu_usage_body:
      type: object
      properties:
        signature:
          type: string
          description: The session signature obtained from the "Create AUTH-session" call.
          example: session_signature_12345
        kvm_id:
          type: string
          description: >
            The unique identifier of the KVM VPS to retrieve CPU usage data
            for.  

            This value is specific to your VPS.
          example: kvm_100200_300400
        valid_until:
          type: string
          description: >
            The expiration timestamp for the session, obtained from the "Create
            AUTH-session" call.  

            Ensure that the session is valid and has not expired.
          example: '1737476000'
    inline_response_200_12:
      type: object
      properties:
        status:
          type: string
          example: success
        chart_cpu:
          type: string
          description: JSON string containing CPU usage chart data.
          example: >-
            {"datasets":[{"label":"CPU usage
            [%]","type":"line","borderWidth":1,"borderColor":"#46A546","backgroundColor":"#46A546","yAxisID":"y","data":[12,10,12,12,12,12,10,14,12,10,12,10,10,12,10,12,14,10,12,12,12,12,15,14,12,12,12,10,10,12,12,12,12,12,12,12,14,12,12,12,12,12,12,14,12,12,12,12,14,10,14,10,12,12,12,10,10,12,12,15,12,12,12,10,12,12,14,12,12,12,15,12,12,12,12,12,12,12,12,12,12,12,12,12,12,12,12,10,12,14,12,12,14,14,12,12,14,12,14,12,14,14,12,12,12,14,12,14,14,12,14,12,10,12,12,12,12,12,14,12,10,12,10,14,12,12,12,14,14,10,14,12,45,10,62,12,14,12,12,14,14,12,10,14,14,12,12,12,12,14,12,12,12,12,14,12,10,10,10,12,12,12,12,12,12,14,12,12,12,12,12,12,14,12,14,14,12,12,12,12,14,10,14,34,14,12,56,12,12,45,12,12,12,10,12,12,12,14,10,12,14,10,12,12,14,17,12,12,12,12,12,44,15,14,12,12,14,12,14,12,12,12,12,14,12,14,14,14,14,12,12,12,12,12,12,12,14,14,10,14,12,14,14,14,12,10,14,14,12,12,12,12,14,14,12,56,12,12,14,15,12,12,12,12,12,12,12,12,10,12,12,12,14,56,12,12,14,10,14,45,14,27,14,12,14,15,12,14,12,14,10,12,12,14,15,14,14,12,10,14,12,12,12,12,14,14,14,12,12,12,14,14,10,12,12,14,12,12,12,12,12,10,10,14,12,12,12,12,12,12,14,12,14,14,10,30,14,12,14,12,14,12,12,12,12,10,12,14,10,10,12,12,12,17,12,12,12,12,10,14,12,10,12,12,12,10,10,12,12,12,12,14,10,12,14,12,12,12,12,12,12,12,12,12,14,10,12,12,14,14,12,12,14,10,10,10,12,14,12,12,12,12,12,10,12,10,12,12,12,12,10,12,12,12,12,49,12,12,19,12,12,10,12,10,12,12,12,12,14,12,12,12,12,12,12,12,12,12,12,12,12,14,10,10,10,12,12,12,12,12,10,14,14,10,12,12,12,12,12,12,12,12,12,12,10,12,12,10,14,14,10,12,14,12,12,12,12,12,14,12,12,14,12,12,12,14,14,12,12,12,12,14,12,12,14,10,12,12,12,12,12,14,10,12,10,12,12,12,12,12,10,12,14,14,12,12,12,14,12,12,12,12,14,12,17,14,10,12,14,12,12,12,14,12,12,14,10,14,10,14,14,14,12,12,14,14,14,12,12,10,14,14,14,14,12,12,12,14,12,12,12,14,12,12,12,12,12,14,14,12,14,12,14,14,12,12,14,12,12,14,12,14,12,12,12,12,12,12,14,14,12,15,10,14,10,12,10,10,12,12,12,12,12,12,14,12,12,12,12,12,12,12,12,12,12,14,14,12,12,12,15,12,14,15,12,12,14,14,12,12,12,10,12,12,12,14,12,12,12,12,14,14,12,12,12,14,12,14,14,12,10,12,12,12,12,12,14,14,14,15,12,12,10,14,14,14,12,12,14,12,12,12,12,12,44,14,15,12,12,12,12,12,12,14,12,12,12,10,10,14,12,12,15,14,12,10,12,12,12,14,12,10,14,12,14,14,12,12,12,12,20,14,12,12,12,12,14,12,15,14]}],"labels":["08:05","10:02"]}
    inline_response_400_8:
      type: object
      properties:
        status:
          type: string
          description: Operation status indicating an error occurred.
          example: error
        error:
          type: string
          description: Error message describing the issue with the request.
          example: 'Missing required parameter: kvm_id'

````