Restaura dados históricos para uma nova instância, também conhecida como instância clone.
Descrição da operação
Mecanismos de banco de dados compatíveis
ApsaraDB RDS for MySQL
ApsaraDB RDS for PostgreSQL
ApsaraDB RDS for SQL Server
ApsaraDB RDS for MariaDB
Documentação relacionada
Experimente agora
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
rds:CloneDBInstance |
create |
DBInstance
|
|
Nenhuma |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| ClientToken |
string |
Não |
O token de cliente usado para garantir a idempotência da solicitação e evitar envios duplicados. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja exclusivo entre diferentes solicitações. O token pode conter no máximo 64 caracteres ASCII e não pode conter caracteres não ASCII. |
0c593ea1-3bea-11e9-b96b-88********** |
| RegionId |
string |
Não |
O ID da região. Você pode chamar a operação DescribeRegions para consultar o ID da região. |
cn-hangzhou |
| ZoneId |
string |
Não |
O ID da zona primária. Você pode chamar a operação DescribeRegions para consultar o ID da zona. Nota
O valor padrão é a zona da instância de origem. |
cn-hangzhou-b |
| DBInstanceClass |
string |
Não |
O tipo de instância. Para mais informações, consulte Tipos de instância. Nota
O valor padrão é o tipo de instância da instância primária. |
mysql.n1.micro.1 |
| DBInstanceStorage |
integer |
Não |
A capacidade de armazenamento da instância. Unidade: GB. A capacidade de armazenamento da instância aumenta em incrementos de 5 GB. Para mais informações, consulte Tipos de instância. Nota
O valor padrão é a capacidade de armazenamento da instância primária. |
1000 |
| DBInstanceDescription |
string |
Não |
A descrição da instância. A descrição deve ter de 2 a 255 caracteres. Deve começar com uma letra ou um caractere chinês e pode conter letras, caracteres chineses, dígitos, sublinhados (_) e hifens (-). Nota
A descrição não pode começar com http:// ou https://. |
testInstance |
| DbNames |
string |
Não |
Os nomes dos bancos de dados. Formato: |
test1,test2 |
| PayType |
string |
Sim |
O método de cobrança. Valores válidos:
|
Postpaid |
| InstanceNetworkType |
string |
Não |
O tipo de rede da instância. Valores válidos:
Nota
O valor padrão é o tipo de rede da instância primária. |
VPC |
| DBInstanceId |
string |
Sim |
O ID da instância. |
rm-uf6wjk5**** |
| BackupId |
string |
Não |
O ID do conjunto de backups. Você pode chamar a operação DescribeBackups para consultar os conjuntos de backups. Nota
Você deve especificar pelo menos um dos parâmetros BackupId e RestoreTime. |
902**** |
| RestoreTime |
string |
Não |
O ponto no tempo para o qual você deseja restaurar os dados. O ponto no tempo deve estar dentro do período de retenção de backup. Especifique a hora no formato aaaa-MM-ddTHH:mm:ssZ. A hora deve estar em UTC. Nota
Você deve especificar pelo menos um dos parâmetros BackupId e RestoreTime. |
2011-06-11T16:00:00Z |
| VPCId |
string |
Não |
O ID da VPC. Nota
Certifique-se de que a VPC pertence à região especificada. |
vpc-uf6f7l4fg90**** |
| VSwitchId |
string |
Não |
O ID do vSwitch. A zona onde o vSwitch está ativo deve corresponder ao ID de zona especificado em ZoneId.
|
vsw-uf6adz52c2p**** |
| PrivateIpAddress |
string |
Não |
O endereço IP de rede interna da nova instância. O endereço IP deve estar dentro do intervalo de endereços do vSwitch especificado. Por padrão, o sistema aloca automaticamente um endereço IP com base em VPCId e VSwitchId. |
172.XX.XX.69 |
| UsedTime |
integer |
Não |
A duração da assinatura. Valores válidos:
Nota
Este parâmetro é obrigatório se o método de cobrança estiver definido como Prepaid. |
1 |
| Period |
string |
Não |
O período da assinatura da instância de assinatura. Valores válidos:
Nota
Este parâmetro é obrigatório se o método de cobrança estiver definido como Prepaid. Valores válidos:
|
Year |
| Category |
string |
Não |
A edição da instância. Valores válidos:
Instâncias serverless
Nota
Você não precisa especificar este parâmetro. A edição da instância clone é a mesma da instância de origem. |
HighAvailability |
| ZoneIdSlave1 |
string |
Não |
O ID da zona do nó secundário. Se este parâmetro for definido com o mesmo valor de ZoneId, será uma implantação de zona única com uma zona ativa. Se este parâmetro for definido com um valor diferente de ZoneId, será uma implantação multizona com várias zonas ativas. |
cn-hangzhou-c |
| ZoneIdSlave2 |
string |
Não |
O ID da zona do nó logger. Se este parâmetro for definido com o mesmo valor de ZoneId, será uma implantação de zona única com uma zona ativa. Se este parâmetro for definido com um valor diferente de ZoneId, será uma implantação multizona com várias zonas ativas. |
cn-hangzhou-d |
| DBInstanceStorageType |
string |
Não |
O tipo de armazenamento da instância. Valores válidos:
Nota
As instâncias serverless suportam apenas discos em nuvem ESSD PL1 e discos em nuvem de desempenho premium. |
general_essd |
| RestoreTable |
string |
Não |
Especifica se deve ser realizada a restauração de banco de dados e tabelas. Defina o valor como true para realizar a restauração de banco de dados e tabelas. Caso contrário, deixe este parâmetro vazio. |
true |
| TableMeta |
string |
Não |
As informações sobre os bancos de dados e tabelas que você deseja restaurar. Este parâmetro é obrigatório quando você realiza a restauração de banco de dados e tabelas. Formato:
|
[{"type":"db","name":"testdb1","newname":"testdb1_new","tables":[{"type":"table","name":"testdb1table1","newname":"testdb1table1_new"}]}] |
| DedicatedHostGroupId |
string |
Não |
O ID do cluster dedicado. |
dhg-7a9**** |
| BackupType |
string |
Não |
O tipo de backup. Valores válidos:
|
FullBackup |
| DeletionProtection |
boolean |
Não |
Especifica se a proteção contra liberação deve ser ativada. Valores válidos:
|
true |
| IoAccelerationEnabled |
string |
Não |
As configurações serverless. Este parâmetro é obrigatório apenas quando você clona dados para uma instância serverless. Nota
Este parâmetro é compatível apenas no site chinês. |
0 |
| BurstingEnabled |
boolean |
Não |
[Descontinuado] Você não precisa configurar este parâmetro. |
0 |
| AutoPay |
boolean |
Não |
Especifica se o recurso Buffer Pool Extension (BPE) deve ser ativado para discos em nuvem de desempenho premium. Valores válidos:
Nota
Para mais informações sobre o recurso Buffer Pool Extension (BPE), consulte Buffer Pool Extension (BPE). |
0 |
| CustomExtraInfo |
string |
Não |
Especifica se o recurso de burst de desempenho de E/S deve ser ativado para discos em nuvem de desempenho premium. Valores válidos:
Nota
Para mais informações sobre o recurso de burst de desempenho de E/S, consulte O que é um disco em nuvem de desempenho premium?. |
false |
| Tag |
array<object> |
Não |
Especifica se o pagamento automático deve ser ativado. Valores válidos:
Nota
O valor padrão é true. Se o seu método de pagamento tiver saldo insuficiente, você pode definir o parâmetro AutoPay como false. Nesse caso, um pedido não pago é gerado e você pode fazer login no console do ApsaraDB RDS para pagar o pedido. |
true |
|
object |
Não |
Os detalhes das tags. |
||
| Key |
string |
Não |
A chave da tag. Você pode especificar este parâmetro para adicionar uma tag à instância.
|
testkey1 |
| Value |
string |
Não |
O valor da tag que corresponde à chave da tag. Você pode especificar este parâmetro para adicionar uma tag à instância.
|
testvalue1 |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
Os parâmetros de resposta. |
||
| DBInstanceId |
string |
O ID da instância. |
rm-uf6wjk5**** |
| OrderId |
string |
O ID do pedido. |
100789370**** |
| RequestId |
string |
O ID da solicitação. |
1E43AAE0-BEE8-43DA-860D-EAF2**** |
Exemplos
Resposta de sucesso
JSON formato
{
"DBInstanceId": "rm-uf6wjk5****",
"OrderId": "100789370****",
"RequestId": "1E43AAE0-BEE8-43DA-860D-EAF2****"
}
Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|---|---|---|---|
| 400 | InvalidAvZone.Format | Specified AvZone is not valid. | A AvZone especificada é inválida. Verifique se o parâmetro está correto. |
| 400 | InvalidAvZone.NotSupport | Specified availableArea multiZone does not support in RDS. | A availableArea multiZone especificada não é suportada no ApsaraDB RDS. |
| 400 | CannotDecreaseEssdPerfLevel | cannot decrease cloud essd performance level. | A operação falhou porque não há suporte para o downgrade das especificações do disco em nuvem. |
| 400 | InvalidIPAddress.Conflict | IP address conflict. | Ocorreu um conflito de endereço IP. |
| 400 | CDDC.AvailableHostsNotEnoughInZone | Not enough available hosts are in the target zone. | A zona de destino não possui recursos de host suficientes. Crie um host na zona. |
| 400 | InvalidInstanceLevel.DiskType | Specified instance level not support request disk type | O tipo de instância atual não suporta este tipo de armazenamento. |
| 400 | InvalidRecoveryDbInstance.StorageType | The disk local_ssd can not clone to cloud disk type | Discos locais não podem ser clonados para discos em nuvem. |
| 400 | InvalidRecoveryDbInstance.StorageSize | The disk space of the new instance cannot be less than that of the current instance | A operação falhou. O espaço em disco da nova instância não pode ser menor que o da instância atual. |
| 400 | InvalidDBInstanceClass.Offline | The specified instance type is no longer provided. Please specify another instance type. | O tipo de instância selecionado atualmente não está mais disponível. Selecione um tipo de instância diferente. |
| 400 | InvalidTunnelId | Specified conn tunnel is not valid. | O canal de conexão especificado é inválido. |
| 400 | ZoneId.NotMatchWithCategory | The number of available zones does not match the database engine or instance edition. Please reset it. | O número de zonas não corresponde ao mecanismo do banco de dados ou à edição da instância. Reconfigure as configurações. |
| 400 | UnsupportExtendDisk.NotSupport | Specified DB instance is unsupport extend disk. | A instância especificada não oferece suporte à expansão de disco. |
| 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 de preços para o plano 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 passou pela verificação de nome real e não atende aos requisitos de 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 saldo disponível da sua conta é menor que zero. Adicione fundos à sua conta antes de tentar fazer uma compra. |
| 400 | CommodityServiceCalling.Exception | Failed to call commodity service. | A chamada para o serviço de comércio falhou. |
| 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. | A Alibaba Cloud planeja otimizar e ajustar a região atual, e os serviços em nuvem nesta região cessarão as operações. Para garantir a continuidade dos negócios e uma transição suave para a migração de dados, você não pode fazer novos pedidos de compra no momento. Agradecemos a 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 comércio. |
| 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 novamente o período. |
| 400 | pay.noCreditCard | Account not bound to credit card. | A sua conta não está vinculada 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. | Você tem pedidos não pagos para o serviço selecionado. Pague ou cancele os pedidos não pagos antes de fazer um novo pedido. |
| 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 sua conta. Adicione um método de pagamento. |
| 400 | BasicInfoUncompleted | Your information is incomplete. Complete your information before the operation. | Suas informações estão incompletas. Complete suas informações antes de prosseguir. |
| 400 | Risk.RiskControlRejection | Your account is abnormal, please contact customer service for details. | Uma anomalia foi detectada em sua conta. Entre em contato com o suporte ao cliente para obter detalhes. |
| 400 | Api.NotSupport | Specified api is not supported. | Esta operação de API não é suportada. |
| 400 | ContainForbiddenLabelError | There is a label that prohibits placing orders. Please contact your distributor for assistance. | Existe uma tag que proíbe a realização de pedidos. Entre em contato com seu distribuidor para obter assistência. |
| 400 | InvalidDBInstanceId.NotFound | The DBInstanceId provided does not exist in records. | A instância especificada não existe. Verifique se a instância existe e se não foi excluída. |
| 400 | InvalidParam | Sepcified wal level Parameter is invalid. There are still logical slots in instance, so it can not be set as replica. | A operação falhou porque o parâmetro é 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. | A conta não existe. |
| 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 de banco de dados 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 suporta esta operação. |
| 400 | InvalidConnectionString.Duplicate | Specified connection string already exists in the RDS. | O nome do endpoint está duplicado. Reconfigure a string de conexão. |
| 400 | RequiredParam.NotFound | Required input param is not found. | Os parâmetros obrigatórios não foram fornecidos. |
| 400 | Parameters.Invalid | Parameter error, please check the parameters. | O parâmetro é inválido. Verifique os parâmetros. |
| 400 | BackupPolicyNotSupport | Cold Data won't open with CrossBackup or Flash Backup, please check Backup Policy. | O arquivamento de dados não suporta backups entre regiões ou snapshots de nível de segundo. Verifique a política de backup. |
| 400 | InvalideStatus.Format | The instance status does not support this operation. | O status atual da instância não suporta esta operação. |
| 400 | InvalidReleasedKeepPolicy.Format | Specified Released Keep Policy is not valid. | A política de retenção de dados para backups arquivados após a liberação da instância é inválida. |
| 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 venda. |
| 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. | A consulta do produto falhou. |
| 400 | ProductInstanceReleased | The instance has been released. Please check before placing the order. | A instância foi liberada. Verifique o status da instância antes de fazer um pedido. |
| 400 | RegionEndTimeDissolvedIndia | The region is no longer supported. | A região foi desativada. |
| 400 | StopService.Clone | The service has been discontinued and cloning operations on classic network instances are no longer permitted. | Como a rede clássica está offline e o tempo de descontinuação do serviço já passou, você não pode clonar uma instância do tipo de rede clássica. |
| 400 | InvalidParam.UsedTime | The clone expiration date cannot exceed %s. | Quando o parâmetro PayType é definido como Prepaid, o parâmetro UsedTime deve ser válido. |
| 400 | MinorVersionTag.NotFound | Minor version tags cannot be parsed by the instance. | |
| 400 | InvalidBakset.Invalid | Specified bakset is not valid. | Esta operação não é suportada para o conjunto de backups especificado. |
| 400 | InvalidParamForXfs | Xfs instance must be single tenant standard instance. | As instâncias XFS devem ser instâncias dedicadas de alta disponibilidade. |
| 400 | AtLeastThreeVSwitchAvailableIp | The primary vswitch requires at least three available IP addresses. | O vSwitch principal requer pelo menos três endereços IP disponíveis. |
| 400 | AtLeastTwoVSwitchAvailableIp | The primary vswitch requires at least two available IP addresses. | O vSwitch principal requer pelo menos dois endereços IP disponíveis. |
| 400 | DiskSize.NotEnough | The disk size is not enough to restore tables. | O espaço restante em disco é insuficiente. |
| 500 | ExternalFailure | The request processing has failed due to external service failure. | A solicitação de 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 técnico. |
| 500 | InvokeProxyFailure | The request processing has failed due to service failure of rds api. | O processamento da solicitação falhou devido a uma falha no serviço da API do ApsaraDB RDS. |
| 403 | IncorrectMinorVersion | Current engine minor version does not support operations. | A versão secundária atual do mecanismo não oferece suporte a esta operação. |
| 403 | IncorrectCharacterType | Current DB instance character type does not support this operation. | O tipo de caractere da instância atual não suporta esta operação. |
| 403 | CloudDiskEncryptionNotSupport | The encryption key is not allowed for general-purpose instance. | A criptografia de disco em nuvem não é suportada para instâncias de uso geral. |
| 403 | OrderStatus.UnPaid | The specified db instance has unpaid order. | A instância possui pedidos não pagos. Pague os pedidos e tente novamente. |
| 403 | InvalidReduceDiskSize | The storage capacity after the scale-down must be larger than the used amount. | A capacidade de armazenamento de destino 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 SSDs padrão não suportam esta operação. Atualize para ESSDs. |
| 403 | InvalidUserOperatorPermission | The user permission does not support this operation. | Você não tem as permissões necessárias para realizar esta operação. |
| 403 | InvalidVswitchId | Specified conn vswitch id is not valid. | O VSwitchId especificado é inválido ou está vazio. |
| 403 | OperationDenied.ZoneResource | There is no available zone for inventory. | Nenhuma zona tem estoque disponível. |
| 403 | NotInFlowController | Sorry,no permission. | Este recurso não está disponível para usuários de nuvem não corporativos. 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. | A operação falhou porque o código de especificação especificado não suporta o número de endpoints. Verifique o número de shards e o número atual de endpoints. |
| 403 | InvalidMeta.TooLarge | Meta information is too large. | Os metadados são muito grandes. Verifique se o número de tabelas na instância excede 50.000. |
| 404 | InvalidDBInstance.NotFound | The specified instance does not exist or is not supported. | A instância especificada não existe ou não suporta esta operação. |
| 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. |
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.