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.
Computação
Elastic Cloud Server
Bare Metal Server
Auto Scaling
Image Management Service
Dedicated Host
FunctionGraph
Cloud Phone Host
Huawei Cloud EulerOS
Redes
Virtual Private Cloud
Elastic IP
Elastic Load Balance
NAT Gateway
Direct Connect
Virtual Private Network
VPC Endpoint
Cloud Connect
Enterprise Router
Enterprise Switch
Global Accelerator
Gerenciamento e governança
Cloud Eye
Identity and Access Management
Cloud Trace Service
Resource Formation Service
Tag Management Service
Log Tank Service
Config
Resource Access Manager
Simple Message Notification
Application Performance Management
Application Operations Management
Organizations
Optimization Advisor
Cloud Operations Center
Resource Governance Center
Migração
Server Migration Service
Object Storage Migration Service
Cloud Data Migration
Migration Center
Cloud Ecosystem
KooGallery
Partner Center
User Support
My Account
Billing Center
Cost Center
Resource Center
Enterprise Management
Service Tickets
HUAWEI CLOUD (International) FAQs
ICP Filing
Support Plans
My Credentials
Customer Operation Capabilities
Partner Support Plans
Professional Services
Análises
MapReduce Service
Data Lake Insight
CloudTable Service
Cloud Search Service
Data Lake Visualization
Data Ingestion Service
GaussDB(DWS)
DataArts Studio
IoT
IoT Device Access
Outros
Product Pricing Details
System Permissions
Console Quick Start
Common FAQs
Instructions for Associating with a HUAWEI CLOUD Partner
Message Center
Segurança e conformidade
Security Technologies and Applications
Web Application Firewall
Host Security Service
Cloud Firewall
SecMaster
Anti-DDoS Service
Data Encryption Workshop
Database Security Service
Cloud Bastion Host
Data Security Center
Cloud Certificate Manager
Situation Awareness
Managed Threat Detection
Blockchain
Blockchain Service
Serviços de mídia
Media Processing Center
Video On Demand
Live
SparkRTC
Armazenamento
Object Storage Service
Elastic Volume Service
Cloud Backup and Recovery
Cloud Server Backup Service
Storage Disaster Recovery Service
Scalable File Service
Volume Backup Service
Data Express Service
Dedicated Distributed Storage Service
Containers
Cloud Container Engine
SoftWare Repository for Container
Application Service Mesh
Ubiquitous Cloud Native Service
Cloud Container Instance
Bancos de dados
Relational Database Service
Document Database Service
Data Admin Service
Data Replication Service
GeminiDB
GaussDB
Distributed Database Middleware
Database and Application Migration UGO
TaurusDB
Middleware
Distributed Cache Service
API Gateway
Distributed Message Service for Kafka
Distributed Message Service for RabbitMQ
Distributed Message Service for RocketMQ
Cloud Service Engine
EventGrid
Dedicated Cloud
Dedicated Computing Cluster
Aplicações de negócios
ROMA Connect
Message & SMS
Domain Name Service
Edge Data Center Management
Meeting
AI
Face Recognition Service
Graph Engine Service
Content Moderation
Image Recognition
Data Lake Factory
Optical Character Recognition
ModelArts
ImageSearch
Conversational Bot Service
Speech Interaction Service
Huawei HiLens
Developer Tools
SDK Developer Guide
API Request Signing Guide
Terraform
Koo Command Line Interface
Distribuição de conteúdo e computação de borda
Content Delivery Network
Intelligent EdgeFabric
CloudPond
Soluções
SAP Cloud
High Performance Computing
Serviços para desenvolvedore
ServiceStage
CodeArts
CodeArts PerfTest
CodeArts Req
CodeArts Pipeline
CodeArts Build
CodeArts Deploy
CodeArts Artifact
CodeArts TestPlan
CodeArts Check
Cloud Application Engine
MacroVerse aPaaS
KooPhone
KooDrive
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

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

Atualizado em 2023-05-05 GMT+08:00

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.

Usamos cookies para aprimorar nosso site e sua experiência. Ao continuar a navegar em nosso site, você aceita nossa política de cookies. Saiba mais

Feedback

Feedback

Feedback

0/500

Conteúdo selecionado

Envie o conteúdo selecionado com o feedback