Restauración de datos en una instancia de base de datos nueva
Función
Esta API se utiliza para restaurar datos a una nueva instancia de base de datos.
- Antes de invocar a una API, debe entender la API de Autenticación.
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
- Descripción del parámetro
Tabla 1 Descripción de parámetro Nombre
Obligatorio
Descripción
project_id
Sí
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
Sí
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
Sí
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
Sí
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
Sí
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
Sí
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
Sí
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
Sí
String
Especifica el tipo de instancia principal/en espera. El valor es Ha (insensible a mayúsculas y minúsculas).
replication_mode
Sí
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
Sí
String
Especifica el motor de base de datos. Valor:
SQLServer
version
Sí
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
Sí
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
Sí
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
Sí
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
Sí
String
Especifica el ID de instancia de base de datos.
type
Sí
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:
- El nuevo nombre de base de datos (A) es el mismo que el nombre de base de datos original (A).
- El nuevo nombre de base de datos (B1) no es único.
- 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
Sí
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
Sí
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
Sí
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
Sí
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
Sí
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
Sí
String
Indica el tipo de instancia principal/en espera . El valor es Ha.
replication_mode
Sí
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
Sí
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
Sí
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
Sí
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
{ "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
- Normal
- Anormal
Para obtener más información, consulte Códigos de estado.
Código de error
Para obtener más información, consulte Códigos de error.