Todos os produtos
Search
Central de documentação

:Consultar o intervalo de tempo para restauração de dados com um arquivo de backup entre regiões

Última atualização: Jun 26, 2026

Chame a operação DescribeAvailableRecoveryTime para consultar o intervalo de tempo para o qual é possível restaurar dados usando um arquivo de backup entre regiões.

Para consultar o intervalo de tempo para restauração de dados com um arquivo de backup comum, consulte DescribeBackups.

Antes de chamar esta operação, verifique se a instância executa um dos seguintes mecanismos de banco de dados:

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Parâmetro de requisição

Parameter

Type

Required

Example

Description

Action

String

Yes

DescribeAvailableRecoveryTime

The operation that you want to perform. Defina the value to DescribeAvailableRecoveryTime.

CrossBackupId

Integer

Yes

14377

The ID of the cross-region backup file. You can call the DescribeCrossRegionBackups operation to query IDs of backup files.

RegionId

String

No

cn-hangzhou

The ID of the region.

ResourceGroupId

String

No

rg-acfmy*

The ID of the resource group.

DBInstanceId

String

No

rm-uf6wjk5*

The ID of the instance. You can call the DescribeDBInstances operation to query the ID of the instance.

Parâmetros de resposta

Parameter

Type

Example

Description

RecoveryEndTime

String

2019-06-12T07:33:12Z

The end time to which data can be restored. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.

RequestId

String

8CCBF4BA-7CE1-47E1-B49F-E97EA200A40D

The ID of the request.

CrossBackupId

Integer

14377

The ID of the cross-region backup file.

RecoveryBeginTime

String

2019-06-12T05:22:29Z

The start time to which data can be restored. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.

RegionId

String

cn-hangzhou

The region ID of the source instance.

Exemplos

Exemplos de requisição

http(s)://rds.aliyuncs.com/?Action=DescribeAvailableRecoveryTime
&CrossBackupId=14377
&<Common request parameters>

Exemplos de resposta bem-sucedida

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeAvailableRecoveryTimeResponse>
<RecoveryEndTime>2019-06-12T07:33:12Z</RecoveryEndTime>
    <RecoveryBeginTime>2019-06-12T05:22:29Z</RecoveryBeginTime>
    <RequestId>8CCBF4BA-7CE1-47E1-B49F-E97EA200A40D</RequestId>
    <RegionId>cn-hangzhou</RegionId>
    <CrossBackupId>14377</CrossBackupId>
</DescribeAvailableRecoveryTimeResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RecoveryEndTime" : "2019-06-12T07:33:12Z",
  "RecoveryBeginTime" : "2019-06-12T05:22:29Z",
  "RequestId" : "8CCBF4BA-7CE1-47E1-B49F-E97EA200A40D",
  "RegionId" : "cn-hangzhou",
  "CrossBackupId" : 14377
}

Códigos de erro

HTTP status code

Error code

Error message

Description

400

NoAvailableLogBackup

No available log backup.

Nenhum arquivo de backup disponível foi encontrado.

400

NoAvailableDisasterRestoreBakset

No available disaster restore bakset.

Nenhum arquivo de backup disponível foi encontrado.

403

CrossBackupNotSupport

Specified region not support cross region backup.

O backup entre zonas não é compatível com a região especificada.

404

InvalidBackupSetID.NotFound

Specified backup set ID does not exist.

O arquivo de backup especificado não existe. Verifique os arquivos de backup existentes.

Para obter a lista de códigos de erro, acesse o API Error Center.