Consulta as configurações de backup entre regiões de uma instância do ApsaraDB for RDS.
Antes de chamar esta operação, verifique se a instância executa uma das seguintes versões de mecanismo de banco de dados e edições do RDS:
MySQL 8.0 na High-availability Edition (com SSDs locais)
MySQL 5.7 na High-availability Edition (com SSDs locais)
MySQL 5.6
Depuração
Parâmetros de solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Exemplo |
Descrição |
|
Action |
String |
Sim |
DescribeInstanceCrossBackupPolicy |
Operação a ser executada. Defina o valor como DescribeInstanceCrossBackupPolicy. |
|
DBInstanceId |
String |
Sim |
rm-uf6wjk5xxxxxxxxxx |
ID da instância. |
|
RegionId |
String |
Sim |
cn-hangzhou |
ID da região. Chame a operação DescribeRegions para consultar a lista de regiões mais recente. |
Parâmetros de resposta
| Parâmetro | Tipo | Exemplo | Descrição |
| BackupEnabled | String | Enable | Status da opção geral de backup entre regiões da instância. Valores válidos:
|
| BackupEnabledTime | String | 2019-06-12T05:44:21Z | Data e hora de ativação do backup entre regiões na instância. Segue o padrão ISO 8601 no formato aaaa-MM-ddTHH:mm:ssZ, em UTC. |
| CrossBackupRegion | String | cn-shanghai | ID da região de destino onde os backups entre regiões da instância são armazenados. |
| CrossBackupType | String | 1 | Política de salvamento dos backups entre regiões da instância. Valor padrão: 1. O valor 1 indica que todos os backups entre regiões são salvos. |
| DBInstanceDescription | String | Test database | Nome da instância. Deve ter de 2 a 256 caracteres, pode conter letras, dígitos, sublinhados (_) e hifens (-), e deve começar com uma letra. Nota O nome da instância não pode começar com http:// ou https://. |
| DBInstanceId | String | rm-uf6wjk5xxxxxxxxxx | ID da instância. |
| DBInstanceStatus | String | Running | Estado da instância. Para obter mais informações, consulte Status da instância. |
| Engine | String | mysql | Tipo do mecanismo de banco de dados. |
| EngineVersion | String | 5.6 | Versão do mecanismo de banco de dados. |
| LockMode | String | Unlock | Status de bloqueio da instância. Valores válidos:
|
| LogBackupEnabled | String | Enable | Status da opção de backup de log entre regiões da instância. Valores válidos:
|
| LogBackupEnabledTime | String | 2019-06-12T05:44:21Z | Data e hora de ativação do backup de log entre regiões na instância. Segue o padrão ISO 8601 no formato aaaa-MM-ddTHH:mm:ssZ, em UTC. |
| RegionId | String | cn-hangzhou | ID da região da instância. |
| RequestId | String | CB7667B2-72C8-497B-9BD8-3B343CEF51AB | ID da solicitação. |
| RetentType | Integer | 1 | Política de retenção dos backups entre regiões da instância. Valor padrão: 1. O valor 1 indica que a retenção segue o período especificado. |
| Retention | Integer | 15 | Número de dias de retenção dos backups entre regiões da instância. Valores válidos: 7 a 1825. |
Exemplos
Solicitações de exemplo
http(s)://rds.aliyuncs.com/? Action=DescribeInstanceCrossBackupPolicy
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&RegionId=cn-hangzhou
&<Common request parameters>
Respostas de sucesso de exemplo
Formato XML
<DescribeInstanceCrossBackupPolicyResponse>
<DBInstanceStatusDesc>ACTIVATION</DBInstanceStatusDesc>
<LockMode>Unlock</LockMode>
<BackupEnabledTime>2019-06-12T05:44:21Z</BackupEnabledTime>
<CrossBackupType>1</CrossBackupType>
<LogBackupEnabled>Enable</LogBackupEnabled>
<BackupEnabled>Enable</BackupEnabled>
<RetentType>1</RetentType>
<DBInstanceId>rm-bpxxxxx</DBInstanceId>
<DBInstanceDescription></DBInstanceDescription>
<Retention>15</Retention>
<Engine>mysql</Engine>
<LogBackupEnabledTime>2019-06-12T05:44:21Z</LogBackupEnabledTime>
<CrossBackupRegion>cn-shanghai</CrossBackupRegion>
<StorageOwner>rds</StorageOwner>
<RegionId>cn-hangzhou</RegionId>
<RequestId>CB7667B2-72C8-497B-9BD8-3B343CEF51AB</RequestId>
<EngineVersion>5.6</EngineVersion>
<StorageType>oss</StorageType>
<Endpoint></Endpoint>
<DBInstanceStatus>1</DBInstanceStatus>
</DescribeInstanceCrossBackupPolicyResponse>
Formato JSON
{
"DBInstanceStatusDesc": "ACTIVATION",
"LockMode": "Unlock",
"BackupEnabledTime": "2019-06-12T05:44:21Z",
"CrossBackupType": "1",
"LogBackupEnabled": "Enable",
"BackupEnabled": "Enable",
"RetentType": 1,
"DBInstanceId": "rm-bpxxxxx",
"DBInstanceDescription": "",
"Retention": 15,
"Engine": "mysql",
"LogBackupEnabledTime": "2019-06-12T05:44:21Z",
"CrossBackupRegion": "cn-shanghai",
"StorageOwner": "rds",
"RegionId": "cn-hangzhou",
"RequestId": "CB7667B2-72C8-497B-9BD8-3B343CEF51AB",
"EngineVersion": "5.6",
"StorageType": "oss",
"Endpoint": "",
"DBInstanceStatus": "1"
}
Códigos de erro
Para obter uma lista de códigos de erro, visite o API Error Center.