Create a vault
POST/v1/vaults
Gives a repository the name, description and terms that projects see. The terms say how long a manual backup may be kept there, whether it may be kept until deleted, and how many may be taken a day. A vault on a locked repository is immutable. A repository has at most one vault.
Operator only: needs a system-scoped token.
Request
Responses
- 201
- 400
- 401
- 403
- 409
- 413
- 415
- 422
- default
Created
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.
Unauthorized.
unauthenticated: The token is missing, expired or not valid.
Forbidden.
forbidden: The token lacks the vault:write permission.
Conflict.
conflict: A vault with this name, or on this repository, already exists.
Request Entity Too Large.
body_too_large: The body is larger than the service accepts.
Unsupported Media Type.
unsupported_media_type: The body is not sent as application/json.
Unprocessable Entity.
validation_failed: A field is not acceptable, and fields names each one. repository_id is missing, not a UUID, not registered or not a chunk repository. name is empty or longer than 191 characters. max_keep does not parse, is below a day or the repository's lock floor, or is above the lock the repository or the cloud allows. until_deleted is set on a locked repository. max_per_day is negative.
An error, as an RFC 7807 problem document.