--- title: "GET /sites" method: GET path: "/sites" --- # GET /sites `GET /sites` ## Request - Base URL: `https://dev-cloud.acronis.com/api/dr/v2` - URL: `https://dev-cloud.acronis.com/api/dr/v2/sites` - Auth: OAuth 2 - Authorization code: `https://dev-cloud.acronis.com/api/2/idp/authorize` - Client credentials - Password - Token URL: `https://dev-cloud.acronis.com/api/2/idp/token` scopes: `dr_service::admin`, `dr::support_operator`, `protection::readonly` Fetches the list of disaster recovery sites. ## Query parameters - `allow_deleted` boolean: Includes resources that are marked as deleted in the request result. - `limit` integer: Maximum number of items to fetch per page. Mutually exclusive with the 'before' and 'after' parameters. - `after` string: Token from the 'after' field in the previous response. It contains a cursor that points to the next page of the requested collection. Mutually exclusive with the 'limit' and 'before' parameters. If provided, all other query parameters will be ignored. - `before` string: Token from the 'before' field in the previous response. It contains a cursor that points to the previous page of the requested collection. Mutually exclusive with the 'limit' and 'after' parameters. If provided, all other query parameters will be ignored. ## Response `200` - object - `items` object[], required: List of the disaster recovery sites. - `default` boolean, required: This property determines if the disaster recovery site is set as default. You can have only one default disaster recovery site at a time. - `deleted_at` string, date-time: Deletion date of the disaster recovery site. - `failover_readiness` 'ERROR' | 'OK' | 'WARNING', required: Failover readiness status of the disaster recovery site. This property can have the following values: OK - ready for failover; WARNING - proceed with caution; or ERROR - not ready for failover. - `status` 'DEPROVISIONING' | 'PROVISIONING' | 'PROVISIONED', required: The status of the disaster recovery site. - `task_uuid` string: Universally unique object identifier. - `tenant_uuid` string, required: Universally unique object identifier. - `uuid` string, required: Universally unique object identifier. - `_links` object[]: Links and actions related to the disaster recovery site. - `rel` 'DR_SITE_CONNECTIVITY_PAGE', required: Identifier of the link to the Connectivity page of the disaster recovery site. - `type` string, required: Media type of the linked resource. - `href` string, uri, required: URL to access the Connectivity page of the disaster recovery site. - `_issues` union[]: Issues of the disaster recovery site. - union: Describes a single issue (constraint violation). - object: Describes a single issue (constraint violation). - `link` string: Name or ID of the link for which the issue is returned. - `domain` 'DisasterRecovery': Disaster Recovery domain. - `target` string, required: UUID of the disaster recovery site on which the issue occurred. - `severity` 'WARNING', required: Severity of the issue. - `error` union, required - object: No VPN appliance is registered for the DR site with Site-to-Site VPN connectivity. - … - object: VPN appliance error. This might happen when the last report from the VPN appliance was received too long ago or if the VPN appliance reported an error. - … - object: The VPN tunnel between the VPN gateway and the VPN appliance cannot be established for the DR site with Site-to-Site VPN connectivity. - … - object: No IPSec tunnels are configured for the DR site with IPSec VPN connectivity. - … - object: At least one of the IPSec tunnels could not be established. - … - object: You have reached the "Disaster recovery storage" quota. To increase the quota, contact the Support team. - … - object: You have reached the "Cloud servers" quota. To increase the quota, contact the Support team. - … - object: You have reached the "Compute points" quota. To increase the quota, contact the Support team. - … - object: Issue that causes the failover readiness to be in the 'ERROR' state. - `domain` 'DisasterRecovery': Domain from which the constraint originates. - `target` string, required: UUID of the DR site on which the issue occurred. - `severity` 'ERROR', required: Severity of the issue. - `error` union, required - object: You cannot perform any operations because the DR site is being deployed or removed. - … - object: The "DR and Direct Backup to Azure" quota is not enabled for your tenant. To enable the quota, contact the Support team. - … - object: The "Disaster recovery storage" quota is not enabled for your tenant. To enable the quota, contact the Support team. - … - object: The "Compute points" quota is not enabled for your tenant. To enable the quota, contact the Support team. - … - object: The "Cloud servers" quota is not enabled for your tenant. To enable the quota, contact the Support team. - … - object: You exceeded the "DR and Direct Backup to Azure" quota. As a result, the DR functionality was disabled on some protected servers. To increase the quota, contact the Support team. - … - object: There are no available compute points for testing the Disaster Recovery functionality. {{additionalComputePoints}} additional compute points will be added next month. To enable the complete functionality, contact your partner and activate the Disaster Recovery service. - … - object: You have exceeded the "Cloud servers" quota. To increase the quota, contact the Support team. - … - object: You have exceeded the "Compute points" quota. To increase the quota, contact the Support team. - … - object: VPN gateway error. This might happen when the last report from the VPN gateway was received too long ago or if the VPN gateway reported an error. - … - object: The operation cannot be performed due to an issue with the cloud connection agent in public cloud connection '{{connectionName}}'. Please go to Infrastructure > Public clouds, select the corresponding cloud connection, click Renew access, and follow the instructions. If the issue persists, contact support. - … - object: The operation cannot be performed due to an issue with the cloud connection agent in public cloud connection '{{connectionName}}'. Please go to Infrastructure > Public clouds, select the corresponding cloud connection, click Renew access, and follow the instructions. If the issue persists, contact support. - … - `paging` object: Response properties related to the pagination. - `count` integer, required: Number of items fetched for the current page. - `cursors` object - `after` string: Cursor that points to the next page with results, if available. - `before` string: Cursor that points to the previous page with results, if available. - `total` integer, required: Total amount of items to fetch. ## Other responses - `400`: The request could not be validated against the RAML schema. - `401`: The request was denied because the bearer access token was invalid or missing. - `403`: The request was denied because the bearer access token did not have the required privileges. - `404`: The requested resource was not found. - `429`: The response status code indicates that the service is overloaded and you must wait before the next request. - `500`: An internal server error occurred while processing the request. - `504`: Gateway time-out. --- [API](https://skmtc.dev/acronis/apis/disaster-recovery-api.md) - [All operations](https://skmtc.dev/acronis/apis/disaster-recovery-api/llms.txt) - [OpenAPI document](https://skmtc.dev/acronis/apis/disaster-recovery-api/revisions/dcf3d4b306cf?raw)