# Get engine storage capacity data.

Endpoint: GET /reporting/storage-capacity-data-report
Version: 3.30.0
Security: ApiKeyAuth

## Security:

  - `ApiKeyAuth` (unknown)
    apiKey in header Authorization

## Query parameters:

  - `engine_id` (string)
    ID of a registered engine.

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

  - `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 the engine storage capacity data.

## Response 200 fields (application/json):

  - `items` (array)

  - `items.engine_id` (string)
    ID of the engine.

  - `items.dataset_id` (string)
    ID of the dataset.

  - `items.captured_timestamp` (string)
    Time at which this information was sampled.

  - `items.dataset_type` (string)
    Type of the dataset.
    Enum: "VDB", "DSOURCE", "CDB", "VCDB", "HELDSPACE"

  - `items.dataset_name` (string)
    Name of the dataset.

  - `items.is_replica` (boolean)
    Flag to specify if this object is a replica.

  - `items.total_size` (integer)
    Actual space used by the dataset.

  - `items.base_size` (integer)
    Amount of space used for the active copy of the dataset.

  - `items.snapshot_size` (integer)
    Amount of space used by snapshots.

  - `items.logs_size` (integer)
    Amount of space used by logs.

  - `items.unvirtualized_size` (integer)
    Unvirtualized space used by the dataset.

  - `items.current_timeflow_unvirtualized_size` (integer)
    Unvirtualized space used by the current (active) TimeFlow. This is approximately equal to the space a VDB would take upon a virtual-to-physical (V2P) operation.

  - `items.timeflow_unvirtualized_size` (integer)
    Unvirtualized space used by the TimeFlow.

  - `items.descendant_size` (integer)
    Amount of space used for snapshots from which VDBs have been provisioned.

  - `items.policy_size` (integer)
    Amount of space used for snapshots held by policy settings.

  - `items.manual_size` (integer)
    Amount of space used for snapshots held by manual retention settings.

  - `items.unowned_snapshot_size` (integer)
    Amount of space used for snapshots part of held space.

  - `items.ingested_size` (integer)
    Amount of space ingested by the source.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  - `items.tags` (array)
    The tags that are applied to dataset.

  - `items.tags.key` (string, required)
    Key of the tag
    Example: key-1

  - `items.tags.value` (string, required)
    Value of the tag
    Example: value-1

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