Modifica as configurações da política de backup de uma instância ApsaraDB RDS.
Descrição da operação
Mecanismos compatíveis
RDS MySQL
RDS PostgreSQL
RDS SQL Server
RDS MariaDB
Documentação relacionada
Configurar uma política de backup automático para uma instância ApsaraDB RDS for MySQL
Configurar uma política de backup automático para uma instância ApsaraDB RDS for PostgreSQL
Configurar uma política de backup automático para uma instância ApsaraDB RDS for SQL Server
Configurar uma política de backup automático para uma instância ApsaraDB RDS for MariaDB
Experimente agora
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
rds:ModifyBackupPolicy |
update |
*DBInstance.
|
|
Nenhuma |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| DBInstanceId |
string |
Sim |
O ID da instância. Você pode chamar DescribeDBInstances para consultar o ID da instância. |
rm-uf6wjk5**** |
| BackupPolicyMode |
string |
Não |
O tipo da política de backup. Valores válidos:
|
DataBackupPolicy |
| PreferredBackupTime |
string |
Não |
O horário em que a tarefa de backup será executada. Formato: HH:mmZ-HH:mmZ (UTC). Nota
|
00:00Z-01:00Z |
| PreferredBackupPeriod |
string |
Não |
O ciclo de backup. Especifique pelo menos dois dias. Separe múltiplos valores com vírgulas (,). Valores válidos:
Nota
|
Monday |
| BackupRetentionPeriod |
string |
Não |
O número de dias durante os quais os backups de dados são retidos. Valores válidos: 7 a 730. Nota
|
7 |
| BackupLog |
string |
Não |
Especifica se o backup de log deve ser ativado. Valores válidos:
Para instâncias SQL Server, o backup de log é ativado por padrão e não pode ser desativado. No entanto, você pode modificar a frequência de backup de log da seguinte forma:
Nota
Este parâmetro entra em vigor somente quando BackupPolicyMode está definido como DataBackupPolicy e é usado para ativar ou desativar o backup de log. |
Enable |
| LogBackupRetentionPeriod |
string |
Não |
O número de dias durante os quais os backups de log são retidos. Valores válidos: 7 a 730. O valor não pode ser maior que o número de dias durante os quais os backups de dados são retidos. Nota
|
7 |
| EnableBackupLog |
string |
Não |
Especifica se o backup de log da instância deve ser ativado para instâncias MySQL, PostgreSQL e MariaDB. Valores válidos:
Nota
|
1 |
| EnablePitrProtection |
boolean |
Não |
Especifica se a recuperação point-in-time deve ser ativada para instâncias MySQL. Valores válidos:
Nota
Este parâmetro entra em vigor somente quando BackupPolicyMode está definido como DataBackupPolicy e BackupLog está definido como Enable. Para mais informações, consulte Configurar uma política de recuperação point-in-time. |
True |
| LocalLogRetentionHours |
string |
Não |
O número de horas durante as quais os backups de log da instância são retidos na instância MySQL. Valores válidos: 0 a 168 (7 × 24). O valor 0 indica que os backups de log da instância não são retidos. Nota
Este parâmetro entra em vigor somente quando BackupPolicyMode está definido como LogBackupPolicy e é obrigatório neste caso. |
18 |
| LocalLogRetentionSpace |
string |
Não |
O uso máximo do espaço de armazenamento de log local para uma instância MySQL. Se o uso exceder este valor, o sistema começará a limpar os logs binários a partir do mais antigo até que o uso fique abaixo deste limite. Valores válidos: 0 a 50. O valor padrão não é modificado. Nota
Este parâmetro entra em vigor somente quando BackupPolicyMode está definido como LogBackupPolicy e é obrigatório neste caso. |
30 |
| HighSpaceUsageProtection |
string |
Não |
Especifica se os logs binários devem ser limpos incondicionalmente quando o uso de disco de uma instância MySQL exceder 80% ou o espaço em disco restante for inferior a 5 GB. Valores válidos: Enable | Disable. O valor padrão não é modificado. Nota
Este parâmetro entra em vigor somente quando BackupPolicyMode está definido como LogBackupPolicy e é obrigatório neste caso. |
Enable |
| LogBackupFrequency |
string |
Não |
A frequência de backup de log para instâncias SQL Server. Valores válidos:
Nota
Este parâmetro entra em vigor somente quando BackupPolicyMode está definido como DataBackupPolicy. |
LogInterval |
| CompressType |
string |
Não |
O método de compressão de backup. Valores válidos:
Nota
Este parâmetro entra em vigor somente quando BackupPolicyMode está definido como DataBackupPolicy. |
4 |
| ArchiveBackupRetentionPeriod |
string |
Não |
O número de dias durante os quais os backups arquivados são retidos. O valor padrão é 0, o que indica que o backup arquivado não está ativado. Valores válidos: 30 a 1095. Nota
Este parâmetro entra em vigor somente quando BackupPolicyMode está definido como DataBackupPolicy. |
365 |
| ArchiveBackupKeepPolicy |
string |
Não |
O ciclo de retenção para backups arquivados. O número de backups que podem ser retidos dentro deste ciclo é determinado por ArchiveBackupKeepCount. O valor padrão é 0. Valores válidos:
Nota
Este parâmetro entra em vigor somente quando BackupPolicyMode está definido como DataBackupPolicy. |
ByMonth |
| ArchiveBackupKeepCount |
integer |
Não |
O número de backups arquivados a reter. O valor padrão é 1. Valores válidos:
Nota
|
1 |
| ReleasedKeepPolicy |
string |
Não |
A política de retenção de dados para backups arquivados de instâncias MySQL excluídas. Valores válidos:
Nota
|
None |
| LogBackupLocalRetentionNumber |
integer |
Não |
O número de logs binários a reter na instância. O valor padrão é 60. Valores válidos: 6 a 100. Nota
|
60 |
| Category |
string |
Não |
Especifica se o backup em segundos deve ser ativado. Valores válidos:
Nota
Este parâmetro entra em vigor somente quando BackupPolicyMode está definido como DataBackupPolicy. |
Standard |
| BackupInterval |
string |
Não |
A frequência de backup de snapshot. Valores válidos:
Nota
|
30 |
| BackupMethod |
string |
Não |
O método de backup para instâncias SQL Server com discos em nuvem. Valores válidos:
Nota
Este parâmetro entra em vigor somente quando BackupPolicyMode está definido como DataBackupPolicy. |
Physical |
| EnableIncrementDataBackup |
boolean |
Não |
Especifica se o backup incremental deve ser ativado para instâncias SQL Server com discos em nuvem ou instâncias MySQL com SSDs locais. Valores válidos:
Nota
Este parâmetro entra em vigor somente quando BackupPolicyMode está definido como DataBackupPolicy. |
False |
| IncBackupInterval |
integer |
Não |
A frequência de backup incremental de alta frequência para instâncias MySQL com SSDs locais. Valores válidos:
Nota
Este parâmetro entra em vigor somente quando EnableIncrementDataBackup está definido como True. |
120 |
| BackupPriority |
integer |
Não |
A configuração de backup na instância secundária para instâncias SQL Server Cluster Edition. Valores válidos:
Nota
|
2 |
| EnableAdvancedBackupPolicy |
integer |
Não |
||
| AdvancedDataPolicies |
array<object> |
Não |
||
|
object |
Não |
|||
| StrategyId |
string |
Não |
||
| ActionType |
string |
Não |
||
| OnlyPreserveOneEachHour |
boolean |
Não |
||
| RetentionValue |
integer |
Não |
||
| BakType |
string |
Não |
||
| FilterKey |
string |
Não |
||
| FilterValue |
string |
Não |
||
| DestType |
string |
Não |
||
| FilterType |
string |
Não |
||
| SrcRegion |
string |
Não |
||
| OnlyPreserveOneEachDay |
boolean |
Não |
||
| SrcType |
string |
Não |
||
| DestRegion |
string |
Não |
||
| RetentionType |
string |
Não |
||
| AdvancedLogPolicies |
array<object> |
Não |
||
|
object |
Não |
|||
| StrategyId |
string |
Não |
||
| ActionType |
string |
Não |
||
| LogRetentionType |
string |
Não |
||
| DestType |
string |
Não |
||
| EnableLogBackup |
integer |
Não |
||
| SrcType |
string |
Não |
||
| SrcRegion |
string |
Não |
||
| LogRetentionValue |
integer |
Não |
||
| DestRegion |
string |
Não |
||
| FilterKey |
string |
Não |
||
| FilterValue |
string |
Não |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
Os parâmetros de resposta. |
||
| CompressType |
string |
O método de compressão de backup. Valores válidos:
|
4 |
| DBInstanceID |
string |
O ID da instância. |
rm-uf6wjk5**** |
| EnableBackupLog |
string |
Indica se o backup de log da instância está ativado. Valores válidos:
Nota
O backup de log da instância para instâncias SQL Server é ativado por padrão e não pode ser desativado. |
1 |
| HighSpaceUsageProtection |
string |
Indica se os logs binários são limpos incondicionalmente quando o uso de disco de uma instância MySQL excede 80% ou o espaço em disco restante é inferior a 5 GB. |
Disable |
| LocalLogRetentionHours |
integer |
O número de horas durante as quais os backups de log da instância são retidos na instância MySQL. |
18 |
| LocalLogRetentionSpace |
string |
O uso máximo do espaço cíclico de logs binários para a instância MySQL. |
30 |
| LogBackupLocalRetentionNumber |
integer |
O número de logs binários retidos na instância MySQL. |
60 |
| RequestId |
string |
O ID da solicitação. |
DA147739-AEAD-4417-9089-65E9B1D8240D |
| EnableIncrementDataBackup |
boolean |
||
| IncBackupInterval |
integer |
||
| EnablePitrProtection |
boolean |
Exemplos
Resposta de sucesso
JSON formato
{
"CompressType": "4",
"DBInstanceID": "rm-uf6wjk5****",
"EnableBackupLog": "1",
"HighSpaceUsageProtection": "Disable",
"LocalLogRetentionHours": 18,
"LocalLogRetentionSpace": "30",
"LogBackupLocalRetentionNumber": 60,
"RequestId": "DA147739-AEAD-4417-9089-65E9B1D8240D",
"EnableIncrementDataBackup": false,
"IncBackupInterval": 0,
"EnablePitrProtection": false
}
Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|---|---|---|---|
| 400 | InvalidColdRetention.Format | Invalid cold retention format. | |
| 400 | InvalidLogBackupFrequency.Malformed | Invalid log backup frequency. | A frequência de backup de log (LogBackupFrequency) é inválida. Verifique se o parâmetro é válido. |
| 400 | InvalidBackupRetentionPeriod.Malformed | The specified backup retention period is invalid. | O ciclo de backup é inválido. O ciclo de backup deve ser maior que 1 dia e menor ou igual a 30 dias. |
| 400 | BackupPropertyNotFound | Backup policy not found | A operação falhou. A política de backup não foi encontrada. |
| 400 | OperationDenied.SwitchToSnapshot | Snapshot backup does not support cross region storage at present. Please turn off cross region backup before switching to snapshot backup mode. | A operação falhou. Os backups de snapshot não suportam armazenamento entre regiões. Desative o backup entre regiões antes de alternar para o modo de backup de snapshot. |
| 400 | InvalidReleasedKeepPolicy.Format | Specified Released Keep Policy is not valid. | A política de retenção de dados de backup arquivados após a liberação da instância é inválida. |
| 400 | IncorrectBackupPolicy | The current instance has an advanced backup policy enabled. Currently, you cannot use the OpenAPI to modify the backup policy. You need to modify the backup policy in the console. | A instância atual tem uma política de backup avançada ativada. A modificação da política de backup usando o OpenAPI não é suportada. Modifique a política de backup no console. |
| 400 | Order.ComboInstanceNotAllowOperate | A package instance is not allowed to operate independently. | Operações individuais não são permitidas para instâncias de pacote. |
| 400 | Price.PricingPlanResultNotFound | Pricing plan price result not found. | O resultado do preço do plano de preços não foi encontrado. |
| 400 | Order.NoRealNameAuthentication | You have not passed the real-name authentication and do not meet the purchase conditions. Please log in to the user center for real-name authentication. | Você não concluiu a verificação de nome real e não está elegível para fazer uma compra. Faça login em Despesas e Custos para concluir a verificação de nome real. |
| 400 | InsufficientAvailableQuota | Your account quota limit is less than 0, please recharge before trying to purchase. | O crédito disponível da sua conta é menor que 0. Recarregue sua conta antes de tentar fazer uma compra. |
| 400 | CommodityServiceCalling.Exception | Failed to call commodity service. | A chamada para o serviço de commodity retornou uma falha. |
| 400 | RegionDissolvedEOM | Dear customer, Alibaba Cloud plans to optimize and adjust the current region. Cloud services in this region will cease operations. You are currently unable to operate new purchase orders. Thank you for your understanding and support. | O Alibaba Cloud planeja otimizar e ajustar a região atual. Os serviços em nuvem nesta região serão descontinuados. Para garantir a continuidade dos seus negócios e uma migração de dados tranquila, você não pode fazer novos pedidos de compra no momento. Agradecemos sua compreensão e apoio. |
| 400 | Commodity.InvalidComponent | The module you purchased is not legal, please buy it again. | O módulo adquirido é inválido. Adquira um módulo válido. |
| 400 | RegionEndTimeDissolvedAustralia | Cloud services in the Australia (Sydney) region will be discontinued. Set the validity date to September 30, 2024 or earlier than September 30, 2024. | A região foi desativada. |
| 400 | Price.CommoditySys | Commodity system call exception. | Ocorreu uma exceção ao chamar o sistema de commodities. |
| 400 | Pay.InsufficientBalance | Insufficient available balance. | |
| 400 | Order.PeriodInvalid | There is a problem with the period you selected, please choose again. | O período de assinatura selecionado é inválido. Selecione um período de assinatura válido. |
| 400 | pay.noCreditCard | Account not bound to credit card. | A conta não está associada a um cartão de crédito. |
| 400 | Order.InstHasUnpaidOrder | There is an unpaid order for the service you have purchased. Please pay or void it before placing the order. | Existe um pedido não pago para o serviço selecionado. Pague ou cancele o pedido antes de fazer um novo. |
| 400 | noAvailablePaymentMethod | No payment method is specified for your account. We recommend that you add a payment method. | Nenhum método de pagamento está especificado para a conta. Adicione um método de pagamento. |
| 400 | BasicInfoUncompleted | Your information is incomplete. Complete your information before the operation. | Suas informações básicas estão incompletas. Complete suas informações básicas antes de realizar esta operação. |
| 400 | Risk.RiskControlRejection | Your account is abnormal, please contact customer service for details. | Ocorreu uma exceção com a sua conta. Entre em contato com o atendimento ao cliente para obter detalhes. |
| 400 | Api.NotSupport | Specified api is not supported. | A operação de API atual não é suportada. |
| 400 | ContainForbiddenLabelError | There is a label that prohibits placing orders. Please contact your distributor for assistance. | Existe uma tag de bloqueio de pedido. Entre em contato com seu distribuidor para obter assistência. |
| 400 | InvalidDBInstanceId.NotFound | The DBInstanceId provided does not exist in records. | O DBInstanceId especificado não existe. |
| 400 | InvalidInstanceLevel.DiskType | Specified instance level not support request disk type | O tipo de instância atual não oferece suporte ao tipo de armazenamento especificado. |
| 400 | InvalidParam | Sepcified wal level Parameter is invalid. There are still logical slots in instance, so it can not be set as replica. | O parâmetro de entrada é inválido. |
| 400 | KmsApiError | User secret key invalid. | A chave do usuário é inválida. |
| 400 | System.SaleValidateFailed | Sales expression validation system error. | |
| 400 | Abs.InvalidAccount.NotFound | account is not found. | Sua conta da Alibaba Cloud não existe ou sua AccessKey expirou. |
| 400 | SqlExecuteFailedOrTimeout | sql command execution failed or timed out:%s. | A execução do comando SQL falhou ou expirou. |
| 400 | ColdData.EngineVersionNotSupport | The current instance engine version not support coldDataEnabled. | A versão atual do mecanismo DPI da instância não suporta o arquivamento de dados frios. |
| 400 | ColdData.MinorVersionNotSupport | The current instance minor version not support coldDataEnabled. | A versão atual do kernel não suporta o arquivamento de dados frios. |
| 400 | IncorrectTargetClasscode | The current instance type does not support this operation. | O tipo de instância atual não oferece suporte a esta operação. |
| 400 | InvalidConnectionString.Duplicate | Specified connection string already exists in the RDS. | O nome do endereço de conexão está duplicado. Reconfigure a string de conexão. |
| 400 | RequiredParam.NotFound | Required input param is not found. | Parâmetros obrigatórios estão ausentes. |
| 400 | Parameters.Invalid | Parameter error, please check the parameters. | O parâmetro está incorreto. Verifique o parâmetro. |
| 400 | BackupPolicyNotSupport | Cold Data won't open with CrossBackup or Flash Backup, please check Backup Policy. | O arquivamento de dados frios não oferece suporte a backup entre regiões ou backup de snapshot de alta frequência. Verifique a política de backup. |
| 400 | InvalideStatus.Format | The instance status does not support this operation. | O status da instância não suporta esta operação. |
| 400 | InvalidDBInstanceEngineType.Format | the DB instance engine type does not support this operation. | O tipo de mecanismo de banco de dados da instância não oferece suporte a esta operação. |
| 400 | Pay.NoCreditCard | No credit cards. | |
| 400 | VpcNetworkTypeNotSupport | The vpc network type instance does not support this operation. | Esta operação não é suportada para instâncias do tipo de rede VPC. |
| 400 | MirrorInsExists | Specified DB instance mirror ins already existed. | A imagem da instância de banco de dados atual já existe. |
| 400 | UnsupportedClassCode | The specified DB instance class stops selling. | O tipo de instância não está mais disponível para compra. |
| 400 | InvalidBackupSet | The specified database does not exist in the backup set. | O banco de dados especificado não existe no conjunto de backup. |
| 400 | OrdTCommodityQueryError | Failed to query for product. | Falha ao consultar o produto. |
| 400 | ProductInstanceReleased | The instance has been released. Please check before placing the order. | A instância foi liberada. Verifique a instância antes de fazer o pedido. |
| 400 | RegionEndTimeDissolvedIndia | The region is no longer supported. | A região foi desativada. |
| 400 | InvalidDiskType | Current disk type does not support this operation. | O tipo de disco atual não oferece suporte a esta operação. |
| 400 | InvalidIncrementBackupInterval.Malformed | Parameter 'IncBackupInterval' is invalid. | O valor do parâmetro IncBackupInterval é inválido. |
| 400 | InvalidLocalLogRetentionSpace.Malformed | Parameter 'LocalLogRetentionSpace' is invalid. | O valor do parâmetro LocalLogRetentionSpace é inválido. |
| 400 | InvalidLocalLogRetentionHours.Malformed | Parameter 'LocalLogRetentionHours' is invalid. | O valor do parâmetro LocalLogRetentionHours é inválido. |
| 400 | InvalidLogBackupLocalRetentionNumber.Malformed | Parameter 'LogBackupLocalRetentionNumber' is invalid. | O valor do parâmetro LogBackupLocalRetentionNumber é inválido. |
| 400 | InvalidBackupInterval.Unsupported | BackupInterval can be configured only when Category is set to Standard. The current instance is set to Flash. Please set Category to Standard. | A instância atual tem o backup em segundos (Category=Flash) ativado. O parâmetro BackupInterval pode ser configurado apenas quando Category estiver definido como Standard. Nas Configurações, defina Category como Standard antes de configurar o parâmetro BackupInterval. |
| 400 | InvalidPitrSetting | Log backup is disabled. Enable PITR requires log backup to be enabled. | O backup de log está desativado. Para ativar a recuperação point-in-time, ative primeiro o backup de log. |
| 500 | ExternalFailure | The request processing has failed due to external service failure. | A solicitação para o serviço falhou. Tente novamente mais tarde. |
| 500 | RequestMetaDataFailed | The service request failed. Please try again later or contact service personnel. | A solicitação de serviço falhou. Tente novamente mais tarde ou entre em contato com o suporte. |
| 500 | InvokeProxyFailure | The request processing has failed due to service failure of rds api. | A solicitação falhou porque o serviço da API do RDS apresentou falha. |
| 403 | IncorrectCategory | Current Instance type does not support Category. | O tipo de instância atual não suporta esta categoria. |
| 403 | OperationDenied.SwitchSnapshotToPhysical | Only physical backup to snapshot backup is supported. | Esta operação oferece suporte apenas à alteração de backup físico para backup de snapshot. |
| 403 | OperationDenied.ModifyBackupSwitchOff | The switch is not turned on. It is forbidden to modify the backup mode. | O switchover falhou porque o backup entre regiões não está ativado. |
| 403 | OperationDenied.ApiForbiddenForLogBackupFrequency | When the instance is a snapshot backup, the log backup frequency is not allowed to be consistent with the data backup. | Quando a instância usa backup de snapshot, a frequência de backup de log não pode ser definida como "Igual ao backup de dados". |
| 403 | OperationDenied.NotSupportedBackupMethod | When the storage is larger than 4000 GB, only snapshot backup is supported. | Quando a capacidade de armazenamento excede 4000 GB, apenas backups de snapshot são suportados. |
| 403 | OperationDenied.ApiForbidden | Operation is not permitted. | A operação não é permitida. |
| 403 | OrderStatus.UnPaid | The specified db instance has unpaid order. | Existe um pedido não pago para a instância atual. Pague o pedido e tente novamente. |
| 403 | InvalidReduceDiskSize | The storage capacity after the scale-down must be larger than the used amount. | A capacidade de destino para redução de escala não pode ser menor que o uso de armazenamento atual. |
| 403 | CloudSSDNotSupport | Cloud ssd does not support this operation, please upgrade to essd. | Os discos em nuvem SSD não suportam esta operação. Faça upgrade para ESSD. |
| 403 | InvalidUserOperatorPermission | The user permission does not support this operation. | As permissões do usuário não suportam esta operação. |
| 403 | InvalidVswitchId | Specified conn vswitch id is not valid. | O VSwitchId especificado está em um formato incorreto ou está vazio. |
| 403 | IncorrectMinorVersion | Current engine minor version does not support operations. | A versão secundária atual do mecanismo não suporta esta operação. |
| 403 | OperationDenied.ZoneResource | There is no available zone for inventory. | Não há regiões de inventário disponíveis. |
| 403 | NotInFlowController | Sorry,no permission. | Este recurso está disponível apenas para usuários de nuvem corporativa. Você não tem as permissões necessárias. |
| 403 | InvalidKmsKey | Kms key is disabled. | A chave KMS está desativada. |
| 403 | InvalidInstanceLevel.Malformed | Current DB instance level does not support this operation. | O nível atual da instância de banco de dados não oferece suporte a esta operação. |
| 403 | IncorrectDBInstanceState | Current DB instance state does not support this operation. | O status da instância de proxy não está ativado. |
| 404 | InvalidClusterKms | The current instance does not authorized to access the Key Management Service. | A instância atual não está autorizada a acessar o Key Management Service (KMS). |
| 404 | Request.NotFound | The requested resource is not available. | O recurso solicitado não está disponível. |
| 404 | HostInfo.NotFound | The specified host info is not found. | As informações do host especificado não existem. |
| 404 | InvalidInsType.Malformed | Specified instance type is not valid. | O tipo de instância é inválido. |
| 404 | IncorrectDBInstanceLockMode | Current DB instance lock mode does not support this operation. | A operação falhou. A instância está bloqueada. |
| 408 | NetworkOrSqlTimeoutError | Failed to create login due to potential SQL Server overload or other issues that may cause the login creation fail. Please retry later. | A consulta expirou devido a uma possível sobrecarga do SQL Server ou a um número excessivo de contas de instância. |
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.