Tous les produits
Search

Ce produit

    :DescribeHistoryTasks

    Centre de documentation

    :DescribeHistoryTasks

    Dernière mise à jour :Aug 06, 2026

    Consulte la liste des tâches dans le centre des tâches.

    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.

    dds:DescribeHistoryTasks

    list

    *Instance

    acs:dds:{#regionId}:{#accountId}:dbinstance/{#InstanceId}

    		 Aucune Aucune

    Paramètres de requête

    Paramètre

    Type

    Requis

    Description

    Exemple
    RegionId

    string

    Non

    L'identifiant de la région de l'événement en attente. Vous pouvez appeler l'opération DescribeRegions pour obtenir la liste des régions la plus récente.

    cn-beijing
    PageSize

    integer

    Non

    Le nombre d'entrées par page. Valeurs valides : 10 à 100. Valeur par défaut : 10.

    10
    PageNumber

    integer

    Non

    Le numéro de la page à renvoyer. La valeur doit être un entier positif. Valeur par défaut : 1.

    1
    InstanceType

    string

    Non

    Le type d'instance de l'instance. Définissez la valeur sur Instance.

    Instance
    Status

    string

    Non

    L'état de la tâche. Valeurs valides :

    • Scheduled : la tâche est en attente d'exécution.

    • Running : la tâche est en cours d'exécution.

    • Succeed : la tâche a réussi.

    • Failed : la tâche a échoué.

    • Cancelling : la tâche est en cours d'arrêt.

    • Canceled : la tâche a été arrêtée.

    • Waiting : la tâche est en attente de l'heure planifiée.

    Séparez les différents états par des virgules (,). Ce paramètre est vide par défaut, ce qui indique que les tâches de tous les états sont interrogées.

    Succeed,Running,Waiting
    InstanceId

    string

    Non

    L'identifiant de l'instance. Séparez les différents identifiants d'instance par des virgules (,). Vous pouvez spécifier jusqu'à 30 identifiants d'instance. Ce paramètre est vide par défaut, ce qui indique que les tâches de toutes les instances sont interrogées.

    dds-8vb38f0e7933xxxx
    TaskId

    string

    Non

    L'identifiant de la tâche. Séparez les différents identifiants de tâche par des virgules (,). Vous pouvez spécifier jusqu'à 30 identifiants de tâche. Ce paramètre est vide par défaut, ce qui indique que toutes les tâches sont interrogées.

    t-0mq1yyhm3ffl2bxxxx
    TaskType

    string

    Non

    Le type de tâche. Ce paramètre est vide par défaut, ce qui indique que tous les types de tâches sont interrogés. Valeurs valides :

    • CreateIns : crée une instance.

    • DeleteIns : supprime une instance.

    • ChangeVariable : modifie les paramètres d'une instance.

    • ModifyInsConfig : modifie les configurations d'une instance.

    • RestartIns : redémarre une instance.

    • HaSwitch : effectue un basculement primaire/secondaire sur une instance.

    • CloneIns : clone une instance.

    • KernelVersionUpgrade : met à jour la version mineure d'une instance.

    • ProxyVersionUpgrade : met à niveau la version de l'agent d'une instance.

    • ModifyAccount : modifie le compte d'une instance.

    • ModifyInsSpec : modifie les spécifications d'une instance ou effectue une migration de données sur l'instance.

    • CreateReadIns : crée une instance en lecture seule.

    • StartIns : démarre une instance.

    • StopIns : arrête une instance.

    • ModifyNetwork : modifie le type de réseau d'une instance.

    • LockIns : verrouille une instance.

    • UnlockIns : déverrouille une instance.

    • DiskOnlineExpansion : étend les disques d'une instance en ligne.

    • StorageOnlineExpansion : étend la capacité de stockage d'une instance en ligne.

    • AddInsNode : ajoute un nœud à une instance.

    • DeleteInsNode : supprime un nœud d'une instance.

    • ManualBackupIns : sauvegarde manuellement une instance.

    • ModifyInsStorageType : modifie le type de stockage d'une instance.

    DeleteInsNode
    FromStartTime

    string

    Oui

    L'heure de début de la tâche d'exploitation et de maintenance à exécuter. Spécifiez l'heure selon la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure doit être en UTC. Vous pouvez interroger les données des 30 derniers jours.

    2023-03-15T03:41:26Z
    ToStartTime

    string

    Oui

    L'heure de fin de la tâche d'exploitation et de maintenance à exécuter. Spécifiez l'heure selon la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure doit être en UTC. Vous pouvez interroger les données des 30 derniers jours.

    2023-03-16T07:21:31Z
    FromExecTime

    integer

    Non

    La durée d'exécution minimale de la tâche. Ce paramètre est utilisé pour filtrer les tâches dont la durée d'exécution est supérieure à la durée d'exécution minimale. Unité : secondes. La valeur par défaut est 0, ce qui indique qu'aucune limite n'est imposée pour la requête.

    0
    ToExecTime

    integer

    Non

    La durée d'exécution maximale de la tâche. Ce paramètre est utilisé pour filtrer les tâches dont la durée d'exécution est inférieure ou égale à la durée d'exécution maximale. Unité : secondes. La valeur par défaut est 0, ce qui indique qu'aucune limite n'est imposée pour la requête.

    0
    ResourceGroupId

    string

    Non

    L'identifiant du groupe de ressources.

    rg-aek2inrfrnw3xby

    Éléments de réponse

    Élément

    Type

    Description

    Exemple

    object

    PageNumber

    integer

    Le numéro de la page renvoyée.

    1
    RequestId

    string

    L'identifiant de la requête.

    3C4A2494-XXXX-XXXX-93CF-548DB3375193
    PageSize

    integer

    Le nombre maximal d'entrées renvoyées par page.

    10
    TotalCount

    integer

    Le nombre total de tâches qui remplissent ces conditions sans prendre en compte la pagination.

    5
    Items

    array<object>

    Les objets de tâche.

    object

    Status

    string

    L'état de la tâche. Valeurs valides :

    • Scheduled : la tâche est en attente d'exécution.

    • Running : la tâche est en cours d'exécution.

    • Succeed : la tâche a réussi.

    • Failed : la tâche a échoué.

    • Cancelling : la tâche est en cours d'arrêt.

    • Canceled : la tâche a été arrêtée.

    • Waiting : la tâche est en attente de l'heure planifiée.

    Succeed
    TaskId

    string

    L'identifiant de la tâche.

    t-0mq1yyhm3ffl2bxxxx
    CurrentStepName

    string

    Le nom de l'étape en cours. Si ce paramètre est vide, la tâche n'est pas démarrée.

    exec_task
    StartTime

    string

    L'heure de début de la tâche d'exploitation et de maintenance exécutée. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.

    2023-02-11T02:33Z
    EndTime

    string

    L'heure de fin de la tâche d'exploitation et de maintenance exécutée. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.

    2023-03-16T02:59Z
    TaskType

    string

    Le type de tâche.

    • CreateIns : crée une instance.

    • DeleteIns : supprime une instance.

    • ChangeVariable : modifie les paramètres d'une instance.

    • ModifyInsConfig : modifie les configurations d'une instance.

    • RestartIns : redémarre une instance.

    • HaSwitch : effectue un basculement primaire/secondaire sur une instance.

    • CloneIns : clone une instance.

    • KernelVersionUpgrade : met à jour la version mineure d'une instance.

    • ProxyVersionUpgrade : met à niveau la version de l'agent d'une instance.

    • ModifyAccount : modifie le compte d'une instance.

    • ModifyInsSpec : modifie les spécifications d'une instance ou effectue une migration de données sur l'instance.

    • CreateReadIns : crée une instance en lecture seule.

    • StartIns : démarre une instance.

    • StopIns : arrête une instance.

    • ModifyNetwork : modifie le type de réseau d'une instance.

    • LockIns : verrouille une instance.

    • UnlockIns : déverrouille une instance.

    • DiskOnlineExpansion : étend les disques d'une instance en ligne.

    • StorageOnlineExpansion : étend la capacité de stockage d'une instance en ligne.

    • AddInsNode : ajoute un nœud à une instance.

    • DeleteInsNode : supprime un nœud d'une instance.

    • ManualBackupIns : sauvegarde manuellement une instance.

    • ModifyInsStorageType : modifie le type de stockage d'une instance.

    CreateIns
    RemainTime

    integer

    Le temps d'exécution restant estimé. Unité : secondes. La valeur 0 indique que la tâche est terminée.

    1000

    Progress

    number

    La progression actuelle de la tâche. Les valeurs valides vont de 0 à 100.

    100.0
    RegionId

    string

    L'identifiant de la région de l'instance.

    cn-hangzhou
    InstanceType

    string

    Le type d'instance de l'instance. La valeur est fixée à Instance.

    Instance
    InstanceId

    string

    L'identifiant de l'instance.

    dds-t4n18194768fxxxx
    InstanceName

    string

    Le nom de l'instance.

    test-dds
    DbType

    string

    Le type de base de données. La valeur est fixée à mongodb.

    mongodb
    Product

    string

    Le produit. La valeur est fixée à dds.

    dds
    TaskDetail

    string

    Les détails de la tâche. Les détails de la tâche varient en fonction de la valeur du paramètre taskType.

    {\"callerUid\":\"test\"}
    ReasonCode

    string

    La raison pour laquelle la tâche en cours a été initiée.

    Mise à niveau de la version mineure
    ActionInfo

    string

    Un ensemble d'actions autorisées pouvant être effectuées sur la tâche. Le système fait correspondre le nom de l'étape en cours et l'état de la tâche aux actions disponibles spécifiées par ActionInfo. Si aucune action correspondante n'est trouvée, l'état actuel de la tâche ne prend en charge aucune action. Exemple :

       "steps": [
    {
      "step_name": "exec_task", // Le nom de l'étape, qui correspond à la valeur de CurrentStepName.
      "action_info": {    // Les actions prises en charge pour cette étape.
        "Waiting": [      // L'état, qui correspond à la valeur de Status.
          "modifySwitchTime" // L'action. Plusieurs actions sont prises en charge.
        ]
      }
    },
    {
      "step_name": "init_task", // Le nom de l'étape.
      "action_info": {    // Les actions prises en charge pour cette étape.
        "Running": [      // L'état.
          "cancel",       // L'action.
          "pause"
        ]
      }
    }
  ]
}

    Le système peut prendre en charge les actions suivantes :

    • retry : effectue une nouvelle tentative.

    • cancel : effectue une annulation.

    • modifySwitchTime : modifie l'heure de basculement ou de restauration.

    `{\"steps\":[{\"action_info\":{\"Waiting\":[\"modifySwitchTime\"]},\"step_name\":\"exec_task\"}]}`
    Uid

    string

    L'identifiant de l'utilisateur auquel la ressource appartient.

    141345906006****
    CallerSource

    string

    La source de la requête. Valeurs valides : System et User.

    System
    CallerUid

    string

    L'identifiant de l'utilisateur qui a effectué la requête. Si CallerSource est défini sur User, CallerUid indique l'identifiant unique (UID) de l'utilisateur.

    141345906006****

    Exemples

    JSON format

    {
  "PageNumber": 1,
  "RequestId": "3C4A2494-XXXX-XXXX-93CF-548DB3375193",
  "PageSize": 10,
  "TotalCount": 5,
  "Items": [
    {
      "Status": "Succeed",
      "TaskId": "t-0mq1yyhm3ffl2bxxxx",
      "CurrentStepName": "exec_task",
      "StartTime": "2023-02-11T02:33Z",
      "EndTime": "2023-03-16T02:59Z",
      "TaskType": "CreateIns",
      "RemainTime": 1000,
      "Progress": 100,
      "RegionId": "cn-hangzhou",
      "InstanceType": "Instance",
      "InstanceId": "dds-t4n18194768fxxxx",
      "InstanceName": "test-dds",
      "DbType": "mongodb",
      "Product": "dds",
      "TaskDetail": "{\\\"callerUid\\\":\\\"test\\\"}",
      "ReasonCode": "Minor version upgrade",
      "ActionInfo": "`{\\\"steps\\\":[{\\\"action_info\\\":{\\\"Waiting\\\":[\\\"modifySwitchTime\\\"]},\\\"step_name\\\":\\\"exec_task\\\"}]}`",
      "Uid": "141345906006****",
      "CallerSource": "System",
      "CallerUid": "141345906006****"
    }
  ]
}

    Codes d'erreur

    Code de statut HTTP

    Code d'erreur

    Message d'erreur

    Description
    400 Param.Invalid Param invalid
    400 Param.Invalid.TimeEndBeforeStart Param invalid. End time before start time

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

    Notes de version

    Consultez Notes de version pour la liste complète.