# Gets the usage report for virtualization engine dSources.

Endpoint: GET /reporting/dsource-usage-report
Version: 3.30.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 dSource usage data.

## Response 200 fields (application/json):

  - `items` (array)

  - `items.dsource_id` (string)
    The dSource id.
    Example: dsource-id-1

  - `items.engine_name` (string)
    The name of the engine the dSource belongs to.
    Example: My favorite engine

  - `items.name` (string)
    The name of the dSource
    Example: prod01-main

  - `items.unvirtualized_space` (integer)
    The the disk space that would be required if not using Delphix virtualizion, in bytes.
    Example: 109242677

  - `items.actual_space` (integer)
    The actual space used by this dSource, in bytes. This includes the disk space used by the current copy of the data as well as the snapshots and log files retained to enable provisioning from historical versions.
    Example: 339292672

  - `items.dependant_vdbs` (integer)
    The number of VDBs that are dependant on this dSource. This includes all VDB descendants that have this dSource as an ancestor.
    Example: 25

  - `items.unvirtualized_space_in_mb` (number)
    Value in MB (binary IEC base), rounded to one decimal place.

  - `items.unvirtualized_space_in_gb` (number)
    Value in GB (binary IEC base), rounded to one decimal place.

  - `items.unvirtualized_space_in_tb` (number)
    Value in TB (binary IEC base), rounded to one decimal place.

  - `items.actual_space_in_mb` (number)
    Value in MB (binary IEC base), rounded to one decimal place.

  - `items.actual_space_in_gb` (number)
    Value in GB (binary IEC base), rounded to one decimal place.

  - `items.actual_space_in_tb` (number)
    Value in TB (binary IEC base), rounded to one decimal place.

  - `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.