Todos os produtos
Search
Central de documentação

:Consultar configurações de backup entre regiões

Última atualização: Jun 26, 2026

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

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta ferramenta para chamar a operação, pois ela também gera dinamicamente códigos de exemplo para diferentes SDKs.

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:

  • Disable
  • Ative
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:

  • Unlock: Instância desbloqueada.
  • ManualLock: Bloqueio manual da instância.
  • LockByExpiration: Bloqueio por expiração.
  • LockByRestoration: Bloqueio automático antes de uma reversão.
  • LockByDiskQuota: Bloqueio automático por esgotamento do espaço de armazenamento. A instância fica inacessível nesta situação.
LogBackupEnabled String Enable

Status da opção de backup de log entre regiões da instância. Valores válidos:

  • Disable
  • Ative
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.