- 데이터 유형 -트리거 TriggerUpdate 조건자 Condition 작업 EventBatchingCondition - 작업 -CreateTrigger(create_trigger).StartTrigger(start_trigger)GetTrigger(get_trigger)GetTrigger(get_triggers)UpdateTrigger(update_trigger)StopTrigger(stop_trigger)DeleteTrigger(delete_trigger)ListTriggers(list_triggers)BatchGetTriggers(batch_get_triggers)

트리거

트리거 API는 AWS Glue에서의 작업 트리거 생성, 업데이트 또는 삭제 및 시작/중지와 관련된 API 및 데이터 유형에 대해 설명합니다.

트리거 구조

특정 트리거에 대한 정보

필드

Name – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

트리거의 이름입니다.
WorkflowName – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

트리거와 연결된 워크플로의 이름입니다.
Id – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

추후 사용 예약.
Type – UTF-8 문자열입니다(유효 값: SCHEDULED | CONDITIONAL | ON_DEMAND | EVENT).

트리거 유형입니다.
State – UTF-8 문자열입니다(유효 값: CREATING | CREATED | ACTIVATING | ACTIVATED | DEACTIVATING | DEACTIVATED | DELETING | UPDATING).

트리거 현재 테이블 상태
Description – URI address multi-line string pattern과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

이 트리거에 대한 설명입니다.
Schedule – UTF-8 문자열입니다.

일정을 지정하는 데 사용되는 cron 표현식입니다(작업 및 크롤러의 시간 기반 일정 참조). 예를 들어, 매일 오후 12시 15분(UTC)에 실행하려면 cron(15 12 * * ? *)을 지정합니다.
Actions – 작업 객체의 배열입니다.

이 트리거에 의해 시작되는 작업
Predicate – 조건자 객체입니다.

트리거가 실행되는 시기를 결정하는 이 트리거의 조건자입니다.
EventBatchingCondition – EventBatchingCondition 객체입니다.

EventBridge 이벤트 트리거가 실행되기 전에 충족되어야 하는 배치 조건(수신된 이벤트의 지정된 수 또는 배치 기간이 만료됨).

TriggerUpdate 구조

트리거를 업데이트하기 위해 정보를 제공하는 데 사용되는 구조입니다. 이 객체는 이전 트리거 정의를 완전히 덮어써서 업데이트합니다.

필드

Name – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

추후 사용 예약.
Description – URI address multi-line string pattern과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

이 트리거에 대한 설명입니다.
Schedule – UTF-8 문자열입니다.

일정을 지정하는 데 사용되는 cron 표현식입니다(작업 및 크롤러의 시간 기반 일정 참조). 예를 들어, 매일 오후 12시 15분(UTC)에 실행하려면 cron(15 12 * * ? *)을 지정합니다.
Actions – 작업 객체의 배열입니다.

이 트리거에 의해 시작되는 작업
Predicate – 조건자 객체입니다.

트리거가 실행되는 시기를 결정하는 이 트리거의 조건자입니다.
EventBatchingCondition – EventBatchingCondition 객체입니다.

EventBridge 이벤트 트리거가 실행되기 전에 충족되어야 하는 배치 조건(수신된 이벤트의 지정된 수 또는 배치 기간이 만료됨).

조건자 구조

트리거가 실행되는 시기를 결정하는 트리거의 조건자를 정의합니다.

필드

Logical – UTF-8 문자열입니다(유효한 값: AND | ANY).

오직 하나의 조건이 기록되어 있다면 조건부 필드입니다. 다수의 조건이 있을 때 이 필드가 필요합니다.
Conditions – Condition 객체의 배열입니다.

트리거가 언제 발생하는지 확인하는 조건 목록입니다.

조건 구조

어떤 트리거가 시작되는지에 대한 조건을 결정합니다.

필드

LogicalOperator – UTF-8 문자열입니다(유효한 값: EQUALS).

논리 연산자
JobName – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

JobRuns에 조건이 적용되고 트리거가 대기하는 작업의 이름입니다.
State – UTF-8 문자열입니다(유효한 값: STARTING | RUNNING | STOPPING | STOPPED | SUCCEEDED | FAILED | TIMEOUT | ERROR | WAITING | EXPIRED).

조건 상태입니다. 현재 트리거가 수신할 수 있는 유일한 작업은 SUCCEEDED, STOPPED, FAILED 및 TIMEOUT입니다. 트리거가 수신할 수 있는 유일한 Crawler는 SUCCEEDED, FAILED 및 CANCELLED입니다.
CrawlerName – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

이 조건이 적용되는 크롤러의 이름입니다.
CrawlState – UTF-8 문자열입니다(유효 값: RUNNING | CANCELLING | CANCELLED | SUCCEEDED | FAILED | ERROR).

이 조건이 적용되는 크롤러의 상태입니다.

작업 구조

트리거에 의해 시작한 작업을 결정합니다.

필드

JobName – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

실행할 작업의 이름입니다.
Arguments – 키-값 페어의 맵 배열입니다.

각 키는 UTF-8 문자열입니다.

각 값은 UTF-8 문자열입니다.

이 트리거가 작동할 때 사용되는 작업 인수입니다. 이 작업 실행에서 작업 정의 자체에 설정된 기본 인수를 바꿉니다.

AWS Glue 자체가 사용하는 인수는 물론 사용자의 작업 실행 스크립트가 사용하는 인수를 지정할 수 있습니다.

자체 작업 인수를 지정하고 사용하는 방법에 대한 자세한 내용은 개발자 가이드의 Python에서 AWS Glue Glue API 호출을 참조하세요.

AWS Glue가 작업을 설정하는 데 사용하는 키 값 페어에 대한 자세한 내용은 개발자 가이드의 AWS Glue가 사용하는 특정 파라미터를 참조하세요.
Timeout – 1 이상의 숫자(정수)입니다.

JobRun 제한 시간(분)입니다. 작업을 실행하여 리소스를 소비하여 중지되기 전에 TIMEOUT 상태로 들어가는 최대 시간입니다. 기본값은 2,880 분(48 시간)입니다. 상위 작업에 설정된 제한 시간 값을 재정의합니다.
SecurityConfiguration – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

이 작업에 사용할 SecurityConfiguration 구조의 이름입니다.
NotificationProperty – NotificationProperty 객체입니다.

작업 실행 알림의 구성 속성을 지정합니다.
CrawlerName – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

이 작업에 사용할 크롤러의 이름입니다.

EventBatchingCondition 구조

EventBridge 이벤트 트리거가 실행되기 전에 충족되어야 하는 배치 조건(수신된 이벤트의 지정된 수 또는 배치 기간이 만료됨).

필드

BatchSize – 필수(Required): 1~100의 숫자(정수)입니다.

EventBridge 이벤트 트리거가 실행되기 전에 Amazon EventBridge에서 수신해야 하는 이벤트 수입니다.
BatchWindow – 1~900의 숫자(정수)입니다.

EventBridge 이벤트 트리거가 실행된 후의 기간(초)입니다. 첫 번째 이벤트가 수신되면 기간이 시작됩니다.

운영

CreateTrigger 작업(Python: create_trigger)
StartTrigger 작업(Python: start_trigger)
GetTrigger 작업(Python: get_trigger)
GetTrigger 작업(Python: get_triggers)
UpdateTrigger 작업(Python: update_trigger)
StopTrigger 작업(Python: stop_trigger)
DeleteTrigger 작업(Python: delete_trigger)
ListTriggers 작업(Python: list_triggers)
BatchGetTriggers 작업(Python: batch_get_triggers)

CreateTrigger 작업(Python: create_trigger)

새로운 트리거를 만듭니다.

요청

Name – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

트리거의 이름입니다.
WorkflowName – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

트리거와 연결된 워크플로의 이름입니다.
Type – 필수(Required): UTF-8 문자열입니다(유효 값: SCHEDULED | CONDITIONAL | ON_DEMAND | EVENT).

새로운 트리거의 유형입니다.
Schedule – UTF-8 문자열입니다.

일정을 지정하는 데 사용되는 cron 표현식입니다(작업 및 크롤러의 시간 기반 일정 참조). 예를 들어, 매일 오후 12시 15분(UTC)에 실행하려면 cron(15 12 * * ? *)을 지정합니다.

트리거 유형이 SCHEDULED(예정)되면 필드가 필요합니다.
Predicate – 조건자 객체입니다.

새로운 트리거가 시작할 시기를 지정하는 조건자입니다.

트리거 유형이 CONDITIONAL이면 이 필드는 필수입니다.
Actions – 필수(Required): 작업 객체의 배열입니다.

트리거가 발생하면 이 트리거가 시작되는 작업입니다.
Description – URI address multi-line string pattern과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

새로운 트리거에 대한 설명.
StartOnCreation – 부울입니다.

생성 시 SCHEDULED 및 CONDITIONAL 트리거를 시작하려면 true로 설정합니다. ON_DEMAND 트리거에는 True가 지원되지 않습니다.
Tags – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

각 키는 길이가 1~128바이트인 UTF-8 문자열입니다.

각 값은 256 바이트 이하 길이의 UTF-8 문자열입니다.

이 트리거에서 사용할 태그입니다. 태그를 사용하여 트리거에 대한 액세스를 제한할 수 있습니다. AWS Glue의 태그에 대한 자세한 내용은 개발자 안내서의 AWS Glue의 AWS 태그를 참조하세요.
EventBatchingCondition – EventBatchingCondition 객체입니다.

EventBridge 이벤트 트리거가 실행되기 전에 충족되어야 하는 배치 조건(수신된 이벤트의 지정된 수 또는 배치 기간이 만료됨).

응답

Name – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

트리거의 이름입니다.

Errors

AlreadyExistsException
EntityNotFoundException
InvalidInputException
IdempotentParameterMismatchException
InternalServiceException
OperationTimeoutException
ResourceNumberLimitExceededException
ConcurrentModificationException

StartTrigger 작업(Python: start_trigger)

기존 트리거 시작. 다른 유형의 트리거가 시작하는 방법에 대한 자세한 내용은 작업 트리거를 참조하십시오.

요청

Name – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

시작할 트리거의 이름입니다.

응답

Name – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

시작된 트리거의 이름입니다.

Errors

InvalidInputException
InternalServiceException
EntityNotFoundException
OperationTimeoutException
ResourceNumberLimitExceededException
ConcurrentRunsExceededException

GetTrigger 작업(Python: get_trigger)

트리거의 정의를 검색합니다.

요청

Name – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

가져올 트리거의 이름입니다.

응답

Trigger – 트리거 객체입니다.

요청한 트리거 정의입니다.

Errors

EntityNotFoundException
InvalidInputException
InternalServiceException
OperationTimeoutException

GetTrigger 작업(Python: get_triggers)

이 작업과 연결된 모든 트리거를 얻습니다.

요청

NextToken – UTF-8 문자열입니다.

이것이 지속적으로 호출되면 지속적인 토큰입니다.
DependentJobName – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

트리거를 가져올 작업 이름입니다. 이 작업을 시작할 수 있는 트리거가 반환되고, 이런 트리거가 없으면 모든 트리거가 반환됩니다.
MaxResults - 1 이상 200 이하의 숫자(정수)입니다.

응답의 최대 크기입니다.

응답

Triggers – 트리거 객체의 배열입니다.

지정된 작업에 대한 트리거 목록.
NextToken – UTF-8 문자열입니다.

모든 요청된 트리거가 반환하지 않은 경우의 지속 토큰입니다.

Errors

EntityNotFoundException
InvalidInputException
InternalServiceException
OperationTimeoutException

UpdateTrigger 작업(Python: update_trigger)

트리거 정의 업데이트

요청

Name – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

업데이트할 트리거의 이름입니다.
TriggerUpdate – 필수(Required): TriggerUpdate 객체입니다.

트리거를 업데이트하여 얻은 새로운 값입니다.

응답

Trigger – 트리거 객체입니다.

결과 트리거 정의입니다.

Errors

InvalidInputException
InternalServiceException
EntityNotFoundException
OperationTimeoutException
ConcurrentModificationException

StopTrigger 작업(Python: stop_trigger)

지정된 트리거를 중지합니다.

요청

Name – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

중지할 트리거의 이름입니다.

응답

Name – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

중지된 트리거의 이름입니다.

Errors

InvalidInputException
InternalServiceException
EntityNotFoundException
OperationTimeoutException
ConcurrentModificationException

DeleteTrigger 작업(Python: delete_trigger)

지정된 트리거를 삭제합니다. 트리거를 못 찾으면 어떤 예외도 없습니다.

요청

Name – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

삭제할 트리거의 이름입니다.

응답

Name – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

삭제된 트리거의 이름입니다.

Errors

InvalidInputException
InternalServiceException
OperationTimeoutException
ConcurrentModificationException

ListTriggers 작업(Python: list_triggers)

AWS 계정의 모든 트리거 리소스 또는 지정된 태그를 가진 리소스의 이름을 검색합니다. 이 작업을 통해 계정에서 사용 가능한 리소스와 그 이름을 확인할 수 있습니다.

이 작업을 수행하면 응답에서 필터로 사용할 수 있는 선택 사항인 Tags 필드가 검색되기 때문에 태그가 지정된 리소스를 하나의 그룹으로 검색할 수 있습니다. 태그 필터링을 사용하기로 선택하면 태그가 포함된 리소스만 검색됩니다.

요청

NextToken – UTF-8 문자열입니다.

이것이 지속적인 요청이라면 지속적인 토큰입니다.
DependentJobName – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

트리거를 가져올 작업 이름 이 작업을 시작할 수 있는 트리거가 반환됩니다. 그런 트리거가 없으면 모든 트리거가 반환됩니다.
MaxResults - 1 이상 200 이하의 숫자(정수)입니다.

반환할 목록의 최대 크기.
Tags – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

각 키는 길이가 1~128바이트인 UTF-8 문자열입니다.

각 값은 256 바이트 이하 길이의 UTF-8 문자열입니다.

이렇게 태그가 지정된 리소스만 반환하도록 지정합니다.

응답

TriggerNames – UTF-8 문자열의 배열입니다.

계정의 모든 트리거 또는 지정된 태그를 가진 트리거의 이름입니다.
NextToken – UTF-8 문자열입니다.

반환된 목록이 사용가능한 마지막 지표를 포함하지 경우의 연속 토큰입니다.

Errors

EntityNotFoundException
InvalidInputException
InternalServiceException
OperationTimeoutException

BatchGetTriggers 작업(Python: batch_get_triggers)

주어진 트리거 이름 목록에 대한 리소스 메타데이터 목록을 반환합니다. ListTriggers 작업을 호출한 후에는 권한이 부여된 데이터에 액세스하기 위해 이 작업을 호출할 수 있습니다. 이 작업은 태그를 사용하는 권한 조건을 포함해 모든 IAM 권한을 지원합니다.

요청

TriggerNames – 필수(Required): UTF-8 문자열의 배열입니다.

트리거 이름(ListTriggers 작업에서 반환된 이름일 수 있음)의 목록입니다.

응답

Triggers – 트리거 객체의 배열입니다.

트리거 정의 목록입니다.
TriggersNotFound – UTF-8 문자열의 배열입니다.

찾을 수 없는 트리거의 이름 목록입니다.

Errors

InternalServiceException
OperationTimeoutException
InvalidInputException

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

작업 실행

대화형 세션