# Fetch a list of all virtualization policies

Endpoint: GET /virtualization-policies
Version: 3.21.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 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 a descending order.

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `items` (array)

  - `items.id` (string)

  - `items.name` (string)

  - `items.dct_managed` (boolean)
    Whether this virtualization policy is managed by DCT or by an individual Delphix Engine.

  - `items.create_user` (string)
    The user who created this virtualization policy.

  - `items.create_timestamp` (string)
    The time this virtualization policy was created.

  - `items.namespace` (string)

  - `items.namespace_id` (string)
    The namespace id of this virtualization policy.

  - `items.namespace_name` (string)
    The namespace name of this virtualization policy.

  - `items.is_replica` (boolean)
    Is this a replicated object.

  - `items.engine_id` (string)

  - `items.engine_name` (string)
    The name of the engine the policy belongs to.

  - `items.policy_type` (string)
    The type of a virtualization policy.
    Enum: "REFRESH_POLICY", "SNAPSHOT_POLICY", "SYNC_POLICY", "RETENTION_POLICY", "REPLICA_RETENTION_POLICY", "QUOTA_POLICY"

  - `items.timezone_id` (string)

  - `items.default_policy` (boolean)
    True if this is the default policy created when the system is setup.

  - `items.effective_type` (string)
    Whether this policy has been directly applied or inherited. See the effectivePolicies parameter of the list call for details.
    Enum: "DIRECT_APPLIED", "INHERITED"

  - `items.data_duration` (integer)
    Amount of time to keep source data [Retention Policy].

  - `items.data_unit` (string)
    Time unit for data_duration [Retention Policy].
    Enum: "DAY", "WEEK", "MONTH", "QUARTER", "YEAR"

  - `items.log_duration` (integer)
    Amount of time to keep log data [Retention Policy].

  - `items.log_unit` (string)
    Time unit for log_duration [Retention Policy].
    Enum: "DAY", "WEEK", "MONTH", "QUARTER", "YEAR"

  - `items.num_of_daily` (integer)
    Number of daily snapshots to keep [Retention Policy].

  - `items.num_of_weekly` (integer)
    Number of weekly snapshots to keep [Retention Policy].

  - `items.day_of_week` (string)
    Day of week upon which to enforce weekly snapshot retention [Retention Policy].
    Enum: "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY"

  - `items.num_of_monthly` (integer)
    Number of monthly snapshots to keep [Retention Policy].

  - `items.day_of_month` (integer)
    Day of month upon which to enforce monthly snapshot retention [Retention Policy].

  - `items.num_of_yearly` (integer)
    Number of yearly snapshots to keep [Retention Policy].

  - `items.day_of_year` (string)
    Day of year upon which to enforce yearly snapshot retention, expressed a month / day string (e.g., "Jan 1") [Retention Policy].

  - `items.schedules` (array)

  - `items.schedules.cron_string` (string, required)

  - `items.schedules.cutoff_time` (integer)

  - `items.provision_source` (string)
    The source of the data to provision from [Refresh Policy].
    Enum: "LATEST_SNAPSHOT", "LATEST_TIME_FLOW_LOG"

  - `items.size` (integer)
    Size of the quota, in bytes. (QUOTA_POLICY only).

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

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

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

  - `items.num_targets` (integer)
    The number of target dSources or VDBs to which this policy has been applied.

  - `items.customized` (boolean)
    True if this policy is customized specifically for one object. Customized policies cannot be shared between objects.

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

