Test Run - List Test Runs Search

Mendapatkan semua uji coba dengan filter yang diberikan

GET https://{Endpoint}/testruns/sortAndFilter?api-version=2022-06-01-preview
GET https://{Endpoint}/testruns/sortAndFilter?orderBy={orderBy}&continuationToken={continuationToken}&search={search}&executionFrom={executionFrom}&executionTo={executionTo}&status={status}&maxPageSize={maxPageSize}&api-version=2022-06-01-preview&testId={testId}

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
Endpoint
path True

string

uri

URL untuk melakukan operasi API sarana data pada sumber daya.

api-version
query True

string

versi API

continuationToken
query

string

Token kelanjutan untuk mendapatkan halaman respons berikutnya.

executionFrom
query

string

date-time

TanggalWaktu akhir (format harfiah ISO 8601) dari rentang filter waktu eksekusi uji-jalan.

executionTo
query

string

date-time

TanggalWaktu mulai (format harfiah ISO 8601) dari rentang filter waktu eksekusi uji-jalan.

maxPageSize
query

integer

int32

Jumlah hasil sebagai respons.

orderBy
query

string

Urutkan pada salah satu bidang - status, displayName, executedDateTime dalam format (bidang asc/desc). misalnya: displayName asc.

search
query

string

Filter pencarian berdasarkan bidang yang dapat dicari - deskripsi, executedUser.

status
query

string

Daftar status uji coba yang dipisahkan koma, nilai dapat menjadi - "DITERIMA", "NOTSTARTED","PROVISIONING","PROVISIONED","CONFIGURING", "CONFIGURED","EXECUTING","EXECUTED","DEPROVISIONING","DEPROVISIONED","DONE","CANCELLED","FAILED".

testId
query

string

Nama unik untuk uji beban, harus berupa karakter URL yang valid ^[a-z0-9_-]*$.

Regex pattern: ^[a-z0-9_-]*$

Respons

Nama Jenis Deskripsi
200 OK

TestRunModelResourceList

Uji coba yang diminta

Other Status Codes

ErrorResponseBody

Respons kesalahan layanan Pengujian Beban.

Headers

x-ms-error-code: string

Contoh

ListTestRunsSearch

Sample Request

GET https://{Endpoint}/testruns/sortAndFilter?orderBy=executedDateTime&continuationToken=continuation token&search=Performance_LoadTest_Run1&executionFrom=2021-12-05T16:43:48.805Z&executionTo=2021-12-05T16:43:48.805Z&status=DONE,EXECUTING&maxPageSize=30&api-version=2022-06-01-preview&testId=12345678-1234-1234-1234-123456789012

Sample Response

{
  "value": [
    {
      "testRunId": "12316678-1234-1234-1234-122451189012",
      "displayName": "Performance_LoadTest_Run1",
      "testId": "12345678-1234-1234-1234-123456789012",
      "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/samplerg/providers/microsoft.loadtestservice/sampleresourcetype/sampleresourcename",
      "description": "sample description",
      "status": "DONE",
      "startDateTime": "2021-12-05T16:43:48.125Z",
      "endDateTime": "2021-12-05T16:43:48.125Z",
      "loadTestConfig": {
        "engineInstances": 6,
        "splitAllCSVs": true
      },
      "testResult": "Passed",
      "passFailCriteria": {
        "passFailMetrics": {
          "fefd759d-7fe8-4f83-8b6d-aeebe0f491fe": {
            "clientmetric": "response_time_ms",
            "aggregate": "percentage",
            "condition": ">",
            "value": 10,
            "action": "continue",
            "actualValue": 10,
            "result": "passed"
          }
        }
      },
      "testArtifacts": {
        "inputArtifacts": {
          "configUrl": {
            "url": "https://dummyurl.com/configresource",
            "fileId": "92345678-1234-1111-1234-123456789012",
            "filename": "config.yaml",
            "fileType": 2,
            "expireTime": "2021-12-05T16:43:46.072Z",
            "validationStatus": ""
          },
          "testScriptUrl": {
            "url": "https://dummyurl.com/testscriptresource",
            "fileId": "92345678-1234-1111-1234-123456789011",
            "filename": "sample.jmx",
            "fileType": 0,
            "expireTime": "2021-12-05T16:43:46.072Z",
            "validationStatus": "VALIDATION_SUCCESS"
          },
          "userPropUrl": {
            "url": "https://dummyurl.com/userpropresource",
            "fileId": "92345678-1234-1111-1234-123456789013",
            "filename": "user.properties",
            "fileType": 1,
            "expireTime": "2021-12-05T16:43:46.072Z",
            "validationStatus": ""
          },
          "inputArtifactsZipFileurl": {
            "url": "https://dummyurl.com/inputartifactzipresource",
            "fileId": "92345678-1234-1111-1234-123456789012",
            "filename": "inputartifacts.zip",
            "fileType": 2,
            "expireTime": "2021-12-05T16:43:46.072Z",
            "validationStatus": ""
          },
          "additionalUrls": []
        },
        "outputArtifacts": {
          "resultUrl": {
            "url": "https://dummyurl.com/dummyresourceresult",
            "fileId": "92345678-1234-1111-1234-123456789012",
            "filename": "sample.jmx",
            "fileType": 0,
            "expireTime": "2021-12-05T16:43:46.072Z",
            "validationStatus": "VALIDATION_SUCCESS"
          },
          "logsUrl": {
            "url": "https://dummyurl.com/logresource",
            "fileId": "abb846a7-63af-4d63-bb3d-a7aa4caff55c",
            "filename": "worker.log",
            "fileType": 2,
            "expireTime": "2022-05-16T09:14:46.0411793+00:00",
            "validationStatus": ""
          }
        }
      },
      "executedDateTime": "2021-12-05T16:43:48.125Z",
      "vusers": 4,
      "testRunStatistics": {
        "Total": {
          "transaction": "Total",
          "sampleCount": 18,
          "errorCount": 19,
          "errorPct": 17,
          "meanResTime": 13,
          "medianResTime": 10,
          "maxResTime": 16,
          "minResTime": 18,
          "pct1ResTime": 27,
          "pct2ResTime": 20,
          "pct3ResTime": 3,
          "throughput": 5,
          "receivedKBytesPerSec": 13,
          "sentKBytesPerSec": 4
        }
      },
      "createdDateTime": "2021-12-05T16:43:46.072Z",
      "createdBy": "user@contoso.com",
      "lastModifiedDateTime": "2021-12-05T16:43:46.072Z",
      "lastModifiedBy": "user@contoso.com",
      "portalUrl": "https://portal.azure.com/dummyresource",
      "secrets": {
        "secret1": {
          "value": "https://samplevault.vault.azure.net/secrets/samplesecret/f113f91fd4c44a368049849c164db827",
          "type": "AKV_SECRET_URI"
        }
      },
      "environmentVariables": {
        "envvar1": "sampletext"
      },
      "duration": 18,
      "subnetId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/samplerg/providers/Microsoft.Network/virtualNetworks/samplenetworkresource/subnets/AAAAA0A0A0"
    }
  ],
  "nextLink": "next link"
}

Definisi

Nama Deskripsi
Error

Kesalahan dari permintaan REST.

ErrorResponseBody

Definisi objek kesalahan.

FileType

Representasi bilangan bulat dari jenis file (0 = JMX_FILE, 1 = USER_PROPERTIES, 2 = ADDITIONAL_ARTIFACTS)

FileUrl

Model FileUrl.

InputTestArtifacts

Artefak input untuk pengujian.

LoadTestConfig

Konfigurasi uji beban.

OutputTestArtifacts

Artefak output untuk uji coba.

PassFailCriteria

Lulus kriteria gagal untuk pengujian.

PassFailMetric
SecretMetadata
TestArtifacts
TestRunModel

Memuat model uji coba

TestRunModelResourceList

Daftar Sumber Daya

TestRunStatisticsModel

Statistik uji coba.

Error

Kesalahan dari permintaan REST.

Nama Jenis Deskripsi
code

string

Kode kesalahan.

details

Error[]

Detail tambahan dan kesalahan dalam.

message

string

Pesan kesalahan.

target

string

Target kesalahan.

ErrorResponseBody

Definisi objek kesalahan.

Nama Jenis Deskripsi
error

Error

Kesalahan dari permintaan REST.

FileType

Representasi bilangan bulat dari jenis file (0 = JMX_FILE, 1 = USER_PROPERTIES, 2 = ADDITIONAL_ARTIFACTS)

Nama Jenis Deskripsi
0

Integer

1

Integer

2

Integer

FileUrl

Model FileUrl.

Nama Jenis Deskripsi
expireTime

string

Waktu kedaluwarsa file

fileId

string

Pengidentifikasi unik file.

fileType

FileType

Representasi bilangan bulat dari jenis file (0 = JMX_FILE, 1 = USER_PROPERTIES, 2 = ADDITIONAL_ARTIFACTS)

filename

string

Nama file.

url

string

URL File.

validationStatus

string

Status validasi file

InputTestArtifacts

Artefak input untuk pengujian.

Nama Jenis Deskripsi
additionalUrls

FileUrl[]

File artefak input { name : url } map untuk uji coba.

configUrl

FileUrl

Model FileUrl.

inputArtifactsZipFileurl

FileUrl

Model FileUrl.

testScriptUrl

FileUrl

Model FileUrl.

userPropUrl

FileUrl

Model FileUrl.

LoadTestConfig

Konfigurasi uji beban.

Nama Jenis Deskripsi
engineInstances

integer

Jumlah instans mesin untuk menjalankan uji beban. Nilai yang didukung berada dalam rentang 1-45. Diperlukan untuk membuat pengujian baru.

splitAllCSVs

boolean

Apakah semua file CSV input harus dibagi secara merata di semua mesin.

OutputTestArtifacts

Artefak output untuk uji coba.

Nama Jenis Deskripsi
logsUrl

FileUrl

Model FileUrl.

resultUrl

FileUrl

Model FileUrl.

PassFailCriteria

Lulus kriteria gagal untuk pengujian.

Nama Jenis Deskripsi
passFailMetrics

<string,  PassFailMetric>

Peta metrik id dan pass fail { id : pass fail metrics }.

PassFailMetric

Nama Jenis Deskripsi
action

string

Baik 'hentikan' atau 'lanjutkan' setelah ambang terpenuhi. Defaultnya adalah 'lanjutkan'.

actualValue

number

Nilai aktual metrik klien untuk uji coba.

aggregate

string

Fungsi agregasi yang akan diterapkan pada metrik klien. Fungsi yang diizinkan - 'persentase' - untuk metrik kesalahan ,'avg', 'p50', 'p90', 'p95', 'p99', 'min', 'max' - untuk metrik response_time_ms dan latensi, 'avg' - untuk requests_per_sec, 'count' - untuk permintaan.

clientmetric

string

Metrik klien tempat kriteria harus diterapkan. Nilai yang diizinkan - 'response_time_ms' , 'latensi', 'kesalahan', 'permintaan', 'requests_per_sec'.

condition

string

Operator perbandingan. Jenis yang didukung '>'

requestName

string

Nama permintaan yang kriteria gagal Pass harus diterapkan.

result

string

Hasil uji coba. kemungkinan hasil - 'passed' , 'failed' , 'undetermined'.

value

number

Nilai untuk dibandingkan dengan metrik klien. Nilai yang diizinkan - 'error : [0.0 , 100.0] unit- % ', response_time_ms dan latensi : unit nilai bilangan bulat apa pun- ms.

SecretMetadata

Nama Jenis Deskripsi
type

string

Jenis rahasia. misalnya. AKV_SECRET_URI/SECRET_VALUE

value

string

Nilai rahasia, jenis AKV_SECRET_URI atau SECRET_VALUE

TestArtifacts

Nama Jenis Deskripsi
inputArtifacts

InputTestArtifacts

Artefak input untuk pengujian.

outputArtifacts

OutputTestArtifacts

Artefak output untuk uji coba.

TestRunModel

Memuat model uji coba

Nama Jenis Deskripsi
createdBy

string

Pengguna yang membuat uji coba.

createdDateTime

string

DateTime (format harfiah ISO 8601) yang dibuat dari eksekusi pengujian.

description

string

Deskripsi uji coba.

displayName

string

Menampilkan nama uji coba.

duration

integer

Durasi uji coba dalam milidetik.

endDateTime

string

Uji coba mengakhiri DateTime(format harfiah ISO 8601).

environmentVariables

object

Variabel lingkungan yang didefinisikan sebagai sekumpulan <nama, pasangan nilai> .

executedDateTime

string

Waktu yang dimulai uji coba

lastModifiedBy

string

Pengguna yang memperbarui uji coba.

lastModifiedDateTime

string

DateTime yang terakhir diperbarui (format harfiah ISO 8601) dari eksekusi pengujian.

loadTestConfig

LoadTestConfig

Konfigurasi uji beban.

passFailCriteria

PassFailCriteria

Lulus kriteria gagal untuk pengujian.

portalUrl

string

Url portal.

resourceId

string

Muat ID sumber daya pengujian.

secrets

<string,  SecretMetadata>

Rahasia dapat disimpan di azure Key Vault atau penyimpanan rahasia lainnya. Jika rahasia disimpan dalam Key Vault Azure, nilainya harus menjadi pengidentifikasi rahasia dan jenisnya harus AKV_SECRET_URI. Jika rahasia disimpan di tempat lain, nilai rahasia harus disediakan secara langsung dan jenisnya harus SECRET_VALUE.

startDateTime

string

Uji coba mulai DateTime(format harfiah ISO 8601).

status

string

Status uji coba.

subnetId

string

ID subnet tempat instans uji beban harus berjalan.

testArtifacts

TestArtifacts

testId

string

Id pengujian terkait.

testResult

string

Hasil pengujian untuk kriteria lulus/Gagal yang digunakan selama uji coba. kemungkinan hasil - 'Lulus' , 'Gagal' , 'Tidak Berlaku'.

testRunId

string

Nama uji coba unik sebagai pengidentifikasi.

testRunStatistics

<string,  TestRunStatisticsModel>

Statistik uji coba

vusers

integer

Jumlah pengguna virtual, yang pengujiannya telah dijalankan.

TestRunModelResourceList

Daftar Sumber Daya

Nama Jenis Deskripsi
nextLink

string

Tautan untuk daftar sumber daya berikutnya jika terjadi hasil paginated, jika berlaku

value

TestRunModel[]

Daftar Sumber Daya

TestRunStatisticsModel

Statistik uji coba.

Nama Jenis Deskripsi
errorCount

number

Jumlah kesalahan.

errorPct

number

Persentase kesalahan.

maxResTime

number

Waktu respons maksimum.

meanResTime

number

Waktu respons rata-rata.

medianResTime

number

Waktu respons median.

minResTime

number

Waktu respons minimum.

pct1ResTime

number

Waktu respons 90 persentil.

pct2ResTime

number

95 persentil waktu respons.

pct3ResTime

number

99 persentil waktu respons.

receivedKBytesPerSec

number

Menerima byte jaringan.

sampleCount

number

Jumlah sampler.

sentKBytesPerSec

number

Byte jaringan terkirim.

throughput

number

Throughput.

transaction

string

Nama transaksi.