Cambio del nombre de una instancia de base de datos
Función
Esta API se utiliza para cambiar el nombre de una instancia de base de datos. Antes de invocar a esta API:
- Aprender cómo autorizar y autenticarla.
- Obtener los región y punto de conexión requeridos.
URI
PUT /v3/{project_id}/instances/{instance_id}/name
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
project_id |
Sí |
String |
ID de proyecto de un tenant en una región. Para obtener este valor, consulte Obtención de un ID de proyecto. |
instance_id |
Sí |
String |
ID de instancia, que es compatible con el formato UUID. |
Parámetros de solicitud
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
X-Auth-Token |
No |
String |
Token de usuario. |
X-Language |
No |
String |
Idioma. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
name |
Sí |
String |
Nombre de instancia. Las instancias del mismo tipo pueden tener los mismos nombres bajo el mismo tenant. El nombre consta de 4 a 64 caracteres y comienza con una letra. Distingue mayúsculas y minúsculas y solo puede contener letras, dígitos, guiones (-) y guiones bajos (_). |
Parámetros de respuesta
Código de estado: 200
Parámetro |
Tipo |
Descripción |
---|---|---|
job_id |
String |
ID de tarea para cambiar el nombre de una instancia. |
Código de estado: 400
Parámetro |
Tipo |
Descripción |
---|---|---|
error_code |
String |
Código de error. |
error_msg |
String |
Mensaje de error. |
Código de estado: 500
Parámetro |
Tipo |
Descripción |
---|---|---|
error_code |
String |
Código de error. |
error_msg |
String |
Mensaje de error. |
Solicitud de ejemplo
Cambio del nombre de una instancia de base de datos
PUT https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/ba62a0b83a1b42bfab275829d86ac0fdin07/name { "name" : "gaussdb-name" }
Ejemplo de respuesta
Código de estado: 200
Success.
{ "job_id" : "0f6b6a9e-bd39-4e95-9374-e4d134e5a3d1" }
Código de estado
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.