Trigger Administration - Get Trigger
Erőforrás-olvasási művelet sablonja.
GET https://{endpoint}/triggers/{triggerId}?api-version=2025-11-01-preview
URI paraméterek
| Név | Ban | Szükséges | Típus | Leírás |
|---|---|---|---|---|
|
endpoint
|
path | True |
string (uri) |
|
|
trigger
|
path | True |
string minLength: 2maxLength: 50 pattern: ^[a-z0-9_-]*$ |
A kiváltó eseményindító egyedi azonosítója. |
|
api-version
|
query | True |
string minLength: 1 |
A művelethez használandó API-verzió. |
Válaszok
| Név | Típus | Leírás |
|---|---|---|
| 200 OK | Trigger: |
A kérés sikeres volt. |
| Other Status Codes |
Váratlan hibaválasz. Fejlécek x-ms-error-code: string |
Biztonság
Oauth2
OAuth 2.0 Flow a Microsoft Entra-azonosítóval.
Típus:
oauth2
Flow:
implicit
Engedélyezési URL:
https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Hatókörök
| Név | Leírás |
|---|---|
| https://cnt-prod.loadtesting.azure.com/.default |
Példák
Get a trigger.
Mintakérés
GET https://{endpoint}/triggers/12345678-1234-1234-1234-123456789012?api-version=2025-11-01-preview
Mintaválasz
{
"testIds": [
"12345678-1234-1234-1234-123456789012"
],
"description": "sample description",
"displayName": "Sample_Trigger",
"triggerId": "12345678-1234-1234-1234-123456789012",
"state": "Active",
"kind": "ScheduleTestsTrigger",
"recurrence": {
"interval": 1,
"frequency": "Daily",
"recurrenceEnd": {
"numberOfOccurrences": 10
}
},
"startDateTime": "2024-05-01T00:00:00Z",
"createdDateTime": "2024-05-01T16:43:46.072Z",
"createdBy": "user@contoso.com",
"lastModifiedDateTime": "2024-05-01T16:43:46.072Z",
"lastModifiedBy": "user@contoso.com"
}
Meghatározások
| Név | Leírás |
|---|---|
|
Azure. |
A hibaobjektum. |
|
Azure. |
Hibaadatokat tartalmazó válasz. |
|
Azure. |
Egy objektum, amely részletesebb információkat tartalmaz a hibáról. Az Azure REST API irányelvei szerint – https://aka.ms/AzureRestApiGuidelines#handling-errors. |
|
Daily |
Ismétlődési modell, ha a gyakoriság Napi. |
| Frequency |
A kiváltó ok ismétlődésének gyakorisága. |
|
Hourly |
Ismétlődési modell, ha a gyakoriság Hourly-ra van állítva. |
|
Monthly |
Ismétlődési modell, ha a gyakoriság MonthlyByDates értékre van állítva. |
|
Monthly |
Ismétlődési modell, ha a gyakoriság HavontaNaponkénti értékre van állítva. |
|
Recurrence |
Ismétlődési végmodell. Adja meg a numberOfOccurrences értéket, ha azt szeretné, hogy az ismétlődés a megadott számú előfordulás után véget érjen, vagy adja meg a következőt: endDate , ha azt szeretné, hogy az ismétlődés egy megadott befejezési dátum után érjen véget. Ha mindkét érték meg van adva, érvényesítési hiba jelenik meg, amely azt jelzi, hogy csak egy mezőt kell megadni. Ha egyik érték sincs megadva, az ismétlődés manuálisan befejeződik. |
|
Recurrence |
A kiváltó esemény ismétlődésének tényleges állapota. |
|
Recurrence |
Az ismétlődés beállítása a cron-kifejezés alapján történik. |
|
Schedule |
ScheduleTestsTrigger modell. |
|
State |
Adja meg a kiváltó eseményindító részleteit. |
|
Trigger |
Az eseményindító aktuális állapota. |
|
Trigger |
Az eseményindító típusa. |
|
Week |
Meghatározza a hét napjait. |
|
Weekly |
Ismétlődési modell, ha a gyakoriság hetente. |
Azure.Core.Foundations.Error
A hibaobjektum.
| Név | Típus | Leírás |
|---|---|---|
| code |
string |
A kiszolgáló által definiált hibakódok egyike. |
| details |
A jelentett hibához vezető konkrét hibák részleteinek tömbje. |
|
| innererror |
Egy objektum, amely az aktuális objektumnál pontosabb információt tartalmaz a hibáról. |
|
| message |
string |
A hiba ember által olvasható ábrázolása. |
| target |
string |
A hiba célja. |
Azure.Core.Foundations.ErrorResponse
Hibaadatokat tartalmazó válasz.
| Név | Típus | Leírás |
|---|---|---|
| error |
A hibaobjektum. |
Azure.Core.Foundations.InnerError
Egy objektum, amely részletesebb információkat tartalmaz a hibáról. Az Azure REST API irányelvei szerint – https://aka.ms/AzureRestApiGuidelines#handling-errors.
| Név | Típus | Leírás |
|---|---|---|
| code |
string |
A kiszolgáló által definiált hibakódok egyike. |
| innererror |
Belső hiba. |
DailyRecurrence
Ismétlődési modell, ha a gyakoriság Napi.
| Név | Típus | Leírás |
|---|---|---|
| frequency |
string:
Daily |
A kiújulás gyakorisága. |
| interval |
integer (int32) |
Az az intervallum, amelyben az ismétlődésnek meg kell ismétlődnie. Az egyes ismétlődések közötti napok számát jelzi. |
| recurrenceEnd |
Ismétlődési végmodell. A véget megadhatja egy numberOfOccurrences megadásával (amely a megadott számú előfordulás után befejezi az ismétlődést), vagy egy endDateTime megadásával (amely a megadott dátum után befejezi az ismétlődést). Ha egyik érték sincs megadva, az ismétlődés addig folytatódik, amíg manuálisan le nem fejeződik. Ha azonban mindkét érték meg van adva, a rendszer hibát jelez. |
Frequency
A kiváltó ok ismétlődésének gyakorisága.
| Érték | Leírás |
|---|---|
| Cron |
Ismétlődés egy cron kifejezés által definiálva. |
| Hourly |
Óránkénti alapon meghatározott ismétlődés a HourlyRecurrence által meghatározottak szerint. |
| Daily |
Napi rendszerességgel definiált ismétlődés, a DailyRecurrence által meghatározottak szerint. |
| Weekly |
Heti rendszerességgel meghatározott ismétlődés, a WeeklyRecurrence által meghatározottak szerint. |
| MonthlyByDays |
Az ismétlődés havonta meghatározott napokon a MonthlyRecurrenceByWeekDays által meghatározottak szerint. |
| MonthlyByDates |
Az ismétlődés havonta meghatározott dátumokon van meghatározva, a MonthlyRecurrenceByDates által meghatározottak szerint. |
HourlyRecurrence
Ismétlődési modell, ha a gyakoriság Hourly-ra van állítva.
| Név | Típus | Leírás |
|---|---|---|
| frequency |
string:
Hourly |
A kiújulás gyakorisága. |
| interval |
integer (int32) |
Az az intervallum, amelyben az ismétlődésnek meg kell ismétlődnie. Az egyes ismétlődések közötti órák számát jelöli. |
| recurrenceEnd |
Ismétlődési végmodell. A véget megadhatja egy numberOfOccurrences megadásával (amely a megadott számú előfordulás után befejezi az ismétlődést), vagy egy endDateTime megadásával (amely a megadott dátum után befejezi az ismétlődést). Ha egyik érték sincs megadva, az ismétlődés addig folytatódik, amíg manuálisan le nem fejeződik. Ha azonban mindkét érték meg van adva, a rendszer hibát jelez. |
MonthlyRecurrenceByDates
Ismétlődési modell, ha a gyakoriság MonthlyByDates értékre van állítva.
| Név | Típus | Leírás |
|---|---|---|
| datesInMonth |
integer[] (int32) |
Az ismétlődés a hónap megadott dátumain ismétlődik. A dátumok értéke 1 és 31 és -1 között lehet. -1 a hónap utolsó napját jelöli. |
| frequency |
string:
Monthly |
A kiújulás gyakorisága. |
| interval |
integer (int32) |
Az az intervallum, amelyben az ismétlődésnek meg kell ismétlődnie. Az egyes ismétlődések közötti hónapok számát jelöli. |
| recurrenceEnd |
Ismétlődési végmodell. A véget megadhatja egy numberOfOccurrences megadásával (amely a megadott számú előfordulás után befejezi az ismétlődést), vagy egy endDateTime megadásával (amely a megadott dátum után befejezi az ismétlődést). Ha egyik érték sincs megadva, az ismétlődés addig folytatódik, amíg manuálisan le nem fejeződik. Ha azonban mindkét érték meg van adva, a rendszer hibát jelez. |
MonthlyRecurrenceByWeekDays
Ismétlődési modell, ha a gyakoriság HavontaNaponkénti értékre van állítva.
| Név | Típus | Leírás |
|---|---|---|
| frequency |
string:
Monthly |
A kiújulás gyakorisága. |
| index |
integer (int32) minimum: 1maximum: 5 |
A hónap azon hetének indexe, amelyen az ismétlődésnek meg kell ismétlődnie. Ha például az index "2", a weekDay a "hétfő", az intervallum 3 és a gyakoriság "Hónap", akkor az ismétlődés a hónap minden második hétfőjén fut, és 3 havonta ismétlődik. Az index értéke 1 és 5 között lehet. |
| interval |
integer (int32) |
Az az intervallum, amelyben az ismétlődésnek meg kell ismétlődnie. Az egyes ismétlődések közötti hónapok számát jelöli. |
| recurrenceEnd |
Ismétlődési végmodell. A véget megadhatja egy numberOfOccurrences megadásával (amely a megadott számú előfordulás után befejezi az ismétlődést), vagy egy endDateTime megadásával (amely a megadott dátum után befejezi az ismétlődést). Ha egyik érték sincs megadva, az ismétlődés addig folytatódik, amíg manuálisan le nem fejeződik. Ha azonban mindkét érték meg van adva, a rendszer hibát jelez. |
|
| weekDaysInMonth |
Week |
A hét azon napjai, amikor a kiújulásnak meg kell ismétlődnie. |
RecurrenceEnd
Ismétlődési végmodell. Adja meg a numberOfOccurrences értéket, ha azt szeretné, hogy az ismétlődés a megadott számú előfordulás után véget érjen, vagy adja meg a következőt: endDate , ha azt szeretné, hogy az ismétlődés egy megadott befejezési dátum után érjen véget. Ha mindkét érték meg van adva, érvényesítési hiba jelenik meg, amely azt jelzi, hogy csak egy mezőt kell megadni. Ha egyik érték sincs megadva, az ismétlődés manuálisan befejeződik.
| Név | Típus | Leírás |
|---|---|---|
| endDateTime |
string (date-time) |
Az a dátum, amely után az ismétlődés véget ér. (RFC 3339 literál formátum) |
| numberOfOccurrences |
integer (int32) |
Azon előfordulások száma, amelyek után az ismétlődés véget ér. |
RecurrenceStatus
A kiváltó esemény ismétlődésének tényleges állapota.
| Név | Típus | Leírás |
|---|---|---|
| nextScheduledDateTimes |
string[] (date-time) |
Az eseményindító következő három végrehajtási időpontja. (RFC 3339 literál formátum) |
| remainingOccurrences |
integer (int32) |
Az eseményindítóhoz hátralévő előfordulások száma. Null, ha az ismétlődés végének dátuma az előfordulások száma helyett a befejezési dátum. |
RecurrenceWithCron
Az ismétlődés beállítása a cron-kifejezés alapján történik.
| Név | Típus | Leírás |
|---|---|---|
| cronExpression |
string |
Az ismétlődés cron-kifejezése. |
| frequency |
string:
Cron |
A kiújulás gyakorisága. |
| recurrenceEnd |
Ismétlődési végmodell. A véget megadhatja egy numberOfOccurrences megadásával (amely a megadott számú előfordulás után befejezi az ismétlődést), vagy egy endDateTime megadásával (amely a megadott dátum után befejezi az ismétlődést). Ha egyik érték sincs megadva, az ismétlődés addig folytatódik, amíg manuálisan le nem fejeződik. Ha azonban mindkét érték meg van adva, a rendszer hibát jelez. |
ScheduleTestsTrigger
ScheduleTestsTrigger modell.
| Név | Típus | Leírás |
|---|---|---|
| createdBy |
string |
A létrehozott felhasználó. |
| createdDateTime |
string (date-time) |
A létrehozás dátumideje (RFC 3339 literális formátum). |
| description |
string maxLength: 100 |
A kiváltó esemény leírása. |
| displayName |
string minLength: 2maxLength: 50 |
Az eseményindító neve. |
| kind | string: |
Az eseményindító típusa. |
| lastModifiedBy |
string |
A legutóbb módosított felhasználó. |
| lastModifiedDateTime |
string (date-time) |
Az utolsó módosítás dátuma (RFC 3339 literális formátum). |
| recurrence | Recurrence: |
Az eseményindító ismétlődési részletei. Null, ha az ütemezés nem ismétlődő. |
| recurrenceStatus |
A kiváltó esemény ismétlődésének tényleges állapota. |
|
| startDateTime |
string (date-time) |
Az eseményindító kezdő dátuma és időpontja UTC időzónában. (RFC 3339 literál formátum) |
| state |
A ravasz aktuális állapota. |
|
| stateDetails |
A trigger aktuális állapotának részletei. |
|
| testIds |
string[] |
Az ütemezési eseményindító által aktiválandó teszt tesztazonosítója. Jelenleg csak egy teszt támogatott egy eseményindítóhoz. |
| triggerId |
string minLength: 2maxLength: 50 pattern: ^[a-z0-9_-]*$ |
A kiváltó eseményindító egyedi azonosítója. |
StateDetails
Adja meg a kiváltó eseményindító részleteit.
| Név | Típus | Leírás |
|---|---|---|
| message |
string |
A hibaüzenet, ha az eseményindító letiltott állapotban van. |
TriggerState
Az eseményindító aktuális állapota.
| Érték | Leírás |
|---|---|
| Active |
A ravasz aktív. |
| Paused |
Az eseményindító manuálisan szünetel. |
| Completed |
Az eseményindító befejeződött. |
| Disabled |
Az eseményindító hiba miatt le van tiltva. |
TriggerType
Az eseményindító típusa.
| Érték | Leírás |
|---|---|
| ScheduleTestsTrigger |
Az eseményindító egy teszt ütemezett eseményindítója. |
WeekDays
Meghatározza a hét napjait.
| Érték | Leírás |
|---|---|
| Sunday |
Vasárnapra utal. |
| Monday |
Hétfőre vonatkozik. |
| Tuesday |
Keddre vonatkozik. |
| Wednesday |
Szerdára vonatkozik. |
| Thursday |
Csütörtökre vonatkozik. |
| Friday |
Péntekre vonatkozik. |
| Saturday |
Szombatra vonatkozik. |
WeeklyRecurrence
Ismétlődési modell, ha a gyakoriság hetente.
| Név | Típus | Leírás |
|---|---|---|
| daysOfWeek |
Week |
Az ismétlődés a hét megadott napjain ismétlődik. |
| frequency |
string:
Weekly |
A kiújulás gyakorisága. |
| interval |
integer (int32) |
Az az intervallum, amelyben az ismétlődésnek meg kell ismétlődnie. Az egyes kiújulások közötti hetek számát jelzi. |
| recurrenceEnd |
Ismétlődési végmodell. A véget megadhatja egy numberOfOccurrences megadásával (amely a megadott számú előfordulás után befejezi az ismétlődést), vagy egy endDateTime megadásával (amely a megadott dátum után befejezi az ismétlődést). Ha egyik érték sincs megadva, az ismétlődés addig folytatódik, amíg manuálisan le nem fejeződik. Ha azonban mindkét érték meg van adva, a rendszer hibát jelez. |