# Gets the inventory report for virtualization engine VDBs.

Endpoint: GET /reporting/vdb-inventory-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 inventory data of VDBs.

## Response 200 fields (application/json):

  - `items` (array)

  - `items.vdb_id` (string)
    The VDB id.
    Example: vdb-id-1

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

  - `items.name` (string)
    The name of the VDB.
    Example: prod01-copy01

  - `items.type` (string)
    The database type of the VDB.
    Example: Oracle

  - `items.version` (string)
    The database version of the VDB.
    Example: 10.2.0.5.0

  - `items.parent_name` (string)
    The name of the VDB's parent dataset.
    Example: prod01-main

  - `items.parent_id` (string)
    A reference to the parent dataset of the VDB.
    Example: 1-DB_CONTAINER-1

  - `items.creation_date` (string)
    The date the VDB was created.
    Example: 2023-04-15T08:51:34.148Z

  - `items.last_refreshed_date` (string)
    The date the VDB was last refreshed.
    Example: 2023-04-15T10:49:34.148Z

  - `items.parent_timeflow_location` (string)
    The location for the VDB's parent timeflow.
    Example: 1178883

  - `items.parent_timeflow_timestamp` (string)
    The timestamp for the VDB's parent timeflow.
    Example: 2021-05-01T08:51:34.148Z

  - `items.parent_timeflow_timezone` (string)
    The timezone for the VDB's parent timeflow.
    Example: America/Los_Angeles

  - `items.enabled` (boolean)
    Whether the VDB is enabled
    Example: true

  - `items.status` (string)
    The runtime status of the VDB. 'Unknown' if all attempts to connect to the dataset failed.
    Example: RUNNING

  - `items.storage_size` (integer)
    The actual space used by the VDB, in bytes.
    Example: 12345678

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

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

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