Vincula una regla de control de recursos especificada a un usuario, base de datos, consulta o conexión en un clúster de PolarDB for MySQL. Una vez que la vinculación se realiza correctamente, el objeto objetivo queda sujeto al límite de cuota de CPU definido por la regla de control de recursos.
Descripción de la operación
El control de recursos limita los recursos de CPU que pueden utilizar usuarios, bases de datos, consultas o conexiones 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 solo aplica 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 de kernel del clúster loose_enable_resource_control debe estar configurado en ON.
Pruébelo ahora
Test
Autorización de RAM
Sintaxis de la solicitud
POST HTTP/1.1Pará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 |
| TargetType |
string |
Sí |
El tipo de destino de la vinculación. Valores válidos: USER, DATABASE, QUERY, CONNECTION. El valor no distingue entre mayúsculas y minúsculas. |
USER |
| TargetValue |
string |
Sí |
El valor del destino de la vinculación. El formato depende del valor de TargetType. Para obtener más información, consulte la tabla a continuación. |
app_user |
Reglas para TargetValue:
| TargetType | Descripción de TargetValue | Ejemplo |
| USER | El nombre de usuario de la base de datos. El nombre debe tener entre 1 y 63 bytes ASCII, comenzar con una letra y contener únicamente letras, dígitos y guiones bajos. No se admiten cuentas que contengan un host, comodines o comillas. | app_user |
| DATABASE | El nombre de la base de datos. El nombre debe tener entre 1 y 63 bytes ASCII, comenzar con una letra y contener únicamente letras, dígitos y guiones bajos. | order_db |
| QUERY | El ID de la consulta. El valor debe ser un entero decimal positivo sin signos, espacios ni ceros a la izquierda. Valores válidos: de 1 a Long.MAX_VALUE. | 12345 |
| CONNECTION | El ID de la conexión. El valor debe ser un entero decimal positivo sin signos, espacios ni ceros a la izquierda. Valores válidos: de 1 a Long.MAX_VALUE. | 67890 |
Elementos de la respuesta
|
Elemento |
Tipo |
Descripción |
Ejemplo |
|
object |
Esquema de la respuesta. |
||
| RequestId |
string |
El ID de la solicitud. |
6BD9CDE4-5E7B-4BF3-9BB8-83C73E****** |
Ejemplos
Respuesta exitosa
JSON Formato
{
"RequestId": "6BD9CDE4-5E7B-4BF3-9BB8-83C73E******"
}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.