Test Run - Get Test Run

Dapatkan detail uji coba menurut nama.

GET https://{Endpoint}/testruns/{testRunId}?api-version=2022-06-01-preview

Parameter URI

Name In Required Type Description
Endpoint
path True
  • string
uri

URL untuk melakukan operasi API sarana data pada sumber daya.

testRunId
path True
  • string

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

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

api-version
query True
  • string

versi API

Respons

Name Type Description
200 OK

Detail uji coba yang diminta

Other Status Codes

Respons kesalahan layanan Pengujian Beban.

Headers

  • x-ms-error-code: string

Contoh

GetTestRun

Sample Request

GET https://{Endpoint}/testruns/12316678-1234-1234-1234-122451189012?api-version=2022-06-01-preview

Sample Response

{
  "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": 20,
        "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": "elon-musk@microsoft.com",
  "lastModifiedDateTime": "2021-12-05T16:43:46.072Z",
  "lastModifiedBy": "elon-musk@microsoft.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"
}

Definisi

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

TestRunStatisticsModel

Statistik uji coba.

Error

Kesalahan dari permintaan REST.

Name Type Description
code
  • string

Kode kesalahan.

details

Detail tambahan dan kesalahan dalam.

message
  • string

Pesan kesalahan.

target
  • string

Target kesalahan.

ErrorResponseBody

Definisi objek kesalahan.

Name Type Description
error

Kesalahan dari permintaan REST.

FileType

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

Name Type Description
0
  • Integer
1
  • Integer
2
  • Integer

FileUrl

Model FileUrl.

Name Type Description
expireTime
  • string

Waktu kedaluwarsa file

fileId
  • string

Pengidentifikasi unik file.

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.

Name Type Description
additionalUrls

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

configUrl

Model FileUrl.

inputArtifactsZipFileurl

Model FileUrl.

testScriptUrl

Model FileUrl.

userPropUrl

Model FileUrl.

LoadTestConfig

Konfigurasi uji beban.

Name Type Description
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.

Name Type Description
logsUrl

Model FileUrl.

resultUrl

Model FileUrl.

PassFailCriteria

Lulus kriteria gagal untuk pengujian.

Name Type Description
passFailMetrics

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

PassFailMetric

Name Type Description
action
  • string

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

actualValue
  • number

Nilai aktual metrik klien untuk eksekusi pengujian.

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-nya 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

Name Type Description
type
  • string

Jenis rahasia. misalnya. AKV_SECRET_URI/SECRET_VALUE

value
  • string

Nilai rahasia, jenis AKV_SECRET_URI atau SECRET_VALUE

TestArtifacts

Name Type Description
inputArtifacts

Artefak input untuk pengujian.

outputArtifacts

Artefak output untuk uji coba.

TestRunModel

Memuat model uji coba

Name Type Description
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

Nama tampilan 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 eksekusi pengujian.

lastModifiedDateTime
  • string

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

loadTestConfig

Konfigurasi uji beban.

passFailCriteria

Lulus kriteria gagal untuk pengujian.

portalUrl
  • string

Url portal.

resourceId
  • string

Muat ID sumber daya pengujian.

secrets

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
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

Statistik uji coba

vusers
  • integer

Jumlah pengguna virtual, yang pengujiannya telah dijalankan.

TestRunStatisticsModel

Statistik uji coba.

Name Type Description
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.