# Gets the storage summary report for virtualization engines.

Endpoint: GET /reporting/virtualization-storage-summary-report
Version: 3.17.0
Security: ApiKeyAuth

## Security:

  - `ApiKeyAuth` (unknown)
    apiKey in header Authorization

## Query parameters:

  - `limit` (integer)
    Maximum number of objects to return per query. The value must be between 1 and 1000. Default is 10000.

  - `cursor` (string)
    Cursor to fetch the next or previous page of results. The value of this property must be extracted from the 'prev_cursor' or 'next_cursor' property of a PaginatedResponseMetadata which is contained in the response of list and search API endpoints.

  - `sort` (string)
    The field to sort results by. A property name with a prepended '-' signifies descending order.

## Response 200:

  - `200` (unknown)
    Returns a list of storage summary data of virtualization engines.

## Response 200 fields (application/json):

  - `items` (array)

  - `items.engine_id` (string, required)
    A reference to the engine.
    Example: engine-123

  - `items.engine_name` (string, required)
    The engine name.
    Example: My Favorite Engine

  - `items.engine_hostname` (string, required)
    The engine hostname.
    Example: eng09.dev.delphix.com

  - `items.total_capacity` (integer)
    The total amount of storage allocated for engine objects and system metadata, in bytes.
    Example: 100000000000

  - `items.free_storage` (integer)
    The amount of available storage, in bytes.
    Example: 99000000000

  - `items.used_storage` (integer)
    The amount of storage used by engine objects and system metadata, in bytes.
    Example: 85000000000

  - `items.used_percentage` (number)
    The percentage of storage used.
    Example: 75

  - `items.dsource_count` (integer)
    The number of dSources on the engine.
    Example: 50

  - `items.vdb_count` (integer)
    The number of VDBs on the engine.
    Example: 200

  - `items.total_object_count` (integer)
    The total number of dSources and VDBs on the engine.
    Example: 400

  - `items.reserved_storage` (integer)
    The amount of storage reversed by the engine as a safety buffer, in bytes.
    Example: 2200000000

  - `items.dsource_used_storage` (integer)
    The amount of storage used by all dSources on the engine, in bytes.
    Example: 890000000

  - `items.vdb_used_storage` (integer)
    The amount of storage used by all VDBs on the engine, in bytes.
    Example: 11000000

  - `response_metadata` (object)

  - `response_metadata.prev_cursor` (string)
    Pointer to the previous page of results. Use this value as a cursor query parameter in a subsequent request, along with limit, to navigate through the collection by virtual page.

  - `response_metadata.next_cursor` (string)
    Pointer to the next page of results. Use this value as a cursor query parameter in a subsequent request, along with limit, to navigate through the collection by virtual page.

  - `response_metadata.total` (integer)
    The total number of results. This value may not be provided.