Configuração de uma política de backup entre regiões
Função
Essa API é usada para configurar uma política de backup entre regiões. Antes de chamar essa API:
- Saiba como autorizá-la e autenticá-la.
- Obtenha a região e o ponto de extremidade necessários.
URI
PUT /v3/{project_id}/instances/{instance_id}/backups/offsite-policy
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
project_id |
Sim |
String |
ID do projeto de um locatário em uma região. Para obter esse valor, consulte Obtenção de um ID de projeto. |
instance_id |
Sim |
String |
ID da instância, que é compatível com o formato UUID. |
Parâmetros de solicitação
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
X-Auth-Token |
Sim |
String |
Token do usuário. Se o corpo de resposta a seguir for retornado para chamar a API usada para obter um token de usuário, a solicitação será bem-sucedida. Depois que a solicitação é processada, o valor de X-Subject-Token no cabeçalho da mensagem é o valor do token. |
X-Language |
Não |
String |
Tipo de linguagem da solicitação. O valor padrão é en-us. Valor:
|
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
backup_policy |
Sim |
Informações de política de backup. |
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
open_auto_backup |
Sim |
Boolean |
Se ativar o backup completo entre regiões.
|
open_incremental_backup |
Sim |
Boolean |
Se ativar o backup incremental entre regiões.
|
destination_project_id |
Sim |
String |
ID do projeto de destino para a política de backup entre regiões. ID do projeto de um locatário em uma região. Para obter esse valor, consulte Obtenção de um ID de projeto. |
destination_region |
Sim |
String |
Região de destino para a política de backup entre regiões. |
keep_days |
Sim |
Integer |
Dias de retenção de backup. Valor: 1 a 1825 |
Parâmetros de resposta
Código de status: 200
Parâmetro |
Tipo |
Descrição |
---|---|---|
result |
String |
Resultado retornado. |
Código de status: 400
Parâmetro |
Tipo |
Descrição |
---|---|---|
error_code |
String |
Código de erro. |
error_msg |
String |
Mensagem de erro. |
Código de status: 500
Parâmetro |
Tipo |
Descrição |
---|---|---|
error_code |
String |
Código de erro. |
error_msg |
String |
Mensagem de erro. |
Exemplo de solicitação
Configuração de uma política de backup entre regiões
PUT https://{endpoint}/v3/97b026aa9cc4417888c14c84a1ad9860/instances/61a4ea66210545909d74a05c27a7179ein07/backups/offsite-policy { "backup_policy" : { "open_auto_backup" : true, "open_incremental_backup" : false, "destination_project_id" : "fd710c89089a448aa2e666ab15817090", "destination_region" : "cn-north-7", "keep_days" : 1 } }
Exemplo de resposta
Código de status: 200
Bem-sucedido.
{ "result" : "success" }
Código de status
Para mais detalhes, consulte Códigos de status.
Código de erro
Para mais detalhes, consulte Códigos de erro.