CLI Command Reference
Tasks
Backup Sharing
| API Name | Command | Description | Operation |
|---|---|---|---|
| Obtaining the Share Member List | hcloud CBR ShowMembersDetail | This API is used to obtain the list of backup share members. | |
| Adding a Share Member | hcloud CBR AddMember | This API is used to add a member with whom the backup can be shared. Only cloud server backups can be shared among tenants in the same region. | |
| Querying Share Member Details | hcloud CBR ShowMemberDetail | This API is used to obtain the details of a backup share member. | |
| Updating the Share Member Status | hcloud CBR UpdateMemberStatus | This API is used to update the status of a backup share member. | |
| Deleting a Specified Share Member | hcloud CBR DeleteMember | This API is used to delete a specified backup share member. |
Restore Points
| API Name | Command | Description | Operation |
|---|---|---|---|
| Synchronizing a Restore Point | hcloud CBR ImportCheckpoint | This API is used to synchronize backups for a vault. | |
| Querying a Restore Point | hcloud CBR ShowCheckpoint | This API is used to query a specified restore point based on its ID. | |
| Replicating a Restore Point | hcloud CBR CopyCheckpoint | This API is used to replicate a restore point. | |
| Creating a Restore Point | hcloud CBR CreateCheckpoint | This API is used to back up a vault and generate a restore point. |
Vaults
| API Name | Command | Description | Operation |
|---|---|---|---|
| Querying the Vault List | hcloud CBR ListVault | This API is used to query the vault list. | |
| Creating a Vault | hcloud CBR CreateVault | This API is used to create a vault. | |
| Querying a Specified Vault | hcloud CBR ShowVault | This API is used to query a specified vault based on its ID. | |
| Modifying a Vault | hcloud CBR UpdateVault | This API is used to modify a vault based on its ID. | |
| Deleting a Vault | hcloud CBR DeleteVault | This API is used to delete vaults. Once a vault is deleted, all backups in the vault are cleared. | |
| Dissociating Resources | hcloud CBR RemoveVaultResource | This API is used to dissociate resources from a vault. | |
| Associating Resources | hcloud CBR AddVaultResource | This API is used to associate resources with a vault. | |
| Binding a Policy to a Vault | hcloud CBR AssociateVaultPolicy | This API is used to bind a policy to a vault. | |
| Unbinding a Vault from a Policy | hcloud CBR DisassociateVaultPolicy | This API is used to unbind a vault from a policy. | |
| Querying the Vault List in Other Regions | hcloud CBR ListExternalVault | This API is used to query the vault list in other regions. | |
| Migrating Resources | hcloud CBR MigrateVaultResource | This API is used to associate resources with another vault and migrate the resource backups to that destination vault. | |
| Batch Modifying Vaults | hcloud CBR BatchUpdateVault | This API is used to batch modify all vaults in a project. | |
| Creating a Yearly/Monthly Vault | hcloud CBR CreatePostPaidVault | This API is used to create a yearly/monthly vault in a combined purchase. It is an internal API. | |
| Setting Auto Backup for a Vault | hcloud CBR SetVaultResource | This API is used to enable or disable auto backup for a vault. |
Backups
| API Name | Command | Description | Operation |
|---|---|---|---|
| Synchronizing a Backup | hcloud CBR ImportBackup | This API is used to synchronize on-premises VMware backups. | |
| Querying a Specified Backup | hcloud CBR ShowBackup | This API is used to query the backup of a specific ID. | |
| Modifying a Backup Name | hcloud CBR UpdateBackup | This API is used to modify a backup name based on a given backup ID. | |
| Deleting a Backup | hcloud CBR DeleteBackup | This API is used to delete a single backup. | |
| Querying All Backups | hcloud CBR ListBackups | This API is used to query all backups. | |
| Replicating a Backup | hcloud CBR CopyBackup | This API is used to replicate a backup across regions. | |
| Restoring a Backup | hcloud CBR RestoreBackup | This API is used to restore backup data. | |
| Querying Backup Metadata | hcloud CBR ShowMetadata | This API is used to query the metadata of the resources that are backed up. |
Policies
| API Name | Command | Description | Operation |
|---|---|---|---|
| Querying the Policy List | hcloud CBR ListPolicies | This API is used to query the policy list. | |
| Creating a Policy | hcloud CBR CreatePolicy | This API is used to create a policy. Policies are classified into backup policies and replication policies. | |
| Querying a Single Policy | hcloud CBR ShowPolicy | This API is used to query a single policy. | |
| Modifying a Policy | hcloud CBR UpdatePolicy | This API is used to modify a policy. | |
| Deleting a Policy | hcloud CBR DeletePolicy | This API is used to delete a policy. |
Protection
| API Name | Command | Description | Operation |
|---|---|---|---|
| Querying Protectable Resources | hcloud CBR ListProtectable | This API is used to query the list of resources that can be protected. | |
| Querying the Agent Status | hcloud CBR CheckAgent | This API is used to check the Agent status required by application-consistent. | |
| Querying a Specified Protectable Resource | hcloud CBR ShowProtectable | This API is used to query a specified resource that can be protected by its ID. | |
| Querying the Replication Capability | hcloud CBR ShowReplicationCapabilities | This API is used to query the replication capability of the current region. |
Projects
| API Name | Command | Description | Operation |
|---|---|---|---|
| This API is used to query the project information of a tenant. | hcloud CBR ListProjects | This API is used to query the enterprise project information of a tenant. | |
| Querying the Project List of a Tenant | hcloud CBR ListDomainProjects | This API is used to query the project list based on a specified tenant name. | |
| Querying Tenant Information | hcloud CBR ShowDomain | This is an internal API called by the console. It is used to obtain the domain name of the source project ID only when querying a shared backup. | |
| Querying the Migration | hcloud CBR ShowMigrateStatus | This API is used to query the migration result. |
Tags
| API Name | Command | Description | Operation |
|---|---|---|---|
| Querying Vault Resources | hcloud CBR ShowVaultResourceInstances | This API is used to filter resources by tag. | |
| Batch Adding or Deleting Tags of a Vault | hcloud CBR BatchCreateAndDeleteVaultTags | This API is used to add or delete tags for a specified resource in batches. | |
| Querying Tags of an Associated Resource | hcloud CBR ShowVaultTag | This API is used to query tags of a specified resource. | |
| Adding a Tag to an Associated Resource | hcloud CBR CreateVaultTags | This API is used to add a tag to an associated resource. A resource can have a maximum of 10 tags. | |
| Deleting a Tag from an Associated Resource | hcloud CBR DeleteVaultTag | This API is used to delete a tag from an associated resource. The API is idempotent. When you delete a nonexistent tag, error code 404 will be returned. Tag keys cannot be empty or be empty character strings. | |
| Querying Tags of a Vault Project | hcloud CBR ShowVaultProjectTag | This API is used to query a tenant's tag set in a specific region and of a specific instance type. |
Metering
| API Name | Command | Description | Operation |
|---|---|---|---|
| Querying Capacity Statistics | hcloud CBR ShowStorageUsage | This API is used to query capacity statistics. |
Operations
| API Name | Command | Description | Operation |
|---|---|---|---|
| Change | hcloud CBR ChangeOrder | This API is used to update the order information of a yearly/monthly product and return the information about the order to be paid. | |
| Change(Abandoned) | hcloud CBR UpdateOrder | Used for updating yearly/monthly subscription order information | |
| Changing the Payment Mode | hcloud CBR ChangeVaultChargeMode | This API is used to change the billing mode of a resource. Currently, only pay-per-use resources can be changed to yearly/monthly resources. |
Organizational Policies
| API Name | Command | Description | Operation |
|---|---|---|---|
| Querying the Organizational Policy List | hcloud CBR ListOrganizationPolicies | This API is used to query the organizational policy list. | |
| Creating an Organization Policy | hcloud CBR CreateOrganizationPolicy | This API is used to create an organization policy. | |
| Querying a Specified Organizational Policy | hcloud CBR ShowOrganizationPolicy | This API is used to query a specified organizational policy. | |
| Updating an Organization Policy | hcloud CBR UpdateOrganizationPolicy | This API is used to update an organization policy. | |
| Deleting an Organization Policy | hcloud CBR DeleteOrganizationPolicy | This API is used to delete an organization policy. | |
| Querying Organizational Policy Delivery Info | hcloud CBR ListOrganizationPolicyDetail | This API is used to query the organization policy delivery info of each account. |
File Backup
| API Name | Command | Description | Operation |
|---|---|---|---|
| Adding File Paths | hcloud CBR AddAgentPath | This API is used to add the file paths you want to back up from a client. Path validity will not be checked. | |
| Querying a Specified Client | hcloud CBR ShowAgent | This API is used to query a specified client. | |
| Modifying a Client | hcloud CBR UpdateAgent | This API is used to change the status of a client. | |
| Removing a Client | hcloud CBR UnregisterAgent | This API is used to remove a client. All backups of a client will be deleted after the client is removed. | |
| Querying the Client List | hcloud CBR ListAgent | This API is used to query the client list. | |
| Registering a Client | hcloud CBR RegisterAgent | This API is used to register a client during agent installation. This API is called automatically by the Agent. Manual registration is not required. | |
| Removing File Paths | hcloud CBR RemoveAgentPath | This API is used to remove the file paths added for backup. |
Project
| API Name | Command | Description | Operation |
|---|---|---|---|
| Tenant Migration | hcloud CBR MigrateDomain | This API is used to migrate CSBS or VBS resources to CBR. |
Vault
| API Name | Command | Description | Operation |
|---|---|---|---|
| Querying Vault Usage of a Tenant | hcloud CBR ShowSummary | This API is used to query the total capacity and used capacity of all vaults of a tenant. |
What is your overall rating for this page?
Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot