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/ Comprobación previa de recursos
Actualización más reciente 2025-03-21 GMT+08:00
Ver PDF
Compartir

Comprobación previa de recursos

Función

Esta API se utiliza para comprobar previamente los recursos. Antes de invocar a esta API:

URI

POST /v3/{project_id}/resource-check

Tabla 1 Parámetro 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.

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.

Se puede obtener invocando a la API de IAM utilizada para obtener un token de usuario.

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

Content-Type

Sí

String

Tipo de contenido.

Valor: application/json

X-Language

No

String

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

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

Parámetro

Obligatorio

Tipo

Descripción

action

Sí

String

Tipo de verificación.

  • createInstance: comprobación previa de recursos durante la creación de instancias
  • createReadonlyNode: comprobación previa de recursos durante la creación de réplicas de lectura
  • resizeFlavor: comprobación previa de recursos durante el cambio de especificación de instancia

resource

Sí

CheckResourceInfo object

Información de recursos.
Tabla 4 CheckResourceInfo

Parámetro

Obligatorio

Tipo

Descripción

enterprise_project_id

No

String

ID de proyecto de empresa. Este parámetro es obligatorio cuando action se establece en createInstance.

instance_num

No

Integer

Número de instancias. Este parámetro es obligatorio cuando action se establece en createInstance.

mode

No

String

Tipo de instancia. Su valor es de Cluster. Este parámetro es obligatorio cuando action se establece en createInstance.

availability_zone_mode

No

String

Tipo de AZ. El valor puede ser single o multi. Este parámetro es obligatorio cuando action se establece en createInstance.

node_num

No

Integer

Cantidad de nodos. Este parámetro es obligatorio cuando action se establece en createInstance o createReadonlyNode.

flavor_ref

No

String

Código de especificación. Este parámetro es obligatorio cuando action se establece en createInstance o resizeFlavor.

availability_zone

No

String

Código de zona de disponibilidad.

subnet_id

No

String

ID de subred. Este parámetro es obligatorio cuando action se establece en createInstance.

instance_id

No

String

ID de instancia. Este parámetro es obligatorio cuando action se establece en createReadonlyNode o resizeFlavor.

Parámetros de respuesta

Código de estado: 200

Tabla 5 Parámetro del cuerpo de respuesta

Parámetro

Tipo

Descripción

result

Boolean

Resultado devuelto.

  • true: El cheque ha sido aprobado.
  • false: La comprobación falla.

Código de estado: 400

Tabla 6 Parámetros del 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 7 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Ejemplo de la solicitud

  • Comprobación previa de recursos durante la creación de instancias 
    POST https://{endpoint}/v3/97b026aa9cc4417888c14c84a1ad9860/resource-check

{
  "action" : "createInstance",
  "resource" : {
    "enterprise_project_id" : 0,
    "instance_num" : 1,
    "mode" : "Cluster",
    "availability_zone_mode" : "single",
    "node_num" : 2,
    "flavor_ref" : "gaussdb.mysql.xlarge.x86.4",
    "availability_zone" : "cn-southwest-244b",
    "subnet_id" : "1e9f71dd-9192-4c0d-9739-161d8dcca68c"
  }
}
  • Comprobación previa de recursos durante la creación de réplicas de lectura 
    POST https://{endpoint}/v3/97b026aa9cc4417888c14c84a1ad9860/resource-check

{
  "action" : "createReadonlyNode",
  "resource" : {
    "instance_id" : "376e0847a2224e95afcd3e607eccd544in07",
    "node_num" : 1
  }
}
  • Comprobación previa de recursos durante el cambio de especificación de instancia 
    POST https://{endpoint}/v3/97b026aa9cc4417888c14c84a1ad9860/resource-check

{
  "action" : "resizeFlavor",
  "resource" : {
    "instance_id" : "376e0847a2224e95afcd3e607eccd544in07",
    "flavor_ref" : "gaussdb.mysql.xlarge.x86.4"
  }
}

Ejemplo de la respuesta

Código de estado: 200

Operación exitosa.

{
  "result" : true
}

Código de estado

Código de estado

Descripción

200

Operación exitosa.

400

Error de cliente.

500

Error de servidor.

Código de error

Para obtener más información, véase Códigos de error.

Tema principal: Gestión de instancias