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.
Centro de ayuda/ TaurusDB/ Referencia de la API/ Las API (recomendadas)/ Gestión de instancias/ Cambio del nombre de una instancia de base de datos
Actualización más reciente 2025-03-21 GMT+08:00
Ver PDF
Compartir

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:

URI

PUT /v3/{project_id}/instances/{instance_id}/name

Tabla 1 Parámetros de URI

Parámetro

Obligatorio

Tipo

Descripción

project_id

Sí

String

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

Para obtener este valor, vea 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

Tabla 2 Parámetros de encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

Sí

String

Token de usuario.

Para obtener este valor, invoque a la API de IAM para obtener un token de usuario.

El valor de X-Subject-Token en el encabezado de respuesta es el valor del token.

X-Language

No

String

Tipo de idioma de solicitud. El valor predeterminado es en-us.

Valores:

  • en-us
  • zh-cn
Tabla 3 Parámetros de body de solicitud

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 debe comenzar con una letra y debe contener entre 4 y 64 caracteres. Solo se permiten letras (distinguen mayúsculas de minúsculas), dígitos, guiones (-) y guiones bajos (_).

is_modify_node_name

No

String

Si se cambian los nombres de nodo de forma sincrónica. El valor puede ser true o false. El valor predeterminado es true.

Parámetros de respuesta

Código de estado: 200

Tabla 4 Parámetro del cuerpo de respuesta

Parámetro

Tipo

Descripción

job_id

String

ID de tarea para cambiar un nombre de instancia de BD.

Código de estado: 400

Tabla 5 Parámetros de cuerpo de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Código de estado: 500

Tabla 6 Parámetros de cuerpo de respuesta

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 instancia a gaussdb-name

PUT https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/ba62a0b83a1b42bfab275829d86ac0fdin07/name
{
  "name" : "gaussdb-name"
}

Ejemplo de respuesta

Código de estado: 200

Operación exitosa.

{
  "job_id" : "0f6b6a9e-bd39-4e95-9374-e4d134e5a3d1"
}

Código de estado

Para más detalles, véase Códigos de estado.

Código de error

Para más detalles, véase Códigos de error.

Tema principal: Gestión de instancias