Read a backup's record from storage

GET 
/v1/points/:id/document

The backup's self-describing record, read from the repository rather than from this cloud's database. It answers for a backup this cloud has never seen.

Operator only: needs a system-scoped token.

Request

Responses

200

OK

400

Bad Request.

invalid_request: A query parameter is malformed.

401

Unauthorized.

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

403

Forbidden.

forbidden: The token is neither an operator's nor a peer cloud's.

404

Not Found.

not_found: The id is not a UUID. Or no repository has that name or id. Or the repository holds no record of this backup in the dedup domains searched.

409

Conflict.

domain_key_missing: This cloud holds no key for the dedup domain the record is in, or the key it holds did not write it. detail names the key to import.

tier_unavailable: The repository named is an rbd tier, which keeps no records.

422

Unprocessable Entity.

validation_failed: repository is missing.

503

Service Unavailable.

kms_unavailable: The record is encrypted and this site has no key manager configured.

default

An error, as an RFC 7807 problem document.