Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Cómputo
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
Gestión y gobernanza
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
Migración
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álisis
MapReduce Service
Data Lake Insight
CloudTable Service
Cloud Search Service
Data Lake Visualization
Data Ingestion Service
GaussDB(DWS)
DataArts Studio
IoT
IoT Device Access
Otros
Product Pricing Details
System Permissions
Console Quick Start
Common FAQs
Instructions for Associating with a HUAWEI CLOUD Partner
Message Center
Seguridad y cumplimiento
Security Technologies and Applications
Web Application Firewall
Host Security Service
Cloud Firewall
SecMaster
Data Encryption Workshop
Database Security Service
Cloud Bastion Host
Data Security Center
Cloud Certificate Manager
Situation Awareness
Managed Threat Detection
Blockchain
Blockchain Service
Servicios multimedia
Media Processing Center
Video On Demand
Live
SparkRTC
Almacenamiento
Object Storage Service
Elastic Volume Service
Cloud Backup and Recovery
Storage Disaster Recovery Service
Scalable File Service
Volume Backup Service
Cloud Server Backup Service
Data Express Service
Dedicated Distributed Storage Service
Contenedores
Cloud Container Engine
SoftWare Repository for Container
Application Service Mesh
Ubiquitous Cloud Native Service
Cloud Container Instance
Bases de datos
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
Aplicaciones empresariales
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
Distribución de contenido y cómputo de borde
Content Delivery Network
Intelligent EdgeFabric
CloudPond
Soluciones
SAP Cloud
High Performance Computing
Servicios para desarrolladores
ServiceStage
CodeArts
CodeArts PerfTest
CodeArts Req
CodeArts Pipeline
CodeArts Build
CodeArts Deploy
CodeArts Artifact
CodeArts TestPlan
CodeArts Check
Cloud Application Engine
aPaaS MacroVerse
KooPhone
KooDrive

Restauración de datos en una instancia de base de datos nueva

Actualización más reciente 2024-06-06 GMT+08:00

Función

Esta API se utiliza para restaurar datos a una nueva instancia de base de datos.

Restricciones

  • El motor de base de datos de la instancia de base de datos original debe ser el mismo que el de la instancia de base de datos de destino. Por ejemplo, si la instancia de base de datos original está ejecutando MySQL, la instancia de base de datos de destino también debe ejecutar MySQL.
  • Las restricciones de las instancias de base de datos originales y de destino son las siguientes:
    • Para RDS for MySQL y RDS for PostgreSQL, las versiones del motor de base de datos de las instancias de base de datos original y de destino deben ser las mismas.
  • Para RDS for MySQL y RDS for PostgreSQL, el tamaño total del volumen de la instancia de base de datos de destino debe ser al menos igual al de la instancia de base de datos original.

URI

  • Formato de URI

    POST /v3/{project_id}/instances

  • Descripción del parámetro
    Tabla 1 Descripción de parámetro

    Nombre

    Obligatorio

    Descripción

    project_id

    Especifica el ID de proyecto de un tenant en una región.

    Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.

Solicitud

  • Descripción de parámetro
    Tabla 2 Descripción de parámetro

    Nombre

    Obligatorio

    Tipo

    Descripción

    name

    String

    Especifica el nombre de instancia de base de datos.

    Las instancias de base de datos del mismo tipo pueden tener los mismos nombres bajo el mismo tenant.

    Valores válidos:

    • RDS for MySQL: El nombre de la instancia de base de datos debe tener de 4 a 64 bytes largos, comenzar con una letra y contener solo letras (sensible a mayúsculas), dígitos, guiones (-), puntos (.), y guiones bajos (_).
    • RDS for PostgreSQL y RDS for SQL Server: El nombre de la instancia de base de datos debe tener de 4 a 64 bytes largos, comenzar con una letra y contener solo letras (sensible a mayúsculas y minúsculas), dígitos, guiones (-) y guiones bajos (_).

    datastore

    No

    Object

    Especifica la información de la base de datos. Este parámetro se utiliza solo para instancias de base de datos de RDS for SQL Server y es obligatorio para la restauración de versiones cruzadas a instancias de base de datos nuevas.

    Para obtener más información, consulte Tabla 4.

    Para obtener más información acerca de las versiones para restauración de RDS for SQL Server, vea Tabla 5.

    ha

    No

    Object

    Especifica los parámetros de configuración de HA, que se utilizan al crear instancias de base de datos primarias o en espera.

    Para obtener más información, consulte Tabla 3.

    configuration_id

    No

    String

    Especifica el ID de plantilla de parámetro.

    port

    No

    String

    Especifica la información del puerto de la base de datos.

    • Las instancias de RDS for MySQL pueden usar los puertos de base de datos 1024 a 65535, excluidos 12017 y 33071, que están reservados para el uso del sistema RDS.
    • Las instancias de RDS for PostgreSQL pueden utilizar los puertos de base de datos 2100 a 9500.
    • Las instancias de RDS for SQL Server puede utilizar el puerto de base de datos 1433 o los puertos de base de datos 2100 a 9500 (excluidos 5355 y 5985. Para Microsoft SQL Server 2017 Enterprise, Standard, y Web editions, el puerto de base de datos no se puede establecer en 5050, 5353 o 5986).

    Si este parámetro no está definido, el valor predeterminado es el siguiente:

    • RDS for MySQL: 3306
    • RDS for PostgreSQL: 5432
    • RDS for SQL Server: 1433

    password

    String

    Especifica la contraseña de la base de datos.

    Valores válidos:

    Una contraseña de base de datos debe tener entre 8 y 32 caracteres y contener al menos tres tipos de los siguientes caracteres: letras mayúsculas, letras minúsculas, dígitos y caracteres especiales.

    • RDS for MySQL: ~!@#$%^*-_=+?,()&
    • RDS for SQL Server: ~!@#$%^*-_+?,
    • RDS for PostgreSQL: ~!@#%^*-_=+?,

    Se recomienda introducir una contraseña segura para mejorar la seguridad, evitando riesgos de seguridad como el agrietamiento por fuerza bruta.

    backup_strategy

    No

    Object

    Especifica la política de copia de respaldo avanzada.

    Para obtener más información, consulte Tabla 6.

    enterprise_project_id

    No

    String

    Especifica el ID del proyecto.

    disk_encryption_id

    No

    String

    Especifica el ID de clave para la encriptación de disco. El valor predeterminado es vacío.

    flavor_ref

    String

    Especifica el código de especificación. El valor no puede estar vacío.

    Para obtener más información, consulte spec_code en la sección Consulta de especificaciones de base de datos.

    volume

    Object

    Especifica la información del volumen.

    Para obtener más información, consulte Tabla 7.

    region

    No

    String

    Especifica el ID de la región. Para obtener más información, consulte Regiones y puntos de conexión.

    availability_zone

    String

    Especifica el ID de zona de disponibilidad. Si la instancia de base de datos no es una única instancia, debe especificar una zona de disponibilidad para cada nodo de la instancia y separar las zonas de disponibilidad con comas (,). Para obtener más información, consulte el ejemplo.

    El valor no puede estar vacío. Para obtener más información sobre cómo obtener este valor de parámetro, consulte Regiones y puntos de conexión.

    vpc_id

    No

    String

    Especifica el ID de la VPC. Para obtener este valor de parámetro, utilice uno de los métodos siguientes:

    • Método 1: Inicie sesión en la consola de VPC y vea el ID de VPC en los detalles de la VPC.
    • Method 2: See the "Querying VPCs" section in the Virtual Private Cloud API Reference.

    subnet_id

    No

    String

    Especifica el ID de red. Para obtener este valor de parámetro, utilice uno de los métodos siguientes:

    • Method 1: Log in to VPC console and click the target subnet on the Subnets page. You can view the network ID on the displayed page.
    • Method 2: See the "Querying Subnets" section in the Virtual Private Cloud API Reference.

    data_vip

    No

    String

    Especifica la dirección IP flotante de una instancia de base de datos. Para obtener este valor de parámetro, utilice uno de los métodos siguientes:

    • Método 1: Inicie sesión en la consola de VPC y haga clic en la subred de destino en la página Subnets. Puede ver el bloque CIDR de subred en la página mostrada.
    • Método 2: Vea la sección "Consulta de subredes" en la Referencia de API de Virtual Private Cloud.

    security_group_id

    No

    String

    Especifica el grupo de seguridad al que pertenece la instancia de base de datos de RDS. Para obtener este valor de parámetro, utilice uno de los métodos siguientes:

    • Método 1: Inicie sesión en la consola de VPC. Seleccione Access Control > Security Groups en el panel de navegación de la izquierda. En la página mostrada, haga clic en el grupo de seguridad de destino. Puede ver el ID del grupo de seguridad en la página mostrada.
    • Method 2: See the "Querying Security Groups" section in the Virtual Private Cloud API Reference.

    Para utilizar varios grupos de seguridad para una instancia de RDS for MySQL, elija Service Tickets > Create Service Ticket en la esquina superior derecha de la consola de gestión para solicitar los permisos necesarios. Puede agregar hasta 10 ID de grupo de seguridad para cada instancia y separarlos con comas (,).

    restore_point

    Object

    Especifica la información de restauración.

    Para obtener más información, consulte Tabla 8.

    charge_info

    No

    Object

    Especifica la información de facturación, que es anual/mensual o de pago por uso (configuración predeterminada). Solo RDS for SQL Server admite la restauración de instancias de base de datos anuales/mensuales en instancias nuevas.

    Para obtener más información, consulte Tabla 9.

    time_zone

    No

    String

    Especifica la zona horaria UTC.

    • Si no se especifica este parámetro, la zona horaria de cada motor es la siguiente:
      • MySQL: El sitio de China continental y el sitio internacional usan UTC de forma predeterminada.
      • PostgreSQL: El sitio de China continental y el sitio internacional usan UTC por defecto.
      • Microsoft SQL Server: sitio de China continental y sitio internacional utilizan hora estándar de China y UTC, respectivamente.
    • Si se especifica este parámetro, el rango de valores es de UTC-12:00 a UTC+12:00 en la hora. Por ejemplo, el parámetro puede ser UTC+08:00 en lugar de UTC+08:30.

    dsspool_id

    No

    String

    Especifica el ID del grupo DSS de los usuarios de DeC. El grupo DSS configurado para cada zona de disponibilidad es diferente. Cuando los usuarios de DeC crean instancias de base de datos distintas de las instancias individuales o réplicas de lectura, los ID de grupo de DSS deben especificarse para todos los nodos de las instancias de base de datos y deben estar separados por comas (,). Para obtener el ID de grupo DSS, puede utilizar cualquiera de los métodos siguientes:

    • Método 1: Inicie sesión en la consola de DSS, vea la lista de grupos de DSS y seleccione el ID de DSS deseado en la zona de disponibilidad.
    • Método 2: Consultar el ID de grupo de DSS usando la API de DSS. Para obtener más información, consulte Obtención de detalles de grupo de almacenamiento DSS.

    replica_of_id

    No

    String

    Especifica el ID de la instancia de base de datos principal. Este parámetro es obligatorio cuando se crea una réplica de lectura y no está disponible en otros escenarios.

    collation

    No

    String

    Este parámetro sólo se aplica para instancias de base de datos de RDS for SQL Server.

    Intervalo de valores: conjuntos de caracteres consultados en Consulta del conjunto de caracteres de SQL Server disponible.

    tags

    No

    Array of objects

    Especifica la lista de etiquetas. Las instancias de base de datos se crean basándose en claves y valores de etiquetas.

    • {key} indica la clave de etiqueta. Debe ser único y no puede estar vacío.
    • {value} indica el valor de la etiqueta, que puede estar vacío.

    Si desea crear instancias de base de datos con múltiples claves de etiquetas y valores, sepárelas con comas (,). Se puede añadir un máximo de 20 pares de clave-valor para una instancia de base de datos.

    Para obtener más información, consulte Tabla 10.

    unchangeable_param

    No

    Object

    Especifica la lista de parámetros que no se pueden cambiar. Los parámetros no modificables deben especificarse antes de la inicialización de la base de datos y no pueden modificarse después de especificarse.

    Para obtener más información, consulte Tabla 11.

    dry_run

    No

    Boolean

    Especifica si las instancias de base de datos no se crearán después de comprobar la solicitud. Este parámetro solo es compatible con MySQL.

    • true: no se crearán instancias de base de datos después de comprobar la solicitud.
      • Si la comprobación tiene éxito, se devuelve el código de estado 202.
      • Si la comprobación falla, se devuelve un código de error. Para obtener más información, consulte Códigos de error.
    • false: Las instancias de base de datos se crearán después de que la comprobación se realice correctamente.
    Tabla 3 descripción de la estructura de datos de campo ha

    Nombre

    Obligatorio

    Tipo

    Descripción

    mode

    String

    Especifica el tipo de instancia principal/en espera. El valor es Ha (insensible a mayúsculas y minúsculas).

    replication_mode

    String

    Especifica el modo de replicación de la instancia de base de datos en espera.

    El valor no puede estar vacío.

    • RDS for MySQL: El valor es async o semisync.
    • RDS for PostgreSQL: El valor es async o sync.
    • RDS for SQL Server: El valor es sync.
    NOTA:
    • async indica el modo de replicación asincrónica.
    • semisync indica el modo de replicación semisincrónica.
    • sync indica el modo de replicación sincrónica.
    Tabla 4 descripción de la estructura de datos del campo de datastore

    Nombre

    Obligatorio

    Tipo

    Descripción

    type

    String

    Especifica el motor de base de datos. Valor:

    SQLServer

    version

    String

    Especifica la versión de la base de datos.

    • Para RDS for SQL Server, solo 2019 Enterprise Edition, 2019 Standard Edition, 2019 Web Edition, 2017 Enterprise Edition, 2017 Standard Edition, 2017 Web Edition, 2014 Standard Edition, 2014 Enterprise Edition, 2016 Enterprise Edition, 2012 Enterprise Edition, 2012 Standard Edition, 2012 Web Edition, 2014 Web Edition y 2016 Web Edition son compatibles. Valor de ejemplo: 2014_SE 2008 R2 Enterprise Edition y 2008 R2 Web Edition son solo para las operaciones básicas instaladas.

    Para obtener más información acerca de las versiones de bases de datos compatibles, consulte Consulta de información de versión acerca de un motor de base de datos.

    Tabla 5 Asignación de versiones para restauración de RDS for SQL Server

    Original

    Restaurar a

    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

    Tabla 6 descripción de la estructura de datos del campo backup_strategy

    Nombre

    Obligatorio

    Tipo

    Descripción

    start_time

    String

    Especifica la ventana de tiempo de copia de respaldo. Las copias de respaldo automatizadas se activarán durante la ventana de tiempo de copia de respaldo.

    El valor no puede estar vacío. Debe ser un valor válido en el formato "hh:mm-HH:MM". La hora actual está en el formato UTC.

    • El valor HH debe ser 1 mayor que el valor hh.
    • Los valores de mm y MM deben ser los mismos y deben establecerse en cualquiera de los siguientes: 00, 15, 30 o 45.

    Valor de ejemplo:

    • 08:15-09:15
    • 23:00-00:00

    keep_days

    No

    Integer

    Especifica los días de retención para archivos de copia de respaldo específicos.

    El intervalo de valores es de 0 a 732. Si este parámetro no se especifica ni se establece en 0, se deshabilita la política de copia de respaldo automatizada. Para ampliar el período de retención, póngase en contacto con el servicio de atención al cliente. Las copias de respaldo automatizadas se pueden conservar hasta 2,562 días.

    Tabla 7 descripción de la estructura de datos de campo de volumen

    Nombre

    Obligatorio

    Tipo

    Descripción

    type

    String

    Especifica el tipo de volumen.

    Su valor puede ser cualquiera de los siguientes y distingue entre mayúsculas y minúsculas:

    • ULTRAHIGH: tipo de E/S ultraalta.
    • LOCALSSD: indica el tipo de SSD local.
    • CLOUDSSD: indica el tipo de SSD en la nube.
    • ESSD: indica el tipo de SSD extremo.

    size

    Integer

    Especifica el tamaño del volumen.

    Su rango de valores es de 40 GB a 4,000 GB. El valor debe ser un múltiplo de 10.

    AVISO:

    El tamaño del volumen de la nueva instancia de base de datos debe ser al menos igual al de la instancia de base de datos original para RDS for MySQL y RDS for PostgreSQL.

    Tabla 8 descripción de la estructura de datos del campo de restore_point

    Nombre

    Obligatorio

    Tipo

    Descripción

    instance_id

    String

    Especifica el ID de instancia de base de datos.

    type

    String

    Especifica el modo de restauración. Los valores enumerados incluyen:

    • backup: indica la restauración de archivos de copia de respaldo. En este modo, backup_id son obligatorias cuando type no son obligatorias.
    • timestamp: indica una restauración puntual. En este modo, restore_time son obligatorias cuando type son obligatorias.

    backup_id

    No

    String

    Especifica el ID de la copia de respaldo utilizada para restaurar los datos. Este parámetro debe especificarse cuando se utiliza el archivo de copia de respaldo para la restauración.

    AVISO:

    Cuando type no son obligatorias, backup_id son obligatorias.

    restore_time

    No

    Integer

    Especifica el punto de tiempo de restauración de datos en la marca de tiempo de UNIX. La unidad es de milisegundos y la zona horaria es UTC.

    AVISO:

    Cuando type son obligatorias, restore_time son obligatorias.

    database_name

    No

    Map<String, String>

    Este parámetro sólo se aplica a las bases de datos de Microsoft SQL Server.

    • Si se especifica este parámetro, puede restaurar todas las bases de datos o determinadas y cambiar el nombre de nuevas bases de datos.
    • Si no se especifica este parámetro, todas las bases de datos se restauran de forma predeterminada.
    • Puede introducir varios nuevos nombres de base de datos y separarlos con comas (,). Los nuevos nombres de base de datos pueden contener pero no pueden ser los mismos que los nombres de base de datos originales.
    • Tenga en cuenta lo siguiente cuando especifique nuevos nombres de base de datos:
      • Los nuevos nombres de base de datos deben ser diferentes de los nombres de base de datos originales. Si se dejan en blanco, los nombres de base de datos originales se usarán para la restauración de forma predeterminada.
      • Los ajustes de sensibilidad a mayúsculas y minúsculas de las nuevas bases de datos son los mismos que los de las bases de datos originales. Asegúrese de que los nuevos nombres de base de datos sean únicos.
      • Los nuevos nombres de base de datos deben ser diferentes de los nombres de base de datos de la instancia de base de datos original.
      • El número total de bases de datos nuevas no puede exceder la cuota de base de datos especificada por rds_databases_quota.
      • Los nuevos nombres de bases de datos no pueden contener los siguientes campos (sin distinción entre mayúsculas y minúsculas): rdsadmin, master, msdb, tempdb, model y resource.
      • Los nuevos nombres de bases de datos deben constar de 1 a 64 caracteres, incluidos solo letras, dígitos, guiones bajos (_), y guiones (-). Si desea restaurar datos en varias bases de datos nuevas, sepárelas con comas (,).

    Ejemplo:

    "database_name":{"Original database name":"New database name"}

    Ejemplo correcto: "database_name":{"A":"A,A1,A2","B":"B1,B2","C":""}

    Ejemplo incorrecto: "database_name":{"A":"A","B":"B1,B2","C":"B1,C1","D":"D1,d1"},

    Las causas de error son las siguientes:

    1. El nuevo nombre de base de datos (A) es el mismo que el nombre de base de datos original (A).
    2. El nuevo nombre de base de datos (B1) no es único.
    3. Cuando el nombre de la base de datos no distingue entre mayúsculas y minúsculas, los nombres de base de datos D1 y d1 entran en conflicto.
      ATENCIÓN:

      Antes de la restauración, asegúrese de que el tamaño de los datos restaurados no exceda la capacidad de disco adquirida.

    Tabla 9 descripción de la estructura de datos del campo de charge_info

    Nombre

    Obligatorio

    Tipo

    Descripción

    charge_mode

    String

    Especifica el modo de facturación.

    Rango de valores:

    • prePaid: indica el modo de facturación anual/mensual.
    • postPaid: indica el modo de facturación de pago por uso.

    period_type

    No

    String

    Especifica el tipo de suscripción.

    Rango de valores:

    • month: indica que el servicio está suscrito por mes.
    • year: indica que el servicio está suscrito por año.
      NOTA:

      Este parámetro es válido y obligatorio si charge_mode tiene el valor de prePaid.

    period_num

    No

    Integer

    Especifica el período de suscripción. Este parámetro es válido y obligatorio si charge_mode tiene el valor de prePaid.

    Rango de valores:

    • Cuando period_type se establece en month el valor del parámetro oscila entre 1 y 9.
    • Cuando period_type se establece en year, el valor del parámetro oscila entre 1 y 3.

    is_auto_renew

    No

    boolean

    Especifica si la renovación automática está habilitada para instancias de base de datos anuales o mensuales. El período de renovación es el mismo que el período original y el pedido se pagará automáticamente.

    • true: indica que la renovación automática está activada.
    • false: indica que la renovación automática está deshabilitada. El valor predeterminado es false.

    is_auto_pay

    No

    boolean

    Especifica si el pedido se pagará automáticamente después de crear instancias de base de datos anuales/mensuales. Este parámetro no afecta al modo de pago de la renovación automática.

    • true: indica que el pedido se pagará automáticamente.
    • false: indica que el pedido se pagará manualmente. El valor predeterminado es false.

    Tabla 10 descripción de estructura de datos de campo de etiquetas

    Nombre

    Obligatorio

    Tipo

    Descripción

    key

    String

    Clave de etiqueta. Debe constar de 1 a 128 caracteres Unicode, incluidos letras, dígitos, espacios y caracteres especiales _.:=+-@. Sin embargo, no puede comenzar o terminar con un espacio, o comenzar con _sys_.

    value

    String

    Valor de etiqueta. Puede dejarse en blanco o contener un máximo de 255 caracteres Unicode, incluidos letras, dígitos, espacios y caracteres especiales _.:=+-@.

    Tabla 11 descripción de la estructura de datos del campo unchangeable_param

    Nombre

    Obligatorio

    Tipo

    Descripción

    lower_case_table_names

    No

    String

    Si los nombres de tabla distinguen entre mayúsculas y minúsculas. El valor predeterminado es 1.

    Valores válidos:

    • 0: Los nombres de las tablas son fijos y distinguen entre mayúsculas y minúsculas.
    • 1: Los nombres de las tablas se almacenan en minúsculas y no distinguen entre mayúsculas y minúsculas.

Solicitud de ejemplo

  • Restaurar una copia de respaldo de RDS for MySQL en una nueva instancia de base de datos
    POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances
    
    {
    	"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"
    	}
    }
  • Restaurar algunas bases de datos en una nueva instancia de base de datos desde una copia de respaldo de RDS for 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": ""
    		}
    	}
    }
  • Restauración de datos de una instancia de base de datos RDS for MySQL a un punto específico en el tiempo
    {
    	"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
    	}
    }
  • Restaurar algunas bases de datos de una instancia de RDS for SQL Server a un punto específico en el tiempo
    {
    	"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": ""
    		}
    	}
    }

Respuesta

  • Respuesta normal
    Tabla 12 Descripción de parámetro

    Nombre

    Tipo

    Descripción

    instance

    Object

    Indica la información de instancia de base de datos.

    Para obtener más información, consulte Tabla 13.

    job_id

    String

    Indica el ID de la tarea de creación de instancia de base de datos. Este parámetro se devuelve solo para la restauración en una nueva instancia de base de datos facturada sobre la base de pago por uso.

    order_id

    String

    Indica el ID de pedido. Este parámetro se devuelve sólo para la creación de una instancia de base de datos de RDS for SQL Server facturada anualmente/mensualmente.

    Tabla 13 Descripción de la instancia

    Nombre

    Tipo

    Descripción

    id

    String

    Indica el ID de instancia de base de datos.

    name

    String

    Indica el nombre de la instancia de base de datos.

    Las instancias de base de datos del mismo tipo pueden tener los mismos nombres bajo el mismo tenant.

    status

    String

    Indica el estado de la instancia de base de datos. Por ejemplo, BUILD indica que se está creando la instancia de base de datos.

    datastore

    Object

    Indica la información de la base de datos.

    Para obtener más información, consulte Tabla 14.

    ha

    Object

    Indica los parámetros de configuración de HA. Este parámetro se devuelve solo cuando se crean instancias de base de datos primarias/en espera.

    Para obtener más información, véase Tabla 15.

    configuration_id

    String

    Indica el ID de plantilla de parámetro. Este parámetro sólo se devuelve cuando se utiliza una plantilla de parámetro personalizada durante la creación de una instancia de base de datos.

    port

    String

    Indica la información del puerto de la base de datos.

    • Las instancias de RDS for MySQL pueden usar los puertos de base de datos 1024 a 65535, excluidos 12017 y 33071, que están reservados para el uso del sistema RDS.
    • Las instancias de RDS for PostgreSQL pueden utilizar los puertos de base de datos 2100 a 9500.
    • Las instancias de RDS for SQL Server puede utilizar el puerto de base de datos 1433 o los puertos de base de datos 2100 a 9500 (excluidos 5355 y 5985. Para Microsoft SQL Server 2017 Enterprise, Standard, y Web editions, el puerto de base de datos no se puede establecer en 5050, 5353 o 5986).

    Si este parámetro no está definido, el valor predeterminado es el siguiente:

    • RDS for MySQL: 3306
    • RDS for PostgreSQL: 5432
    • RDS for SQL Server: 1433

    backup_strategy

    Object

    Indica la política de copia de respaldo automatizada.

    Para obtener más información, véase Tabla 16.

    enterprise_project_tag

    String

    Indica el ID del proyecto.

    flavor_ref

    String

    Indica el ID de especificación.

    Para obtener más información, consulte spec_code de Tabla 3 en la sección Consulta de especificaciones de base de datos.

    volume

    Object

    Indica la información del volumen.

    Para obtener más información, consulte Tabla 17.

    region

    String

    Indica el ID de región.

    availability_zone

    String

    Indica el ID de zona de disponibilidad.

    vpc_id

    String

    Indica el ID de VPC. Para obtener este valor de parámetro, utilice uno de los métodos siguientes:

    • Método 1: Inicie sesión en la consola de VPC y vea el ID de VPC en los detalles de la VPC.
    • Method 2: See the "Querying VPCs" section in the Virtual Private Cloud API Reference.

    subnet_id

    String

    Indica el ID de red. Para obtener este valor de parámetro, utilice uno de los métodos siguientes:

    • Method 1: Log in to VPC console and click the target subnet on the Subnets page. You can view the network ID on the displayed page.
    • Method 2: See the "Querying Subnets" section in the Virtual Private Cloud API Reference.

    security_group_id

    String

    Indica el grupo de seguridad al que pertenece la instancia de base de datos de RDS. Para obtener este valor de parámetro, utilice uno de los métodos siguientes:

    • Método 1: Inicie sesión en la consola de VPC. Seleccione Access Control > Security Groups en el panel de navegación de la izquierda. En la página mostrada, haga clic en el grupo de seguridad de destino. Puede ver el ID del grupo de seguridad en la página mostrada.
    • Method 2: See the "Querying Security Groups" section in the Virtual Private Cloud API Reference.

    collation

    String

    Indica la intercalación de RDS for SQL Server.

    charge_info

    Object

    Indica la información de facturación, que es anual/mensual o de pago por uso.

    Para obtener más información, consulte Tabla 9.

    Tabla 14 descripción de la estructura de datos del campo de datastore

    Nombre

    Obligatorio

    Tipo

    Descripción

    type

    String

    Indica el motor de base de datos. Su valor puede ser cualquiera de los siguientes y no distingue entre mayúsculas y minúsculas:

    • MySQL
    • PostgreSQL
    • SQLServer

    version

    String

    Indica la versión de la base de datos.

    Para obtener más información acerca de las versiones de bases de datos compatibles, consulte la sección Consulta de información de versión acerca de un motor de base de datos.

    complete_version

    No

    String

    Indica el número de versión completo. Este parámetro se devuelve solo cuando el motor de base de datos es PostgreSQL.

    Tabla 15 descripción de la estructura de datos de campo ha

    Nombre

    Obligatorio

    Tipo

    Descripción

    mode

    String

    Indica el tipo de instancia principal/en espera . El valor es Ha.

    replication_mode

    String

    Indica el modo de replicación de la instancia de base de datos en espera.

    El valor no puede estar vacío.

    • RDS for MySQL: El valor es async o semisync.
    • RDS for PostgreSQL: El valor es async o sync.
    • RDS for SQL Server: El valor es sync.
    NOTA:
    • async indica el modo de replicación asincrónica.
    • semisync indica el modo de replicación semisincrónica.
    • sync indica el modo de replicación sincrónica.
    Tabla 16 descripción de la estructura de datos de campo de backupStrategy

    Nombre

    Obligatorio

    Tipo

    Descripción

    start_time

    String

    Indica la ventana de tiempo de copia de respaldo. Las copias de respaldo automatizadas se activarán durante la ventana de tiempo de copia de respaldo.

    El valor no puede estar vacío. Debe ser un valor válido en el formato "hh:mm-HH:MM". La hora actual está en el formato UTC.

    • El valor HH debe ser 1 mayor que el valor hh.
    • Los valores de mm y MM deben ser los mismos y deben establecerse en cualquiera de los siguientes: 00, 15, 30 o 45.

    Valor de ejemplo:

    • 08:15-09:15
    • 23:00-00:00

    keep_days

    No

    Integer

    Indica los días de retención de archivos de copia de respaldo específicos.

    El intervalo de valores es de 0 a 732. Si este parámetro no se especifica ni se establece en 0, se deshabilita la política de copia de respaldo automatizada. Para ampliar el período de retención, póngase en contacto con el servicio de atención al cliente. Las copias de respaldo automatizadas se pueden conservar hasta 2,562 días.

    Tabla 17 descripción de la estructura de datos de campo de volumen

    Nombre

    Obligatorio

    Tipo

    Descripción

    type

    String

    Indica el tipo de volumen.

    Su valor puede ser cualquiera de los siguientes y distingue entre mayúsculas y minúsculas:

    • ULTRAHIGH: tipo de E/S ultraalta.
    • LOCALSSD: indica el tipo de SSD local.
    • CLOUDSSD: indica el tipo de SSD en la nube.
    • ESSD: indica el tipo de SSD extremo.

    size

    Integer

    Indica el tamaño del volumen.

    Su rango de valores es de 40 GB a 4,000 GB. El valor debe ser un múltiplo de 10.

  • Ejemplo de respuesta 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"
    }
  • Respuesta anormal

    Para obtener más información, consulte Resultados de solicitud anormales.

Código de estado

Código de error

Para obtener más información, consulte Códigos de error.

Utilizamos cookies para mejorar nuestro sitio y tu experiencia. Al continuar navegando en nuestro sitio, tú aceptas nuestra política de cookies. Descubre más

Comentarios

Comentarios

Comentarios

0/500

Seleccionar contenido

Enviar el contenido seleccionado con los comentarios