Todos los productos
Search
Centro de documentos

PolarDB:CreateResourceControl

Última actualización: Sep 01, 2026

Crea una regla de control de recursos para un clúster de PolarDB for MySQL especificado. Puede configurar MaxCpu para especificar el porcentaje máximo de cuota de CPU que la regla puede utilizar, o configurar CpuCount para especificar el número máximo de núcleos de CPU que la regla puede utilizar. Debe especificar uno y solo uno de los parámetros MaxCpu y CpuCount al crear una regla.

Descripción de la operación

El control de recursos limita los recursos de CPU que pueden ser utilizados por un usuario, base de datos, consulta o conexión específicos en un clúster de PolarDB for MySQL. Esta versión admite la creación, modificación, eliminación, vinculación y desvinculación de reglas de control de recursos. No se admite la consulta del uso de CPU del control de recursos.

Antes de comenzar

  • Esta función se aplica únicamente a clústeres de PolarDB for MySQL Cluster Edition que admiten el control de recursos. PolarDB for MySQL Standard Edition no es compatible.

  • El parámetro del kernel del clúster loose_enable_resource_control debe estar configurado en ON.

  • MaxCpu y CpuCount son dos modos de cuota de CPU mutuamente excluyentes.

  • El valor máximo de CpuCount está determinado por el parámetro del kernel resource_control_cpu_count_limit del clúster de destino.

Importante Este es un aviso.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

No se requiere autorización para esta operación. Si experimenta problemas al ejecutarla, póngase en contacto con el soporte técnico.

Sintaxis de la solicitud

POST  HTTP/1.1

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

RegionId

string

No

El ID de la región del clúster de PolarDB.

Nota

Puede llamar a la operación DescribeRegions para consultar las regiones disponibles.

cn-beijing

DBClusterId

string

Sí

El ID del clúster de PolarDB.

pc-**************

ResourceControlName

string

Sí

El nombre de la regla de control de recursos. El nombre debe tener entre 1 y 63 bytes ASCII, comenzar con una letra y contener únicamente letras, dígitos y guiones bajos.

test_rc

MaxCpu

integer

No

El porcentaje máximo de cuota de CPU que la regla de control de recursos puede utilizar. Valores válidos: de 1 a 100. Debe especificar uno y solo uno de este parámetro y CpuCount.

20

CpuCount

integer

No

El número máximo de núcleos de CPU que la regla de control de recursos puede utilizar. El valor mínimo es 1. El valor máximo está determinado por el parámetro del kernel del clúster resource_control_cpu_count_limit. Debe especificar uno y solo uno de este parámetro y MaxCpu.

4

Debe especificar uno y solo uno de los parámetros MaxCpu y CpuCount al crear una regla.

Importante Este es un aviso.

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

Esquema de la respuesta.

RequestId

string

ID de la solicitud.

C61892A4-0850-4516-9E26-44D96C1782DE

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "C61892A4-0850-4516-9E26-44D96C1782DE"
}

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

400 InvalidParameters.Malformed The specified Resource Control parameter is not valid.
400 Database.ConnectError Unable to connect to the database instance.
400 Database.ExecError The Resource Control operation could not be executed on the database instance.
403 IncorrectDBInstanceType Resource Control is not supported for the current DB cluster edition or kernel configuration.
403 AuthorizationFailure The request is not authorized to operate Resource Control.
404 InvalidDBClusterId.NotFound The DBClusterId provided does not exist in our records.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.