uip tm perf-scenario load-groups

Syntaxe et options pour `uip tm perf-scenario load-groups`, qui liez les cas de test à un scénario de performances et ajuste leur profil de charge.

uip tm perf-scenario load-groups gère les groupes de charge liés à un scénario de performances. Un groupe de charge est un cas de test lié à un scénario avec un profil de charge — utilisateurs virtuels, synchronisation des montées en puissance/pics/down, seuils SLO et type de robot.

Cette page fait partie du groupe de commandes uip tm perf-scenario - consultez cette page pour les verbes du cycle de vie du scénario (create, get, list, execute, stop, list-dry-run-reports) et les concepts partagés.

Synthèse

uip tm perf-scenario load-groups add --scenario-key <key> [--project-key <key>] (--test-case-key <key> | --test-case-id <uuid>) --folder-key <uuid> --package-name <name> [--package-version <version>] [--virtual-users <n>] [--ramp-up-minutes <n>] [--peak-minutes <n>] [--ramp-down-minutes <n>] [--delay-minutes <n>] [--max-response-time-ms <ms>] [--max-error-rate <rate>] [--robot-type <type>]
uip tm perf-scenario load-groups update --load-group-id <uuid> --project-key <key> [--virtual-users <n>] [--ramp-up-minutes <n>] [--peak-minutes <n>] [--ramp-down-minutes <n>] [--delay-minutes <n>] [--max-response-time-ms <ms>] [--max-error-rate <rate>] [--multiplexing-factor <n>] [--robot-type <type>] [--enabled <bool>]
uip tm perf-scenario load-groups remove --load-group-id <uuid> --project-key <key>
uip tm perf-scenario load-groups list --project-key <key> --execution-id <uuid> [--query <expr>]

Tous les verbes respectent les options globales et les codes de sortie standard. Chaque verbe accepte --log-level <level> (par défaut Information).

Remarque :

--project-key est facultatif sur add (déduit du préfixe --scenario-key lorsqu'il est omis), mais .requiredOption() requis sur update, remove et list, car ceux-ci identifient leur cible par un UUID barré avec aucun préfixe de projet pouvant être dérivé.

uip tm perf-scenario load-groups ajouter

Liez un cas de test à un scénario en tant que nouveau groupe de charge. Définit les valeurs de test par défaut pour le profil de charge — numérotez-les plus tard avec update une fois l'exécution du test réussie.

Options

Drapeau	Description
--scenario-key <key>	Requis. Clé d’objet de scénario (par exemple, SP1:7).
--project-key <key>	Propriétaire du projet. Facultatif — dérivé du préfixe --scenario-key lorsqu'il est omis.
--test-case-key <key>	Clé d'objet de cas de test à lier (par exemple, SP1:602). Résolu à son UUID via l'API. Fournissez ceci ou --test-case-id.
--test-case-id <uuid>	UUID du cas de test à lier directement, en évitant la recherche de la clé. Fournissez ceci ou --test-case-key.
--folder-key <uuid>	Requis. La clé de dossier Orchestrator (doit être un GUID).
--package-name <name>	Requis. Nom du package Orchestrator contenant l'automatisation.
--package-version <version>	Version du package Orchestrator. La valeur par défaut sera la dernière version publiée du package lorsqu'elle est omise (résolue via une recherche Orchestrator).
--virtual-users <n>	Nombre d’utilisateurs virtuels. La valeur par défaut est 1.
--ramp-up-minutes <n>	Durée de la montée en puissance en minutes. La valeur par défaut est 0.
--peak-minutes <n>	Durée du pic en minutes. La valeur par défaut est 1.
--ramp-down-minutes <n>	Durée de la descente en minutes. La valeur par défaut est 0.
--delay-minutes <n>	Délai avant début, en minutes. La valeur par défaut est 0.
--max-response-time-ms <ms>	SLO du temps de réponse maximal en ms; le serveur nécessite au moins 100. La valeur par défaut est 100.
--max-error-rate <rate>	SLO de taux d’erreur maximum (fraction, par exemple 0.01 pour 1 %); le serveur nécessite au moins 0.0001. La valeur par défaut est 0.0001.
--robot-type <type>	Type de robot: standard, template, elasticRobotPool, cloudRobotVm, serverless. La valeur par défaut est standard.

Exemples

# bind by test case key
uip tm perf-scenario load-groups add \
  --scenario-key SP1:7 \
  --test-case-key SP1:602 \
  --folder-key 94821c49-ab85-49cb-94e1-f82c6d8973be \
  --package-name Checkout_Tests \
  --robot-type serverless

# bind by test case id directly (skips the key lookup)
uip tm perf-scenario load-groups add \
  --scenario-key SP1:7 \
  --test-case-id f0b7f77f-482b-0400-a9c4-0b49497eb136 \
  --folder-key 94821c49-ab85-49cb-94e1-f82c6d8973be \
  --package-name Checkout_Tests \
  --package-version 1.0.2

Format des données

{
  "Code": "LoadGroupAdd",
  "Data": {
    "ScenarioKey": "SP1:7",
    "TestCaseKey": "SP1:602",
    "LoadGroupId": "8e322581-0a25-0000-738b-0b49fd936ca1",
    "PackageName": "Checkout_Tests",
    "PackageVersion": "1.0.2",
    "VirtualUsers": 1,
    "Result": "Added"
  }
}

uip tm perf-scenario load-groups - Mise à jour

Mettez à jour le profil de charge d’un groupe de charge en place (utilisateurs virtuels, minutes de montée en puissance/peak/down, seuils SLO, type de robot, état activé). Seuls les indicateurs que vous transmettez changent - tout le reste est conservé. Utilisez cette option entre un test de passage et une exécution complète de performanceTesting pour numéroter dans le profil de charge réelle.

Options

Drapeau	Description
--load-group-id <uuid>	Requis. L'UUID du groupe de charge du scénario (le champ LoadGroupId de perf-scenario get, execute ou add ci-dessus — et non l'identifiant par exécution de list ci-dessous).
--project-key <key>	Requis. Propriétaire du projet.
--virtual-users <n>	Nouveau nombre d’utilisateurs virtuels.
--ramp-up-minutes <n>	Nouvelle durée de montée en puissance en minutes.
--peak-minutes <n>	Nouvelle durée de pic en minutes.
--ramp-down-minutes <n>	Nouvelle durée de descente en minutes.
--delay-minutes <n>	Nouveau délai avant le début, en minutes.
--max-response-time-ms <ms>	Nouveau SLO de temps de réponse max en ms (le serveur nécessite au moins 100).
--max-error-rate <rate>	Nouveau SLO de taux d’erreur maximum (le serveur nécessite au moins 0.0001).
--multiplexing-factor <n>	Facteur de multiplexage - la valeur recommandée est émise à la fin de l'exécution du test (list-dry-run-reports → RecommendedMultiplexingFactor).
--robot-type <type>	Nouveau type de robot: standard, template, elasticRobotPool, cloudRobotVm, serverless.
--enabled <bool>	Activez (true) ou désactivez (false) ce groupe de charge.

Exemple

uip tm perf-scenario load-groups update \
  --load-group-id 8e322581-0a25-0000-738b-0b49fd936ca1 \
  --project-key SP1 \
  --virtual-users 50 \
  --ramp-up-minutes 2 \
  --peak-minutes 10

Format des données

{
  "Code": "LoadGroupUpdate",
  "Data": {
    "LoadGroupId": "8e322581-0a25-0000-738b-0b49fd936ca1",
    "VirtualUsers": 50,
    "RampUpMinutes": 2,
    "PeakMinutes": 10,
    "RampDownMinutes": 0,
    "DelayMinutes": 0,
    "MaxResponseTimeMs": 100,
    "MaxErrorRate": 0.0001,
    "MultiplexingFactor": null,
    "Enabled": true,
    "RobotType": "standard",
    "Result": "Updated"
  }
}

Les champs que vous n'avez pas transmis sont renvoyés à leur valeur actuelle (non modifiée), et non omis - la réponse reflète le groupe de charge fusionné complet, pas seulement le delta.

uip tm perf-scenario load-groups - Supprimer

Supprimez un groupe de charge d'un scénario. Détache le cas de test et son profil de charge; le cas de test lui-même et toutes les données d'exécution passées ne sont pas modifiés.

Options

Drapeau	Description
--load-group-id <uuid>	Requis. L'UUID du groupe de charge du scénario (le champ LoadGroupId de perf-scenario get ou add ci-dessus).
--project-key <key>	Requis. Propriétaire du projet.

Exemple

uip tm perf-scenario load-groups remove \
  --load-group-id 8e322581-0a25-0000-738b-0b49fd936ca1 \
  --project-key SP1

Format des données

{
  "Code": "LoadGroupRemove",
  "Data": {
    "LoadGroupId": "8e322581-0a25-0000-738b-0b49fd936ca1",
    "Result": "Removed"
  }
}

Il s'agit d'une suppression définitive sans indicateur de confirmation — la CLI ne la synchronise pas derrière -y/--yes.

uip tm perf-scenario load-groups - liste

Répertoriez les groupes de charge d’une exécution (cas de test, SUT, utilisateurs virtuels, seuils, statut). Cela est différent de la liste des groupes de charge du scénario: utilisez perf-scenario get pour voir les groupes de charge configurés dans le scénario lui-même.

Options

Drapeau	Description
--project-key <key>	Requis. Propriétaire du projet.
--execution-id <uuid>	Requis. ID d’exécution de scénario (ExecutionId de perf-scenario execute).
--query <expr>	un filtre de style jq appliqué aux données de sortie.

Exemple

uip tm perf-scenario load-groups list \
  --project-key DEMO \
  --execution-id 80694766-5a44-0000-0985-0b49fd93832d

Format des données

{
  "Code": "PerfLoadGroupsList",
  "Data": {
    "Data": [
      {
        "Id": "082486b0-8d51-0000-b54a-0b4a1388f850",
        "Status": "Finished"
      }
    ]
  }
}

Cette réponse est une légère transmission PascalCase de la charge utile du SDK sous-jacente plutôt qu'une forme de ligne conçue à cet effet, de sorte que l'ensemble de champs exact peut être plus riche que celui indiqué ici (cas de test, SUT, utilisateurs virtuels, seuils) — inspecter une réponse réelle ou utilisez --query pour la façonner. Le champ Id est l'ID de groupe de charge par exécution que les http-errors list et automation-errors list des données d'exécution attendent comme --load-group-id.

Associé

• uip tm perf-scenario — cycle de vie du scénario et concepts partagés.
• Données d’exécution : inspectez une exécution terminée ou en cours.
• Rapports : rendent les rapports créés à des fins d’exécution ou de comparaison.
• testcases — link-automation est ce qui donne à un cas de test le automationId duquel dépendent add et perf-scenario list-dry-run-reports .
• uip ou liste de dossiers — source du --folder-key utilisé par add.

Voir également

• Vue d’ensemble de Test Manager