GetErrorRequestSample - - Centre de documentation Alibaba Cloud

Consulte de manière asynchrone les informations sur les requêtes SQL en échec dans les données de SQL Explorer. Vous pouvez consulter jusqu'à 20 requêtes SQL en échec dans la plage de temps spécifiée.

Description de l'opération

Remarque

GetErrorRequestSample est une opération asynchrone. Après l'envoi d'une requête, les résultats complets ne sont pas renvoyés immédiatement. Si la valeur de isFinish est false dans la réponse, patientez 1 seconde puis renvoyez la requête. Si la valeur de isFinish est true, les résultats complets sont renvoyés.

Cette opération d'API prend uniquement en charge les instances ApsaraDB RDS for MySQL et les clusters PolarDB for MySQL pour lesquels Database Autonomy Service (DAS) Enterprise Edition est activé. Pour plus d'informations, consultez Acheter DAS Enterprise Edition.
Si vous utilisez un SDK pour appeler les opérations d'API de DAS, vous devez définir l'identifiant de la région sur cn-shanghai.

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:GetErrorRequestSample

get

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
InstanceId	string	Oui	L'identifiant de l'instance.	rm-2ze8g2am97624****
NodeId	string	Non	L'identifiant du nœud. Remarque Vous devez spécifier l'identifiant du nœud si votre instance de base de données est un cluster PolarDB for MySQL.	pi-bp179lg03445l****
SqlId	string	Non	L'identifiant de la requête SQL. Vous pouvez appeler l'opération GetAsyncErrorRequestListByCode pour interroger l'identifiant de la requête SQL pour laquelle un code d'erreur MySQL est renvoyé.	2cd4432556c3dab9d825ba363637****
Start	integer	Non	Le début de la plage de temps à interroger. Définissez ce paramètre sur un horodatage UNIX représentant le nombre de millisecondes écoulées depuis le 1er janvier 1970 à 00:00:00 UTC. Remarque L'heure de début doit se situer dans la durée de stockage de la fonctionnalité SQL Explorer de l'instance de base de données, et peut précéder l'heure actuelle de 90 jours au maximum.	1642556990714
End	integer	Non	La fin de la plage de temps à interroger. Définissez ce paramètre sur un horodatage UNIX représentant le nombre de millisecondes écoulées depuis le 1er janvier 1970 à 00:00:00 UTC. Remarque L'heure de fin doit être postérieure à l'heure de début. L'intervalle ne peut pas dépasser 24 heures.	1642566830000
DbName	string	Non	Le nom de la base de données.	testdb01

Éléments de réponse

Élément	Type	Description	Exemple
	object	The response parameters.
Code	integer	Le code d'état HTTP renvoyé.	200
Message	string	Le message renvoyé. Remarque Si la requête a réussi, Successful est renvoyé. Si la requête a échoué, un message d'erreur tel qu'un code d'erreur est renvoyé.	Successful
Data	array<object>	Les données renvoyées.	[ { "sqlId": "2cd4432556c3dab9d825ba363637**", "database": "dbgateway", "originHost": "172.16.1", "tables": [ "meter_" ], "instanceId": "rm-2ze8g2am97624", "errorCode": "1062", "user": "dbgat", "sql": "insert into meter_\n ( \n \n )\n values (now(), now(), 'bbbc8624-5e19-455a-9714-8466f688**', '2022-02-10 14:00:00', '{\"endTime\":\"2022-02-10 14:00:00\",\"endTimestamp\":1644472800,\"startTime\":\"2022-02-10 13:00:00\",\"startTimestamp\":1644469200}', null, null)", "timestamp": 1644476100435 }]
	object
sqlId	string	L'identifiant de la requête SQL.	2cd4432556c3dab9d825ba363637****
database	string	Le nom de la base de données.	dbgateway
originHost	string	L'adresse IP du client qui exécute l'instruction SQL.	172.16.1****
tables	array	Les informations de la table.
	string	Le nom de la table.	meter_****
instanceId	string	L'identifiant de l'instance.	rm-2ze8g2am97624****
errorCode	string	Le code d'erreur renvoyé.	1062
user	string	Le nom d'utilisateur du compte utilisé pour se connecter à la base de données.	dbgat****
sql	string	L'instruction SQL.	insert into meter_****
timestamp	integer	L'heure à laquelle la requête SQL a été exécutée. Cette valeur est un horodatage UNIX représentant le nombre de millisecondes écoulées depuis le 1er janvier 1970 à 00:00:00 UTC.	1644476100435
RequestId	string	L'identifiant de la requête.	7172BECE-588A-5961-8126-C216E16B****
Success	boolean	Indique si la requête a réussi. Valeurs valides : true false	true

Exemples

JSON format

{
  "Code": 200,
  "Message": "Successful",
  "Data": [
    {
      "sqlId": "2cd4432556c3dab9d825ba363637****",
      "database": "dbgateway",
      "originHost": "172.16.1****",
      "tables": [
        "meter_****"
      ],
      "instanceId": "rm-2ze8g2am97624****",
      "errorCode": "1062",
      "user": "dbgat****",
      "sql": "insert into meter_****",
      "timestamp": 1644476100435
    }
  ],
  "RequestId": "7172BECE-588A-5961-8126-C216E16B****",
  "Success": true
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidParams	The request parameters are invalid.
403	NoPermission	You are not authorized to do this action.

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

Notes de version

Consultez Notes de version pour la liste complète.