Todos os produtos
Search
Central de documentação

:Criar um arquivo de backup

Última atualização: Jun 26, 2026

Chame a operação CreateBackup para criar um arquivo de backup de uma instância.

Esta operação usa o recurso de backup do ApsaraDB RDS para criar um arquivo de backup. Também é possível usar uma operação do Database Backup (DBS) para criar um arquivo de backup.

Antes de chamar esta operação, confirme se os seguintes requisitos são atendidos:

  • A instância está no estado Running.

  • A instância não possui tarefas de backup em andamento.

  • O número de arquivos de backup criados por dia para uma instância não pode exceder 20.

Debugging

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para maior praticidade, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de requisição

ParameterTypeRequiredExampleDescription
ActionStringYesCreateBackup

A operação a ser executada. Defina o valor como CreateBackup.

DBInstanceIdStringYesrm-uf6wjk5****

O id da instância.

DBNameStringNords_mysql

Os nomes dos bancos de dados cujos dados você deseja incluir no backup. Separe os nomes dos bancos de dados com vírgulas (,).

Nota Especifique este parâmetro ao realizar um backup lógico em bancos de dados individuais de uma instância do ApsaraDB RDS for MySQL. Também é possível especificá-lo ao realizar um backup físico completo em bancos de dados individuais de uma instância do ApsaraDB RDS for SQL Server.
BackupStrategyStringNodb

A política a ser usada para o arquivo de backup. Valores válidos:

  • db: backup no nível de banco de dados.
  • instance: backup no nível de instância.
Nota Especifique este parâmetro ao realizar um backup lógico em uma instância do ApsaraDB RDS for MySQL. Também é possível especificá-lo ao realizar um backup físico completo em uma instância do ApsaraDB RDS for SQL Server.
BackupMethodStringNoPhysical

O tipo de backup a ser realizado. Valores válidos:

  • Logical: backup lógico
  • Physical: backup físico
  • Snapshot: backup por snapshot

Valor padrão: Physical.

Nota
  • O backup lógico só pode ser realizado quando há bancos de dados criados na instância.
  • Ao realizar um backup por snapshot em uma instância do ApsaraDB RDS for MariaDB, defina este parâmetro como Physical.
  • Para mais informações sobre os tipos de backup compatíveis, consulte Fazer backup de uma instância do ApsaraDB RDS for MySQL.
  • Ao realizar um backup por snapshot em uma instância do ApsaraDB RDS for SQL Server que usa SSDs padrão ou SSDs aprimorados (ESSD), defina este parâmetro como Snapshot.
BackupTypeStringNoAuto

O método de backup. Valores válidos:

  • Auto: o sistema determina automaticamente se deve realizar um backup completo ou incremental.
  • FullBackup: backup completo.

Valor padrão: Auto.

Nota
  • Configure este parâmetro somente quando a instância usar o mecanismo de banco de dados SQL Server.
  • Este parâmetro é válido apenas quando o parâmetro BackupMethod está definido como Physical.
ResourceGroupIdStringNorg-acfmy*****

O id do grupo de recursos.

Parâmetros de resposta

Parameter

Type

Example

Description

BackupJobId

String

5073731

O id da tarefa de backup.

RequestId

String

2C125605-266F-41CA-8AC5-3A643D4F42C5

O id da requisição.

Exemplos

Exemplos de requisição

http(s)://rds.aliyuncs.com/?Action=CreateBackup
&DBInstanceId=rm-uf6wjk5****
&<Common request parameters>

Exemplos de resposta bem-sucedida

XML format

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

<?xml version="1.0" encoding="UTF-8" ?>
<CreateBackupResponse>
    <RequestId>2C125605-266F-41CA-8AC5-3A643D4F42C5</RequestId>
    <BackupJobId>5073731</BackupJobId>
</CreateBackupResponse>

JSON format

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

{
  "RequestId" : "2C125605-266F-41CA-8AC5-3A643D4F42C5",
  "BackupJobId" : "5073731"
}

Códigos de erro

HTTP status code

Error code

Error message

Description

403

OperationDenied.ApiForbidden

operation not permitted.

A operação atual não é compatível.

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