Restaurar dados em uma nova instância entre regiões - : Central de Documentação do Alibaba Cloud

Chame a operação CreateDdrInstance para restaurar os dados de uma instância em uma nova instância localizada em uma região diferente.

Antes de chamar esta operação, chame a CheckCreateDdrDBInstance para verificar se os dados da instância de origem podem ser restaurados a partir de um arquivo de backup entre regiões.

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

MySQL. Para obter mais informações, consulte Back up an ApsaraDB RDS for MySQL instance across regions.
SQL Server. Para obter mais informações, consulte Back up an ApsaraDB RDS for SQL Server instance across regions.
PostgreSQL. Para obter mais informações, consulte Back up an ApsaraDB RDS for PostgreSQL instance across regions.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, 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

Parameter	Type	Required	Example	Description
Action	String	Yes	CreateDdrInstance	A operação a ser executada. Defina o valor como CreateDdrInstance.
RegionId	String	Yes	cn-hangzhou	O ID da região da instância de destino. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
Engine	String	Yes	MySQL	O mecanismo de banco de dados da instância de destino. Valores válidos: MySQL SQLServer PostgreSQL
EngineVersion	String	Yes	5.6	A versão principal do mecanismo da instância de destino. O valor deste parâmetro varia conforme o valor do parâmetro Engine. Valores válidos: Valores válidos quando Engine é MySQL: 5.5, 5.6, 5.7 e 8.0 Valores válidos quando Engine é SQL Server: 2008r2, 08r2_ent_ha, 2012, 2012_ent_ha, 2012_std_ha, 2012_web, 2014_std_ha, 2016_ent_ha, 2016_std_ha, 2016_web, 2017_std_ha, 2017_ent, 2019_std_ha e 2019_ent Valores válidos quando Engine é PostgreSQL: 9.4, 10.0, 11.0, 12.0 e 13.0
DBInstanceClass	String	Yes	rds.mysql.s1.small	O tipo da instância de destino. Para obter mais informações, consulte Primary ApsaraDB RDS instance types.
DBInstanceStorage	Integer	Yes	20	A capacidade de armazenamento da instância de destino. Valores válidos: 5 a 2000. Unidade: GB. O valor deve ser múltiplo de 5 GB. Para obter mais informações, consulte Primary ApsaraDB RDS instance types.
SystemDBCharset	String	No	uft8	O conjunto de caracteres da instância de destino. Valores válidos: utf8 gbk latin1 utf8mb4
DBInstanceNetType	String	Yes	Intranet	O tipo de conexão de rede da instância de destino. Valores válidos: Internet: Internet Intranet: rede interna
DBInstanceDescription	String	No	testdatabase	O nome da instância de destino. O nome deve ter entre 2 e 256 caracteres e pode conter letras, dígitos, underscores (_) e hífens (-). O nome deve começar com uma letra. Nota O nome não pode começar com http:// ou https://.
SecurityIPList	String	Yes	127.0.0.1	A lista de permissões de endereços IP da instância de destino. Para adicionar mais de uma entrada, separe-as com vírgulas (,). Cada entrada deve ser única. É possível adicionar no máximo 1.000 entradas. Para obter mais informações, consulte Configure an IP address whitelist for an ApsaraDB RDS for MySQL instance. As entradas da lista de permissões de endereços IP devem estar em um dos seguintes formatos: Endereço IP. Exemplo: 10.23.12.24. Bloco CIDR. Exemplo: 10.23.12.24/24. Neste exemplo, 24 indica que o prefixo do bloco CIDR tem 24 bits de comprimento. Substitua 24 por um valor entre 1 e 32.
ClientToken	String	No	ETnLKlblzczshOTUbOCzxxxxxxxxxx	O token do cliente usado para garantir a idempotência da requisição. Gere o token pelo cliente, certificando-se de que seja único entre requisições diferentes. O token pode conter apenas caracteres ASCII e não deve ultrapassar 64 caracteres.
PayType	String	Yes	Prepaid	O método de faturamento da instância de destino. Valores válidos: Postpaid: pagamento conforme o uso Prepaid: assinatura
ZoneId	String	No	cn-hangzhou-b	O ID da zona de disponibilidade da instância de destino. Se a instância for implantada em múltiplas zonas, separe os IDs das zonas com dois-pontos (:). Nota Ao especificar uma VPC e um vSwitch, especifique também o parâmetro ZoneId.
InstanceNetworkType	String	No	Classic	O tipo de rede da instância de destino. Valores válidos: VPC Classic Valor padrão: Classic. Nota Ao definir este parâmetro como VPC, especifique também os parâmetros VPCId e VSwitchId.
ConnectionMode	String	No	Standard	O modo de conexão da instância de destino. Valores válidos: Standard: modo padrão Safe: modo de proxy de banco de dados Valor padrão: Standard
VPCId	String	No	vpc-xxxxxxxxxxxx	O ID da VPC da instância de destino. Este parâmetro está disponível apenas quando o parâmetro InstanceNetworkType é definido como VPC. Nota Ao especificar este parâmetro, especifique também o parâmetro ZoneId.
VSwitchId	String	No	vsw-xxxxxxxxxxx	O ID do vSwitch da instância de destino. Para especificar mais de um vSwitch, separe os IDs com vírgulas (,). Este parâmetro está disponível apenas quando o parâmetro InstanceNetworkType é definido como VPC. Nota Ao especificar este parâmetro, especifique também o parâmetro ZoneId.
PrivateIpAddress	String	No	172.XXX.XXX.69	O endereço IP privado da instância de destino. O endereço IP privado deve estar dentro do bloco CIDR suportado pelo vSwitch especificado. O sistema atribui automaticamente um endereço IP privado à instância com base nos valores dos parâmetros VPCId e VSwitchId.
UsedTime	String	No	2	A duração da assinatura da instância. Valores válidos: Se o parâmetro Period for definido como Year, o valor do parâmetro UsedTime varia de 1 a 3. Se o parâmetro Period for definido como Month, o valor do parâmetro UsedTime varia de 1 a 9. Nota Se o parâmetro PayType for definido como Prepaid, especifique também este parâmetro.
Period	String	No	Year	A unidade de medida da duração da assinatura da instância de destino. Valores válidos: Year Month Nota Se o parâmetro PayType for definido como Prepaid, especifique também este parâmetro.
ResourceGroupId	String	No	rg-acfmyxxxxxxxxxx	O ID do grupo de recursos.
RestoreType	String	Yes	BackupSet	O método de restauração de dados. Valores válidos: BackupSet: os dados são restaurados a partir de um conjunto de backup. Ao usar este valor, especifique também o parâmetro BackupSetID. BackupTime: restaura os dados para um ponto no tempo. Especifique também os parâmetros RestoreTime, SourceRegion e SourceDBInstanceName.
BackupSetId	String	No	14***	O ID do conjunto de backup usado para a restauração. Chame a operação DescribeCrossRegionBackups para consultar o ID do conjunto de backup. Nota Se o parâmetro RestoreType for definido como BackupSet, especifique também este parâmetro.
RestoreTime	String	No	2019-05-30T03:29:10Z	O ponto no tempo para o qual os dados serão restaurados. O ponto no tempo especificado deve ser anterior ao momento atual. Especifique o horário no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. O horário deve estar em UTC. Nota Se o parâmetro RestoreType for definido como BackupTime, especifique também este parâmetro.
SourceRegion	String	No	cn-hangzhou	O ID da região da instância de origem, quando os dados são restaurados para um ponto no tempo. Nota Se o parâmetro RestoreType for definido como BackupTime, especifique também este parâmetro.
SourceDBInstanceName	String	No	rm-uf6wjk5xxxxxxx	O ID da instância de origem, quando os dados são restaurados para um ponto no tempo. Nota Se o parâmetro RestoreType for definido como BackupTime, especifique também este parâmetro.
DBInstanceStorageType	String	No	local_ssd	O tipo de armazenamento da instância de destino. Apenas o tipo de armazenamento SSD local é suportado. Valor padrão: local_ssd.

Parâmetros de resposta

Parameter	Type	Example	Description
DBInstanceId	String	rm-xxxxx	O ID da instância de destino.
RequestId	String	E52666CC-330E-418A-8E5B-A19E3FB42D13	O ID da requisição.
Port	String	3306	O número da porta usada para conectar à instância de destino. Nota O parâmetro DBInstanceNetType indica se a porta é interna ou pública.
ConnectionString	String	rm-xxxxx.mysql.rds.aliyuncs.com	O endpoint usado para conectar à instância de destino. Nota O parâmetro DBInstanceNetType indica se o endpoint é interno ou público.
OrderId	String	2038691xxxxx	O ID do pedido.

Exemplos

Exemplos de requisição

http(s)://rds.aliyuncs.com/?Action=CreateDdrInstance
&RegionId=cn-hangzhou
&Engine=MySQL
&EngineVersion=5.6
&DBInstanceClass=rds.mysql.s1.small
&DBInstanceStorage=20
&SystemDBCharset=uft8
&DBInstanceNetType=Intranet
&DBInstanceDescription=testdatabase
&SecurityIPList=127.0.0.1
&ClientToken=ETnLKlblzczshOTUbOCzxxxxxxxxxx
&PayType=Prepaid
&ZoneId=cn-hangzhou-b
&InstanceNetworkType=Classic
&ConnectionMode=Standard
&VPCId=vpc-xxxxxxxxxxxx
&VSwitchId=vsw-xxxxxxxxxxx
&PrivateIpAddress=172.XXX.XXX.69
&UsedTime=2
&Period=Year
&ResourceGroupId=rg-acfmyxxxxxxxxxx	
&RestoreType=BackupSet
&BackupSetId=14***
&RestoreTime=2019-05-30T03:29:10Z
&SourceRegion=cn-hangzhou
&SourceDBInstanceName=rm-uf6wjk5xxxxxxx
&DBInstanceStorageType=local_ssd
&Common request parameters

Exemplos de resposta de sucesso

XML formato

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

<CreateDdrInstanceResponse>
    <RequestId>E52666CC-330E-418A-8E5B-A19E3FB42D13</RequestId>
    <DBInstanceId>rm-xxxxx</DBInstanceId>
    <Port>3306</Port>
    <ConnectionString>rm-xxxxx.mysql.rds.aliyuncs.com</ConnectionString>
    <OrderId>2038691xxxxx</OrderId>
</CreateDdrInstanceResponse>

JSON formato

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

{
  "RequestId" : "E52666CC-330E-418A-8E5B-A19E3FB42D13",
  "DBInstanceId" : "rm-xxxxx",
  "Port" : "3306",
  "ConnectionString" : "rm-xxxxx.mysql.rds.aliyuncs.com",
  "OrderId" : "2038691xxxxx"
}

Códigos de erro

HTTP status code	Error code	Error message	Description
400	InvalidZoneId.NotSupported	The Specified vpc Zone not supported.	A zona especificada não permite a criação de instâncias em uma VPC. Especifique uma zona diferente e tente novamente.
400	InvalidDBInstanceName.Format	Specified DB instance name is not valid.	A instância não existe. Verifique as informações da instância.
400	InvalidDBInstanceName.Duplicate	Specified DB instance name already exists in the Aliyun RDS.	O nome da instância já existe. Especifique um nome diferente e tente novamente.
400	InvalidRegion.Format	Specified Region is not valid.	A região especificada é inválida.
400	InvalidServiceType.Format	Specified service type is not valid.	O tipo de serviço é inválido. Defina o tipo de serviço como 0 ou 1. O valor 0 indica um serviço Alibaba Cloud e o valor 1 indica um serviço JST.
400	InvalidEngine.Malformed	Specified engine is not valid.	O mecanismo de banco de dados é inválido. Especifique um mecanismo de banco de dados válido.
400	InvalidEngineVersion.Malformed	Specified engine version is not valid.	A versão do mecanismo de banco de dados especificada é inválida. Verifique a versão e tente novamente.
400	InvalidConnectionString.Format	Specified connection string is not valid.	O prefixo do endpoint é inválido. O prefixo deve ter entre 5 e 40 caracteres.
400	InvalidConnectionString.Duplicate	Specified connection string already exists in the Aliyun RDS.	O endpoint especificado já existe. Especifique um endpoint diferente.
400	InvalidCharacterSetName.Format	Specified character set name is not valid.	O conjunto de caracteres especificado é inválido. O ApsaraDB RDS suporta os seguintes conjuntos de caracteres: GBK, UTF-8, EUC-KR e ASCII.
400	InvalidDBInstanceType.Format	Specified instance type is not valid.	O tipo de instância especificado é inválido. Especifique um tipo de instância válido.
400	InvalidPort.Malformed	Specified port is not valid.	O número de porta especificado é inválido.
400	InvalidBackupRetentionPeriod.Malformed	Specified backup retention period is not valid.	O ciclo de backup especificado é inválido. O ciclo de backup deve ser maior que 1 dia ou menor ou igual a 30 dias.
400	InvalidPreferredBackupTime.Format	Specified preferred backup time is not valid.	O formato do horário de backup está incorreto. Especifique o horário em GMT no formato YYYY-MM-DDThh:mmZ. Exemplo: 2012-06-11T15:00Z.
400	InvalidPreferredBackupPeriod.Malformed	Specified backup period is not valid.	O horário de backup é inválido.
400	InvalidExpiredTime.Format	Specified expired time is not valid.	O valor do parâmetro ExpiredTime é inválido. Especifique o horário no formato yyyy-MM-ddTHH:mm:ssZ. O horário deve estar em UTC.
400	InvalidSecurityIPList.Format	Specified security IP list format is not valid.	A lista de permissões de endereços IP é inválida. Verifique a lista de permissões de endereços IP.
400	InvalidSecurityIPList.Duplicate	Specified security IP list is not valid: Duplicate IP address in the list	Os endereços IP ou blocos CIDR especificados são inválidos. Existem entradas duplicadas na lista.
400	InvalidSecurityIPList.QuotaExceeded	Specified security IP list is not valid: Exceeding the allowed amount of IP address in the list.	O número de entradas na lista de permissões de endereços IP excede o limite máximo. É possível especificar até 1.000 entradas por lista.
400	InvalidDBInstanceDescription.Format	Specified DB instance description is not valid.	O valor do parâmetro DBInstanceDescription é inválido. Especifique um valor válido. O valor deve ter entre 2 e 256 caracteres e pode conter letras, dígitos, underscores (_) e hífens (-). O valor deve começar com uma letra.
400	InvalidStorage.Format	Specified Storage is not valid.	O valor do parâmetro Storage é inválido. Especifique um valor válido.
400	InvalidDBInstanceConnType.Format	Specified DB instance conn type is not valid.	O tipo de rede da instância não suporta esta operação.
400	PreCheckInvalid	CreateDdrInstance PreCheck Is Invalid	A pré-verificação da operação CreateDdrInstance é inválida.
400	IncorrectDBInstanceType	Current DB instance engine and type does not support operations.	Esta operação não é suportada para o mecanismo de banco de dados e o tipo de instância atuais.
400	InvalidRestoreType.Format	Specified restore type is not valid.	O tipo de restauração especificado é inválido. Especifique um tipo de restauração válido.
400	NoBackupSetRegion	BackupSetRegion is absence.	A região de backup não existe.
400	NoBaksetName	BaksetName is absence.	O nome do conjunto de backup não existe.
400	NoSourceInstanceName	No SourceDBInstanceName.	O nome da instância de origem não foi encontrado.
400	NoAvailableDisasterRestoreBakset	No available disaster restore bakset.	Nenhum conjunto de backup disponível foi encontrado.
400	InvalidBackupType.Format	Specified backup type is not valid.	O tipo de backup é inválido.
400	IncorrectEngineVersion	Current engine version does not support operations.	Esta operação não é suportada para a versão do mecanismo de banco de dados em execução na instância.
400	DisasterRestoreRegionNotMatched	Disaster restore should be operated in the ddr region or source region.	A recuperação de desastres deve ser executada na região da instância de origem ou de destino.
403	IncorrectBackupSetMethod	Current backup set method does not support operations.	O conjunto de backup especificado não pode ser usado para restaurar bancos de dados e tabelas individualmente.
403	IncorrectBaksetVersion	Current bakset version does not support operations.	Esta operação não é suportada para a versão do conjunto de backup.
403	CrossRegionUnsupportTDE	Cross-region disaster restore not support TDE bakset.	Conjuntos de backup baseados em TDE não podem ser usados para restaurar uma instância em outra região.
404	InvalidRegion.NotFound	Specified Region does not exist in the RDS	O ID da região é inválido.
404	InvalidClusterName.NotFound	The specified cluster name is not available.	O nome do cluster não existe. Verifique o nome do cluster e tente novamente.
404	InvalidDBInstanceClass.NotFound	Specified DB instance class is not found.	O novo tipo de instância não foi encontrado ou não está mais disponível para compra. Selecione um tipo de instância disponível.
404	InvalidDBInstanceNetType.NotFound	Specified DB instance net type is not found.	O tipo de rede da instância é inválido. Verifique o tipo de rede.
404	RestoreType.NotFound	RestoreType is not found.	O método de restauração especificado não existe.
404	InvalidBackupSetID.NotFound	Specified backup set ID does not exist.	O conjunto de backup especificado não existe. Verifique os conjuntos de backup existentes.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.