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.
Pruébelo ahora
Test
Autorización de RAM
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.
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.