attendre tm uip

Syntaxe et options de `uip tm wait`, qui interroge une exécution de test jusqu'à ce qu'elle atteigne un état terminal et imprime un résumé sur une ligne.

uip tm wait polls a test execution until it reaches a terminal state (Finished or Cancelled) and then prints a one-line summary. It turns the asynchronous uip tm testsets run into a blocking step in a CI pipeline.

wait is registered as a top-level verb under tm, not as a resource. Invoke it as uip tm wait, not uip tm executions wait.

Synthèse

uip tm wait --execution-id <uuid> (--project-key <key> | --project-id <id> | --test-set-key <key>)
            [--timeout <seconds>]

Respecte les options globales. Consultez la section Codes de sortie ci-dessous pour connaître le comportement spécifique au domaine en cas de délai d'expiration.

attendre tm uip

Block until the given execution reaches a terminal state, polling Test Manager every 60 seconds.

Arguments

Aucun

Options

• --execution-id <uuid> (requis) : exécution à attendre. Obtenez-le à partir de uip tm testsets run.

• --project-key <key> — owning project key.

• --project-id <id> — owning project ID. Use instead of --project-key.

  Pass --project-id, --project-key, or --test-set-key. When you pass more than one, --project-id is used first, then --project-key, then the project prefix of --test-set-key.

• --test-set-key <key> — clé de l'ensemble de tests (par exemple, DEMO:42); la clé du projet est dérivée du préfixe.

• --timeout <seconds> — maximum time to wait, in seconds. Defaults to 1800 (30 minutes). Pass 0 to wait indefinitely.

Remarque :

There is no --poll-interval flag on this command. The poll interval is fixed at 60 seconds.

Avertissement :

A manual run closed early with executions finish keeps Status: "Running", so wait never sees a terminal state on it. wait blocks until --timeout and then exits 2. Check such a run's ExecutionFinished timestamp with executions get-stats instead.

Exemple

# wait up to 15 minutes
uip tm wait \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO \
  --timeout 900

Data shape (terminal state reached before the timeout)

{
  "Code": "WaitComplete",
  "Data": {
    "ExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Status": "Finished",
    "EndTime": "2025-04-15T10:32:11Z",
    "Duration": "00:02:11"
  }
}

Status is the terminal state Test Manager reports: Finished or Cancelled. Reaching a terminal state is the success signal for wait; the verb exits 0 whether the tests inside the execution passed or failed. To branch on pass or fail, read the report get output after wait returns.

Codes de sortie

wait suit les codes de sortie standard pour 0, 1 et 3, avec une réutilisation spécifique au domaine de 2:

Code de sortie	Signification
0	L'exécution a atteint un état terminal dans le délai d'expiration.
1	Polling failed (three consecutive API errors, interrupt, abort), sign-in failed, or no project was given. See the Message field for detail.
2	Timed out. The timeout elapsed before the execution reached a terminal state.
3	Erreur de validation (valeur d’indicateur incorrecte, option requise manquante).

Exit code 2 is domain-specific. The shared CLI contract reserves 2 for AuthenticationError, but wait reuses it for timeout so that scripts can distinguish "took too long" from "polling failed" without parsing text. uip tm run uses 4 for its own timeout instead. See Exit-code behavior on executions for the full pattern.

Modèle de script

uip tm wait \
  --execution-id "$id" \
  --project-key DEMO \
  --timeout 1800
case $? in
  0) ;;
  2) echo "timed out" >&2; exit 2 ;;
  *) echo "wait failed" >&2; exit 1 ;;
esac

Associé

• exécution des ensembles de tests — produit le ExecutionId à attendre.
• rapport — résumé à lire une fois que wait renvoie 0.
• résultat — Exportation XML JUnit.
• exécutions réessayer — réexécuter les cas ayant échoué d’une exécution terminée.
• executions cancel — stop a running automated execution; poll it to Cancelled with wait.
• run — run every test in an uploaded package, wait, and write a report in one command.

Voir également

• Vue d’ensemble de Test Manager
• Codes de sortie — contrat partagé.
• Modèles de script — le pipeline Launch-Wait-Verify.