# 작업 API
<a name="aws-glue-api-jobs"></a>

작업 API는 작업 데이터 유형을 설명하며 AWS Glue에서 작업, 작업 실행, 트리거로 작업하기 위한 API를 포함합니다.

**Topics**
+ [작업](aws-glue-api-jobs-job.md)
+ [작업 실행](aws-glue-api-jobs-runs.md)
+ [트리거](aws-glue-api-jobs-trigger.md)

# 작업
<a name="aws-glue-api-jobs-job"></a>

작업 API는 AWS Glue에서의 작업 생성, 업데이트, 삭제 또는 확인과 관련된 API 및 데이터 유형에 대해 설명합니다.

## 데이터 타입
<a name="aws-glue-api-jobs-job-objects"></a>
+ [작업 구조](#aws-glue-api-jobs-job-Job)
+ [ExecutionProperty 구조](#aws-glue-api-jobs-job-ExecutionProperty)
+ [NotificationProperty 구조](#aws-glue-api-jobs-job-NotificationProperty)
+ [JobCommand 구조](#aws-glue-api-jobs-job-JobCommand)
+ [ConnectionsList 구조](#aws-glue-api-jobs-job-ConnectionsList)
+ [JobUpdate 구조](#aws-glue-api-jobs-job-JobUpdate)
+ [SourceControlDetails 구조](#aws-glue-api-jobs-job-SourceControlDetails)

## 작업 구조
<a name="aws-glue-api-jobs-job-Job"></a>

작업 정의를 지정합니다.

**필드**
+ `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업 정의에 할당하는 이름입니다.
+ `JobMode` – UTF-8 문자열입니다(유효한 값: `SCRIPT=""` \$1 `VISUAL=""` \$1 `NOTEBOOK=""`).

  작업이 생성된 방법을 설명하는 모드입니다. 유효값은 다음과 같습니다.
  + `SCRIPT` - AWS Glue Studio 스크립트 편집기를 사용하여 작업을 생성했습니다.
  + `VISUAL` - AWS Glue Studio 시각적 편집기를 사용하여 작업을 생성했습니다.
  + `NOTEBOOK` - 대화형 세션 노트북을 사용하여 작업을 생성했습니다.

  `JobMode` 필드가 없거나 null인 경우 기본값으로 `SCRIPT`가 할당됩니다.
+ `JobRunQueuingEnabled` – 부울입니다.

  이 작업에 대한 작업 실행을 위해 작업 실행 대기열을 활성화할지 여부를 지정합니다.

  값이 true이면 해당 작업 실행에 대해 작업 실행 큐가 활성화됩니다. false이거나 채워지지 않은 경우 작업 실행은 대기열에 포함되는 것으로 간주되지 않습니다.

  이 필드가 작업 실행에 설정된 값과 일치하지 않으면 작업 실행 필드의 값이 사용됩니다.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  작업 설명입니다.
+ `LogUri` – UTF-8 문자열입니다.

  이 필드는 향후 사용하기 위해 예약되어 있습니다.
+ `Role` – UTF-8 문자열입니다.

  이 작업과 연결된 IAM 역할의 이름 또는 Amazon 리소스 이름(ARN)입니다.
+ `CreatedOn` – 타임스탬프입니다.

  작업 정의가 생성된 날짜와 시간입니다.
+ `LastModifiedOn` – 타임스탬프입니다.

  이 작업 정의가 수정된 마지막 시점입니다.
+ `ExecutionProperty` – [ExecutionProperty](#aws-glue-api-jobs-job-ExecutionProperty) 객체입니다.

  `ExecutionProperty`는 이 작업에 허용된 최대 동시 실행 수를 지정합니다.
+ `Command` – [JobCommand](#aws-glue-api-jobs-job-JobCommand) 객체입니다.

  이 작업을 실행하는 `JobCommand`입니다.
+ `DefaultArguments` – 키-값 페어의 맵 배열입니다.

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

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

  이 작업의 모든 실행에서 기본 인수(이름 값 페어로 지정됨)입니다.

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

  작업 인수가 로깅될 수 있습니다. 일반 텍스트 보안 암호를 인수로 전달하지 마세요. 보안 암호를 작업 내에 보관하려는 경우 AWS Glue 연결, AWS Secrets Manager 또는 다른 보안 암호 관리 메커니즘에서 검색합니다.

  자체 작업 인수를 지정하고 사용하는 방법에 대한 자세한 내용은 개발자 가이드의 [Python에서 AWS Glue Glue API](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-python-calling.html) 호출을 참조하세요.

  Spark 작업을 구성할 때 이 필드에 제공할 수 있는 인수에 대한 자세한 내용은 개발자 안내서의 [AWS Glue에서 사용하는 특별 파라미터](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html) 주제를 참조하세요.

  Ray 작업을 구성할 때 이 필드에 제공할 수 있는 인수에 대한 자세한 내용은 개발자 안내서의 [Ray 작업에서 작업 파라미터 사용](https://docs.aws.amazon.com/glue/latest/dg/author-job-ray-job-parameters.html)을 참조하세요.
+ `NonOverridableArguments` – 키-값 페어의 맵 배열입니다.

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

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

  작업 실행 시 작업 인수를 제공할 때 재정의되지 않는 이 작업의 인수(이름 값 페어로 지정됨)입니다.
+ `Connections` – [ConnectionsList](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-ConnectionsList) 객체입니다.

  이 작업에 사용된 연결입니다.
+ `MaxRetries` - 숫자(정수)입니다.

  JobRun이 실패한 후 이 작업을 다시 시도할 수 있는 최대 횟수입니다.
+ `AllocatedCapacity` - 숫자(정수)입니다.

  이 필드는 더 이상 사용되지 않습니다. 대신 `MaxCapacity`을 사용하세요.

  이 작업 실행에 따라 할당된 AWS Glue 데이터 처리 장치(DPU) 수입니다. 최소 2DPU를 할당할 수 있습니다. 기본값은 10입니다. DPU는 4 vCPU의 컴퓨팅 파워와 16GB 메모리로 구성된 프로세싱 파워의 상대적 측정값입니다. 자세한 내용은 [AWS Glue 요금](https://aws.amazon.com/glue/pricing/) 페이지를 참조하세요.

  
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  작업 타임아웃(분)입니다. 작업을 실행하여 리소스를 소비하여 중지되기 전에 `TIMEOUT` 상태로 들어가는 최대 시간입니다.

  작업의 시간 제한 값은 7일 또는 10,080분 미만이어야 합니다. 그렇지 않으면 작업에서 예외가 발생합니다.

  값을 비워 두면 제한 시간은 기본적으로 2,880분으로 설정됩니다.

  제한 시간 값이 7일을 초과하는 기존 AWS Glue 작업은 기본적으로 7일로 설정됩니다. 예를 들어 배치 작업에 20일의 제한 시간을 지정한 경우 7일째 되는 날에 작업이 중지됩니다.

  스트리밍 작업은 유지 관리 기간을 설정한 경우 7일 후 유지 관리 기간 중에 작업이 다시 시작됩니다.
+ `MaxCapacity` - 숫자(double)입니다.

  Glue 버전 1.0 이전 적업의 경우 표준 작업자 유형을 사용하여 이 작업을 실행할 때 할당할 수 있는 AWS Glue 데이터 처리 장치(DPU) 수입니다. DPU는 4 vCPU의 컴퓨팅 파워와 16GB 메모리로 구성된 프로세싱 파워의 상대적 측정값입니다. 자세한 내용은 [AWS Glue 요금](https://aws.amazon.com/glue/pricing/) 페이지를 참조하세요.

  Glue 버전 2.0 이상 작업의 경우 `Maximum capacity`를 지정할 수 없습니다. 그 대신 `Worker type` 및 `Number of workers`를 지정해야 합니다.

  `WorkerType` 및 `NumberOfWorkers`를 사용하는 경우, `MaxCapacity`를 설정하지 마세요.

  `MaxCapacity`에 할당할 수 있는 값은 Python 셸 작업을 실행하는지 또는 Apache Spark ETL 작업 또는 Apache Spark 스트리밍 ETL 작업을 실행하는지에 따라 다릅니다.
  + Python 셸 작업(`JobCommand.Name`="pythonshell")을 지정하면 0.0625 또는 1 DPU를 할당할 수 있습니다. 기본값은 0.0625 DPU입니다.
  + Apache Spark ETL 작업(`JobCommand.Name`="glueetl") 또는 Apache Spark 스트리밍 ETL 작업 (`JobCommand.Name`="gluestreaming") 을 지정하면 2에서 100 DPU를 할당할 수 있습니다. 기본값은 10 DPU입니다. 이 작업 유형에는 부분적인 DPU 할당을 사용할 수 없습니다.
+ `WorkerType` – UTF-8 문자열입니다(유효한 값: `Standard=""` \$1 `G.025X=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `G.12X=""` \$1 `G.16X=""` \$1 `R.1X=""` \$1 `R.2X=""` \$1 `R.4X=""` \$1 `R.8X=""` \$1 `Z.2X=""`).

  작업이 실행될 때 할당되는 미리 정의된 작업자 유형입니다.

  AWS Glue는 다양한 워크로드 요구 사항을 수용할 수 있도록 여러 개의 작업자 유형을 제공합니다.

  G 작업자 유형(범용 컴퓨팅 작업자):
  + G.025X: DPU 0.25개(vCPU 2개, 메모리 4GB, 디스크 84GB)
  + G.1X: DPU 1개(vCPU 4개, 메모리 16GB, 디스크 94GB)
  + G.2X: DPU 2개(vCPU 8개, 메모리 32GB, 디스크 138GB)
  + G.4X: DPU 4개(vCPU 16개, 메모리 64GB, 디스크 256GB)
  + G.8X: DPU 8개(vCPU 32개, 메모리 128GB, 디스크 512GB)
  + G.12X: DPU 12개(vCPU 48개, 메모리 192GB, 디스크 768GB)
  + G.16X: DPU 16개(vCPU 64개, 메모리 256GB, 디스크 1,024GB)

  R 작업자 유형(메모리 최적화 작업자):
  + R.1X: DPU 1개(vCPU 4개, 메모리 32GB, 디스크 94GB)
  + R.2X: DPU 2개(vCPU 8개, 메모리 64GB, 디스크 128GB)
  + R.4X: DPU 4개(vCPU 16개, 메모리 128GB, 디스크 256GB)
  + R.8X: DPU 8개(vCPU 32개, 메모리 256GB, 디스크 512GB)
+ `NumberOfWorkers` - 숫자(정수)입니다.

  작업이 실행될 때 할당되는 정의된 `workerType`의 작업자 수입니다.
+ `SecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업에 사용할 `SecurityConfiguration` 구조의 이름입니다.
+ `NotificationProperty` – [NotificationProperty](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-NotificationProperty) 객체입니다.

  작업 알림의 구성 속성을 지정합니다.
+ `Running` – 부울입니다.

  이 필드는 향후 사용하기 위해 예약되어 있습니다.
+ `GlueVersion` – [Custom string pattern #48](aws-glue-api-common.md#regex_48)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  Spark 작업에서 `GlueVersion`에 따라 AWS Glue에서 작업에 사용할 수 있는 Apache Spark 및 Python 버전이 결정됩니다. Python의 버전으로 Spark 유형의 작업에 대해 지원되는 버전을 확인할 수 있습니다.

  Ray 작업에서는 `GlueVersion`을 `4.0` 이상으로 설정해야 합니다. 그러나 Ray 작업에서 사용할 수 있는 Ray, Python 및 추가 라이브러리의 버전은 Job 명령의 `Runtime` 파라미터에 의해 결정됩니다.

  이용 가능한 AWS Glue 버전과 그에 상응하는 Spark 및 Python 버전에 대한 자세한 내용은 개발자 안내서의 [Glue 버전](https://docs.aws.amazon.com/glue/latest/dg/add-job.html)을 참조하세요.

  Glue 버전 지정 없이 생성된 작업은 Glue 0.9로 기본 지정됩니다.
+ `CodeGenConfigurationNodes` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #60](aws-glue-api-common.md#regex_60)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [CodeGenConfigurationNode](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CodeGenConfigurationNode) 객체입니다.

  Glue Studio 시각적 구성 요소 및 Glue Studio 코드 생성의 기반이 되는 방향성 비순환 그래프의 표현입니다.
+ `ExecutionClass` - 16바이트 미만의 UTF-8 문자열입니다(유효한 값: `FLEX=""` \$1 `STANDARD=""`).

  작업이 표준 또는 유연한 실행 클래스로 실행되는지 여부를 나타냅니다. 표준 실행 클래스는 빠른 작업 시작 및 전용 리소스가 필요한 시간에 민감한 워크로드에 적합합니다.

  유연한 실행 클래스는 시작 및 완료 시간이 다를 수 있는 시간에 민감하지 않은 작업에 적합합니다.

  AWS Glue 버전 3.0 이상 및 명령 유형 `glueetl`을 사용하는 작업만 `ExecutionClass`가 `FLEX`로 설정됩니다. 유연한 실행 클래스는 Spark 작업에 사용할 수 있습니다.
+ `SourceControlDetails` – [SourceControlDetails](#aws-glue-api-jobs-job-SourceControlDetails) 객체입니다.

  작업에 대한 소스 제어 구성에 대한 세부 정보로, 원격 리포지토리와의 작업 아티팩트 동기화를 허용합니다.
+ `MaintenanceWindow` – [Custom string pattern #34](aws-glue-api-common.md#regex_34)과(와) 일치하는 UTF-8 문자열입니다.

  이 필드는 스트리밍 작업에 대한 유지 관리 기간의 요일과 시간을 지정합니다. AWS Glue에서는 정기적으로 유지 관리 작업을 수행합니다. 이러한 유지 관리 기간 동안에는 AWS Glue에서 스트리밍 작업을 다시 시작해야 합니다.

  AWS Glue에서는 지정된 유지 관리 기간으로부터 3시간 이내에 작업을 다시 시작합니다. 예를 들어, 유지 관리 기간을 GMT 기준 월요일 오전 10시로 설정하면 작업이 GMT 기준 오전 10시에서 오후 1시 사이에 다시 시작됩니다.
+ `ProfileName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  작업과 연결된 AWS Glue 사용 프로필의 이름입니다.

## ExecutionProperty 구조
<a name="aws-glue-api-jobs-job-ExecutionProperty"></a>

작업의 실행 속성입니다.

**필드**
+ `MaxConcurrentRuns` - 숫자(정수)입니다.

  작업에 허용된 최대 동시 실행 수입니다. 기본 값은 1입니다. 이 임곗값에 도달하면 오류가 반환됩니다. 지정할 수 있는 최대값은 서비스 제한에 따라 통제됩니다.

## NotificationProperty 구조
<a name="aws-glue-api-jobs-job-NotificationProperty"></a>

알림의 구성 속성을 지정합니다.

**필드**
+ `NotifyDelayAfter` – 1 이상의 숫자(정수)입니다.

  작업 실행 시작 후 작업 실행 대기 알림을 전송하기 전까지 대기하는 시간(분)입니다.

## JobCommand 구조
<a name="aws-glue-api-jobs-job-JobCommand"></a>

작업이 실행될 때 실행되는 코드를 지정합니다.

**필드**
+ `Name` – UTF-8 문자열입니다.

  작업 명령의 이름입니다. Apache Spark ETL 작업의 경우, `glueetl`이어야 합니다. Python 셸 작업의 경우, `pythonshell`이어야 합니다. Apache Spark 스트리밍 ETL 작업의 경우, `gluestreaming`이어야 합니다. Ray 작업의 경우 `glueray`이어야 합니다.
+ `ScriptLocation` – 400,000바이트 이하 길이의 UTF-8 문자열입니다.

  작업을 실행하는 스크립트의 Amazon Simple Storage Service(Amazon S3) 경로를 지정합니다.
+ `PythonVersion` – [Custom string pattern #49](aws-glue-api-common.md#regex_49)과(와) 일치하는 UTF-8 문자열입니다.

  Python 셸 작업을 실행하는 데 사용되는 Python 버전입니다. 허용되는 값은 2 또는 3입니다.
+ `Runtime` – [Custom string pattern #33](aws-glue-api-common.md#regex_33)과 일치하는 64바이트 이하 길이의 UTF-8 문자열입니다.

  Ray 작업에서 런타임은 사용자 환경에서 사용 가능한 Ray, Python 및 추가 라이브러리의 버전을 지정하는 데 사용됩니다. 이 필드는 다른 작업 유형에서 사용되지 않습니다. 지원되는 런타임 환경 값은 AWS Glue 개발자 안내서에서 [지원되는 Ray 런타임 환경](https://docs.aws.amazon.com/glue/latest/dg/ray-jobs-section.html)을 참조하세요.

## ConnectionsList 구조
<a name="aws-glue-api-jobs-job-ConnectionsList"></a>

작업이 사용한 연결을 지정합니다.

**필드**
+ `Connections` – 1,000개 이하의 문자열로 구성된 UTF-8 문자열의 배열입니다.

  작업이 사용한 연결 목록입니다.

## JobUpdate 구조
<a name="aws-glue-api-jobs-job-JobUpdate"></a>

기존 작업 정의 업데이트에 사용된 정보를 지정합니다. 이전 작업 정의를 이 정보로 완전히 덮어씁니다.

**필드**
+ `JobMode` – UTF-8 문자열입니다(유효한 값: `SCRIPT=""` \$1 `VISUAL=""` \$1 `NOTEBOOK=""`).

  작업이 생성된 방법을 설명하는 모드입니다. 유효값은 다음과 같습니다.
  + `SCRIPT` - AWS Glue Studio 스크립트 편집기를 사용하여 작업을 생성했습니다.
  + `VISUAL` - AWS Glue Studio 시각적 편집기를 사용하여 작업을 생성했습니다.
  + `NOTEBOOK` - 대화형 세션 노트북을 사용하여 작업을 생성했습니다.

  `JobMode` 필드가 없거나 null인 경우 기본값으로 `SCRIPT`가 할당됩니다.
+ `JobRunQueuingEnabled` – 부울입니다.

  이 작업에 대한 작업 실행을 위해 작업 실행 대기열을 활성화할지 여부를 지정합니다.

  값이 true이면 해당 작업 실행에 대해 작업 실행 큐가 활성화됩니다. false이거나 채워지지 않은 경우 작업 실행은 대기열에 포함되는 것으로 간주되지 않습니다.

  이 필드가 작업 실행에 설정된 값과 일치하지 않으면 작업 실행 필드의 값이 사용됩니다.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  정의된 작업에 대한 설명입니다.
+ `LogUri` – UTF-8 문자열입니다.

  이 필드는 향후 사용하기 위해 예약되어 있습니다.
+ `Role` – UTF-8 문자열입니다.

  이 작업과 연결된 IAM 역할의 이름 또는 Amazon 리소스 이름(ARN)입니다(필수).
+ `ExecutionProperty` – [ExecutionProperty](#aws-glue-api-jobs-job-ExecutionProperty) 객체입니다.

  `ExecutionProperty`는 이 작업에 허용된 최대 동시 실행 수를 지정합니다.
+ `Command` – [JobCommand](#aws-glue-api-jobs-job-JobCommand) 객체입니다.

  이 작업을 실행하는 `JobCommand`입니다(필수).
+ `DefaultArguments` – 키-값 페어의 맵 배열입니다.

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

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

  이 작업의 모든 실행에서 기본 인수(이름 값 페어로 지정됨)입니다.

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

  작업 인수가 로깅될 수 있습니다. 일반 텍스트 보안 암호를 인수로 전달하지 마세요. 보안 암호를 작업 내에 보관하려는 경우 AWS Glue 연결, AWS Secrets Manager 또는 다른 보안 암호 관리 메커니즘에서 검색합니다.

  자체 작업 인수를 지정하고 사용하는 방법에 대한 자세한 내용은 개발자 가이드의 [Python에서 AWS Glue Glue API](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-python-calling.html) 호출을 참조하세요.

  Spark 작업을 구성할 때 이 필드에 제공할 수 있는 인수에 대한 자세한 내용은 개발자 안내서의 [AWS Glue에서 사용하는 특별 파라미터](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html) 주제를 참조하세요.

  Ray 작업을 구성할 때 이 필드에 제공할 수 있는 인수에 대한 자세한 내용은 개발자 안내서의 [Ray 작업에서 작업 파라미터 사용](https://docs.aws.amazon.com/glue/latest/dg/author-job-ray-job-parameters.html)을 참조하세요.
+ `NonOverridableArguments` – 키-값 페어의 맵 배열입니다.

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

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

  작업 실행 시 작업 인수를 제공할 때 재정의되지 않는 이 작업의 인수(이름 값 페어로 지정됨)입니다.
+ `Connections` – [ConnectionsList](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-ConnectionsList) 객체입니다.

  이 작업에 사용된 연결입니다.
+ `MaxRetries` - 숫자(정수)입니다.

  실패한 경우 이 작업을 다시 시도할 수 있는 최대 횟수입니다.
+ `AllocatedCapacity` - 숫자(정수)입니다.

  이 필드는 더 이상 사용되지 않습니다. 대신 `MaxCapacity`을 사용하세요.

  이 작업에 할당할 AWS Glue 데이터 처리 장치(DPU) 수입니다. 최소 2DPU를 할당할 수 있습니다. 기본값은 10입니다. DPU는 4 vCPU의 컴퓨팅 파워와 16GB 메모리로 구성된 프로세싱 파워의 상대적 측정값입니다. 자세한 내용은 [AWS Glue 요금](https://aws.amazon.com/glue/pricing/) 페이지를 참조하세요.
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  작업 타임아웃(분)입니다. 작업을 실행하여 리소스를 소비하여 중지되기 전에 `TIMEOUT` 상태로 들어가는 최대 시간입니다.

  작업의 시간 제한 값은 7일 또는 10,080분 미만이어야 합니다. 그렇지 않으면 작업에서 예외가 발생합니다.

  값을 비워 두면 제한 시간은 기본적으로 2,880분으로 설정됩니다.

  제한 시간 값이 7일을 초과하는 기존 AWS Glue 작업은 기본적으로 7일로 설정됩니다. 예를 들어 배치 작업에 20일의 제한 시간을 지정한 경우 7일째 되는 날에 작업이 중지됩니다.

  스트리밍 작업은 유지 관리 기간을 설정한 경우 7일 후 유지 관리 기간 중에 작업이 다시 시작됩니다.
+ `MaxCapacity` - 숫자(double)입니다.

  Glue 버전 1.0 이전 적업의 경우 표준 작업자 유형을 사용하여 이 작업을 실행할 때 할당할 수 있는 AWS Glue 데이터 처리 장치(DPU) 수입니다. DPU는 4 vCPU의 컴퓨팅 파워와 16GB 메모리로 구성된 프로세싱 파워의 상대적 측정값입니다. 자세한 내용은 [AWS Glue 요금](https://aws.amazon.com/glue/pricing/) 페이지를 참조하세요.

  Glue 버전 2.0 이상 작업의 경우 `Maximum capacity`를 지정할 수 없습니다. 그 대신 `Worker type` 및 `Number of workers`를 지정해야 합니다.

  `WorkerType` 및 `NumberOfWorkers`를 사용하는 경우, `MaxCapacity`를 설정하지 마세요.

  `MaxCapacity`에 할당할 수 있는 값은 Python 셸 작업을 실행하는지 또는 Apache Spark ETL 작업 또는 Apache Spark 스트리밍 ETL 작업을 실행하는지에 따라 다릅니다.
  + Python 셸 작업(`JobCommand.Name`="pythonshell")을 지정하면 0.0625 또는 1 DPU를 할당할 수 있습니다. 기본값은 0.0625 DPU입니다.
  + Apache Spark ETL 작업(`JobCommand.Name`="glueetl") 또는 Apache Spark 스트리밍 ETL 작업 (`JobCommand.Name`="gluestreaming") 을 지정하면 2에서 100 DPU를 할당할 수 있습니다. 기본값은 10 DPU입니다. 이 작업 유형에는 부분적인 DPU 할당을 사용할 수 없습니다.
+ `WorkerType` – UTF-8 문자열입니다(유효한 값: `Standard=""` \$1 `G.025X=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `G.12X=""` \$1 `G.16X=""` \$1 `R.1X=""` \$1 `R.2X=""` \$1 `R.4X=""` \$1 `R.8X=""` \$1 `Z.2X=""`).

  작업이 실행될 때 할당되는 미리 정의된 작업자 유형입니다. Spark 작업에 대해 G.025X, G.1X, G.2X, G.4X, G.8X, G.12X, G.16X, R.1X, R.2X, R.4X 또는 R.8X 값을 허용합니다. Ray 작업에 대해 Z.2X 값을 허용합니다. 자세한 내용은 [Spark 작업을 위한 작업 속성 정의](https://docs.aws.amazon.com/glue/latest/dg/add-job.html#create-job)를 참조하세요.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  작업이 실행될 때 할당되는 정의된 `workerType`의 작업자 수입니다.
+ `SecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업에 사용할 `SecurityConfiguration` 구조의 이름입니다.
+ `NotificationProperty` – [NotificationProperty](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-NotificationProperty) 객체입니다.

  작업 알림의 구성 속성을 지정합니다.
+ `GlueVersion` – [Custom string pattern #48](aws-glue-api-common.md#regex_48)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  Spark 작업에서 `GlueVersion`에 따라 AWS Glue에서 작업에 사용할 수 있는 Apache Spark 및 Python 버전이 결정됩니다. Python의 버전으로 Spark 유형의 작업에 대해 지원되는 버전을 확인할 수 있습니다.

  Ray 작업에서는 `GlueVersion`을 `4.0` 이상으로 설정해야 합니다. 그러나 Ray 작업에서 사용할 수 있는 Ray, Python 및 추가 라이브러리의 버전은 Job 명령의 `Runtime` 파라미터에 의해 결정됩니다.

  이용 가능한 AWS Glue 버전과 그에 상응하는 Spark 및 Python 버전에 대한 자세한 내용은 개발자 안내서의 [Glue 버전](https://docs.aws.amazon.com/glue/latest/dg/add-job.html)을 참조하세요.

  Glue 버전 지정 없이 생성된 작업은 Glue 0.9로 기본 지정됩니다.
+ `CodeGenConfigurationNodes` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #60](aws-glue-api-common.md#regex_60)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [CodeGenConfigurationNode](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CodeGenConfigurationNode) 객체입니다.

  Glue Studio 시각적 구성 요소 및 Glue Studio 코드 생성의 기반이 되는 방향성 비순환 그래프의 표현입니다.
+ `ExecutionClass` - 16바이트 미만의 UTF-8 문자열입니다(유효한 값: `FLEX=""` \$1 `STANDARD=""`).

  작업이 표준 또는 유연한 실행 클래스로 실행되는지 여부를 나타냅니다. 표준 실행 클래스는 빠른 작업 시작 및 전용 리소스가 필요한 시간에 민감한 워크로드에 적합합니다.

  유연한 실행 클래스는 시작 및 완료 시간이 다를 수 있는 시간에 민감하지 않은 작업에 적합합니다.

  AWS Glue 버전 3.0 이상 및 명령 유형 `glueetl`을 사용하는 작업만 `ExecutionClass`가 `FLEX`로 설정됩니다. 유연한 실행 클래스는 Spark 작업에 사용할 수 있습니다.
+ `SourceControlDetails` – [SourceControlDetails](#aws-glue-api-jobs-job-SourceControlDetails) 객체입니다.

  작업에 대한 소스 제어 구성에 대한 세부 정보로, 원격 리포지토리와의 작업 아티팩트 동기화를 허용합니다.
+ `MaintenanceWindow` – [Custom string pattern #34](aws-glue-api-common.md#regex_34)과(와) 일치하는 UTF-8 문자열입니다.

  이 필드는 스트리밍 작업에 대한 유지 관리 기간의 요일과 시간을 지정합니다. AWS Glue에서는 정기적으로 유지 관리 작업을 수행합니다. 이러한 유지 관리 기간 동안에는 AWS Glue에서 스트리밍 작업을 다시 시작해야 합니다.

  AWS Glue에서는 지정된 유지 관리 기간으로부터 3시간 이내에 작업을 다시 시작합니다. 예를 들어, 유지 관리 기간을 GMT 기준 월요일 오전 10시로 설정하면 작업이 GMT 기준 오전 10시에서 오후 1시 사이에 다시 시작됩니다.
+ `ProfileName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  작업과 연결된 AWS Glue 사용 프로필의 이름입니다.

## SourceControlDetails 구조
<a name="aws-glue-api-jobs-job-SourceControlDetails"></a>

작업에 대한 소스 제어 구성에 대한 세부 정보로, 원격 리포지토리와의 작업 아티팩트 동기화를 허용합니다.

**필드**
+ `Provider` – UTF-8 문자열입니다(유효 값: `GITHUB` \$1 `AWS_CODE_COMMIT`).

  원격 리포지토리의 공급자입니다.
+ `Repository` – 1\$1512바이트 길이의 UTF-8 문자열입니다.

  작업 아티팩트가 포함된 원격 리포지토리의 이름입니다.
+ `Owner` – 1\$1512바이트 길이의 UTF-8 문자열입니다.

  작업 아티팩트가 포함된 원격 리포지토리의 소유자입니다.
+ `Branch` – 1\$1512바이트 길이의 UTF-8 문자열입니다.

  원격 리포지토리의 선택적 브랜치입니다.
+ `Folder` – 1\$1512바이트 길이의 UTF-8 문자열입니다.

  원격 리포지토리의 선택적 폴더입니다.
+ `LastCommitId` – 1\$1512바이트 길이의 UTF-8 문자열입니다.

  원격 리포지토리의 커밋에 대한 마지막 커밋 ID입니다.
+ `LastSyncTimestamp` – 1\$1512바이트 길이의 UTF-8 문자열입니다.

  마지막 작업 동기화가 수행된 날짜와 시간입니다.
+ `AuthStrategy` – UTF-8 문자열입니다(유효 값: `PERSONAL_ACCESS_TOKEN` \$1 `AWS_SECRETS_MANAGER`).

  인증 유형으로, AWS Secrets Manager에 저장된 인증 토큰이거나 개인 액세스 토큰일 수 있습니다.
+ `AuthToken` – 1\$1512바이트 길이의 UTF-8 문자열입니다.

  인증 토큰의 값입니다.

## 운영
<a name="aws-glue-api-jobs-job-actions"></a>
+ [CreateJob 작업(Python: create\$1job)](#aws-glue-api-jobs-job-CreateJob)
+ [UpdateJob 작업(Python: update\$1job)](#aws-glue-api-jobs-job-UpdateJob)
+ [GetJob 작업(Python: get\$1job)](#aws-glue-api-jobs-job-GetJob)
+ [GetJobs 작업(Python: get\$1jobs)](#aws-glue-api-jobs-job-GetJobs)
+ [DeleteJob 작업(Python: delete\$1job)](#aws-glue-api-jobs-job-DeleteJob)
+ [ListJobs 작업(Python: list\$1jobs)](#aws-glue-api-jobs-job-ListJobs)
+ [BatchGetJobs 작업(Python: batch\$1get\$1jobs)](#aws-glue-api-jobs-job-BatchGetJobs)

## CreateJob 작업(Python: create\$1job)
<a name="aws-glue-api-jobs-job-CreateJob"></a>

새로운 작업 정의를 만듭니다.

**요청**
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업 정의에 할당하는 이름입니다. 계정에서 고유해야 합니다.
+ `JobMode` – UTF-8 문자열입니다(유효한 값: `SCRIPT=""` \$1 `VISUAL=""` \$1 `NOTEBOOK=""`).

  작업이 생성된 방법을 설명하는 모드입니다. 유효값은 다음과 같습니다.
  + `SCRIPT` - AWS Glue Studio 스크립트 편집기를 사용하여 작업을 생성했습니다.
  + `VISUAL` - AWS Glue Studio 시각적 편집기를 사용하여 작업을 생성했습니다.
  + `NOTEBOOK` - 대화형 세션 노트북을 사용하여 작업을 생성했습니다.

  `JobMode` 필드가 없거나 null인 경우 기본값으로 `SCRIPT`가 할당됩니다.
+ `JobRunQueuingEnabled` – 부울입니다.

  이 작업에 대한 작업 실행을 위해 작업 실행 대기열을 활성화할지 여부를 지정합니다.

  값이 true이면 해당 작업 실행에 대해 작업 실행 큐가 활성화됩니다. false이거나 채워지지 않은 경우 작업 실행은 대기열에 포함되는 것으로 간주되지 않습니다.

  이 필드가 작업 실행에 설정된 값과 일치하지 않으면 작업 실행 필드의 값이 사용됩니다.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  정의된 작업에 대한 설명입니다.
+ `LogUri` – UTF-8 문자열입니다.

  이 필드는 향후 사용하기 위해 예약되어 있습니다.
+ `Role` – *필수(Required):* UTF-8 문자열입니다.

  이 작업과 연결된 IAM 역할의 이름 또는 Amazon 리소스 이름(ARN)입니다.
+ `ExecutionProperty` – [ExecutionProperty](#aws-glue-api-jobs-job-ExecutionProperty) 객체입니다.

  `ExecutionProperty`는 이 작업에 허용된 최대 동시 실행 수를 지정합니다.
+ `Command` – *필수(Required):* [JobCommand](#aws-glue-api-jobs-job-JobCommand) 객체입니다.

  이 작업을 실행하는 `JobCommand`입니다.
+ `DefaultArguments` – 키-값 페어의 맵 배열입니다.

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

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

  이 작업의 모든 실행에서 기본 인수(이름 값 페어로 지정됨)입니다.

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

  작업 인수가 로깅될 수 있습니다. 일반 텍스트 보안 암호를 인수로 전달하지 마세요. 보안 암호를 작업 내에 보관하려는 경우 AWS Glue 연결, AWS Secrets Manager 또는 다른 보안 암호 관리 메커니즘에서 검색합니다.

  자체 작업 인수를 지정하고 사용하는 방법에 대한 자세한 내용은 개발자 가이드의 [Python에서 AWS Glue Glue API](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-python-calling.html) 호출을 참조하세요.

  Spark 작업을 구성할 때 이 필드에 제공할 수 있는 인수에 대한 자세한 내용은 개발자 안내서의 [AWS Glue에서 사용하는 특별 파라미터](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html) 주제를 참조하세요.

  Ray 작업을 구성할 때 이 필드에 제공할 수 있는 인수에 대한 자세한 내용은 개발자 안내서의 [Ray 작업에서 작업 파라미터 사용](https://docs.aws.amazon.com/glue/latest/dg/author-job-ray-job-parameters.html)을 참조하세요.
+ `NonOverridableArguments` – 키-값 페어의 맵 배열입니다.

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

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

  작업 실행 시 작업 인수를 제공할 때 재정의되지 않는 이 작업의 인수(이름 값 페어로 지정됨)입니다.
+ `Connections` – [ConnectionsList](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-ConnectionsList) 객체입니다.

  이 작업에 사용된 연결입니다.
+ `MaxRetries` - 숫자(정수)입니다.

  실패한 경우 이 작업을 다시 시도할 수 있는 최대 횟수입니다.
+ `AllocatedCapacity` - 숫자(정수)입니다.

  이 파라미터는 이제 사용되지 않습니다. 대신 `MaxCapacity`을 사용하세요.

  이 작업에 할당할 AWS Glue 데이터 처리 장치(DPU) 수입니다. 최소 2DPU를 할당할 수 있습니다. 기본값은 10입니다. DPU는 4 vCPU의 컴퓨팅 파워와 16GB 메모리로 구성된 프로세싱 파워의 상대적 측정값입니다. 자세한 내용은 [AWS Glue 요금](https://aws.amazon.com/glue/pricing/) 페이지를 참조하세요.
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  작업 타임아웃(분)입니다. 작업을 실행하여 리소스를 소비하여 중지되기 전에 `TIMEOUT` 상태로 들어가는 최대 시간입니다.

  작업의 시간 제한 값은 7일 또는 10,080분 미만이어야 합니다. 그렇지 않으면 작업에서 예외가 발생합니다.

  값을 비워 두면 제한 시간은 기본적으로 2,880분으로 설정됩니다.

  제한 시간 값이 7일을 초과하는 기존 AWS Glue 작업은 기본적으로 7일로 설정됩니다. 예를 들어 배치 작업에 20일의 제한 시간을 지정한 경우 7일째 되는 날에 작업이 중지됩니다.

  스트리밍 작업은 유지 관리 기간을 설정한 경우 7일 후 유지 관리 기간 중에 작업이 다시 시작됩니다.
+ `MaxCapacity` - 숫자(double)입니다.

  Glue 버전 1.0 이전 적업의 경우 표준 작업자 유형을 사용하여 이 작업을 실행할 때 할당할 수 있는 AWS Glue 데이터 처리 장치(DPU) 수입니다. DPU는 4 vCPU의 컴퓨팅 파워와 16GB 메모리로 구성된 프로세싱 파워의 상대적 측정값입니다. 자세한 내용은 [AWS Glue 요금](https://aws.amazon.com/glue/pricing/) 페이지를 참조하세요.

  Glue 버전 2.0 이상 작업의 경우 `Maximum capacity`를 지정할 수 없습니다. 그 대신 `Worker type` 및 `Number of workers`를 지정해야 합니다.

  `WorkerType` 및 `NumberOfWorkers`를 사용하는 경우, `MaxCapacity`를 설정하지 마세요.

  `MaxCapacity`에 할당할 수 있는 값은 Python 셸 작업을 실행하는지 또는 Apache Spark ETL 작업 또는 Apache Spark 스트리밍 ETL 작업을 실행하는지에 따라 다릅니다.
  + Python 셸 작업(`JobCommand.Name`="pythonshell")을 지정하면 0.0625 또는 1 DPU를 할당할 수 있습니다. 기본값은 0.0625 DPU입니다.
  + Apache Spark ETL 작업(`JobCommand.Name`="glueetl") 또는 Apache Spark 스트리밍 ETL 작업 (`JobCommand.Name`="gluestreaming") 을 지정하면 2에서 100 DPU를 할당할 수 있습니다. 기본값은 10 DPU입니다. 이 작업 유형에는 부분적인 DPU 할당을 사용할 수 없습니다.
+ `SecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업에 사용할 `SecurityConfiguration` 구조의 이름입니다.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  이 작업에서 사용할 태그입니다. 태그를 사용하여 작업에 대한 액세스를 제한할 수 있습니다. AWS Glue의 태그에 대한 자세한 내용은 개발자 안내서의 [AWS Glue의 AWS 태그](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html)를 참조하세요.
+ `NotificationProperty` – [NotificationProperty](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-NotificationProperty) 객체입니다.

  작업 알림의 구성 속성을 지정합니다.
+ `GlueVersion` – [Custom string pattern #48](aws-glue-api-common.md#regex_48)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  Spark 작업에서 `GlueVersion`에 따라 AWS Glue에서 작업에 사용할 수 있는 Apache Spark 및 Python 버전이 결정됩니다. Python의 버전으로 Spark 유형의 작업에 대해 지원되는 버전을 확인할 수 있습니다.

  Ray 작업에서는 `GlueVersion`을 `4.0` 이상으로 설정해야 합니다. 그러나 Ray 작업에서 사용할 수 있는 Ray, Python 및 추가 라이브러리의 버전은 Job 명령의 `Runtime` 파라미터에 의해 결정됩니다.

  이용 가능한 AWS Glue 버전과 그에 상응하는 Spark 및 Python 버전에 대한 자세한 내용은 개발자 안내서의 [Glue 버전](https://docs.aws.amazon.com/glue/latest/dg/add-job.html)을 참조하세요.

  Glue 버전 지정 없이 생성된 작업은 Glue 0.9로 기본 지정됩니다.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  작업이 실행될 때 할당되는 정의된 `workerType`의 작업자 수입니다.
+ `WorkerType` – UTF-8 문자열입니다(유효한 값: `Standard=""` \$1 `G.025X=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `G.12X=""` \$1 `G.16X=""` \$1 `R.1X=""` \$1 `R.2X=""` \$1 `R.4X=""` \$1 `R.8X=""` \$1 `Z.2X=""`).

  작업이 실행될 때 할당되는 미리 정의된 작업자 유형입니다. Spark 작업에 대해 G.025X, G.1X, G.2X, G.4X, G.8X, G.12X, G.16X, R.1X, R.2X, R.4X 또는 R.8X 값을 허용합니다. Ray 작업에 대해 Z.2X 값을 허용합니다.
  + `G.025X` 작업자 유형의 경우, 각 작업자가 84GB의 디스크가 있는 0.25DPU(2개의 vCPU, 4GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 볼륨이 낮은 스트리밍 작업에 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 3.0 이상 스트리밍 작업에만 사용할 수 있습니다.
  + `G.1X` 작업자 유형의 경우, 각 작업자가 94GB의 디스크가 있는 1DPU(4개의 vCPU, 16GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 대부분의 작업을 실행할 수 있는 확장 가능하고 비용 효율적인 방법을 제공하기 위해 데이터 변환, 조인, 쿼리와 같은 워크로드에서 이 작업자 유형을 사용하는 것이 좋습니다.
  + `G.2X` 작업자 유형의 경우, 각 작업자가 138GB의 디스크가 있는 2DPU(8개의 vCPU, 32GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 대부분의 작업을 실행할 수 있는 확장 가능하고 비용 효율적인 방법을 제공하기 위해 데이터 변환, 조인, 쿼리와 같은 워크로드에서 이 작업자 유형을 사용하는 것이 좋습니다.
  + `G.4X` 작업자 유형의 경우, 각 작업자가 256GB의 디스크가 있는 4DPU(16개의 vCPU, 64GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 워크로드에 가장 까다로운 변환, 집계, 조인 및 쿼리가 포함된 작업에서 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 다음 AWS 리전에서 실행되는 Spark ETL 작업의 AWS Glue 버전 3.0 이상에서만 사용할 수 있습니다: 미국 동부(오하이오), 미국 동부(버지니아 북부), 미국 서부(캘리포니아 북부), 미국 서부(오리건), 아시아 태평양(뭄바이), 아시아 태평양(서울), 아시아 태평양(싱가포르), 아시아 태평양(시드니), 아시아 태평양(도쿄), 캐나다(중부), 유럽(프랑크푸르트), 유럽(아일랜드), 유럽(런던), 유럽(스페인), 유럽(스톡홀름) 
  + `G.8X` 작업자 유형의 경우, 각 작업자가 512GB의 디스크가 있는 8DPU(32개의 vCPU, 128GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 워크로드에 가장 까다로운 변환, 집계, 조인 및 쿼리가 포함된 작업에서 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 `G.4X` 작업자 유형에 지원되는 동일한 AWS 리전에서 AWS Glue 버전 3.0 이상 Spark ETL 작업에 대해서만 사용할 수 있습니다.
  + `G.12X` 작업자 유형의 경우, 각 작업자가 768GB의 디스크가 있는 12DPU(48개의 vCPU, 192GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 워크로드가 매우 큰 작업에는 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `G.16X` 작업자 유형의 경우, 각 작업자가 1024GB의 디스크가 있는 16DPU(64개의 vCPU, 256GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 워크로드가 매우 큰 작업에는 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `R.1X` 작업자 유형의 경우, 각 작업자가 94GB의 디스크가 있는 1DPU(4개의 vCPU, 32GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 워크로드의 경우 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `R.2X` 작업자 유형의 경우, 각 작업자가 128GB의 디스크가 있는 2DPU(8개의 vCPU, 64GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 워크로드의 경우 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `R.4X` 작업자 유형의 경우, 각 작업자가 256GB의 디스크가 있는 4DPU(16개의 vCPU, 128GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 워크로드의 경우 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `R.8X` 작업자 유형의 경우, 각 작업자가 512GB의 디스크가 있는 8DPU(32개의 vCPU, 256GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 워크로드의 경우 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `Z.2X` 작업자 유형의 경우, 각 작업자는 128GB 디스크에서 2개의 M-DPU(vCPU 8개, 메모리 64GB)에 매핑되고, Autoscaler에 따라 최대 8개의 Ray 작업자를 제공합니다.
+ `CodeGenConfigurationNodes` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #60](aws-glue-api-common.md#regex_60)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [CodeGenConfigurationNode](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CodeGenConfigurationNode) 객체입니다.

  Glue Studio 시각적 구성 요소 및 Glue Studio 코드 생성의 기반이 되는 방향성 비순환 그래프의 표현입니다.
+ `ExecutionClass` - 16바이트 미만의 UTF-8 문자열입니다(유효한 값: `FLEX=""` \$1 `STANDARD=""`).

  작업이 표준 또는 유연한 실행 클래스로 실행되는지 여부를 나타냅니다. 표준 실행 클래스는 빠른 작업 시작 및 전용 리소스가 필요한 시간에 민감한 워크로드에 적합합니다.

  유연한 실행 클래스는 시작 및 완료 시간이 다를 수 있는 시간에 민감하지 않은 작업에 적합합니다.

  AWS Glue 버전 3.0 이상 및 명령 유형 `glueetl`을 사용하는 작업만 `ExecutionClass`가 `FLEX`로 설정됩니다. 유연한 실행 클래스는 Spark 작업에 사용할 수 있습니다.
+ `SourceControlDetails` – [SourceControlDetails](#aws-glue-api-jobs-job-SourceControlDetails) 객체입니다.

  작업에 대한 소스 제어 구성에 대한 세부 정보로, 원격 리포지토리와의 작업 아티팩트 동기화를 허용합니다.
+ `MaintenanceWindow` – [Custom string pattern #34](aws-glue-api-common.md#regex_34)과(와) 일치하는 UTF-8 문자열입니다.

  이 필드는 스트리밍 작업에 대한 유지 관리 기간의 요일과 시간을 지정합니다. AWS Glue에서는 정기적으로 유지 관리 작업을 수행합니다. 이러한 유지 관리 기간 동안에는 AWS Glue에서 스트리밍 작업을 다시 시작해야 합니다.

  AWS Glue에서는 지정된 유지 관리 기간으로부터 3시간 이내에 작업을 다시 시작합니다. 예를 들어, 유지 관리 기간을 GMT 기준 월요일 오전 10시로 설정하면 작업이 GMT 기준 오전 10시에서 오후 1시 사이에 다시 시작됩니다.
+ `ProfileName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  작업과 연결된 AWS Glue 사용 프로필의 이름입니다.

**응답**
+ `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업 정의를 위해 제공된 고유 이름입니다.

**오류**
+ `InvalidInputException`
+ `IdempotentParameterMismatchException`
+ `AlreadyExistsException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `ConcurrentModificationException`

## UpdateJob 작업(Python: update\$1job)
<a name="aws-glue-api-jobs-job-UpdateJob"></a>

기존 작업 정의를 업데이트합니다. 이전 작업 정의를 이 정보로 완전히 덮어씁니다.

**요청**
+ `JobName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  업데이트할 작업 정의 이름입니다.
+ `JobUpdate` – *필수(Required):* [JobUpdate](#aws-glue-api-jobs-job-JobUpdate) 객체입니다.

  작업 정의를 업데이트하여 값을 지정합니다. 지정되지 않은 구성은 제거되거나 기본값으로 재설정됩니다.
+ `ProfileName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  작업과 연결된 AWS Glue 사용 프로필의 이름입니다.

**응답**
+ `JobName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  업데이트된 작업 정의 이름을 반환합니다.

**오류**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ConcurrentModificationException`

## GetJob 작업(Python: get\$1job)
<a name="aws-glue-api-jobs-job-GetJob"></a>

기존 작업 정의를 가져옵니다.

**요청**
+ `JobName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  가져올 작업 정의 이름입니다.

**응답**
+ `Job` – [작업](#aws-glue-api-jobs-job-Job) 객체입니다.

  요청한 작업 정의.

**오류**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetJobs 작업(Python: get\$1jobs)
<a name="aws-glue-api-jobs-job-GetJobs"></a>

현재 모든 작업 정의를 가져옵니다.

**요청**
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰입니다.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  응답의 최대 크기입니다.

**응답**
+ `Jobs` – [작업](#aws-glue-api-jobs-job-Job) 객체의 배열입니다.

  작업 정의 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.

  모든 작업 정의가 반환하지 않은 경우의 지속 토큰입니다.

**오류**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## DeleteJob 작업(Python: delete\$1job)
<a name="aws-glue-api-jobs-job-DeleteJob"></a>

지정한 작업 정의를 삭제합니다. 작업 정의를 못 찾으면 어떤 예외도 없습니다.

**요청**
+ `JobName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  삭제할 작업 정의 이름입니다.

**응답**
+ `JobName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  삭제된 작업 정의 이름입니다.

**오류**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## ListJobs 작업(Python: list\$1jobs)
<a name="aws-glue-api-jobs-job-ListJobs"></a>

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

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

**요청**
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적인 요청이라면 지속적인 토큰입니다.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

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

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

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

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

**응답**
+ `JobNames` – UTF-8 문자열의 배열입니다.

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

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

**오류**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## BatchGetJobs 작업(Python: batch\$1get\$1jobs)
<a name="aws-glue-api-jobs-job-BatchGetJobs"></a>

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

**요청**
+ `JobNames` – *필수(Required):* UTF-8 문자열의 배열입니다.

  작업 이름(`ListJobs` 작업에서 반환된 이름일 수 있음)의 목록입니다.

**응답**
+ `Jobs` – [작업](#aws-glue-api-jobs-job-Job) 객체의 배열입니다.

  작업 정의 목록입니다.
+ `JobsNotFound` – UTF-8 문자열의 배열입니다.

  찾을 수 없는 작업의 이름 목록입니다.

**오류**
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`

# 작업 실행
<a name="aws-glue-api-jobs-runs"></a>

 작업 실행 API는 AWS Glue에서의 작업 실행 시작, 중지 또는 확인과 작업 북마크 재설정과 관련된 API 및 데이터 유형에 대해 설명합니다. 워크플로 및 작업 실행의 경우 작업 실행 기록을 90일 동안 액세스할 수 있습니다.

## 데이터 타입
<a name="aws-glue-api-jobs-runs-objects"></a>
+ [JobRun 구조](#aws-glue-api-jobs-runs-JobRun)
+ [이전 구조](#aws-glue-api-jobs-runs-Predecessor)
+ [JobBookmarkEntry 구조](#aws-glue-api-jobs-runs-JobBookmarkEntry)
+ [BatchStopJobRunSuccessfulSubmission 구조](#aws-glue-api-jobs-runs-BatchStopJobRunSuccessfulSubmission)
+ [BatchStopJobRunError 구조](#aws-glue-api-jobs-runs-BatchStopJobRunError)
+ [NotificationProperty 구조](#aws-glue-api-jobs-runs-NotificationProperty)

## JobRun 구조
<a name="aws-glue-api-jobs-runs-JobRun"></a>

작업 실행에 관한 정보를 포함합니다.

**필드**
+ `Id` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업 실행의 ID.
+ `Attempt` - 숫자(정수)입니다.

  이 작업을 실행하고자 시도했던 수입니다.
+ `PreviousRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업의 이전 실행 ID입니다. 예를 들어 `StartJobRun` 작업에 지정된 `JobRunId`입니다.
+ `TriggerName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업을 시작한 트리거의 이름입니다.
+ `JobName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업에 사용된 작업 정의 이름입니다.
+ `JobMode` – UTF-8 문자열입니다(유효한 값: `SCRIPT=""` \$1 `VISUAL=""` \$1 `NOTEBOOK=""`).

  작업이 생성된 방법을 설명하는 모드입니다. 유효값은 다음과 같습니다.
  + `SCRIPT` - AWS Glue Studio 스크립트 편집기를 사용하여 작업을 생성했습니다.
  + `VISUAL` - AWS Glue Studio 시각적 편집기를 사용하여 작업을 생성했습니다.
  + `NOTEBOOK` - 대화형 세션 노트북을 사용하여 작업을 생성했습니다.

  `JobMode` 필드가 없거나 null인 경우 기본값으로 `SCRIPT`가 할당됩니다.
+ `JobRunQueuingEnabled` – 부울입니다.

  해당 작업 실행에 대해 작업 실행 대기열을 활성화할지 여부를 지정합니다.

  값이 true이면 해당 작업 실행에 대해 작업 실행 큐가 활성화됩니다. false이거나 채워지지 않은 경우 작업 실행은 대기열에 포함되는 것으로 간주되지 않습니다.
+ `StartedOn` – 타임스탬프입니다.

  이 작업이 시작된 날짜 및 시간.
+ `LastModifiedOn` – 타임스탬프입니다.

  이 작업 실행이 수정된 마지막 시간입니다.
+ `CompletedOn` – 타임스탬프입니다.

  이 작업 실행이 완료된 날짜 및 시간입니다.
+ `JobRunState` – UTF-8 문자열입니다(유효한 값: `STARTING` \$1 `RUNNING` \$1 `STOPPING` \$1 `STOPPED` \$1 `SUCCEEDED` \$1 `FAILED` \$1 `TIMEOUT` \$1 `ERROR` \$1 `WAITING` \$1 `EXPIRED`).

  작업 실행의 현재 상태입니다. 비정상적으로 종료된 작업의 상태에 대한 자세한 내용은 [AWS Glue 작업 실행 상태](https://docs.aws.amazon.com/glue/latest/dg/job-run-statuses.html)를 참조하세요.
+ `Arguments` – 키-값 페어의 맵 배열입니다.

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

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

  작업과 연결되어 있는 작업 인수입니다. 이 작업 실행에서 작업 정의 자체에 설정된 기본 인수를 바꿉니다.

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

  작업 인수가 로깅될 수 있습니다. 일반 텍스트 보안 암호를 인수로 전달하지 마세요. 보안 암호를 작업 내에 보관하려는 경우 AWS Glue 연결, AWS Secrets Manager 또는 다른 보안 암호 관리 메커니즘에서 검색합니다.

  자체 작업 인수를 지정하고 사용하는 방법에 대한 자세한 내용은 개발자 가이드의 [Python에서 AWS Glue Glue API](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-python-calling.html) 호출을 참조하세요.

  Spark 작업을 구성할 때 이 필드에 제공할 수 있는 인수에 대한 자세한 내용은 개발자 안내서의 [AWS Glue에서 사용하는 특별 파라미터](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html) 주제를 참조하세요.

  Ray 작업을 구성할 때 이 필드에 제공할 수 있는 인수에 대한 자세한 내용은 개발자 안내서의 [Ray 작업에서 작업 파라미터 사용](https://docs.aws.amazon.com/glue/latest/dg/author-job-ray-job-parameters.html)을 참조하세요.
+ `ErrorMessage` – UTF-8 문자열입니다.

  이 작업의 실행과 연결된 오류 메시지입니다.
+ `PredecessorRuns` – [이전 기록](#aws-glue-api-jobs-runs-Predecessor) 객체의 배열입니다.

  이 작업을 실행하기 이전의 기록입니다.
+ `AllocatedCapacity` - 숫자(정수)입니다.

  이 필드는 더 이상 사용되지 않습니다. 대신 `MaxCapacity`을 사용하세요.

  이 JobRun에 할당된 AWS Glue 데이터 처리 장치(DPU) 수입니다. 2\$1100DPU가 할당될 수 있습니다. 기본값은 10입니다. DPU는 4 vCPU의 컴퓨팅 파워와 16GB 메모리로 구성된 프로세싱 파워의 상대적 측정값입니다. 자세한 내용은 [AWS Glue 요금](https://aws.amazon.com/glue/pricing/) 페이지를 참조하세요.
+ `ExecutionTime` - 숫자(정수)입니다.

  이 작업이 리소스를 소비한 시간(초).
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  `JobRun` 제한 시간(분)입니다. 작업을 실행하여 리소스를 소비하여 중지되기 전에 `TIMEOUT` 상태로 들어가는 최대 시간입니다. 이 값은 상위 작업에 설정된 제한 시간 값을 재정의합니다.

  작업의 시간 제한 값은 7일 또는 10,080분 미만이어야 합니다. 그렇지 않으면 작업에서 예외가 발생합니다.

  값을 비워 두면 제한 시간은 기본적으로 2,880분으로 설정됩니다.

  제한 시간 값이 7일을 초과하는 기존 AWS Glue 작업은 기본적으로 7일로 설정됩니다. 예를 들어 배치 작업에 20일의 제한 시간을 지정한 경우 7일째 되는 날에 작업이 중지됩니다.

  스트리밍 작업은 유지 관리 기간을 설정한 경우 7일 후 유지 관리 기간 중에 작업이 다시 시작됩니다.
+ `MaxCapacity` - 숫자(double)입니다.

  Glue 버전 1.0 이전 적업의 경우 표준 작업자 유형을 사용하여 이 작업을 실행할 때 할당할 수 있는 AWS Glue 데이터 처리 장치(DPU) 수입니다. DPU는 4 vCPU의 컴퓨팅 파워와 16GB 메모리로 구성된 프로세싱 파워의 상대적 측정값입니다. 자세한 내용은 [AWS Glue 요금](https://aws.amazon.com/glue/pricing/) 페이지를 참조하세요.

  Glue 버전 2.0 이상 작업의 경우 `Maximum capacity`를 지정할 수 없습니다. 그 대신 `Worker type` 및 `Number of workers`를 지정해야 합니다.

  `WorkerType` 및 `NumberOfWorkers`를 사용하는 경우, `MaxCapacity`를 설정하지 마세요.

  `MaxCapacity`에 할당할 수 있는 값은 Python 셸 작업을 실행하는지 또는 Apache Spark ETL 작업 또는 Apache Spark 스트리밍 ETL 작업을 실행하는지에 따라 다릅니다.
  + Python 셸 작업(`JobCommand.Name`="pythonshell")을 지정하면 0.0625 또는 1 DPU를 할당할 수 있습니다. 기본값은 0.0625 DPU입니다.
  + Apache Spark ETL 작업(`JobCommand.Name`="glueetl") 또는 Apache Spark 스트리밍 ETL 작업 (`JobCommand.Name`="gluestreaming") 을 지정하면 2에서 100 DPU를 할당할 수 있습니다. 기본값은 10 DPU입니다. 이 작업 유형에는 부분적인 DPU 할당을 사용할 수 없습니다.
+ `WorkerType` – UTF-8 문자열입니다(유효한 값: `Standard=""` \$1 `G.025X=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `G.12X=""` \$1 `G.16X=""` \$1 `R.1X=""` \$1 `R.2X=""` \$1 `R.4X=""` \$1 `R.8X=""` \$1 `Z.2X=""`).

  작업이 실행될 때 할당되는 미리 정의된 작업자 유형입니다. Spark 작업에 대해 G.025X, G.1X, G.2X, G.4X, G.8X, G.12X, G.16X, R.1X, R.2X, R.4X 또는 R.8X 값을 허용합니다. Ray 작업에 대해 Z.2X 값을 허용합니다.
  + `G.1X` 작업자 유형의 경우, 각 작업자가 94GB의 디스크가 있는 1DPU(4개의 vCPU, 16GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 대부분의 작업을 실행할 수 있는 확장 가능하고 비용 효율적인 방법을 제공하기 위해 데이터 변환, 조인, 쿼리와 같은 워크로드에서 이 작업자 유형을 사용하는 것이 좋습니다.
  + `G.2X` 작업자 유형의 경우, 각 작업자가 138GB의 디스크가 있는 2DPU(8개의 vCPU, 32GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 대부분의 작업을 실행할 수 있는 확장 가능하고 비용 효율적인 방법을 제공하기 위해 데이터 변환, 조인, 쿼리와 같은 워크로드에서 이 작업자 유형을 사용하는 것이 좋습니다.
  + `G.4X` 작업자 유형의 경우, 각 작업자가 256GB의 디스크가 있는 4DPU(16개의 vCPU, 64GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 워크로드에 가장 까다로운 변환, 집계, 조인 및 쿼리가 포함된 작업에서 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 미국 동부(오하이오), 미국 동부(버지니아 북부), 미국 서부(오레곤), 아시아 태평양(싱가포르), 아시아 태평양(시드니), 아시아 태평양(도쿄), 캐나다(중부), 유럽(프랑크푸르트), 유럽(아일랜드), 유럽(스톡홀름)과 같은AWS 리전에서 AWS Glue 버전 3.0 이상 Spark ETL 작업에 대해서만 사용할 수 있습니다.
  + `G.8X` 작업자 유형의 경우, 각 작업자가 512GB의 디스크가 있는 8DPU(32개의 vCPU, 128GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 워크로드에 가장 까다로운 변환, 집계, 조인 및 쿼리가 포함된 작업에서 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 `G.4X` 작업자 유형에 지원되는 동일한 AWS 리전에서 AWS Glue 버전 3.0 이상 Spark ETL 작업에 대해서만 사용할 수 있습니다.
  + `G.12X` 작업자 유형의 경우, 각 작업자가 768GB의 디스크가 있는 12DPU(48개의 vCPU, 192GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 워크로드가 매우 큰 작업에는 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `G.16X` 작업자 유형의 경우, 각 작업자가 1024GB의 디스크가 있는 16DPU(64개의 vCPU, 256GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 워크로드가 매우 큰 작업에는 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `G.025X` 작업자 유형의 경우, 각 작업자가 84GB의 디스크가 있는 0.25DPU(2개의 vCPU, 4GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 볼륨이 낮은 스트리밍 작업에 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 3.0 이상 스트리밍 작업에만 사용할 수 있습니다.
  + `R.1X` 작업자 유형의 경우, 각 작업자가 94GB의 디스크가 있는 1DPU(4개의 vCPU, 32GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 워크로드의 경우 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `R.2X` 작업자 유형의 경우, 각 작업자가 128GB의 디스크가 있는 2DPU(8개의 vCPU, 64GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 워크로드의 경우 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `R.4X` 작업자 유형의 경우, 각 작업자가 256GB의 디스크가 있는 4DPU(16개의 vCPU, 128GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 워크로드의 경우 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `R.8X` 작업자 유형의 경우, 각 작업자가 512GB의 디스크가 있는 8DPU(32개의 vCPU, 256GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 워크로드의 경우 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `Z.2X` 작업자 유형의 경우, 각 작업자는 128GB 디스크에서 2개의 M-DPU(vCPU 8개, 메모리 64GB)에 매핑되고, Autoscaler에 따라 최대 8개의 Ray 작업자를 제공합니다.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  작업이 실행될 때 할당되는 정의된 `workerType`의 작업자 수입니다.
+ `SecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업 실행에 사용할 `SecurityConfiguration` 구조의 이름입니다.
+ `LogGroupName` – UTF-8 문자열입니다.

  AWS KMS를 사용하여 Amazon CloudWatch에서 서버 측 암호화가 가능한 보안 로깅용 로그 그룹의 이름입니다. 이 이름은 `/aws-glue/jobs/`일 수 있으며, 그 기본 암호화는 `NONE`입니다. 역할 이름과 `SecurityConfiguration` 이름(즉, `/aws-glue/jobs-yourRoleName-yourSecurityConfigurationName/`)을 추가하면 로그 그룹 암호화에 이 보안 구성이 사용됩니다.
+ `NotificationProperty` – [NotificationProperty](#aws-glue-api-jobs-runs-NotificationProperty) 객체입니다.

  작업 실행 알림의 구성 속성을 지정합니다.
+ `GlueVersion` – [Custom string pattern #48](aws-glue-api-common.md#regex_48)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  Spark 작업에서 `GlueVersion`에 따라 AWS Glue에서 작업에 사용할 수 있는 Apache Spark 및 Python 버전이 결정됩니다. Python의 버전으로 Spark 유형의 작업에 대해 지원되는 버전을 확인할 수 있습니다.

  Ray 작업에서는 `GlueVersion`을 `4.0` 이상으로 설정해야 합니다. 그러나 Ray 작업에서 사용할 수 있는 Ray, Python 및 추가 라이브러리의 버전은 Job 명령의 `Runtime` 파라미터에 의해 결정됩니다.

  이용 가능한 AWS Glue 버전과 그에 상응하는 Spark 및 Python 버전에 대한 자세한 내용은 개발자 안내서의 [Glue 버전](https://docs.aws.amazon.com/glue/latest/dg/add-job.html)을 참조하세요.

  Glue 버전 지정 없이 생성된 작업은 Glue 0.9로 기본 지정됩니다.
+ `DPUSeconds` - 숫자(double)입니다.

  이 필드는 실행 클래스가 `FLEX`인 작업 실행이거나 Auto Scaling이 활성화된 경우에 설정할 수 있으며, 작업 실행 수명 주기 동안 각 실행기가 실행된 총 시간(초)에 DPU 계수(작업자는 1(`G.1X`), 2(`G.2X`) 또는 0.25(`G.025X`))를 곱한 값을 나타냅니다. 이 값은 Auto Scaling 작업의 경우처럼 `executionEngineRuntime` \$1 `MaxCapacity`와 다를 수 있습니다. 지정된 시간에 실행 중인 실행기 수가 `MaxCapacity`보다 작을 수 있기 때문입니다. 따라서, `DPUSeconds` 값이 `executionEngineRuntime` \$1 `MaxCapacity`보다 작을 수 있습니다.
+ `ExecutionClass` - 16바이트 미만의 UTF-8 문자열입니다(유효한 값: `FLEX=""` \$1 `STANDARD=""`).

  작업이 표준 또는 유연한 실행 클래스로 실행되는지 여부를 나타냅니다. 표준 실행 클래스는 빠른 작업 시작 및 전용 리소스가 필요한 시간에 민감한 워크로드에 적합합니다.

  유연한 실행 클래스는 시작 및 완료 시간이 다를 수 있는 시간에 민감하지 않은 작업에 적합합니다.

  AWS Glue 버전 3.0 이상 및 명령 유형 `glueetl`을 사용하는 작업만 `ExecutionClass`가 `FLEX`로 설정됩니다. 유연한 실행 클래스는 Spark 작업에 사용할 수 있습니다.
+ `MaintenanceWindow` – [Custom string pattern #34](aws-glue-api-common.md#regex_34)과(와) 일치하는 UTF-8 문자열입니다.

  이 필드는 스트리밍 작업에 대한 유지 관리 기간의 요일과 시간을 지정합니다. AWS Glue에서는 정기적으로 유지 관리 작업을 수행합니다. 이러한 유지 관리 기간 동안에는 AWS Glue에서 스트리밍 작업을 다시 시작해야 합니다.

  AWS Glue에서는 지정된 유지 관리 기간으로부터 3시간 이내에 작업을 다시 시작합니다. 예를 들어, 유지 관리 기간을 GMT 기준 월요일 오전 10시로 설정하면 작업이 GMT 기준 오전 10시에서 오후 1시 사이에 다시 시작됩니다.
+ `ProfileName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  작업 실행과 연결된 AWS Glue 사용 프로필의 이름입니다.
+ `StateDetail` – 400,000바이트 이하 길이의 UTF-8 문자열입니다.

  이 필드에는 작업 실행 상태와 관련된 세부 정보가 들어 있습니다. 이 필드는 null을 사용할 수 없습니다.

  예를 들어 작업 실행 큐의 결과로 작업 실행이 대기 상태인 경우 필드에는 작업 실행이 해당 상태인 이유가 표시됩니다.
+ `ExecutionRoleSessionPolicy` – UTF-8 문자열입니다(2\$12,048바이트).

  StartJobRun API에 대한 이 인라인 세션 정책을 사용하면 추가 IAM 역할을 생성할 필요 없이 작업 범위에 대해 지정된 실행 역할의 권한을 동적으로 제한할 수 있습니다.

## 이전 구조
<a name="aws-glue-api-jobs-runs-Predecessor"></a>

이 작업을 실행할 수 있도록 조건적 트리거를 조건으로 한 작업입니다.

**필드**
+ `JobName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 이전 작업에 사용된 작업 정의 이름입니다.
+ `RunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업의 이전 작업 실행 ID입니다.

## JobBookmarkEntry 구조
<a name="aws-glue-api-jobs-runs-JobBookmarkEntry"></a>

작업이 프로세싱을 다시 시작할 수 있는 포인트를 정의합니다.

**필드**
+ `JobName` – UTF-8 문자열입니다.

  문제의 작업 이름입니다.
+ `Version` - 숫자(정수)입니다.

  작업의 버전입니다.
+ `Run` - 숫자(정수)입니다.

  실행 ID 숫자입니다.
+ `Attempt` - 숫자(정수)입니다.

  시도 ID 숫자입니다.
+ `PreviousRunId` – UTF-8 문자열입니다.

  이전의 작업 실행과 연결된 고유의 실행 식별자입니다.
+ `RunId` – UTF-8 문자열입니다.

  실행 ID 숫자입니다.
+ `JobBookmark` – UTF-8 문자열입니다.

  그 자체를 즐겨찾습니다.

## BatchStopJobRunSuccessfulSubmission 구조
<a name="aws-glue-api-jobs-runs-BatchStopJobRunSuccessfulSubmission"></a>

지정된 `JobRun`을 중지한 성공적인 요청을 기록합니다.

**필드**
+ `JobName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업이 중지된 작업 정의 이름입니다.
+ `JobRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  중지된 작업 실행의 `JobRunId`입니다.

## BatchStopJobRunError 구조
<a name="aws-glue-api-jobs-runs-BatchStopJobRunError"></a>

지정된 작업을 중지하고자 할 때 발생하는 오류를 기록합니다.

**필드**
+ `JobName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  문제의 작업 실행에 사용된 작업 정의 이름입니다.
+ `JobRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  문제의 작업 실행 `JobRunId`입니다.
+ `ErrorDetail` – [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail) 객체입니다.

  발생한 오류에 대한 추가 세부 정보를 지정합니다.

## NotificationProperty 구조
<a name="aws-glue-api-jobs-runs-NotificationProperty"></a>

알림의 구성 속성을 지정합니다.

**필드**
+ `NotifyDelayAfter` – 1 이상의 숫자(정수)입니다.

  작업 실행 시작 후 작업 실행 대기 알림을 전송하기 전까지 대기하는 시간(분)입니다.

## 운영
<a name="aws-glue-api-jobs-runs-actions"></a>
+ [StartJobRun 작업(Python: start\$1job\$1run)](#aws-glue-api-jobs-runs-StartJobRun)
+ [BatchStopJobRun 작업(Python: batch\$1stop\$1job\$1run)](#aws-glue-api-jobs-runs-BatchStopJobRun)
+ [GetJobRun 작업(Python: get\$1job\$1run)](#aws-glue-api-jobs-runs-GetJobRun)
+ [GetJobRuns 작업(Python: get\$1job\$1runs)](#aws-glue-api-jobs-runs-GetJobRuns)
+ [GetJobBookmark 작업(Python: get\$1job\$1bookmark)](#aws-glue-api-jobs-runs-GetJobBookmark)
+ [GetJobBookmarks 작업(Python: get\$1job\$1bookmarks)](#aws-glue-api-jobs-runs-GetJobBookmarks)
+ [ResetJobBookmark 작업(Python: reset\$1job\$1bookmark)](#aws-glue-api-jobs-runs-ResetJobBookmark)

## StartJobRun 작업(Python: start\$1job\$1run)
<a name="aws-glue-api-jobs-runs-StartJobRun"></a>

작업 정의를 사용한 작업 시작하기

**요청**
+ `JobName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  사용할 작업 정의의 이름입니다.
+ `JobRunQueuingEnabled` – 부울입니다.

  해당 작업 실행에 대해 작업 실행 대기열을 활성화할지 여부를 지정합니다.

  값이 true이면 해당 작업 실행에 대해 작업 실행 큐가 활성화됩니다. false이거나 채워지지 않은 경우 작업 실행은 대기열에 포함되는 것으로 간주되지 않습니다.
+ `JobRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  재시도할 이전 `JobRun`의 ID입니다.
+ `Arguments` – 키-값 페어의 맵 배열입니다.

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

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

  작업과 연결되어 있는 작업 인수입니다. 이 작업 실행에서 작업 정의 자체에 설정된 기본 인수를 바꿉니다.

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

  작업 인수가 로깅될 수 있습니다. 일반 텍스트 보안 암호를 인수로 전달하지 마세요. 보안 암호를 작업 내에 보관하려는 경우 AWS Glue 연결, AWS Secrets Manager 또는 다른 보안 암호 관리 메커니즘에서 검색합니다.

  자체 작업 인수를 지정하고 사용하는 방법에 대한 자세한 내용은 개발자 가이드의 [Python에서 AWS Glue Glue API](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-python-calling.html) 호출을 참조하세요.

  Spark 작업을 구성할 때 이 필드에 제공할 수 있는 인수에 대한 자세한 내용은 개발자 안내서의 [AWS Glue에서 사용하는 특별 파라미터](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html) 주제를 참조하세요.

  Ray 작업을 구성할 때 이 필드에 제공할 수 있는 인수에 대한 자세한 내용은 개발자 안내서의 [Ray 작업에서 작업 파라미터 사용](https://docs.aws.amazon.com/glue/latest/dg/author-job-ray-job-parameters.html)을 참조하세요.
+ `AllocatedCapacity` - 숫자(정수)입니다.

  이 필드는 더 이상 사용되지 않습니다. 대신 `MaxCapacity`을 사용하세요.

  이 JobRun에 할당할 AWS Glue 데이터 처리 장치(DPU) 수입니다. 최소 2DPU를 할당할 수 있습니다. 기본값은 10입니다. DPU는 4 vCPU의 컴퓨팅 파워와 16GB 메모리로 구성된 프로세싱 파워의 상대적 측정값입니다. 자세한 내용은 [AWS Glue 요금](https://aws.amazon.com/glue/pricing/) 페이지를 참조하세요.
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  `JobRun` 제한 시간(분)입니다. 작업을 실행하여 리소스를 소비하여 중지되기 전에 `TIMEOUT` 상태로 들어가는 최대 시간입니다. 이 값은 상위 작업에 설정된 제한 시간 값을 재정의합니다.

  작업의 시간 제한 값은 7일 또는 10,080분 미만이어야 합니다. 그렇지 않으면 작업에서 예외가 발생합니다.

  값을 비워 두면 제한 시간은 기본적으로 2,880분으로 설정됩니다.

  제한 시간 값이 7일을 초과하는 기존 AWS Glue 작업은 기본적으로 7일로 설정됩니다. 예를 들어 배치 작업에 20일의 제한 시간을 지정한 경우 7일째 되는 날에 작업이 중지됩니다.

  스트리밍 작업은 유지 관리 기간을 설정한 경우 7일 후 유지 관리 기간 중에 작업이 다시 시작됩니다.
+ `MaxCapacity` - 숫자(double)입니다.

  Glue 버전 1.0 이전 적업의 경우 표준 작업자 유형을 사용하여 이 작업을 실행할 때 할당할 수 있는 AWS Glue 데이터 처리 장치(DPU) 수입니다. DPU는 4 vCPU의 컴퓨팅 파워와 16GB 메모리로 구성된 프로세싱 파워의 상대적 측정값입니다. 자세한 내용은 [AWS Glue 요금](https://aws.amazon.com/glue/pricing/) 페이지를 참조하세요.

  Glue 버전 2.0 이상 작업의 경우 `Maximum capacity`를 지정할 수 없습니다. 그 대신 `Worker type` 및 `Number of workers`를 지정해야 합니다.

  `WorkerType` 및 `NumberOfWorkers`를 사용하는 경우, `MaxCapacity`를 설정하지 마세요.

  `MaxCapacity`에 할당할 수 있는 값은 Python 셸 작업을 실행하는지 또는 Apache Spark ETL 작업 또는 Apache Spark 스트리밍 ETL 작업을 실행하는지에 따라 다릅니다.
  + Python 셸 작업(`JobCommand.Name`="pythonshell")을 지정하면 0.0625 또는 1 DPU를 할당할 수 있습니다. 기본값은 0.0625 DPU입니다.
  + Apache Spark ETL 작업(`JobCommand.Name`="glueetl") 또는 Apache Spark 스트리밍 ETL 작업 (`JobCommand.Name`="gluestreaming") 을 지정하면 2에서 100 DPU를 할당할 수 있습니다. 기본값은 10 DPU입니다. 이 작업 유형에는 부분적인 DPU 할당을 사용할 수 없습니다.
+ `SecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업 실행에 사용할 `SecurityConfiguration` 구조의 이름입니다.
+ `NotificationProperty` – [NotificationProperty](#aws-glue-api-jobs-runs-NotificationProperty) 객체입니다.

  작업 실행 알림의 구성 속성을 지정합니다.
+ `WorkerType` – UTF-8 문자열입니다(유효한 값: `Standard=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `Z.2X=""`).

  작업이 실행될 때 할당되는 미리 정의된 작업자 유형입니다. Spark 작업에 대해 G.1X, G.2X, G.4X, G.8X 또는 G.025X의 값을 허용합니다. Ray 작업에 대해 Z.2X 값을 허용합니다.
  + `G.1X` 작업자 유형의 경우, 각 작업자가 94GB의 디스크가 있는 1DPU(4개의 vCPU, 16GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 대부분의 작업을 실행할 수 있는 확장 가능하고 비용 효율적인 방법을 제공하기 위해 데이터 변환, 조인, 쿼리와 같은 워크로드에서 이 작업자 유형을 사용하는 것이 좋습니다.
  + `G.2X` 작업자 유형의 경우, 각 작업자가 138GB의 디스크가 있는 2DPU(8개의 vCPU, 32GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 대부분의 작업을 실행할 수 있는 확장 가능하고 비용 효율적인 방법을 제공하기 위해 데이터 변환, 조인, 쿼리와 같은 워크로드에서 이 작업자 유형을 사용하는 것이 좋습니다.
  + `G.4X` 작업자 유형의 경우, 각 작업자가 256GB의 디스크가 있는 4DPU(16개의 vCPU, 64GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 워크로드에 가장 까다로운 변환, 집계, 조인 및 쿼리가 포함된 작업에서 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 미국 동부(오하이오), 미국 동부(버지니아 북부), 미국 서부(오레곤), 아시아 태평양(싱가포르), 아시아 태평양(시드니), 아시아 태평양(도쿄), 캐나다(중부), 유럽(프랑크푸르트), 유럽(아일랜드), 유럽(스톡홀름)과 같은AWS 리전에서 AWS Glue 버전 3.0 이상 Spark ETL 작업에 대해서만 사용할 수 있습니다.
  + `G.8X` 작업자 유형의 경우, 각 작업자가 512GB의 디스크가 있는 8DPU(32개의 vCPU, 128GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 워크로드에 가장 까다로운 변환, 집계, 조인 및 쿼리가 포함된 작업에서 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 `G.4X` 작업자 유형에 지원되는 동일한 AWS 리전에서 AWS Glue 버전 3.0 이상 Spark ETL 작업에 대해서만 사용할 수 있습니다.
  + `G.12X` 작업자 유형의 경우, 각 작업자가 768GB의 디스크가 있는 12DPU(48개의 vCPU, 192GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 워크로드가 매우 큰 작업에는 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `G.16X` 작업자 유형의 경우, 각 작업자가 1024GB의 디스크가 있는 16DPU(64개의 vCPU, 256GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 워크로드가 매우 큰 작업에는 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `G.025X` 작업자 유형의 경우, 각 작업자가 84GB의 디스크가 있는 0.25DPU(2개의 vCPU, 4GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 볼륨이 낮은 스트리밍 작업에 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 3.0 이상 스트리밍 작업에만 사용할 수 있습니다.
  + `R.1X` 작업자 유형의 경우, 각 작업자가 94GB의 디스크가 있는 1DPU(4개의 vCPU, 32GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 워크로드의 경우 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `R.2X` 작업자 유형의 경우, 각 작업자가 128GB의 디스크가 있는 2DPU(8개의 vCPU, 64GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 워크로드의 경우 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `R.4X` 작업자 유형의 경우, 각 작업자가 256GB의 디스크가 있는 4DPU(16개의 vCPU, 128GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 워크로드의 경우 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `R.8X` 작업자 유형의 경우, 각 작업자가 512GB의 디스크가 있는 8DPU(32개의 vCPU, 256GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 워크로드의 경우 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `Z.2X` 작업자 유형의 경우, 각 작업자는 128GB 디스크에서 2개의 M-DPU(vCPU 8개, 메모리 64GB)에 매핑되고, Autoscaler에 따라 최대 8개의 Ray 작업자를 제공합니다.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  작업이 실행될 때 할당되는 정의된 `workerType`의 작업자 수입니다.
+ `ExecutionClass` - 16바이트 미만의 UTF-8 문자열입니다(유효한 값: `FLEX=""` \$1 `STANDARD=""`).

  작업이 표준 또는 유연한 실행 클래스로 실행되는지 여부를 나타냅니다. 표준 실행 클래스는 빠른 작업 시작 및 전용 리소스가 필요한 시간에 민감한 워크로드에 적합합니다.

  유연한 실행 클래스는 시작 및 완료 시간이 다를 수 있는 시간에 민감하지 않은 작업에 적합합니다.

  AWS Glue 버전 3.0 이상 및 명령 유형 `glueetl`을 사용하는 작업만 `ExecutionClass`가 `FLEX`로 설정됩니다. 유연한 실행 클래스는 Spark 작업에 사용할 수 있습니다.
+ `ProfileName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  작업 실행과 연결된 AWS Glue 사용 프로필의 이름입니다.
+ `ExecutionRoleSessionPolicy` – UTF-8 문자열입니다(2\$12,048바이트).

  StartJobRun API에 대한 이 인라인 세션 정책을 사용하면 추가 IAM 역할을 생성할 필요 없이 작업 범위에 대해 지정된 실행 역할의 권한을 동적으로 제한할 수 있습니다.

**응답**
+ `JobRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업 실행에 할당된 ID.

**오류**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `ConcurrentRunsExceededException`

## BatchStopJobRun 작업(Python: batch\$1stop\$1job\$1run)
<a name="aws-glue-api-jobs-runs-BatchStopJobRun"></a>

지정된 작업을 정의하기 위해서 하나 이상의 작업을 중지합니다.

**요청**
+ `JobName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  작업이 실행되지 않고 중지하기 위한 작업 정의 이름입니다.
+ `JobRunIds` – *필수(Required):* 1\$125개 문자열의 UTF-8 문자열의 배열입니다.

  이 작업을 정의하기 위해서 중지되어야 하는 `JobRunIds`의 목록입니다.

**응답**
+ `SuccessfulSubmissions` – [BatchStopJobRunSuccessfulSubmission](#aws-glue-api-jobs-runs-BatchStopJobRunSuccessfulSubmission) 객체의 배열입니다.

  중지할 목적으로 성공적으로 제출된 JobRun입니다.
+ `Errors` – [BatchStopJobRunError](#aws-glue-api-jobs-runs-BatchStopJobRunError) 객체의 배열입니다.

  `JobRuns`를 중지할 때 발생하는 오류 목록은 오류에 대한 상세 정보와 함께 각 오류가 발생한 `JobRunId`를 포함합니다.

**오류**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetJobRun 작업(Python: get\$1job\$1run)
<a name="aws-glue-api-jobs-runs-GetJobRun"></a>

작업 실행 시 메타데이터 가져오기 워크플로 및 작업 실행의 경우 작업 실행 기록을 365일 동안 액세스할 수 있습니다.

**요청**
+ `JobName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  실행 중인 작업 정의의 이름입니다.
+ `RunId` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업 실행의 ID.
+ `PredecessorsIncluded` – 부울입니다.

  이전 작업 실행 목록이 반환되어야 하면 True입니다.

**응답**
+ `JobRun` – [JobRun](#aws-glue-api-jobs-runs-JobRun) 객체입니다.

  요청한 작업 실행 메타데이터.

**오류**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetJobRuns 작업(Python: get\$1job\$1runs)
<a name="aws-glue-api-jobs-runs-GetJobRuns"></a>

주어진 작업 정의의 모든 실행 시 메타데이터 가져오기

`GetJobRuns`는 작업 실행을 시간순으로 반환합니다. 이때 최신 작업을 먼저 반환합니다.

**요청**
+ `JobName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  모든 작업을 실행하기 위한 작업 정의 이름입니다.
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰입니다.
+ `MaxResults` - 1 이상 200 이하의 숫자(정수)입니다.

  응답의 최대 크기입니다.

**응답**
+ `JobRuns` – [JobRun](#aws-glue-api-jobs-runs-JobRun) 객체의 배열입니다.

  작업 실행 메타데이터 객체의 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.

  요청된 모든 작업 실행이 반환하지 않은 경우의 지속 토큰입니다.

**오류**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetJobBookmark 작업(Python: get\$1job\$1bookmark)
<a name="aws-glue-api-jobs-runs-GetJobBookmark"></a>

작업 북마크 항목에 대한 정보를 반환합니다.

작업 북마크에 대한 자세한 내용을 알아보려면 다음을 참조하세요.
+ [처리된 데이터를 작업 북마크로 추적](https://docs.aws.amazon.com/glue/latest/dg/monitor-continuations.html)
+ [AWS Glue에서 사용하는 작업 파라미터](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html)
+ [작업 구조](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-jobs-job.html#aws-glue-api-jobs-job-Job)

**요청**
+ `JobName` – *필수(Required):* UTF-8 문자열입니다.

  문제의 작업 이름입니다.
+ `Version` - 숫자(정수)입니다.

  작업의 버전입니다.
+ `RunId` – UTF-8 문자열입니다.

  이 작업 실행과 연결된 고유의 실행 식별자입니다.

**응답**
+ `JobBookmarkEntry` – [JobBookmarkEntry](#aws-glue-api-jobs-runs-JobBookmarkEntry) 객체입니다.

  작업이 처리를 다시 시작할 수 있는 포인트를 정의하는 구조입니다.

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ValidationException`

## GetJobBookmarks 작업(Python: get\$1job\$1bookmarks)
<a name="aws-glue-api-jobs-runs-GetJobBookmarks"></a>

작업 북마크 항목에 대한 정보를 반환합니다. 목록은 버전 번호가 감소되는 순서로 정렬됩니다.

작업 북마크에 대한 자세한 내용을 알아보려면 다음을 참조하세요.
+ [처리된 데이터를 작업 북마크로 추적](https://docs.aws.amazon.com/glue/latest/dg/monitor-continuations.html)
+ [AWS Glue에서 사용하는 작업 파라미터](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html)
+ [작업 구조](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-jobs-job.html#aws-glue-api-jobs-job-Job)

**요청**
+ `JobName` – *필수(Required):* UTF-8 문자열입니다.

  문제의 작업 이름입니다.
+ `MaxResults` - 숫자(정수)입니다.

  응답의 최대 크기입니다.
+ `NextToken` - 숫자(정수)입니다.

  이것이 지속적으로 호출되면 지속적인 토큰입니다.

**응답**
+ `JobBookmarkEntries` – [JobBookmarkEntry](#aws-glue-api-jobs-runs-JobBookmarkEntry) 객체의 배열입니다.

  작업이 처리를 다시 시작할 수 있는 포인트를 정의하는 작업 북마크 항목의 목록입니다.
+ `NextToken` - 숫자(정수)입니다.

  모든 항목이 반환된 경우에는 1, 요청된 작업 실행 중 일부가 반환되지 않은 경우 1보다 큰 값이 있는 연속 토큰입니다.

**오류**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## ResetJobBookmark 작업(Python: reset\$1job\$1bookmark)
<a name="aws-glue-api-jobs-runs-ResetJobBookmark"></a>

북마크 입력 재설정

작업 북마크에 대한 자세한 내용을 알아보려면 다음을 참조하세요.
+ [처리된 데이터를 작업 북마크로 추적](https://docs.aws.amazon.com/glue/latest/dg/monitor-continuations.html)
+ [AWS Glue에서 사용하는 작업 파라미터](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html)
+ [작업 구조](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-jobs-job.html#aws-glue-api-jobs-job-Job)

**요청**
+ `JobName` – *필수(Required):* UTF-8 문자열입니다.

  문제의 작업 이름입니다.
+ `RunId` – UTF-8 문자열입니다.

  이 작업 실행과 연결된 고유의 실행 식별자입니다.

**응답**
+ `JobBookmarkEntry` – [JobBookmarkEntry](#aws-glue-api-jobs-runs-JobBookmarkEntry) 객체입니다.

  북마크 입력 재설정

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

# 트리거
<a name="aws-glue-api-jobs-trigger"></a>

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

## 데이터 타입
<a name="aws-glue-api-jobs-trigger-objects"></a>
+ [트리거 구조](#aws-glue-api-jobs-trigger-Trigger)
+ [TriggerUpdate 구조](#aws-glue-api-jobs-trigger-TriggerUpdate)
+ [조건자 구조](#aws-glue-api-jobs-trigger-Predicate)
+ [조건 구조](#aws-glue-api-jobs-trigger-Condition)
+ [작업 구조](#aws-glue-api-jobs-trigger-Action)
+ [EventBatchingCondition 구조](#aws-glue-api-jobs-trigger-EventBatchingCondition)

## 트리거 구조
<a name="aws-glue-api-jobs-trigger-Trigger"></a>

특정 트리거에 대한 정보

**필드**
+ `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  트리거의 이름입니다.
+ `WorkflowName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  트리거와 연결된 워크플로의 이름입니다.
+ `Id` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

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

  트리거 현재 테이블 상태
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

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

  일정을 지정하는 데 사용되는 `cron` 표현식입니다([작업 및 크롤러의 시간 기반 일정](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html) 참조). 예를 들어, 매일 오후 12시 15분(UTC)에 실행하려면 `cron(15 12 * * ? *)`을 지정합니다.
+ `Actions` – [작업](#aws-glue-api-jobs-trigger-Action) 객체의 배열입니다.

  이 트리거에 의해 시작되는 작업
+ `Predicate` – [조건자](#aws-glue-api-jobs-trigger-Predicate) 객체입니다.

  트리거가 실행되는 시기를 결정하는 이 트리거의 조건자입니다.
+ `EventBatchingCondition` – [EventBatchingCondition](#aws-glue-api-jobs-trigger-EventBatchingCondition) 객체입니다.

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

## TriggerUpdate 구조
<a name="aws-glue-api-jobs-trigger-TriggerUpdate"></a>

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

**필드**
+ `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  추후 사용 예약.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

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

  일정을 지정하는 데 사용되는 `cron` 표현식입니다([작업 및 크롤러의 시간 기반 일정](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html) 참조). 예를 들어, 매일 오후 12시 15분(UTC)에 실행하려면 `cron(15 12 * * ? *)`을 지정합니다.
+ `Actions` – [작업](#aws-glue-api-jobs-trigger-Action) 객체의 배열입니다.

  이 트리거에 의해 시작되는 작업
+ `Predicate` – [조건자](#aws-glue-api-jobs-trigger-Predicate) 객체입니다.

  트리거가 실행되는 시기를 결정하는 이 트리거의 조건자입니다.
+ `EventBatchingCondition` – [EventBatchingCondition](#aws-glue-api-jobs-trigger-EventBatchingCondition) 객체입니다.

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

## 조건자 구조
<a name="aws-glue-api-jobs-trigger-Predicate"></a>

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

**필드**
+ `Logical` – UTF-8 문자열입니다(유효한 값: `AND` \$1 `ANY`).

  오직 하나의 조건이 기록되어 있다면 조건부 필드입니다. 다수의 조건이 있을 때 이 필드가 필요합니다.
+ `Conditions` – [Condition](#aws-glue-api-jobs-trigger-Condition) 객체의 배열이며 구조는 500개 이하입니다.

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

## 조건 구조
<a name="aws-glue-api-jobs-trigger-Condition"></a>

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

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

  논리 연산자
+ `JobName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

  조건 상태입니다. 현재 트리거가 수신할 수 있는 유일한 작업은 `SUCCEEDED`, `STOPPED`, `FAILED` 및 `TIMEOUT`입니다. 트리거가 수신할 수 있는 유일한 Crawler는 `SUCCEEDED`, `FAILED` 및 `CANCELLED`입니다.
+ `CrawlerName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

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

## 작업 구조
<a name="aws-glue-api-jobs-trigger-Action"></a>

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

**필드**
+ `JobName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

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

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

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

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

  자체 작업 인수를 지정하고 사용하는 방법에 대한 자세한 내용은 개발자 가이드의 [Python에서 AWS Glue Glue API](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-python-calling.html) 호출을 참조하세요.

  AWS Glue가 작업을 설정하는 데 사용하는 키 값 페어에 대한 자세한 내용은 개발자 가이드의 [AWS Glue가 사용하는 특정 파라미터](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html)를 참조하세요.
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  `JobRun` 제한 시간(분)입니다. 작업을 실행하여 리소스를 소비하여 중지되기 전에 `TIMEOUT` 상태로 들어가는 최대 시간입니다. 상위 작업에 설정된 제한 시간 값을 재정의합니다.

  작업의 시간 제한 값은 7일 또는 10,080분 미만이어야 합니다. 그렇지 않으면 작업에서 예외가 발생합니다.

  값을 비워 두면 제한 시간은 기본적으로 2,880분으로 설정됩니다.

  제한 시간 값이 7일을 초과하는 기존 AWS Glue 작업은 기본적으로 7일로 설정됩니다. 예를 들어 배치 작업에 20일의 제한 시간을 지정한 경우 7일째 되는 날에 작업이 중지됩니다.

  스트리밍 작업은 유지 관리 기간을 설정한 경우 7일 후 유지 관리 기간 중에 작업이 다시 시작됩니다.
+ `SecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업에 사용할 `SecurityConfiguration` 구조의 이름입니다.
+ `NotificationProperty` – [NotificationProperty](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-NotificationProperty) 객체입니다.

  작업 실행 알림의 구성 속성을 지정합니다.
+ `CrawlerName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

## EventBatchingCondition 구조
<a name="aws-glue-api-jobs-trigger-EventBatchingCondition"></a>

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

**필드**
+ `BatchSize` – *필수(Required):* 1\$1100의 숫자(정수)입니다.

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

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

## 운영
<a name="aws-glue-api-jobs-trigger-actions"></a>
+ [CreateTrigger 작업(Python: create\$1trigger)](#aws-glue-api-jobs-trigger-CreateTrigger)
+ [StartTrigger 작업(Python: start\$1trigger)](#aws-glue-api-jobs-trigger-StartTrigger)
+ [GetTrigger 작업(Python: get\$1trigger)](#aws-glue-api-jobs-trigger-GetTrigger)
+ [GetTrigger 작업(Python: get\$1triggers)](#aws-glue-api-jobs-trigger-GetTriggers)
+ [UpdateTrigger 작업(Python: update\$1trigger)](#aws-glue-api-jobs-trigger-UpdateTrigger)
+ [StopTrigger 작업(Python: stop\$1trigger)](#aws-glue-api-jobs-trigger-StopTrigger)
+ [DeleteTrigger 작업(Python: delete\$1trigger)](#aws-glue-api-jobs-trigger-DeleteTrigger)
+ [ListTriggers 작업(Python: list\$1triggers)](#aws-glue-api-jobs-trigger-ListTriggers)
+ [BatchGetTriggers 작업(Python: batch\$1get\$1triggers)](#aws-glue-api-jobs-trigger-BatchGetTriggers)

## CreateTrigger 작업(Python: create\$1trigger)
<a name="aws-glue-api-jobs-trigger-CreateTrigger"></a>

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

작업 인수가 로깅될 수 있습니다. 일반 텍스트 보안 암호를 인수로 전달하지 마세요. 보안 암호를 작업 내에 보관하려는 경우 AWS Glue 연결, AWS Secrets Manager 또는 다른 보안 암호 관리 메커니즘에서 검색합니다.

**요청**
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  트리거의 이름입니다.
+ `WorkflowName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

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

  일정을 지정하는 데 사용되는 `cron` 표현식입니다([작업 및 크롤러의 시간 기반 일정](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html) 참조). 예를 들어, 매일 오후 12시 15분(UTC)에 실행하려면 `cron(15 12 * * ? *)`을 지정합니다.

  트리거 유형이 SCHEDULED(예정)되면 필드가 필요합니다.
+ `Predicate` – [조건자](#aws-glue-api-jobs-trigger-Predicate) 객체입니다.

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

  트리거 유형이 `CONDITIONAL`이면 이 필드는 필수입니다.
+ `Actions` – *필수(Required):* [작업](#aws-glue-api-jobs-trigger-Action) 객체의 배열입니다.

  트리거가 발생하면 이 트리거가 시작되는 작업입니다.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

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

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

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

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

  이 트리거에서 사용할 태그입니다. 태그를 사용하여 트리거에 대한 액세스를 제한할 수 있습니다. AWS Glue의 태그에 대한 자세한 내용은 개발자 안내서의 [AWS Glue의 AWS 태그](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html)를 참조하세요.
+ `EventBatchingCondition` – [EventBatchingCondition](#aws-glue-api-jobs-trigger-EventBatchingCondition) 객체입니다.

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

**응답**
+ `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  트리거의 이름입니다.

**오류**
+ `AlreadyExistsException`
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `IdempotentParameterMismatchException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `ConcurrentModificationException`

## StartTrigger 작업(Python: start\$1trigger)
<a name="aws-glue-api-jobs-trigger-StartTrigger"></a>

기존 트리거 시작. 다른 유형의 트리거가 시작하는 방법에 대한 자세한 내용은 [작업 트리거](https://docs.aws.amazon.com/glue/latest/dg/trigger-job.html)를 참조하십시오.

**요청**
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

**응답**
+ `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

**오류**
+ `InvalidInputException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `ConcurrentRunsExceededException`

## GetTrigger 작업(Python: get\$1trigger)
<a name="aws-glue-api-jobs-trigger-GetTrigger"></a>

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

**요청**
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

**응답**
+ `Trigger` – [트리거](#aws-glue-api-jobs-trigger-Trigger) 객체입니다.

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

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetTrigger 작업(Python: get\$1triggers)
<a name="aws-glue-api-jobs-trigger-GetTriggers"></a>

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

**요청**
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰입니다.
+ `DependentJobName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

  응답의 최대 크기입니다.

**응답**
+ `Triggers` – [트리거](#aws-glue-api-jobs-trigger-Trigger) 객체의 배열입니다.

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

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

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## UpdateTrigger 작업(Python: update\$1trigger)
<a name="aws-glue-api-jobs-trigger-UpdateTrigger"></a>

트리거 정의 업데이트

작업 인수가 로깅될 수 있습니다. 일반 텍스트 보안 암호를 인수로 전달하지 마세요. 보안 암호를 작업 내에 보관하려는 경우 AWS Glue 연결, AWS Secrets Manager 또는 다른 보안 암호 관리 메커니즘에서 검색합니다.

**요청**
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  업데이트할 트리거의 이름입니다.
+ `TriggerUpdate` – *필수(Required):* [TriggerUpdate](#aws-glue-api-jobs-trigger-TriggerUpdate) 객체입니다.

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

**응답**
+ `Trigger` – [트리거](#aws-glue-api-jobs-trigger-Trigger) 객체입니다.

  결과 트리거 정의입니다.

**오류**
+ `InvalidInputException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `ConcurrentModificationException`

## StopTrigger 작업(Python: stop\$1trigger)
<a name="aws-glue-api-jobs-trigger-StopTrigger"></a>

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

**요청**
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

**응답**
+ `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

**오류**
+ `InvalidInputException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `ConcurrentModificationException`

## DeleteTrigger 작업(Python: delete\$1trigger)
<a name="aws-glue-api-jobs-trigger-DeleteTrigger"></a>

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

**요청**
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

**응답**
+ `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

**오류**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ConcurrentModificationException`

## ListTriggers 작업(Python: list\$1triggers)
<a name="aws-glue-api-jobs-trigger-ListTriggers"></a>

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

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

**요청**
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적인 요청이라면 지속적인 토큰입니다.
+ `DependentJobName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

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

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

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

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

**응답**
+ `TriggerNames` – UTF-8 문자열의 배열입니다.

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

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

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## BatchGetTriggers 작업(Python: batch\$1get\$1triggers)
<a name="aws-glue-api-jobs-trigger-BatchGetTriggers"></a>

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

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

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

**응답**
+ `Triggers` – [트리거](#aws-glue-api-jobs-trigger-Trigger) 객체의 배열입니다.

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

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

**오류**
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`