Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda> Relational Database Service> Referência de API> API v3 (recomendada)> Backup e restauração> Restauração de dados em uma nova instância de banco de dados
Atualizado em 2023-05-05 GMT+08:00

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

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:

    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:

    1. O nome do novo banco de dados (A) é o mesmo que o nome de banco de dados original (A).
    2. O novo nome de banco de dados (B1) não é exclusivo.
    3. 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

Código de erro

Para mais detalhes, consulte Códigos de erro.