DescribeInvocationResults - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Une commande peut échouer ou renvoyer des résultats inattendus après son exécution. Appelez cette opération pour interroger les résultats d'exécution réels.
Vous pouvez interroger les informations relatives aux tâches de commande des quatre dernières semaines. Jusqu'à 100 000 entrées d'informations de tâche peuvent être conservées.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeInvocationResults	L'opération à effectuer. Définissez la valeur sur DescribeInvocationResults.
RegionId	String	Yes	cn-hangzhou	L'ID de région de la commande. Appelez l'opération DescribeRegions pour interroger la liste des régions les plus récentes.
ResourceGroupId	String	No	rg-bp67acfmxazb4p****	L'ID du groupe de ressources. Si vous définissez ce paramètre, l'opération interroge les résultats d'exécution de la commande dans le groupe de ressources spécifié.
InvokeId	String	No	t-hz0jdfwd9f****	L'ID de la tâche de commande. Appelez l'opération DescribeInvocations pour interroger les ID de toutes les tâches de commande.
InstanceId	String	No	i-bp1i7gg30r52z2em****	L'ID de l'instance.
CommandId	String	No	c-hz0jdfwcsr****	L'ID de la commande.
InvokeRecordStatus	String	No	Running	L'état d'exécution de la tâche de commande. Valeurs valides : Running Tâche planifiée : L'état d'exécution global reste Running jusqu'à l'arrêt manuel de la tâche planifiée. Tâche ponctuelle : L'état d'exécution global est Running si la commande est en cours d'exécution sur les instances. Finished : Tâche planifiée : L'état d'exécution global ne peut pas être Finished. Tâche ponctuelle : L'exécution est terminée sur toutes les instances, ou elle est arrêtée manuellement sur certaines instances et terminée sur d'autres. Success : Tâche ponctuelle : L'exécution est terminée et le code de sortie est 0. Tâche planifiée : La dernière exécution a réussi, le code de sortie est 0 et le cycle spécifié est terminé. Failed : Tâche planifiée : L'état d'exécution global ne peut pas être Failed. Tâche ponctuelle : L'exécution a échoué sur toutes les instances. PartialFailed : Tâche planifiée : L'état d'exécution global ne peut pas être PartialFailed. Tâche ponctuelle : L'exécution a échoué sur certaines instances. Stopped : La tâche est arrêtée. Stopping : La tâche est en cours d'arrêt.
IncludeHistory	Boolean	No	false	Indique s'il faut renvoyer les résultats des exécutions planifiées historiques. Valeurs valides : true : renvoie les résultats des exécutions planifiées historiques. Si vous définissez ce paramètre sur true, vous devez définir InvokeId sur l'ID d'une tâche exécutée selon une planification (RepeatMode défini sur Period) ou à chaque démarrage du système (RepeatMode défini sur EveryReboot). false : ne renvoie pas les résultats des exécutions planifiées historiques. Valeur par défaut : false.
ContentEncoding	String	No	PlainText	Le mode d'encodage des valeurs `CommandContent` et `Output` dans la réponse. Valeurs valides : PlainText : renvoie le contenu original de la commande et les sorties de commande. Base64 : renvoie le contenu de la commande et les sorties de commande encodés en Base64. Valeur par défaut : Base64.
PageNumber	Long	No	1	Le numéro de page. La numérotation des pages commence à 1. Valeur par défaut : 1.
PageSize	Long	No	1	Le nombre d'entrées par page. Valeurs valides : 1 à 50. Valeur par défaut : 10.
Tag.N.Key	String	No	TestKey	La clé du tag N de la tâche de commande. Valeurs valides de N : 1 à 20. La clé de tag ne peut pas être une chaîne vide. Si un seul tag est spécifié pour interroger les ressources, la réponse affiche jusqu'à 1 000 ressources associées à ce tag. Si plusieurs tags sont spécifiés, la réponse affiche jusqu'à 1 000 ressources associées à tous ces tags. Pour interroger plus de 1 000 ressources associées à des tags spécifiques, appelez l'opération ListTagResources. La clé de tag peut comporter jusqu'à 128 caractères et ne peut pas contenir `http://` ou `https://`. Elle ne peut pas commencer par `acs:` ou `aliyun`.
Tag.N.Value	String	No	TestValue	La valeur du tag N de la tâche de commande. Valeurs valides de N : 1 à 20. La valeur de tag peut être une chaîne vide. La valeur de tag peut comporter jusqu'à 128 caractères et ne peut pas contenir `http://` ou `https://`.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE*****	L'ID de la requête.
Invocation	Object		Détails sur les résultats d'exécution.
PageSize	Long	1	Le nombre d'entrées par page.
PageNumber	Long	1	Le numéro de page.
TotalCount	Long	1	Le nombre total de commandes.
InvocationResults	Array of InvocationResult		Les résultats d'exécution.
InvocationResult
InvocationStatus	String	Success	L'état d'exécution sur une instance unique. Valeurs valides : Pending : La commande était en cours de vérification ou d'envoi. Invalid : Le type de commande ou le paramètre spécifié n'était pas valide. Aborted : L'envoi de la commande a échoué. Pour envoyer une commande à une instance, assurez-vous que l'instance est dans l'état Running et que la commande peut être envoyée dans un délai d'une minute. Running : La commande était en cours d'exécution sur les instances. Success : Tâche ponctuelle : L'exécution était terminée et le code de sortie était 0. Tâche planifiée : La dernière exécution a réussi, le code de sortie était 0 et le cycle spécifié s'est terminé. Failed : Tâche ponctuelle : L'exécution était terminée, mais le code de sortie n'était pas 0. Tâche planifiée : La dernière exécution a réussi, le code de sortie n'était pas 0 et le cycle spécifié était sur le point de se terminer. Error : L'exécution ne peut pas se poursuivre en raison d'une exception. Timeout : L'exécution a expiré. Cancelled : L'exécution a été annulée et la commande n'a pas été exécutée. Stopping : La tâche de commande dans l'état Running était en cours d'arrêt. Terminated : L'exécution a été interrompue pendant l'exécution de la commande. Scheduled : Tâche ponctuelle : L'état d'exécution ne peut jamais être Scheduled. Tâche planifiée : La commande est en attente d'exécution.
Repeats	Integer	0	Le nombre de fois où la commande a été exécutée sur l'instance. Si la commande est configurée pour s'exécuter une seule fois, la valeur est 0 ou 1. Si la commande est configurée pour s'exécuter selon une planification, la valeur correspond au nombre d'exécutions de la commande.
CommandId	String	c-hz0jdfwcsr****	L'ID de la commande.
InstanceId	String	i-bp1i7gg30r52z2em****	L'ID de l'instance.
Output	String	MTU6MzA6MDEK	La sortie de la commande. Si ContentEncoding est défini sur PlainText dans la requête, la sortie originale de la commande est renvoyée. Si ContentEncoding est défini sur Base64 dans la requête, la sortie de la commande encodée en Base64 est renvoyée.
Dropped	Integer	0	La taille du texte Output tronqué et ignoré lorsque la valeur `Output` dépasse 24 Ko.
StopTime	String	2020-01-19T09:15:47Z	L'heure à laquelle la tâche de commande a été arrêtée. Si vous appelez l'opération `StopInvocation` pour arrêter la tâche de commande, la valeur de ce paramètre correspond à l'heure d'appel de l'opération.
ExitCode	Long	0	Le code de sortie de la tâche de commande. Pour les instances Linux, le code de sortie est celui du processus shell. Pour les instances Windows, le code de sortie est celui du processus batch ou PowerShell.
StartTime	String	2019-12-20T06:15:55Z	L'heure à laquelle la commande a commencé à s'exécuter sur l'instance.
ErrorInfo	String	the specified instance does not exists	La raison de l'échec de l'envoi ou de l'exécution de la commande. Valeurs valides : Si ce paramètre est laissé vide, la commande s'exécute normalement. the specified instance does not exist the instance has released when create task the instance is not running when create task the command is not applicable the specified account does not exist the specified directory does not exist the cron job expression is invalid the aliyun service is not running on the instance the aliyun service in the instance does not response the aliyun service in the instance is upgrading now the aliyun service in the instance need upgrade the command delivery has been timeout the command execution has been timeout the command execution got an exception the command execution has been interrupted the command execution exit code is not zero the specified instance has been released
ErrorCode	String	InstanceNotExists	Le code d'erreur renvoyé en cas d'échec de l'envoi ou de l'exécution de la commande. Valeurs valides : Si ce paramètre est laissé vide, la commande s'exécute normalement. InstanceNotExists : L'instance n'existait pas ou avait été libérée. InstanceReleased : L'instance a été libérée pendant l'exécution de la commande. InstanceNotRunning : L'instance n'était pas en cours d'exécution pendant l'exécution de la commande. CommandNotApplicable : La commande n'était pas applicable à l'instance spécifiée. AccountNotExists : Le compte spécifié n'existait pas. DirectoryNotExists : Le répertoire spécifié n'existait pas. BadCronExpression : L'expression cron utilisée pour spécifier une planification n'était pas valide. ClientNotRunning : Cloud Assistant Agent n'était pas en cours d'exécution. ClientNotResponse : Cloud Assistant Agent n'a pas répondu. ClientIsUpgrading : Cloud Assistant Agent était en cours de mise à niveau. ClientNeedUpgrade : Cloud Assistant Agent doit être mis à niveau. DeliveryTimeout : La demande d'envoi de la commande a expiré. ExecutionTimeout : L'exécution a expiré. ExecutionException : Une exception s'est produite pendant l'exécution de la commande. ExecutionInterrupted : La tâche de commande a été interrompue. ExitCodeNonzero : La tâche de commande est terminée, mais le code de sortie n'est pas 0.
FinishedTime	String	2019-12-20T06:15:56Z	L'heure de fin de la tâche de commande. En cas d'expiration de la tâche, l'heure de fin correspond à l'heure de début spécifiée par `StartTime` plus la période d'expiration spécifiée par `Timeout`.
InvokeId	String	t-hz0jdfwd9f****	L'ID de la tâche de commande.
InvokeRecordStatus	String	Running	L'état d'exécution de la tâche de commande. Valeurs valides : Running : Tâche planifiée : L'état d'exécution global reste Running jusqu'à l'arrêt manuel de la tâche planifiée. Tâche ponctuelle : L'état d'exécution global est Running si la commande est en cours d'exécution sur les instances. Finished : Tâche planifiée : L'état d'exécution global ne peut pas être Finished. Tâche ponctuelle : L'exécution est terminée sur toutes les instances, ou elle est arrêtée manuellement sur certaines instances et terminée sur d'autres. Failed : Tâche planifiée : L'état d'exécution global ne peut pas être Failed. Exécution ponctuelle : L'exécution a échoué sur toutes les instances. PartialFailed : Tâche planifiée : L'état d'exécution global ne peut pas être PartialFailed. Tâche ponctuelle : L'exécution a échoué sur certaines instances. Stopped : La tâche a été arrêtée. Stopping : La tâche était en cours d'arrêt.
Username	String	test	Le nom d'utilisateur utilisé pour exécuter la commande sur l'instance.
ContainerId	String	ab141ddfbacfe02d9dbc25966ed971536124527097398d419a6746873fea****	L'ID du conteneur.
ContainerName	String	test-container	Le nom du conteneur.
Tags	Array of Tag		Les tags de la tâche de commande.
Tag
TagKey	String	owner	La clé de tag de la tâche de commande.
TagValue	String	zhangsan	La valeur de tag de la tâche de commande.

Exemples

Exemples de requêtes

http(s)://ecs.aliyuncs.com/?Action=DescribeInvocationResults
&RegionId=cn-hangzhou
&InstanceId=i-bp1i7gg30r52z2em****
&PageNumber=1
&PageSize=1
&<Common request parameters>

Exemples de réponses réussies

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeInvocationResultsResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE*****</RequestId>
    <Invocation>
        <InvocationResults>
            <InvocationResult>
                <Dropped>0</Dropped>
                <InvocationStatus>Success</InvocationStatus>
                <InstanceId>i-bp1i7gg30r52z2em****</InstanceId>
                <ExitCode>0</ExitCode>
                <ErrorInfo>the specified instance does not exists</ErrorInfo>
                <StartTime>2019-12-20T06:15:55Z</StartTime>
                <Repeats>0</Repeats>
                <InvokeRecordStatus>Running</InvokeRecordStatus>
                <FinishedTime>2019-12-20T06:15:56Z</FinishedTime>
                <Output>MTU6MzA6MDEK</Output>
                <CommandId>c-hz0jdfwcsr****</CommandId>
                <ErrorCode>InstanceNotExists</ErrorCode>
                <InvokeId>t-hz0jdfwd9f****</InvokeId>
                <StopTime>2020-01-19T09:15:47Z</StopTime>
                <Username>test</Username>
                <ContainerId>ab141ddfbacfe02d9dbc25966ed971536124527097398d419a6746873fea****</ContainerId>
                <ContainerName>test-container</ContainerName>
                <Tags>
                    <TagKey>owner</TagKey>
                    <TagValue>zhangsan</TagValue>
                </Tags>
            </InvocationResult>
        </InvocationResults>
        <TotalCount>1</TotalCount>
        <PageSize>1</PageSize>
        <PageNumber>1</PageNumber>
    </Invocation>
</DescribeInvocationResultsResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE*****",
  "Invocation" : {
    "InvocationResults" : {
      "InvocationResult" : [ {
        "Dropped" : 0,
        "InvocationStatus" : "Success",
        "InstanceId" : "i-bp1i7gg30r52z2em****",
        "ExitCode" : 0,
        "ErrorInfo" : "the specified instance does not exists",
        "StartTime" : "2019-12-20T06:15:55Z",
        "Repeats" : 0,
        "InvokeRecordStatus" : "Running",
        "FinishedTime" : "2019-12-20T06:15:56Z",
        "Output" : "MTU6MzA6MDEK",
        "CommandId" : "c-hz0jdfwcsr****",
        "ErrorCode" : "InstanceNotExists",
        "InvokeId" : "t-hz0jdfwd9f****",
        "StopTime" : "2020-01-19T09:15:47Z",
        "Username" : "test",
        "ContainerId" : "ab141ddfbacfe02d9dbc25966ed971536124527097398d419a6746873fea****",
        "ContainerName" : "test-container",
        "Tags" : [ {
          "TagKey" : "owner",
          "TagValue" : "zhangsan"
        } ]
      } ]
    },
    "TotalCount" : 1,
    "PageSize" : 1,
    "PageNumber" : 1
  }
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	RegionId.ApiNotSupported	The api is not supported in this region.	Cette opération ne peut pas être effectuée dans la région spécifiée. Vérifiez si la valeur du paramètre RegionId est valide.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	La clé de tag existe déjà. Les clés de tag doivent être uniques.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Valeur Tag.N.Key non valide.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Valeur Tag.N.Value non valide.
400	MissingParameter.TagKey	You must specify Tag.N.Key.	Tag.N.Key est requis.
400	InvalidParam.PageNumber	The specified parameter is invalid.	Valeur PageNumber non valide.
400	InvalidParam.PageSize	The specified parameter is invalid.	Valeur PageSize non valide.
403	Operation.Forbidden	The operation is not permitted.	L'opération n'est pas prise en charge.
500	InternalError.Dispatch	An error occurred when you dispatched the request.	Une erreur s'est produite lors de l'envoi de la requête. Réessayez ultérieurement.
500	ServiceUnavailable	The request has failed due to a temporary failure of the server.	La requête a échoué en raison d'une défaillance temporaire du serveur backend.
500	InternalError	The request processing has failed due to some unknown error.	Une erreur interne s'est produite. Réessayez ultérieurement.

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.