Retire a protection group's superseded recovery
POST/v1/protection-groups/:id/retire
Removes what a superseded recovery left here once the other region has taken the workload back: the stopped, locked servers a recover built, the ports and floating addresses it gave them. Their volumes are never deleted: each is kept when its server is deleted and then released from the block storage service, leaving the underlying image where it is, named in the run's resources as an unmanaged_volume for an operator to remove. Runs only once this region has read the other region's record of recovering the group at the custody epoch held here or above; a record of another region is otherwise never a reason to remove anything.
The group's custody here becomes standby first, which is the run's point of no return, and nothing is undone after it; a run that stops is resumed. With dry_run=true the request answers 200 with the plan and starts nothing.
Any member of the project the token is scoped to.
Request
Responses
- 200
- 202
- 400
- 401
- 403
- 404
- 409
- 413
- 415
- 503
- default
OK.
With dry_run=true, the plan the run would follow. Nothing was started.
Accepted
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 may not retire this group.
Not Found.
not_found: No group with this id exists in the token's project.
Conflict.
group_busy: A run is acting on the group.
custody_not_standby: The workload runs here, because the group's custody here is active.
split_brain_risk: The group is in split_brain_risk, which only a resync or an acknowledgement clears.
no_newer_custody_elsewhere: The other region's record of recovering the group at the custody epoch held here or above has not been read here.
nothing_to_retire: The group holds no server a recover built here.
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.
Service Unavailable.
dr_not_enabled: Disaster recovery is not enabled here, or this cloud cannot delete servers or release volumes, which the detail names.
An error, as an RFC 7807 problem document.