--- title: "GET /servers/{uuid}" method: GET path: "/servers/{uuid}" --- # GET /servers/{uuid} `GET /servers/{uuid}` ## Request - Base URL: `https://dev-cloud.acronis.com/api/dr/v2` - URL: `https://dev-cloud.acronis.com/api/dr/v2/servers/{uuid}` - 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 details of the cloud server. ## Path parameters - `uuid` string, required: A unique identifier of the cloud server. ## Response `200` - union - object - `type` 'PRIMARY', required: Type of the cloud server. - `primary` object, required: Additional parameters of the primary server. - `vault_id` string, required: Generic object identifier. - `_links` union[]: Links and actions related to the primary server. - union - Item05: Link to the cloud server configuration page. The link must be opened in a web browser. - `rel` 'DR_CLOUD_SERVER_PAGE', required: Identifier of the link to the cloud server configuration page. - `type` string, required: Media type of the linked resource. - `href` string, uri, required: URL of the cloud server configuration page. - Item16: Link to the page with the remote console of the cloud server. The link must be opened in a web browser. - `rel` 'DR_CLOUD_SERVER_REMOTE_CONSOLE_PAGE', required: Identifier of the link to the page with the remote console of the cloud server. - `type` string, required: Media type of the linked resource. - `href` string, uri, required: URL of the page with the remote console of the cloud server. - Item27: Link that fetches the list of recovery points that are available for the cloud server recovery and failover. - `rel` 'DR_CLOUD_SERVER_RECOVERY_POINTS', required: Identifier of the link that fetches the list of recovery points that are available for the cloud server recovery and failover. - `type` string, required: Media type of the linked resource. - `href` string, uri, required: URL from which the GET request fetches the list of recovery points that are available for the cloud server recovery and failover. - `_issues` Item08[]: Issues related to the primary server. - `link` 'DR_CLOUD_SERVER_REMOTE_CONSOLE_PAGE': Name of the affected link. - `domain` 'DisasterRecovery': Disaster Recovery domain. - `target` string, required: UUID of the cloud server on which the issue occurred. - `severity` 'ERROR', required: Severity of the issue. - `error` union, required - SiteNotReady12: You cannot perform any operations because the DR site is being deployed or removed. - `domain` 'DisasterRecovery', required - `code` 'SiteNotReady', required - ServerNotReady17: The operation is not applicable to cloud servers in this state. - `domain` 'DisasterRecovery', required - `code` 'ServerNotReady', required - `vm` object, required: Properties of the virtual machine. - `cpu` integer, required: Number of vCPU cores that will be allocated to the virtual machine. - `os` string: Information about the OS of the virtual machine. Not available if the status of the virtual machine is 'NOT_READY'. - `ram_mb` integer, required: Amount of RAM in mebibytes that will be allocated to the virtual machine. - `status` 'NOT_READY' | 'STARTED' | 'STOPPED' | 'SUSPENDED', required - `storage` object[]: Information about the disks that are configured for the virtual machine. Not available if the status of the virtual machine is 'NOT_READY'. - `id` string, required: Generic object identifier. - `protected` boolean, required: True if the disk cannot be removed. - `size_gb` integer, required: Size of the storage volume in gibibytes. - `name` string, required: Name of the cloud server. - `site_uuid` string, required: Universally unique object identifier. - `description` string, required: Description of the cloud server. - `created_at` string, date-time, required: Date and time when the cloud server was created. - `status` 'CREATING' | 'DELETING' | 'FAILING_BACK' | 'FAILBACK_DATA_TRANSFER' | 'FAILBACK_SWITCHOVER' | 'FAILBACK_VALIDATION' | 'FAILOVER_PROD' | 'FAILOVER_TEST' | 'FAILOVER_TEST_AUTO' | 'FINALIZATION' | 'FINALIZATION_FAILED' | 'RESTORING_FROM_BACKUP' | 'POWERING_OFF' | 'POWERING_ON' | 'RECONFIGURING' | 'STAND_BY' | 'STARTING_FAILBACK' | 'STARTING_FAILBACK_DATA_TRANSFER_RESUME' | 'STARTING_FAILBACK_DATA_TRANSFER_STOP' | 'STARTING_FAILBACK_SWITCHOVER_BEGIN' | 'STARTING_FAILBACK_SWITCHOVER_COMPLETE' | 'STARTING_FAILBACK_COMMIT' | 'STARTING_FAILBACK_ROLLBACK' | 'STARTING_FAILOVER_PROD' | 'STARTING_FAILOVER_TEST' | 'STARTING_FAILOVER_TEST_AUTO' | 'STOPPING_FAILOVER' | 'STOPPING_RESTORE_FROM_BACKUP', required: List of available cloud server statuses. - `uuid` string, required: Universally unique object identifier. - `public_ip` string, ipv4: Public IP address of the cloud server. Missing if the Public IP address setting of the server is not enabled. - `rpo` object: RPO and server status. - `ratio` number: Time since the last backup (in seconds) divided by the threshold (in seconds). Available only if there is a backup. - `status` 'OK' | 'WARNING' | 'ERROR' | 'CRITICAL', required: OK - compliant; warning - violates the threshold; error - violates the threshold more than 2x times; critical - violates the threshold more than 4x times. - `threshold_seconds` integer, required: Threshold for RPO status, in seconds. - `task_uuid` string: Universally unique object identifier. - object - `type` 'RECOVERY', required: Type of the cloud server. - `recovery` object, required: Additional parameters of recovery server. - `active_failover` object: Details of the failover that is in progress. Missing for servers in the STAND_BY state. - `archive_credentials_id` string: ID of the archive credentials of the backup that is used for the failover operation. Required for automated failback. Missing if failover was initiated from a non-encrypted archive. - `backup_uri` string, required: Universal URI identifier of the recovery point that is used for the failover operation. - `id` string, required: Unique identifier of the failover that is in progress. - `vault_id` string, required: Generic object identifier. - `automated_test_failover` union, required: Details of the automated test failover. All properties except the schedule are omitted if automated test failover is disabled for the server. - object: Automated test failover is disabled. - `schedule` 'NEVER', required: Schedule of the automated test failover. 'NEVER' means that automated test failover is disabled for the server. - object: Automated test failover was performed at least one time. - `recovery_point` RecoveryPoint9, required: Composite identifier of a recovery point. - `archive_id` string, required: Generic object identifier. - `backup_id` string, required: Generic object identifier. - `vault_id` string, required: Generic object identifier. - `last_start` string, date-time, required: Date and time of the last automated test failover. - `last_status` 'SUCCESS' | 'FAILURE', required: Result of the last automated test failover. - `last_task_uuid` string, required: Universally unique object identifier. - `next_start` string, date-time, nullable, required - `schedule` 'HOURLY' | 'DAILY' | 'WEEKLY' | 'MONTHLY', required: Interval at which automated test failover is performed. - `screenshot_link` string, uri, nullable, required - `screenshot_preview_link` string, uri, nullable, required - `timeout` integer, required: Timeout in seconds for the complete operation: performing a test failover, taking a screenshot, and evaluating the result. - object: Automated test failover is enabled but has not been performed yet. - `recovery_point` string, nullable, required - `last_start` string, nullable, required - `last_status` string, nullable, required - `next_start` string, date-time, nullable, required - `last_task_uuid` string, nullable, required - `schedule` 'HOURLY' | 'DAILY' | 'WEEKLY' | 'MONTHLY', required: Interval at which automated test failover is performed. - `screenshot_link` string, nullable, required - `screenshot_preview_link` string, nullable, required - `timeout` integer, required: Timeout in seconds for the complete operation: performing a test failover, taking a screenshot, and evaluating the result. - `ip_mapped` string, ipv4: Optional mapping of the specified server IP in the production network to make the server accessible during test failover. - `resource_id` string, required: Identifier of the original device that is protected by the recovery server. - `test_failover` object: Details of the test failover. - `recovery_point` RecoveryPoint9, required: Composite identifier of a recovery point. - `archive_id` string, required: Generic object identifier. - `backup_id` string, required: Generic object identifier. - `vault_id` string, required: Generic object identifier. - `last_start` string, date-time, required: Date and time of the test failover. - `last_task_uuid` string, required: Universally unique object identifier. - `_links` union[]: Links and actions related to the recovery server. - union - Item05: Link to the cloud server configuration page. The link must be opened in a web browser. - `rel` 'DR_CLOUD_SERVER_PAGE', required: Identifier of the link to the cloud server configuration page. - `type` string, required: Media type of the linked resource. - `href` string, uri, required: URL of the cloud server configuration page. - Item16: Link to the page with the remote console of the cloud server. The link must be opened in a web browser. - `rel` 'DR_CLOUD_SERVER_REMOTE_CONSOLE_PAGE', required: Identifier of the link to the page with the remote console of the cloud server. - `type` string, required: Media type of the linked resource. - `href` string, uri, required: URL of the page with the remote console of the cloud server. - Item27: Link that fetches the list of recovery points that are available for the cloud server recovery and failover. - `rel` 'DR_CLOUD_SERVER_RECOVERY_POINTS', required: Identifier of the link that fetches the list of recovery points that are available for the cloud server recovery and failover. - `type` string, required: Media type of the linked resource. - `href` string, uri, required: URL from which the GET request fetches the list of recovery points that are available for the cloud server recovery and failover. - object: Link used in a POST request to initiate a production failover of the cloud server. - `rel` 'DR_CLOUD_SERVER_START_FAILOVER_PROD', required: Identifier of the link used in a POST request to initiate a production failover of the cloud server. - `type` string, required: Media type of the response to the action. - `href` string, uri, required: URL for the POST request to start production failover for the cloud server. - object: Link to the POST request to start test failover for the cloud server. - `rel` 'DR_CLOUD_SERVER_START_FAILOVER_TEST', required: Identifier of the link to the POST request to start test failover for the cloud server. - `type` string, required: Media type of the response to the action. - `href` string, uri, required: URL for the POST request to start test failover for the cloud server. - object: Link to the POST request to stop failover for the cloud server. - `rel` 'DR_CLOUD_SERVER_STOP_FAILOVER', required: Identifier of the link to the POST request to stop failover for the cloud server. - `type` string, required: Media type of the response to the action. - `href` string, uri, required: URL for the POST request to stop failover for the cloud server. - `_issues` union[]: Issues related to the recovery server. - union: Describes a single issue (constraint violation). - Item08: Describes a single issue (constraint violation). - `link` 'DR_CLOUD_SERVER_REMOTE_CONSOLE_PAGE': Name of the affected link. - `domain` 'DisasterRecovery': Disaster Recovery domain. - `target` string, required: UUID of the cloud server on which the issue occurred. - `severity` 'ERROR', required: Severity of the issue. - `error` union, required - SiteNotReady12: You cannot perform any operations because the DR site is being deployed or removed. - … - ServerNotReady17: The operation is not applicable to cloud servers in this state. - … - object: Describes a single issue (constraint violation). - `link` 'DR_CLOUD_SERVER_START_FAILOVER_PROD' | 'DR_CLOUD_SERVER_START_FAILOVER_TEST': Name of the affected link. - `domain` 'DisasterRecovery': Disaster Recovery domain. - `target` string, required: UUID of the cloud server on which the issue occurred. - `severity` 'ERROR', required: Severity of the issue. - `error` union, required - SiteNotReady12: 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: 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. - … - VPNGatewayUnreachable14: 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. - … - NotAllowed15: Method specified in REST request is not allowed. - … - object: With Demo Disaster Recovery, you cannot perform a test failover of more than {{testFailoverMaxNumber}} recovery servers at the same time. To perform a test failover of more than {{testFailoverMaxNumber}} recovery servers at the same time, contact your partner and activate the Disaster Recovery service. - … - 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. - … - ResourceBusy16: The resource is busy, another task is currently in progress. Try again later. - … - object: Operation is not allowed for the server because it does not have an active disaster recovery license. - … - ServerNotReady17: The operation is not applicable to cloud servers in this state. - … - object: Describes a single issue (constraint violation). - `link` 'DR_CLOUD_SERVER_STOP_FAILOVER': Name of the affected link. - `domain` 'DisasterRecovery': Disaster Recovery domain. - `target` string, required: UUID of the cloud server on which the issue occurred. - `severity` 'ERROR', required: Severity of the issue. - `error` union, required - SiteNotReady12: You cannot perform any operations because the DR site is being deployed or removed. - … - VPNGatewayUnreachable14: 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. - … - NotAllowed15: Method specified in REST request is not allowed. - … - ResourceBusy16: The resource is busy, another task is currently in progress. Try again later. - … - ServerNotReady17: The operation is not applicable to cloud servers in this state. - … - `vm` object, required: Properties of the virtual machine. - `cpu` integer, required: Number of vCPU cores that will be allocated to the virtual machine. - `os` string: Information about the OS of the virtual machine. Not available if the status of the virtual machine is 'NOT_READY'. - `ram_mb` integer, required: Amount of RAM in mebibytes that will be allocated to the virtual machine. - `status` 'NOT_READY' | 'STARTED' | 'STOPPED' | 'SUSPENDED', required - `storage` object[]: Information about the disks that are configured for the virtual machine. Not available if the status of the virtual machine is 'NOT_READY'. - `id` string, required: Generic object identifier. - `protected` boolean, required: True if the disk cannot be removed. - `size_gb` integer, required: Size of the storage volume in gibibytes. - `name` string, required: Name of the cloud server. - `site_uuid` string, required: Universally unique object identifier. - `description` string, required: Description of the cloud server. - `created_at` string, date-time, required: Date and time when the cloud server was created. - `status` 'CREATING' | 'DELETING' | 'FAILING_BACK' | 'FAILBACK_DATA_TRANSFER' | 'FAILBACK_SWITCHOVER' | 'FAILBACK_VALIDATION' | 'FAILOVER_PROD' | 'FAILOVER_TEST' | 'FAILOVER_TEST_AUTO' | 'FINALIZATION' | 'FINALIZATION_FAILED' | 'RESTORING_FROM_BACKUP' | 'POWERING_OFF' | 'POWERING_ON' | 'RECONFIGURING' | 'STAND_BY' | 'STARTING_FAILBACK' | 'STARTING_FAILBACK_DATA_TRANSFER_RESUME' | 'STARTING_FAILBACK_DATA_TRANSFER_STOP' | 'STARTING_FAILBACK_SWITCHOVER_BEGIN' | 'STARTING_FAILBACK_SWITCHOVER_COMPLETE' | 'STARTING_FAILBACK_COMMIT' | 'STARTING_FAILBACK_ROLLBACK' | 'STARTING_FAILOVER_PROD' | 'STARTING_FAILOVER_TEST' | 'STARTING_FAILOVER_TEST_AUTO' | 'STOPPING_FAILOVER' | 'STOPPING_RESTORE_FROM_BACKUP', required: List of available cloud server statuses. - `uuid` string, required: Universally unique object identifier. - `public_ip` string, ipv4: Public IP address of the cloud server. Missing if the Public IP address setting of the server is not enabled. - `rpo` object: RPO and server status. - `ratio` number: Time since the last backup (in seconds) divided by the threshold (in seconds). Available only if there is a backup. - `status` 'OK' | 'WARNING' | 'ERROR' | 'CRITICAL', required: OK - compliant; warning - violates the threshold; error - violates the threshold more than 2x times; critical - violates the threshold more than 4x times. - `threshold_seconds` integer, required: Threshold for RPO status, in seconds. - `task_uuid` string: Universally unique object identifier. ## 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)