Delete Backup | VMware Cloud Director Availability API

Delete Backup

This request deletes the specified backup, freeing the disk space it takes.

Request

URI

DELETE

https://{api_host}//backups/{backupId}

COPY

Path Parameters

string

backupId

Required

backupId

Header Parameters

string

operationID

Optional

Operation ID for correlating logs across multiple services

Authentication

This operation uses the following authentication methods.

VMware_Cloud_Director_Availability_vApp_Replication_Manager_cookie

Responses

202

Accepted

Returns ApiTaskOfVoid of type(s) application/json;charset=UTF-8

{
    "endTime": 1499929558827,
    "error": {
        "args": [],
        "code": "Forbidden",
        "msg": "Permission denied.",
        "stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
    },
    "id": "f61d60d2-698a-46dc-a266-88df27644956",
    "lastUpdated": 1499929558827,
    "progress": 100,
    "resultType": "string",
    "startTime": 1499929548951,
    "state": "SUCCEEDED",
    "user": "root",
    "warnings": [],
    "workflowInfo": {
        "resourceId": "C4VAPP-ccbe771e-b685-46c7-8c7a-4ed36915d963",
        "resourceName": "my vapp 1",
        "resourceType": "vappReplication",
        "type": "sync"
    }
}

integer As int64 As int64

endTime

Optional

Timestamp in msec of the completion time of the task. -1 means the task hasn't completed.

ApiError

error

Optional

error

string As uuid As uuid

Optional

The unique identifier of the long-running task. It is unique and can be used for monitoring.

integer As int64 As int64

lastUpdated

Optional

Timestamp in msec of the last task status update.

integer As int32 As int32

progress

Optional

Percentage-based progress of the task.

string

resultType

Optional

Indicates the type of the task result. Populated only if the execution was successful.

integer As int64 As int64

startTime

Optional

Timestamp in msec of the creation time of the task.

string

state

Optional

The current state of the task. States: [RUNNING, SUCCEEDED, FAILED]

Possible values are : RUNNING, SUCCEEDED, FAILED,

string

user

Optional

The user who started the task.

array of ResultWarning

warnings

Optional

Warnings, which occurred during the task execution.

ApiWorkflowInfo

workflowInfo

Optional

workflowInfo

401

The returned error codes include (but are not limited to):

NotAuthenticated

Returns ApiError of type(s) application/json;charset=UTF-8

{
    "args": [],
    "code": "Forbidden",
    "msg": "Permission denied.",
    "stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
}

array of string

args

Optional

Positional arguments.

string

code

Optional

Specific error code.

string

msg

Optional

Detailed error message.

string

stacktrace

Optional

Exception stacktrace.

500

The returned error codes include (but are not limited to):

GeneralServerFailure

Returns ApiError of type(s) application/json;charset=UTF-8

{
    "args": [],
    "code": "Forbidden",
    "msg": "Permission denied.",
    "stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
}

array of string

args

Optional

Positional arguments.

string

code

Optional

Specific error code.

string

msg

Optional

Detailed error message.