UpdateAutoThrottleRulesAsync - - Centre de documentation Alibaba Cloud

Appelle l'opération UpdateAutoThrottleRulesAsync pour configurer de manière asynchrone et par lots les paramètres de limitation SQL automatique pour les instances de base de données spécifiées.

Description de l'opération

Remarque

Un appel asynchrone ne renvoie pas immédiatement les résultats complets. Appelez d'abord cette opération pour obtenir le ResultId. Ensuite, utilisez le ResultId renvoyé pour initier à nouveau l'appel jusqu'à ce que isFinish soit true, moment auquel les résultats complets sont renvoyés. Cela signifie que vous devez appeler cette opération au moins deux fois pour obtenir les données complètes.

Avant de commencer :\n- Lors de l'utilisation du SDK pour appeler DAS, spécifiez la région cn-shanghai.

Le service d'autonomie est activé pour l'instance de base de données cible. Pour plus d'informations, consultez Centre d'autonomie.
L'instance de base de données cible est l'une des suivantes :
- ApsaraDB RDS for MySQL série haute disponibilité 5.6, 5.7 ou 8.0, ou RDS Enterprise Edition.
- PolarDB for MySQL 5.6 Cluster Edition, 5.7 Cluster Edition ou 8.0 Cluster Edition.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

hdm:UpdateAutoThrottleRulesAsync

none

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
ConsoleContext	string	Non	Un paramètre réservé.	None
InstanceIds	string	Oui	Les identifiants des instances de base de données.\n\n> Le format des données est JSONArray, par exemple `['Instance ID 1','Instance ID 2']`. Séparez les identifiants d'instance par des virgules (,).	['rm-2ze8g2am97624**','rm-2ze9xrhze0709**']
CpuUsage	number	Oui	Le seuil d'utilisation du processeur. Valeurs valides : 70 % à 100 %.	70
CpuSessionRelation	string	Oui	La relation logique entre le seuil d'utilisation du processeur et le seuil de sessions actives. Valeurs valides : AND : les deux conditions doivent être remplies. OR : l'une ou l'autre des conditions doit être remplie.	OR
ActiveSessions	integer	Oui	Le seuil de sessions actives. Si la relation avec le seuil d'utilisation du CPU est OR, la valeur doit être supérieure ou égale à 16. Si la relation avec le seuil d'utilisation du CPU est AND, la valeur doit être supérieure ou égale à 2.	16
AbnormalDuration	number	Oui	Le seuil de durée de l'anomalie qui déclenche la limitation SQL automatique. La valeur doit être un entier positif supérieur ou égal à 2. Unité : minutes.	2
MaxThrottleTime	number	Oui	La durée maximale de limitation. La valeur doit être un entier positif. Unité : minutes.	10
AllowThrottleStartTime	string	Oui	L'heure de début de la fenêtre de temps de limitation (UTC).	00:00Z
AllowThrottleEndTime	string	Oui	L'heure de fin de la fenêtre de temps de limitation (UTC).	23:59Z
AutoKillSession	boolean	Oui	Indique si les instructions SQL anormales en cours d'exécution doivent être simultanément interrompues. Remarque Les instructions SQL anormales sont celles qui correspondent aux modèles SQL à limiter. Valeurs valides : true : Oui. false : Non.	true
ResultId	string	Non	L'identifiant de la requête asynchrone.\n> Un appel asynchrone ne renvoie pas immédiatement les résultats complets. Appelez d'abord cette opération pour obtenir le ResultId. Ensuite, utilisez le ResultId renvoyé pour initier à nouveau l'appel jusqu'à ce que isFinish soit true, moment auquel les résultats complets sont renvoyés. Cela signifie que vous devez appeler cette opération au moins deux fois pour obtenir les données complètes.	async__507044db6c4eadfa2dab9b084e80****

Éléments de réponse

Élément	Type	Description	Exemple
	object
Code	integer	Le code d'état renvoyé.	200
Message	string	Le message renvoyé.\n> Si la requête aboutit, Successful est renvoyé. Si la requête échoue, un message d'erreur tel qu'un code d'erreur est renvoyé.	Successful
Data	object	Les données renvoyées.
Fail	boolean	Indique si la requête a échoué. Valeurs valides : true : La requête a échoué. false : La requête n'a pas échoué.	false
ConfigResponse	object	Les données de réponse de la configuration par lots.\n> Ces données sont renvoyées uniquement lorsque la requête asynchrone est terminée (c'est-à-dire lorsque isFinish est true).
TotalInstanceCount	integer	Le nombre total d'instances de base de données.	2
ConfigSuccessInstanceCount	integer	Le nombre d'instances de base de données configurées avec succès.	1
ConfigFailInstanceCount	integer	Le nombre d'instances de base de données dont la configuration a échoué.	1
ConfigSuccessInstanceList	array<object>	La liste des instances de base de données configurées avec succès.
	object
ConfigSuccess	boolean	Indique si la configuration a réussi. Valeurs valides : true : La configuration a réussi. false : La configuration a échoué.	true
InstanceId	string	L'identifiant de l'instance de base de données.	rm-2ze8g2am97624****
ConfigFailInstanceList	array<object>	La liste des instances de base de données dont la configuration a échoué.
	object
ConfigSuccess	boolean	Indique si la configuration a réussi. Valeurs valides : true : La configuration a réussi. false : La configuration a échoué.	false
InstanceId	string	L'identifiant de l'instance de base de données.	rm-2ze9xrhze0709****
ErrorMessage	string	Le message d'erreur.	instance das autonomy service is off or can not find instance
ResultId	string	L'identifiant de la requête asynchrone.	async__665ee69612f1627c7fd9f3c85075****
IsFinish	boolean	Indique si la requête asynchrone est terminée. Valeurs valides : true : La requête est terminée. false : La requête n'est pas terminée.	true
State	string	L'état d'exécution de la requête asynchrone. Valeurs valides : RUNNING : La requête est en cours d'exécution. SUCCESS : La requête a réussi. FAIL : La requête a échoué.	SUCCESS
Complete	boolean	Indique si la requête asynchrone est terminée. Valeurs valides : true : La requête est terminée. false : La requête n'est pas terminée.	true
Timestamp	integer	L'heure d'exécution. La valeur est un horodatage UNIX. Unité : millisecondes.	1645668213000
RequestId	string	L'identifiant de la requête.	B6D17591-B48B-4D31-9CD6-9B9796B2****
Success	boolean	Indique si la requête a réussi. Valeurs valides : true : La requête a réussi. false : La requête a échoué.	true

Exemples

JSON format

{
  "Code": 200,
  "Message": "Successful",
  "Data": {
    "Fail": false,
    "ConfigResponse": {
      "TotalInstanceCount": 2,
      "ConfigSuccessInstanceCount": 1,
      "ConfigFailInstanceCount": 1,
      "ConfigSuccessInstanceList": [
        {
          "ConfigSuccess": true,
          "InstanceId": "rm-2ze8g2am97624****"
        }
      ],
      "ConfigFailInstanceList": [
        {
          "ConfigSuccess": false,
          "InstanceId": "rm-2ze9xrhze0709****",
          "ErrorMessage": "instance das autonomy service is off or can not find instance"
        }
      ]
    },
    "ResultId": "async__665ee69612f1627c7fd9f3c85075****",
    "IsFinish": true,
    "State": "SUCCESS",
    "Complete": true,
    "Timestamp": 1645668213000
  },
  "RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Success": true
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidParams	The request parameters are invalid.	Les paramètres de la requête sont invalides.
403	NoPermission	You are not authorized to do this action.	Vous ne disposez pas des autorisations nécessaires pour effectuer cette opération.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.