Aracılığıyla paylaş


Trigger Administration - Get Trigger

Kaynak okuma işlemi şablonu.

GET https://{endpoint}/triggers/{triggerId}?api-version=2025-11-01-preview

URI Parametreleri

Name İçinde Gerekli Tür Description
endpoint
path True

string (uri)

triggerId
path True

string

minLength: 2
maxLength: 50
pattern: ^[a-z0-9_-]*$

Tetikleyicinin benzersiz tanımlayıcısı.

api-version
query True

string

minLength: 1

Bu işlem için kullanılacak API sürümü.

Yanıtlar

Name Tür Description
200 OK Trigger:

ScheduleTestsTrigger

İstek başarılı oldu.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Beklenmeyen bir hata yanıtı.

Üst Bilgiler

x-ms-error-code: string

Güvenlik

Oauth2

Microsoft Entra Id ile OAuth 2.0 Flow.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Kapsamlar

Name Description
https://cnt-prod.loadtesting.azure.com/.default

Örnekler

Get a trigger.

Örnek isteği

GET https://{endpoint}/triggers/12345678-1234-1234-1234-123456789012?api-version=2025-11-01-preview

Örnek yanıt

{
  "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"
}

Tanımlar

Name Description
Azure.Core.Foundations.Error

Hata nesnesi.

Azure.Core.Foundations.ErrorResponse

Hata ayrıntılarını içeren bir yanıt.

Azure.Core.Foundations.InnerError

Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Azure REST API yönergelerine göre - https://aka.ms/AzureRestApiGuidelines#handling-errors.

DailyRecurrence

Frekans Günlük olarak ayarlandığında tekrarlama modeli.

Frequency

Bir tetikleyici için tekrarlama sıklığı.

HourlyRecurrence

Frekans Saatlik olarak ayarlandığında yinelenme modeli.

MonthlyRecurrenceByDates

Sıklık MonthlyByDates olarak ayarlandığında yinelenme modeli.

MonthlyRecurrenceByWeekDays

Sıklık MonthlyByDays olarak ayarlandığında yinelenme modeli.

RecurrenceEnd

Tekrarlama bitiş modeli. Yinelemenin belirtilen sayıda oluşumdan sonra sona ermesini istiyorsanız numberOfOccurrences değerini sağlayın veya yinelemenin belirtilen bir bitiş tarihinden sonra sona ermesini istiyorsanız endDate değerini sağlayın. Her iki değer de sağlanırsa, yalnızca bir alanın sağlanması gerektiğini belirten bir doğrulama hatası atılır. Her iki değer de sağlanmazsa, el ile sonlandırıldığında yineleme sona erer.

RecurrenceStatus

Tetikleyici için yinelemenin gerçek durumu.

RecurrenceWithCron

Tekrarlama, cron ifadesine göre ayarlanır.

ScheduleTestsTrigger

ScheduleTestsTrigger modeli.

StateDetails

Tetikleyicinin durum ayrıntıları.

TriggerState

Bir tetikleyicinin geçerli durumu.

TriggerType

Tetikleyici türü.

WeekDays

Haftanın günlerini tanımlar.

WeeklyRecurrence

Frekans haftalık olarak ayarlandığında tekrarlama modeli.

Azure.Core.Foundations.Error

Hata nesnesi.

Name Tür Description
code

string

Sunucu tanımlı hata kodları kümesinden biri.

details

Azure.Core.Foundations.Error[]

Bu bildirilen hataya yol açan belirli hatalar hakkında bir dizi ayrıntı.

innererror

Azure.Core.Foundations.InnerError

Hatayla ilgili geçerli nesneden daha belirli bilgiler içeren bir nesne.

message

string

Hatanın insan tarafından okunabilir bir gösterimi.

target

string

Hatanın hedefi.

Azure.Core.Foundations.ErrorResponse

Hata ayrıntılarını içeren bir yanıt.

Name Tür Description
error

Azure.Core.Foundations.Error

Hata nesnesi.

Azure.Core.Foundations.InnerError

Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Azure REST API yönergelerine göre - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name Tür Description
code

string

Sunucu tanımlı hata kodları kümesinden biri.

innererror

Azure.Core.Foundations.InnerError

İç hata.

DailyRecurrence

Frekans Günlük olarak ayarlandığında tekrarlama modeli.

Name Tür Description
frequency string:

Daily

Tekrarlama sıklığı.

interval

integer (int32)

Tekrarlamanın tekrarlanması gereken aralık. Her nüks arasındaki gün sayısını belirtir.

recurrenceEnd

RecurrenceEnd

Tekrarlama bitiş modeli. Bir numberOfOccurrences (belirtilen oluşum sayısından sonra yinelemeyi sonlandırır) veya bir endDateTime (belirtilen tarihten sonra yinelemeyi sonlandırır) sağlayarak bitişi belirtebilirsiniz. Her iki değer de sağlanmazsa, yineleme el ile sonlandırılana kadar devam eder. Ancak, her iki değer de sağlanırsa, bir hata atılır.

Frequency

Bir tetikleyici için tekrarlama sıklığı.

Değer Description
Cron

Bir cron ifadesi ile tanımlanan yineleme.

Hourly

HourlyCurrence tarafından belirtildiği gibi saatlik olarak tanımlanan yinelenme.

Daily

DailyReverrence tarafından belirtildiği gibi günlük olarak tanımlanan yineleme.

Weekly

Yinelenme, WeeklyReprence tarafından belirtildiği gibi haftalık olarak tanımlanır.

MonthlyByDays

Yinelenme, MonthlyRecurrenceByWeekDays tarafından belirtildiği gibi belirli günlerde aylık olarak tanımlanır.

MonthlyByDates

Yinelenme, MonthlyRecurrenceByDates tarafından belirtildiği gibi belirli tarihlerde aylık olarak tanımlanır.

HourlyRecurrence

Frekans Saatlik olarak ayarlandığında yinelenme modeli.

Name Tür Description
frequency string:

Hourly

Tekrarlama sıklığı.

interval

integer (int32)

Tekrarlamanın tekrarlanması gereken aralık. Her tekrarlama arasındaki saat sayısını belirtir.

recurrenceEnd

RecurrenceEnd

Tekrarlama bitiş modeli. Bir numberOfOccurrences (belirtilen oluşum sayısından sonra yinelemeyi sonlandırır) veya bir endDateTime (belirtilen tarihten sonra yinelemeyi sonlandırır) sağlayarak bitişi belirtebilirsiniz. Her iki değer de sağlanmazsa, yineleme el ile sonlandırılana kadar devam eder. Ancak, her iki değer de sağlanırsa, bir hata atılır.

MonthlyRecurrenceByDates

Sıklık MonthlyByDates olarak ayarlandığında yinelenme modeli.

Name Tür Description
datesInMonth

integer[] (int32)

Yinelenme, ayın belirtilen tarihlerinde tekrarlanacak şekilde ayarlanmıştır. Tarihlerin değeri 1 ile 31 arasında ve -1 olabilir. -1 ayın son gününü temsil eder.

frequency string:

MonthlyByDates

Tekrarlama sıklığı.

interval

integer (int32)

Tekrarlamanın tekrarlanması gereken aralık. Her nüks arasındaki ay sayısını belirtir.

recurrenceEnd

RecurrenceEnd

Tekrarlama bitiş modeli. Bir numberOfOccurrences (belirtilen oluşum sayısından sonra yinelemeyi sonlandırır) veya bir endDateTime (belirtilen tarihten sonra yinelemeyi sonlandırır) sağlayarak bitişi belirtebilirsiniz. Her iki değer de sağlanmazsa, yineleme el ile sonlandırılana kadar devam eder. Ancak, her iki değer de sağlanırsa, bir hata atılır.

MonthlyRecurrenceByWeekDays

Sıklık MonthlyByDays olarak ayarlandığında yinelenme modeli.

Name Tür Description
frequency string:

MonthlyByDays

Tekrarlama sıklığı.

index

integer (int32)

minimum: 1
maximum: 5

Tekrarlamanın tekrarlanması gereken bir ay içindeki haftanın indeksi. Örneğin, dizin '2', hafta içi 'Pazartesi', aralık 3 ve sıklık 'Ay' ise, yineleme her ayın ikinci Pazartesi günü çalışır ve her 3 ayda bir tekrarlanır. Endeks değeri 1 ile 5 arasında olabilir.

interval

integer (int32)

Tekrarlamanın tekrarlanması gereken aralık. Her nüks arasındaki ay sayısını belirtir.

recurrenceEnd

RecurrenceEnd

Tekrarlama bitiş modeli. Bir numberOfOccurrences (belirtilen oluşum sayısından sonra yinelemeyi sonlandırır) veya bir endDateTime (belirtilen tarihten sonra yinelemeyi sonlandırır) sağlayarak bitişi belirtebilirsiniz. Her iki değer de sağlanmazsa, yineleme el ile sonlandırılana kadar devam eder. Ancak, her iki değer de sağlanırsa, bir hata atılır.

weekDaysInMonth

WeekDays[]

Tekrarlamanın tekrarlanması gereken haftanın belirli günleri.

RecurrenceEnd

Tekrarlama bitiş modeli. Yinelemenin belirtilen sayıda oluşumdan sonra sona ermesini istiyorsanız numberOfOccurrences değerini sağlayın veya yinelemenin belirtilen bir bitiş tarihinden sonra sona ermesini istiyorsanız endDate değerini sağlayın. Her iki değer de sağlanırsa, yalnızca bir alanın sağlanması gerektiğini belirten bir doğrulama hatası atılır. Her iki değer de sağlanmazsa, el ile sonlandırıldığında yineleme sona erer.

Name Tür Description
endDateTime

string (date-time)

Yinelemenin sona ereceği tarih. (RFC 3339 değişmez biçimi)

numberOfOccurrences

integer (int32)

Tekrarlamanın sona ereceği olay sayısı.

RecurrenceStatus

Tetikleyici için yinelemenin gerçek durumu.

Name Tür Description
nextScheduledDateTimes

string[] (date-time)

Tetikleyicinin sonraki üç yürütme süresi. (RFC 3339 değişmez biçimi)

remainingOccurrences

integer (int32)

Tetikleyici için kalan oluşum sayısı. Yinelenme sonunun oluşum sayısı yerine bitiş tarihi varsa null.

RecurrenceWithCron

Tekrarlama, cron ifadesine göre ayarlanır.

Name Tür Description
cronExpression

string

Tekrarlama için Cron ifadesi.

frequency string:

Cron

Tekrarlama sıklığı.

recurrenceEnd

RecurrenceEnd

Tekrarlama bitiş modeli. Bir numberOfOccurrences (belirtilen oluşum sayısından sonra yinelemeyi sonlandırır) veya bir endDateTime (belirtilen tarihten sonra yinelemeyi sonlandırır) sağlayarak bitişi belirtebilirsiniz. Her iki değer de sağlanmazsa, yineleme el ile sonlandırılana kadar devam eder. Ancak, her iki değer de sağlanırsa, bir hata atılır.

ScheduleTestsTrigger

ScheduleTestsTrigger modeli.

Name Tür Description
createdBy

string

Oluşturan kullanıcı.

createdDateTime

string (date-time)

Oluşturma datetime(RFC 3339 değişmez değer biçimi).

description

string

maxLength: 100

Tetikleyicinin açıklaması.

displayName

string

minLength: 2
maxLength: 50

Tetikleyicinin adı.

kind string:

ScheduleTestsTrigger

Tetiğin türü.

lastModifiedBy

string

Son değiştiren kullanıcı.

lastModifiedDateTime

string (date-time)

Son Değiştirilen tarih saat (RFC 3339 değişmez değer biçimi).

recurrence Recurrence:

Tetikleyicinin yinelenme ayrıntıları. Zamanlama yinelenmiyorsa null.

recurrenceStatus

RecurrenceStatus

Tetikleyici için yinelemenin gerçek durumu.

startDateTime

string (date-time)

UTC saat diliminde tetikleyicinin başlangıç tarihi saati. (RFC 3339 değişmez biçimi)

state

TriggerState

Tetikleyicinin geçerli durumu.

stateDetails

StateDetails

Tetikleyicinin mevcut durumunun ayrıntıları.

testIds

string[]

Bu zamanlama tetikleyicisi tarafından tetiklenecek testin test kimliği. Şu anda bir tetikleyici için yalnızca bir test desteklenmektedir.

triggerId

string

minLength: 2
maxLength: 50
pattern: ^[a-z0-9_-]*$

Tetikleyicinin benzersiz tanımlayıcısı.

StateDetails

Tetikleyicinin durum ayrıntıları.

Name Tür Description
message

string

Tetikleyici devre dışı durumdaysa hata mesajı.

TriggerState

Bir tetikleyicinin geçerli durumu.

Değer Description
Active

Tetikleyici etkindir.

Paused

Tetikleyici manuel olarak duraklatılır.

Completed

Tetikleme tamamlandı.

Disabled

Tetikleyici hata nedeniyle devre dışı bırakıldı.

TriggerType

Tetikleyici türü.

Değer Description
ScheduleTestsTrigger

Tetikleyici, bir Testte Zamanlanmış Tetikleyicidir.

WeekDays

Haftanın günlerini tanımlar.

Değer Description
Sunday

Pazar gününü ifade eder.

Monday

Pazartesi anlamına gelir.

Tuesday

Salı gününü ifade eder.

Wednesday

Çarşamba'yı ifade eder.

Thursday

Perşembe gününü ifade eder.

Friday

Cuma gününü ifade eder.

Saturday

Cumartesi anlamına gelir.

WeeklyRecurrence

Frekans haftalık olarak ayarlandığında tekrarlama modeli.

Name Tür Description
daysOfWeek

WeekDays[]

Yinelenme, haftanın belirtilen günlerinde tekrarlanacak şekilde ayarlanmıştır.

frequency string:

Weekly

Tekrarlama sıklığı.

interval

integer (int32)

Tekrarlamanın tekrarlanması gereken aralık. Her nüks arasındaki hafta sayısını gösterir.

recurrenceEnd

RecurrenceEnd

Tekrarlama bitiş modeli. Bir numberOfOccurrences (belirtilen oluşum sayısından sonra yinelemeyi sonlandırır) veya bir endDateTime (belirtilen tarihten sonra yinelemeyi sonlandırır) sağlayarak bitişi belirtebilirsiniz. Her iki değer de sağlanmazsa, yineleme el ile sonlandırılana kadar devam eder. Ancak, her iki değer de sağlanırsa, bir hata atılır.