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

Comprobación previa de recursos

Función

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

Aprender cómo autorizar y autenticarla.
Obtenga la región y el punto de conexión requeridos.

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"
  }
}