Trigger Administration - Get Trigger

서비스:: Azure App Testing

API 버전:: 2025-11-01-preview

리소스 읽기 작업 템플릿입니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
endpoint	path	True	string (uri)
triggerId	path	True	string minLength: 2 maxLength: 50 pattern: ^[a-z0-9_-]*$	트리거의 고유 식별자입니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	Trigger: ScheduleTestsTrigger	요청이 성공했습니다.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	예기치 않은 오류 응답입니다. 헤더 x-ms-error-code: string

Name

형식

Description

200 OK

Trigger:

ScheduleTestsTrigger

요청이 성공했습니다.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

예기치 않은 오류 응답입니다.

헤더

x-ms-error-code: string

보안

Oauth2

Microsoft Entra ID를 사용하는 OAuth 2.0 Flow입니다.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

범위

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

예제

Get a trigger.

샘플 요청

HTTP

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

샘플 응답

상태 코드:: 200

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

정의

Name	Description
Azure.Core.Foundations.Error	오류 개체입니다.
Azure.Core.Foundations.ErrorResponse	오류 세부 정보가 포함된 응답입니다.
Azure.Core.Foundations.InnerError	오류에 대한 보다 구체적인 정보를 포함하는 개체입니다. Azure REST API 지침에 따라 - https://aka.ms/AzureRestApiGuidelines#handling-errors.
DailyRecurrence	빈도가 매일로 설정된 경우 되풀이 모델입니다.
Frequency	트리거에 대한 반복 빈도입니다.
HourlyRecurrence	빈도가 매시간으로 설정된 경우 되풀이 모델입니다.
MonthlyRecurrenceByDates	빈도가 MonthlyByDates로 설정된 경우 되풀이 모델입니다.
MonthlyRecurrenceByWeekDays	빈도가 MonthlyByDays로 설정된 경우 되풀이 모델 .
RecurrenceEnd	되풀이 종료 모델. 지정된 횟수 후에 되풀이를 종료하려면 numberOfOccurrences를 제공하고, 지정된 종료 날짜 이후에 되풀이를 종료하려면 endDate를 제공합니다. 두 값이 모두 제공되면 하나의 필드만 제공해야 함을 나타내는 유효성 검사 오류가 발생합니다. 두 값 모두 제공되지 않으면 수동으로 종료할 때 되풀이가 종료됩니다.
RecurrenceStatus	트리거에 대한 되풀이의 실제 상태입니다.
RecurrenceWithCron	되풀이는 cron 표현식을 기반으로 설정됩니다.
ScheduleTestsTrigger	ScheduleTestsTrigger 모델을 사용합니다.
StateDetails	트리거의 상태 세부 정보입니다.
TriggerState	트리거의 현재 상태입니다.
TriggerType	트리거의 유형입니다.
WeekDays	요일을 정의합니다.
WeeklyRecurrence	빈도가 매주로 설정된 경우 되풀이 모델입니다.

Azure.Core.Foundations.Error

Object

오류 개체입니다.

Name	형식	Description
code	string	서버에서 정의한 오류 코드 집합 중 하나입니다.
details	Azure.Core.Foundations.Error[]	이 보고된 오류로 이어진 특정 오류에 대한 세부 정보 배열입니다.
innererror	Azure.Core.Foundations.InnerError	오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.
message	string	사람이 읽을 수 있는 오류 표현입니다.
target	string	오류의 대상입니다.

Azure.Core.Foundations.ErrorResponse

Object

오류 세부 정보가 포함된 응답입니다.

Name	형식	Description
error	Azure.Core.Foundations.Error	오류 개체입니다.

Azure.Core.Foundations.InnerError

Object

오류에 대한 보다 구체적인 정보를 포함하는 개체입니다. Azure REST API 지침에 따라 - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	형식	Description
code	string	서버에서 정의한 오류 코드 집합 중 하나입니다.
innererror	Azure.Core.Foundations.InnerError	내부 오류입니다.

DailyRecurrence

Object

빈도가 매일로 설정된 경우 되풀이 모델입니다.

Name	형식	Description
frequency	string: Daily	재발 빈도입니다.
interval	integer (int32)	되풀이가 반복되어야 하는 간격입니다. 각 반복 사이의 일 수를 나타냅니다.
recurrenceEnd	RecurrenceEnd	되풀이 종료 모델. numberOfOccurrences(지정된 발생 횟수 후에 되풀이를 종료함)를 제공하거나 endDateTime(지정된 날짜 이후에 되풀이를 종료함)을 제공하여 끝을 지정할 수 있습니다. 두 값 모두 제공되지 않으면 수동으로 종료될 때까지 되풀이가 계속됩니다. 그러나 두 값을 모두 제공하면 오류가 발생합니다.

Frequency

열거형

트리거에 대한 반복 빈도입니다.

값	Description
Cron	cron 표현식으로 정의된 되풀이입니다.
Hourly	HourlyRecurrence에 지정된 대로 시간 단위로 정의된 되풀이입니다.
Daily	DailyRecurrence에 지정된 대로 매일 정의된 되풀이입니다.
Weekly	WeeklyRecurrence에 지정된 대로 주별로 정의된 되풀이입니다.
MonthlyByDays	MonthlyRecurrenceByWeekDays에 지정된 대로 특정 날짜에 매월 정의된 되풀이입니다.
MonthlyByDates	MonthlyRecurrenceByDates에 지정된 대로 특정 날짜에 매월 정의된 되풀이입니다.

HourlyRecurrence

Object

빈도가 매시간으로 설정된 경우 되풀이 모델입니다.

Name	형식	Description
frequency	string: Hourly	재발 빈도입니다.
interval	integer (int32)	되풀이가 반복되어야 하는 간격입니다. 각 반복 사이의 시간을 나타냅니다.
recurrenceEnd	RecurrenceEnd	되풀이 종료 모델. numberOfOccurrences(지정된 발생 횟수 후에 되풀이를 종료함)를 제공하거나 endDateTime(지정된 날짜 이후에 되풀이를 종료함)을 제공하여 끝을 지정할 수 있습니다. 두 값 모두 제공되지 않으면 수동으로 종료될 때까지 되풀이가 계속됩니다. 그러나 두 값을 모두 제공하면 오류가 발생합니다.

MonthlyRecurrenceByDates

Object

빈도가 MonthlyByDates로 설정된 경우 되풀이 모델입니다.

Name	형식	Description
datesInMonth	integer[] (int32)	해당 월의 지정된 날짜에 반복되도록 설정된 되풀이입니다. 날짜의 값은 1에서 31 및 -1 일 수 있습니다. -1은 해당 월의 마지막 날을 나타냅니다.
frequency	string: MonthlyByDates	재발 빈도입니다.
interval	integer (int32)	되풀이가 반복되어야 하는 간격입니다. 각 반복 사이의 개월 수를 나타냅니다.
recurrenceEnd	RecurrenceEnd	되풀이 종료 모델. numberOfOccurrences(지정된 발생 횟수 후에 되풀이를 종료함)를 제공하거나 endDateTime(지정된 날짜 이후에 되풀이를 종료함)을 제공하여 끝을 지정할 수 있습니다. 두 값 모두 제공되지 않으면 수동으로 종료될 때까지 되풀이가 계속됩니다. 그러나 두 값을 모두 제공하면 오류가 발생합니다.

MonthlyRecurrenceByWeekDays

Object

빈도가 MonthlyByDays로 설정된 경우 되풀이 모델 .

Name	형식	Description
frequency	string: MonthlyByDays	재발 빈도입니다.
index	integer (int32) minimum: 1 maximum: 5	재발이 반복되어야 하는 달의 주 인덱스입니다. 예를 들어 인덱스가 '2', weekDay가 'Monday', 간격이 3, 빈도가 'Month'인 경우 되풀이는 매월 두 번째 월요일에 실행되고 3개월마다 반복됩니다. 인덱스 값은 1에서 5까지입니다.
interval	integer (int32)	되풀이가 반복되어야 하는 간격입니다. 각 반복 사이의 개월 수를 나타냅니다.
recurrenceEnd	RecurrenceEnd	되풀이 종료 모델. numberOfOccurrences(지정된 발생 횟수 후에 되풀이를 종료함)를 제공하거나 endDateTime(지정된 날짜 이후에 되풀이를 종료함)을 제공하여 끝을 지정할 수 있습니다. 두 값 모두 제공되지 않으면 수동으로 종료될 때까지 되풀이가 계속됩니다. 그러나 두 값을 모두 제공하면 오류가 발생합니다.
weekDaysInMonth	WeekDays[]	재발이 반복되어야 하는 특정 요일입니다.

RecurrenceEnd

Object

되풀이 종료 모델. 지정된 횟수 후에 되풀이를 종료하려면 numberOfOccurrences를 제공하고, 지정된 종료 날짜 이후에 되풀이를 종료하려면 endDate를 제공합니다. 두 값이 모두 제공되면 하나의 필드만 제공해야 함을 나타내는 유효성 검사 오류가 발생합니다. 두 값 모두 제공되지 않으면 수동으로 종료할 때 되풀이가 종료됩니다.

Name	형식	Description
endDateTime	string (date-time)	되풀이가 종료되는 날짜입니다. (RFC 3339 리터럴 형식)
numberOfOccurrences	integer (int32)	되풀이가 종료되는 발생 횟수입니다.

RecurrenceStatus

Object

트리거에 대한 되풀이의 실제 상태입니다.

Name	형식	Description
nextScheduledDateTimes	string[] (date-time)	트리거의 다음 세 실행 시간입니다. (RFC 3339 리터럴 형식)
remainingOccurrences	integer (int32)	트리거에 대해 남은 발생 횟수입니다. 되풀이 종료에 발생 횟수 대신 종료 날짜가 있는 경우 Null입니다.

RecurrenceWithCron

Object

되풀이는 cron 표현식을 기반으로 설정됩니다.

Name	형식	Description
cronExpression	string	Cron 표현식입니다.
frequency	string: Cron	재발 빈도입니다.
recurrenceEnd	RecurrenceEnd	되풀이 종료 모델. numberOfOccurrences(지정된 발생 횟수 후에 되풀이를 종료함)를 제공하거나 endDateTime(지정된 날짜 이후에 되풀이를 종료함)을 제공하여 끝을 지정할 수 있습니다. 두 값 모두 제공되지 않으면 수동으로 종료될 때까지 되풀이가 계속됩니다. 그러나 두 값을 모두 제공하면 오류가 발생합니다.

ScheduleTestsTrigger

Object

ScheduleTestsTrigger 모델을 사용합니다.

Name	형식	Description
createdBy	string	만든 사용자입니다.
createdDateTime	string (date-time)	생성 날짜/시간(RFC 3339 리터럴 형식)입니다.
description	string maxLength: 100	트리거에 대한 설명입니다.
displayName	string minLength: 2 maxLength: 50	트리거의 이름입니다.
kind	string: ScheduleTestsTrigger	트리거의 형식입니다.
lastModifiedBy	string	마지막으로 수정한 사용자입니다.
lastModifiedDateTime	string (date-time)	마지막으로 수정된 날짜/시간(RFC 3339 리터럴 형식)입니다.
recurrence	Recurrence: DailyRecurrence HourlyRecurrence MonthlyRecurrenceByDates MonthlyRecurrenceByWeekDays RecurrenceWithCron WeeklyRecurrence	트리거의 되풀이 세부 정보입니다. 일정이 반복되지 않는 경우 Null입니다.
recurrenceStatus	RecurrenceStatus	트리거에 대한 되풀이의 실제 상태입니다.
startDateTime	string (date-time)	UTC 표준 시간대의 트리거 시작 날짜 시간입니다. (RFC 3339 리터럴 형식)
state	TriggerState	트리거의 현재 상태입니다.
stateDetails	StateDetails	트리거의 현재 상태에 대한 세부 정보입니다.
testIds	string[]	이 일정 트리거에 의해 트리거될 테스트의 테스트 ID입니다. 현재 트리거에 대해 하나의 테스트만 지원됩니다.
triggerId	string minLength: 2 maxLength: 50 pattern: ^[a-z0-9_-]*$	트리거의 고유 식별자입니다.

StateDetails

Object

트리거의 상태 세부 정보입니다.

Name	형식	Description
message	string	트리거가 비활성화된 상태인 경우 오류 메시지입니다.

TriggerState

열거형

트리거의 현재 상태입니다.

값	Description
Active	트리거가 활성화되었습니다.
Paused	트리거는 수동으로 일시 중지됩니다.
Completed	트리거가 완료되었습니다.
Disabled	오류로 인해 트리거가 비활성화되었습니다.

TriggerType

열거형

트리거의 유형입니다.

값	Description
ScheduleTestsTrigger	트리거는 테스트의 예약된 트리거입니다.

WeekDays

열거형

요일을 정의합니다.

값	Description
Sunday	일요일을 가리킵니다.
Monday	월요일을 나타냅니다.
Tuesday	화요일을 나타냅니다.
Wednesday	수요일을 나타냅니다.
Thursday	목요일을 나타냅니다.
Friday	금요일을 나타냅니다.
Saturday	토요일을 나타냅니다.

WeeklyRecurrence

Object

빈도가 매주로 설정된 경우 되풀이 모델입니다.

Name	형식	Description
daysOfWeek	WeekDays[]	지정된 요일에 반복되도록 설정된 되풀이입니다.
frequency	string: Weekly	재발 빈도입니다.
interval	integer (int32)	되풀이가 반복되어야 하는 간격입니다. 각 재발 사이의 주 수를 나타냅니다.
recurrenceEnd	RecurrenceEnd	되풀이 종료 모델. numberOfOccurrences(지정된 발생 횟수 후에 되풀이를 종료함)를 제공하거나 endDateTime(지정된 날짜 이후에 되풀이를 종료함)을 제공하여 끝을 지정할 수 있습니다. 두 값 모두 제공되지 않으면 수동으로 종료될 때까지 되풀이가 계속됩니다. 그러나 두 값을 모두 제공하면 오류가 발생합니다.

다음을 통해 공유

Trigger Administration - Get Trigger

URI 매개 변수

응답

보안

Oauth2

범위

예제

Get a trigger.

샘플 요청

샘플 응답

정의

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

DailyRecurrence

Frequency

HourlyRecurrence

MonthlyRecurrenceByDates

MonthlyRecurrenceByWeekDays

RecurrenceEnd

RecurrenceStatus

RecurrenceWithCron

ScheduleTestsTrigger

StateDetails

TriggerState

TriggerType

WeekDays

WeeklyRecurrence