Advance Cluster Restore

Advance any currently suspended restore operation. The operation might have been suspended because (1) the user had suspended it previously, or (2) the operation is waiting for user input, to be provided as a part of the POST request body. This operation is only valid when a GET cluster/restore/status returns a status with value SUSPENDED. Otherwise, a 409 response is returned.

Request

URI

POST

https://nsxmanager.your.domain/api/v1/cluster/restore?action=advance

COPY

Request Body

AdvanceClusterRestoreRequest of type(s) application/json

Required

Show optional properties

{
    "data": [
        {
            "resources": [
                {}
            ]
        }
    ]
}

{
    "data": [
        {
            "id": "string",
            "resources": [
                {
                    "is_valid": false,
                    "target_display_name": "string",
                    "target_id": "string",
                    "target_type": "string",
                    "selected": false
                }
            ]
        }
    ]
}

array of object

data

Required

List of instructions and their associated data

Authentication

This operation uses the following authentication methods.

BasicAuth

Responses

200

Returns ClusterRestoreStatus of type(s) application/json

"ClusterRestoreStatus Object"

array of string

allowed_actions

Optional

Constraints: default:

List of actions that are allowed.

integer As int64 As int64

backup_timestamp

Optional

Timestamp when backup was initiated in epoch millisecond

array of object

endpoints

Optional

The list of allowed endpoints, based on the current state of the restore process

string

Optional

Unique id for backup request

array of object

instructions

Optional

Instructions for users to reconcile Restore operations

array of string

not_allowed_actions

Optional

Constraints: default:

List of actions that are not allowed

integer As int64 As int64

restore_end_time

Optional

Timestamp when restore was completed in epoch millisecond

integer As int64 As int64

restore_start_time

Optional

Timestamp when restore was started in epoch millisecond

object

status

Optional

Overall restore process status

object

step

Optional

Restore step info

integer As int64 As int64

total_steps

Optional

Total number of steps in the entire restore process

400

Returns BadRequest of type(s) application/json

Operation doesn't return any data structure

403

Returns Forbidden of type(s) application/json

Operation doesn't return any data structure

404

Returns NotFound of type(s) application/json

Operation doesn't return any data structure

409

Conflict

Returns ClusterRestoreStatus of type(s) application/json

"ClusterRestoreStatus Object"

array of string

allowed_actions

Optional

Constraints: default:

List of actions that are allowed.

integer As int64 As int64

backup_timestamp

Optional

Timestamp when backup was initiated in epoch millisecond

array of object

endpoints

Optional

The list of allowed endpoints, based on the current state of the restore process

string

Optional

Unique id for backup request

array of object

instructions

Optional

Instructions for users to reconcile Restore operations

array of string

not_allowed_actions

Optional

Constraints: default:

List of actions that are not allowed

integer As int64 As int64

restore_end_time

Optional

Timestamp when restore was completed in epoch millisecond

integer As int64 As int64

restore_start_time

Optional

Timestamp when restore was started in epoch millisecond

object

status

Optional

Overall restore process status

object

step

Optional

Restore step info

integer As int64 As int64

total_steps

Optional

Total number of steps in the entire restore process

412

Returns PreconditionFailed of type(s) application/json

Operation doesn't return any data structure

500

Returns InternalServerError of type(s) application/json

Operation doesn't return any data structure

503

Returns ServiceUnavailable of type(s) application/json

Operation doesn't return any data structure

Code Samples

COPY

                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{"data":["object"]}' https://{api_host}/api/v1/cluster/restore?action=advance

On This Page

Description

Request

Request Body

Authentication

Response

200 Response Body

Errors

System Administration Operations