Back up now

POST 
/v1/points

Takes a backup outside the schedule. Name plan_id to run a plan, for every resource it protects or for those in resource_ids. Name resource_kind, resource_id and vault_id to back up one server or volume into a vault. The backup is kept until keep_until, or until deleted with until_deleted where the vault offers it, within the vault's terms.

Any member of the project the token is scoped to.

Request

Responses

202

Accepted

400

Bad Request.

invalid_request: The body is not a single JSON object, names a field this operation does not take, or gives a value of the wrong type.

401

Unauthorized.

unauthenticated: The token is missing, expired or not valid.

403

Forbidden.

forbidden: The token may not take backups in this project. Or the plan's policy keeps its backups where no vault is offered. Or the vault takes no manual backups.

quota_exceeded: The project is over its backup quota.

404

Not Found.

not_found: The plan does not exist or is not visible to this token. Or the server or volume does not exist in the token's project.

409

Conflict.

conflict: The plan is deleted, or names no usable protection policy. Or the resource is in more than one plan that keeps its backups in this vault, so plan_id must say which. Or the resource is encrypted with its own key in a plan that keeps it elsewhere or names no policy. Or a backup of one resource was asked for with a token scoped to no project. Or one of the resource's disks cannot be read, so it cannot be backed up in full outside a plan.

placement_unsatisfiable: The plan's policy cannot be served right now. unsatisfied says what is wrong.

413

Request Entity Too Large.

body_too_large: The body is larger than the service accepts.

415

Unsupported Media Type.

unsupported_media_type: The body is not sent as application/json.

422

Unprocessable Entity.

validation_failed: A field is not acceptable, and fields names each one. plan_id is not a UUID and no resource_id was named. plan_id came with resource_kind, resource_id, vault_id, policy_id or consistency. resource_ids names a resource the plan does not protect. resource_kind is not instance or volume. vault_id is not a UUID, or names no vault this project is offered. vault_id and policy_id were both sent, or neither was. policy_id names no usable policy, or one whose storage no vault offers. consistency is not crash or filesystem, or differs from the level of the plan the resource is in. keep_until is outside the vault's bounds, is missing where there is no default, or was sent with until_deleted. until_deleted is not offered by the vault.

429

Too Many Requests.

rate_limited: The vault's daily allowance of manual backups is used up, for the plan or for this project outside its plans.

503

Service Unavailable.

discovery_unavailable: A backup of one resource was asked for, and the service cannot inspect the resource or prove which project owns it.

default

An error, as an RFC 7807 problem document.