Restauração de dados em uma nova instância de banco de dados_Relational Database Service

Função

Esta API é usada para restaurar dados em uma nova instância de banco de dados.

Antes de chamar uma API, você precisa entender a API em Autenticação.

Restrições

O mecanismo de banco de dados da instância de banco de dados original deve ser o mesmo da instância de banco de dados de destino. Por exemplo, se a instância de banco de dados original estiver executando o MySQL, a instância de banco de dados de destino também deve executar o MySQL.
As restrições nas instâncias de banco de dados original e de destino são as seguintes:
- Para RDS for MySQL e RDS for PostgreSQL, as versões do mecanismo de banco de dados das instâncias de banco de dados originais e de destino devem ser as mesmas.
Para RDS for MySQL e RDS for PostgreSQL, o tamanho total do volume da instância de banco de dados de destino deve ser pelo menos igual ao da instância de banco de dados original.

URI

Formato de URI
POST /v3/{project_id}/instances

Descrição do parâmetro

**Tabela 1** Descrição do parâmetro
Nome	Obrigatório	Descrição
project_id	Sim	Especifica o ID do projeto de um locatário em uma região. Para obter detalhes sobre como obter o ID do projeto, consulte Obtenção de um ID de projeto.

Solicitação

Descrição do parâmetro

**Tabela 2** Descrição do parâmetro
Nome	Obrigatório	Tipo	Descrição
name	Sim	String	Especifica o nome da instância de banco de dados. Instâncias de banco de dados do mesmo tipo podem ter os mesmos nomes sob o mesmo locatário. Valor válido: O nome da instância de banco de dados deve ter de 4 a 64 bytes, começar com uma letra e conter apenas letras (sensíveis a maiúsculas e minúsculas), dígitos, hifens (-) e sublinhados (_).
datastore	Não	Object	Especifica as informações de banco de dados. Este parâmetro é usado somente para instâncias de banco de dados do RDS for SQL Server e é obrigatório para restauração entre versões para novas instâncias de banco de dados. Para mais detalhes, consulte Tabela 4. Para obter detalhes sobre versões para restauração do RDS for SQL Server, consulte Tabela 5.
ha	Não	Object	Especifica os parâmetros de configuração de HA, que são usados ao criar instâncias de banco de dados primárias/em espera. Para mais detalhes, consulte Tabela 3.
configuration_id	Não	String	Especifica o ID do modelo de parâmetro.
port	Não	String	Especifica as informações da porta de banco de dados. A porta de banco de dados do RDS for MySQL varia de 1024 a 65535 (excluindo 12017 e 33071, que são ocupados pelo sistema RDS e não podem ser utilizados). A porta de banco de dados do RDS for PostgreSQL varia de 2100 a 9500. A porta de banco de dados do RDS for SQL Server é 1433 ou varia de 2100 a 9500 (excluindo 5355 e 5985. Para as edições Enterprise, Standard e Web do Microsoft SQL Server 2017, a porta de banco de dados também não pode ser definida como 5050, 5353 ou 5986). Se este parâmetro não estiver definido, o valor padrão será o seguinte: RDS for MySQL: 3306. RDS for PostgreSQL: 5432 RDS for SQL Server: 1433
password	Sim	String	Especifica a senha de banco de dados. Valor válido: uma senha de banco de dados deve ter de 8 a 32 caracteres e conter pelo menos três tipos dos seguintes caracteres: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais. RDS for MySQL: ~!@#$%^-_=+?,()& RDS for SQL Server: ~!@#$%^-_+?, RDS for PostgreSQL: ~!@#%^*-_=+?, é aconselhável que você insira uma senha forte para melhorar a segurança, evitando riscos de segurança, como quebra de força bruta.
backup_strategy	Não	Object	Especifica a política de backup avançada. Para mais detalhes, consulte Tabela 6.
enterprise_project_id	Não	String	Especifica o ID do projeto.
disk_encryption_id	Não	String	Especifica o ID da chave para criptografia de disco. O valor padrão é vazio
flavor_ref	Sim	String	Especifica o código de especificação. O valor não pode estar vazio. Para detalhes, veja spec_code na seção Consulta de especificações de banco de dados.
volume	Sim	Object	Especifica as informações do volume. Para mais detalhes, consulte Tabela 7.
region	Não	String	Especifica o ID da região. Para obter detalhes, consulte Regiões e pontos de extremidade.
availability_zone	Sim	String	Especifica o ID da AZ. Se a instância de banco de dados não for uma única instância, será necessário especificar uma AZ para cada nó da instância e separar as AZs com vírgulas (,). Para mais detalhes, veja o exemplo. O valor não pode estar vazio. Para obter detalhes sobre como obter esse valor de parâmetro, consulte Regiões e pontos de extremidade.
vpc_id	Não	String	Especifica o ID da VPC. Para obter o valor deste parâmetro, use um dos seguintes métodos: Método 1: faça logon no console da VPC e visualize o ID da VPC nos detalhes da VPC. Método 2: para obter detalhes, consulte a seção "Consulta das VPCs" na Referência de API da Virtual Private Cloud.
subnet_id	Não	String	Especifica o ID da rede. Para obter o valor deste parâmetro, use um dos seguintes métodos: Método 1: faça logon no console da VPC e clique na sub-rede de destino na página Subnets. Você pode exibir o ID da rede na página exibida. Método 2: para obter detalhes, consulte a seção "Consulta das VPCs" na Referência de API da Virtual Private Cloud.
data_vip	Não	String	Especifica o endereço IP flutuante de uma instância de banco de dados. Para obter o valor deste parâmetro, use um dos seguintes métodos: Método 1: faça logon no console da VPC e clique na sub-rede de destino na página Subnets. Você pode exibir o bloco CIDR da sub-rede na página exibida. Método 2: consulte a seção "Consulta das sub-redes" na Referência de API da Virtual Private Cloud.
security_group_id	Não	String	Especifica o grupo de segurança ao qual a instância de banco de dados do RDS pertence. Para obter o valor deste parâmetro, use um dos seguintes métodos: Método 1: faça logon no console da VPC. Escolha Access Control > Security Groups no painel de navegação à esquerda. Na página exibida, clique no grupo de segurança de destino. Você pode exibir o ID do grupo de segurança na página exibida. Método 2: consulte a seção "Consulta de grupos de segurança" na Referência de API da Virtual Private Cloud. Para usar vários grupos de segurança para uma instância do RDS for MySQL, escolha Service Tickets > Create Service Ticket no canto superior direito do console de gerenciamento para solicitar as permissões necessárias. Você pode adicionar até 10 IDs de grupo de segurança para cada instância e separá-los com vírgulas (,).
restore_point	Sim	Object	Especifica as informações de restauração. Para mais detalhes, consulte Tabela 8.
charge_info	Não	Object	Especifica as informações de cobrança, que são anuais/mensais ou de pagamento por uso (configuração padrão). Somente o RDS for SQL Server oferece suporte à restauração de instâncias de banco de dados anuais/mensais para novas instâncias. Para mais detalhes, consulte Tabela 9.
time_zone	Não	String	Especifica o fuso horário UTC. Se este parâmetro não estiver especificado, o fuso horário de cada mecanismo será o seguinte: MySQL: o site da China continental e o site internacional usam o UTC por padrão. PostgreSQL: o site da China continental e o site internacional usam o UTC por padrão. Microsoft SQL Server: o site da China continental e o site internacional usam o horário padrão da China e o UTC, respectivamente. Se este parâmetro estiver especificado, o intervalo de valores será de UTC-12:00 a UTC+12:00 na hora. Por exemplo, o parâmetro pode ser UTC+08:00 em vez de UTC+08:30.
dsspool_id	Não	String	Especifica o ID do pool do DSS dos usuários da DeC. O pool do DSS configurado para cada AZ é diferente. Quando os usuários da DeC criam instâncias de banco de dados que não sejam instâncias únicas ou réplicas de leitura, os IDs do pool do DSS devem ser especificados para todos os nós das instâncias de banco de dados e devem ser separados por vírgulas (,). Para obter o ID do pool do DSS, você pode usar um dos seguintes métodos: Método 1: faça logon no console do DSS, exiba a lista do pool do DSS e selecione o ID do DSS desejado na AZ. Método 2: consulte o ID do pool do DSS usando a API do DSS. Para detalhes, consulte Obtenção de detalhes dos pools do armazenamento do DSS.
replica_of_id	Não	String	Especifica o ID da instância de banco de dados primária. Este parâmetro é obrigatório quando você cria uma réplica de leitura e não está disponível em outros cenários.
collation	Não	String	Este parâmetro se aplica somente a instâncias de banco de dados do RDS for SQL Server. Intervalo de valores: conjuntos de caracteres consultados em Consulta do conjunto de caracteres disponíveis do SQL Server.
tags	Não	Array of objects	Especifica a lista de tags. As instâncias de banco de dados são criadas com base em chaves e valores de tags. {key} indica a chave da tag. Deve ser única e não pode estar vazia. {value} indica o valor da tag, que pode estar vazio. Se você quiser criar instâncias de banco de dados com várias chaves e valores de tags, separe-as com vírgulas (,). Um máximo de 10 pares de chave-valor podem ser adicionados para uma instância de banco de dados. Para mais detalhes, consulte Tabela 10.
unchangeable_param	Não	Object	Especifica a lista de parâmetros inalteráveis. Os parâmetros inalteráveis precisam ser especificados antes da inicialização de banco de dados e não podem ser modificados após serem especificados. Para mais detalhes, consulte Tabela 11.
dry_run	Não	Boolean	Especifica se as instâncias de banco de dados não serão criadas após a verificação da solicitação. Este parâmetro é suportado apenas com o MySQL. true: as instâncias de banco de dados não serão criadas após a verificação da solicitação. Se a verificação for bem sucedida, o código de status 202 é retornado. Se a verificação falhar, um código de erro será retornado. Para mais detalhes, consulte Códigos de erro. false: as instâncias de banco de dados serão criadas após a verificação ser bem-sucedida.

**Tabela 3** Descrição da estrutura de dados do campo ha
Nome	Obrigatório	Tipo	Descrição
mode	Sim	String	Especifica o tipo de instância primária/em espera. O valor é Ha (sem distinção entre maiúsculas e minúsculas).
replication_mode	Sim	String	Especifica o modo de replicação para a instância de banco de dados em espera. O valor não pode estar vazio. Para o MySQL, o valor é async ou semisync. Para o PostgreSQL, o valor é async ou sync. Para o Microsoft SQL Server, o valor é sync. NOTA: async indica o modo de replicação assíncrona. semisync indica o modo de replicação semi-síncrona. sync indica o modo de replicação síncrona.

**Tabela 4** Descrição da estrutura de dados do campo datastore
Nome	Obrigatório	Tipo	Descrição
type	Sim	String	Especifica o mecanismo de banco de dados. Valor: SQLServer
version	Sim	String	Especifica a versão de banco de dados. Para o Microsoft SQL Server, apenas as seguintes edições são suportadas: 2017 Enterprise Edition, 2017 Standard Edition, 2017 Web Edition, 2014 Standard Edition, 2014 Enterprise Edition, 2016 Standard Edition, 2016 Enterprise Edition, 2012 Enterprise Edition, 2012 Standard Edition, 2012 Web Edition, 2008 R2 Enterprise Edition, 2008 R2 Standard Edition, 2008 R2 Web Edition, 2014 Web Edition e 2016 Web Edition. Exemplo de valor: 2014_SE Para obter detalhes sobre as versões de banco de dados suportadas, consulte Consulta de informações de versão sobre um mecanismo de banco de dados.

**Tabela 5** Mapeamento de versão para restauração do RDS for SQL Server
Original	Restaurável para
2008 R2 Standard Edition	2012 Standard Edition 2012 Enterprise Edition 2014 Standard Edition 2014 Enterprise Edition 2016 Standard Edition 2016 Enterprise Edition 2017 Standard Edition 2017 Enterprise Edition
2012 Web Edition	2012 Web Edition 2012 Standard Edition 2012 Enterprise Edition 2014 Web Edition 2014 Standard Edition 2014 Enterprise Edition 2016 Web Edition 2016 Standard Edition 2016 Enterprise Edition 2017 Web Edition 2017 Standard Edition 2017 Enterprise Edition
2012 Standard Edition	2012 Standard Edition 2012 Enterprise Edition 2014 Standard Edition 2014 Enterprise Edition 2016 Standard Edition 2016 Enterprise Edition 2017 Standard Edition 2017 Enterprise Edition
2012 Enterprise Edition	2012 Enterprise Edition 2014 Enterprise Edition 2016 Enterprise Edition 2017 Enterprise Edition
2014 Standard Edition	2014 Standard Edition 2014 Enterprise Edition 2016 Standard Edition 2016 Enterprise Edition 2017 Standard Edition 2017 Enterprise Edition
2014 Enterprise Edition	2014 Enterprise Edition 2016 Enterprise Edition 2017 Enterprise Edition
2016 Standard Edition	2016 Standard Edition 2016 Enterprise Edition 2017 Standard Edition 2017 Enterprise Edition
2016 Enterprise Edition	2016 Enterprise Edition 2017 Enterprise Edition
2017 Web Edition	2017 Web Edition 2017 Standard Edition 2017 Enterprise Edition
2017 Standard Edition	2017 Standard Edition 2017 Enterprise Edition
2017 Enterprise Edition	2017 Enterprise Edition

**Tabela 6** Descrição da estrutura de dados do campo backup_strategy
Nome	Obrigatório	Tipo	Descrição
start_time	Sim	String	Especifica a janela de tempo de backup. Os backups automáticos serão acionados durante a janela de tempo de backup. O valor não pode estar vazio. Deve ser um valor válido no formato "hh:mm-HH:MM". A hora atual está no formato UTC. O valor de HH deve ser 1 maior que o valor de hh. Os valores de mm e MM devem ser os mesmos e devem ser definidos como: 00, 15, 30 ou 45. Valor de exemplo 08:15-09:15 23:00-00:00
keep_days	Não	Integer	Especifica os dias de retenção para arquivos de backup específicos. O intervalo de valores é de 0 a 732. Se este parâmetro não estiver especificado ou estiver definido como 0, a política de backup automático estará desativada. Para estender o período de retenção, entre em contato com o atendimento ao cliente. Backups automáticos podem ser mantidos por até 2.562 dias.

**Tabela 7** Descrição da estrutura de dados do campo volume
Nome	Obrigatório	Tipo	Descrição
type	Sim	String	Especifica o tipo de volume. O valor pode ser qualquer um dos seguintes e diferencia maiúsculas de minúsculas: ULTRAHIGH: armazenamento de SSD. LOCALSSD: indica o tipo SSD local. CLOUDSSD: indica o tipo SSD na nuvem. ESSD: indica o tipo SSD extrema.
size	Sim	Integer	Especifica o tamanho do volume. O intervalo de valor é de 40 GB a 4.000 GB. O valor deve ser um múltiplo de 10. AVISO: O tamanho do volume da nova instância de banco de dados deve ser pelo menos igual ao da instância de banco de dados original do RDS for MySQL e RDS for PostgreSQL.

**Tabela 8** Descrição da estrutura de dados do campo restore_point
Nome	Obrigatório	Tipo	Descrição
instance_id	Sim	String	Especifica o ID da instância de banco de dados.
type	Sim	String	Especifica o modo de restauração. Os valores enumerados incluem: backup: indica a restauração a partir de arquivos de backup. Neste modo, backup_id é obrigatório quando type não é obrigatório. timestamp: indica restauração de ponto no tempo. Neste modo, restore_time é obrigatório quando type é obrigatório.
backup_id	Não	String	Especifica o ID do backup usado para restaurar dados. Este parâmetro deve ser especificado quando o arquivo de backup é usado para restauração. AVISO: Quando type não é obrigatório, backup_id é obrigatório.
restore_time	Não	Integer	Especifica o ponto de tempo da restauração de dados no carimbo de data/hora UNIX. A unidade é milissegundo e o fuso horário é UTC. AVISO: Quando type é obrigatório, restore_timee é obrigatório.
database_name	Não	Map<String, String>	Este parâmetro aplica-se apenas a bases de dados do Microsoft SQL Server. Se este parâmetro estiver especificado, você poderá restaurar todos os bancos de dados ou bancos de dados específicos e renomear novos bancos de dados. Se este parâmetro não estiver especificado, todos os bancos de dados serão restaurados por padrão. Você pode inserir vários novos nomes de banco de dados e separá-los com vírgulas (,). Os novos nomes de banco de dados podem conter, mas não podem ser iguais aos nomes de banco de dados originais. Observe o seguinte quando você estiver especificando novos nomes de banco de dados: Novos nomes de banco de dados devem ser diferentes dos nomes de banco de dados originais. Se eles forem deixados em branco, os nomes originais de banco de dados serão usados para restauração por padrão. As configurações de sensibilidade a maiúsculas e minúsculas dos novos bancos de dados são as mesmas dos bancos de dados originais. Certifique-se de que os novos nomes de banco de dados sejam exclusivos. Novos nomes de banco de dados devem ser diferentes de quaisquer nomes de banco de dados na instância de banco de dados original. O número total de novos bancos de dados não pode exceder a cota de banco de dados especificada por rds_databases_quota. Novos nomes de banco de dados não podem conter os seguintes campos (não diferencia maiúsculas de minúsculas): rdsadmin, master, msdb, tempdb, mode e resource. Novos nomes de banco de dados devem conter de 1 a 64 caracteres, incluindo apenas letras, dígitos, sublinhados (_) e hifens (-). Se você quiser restaurar dados para vários bancos de dados novos, separe-os com vírgulas (,). Exemplo: "database_name":{"Original database name":"New database name"} Exemplo correto: "database_name":{"A":"A,A1,A2","B":"B1,B2","C":""} Exemplo incorreto: "database_name":{"A":"A","B":"B1,B2","C":"B1,C1","D":"D1,d1"}, As causas de erro são as seguintes: O nome do novo banco de dados (A) é o mesmo que o nome de banco de dados original (A). O novo nome de banco de dados (B1) não é exclusivo. Quando o nome de banco de dados não diferencia maiúsculas de minúsculas, os nomes de banco de dados D1 e d1 entram em conflito. CUIDADO: Antes da restauração, certifique-se de que o tamanho dos dados restaurados não exceda a capacidade de disco adquirida.

**Tabela 9** Descrição da estrutura de dados do campo charge_info
Nome	Obrigatório	Tipo	Descrição
charge_mode	Sim	String	Especifica o modo de cobrança. Intervalo de valores: prePaid: indica o modo de cobrança anual/mensal. postPaid: indica o modo de cobrança de pagamento por uso.
period_type	Não	String	Especifica o tipo de assinatura. Intervalo de valores: month: indica que o serviço é subscrito por mês. year: indica que o serviço é subscrito por ano. NOTA: Este parâmetro é válido e obrigatório se charge_mode estiver definido como prePaid.
period_num	Não	Integer	Especifica o período de subscrição. Este parâmetro é válido e obrigatório se charge_mode estiver definido como prePaid. Intervalo de valores: Quando period_type está definido como month, o valor do parâmetro varia de 1 a 9. Quando period_type é definido como year, o valor do parâmetro varia de 1 a 3.

**Tabela 10** Descrição da estrutura de dados do campo tags
Nome	Obrigatório	Tipo	Descrição
key	Sim	String	Especifica a chave da tag. Ele contém um máximo de 36 caracteres Unicode. Não pode ser uma cadeia vazia, um espaço ou deixada em branco. Pode conter letras maiúsculas e minúsculas, dígitos, hifens (-), sublinhados (_) e caracteres Unicode (\u4E00-\u9FFF).
value	Sim	String	Especifica o valor da tag. Ele contém um máximo de 43 caracteres Unicode. Pode ser uma cadeia vazia. Pode conter letras maiúsculas e minúsculas, dígitos, hifens (-), sublinhados (_) e caracteres Unicode (\u4E00-\u9FFF).

**Tabela 11** Descrição da estrutura de dados do campo unchangeable_param
Nome	Obrigatório	Tipo	Descrição
lower_case_table_names	Não	String	Se os nomes das tabelas são sensíveis a maiúsculas e minúsculas. O valor padrão é 1. Valor válido: 0: os nomes das tabelas são fixos e diferenciam maiúsculas de minúsculas. 1: os nomes das tabelas são armazenados em minúsculas e não diferenciam maiúsculas de minúsculas.

Exemplo
POST https://rds.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances

Exemplo de solicitação

Usar arquivos de backup para restauração:

MySQL/PostgreSQL:

{
	"name": "targetInst",
	"availability_zone": "bbb,ccc",
	"ha": {
		"mode": "ha",
		"replication_mode": "async"
	},
	"flavor_ref": "rds.mysql.s1.large",
	"volume": {
		"type": "ULTRAHIGH",
		"size": 40
	},
        "region": "aaa",
	"disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4",
	"vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce",
	"subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f",
	"data_vip": "192.168.0.147",
	"security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5",
	"backup_strategy": {
		"keep_days": 2,
		"start_time": "19:00-20:00"
	},
	"password": "Demo@12345678",
	"configuration_id": "52e86e87445847a79bf807ceda213165pr01",
	"enterprise_project_id": "ba1f7fc8-3307-42a7-aa6f-42c8b9b8f85c",
	"time_zone": "UTC+04:00",
	"restore_point": {
		"instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01",
		"type": "backup",
		"backup_id": "2f4ddb93-b901-4b08-93d8-1d2e472f30fe"
	}
}

Microsoft SQL Server:

{
	"name": "targetInst",
        "datastore": {
		"type": "SQLServer",
		"version": "2014_SE"
	},
	"availability_zone": "bbb,ccc",
	"ha": {
		"mode": "ha",
		"replication_mode": "sync"
	},
	"flavor_ref": "rds.mssql.2014.se.s3.xlarge.2.ha",
	"volume": {
		"type": "ULTRAHIGH",
		"size": 40
	},
	"disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4",
	"vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce",
	"subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f",
	"data_vip": "192.168.0.147",
	"security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5",
	"backup_strategy": {
		"keep_days": 2,
		"start_time": "19:00-20:00"
	},
       "charge_info": {
	       "charge_mode": "prePaid",		
               "period_type": "month",
               "period_num": 1,
               "is_auto_renew": false,
               "is_auto_pay": true
       },
	"password": "Demo@12345678",
	"configuration_id": "52e86e87445847a79bf807ceda213165pr04",
	"enterprise_project_id": "ba1f7fc8-3307-42a7-aa6f-42c8b9b8f85c",
	"time_zone": "UTC+04:00",
        "collation": "Cyrillic_General_CI_AS",
	"restore_point": {
		"instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin04",
		"type": "backup",
		"backup_id": "2f4ddb93-b901-4b08-93d8-1d2e472f30fe",
		"database_name": {
			"db1": "dbtest1,dbtest2",
			"db2": "db2,db002",
                        "db3": ""
		}
	}
}

Usar o PITR para restauração:

MySQL/PostgreSQL:

{
	"name": "targetInst",
	"availability_zone": "bbb,ccc",
	"ha": {
		"mode": "ha",
		"replication_mode": "async"
	},
	"flavor_ref": "rds.mysql.s1.large",
	"volume": {
		"type": "ULTRAHIGH",
		"size": 40
	},
	"disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4",
	"vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce",
	"subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f",
	"security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5",
	"data_vip": "192.168.0.147",
	"backup_strategy": {
		"keep_days": 2,
		"start_time": "19:00-20:00"
	},
	"password": "Demo@12345678",
	"configuration_id": "52e86e87445847a79bf807ceda213165pr01",
	"enterprise_project_id": "ba1f7fc8-3307-42a7-aa6f-42c8b9b8f85c",
	"time_zone": "UTC+04:00",
	"restore_point": {
		"instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01",
		"type": "timestamp",
		"restore_time": 1532001446987
	}
}

Microsoft SQL Server:

{
	"name": "targetInst",
        "datastore": {
		"type": "SQLServer",
		"version": "2014_SE"
	},
	"availability_zone": "bbb,ccc",
	"ha": {
		"mode": "ha",
		"replication_mode": "sync"
	},
	"flavor_ref": "rds.mssql.2014.se.s3.xlarge.2.ha",
	"volume": {
		"type": "ULTRAHIGH",
		"size": 40
	},
	"disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4",
	"vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce",
	"subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f",
	"data_vip": "192.168.0.147",
	"security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5",
	"backup_strategy": {
		"keep_days": 2,
		"start_time": "19:00-20:00"
	},
        "charge_info": {
	       "charge_mode": "prePaid",		
               "period_type": "month",
               "period_num": 1,
               "is_auto_renew": false,
               "is_auto_pay": true
       },
	"password": "Demo@12345678",
	"configuration_id": "52e86e87445847a79bf807ceda213165pr04",
	"enterprise_project_id": "ba1f7fc8-3307-42a7-aa6f-42c8b9b8f85c",
	"time_zone": "UTC+04:00",
        "collation": "Cyrillic_General_CI_AS",
	"restore_point": {
		"instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin04",
		"type": "timestamp",
		"restore_time": 1532001446987,
		"database_name": {
			"db1": "dbtest1,dbtest2",
			"db2": "db2,db02",
                        "db3": ""
		}
	}
}

Resposta

Resposta normal

**Tabela 12** Descrição do parâmetro
Nome	Tipo	Descrição
instance	Object	Indica as informações da instância de banco de dados. Para mais detalhes, consulte Tabela 13.
job_id	String	Indica o ID da tarefa de criação da instância de banco de dados. Este parâmetro é retornado somente para a restauração de uma nova instância de banco de dados cobrada na base de pagamento por uso.
order_id	String	Indica o ID do pedido. Este parâmetro é retornado somente para a criação de uma instância de banco de dados do RDS for SQL Server cobrada anualmente/mensalmente.

**Tabela 13** Descrição da instância
Nome	Tipo	Descrição
id	String	Indica o ID da instância de banco de dados.
name	String	Indica o nome da instância de banco de dados. Instâncias de banco de dados do mesmo tipo podem ter os mesmos nomes sob o mesmo locatário. Valor válido: O nome da instância de banco de dados deve ter de 4 a 64 bytes, começar com uma letra e conter apenas letras (sensíveis a maiúsculas e minúsculas), dígitos, hifens (-) e sublinhados (_).
status	String	Indica o status da instância de banco de dados. Por exemplo, BUILD indica que a instância de banco de dados está sendo criada.
datastore	Object	Indica as informações de banco de dados. Para mais detalhes, consulte Tabela 14.
ha	Object	Indica os parâmetros de configuração de HA. Este parâmetro é retornado somente quando instâncias de banco de dados primárias/em espera são criadas. Para mais detalhes, consulte Tabela 15.
configuration_id	String	Indica o ID do modelo de parâmetro. Este parâmetro é retornado somente quando um modelo de parâmetro personalizado é usado durante a criação da instância de banco de dados.
port	String	Indica as informações da porta de banco de dados. A porta de banco de dados do RDS for MySQL varia de 1024 a 65535 (excluindo 12017 e 33071, que são ocupados pelo sistema RDS e não podem ser utilizados). A porta de banco de dados do RDS for PostgreSQL varia de 2100 a 9500. A porta de banco de dados do RDS for SQL Server é 1433 ou varia de 2100 a 9500 (excluindo 5355 e 5985. Para as edições Enterprise, Standard e Web do Microsoft SQL Server 2017, a porta de banco de dados também não pode ser definida como 5050, 5353 ou 5986). Se este parâmetro não estiver definido, o valor padrão será o seguinte: RDS for MySQL: 3306. RDS for PostgreSQL: 5432 RDS for SQL Server: 1433
backup_strategy	Object	Indica a política de backup automático. Para mais detalhes, consulte Tabela 16.
enterprise_project_tag	String	Indica o ID do projeto.
flavor_ref	String	Indica o ID da especificação. Para obter detalhes, consulte spec_code em Tabela 3 na seção Consulta de especificações de banco de dados.
volume	Object	Indica as informações de volume. Para mais detalhes, consulte Tabela 17.
region	String	Indica o ID da região.
availability_zone	String	Indica o ID da AZ.
vpc_id	String	Indica o ID da VPC. Para obter o valor deste parâmetro, use um dos seguintes métodos: Método 1: faça logon no console da VPC e visualize o ID da VPC nos detalhes da VPC. Método 2: para obter detalhes, consulte a seção "Consulta das VPCs" na Referência de API da Virtual Private Cloud.
subnet_id	String	Indica o ID da rede. Para obter o valor deste parâmetro, use um dos seguintes métodos: Método 1: faça logon no console da VPC e clique na sub-rede de destino na página Subnets. Você pode exibir o ID da rede na página exibida. Método 2: para obter detalhes, consulte a seção "Consulta das VPCs" na Referência de API da Virtual Private Cloud.
security_group_id	String	Indica o grupo de segurança ao qual a instância de banco de dados do RDS pertence. Para obter o valor deste parâmetro, use um dos seguintes métodos: Método 1: faça logon no console da VPC. Escolha Access Control > Security Groups no painel de navegação à esquerda. Na página exibida, clique no grupo de segurança de destino. Você pode exibir o ID do grupo de segurança na página exibida. Método 2: consulte a seção "Consulta de grupos de segurança" na Referência de API da Virtual Private Cloud.
collation	String	Indica o agrupamento do RDS for SQL Server.
charge_info	Object	Indica as informações de cobrança, que é anual/mensal ou de pagamento por uso. Para mais detalhes, consulte Tabela 9.

**Tabela 14** Descrição da estrutura de dados do campo datastore
Nome	Obrigatório	Tipo	Descrição
type	Sim	String	Indica o mecanismo de banco de dados. O valor pode ser qualquer um dos seguintes e não faz distinção entre maiúsculas e minúsculas: MySQL PostgreSQL SQLServer
version	Sim	String	Indica a versão de banco de dados. Para obter detalhes sobre as versões de banco de dados suportadas, consulte a seção Consulta de informações de versão sobre um mecanismo de banco de dados.
complete_version	Não	String	Indica o número completo da versão. Este parâmetro é retornado somente quando o mecanismo de banco de dados é PostgreSQL.

**Tabela 15** Descrição da estrutura de dados do campo ha
Nome	Obrigatório	Tipo	Descrição
mode	Sim	String	Indica o tipo de instância primária/em espera. O valor é Ha.
replication_mode	Sim	String	Indica o modo de replicação para a instância de banco de dados em espera. O valor não pode estar vazio. Para o MySQL, o valor é async ou semisync. Para o PostgreSQL, o valor é async ou sync. Para o Microsoft SQL Server, o valor é sync. NOTA: async indica o modo de replicação assíncrona. semisync indica o modo de replicação semi-síncrona. sync indica o modo de replicação síncrona.

**Tabela 16** Descrição da estrutura de dados de campo backupStrategy
Nome	Obrigatório	Tipo	Descrição
start_time	Sim	String	Indica a janela de tempo de backup. Os backups automáticos serão acionados durante a janela de tempo de backup. O valor não pode estar vazio. Deve ser um valor válido no formato "hh:mm-HH:MM". A hora atual está no formato UTC. O valor de HH deve ser 1 maior que o valor de hh. Os valores de mm e MM devem ser os mesmos e devem ser definidos como: 00, 15, 30 ou 45. Valor de exemplo 08:15-09:15 23:00-00:00
keep_days	Não	Integer	Indica os dias de retenção para arquivos de backup específicos. O intervalo de valor é de 0 a 732. Se este parâmetro não estiver especificado ou estiver definido como 0, a política de backup automático estará desativada. Para estender o período de retenção, entre em contato com o atendimento ao cliente. Os backups automáticos podem ser mantidos por até 2.562 dias.

**Tabela 17** Descrição da estrutura de dados do campo volume
Nome	Obrigatório	Tipo	Descrição
type	Sim	String	Indica o tipo de volume. O valor pode ser qualquer um dos seguintes e diferencia maiúsculas de minúsculas: ULTRAHIGH: armazenamento de SSD. LOCALSSD: indica o tipo SSD local. CLOUDSSD: indica o tipo SSD na nuvem. ESSD: indica o tipo SSD extrema.
size	Sim	Integer	Indica o tamanho do volume. O intervalo de valor é de 40 GB a 4.000 GB. O valor deve ser um múltiplo de 10.

Exemplo de resposta normal

MySQL

{
	"instance": {
		"id": "f5ffdd8b1c98434385eb001904209eacin01",
		"name": "demoname",
		"status": "BUILD",
		"datastore": {
			"type": "MySQL",
			"version": "5.7.31"
		},
		"port": "3306",
		"volume": {
			"type": "ULTRAHIGH",
			"size": "40"
		},
		"region": "aaa",
		"backup_strategy": {
			"start_time": "02:00-03:00",
			"keep_days": "7"
		},
		"flavor_ref": "rds.mysql.s1.large",
		"availability_zone": "bbb",
		"vpc_id": "19e5d45d-70fd-4a91-87e9-b27e71c9891f",
		"subnet_id": "bd51fb45-2dcb-4296-8783-8623bfe89bb7",
		"security_group_id": "23fd0cd4-15dc-4d65-bdb3-8844cc291be0"
	},
	"job_id": "bf003379-afea-4aa5-aa83-4543542070bc"
}

PostgreSQL

{
	"instance": {
		"id": "f5ffdd8b1c98434385eb001904209eacin01",
		"name": "demoname",
		"status": "BUILD",
		"datastore": {
			"type": "PostgreSQL",
			"version": "9.6.13"
		},
		"port": "5432",
		"volume": {
			"type": "ULTRAHIGH",
			"size": "40"
		},
		"region": "aaa",
		"backup_strategy": {
			"start_time": "02:00-03:00",
			"keep_days": "7"
		},
		"flavor_ref": "rds.pg.s1.large",
		"availability_zone": "bbb",
		"vpc_id": "19e5d45d-70fd-4a91-87e9-b27e71c9891f",
		"subnet_id": "bd51fb45-2dcb-4296-8783-8623bfe89bb7",
		"security_group_id": "23fd0cd4-15dc-4d65-bdb3-8844cc291be0"
	},
	"job_id": "bf003379-afea-4aa5-aa83-4543542070bc"
}

SQL Server

{
	"instance": {
		"id": "f5ffdd8b1c98434385eb001904209eacin01",
		"name": "demoname",
		"status": "BUILD",
		"datastore": {
			"type": "sqlserver",
			"version": "2014_SE"
		},
		"port": "2100",
		"volume": {
			"type": "ULTRAHIGH",
			"size": "40"
		},
		"region": "aaa",
		"backup_strategy": {
			"start_time": "02:00-03:00",
			"keep_days": "7"
		},
		"flavor_ref": "rds.mssql.2014.se.s3.large.2",
		"availability_zone": "bbb",
		"vpc_id": "19e5d45d-70fd-4a91-87e9-b27e71c9891f",
		"subnet_id": "bd51fb45-2dcb-4296-8783-8623bfe89bb7",
		"security_group_id": "23fd0cd4-15dc-4d65-bdb3-8844cc291be0",
                "charge_info": {           
                       "charge_mode": "prePaid",            
                       "period_num": 1        
                 },        
                "collation": "Cyrillic_General_CI_AS"
	},
	"order_id": "CS20122919584LQ7K"
}

Resposta anormal
Para mais detalhes, consulte Resultados anormais da solicitação.

Código de status

Normal
202
Anormal
Para mais detalhes, consulte Códigos de status.

Código de erro

Para mais detalhes, consulte Códigos de erro.

Restauração de dados em uma nova instância de banco de dados