az load test
Not
Den här referensen är en del av läsa in-tillägget för Azure CLI (version 2.66.0 eller senare). Tillägget installeras automatiskt första gången du kör ett az load test kommando. Läs mer om tillägg.
Den här kommandogruppen är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus
Kommandogrupp för att hantera belastningstester.
Kommandogrupp för att hantera belastningstest med skapa, uppdatera, ta bort, lista osv.
Kommandon
Name | Description | Typ | Status |
---|---|---|---|
az load test app-component |
Kommandogrupp för att hantera appkomponenter. |
Förlängning | Förhandsvisning |
az load test app-component add |
Lägg till en appkomponent i ett test. |
Förlängning | Förhandsvisning |
az load test app-component list |
Visa en lista över alla appkomponenter för ett test. |
Förlängning | Förhandsvisning |
az load test app-component remove |
Ta bort den angivna appkomponenten från ett test. |
Förlängning | Förhandsvisning |
az load test compare-to-baseline |
Jämför exempelstatistiken från de senaste testkörningarna med de som använts för baslinjetestkörningen. |
Förlängning | Förhandsvisning |
az load test convert-to-jmx |
Konvertera ett URL-typtest till JMX-test. |
Förlängning | Förhandsvisning |
az load test create |
Skapa ett nytt belastningstest. |
Förlängning | Förhandsvisning |
az load test delete |
Ta bort ett befintligt belastningstest. |
Förlängning | Förhandsvisning |
az load test download-files |
Ladda ned filer från ett befintligt belastningstest. |
Förlängning | Förhandsvisning |
az load test file |
Kommandogrupp för åtgärder på testfiler. |
Förlängning | Förhandsvisning |
az load test file delete |
Ta bort en fil från test. |
Förlängning | Förhandsvisning |
az load test file download |
Ladda ned en fil från ett test. |
Förlängning | Förhandsvisning |
az load test file list |
Visa en lista över alla filer i ett test. |
Förlängning | Förhandsvisning |
az load test file upload |
Ladda upp en fil till ett test. |
Förlängning | Förhandsvisning |
az load test list |
Visa en lista över alla tester i den angivna belastningstestresursen. |
Förlängning | Förhandsvisning |
az load test server-metric |
Kommandogrupp för att hantera servermått. |
Förlängning | Förhandsvisning |
az load test server-metric add |
Lägg till ett servermått i ett test. |
Förlängning | Förhandsvisning |
az load test server-metric list |
Visa en lista över alla servermått för ett test. |
Förlängning | Förhandsvisning |
az load test server-metric remove |
Ta bort det angivna servermåttet från testet. |
Förlängning | Förhandsvisning |
az load test set-baseline |
Ange en testkörning som baslinje för jämförelse med andra körningar i testet. |
Förlängning | Förhandsvisning |
az load test show |
Visa information om testet. |
Förlängning | Förhandsvisning |
az load test update |
Uppdatera ett befintligt belastningstest. |
Förlängning | Förhandsvisning |
az load test compare-to-baseline
Kommandogruppen "load test" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus
Jämför exempelstatistiken från de senaste testkörningarna med de som använts för baslinjetestkörningen.
az load test compare-to-baseline --load-test-resource
--test-id
[--aggregation {MAX, MEAN, MEDIAN, MIN, P75, P90, P95, P96, P98, P99, P999, P9999}]
[--resource-group]
Exempel
Jämför de senaste testkörningarna med baslinjen.
az load test compare-to-baseline --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id -o table
Jämför de senaste testkörningarna med baslinjen med specifik aggregering.
az load test compare-to-baseline --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --aggregation P95 -o table
Obligatoriska parametrar
Namn eller ARM-resurs-ID för resursen för belastningstestning.
Test-ID för belastningstestet.
Valfria parametrar
Ange aggregeringsmetoden för svarstid.
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>
.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID
.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az load test convert-to-jmx
Kommandogruppen "load test" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus
Konvertera ett URL-typtest till JMX-test.
az load test convert-to-jmx --load-test-resource
--test-id
[--resource-group]
[--yes]
Exempel
Konvertera till JMX-test.
az load test convert-to-jmx --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id
Obligatoriska parametrar
Namn eller ARM-resurs-ID för resursen för belastningstestning.
Test-ID för belastningstestet.
Valfria parametrar
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>
.
Fråga inte efter bekräftelse.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID
.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az load test create
Kommandogruppen "load test" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus
Skapa ett nytt belastningstest.
az load test create --load-test-resource
--test-id
[--autostop]
[--autostop-error-rate]
[--autostop-time-window]
[--certificate]
[--description]
[--disable-public-ip]
[--display-name]
[--engine-instances]
[--env]
[--keyvault-reference-id]
[--load-test-config-file]
[--no-wait]
[--regionwise-engines]
[--resource-group]
[--secret]
[--split-csv]
[--subnet-id]
[--test-plan]
[--test-type {JMX, URL}]
Exempel
Skapa ett test med konfigurationsfilen för belastningstest.
az load test create --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-test-id --load-test-config-file ~/resources/sample-config.yaml
Skapa ett test med argument.
az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --description "Test description" --test-plan sample-jmx.jmx --engine-instances 1 --env rps=2 count=1
Skapa ett test med konfigurationsfilen för belastningstest och åsidosätt motorinstansen och env med hjälp av argument och vänta inte på filuppladdning.
az load test create --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-test-id --load-test-config-file ~/resources/sample-config.yaml --engine-instances 1 --env rps=2 count=1 --no-wait
Skapa ett test med hemligheter och miljövariabler.
az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --description "Test description" --test-plan sample-jmx.jmx --secret secret_name1=secret_uri1 secret_name2=secret_uri2 --env rps=2 count=1
Skapa ett test med hemligheter med hjälp av användartilldelad hanterad identitet för att få åtkomst till Key Vault.
az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --secret secret_name1=secret_uri1 secret_name2=secret_uri2 --keyvault-reference-id "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg/providers/microsoft.managedidentity/userassignedidentities/sample-mi"
Skapa ett test för en privat slutpunkt i ett virtuellt nätverk med alternativet delad CSV aktiverat.
az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --subnet-id "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg/providers/Microsoft.Network/virtualNetworks/SampleVMVNET/subnets/SampleVMSubnet" --split-csv true
Skapa ett test med anpassade definierade autostoppvillkor eller aktivera/inaktivera autostop för ett test.
az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --autostop-error-rate 80.5 --autostop-time-window 120
az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --autostop disable
az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --autostop enable
Skapa ett test med en belastningskonfiguration för flera regioner med regionnamn i det format som godkänts av Azure Resource Manager (ARM). Kontrollera att de angivna regionerna stöds av Azure Load Testing. Belastningstester för flera regioner är endast begränsade till offentliga slutpunkter.
az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --engine-instances 3 --regionwise-engines eastus=1 westus2=1 germanywestcentral=1 --test-plan sample-jmx.jmx
Skapa ett avancerat URL-test med flera HTTP-begäranden med hjälp av en JSON-fil.
az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --test-plan ~/resources/sample-url-requests.json --test-type URL
Obligatoriska parametrar
Namn eller ARM-resurs-ID för resursen för belastningstestning.
Test-ID för belastningstestet.
Valfria parametrar
Om automatisk stopp ska aktiveras eller inaktiveras. Tillåtna värden är aktivera/inaktivera.
Tröskelvärde för procentandel av fel som testkörningen ska stoppas automatiskt på. Tillåtna värden ligger inom intervallet [0.0,100.0].
Tidsperiod då felprocenten ska utvärderas i sekunder.
Ett enda certifikat i formatet "key[=value]". Certifikatet ska lagras i Azure Key Vault i PFX-format och certifikatidentifieraren ska anges som värde.
Beskrivning av belastningstestet.
Inaktivera distributionen av en offentlig IP-adress, lastbalanserare och nätverkssäkerhetsgrupp när du testar en privat slutpunkt.
Visningsnamn för belastningstestet.
Antal motorinstanser som testet ska köras på.
Utrymmesavgränsade miljövariabler: key[=value] [key[=value] ...].
Den identitet som ska användas för att komma åt nyckelvalvet.
Sökväg till konfigurationsfilen för belastningstestet. Se https://learn.microsoft.com/azure/load-testing/reference-test-config-yaml.
Vänta inte tills den långvariga åtgärden har slutförts.
Ange antalet motorer för varje region i formatet: region1=engineCount1 region2=engineCount2 .... Använd regionnamn i det format som godkänts av Azure Resource Manager (ARM). Se till att regionerna stöds av Azure Load Testing. Belastningstester för flera regioner kan bara rikta in sig på offentliga slutpunkter.
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>
.
Utrymmesavgränsade hemligheter: key[=value] [key[=value] ...]. Hemligheter ska lagras i Azure Key Vault och den hemliga identifieraren ska anges som värde.
Dela CSV-filer jämnt mellan motorinstanser.
Resurs-ID för undernätet som ska användas för privat belastningstest.
Referens till testplansfilen. Om testType: JMX
: sökväg till JMeter-skriptet. Om testType: URL
: sökväg till JSON-filen för begäranden.
Typ av belastningstest.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID
.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az load test delete
Kommandogruppen "load test" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus
Ta bort ett befintligt belastningstest.
az load test delete --load-test-resource
--test-id
[--resource-group]
[--yes]
Exempel
Ta bort ett belastningstest.
az load test delete --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id
Obligatoriska parametrar
Namn eller ARM-resurs-ID för resursen för belastningstestning.
Test-ID för belastningstestet.
Valfria parametrar
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>
.
Fråga inte efter bekräftelse.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID
.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az load test download-files
Kommandogruppen "load test" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus
Ladda ned filer från ett befintligt belastningstest.
az load test download-files --load-test-resource
--path
--test-id
[--force]
[--resource-group]
Exempel
Ladda ned alla filer i ett test. Katalogen bör redan finnas.
az load test download-files --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --path ~/downloads
Ladda ned alla filer i ett test genom att skapa katalogen om den inte finns.
az load test download-files --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --path "~/downloads/new folder" --force
Obligatoriska parametrar
Namn eller ARM-resurs-ID för resursen för belastningstestning.
Sökväg till katalogen för att ladda ned filer.
Test-ID för belastningstestet.
Valfria parametrar
Framtvinga körning av kommandot. Då skapas katalogen för att ladda ned filer om den inte finns.
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>
.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID
.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az load test list
Kommandogruppen "load test" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus
Visa en lista över alla tester i den angivna belastningstestresursen.
az load test list --load-test-resource
[--resource-group]
Exempel
Visa en lista över alla belastningstester i en resurs.
az load test list --load-test-resource sample-alt-resource --resource-group sample-rg
Obligatoriska parametrar
Namn eller ARM-resurs-ID för resursen för belastningstestning.
Valfria parametrar
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>
.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID
.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az load test set-baseline
Kommandogruppen "load test" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus
Ange en testkörning som baslinje för jämförelse med andra körningar i testet.
az load test set-baseline --load-test-resource
--test-id
--test-run-id
[--resource-group]
Exempel
Ange baslinjetestkörning.
az load test set-baseline --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --test-run-id sample-associated-test-run-id
Obligatoriska parametrar
Namn eller ARM-resurs-ID för resursen för belastningstestning.
Test-ID för belastningstestet.
Testkörnings-ID för belastningstestkörningen.
Valfria parametrar
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>
.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID
.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az load test show
Kommandogruppen "load test" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus
Visa information om testet.
az load test show --load-test-resource
--test-id
[--resource-group]
Exempel
Hämta information om ett belastningstest.
az load test show --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg
Obligatoriska parametrar
Namn eller ARM-resurs-ID för resursen för belastningstestning.
Test-ID för belastningstestet.
Valfria parametrar
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>
.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID
.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az load test update
Kommandogruppen "load test" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus
Uppdatera ett befintligt belastningstest.
az load test update --load-test-resource
--test-id
[--autostop]
[--autostop-error-rate]
[--autostop-time-window]
[--certificate]
[--description]
[--disable-public-ip]
[--display-name]
[--engine-instances]
[--env]
[--keyvault-reference-id]
[--load-test-config-file]
[--no-wait]
[--regionwise-engines]
[--resource-group]
[--secret]
[--split-csv]
[--subnet-id]
[--test-plan]
Exempel
Uppdatera ett test med konfigurationsfilen för belastningstest och vänta inte på filuppladdning.
az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --load-test-config-file ~/resources/sample-config.yaml --no-wait
Uppdatera visningsnamnet och beskrivningen för ett test.
az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --description "Test description" --display-name "Sample Name"
Uppdatera ett test med konfigurationsfilen för belastningstest och åsidosätt parametrar med hjälp av argument.
az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --load-test-config-file ~/resources/sample-config.yaml --engine-instances 1 --env name=value name=value
Ta bort hemligheterna från ett test.
az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --secret secret_name1=""
Uppdatera Key Vault-referensidentiteten till systemtilldelad hanterad identitet.
az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --keyvault-reference-id null
Uppdatera autostopvillkor.
az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --autostop-error-rate 90 --autostop-time-window 180
Uppdatera inläsningskonfigurationen för flera regioner.
az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --engine-instances 5 --regionwise-engines eastus=2 westus2=1 eastasia=2
Obligatoriska parametrar
Namn eller ARM-resurs-ID för resursen för belastningstestning.
Test-ID för belastningstestet.
Valfria parametrar
Om automatisk stopp ska aktiveras eller inaktiveras. Tillåtna värden är aktivera/inaktivera.
Tröskelvärde för procentandel av fel som testkörningen ska stoppas automatiskt på. Tillåtna värden ligger inom intervallet [0.0,100.0].
Tidsperiod då felprocenten ska utvärderas i sekunder.
Ett enda certifikat i formatet "key[=value]". Certifikatet ska lagras i Azure Key Vault i PFX-format och certifikatidentifieraren ska anges som värde. Använd "" för att rensa befintligt certifikat.
Beskrivning av belastningstestet.
Inaktivera distributionen av en offentlig IP-adress, lastbalanserare och nätverkssäkerhetsgrupp när du testar en privat slutpunkt.
Visningsnamn för belastningstestet.
Antal motorinstanser som testet ska köras på.
Utrymmesavgränsade miljövariabler: key[=value] [key[=value] ...]. Använd "" för att rensa befintliga miljövariabler.
Den identitet som ska användas för att komma åt nyckelvalvet. Ange null
eller None
för att använda den systemtilldelade identiteten för belastningstestresursen.
Sökväg till konfigurationsfilen för belastningstestet. Se https://learn.microsoft.com/azure/load-testing/reference-test-config-yaml.
Vänta inte tills den långvariga åtgärden har slutförts.
Ange antalet motorer för varje region i formatet: region1=engineCount1 region2=engineCount2 .... Använd regionnamn i det format som godkänts av Azure Resource Manager (ARM). Se till att regionerna stöds av Azure Load Testing. Belastningstester för flera regioner kan bara rikta in sig på offentliga slutpunkter.
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>
.
Utrymmesavgränsade hemligheter: key[=value] [key[=value] ...]. Hemligheter ska lagras i Azure Key Vault och den hemliga identifieraren ska anges som värde. Använd "" för att rensa befintliga hemligheter.
Dela CSV-filer jämnt mellan motorinstanser.
Resurs-ID för undernätet som ska användas för privat belastningstest.
Referens till testplansfilen. Om testType: JMX
: sökväg till JMeter-skriptet. Om testType: URL
: sökväg till JSON-filen för begäranden.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID
.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.