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 de un nombre de dominio privado
Actualización más reciente 2025-03-21 GMT+08:00
Ver PDF
Compartir

Cambio de un nombre de dominio privado

Función

Esta API se utiliza para cambiar un nombre de dominio privado. Antes de invocar a esta API:

URI

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

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, 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

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ámetro del cuerpo de la solicitud

Parámetro

Obligatorio

Tipo

Descripción

dns_name

Sí

String

Prefijo del nombre de dominio nuevo. Valor:

El nombre puede contener entre 8 y 63 caracteres. Solo se permiten letras mayúsculas, minúsculas y dígitos.

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 la tarea.

Código de estado: 400

Tabla 5 Parámetros de body 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 body de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Ejemplo de la solicitud

Cambio de un nombre de dominio privado

POST https://{endpoint}/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/af315b8e6aaa41799bd9a31f2de15abcin07/dns

{
  "dns_name" : "testmodifydnsname"
}

Ejemplo de la respuesta

Código de estado: 200

Operación exitosa.

{
  "job_id" : "d5169969-e391-482a-9755-042b2d83ed17"
}

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