Skip to main content

Recovery bindings and profiles

Recovering another region's resources here. Operator only.

recovery binding create​

Claim a resource another cloud backed up for a project here (operator).

Nothing is adopted without a binding. Once it exists, every catalogue pass adopts the resource's points into the target project, those catalogued before the binding included, and they restore like any other point. With --standby-pool the binding is warm: a standby is registered in that pool on the first adopted point and kept current by replaying each new point into it. A resource binds once.

openstack backup recovery binding create --repository <repository> \
--origin-cloud <cloud> [--source-project <project>] \
--resource <resource> --target-project <project> \
[--target-domain <domain>] [--standby-site <site>] \
[--standby-pool <pool>] [--standby-prefix <prefix>]
ArgumentDescription
--repository <repository>Repository the points are read from, by name or id. Required.
--origin-cloud <cloud>Cloud that wrote the points, as its point objects name it. Required.
--source-project <project>Project the resource belonged to there, for the record.
--resource <resource>Id of the backed-up resource in the origin cloud. Required.
--target-project <project>Project here the points are adopted into. Required.
--target-domain <domain>Domain of the target project; needed only when the service cannot look the project up.
--standby-site <site>Site the standby lives at, by name or id; defaults to this cloud's own.
--standby-pool <pool>Pool a standby is kept current in, which makes the binding warm.
--standby-prefix <prefix>Prefix for the standby's image names.

recovery binding delete​

End one or more recovery bindings (operator).

No further points are adopted and the standby's replays stop. Points already adopted stay, and so does any standby the binding registered.

openstack backup recovery binding delete <binding> [<binding> ...]
ArgumentDescription
<binding>Takes one or more.

recovery binding dry run​

Resolve what recovering a bound resource here would build (operator).

Creates nothing. Resolves one of the binding's adopted points, the newest unless --point names one, against this cloud's own flavors, networks, volume types and security groups, and answers what would be created, what will differ and what cannot be mapped. An unresolved element is accepted only by naming it with --confirm-unresolved.

openstack backup recovery binding dry run <binding> [--point <point>] \
[--profile <profile>] [--profile-file <file>] \
[--confirm-unresolved <element>]
ArgumentDescription
<binding>Binding id.
--point <point>Adopted point to resolve; defaults to the newest.
--profile <profile>Stored recovery profile to translate with, by name.
--profile-file <file>An inline profile as YAML or JSON.
--confirm-unresolved <element>Unresolved element to accept, as the resolution names it, e.g. network:net-1 (repeatable)

recovery binding list​

List recovery bindings (operator).

openstack backup recovery binding list [--repository <repository>] \
[--origin-cloud <cloud>] [--target-project <project>]
ArgumentDescription
--repository <repository>Only bindings reading this repository, by name or id.
--origin-cloud <cloud>Only bindings for points this cloud wrote.
--target-project <project>Only bindings adopting into this project.

recovery binding show​

Show a recovery binding (operator).

openstack backup recovery binding show <binding>
ArgumentDescription
<binding>Binding id.

recovery group list​

List the protection groups a repository describes (operator).

Each is the newest version of a group document another region wrote, as this region's catalogue read it. registered_as names this region's recovery of it, once one is registered with openstack backup group register.

openstack backup recovery group list <repository> [--origin-cloud <cloud>]
ArgumentDescription
<repository>Repository to read, by name or id.
--origin-cloud <cloud>Only groups this cloud wrote.

recovery profile create​

Create a recovery profile (operator).

A named, reusable translation from another cloud's flavors, networks, volume types, availability zones, security groups and key pairs to this cloud's. With no --origin-cloud it applies to points from any cloud. A restore or a binding dry-run asks for it by name.

openstack backup recovery profile create <name> [--origin-cloud <cloud>] \
[--flavor-map <from=to>] [--network-map <from=to>] \
[--subnet-map <from=to>] [--volume-type-map <from=to>] \
[--az-map <from=to>] [--security-group-map <from=to>] \
[--keypair-map <from=to>] [--floating-pool <pool>] \
[--flavor-fallback-by-spec] [--recreate-security-groups] \
[--import-keypair]
ArgumentDescription
<name>Profile name.
--origin-cloud <cloud>Cloud whose points this translates, as its point objects name it.
--flavor-map <from=to>Source to target (repeatable)
--network-map <from=to>Source to target (repeatable)
--subnet-map <from=to>Source to target (repeatable)
--volume-type-map <from=to>Source to target (repeatable)
--az-map <from=to>Source to target (repeatable)
--security-group-map <from=to>Source to target (repeatable)
--keypair-map <from=to>Source to target (repeatable)
--floating-pool <pool>
--flavor-fallback-by-specPick the nearest flavor by spec when no name matches.
--recreate-security-groupsRecreate a source security group here when none maps to it.
--import-keypairImport the source's key pair here when none maps to it.

recovery profile delete​

Delete one or more recovery profiles, by name or id (operator).

openstack backup recovery profile delete <profile> [<profile> ...]
ArgumentDescription
<profile>Takes one or more.

recovery profile list​

List recovery profiles (operator).

openstack backup recovery profile list