# 워크플로 워크플로 API는 AWS Glue에서의 워크플로 생성, 업데이트 또는 확인과 관련된 API 및 데이터 유형에 대해 설명합니다. 워크플로 및 작업 실행의 경우 작업 실행 기록을 90일 동안 액세스할 수 있습니다. ## 데이터 타입 + [JobNodeDetails 구조](#aws-glue-api-workflow-JobNodeDetails) + [CrawlerNodeDetails 구조](#aws-glue-api-workflow-CrawlerNodeDetails) + [TriggerNodeDetails 구조](#aws-glue-api-workflow-TriggerNodeDetails) + [크롤 구조](#aws-glue-api-workflow-Crawl) + [노드 구조](#aws-glue-api-workflow-Node) + [엣지 구조](#aws-glue-api-workflow-Edge) + [워크플루 구조](#aws-glue-api-workflow-Workflow) + [WorkflowGraph 구조](#aws-glue-api-workflow-WorkflowGraph) + [WorkflowRun 구조](#aws-glue-api-workflow-WorkflowRun) + [WorkflowRunStatistics 구조](#aws-glue-api-workflow-WorkflowRunStatistics) + [StartingEventBatchCondition 구조](#aws-glue-api-workflow-StartingEventBatchCondition) + [블루프린트 구조](#aws-glue-api-workflow-Blueprint) + [BlueprintDetails 구조](#aws-glue-api-workflow-BlueprintDetails) + [LastActiveDefinition 구조](#aws-glue-api-workflow-LastActiveDefinition) + [BlueprintRun 구조](#aws-glue-api-workflow-BlueprintRun) ## JobNodeDetails 구조 워크플로에 있는 작업 노드의 세부 정보입니다. **필드** + `JobRuns` – [JobRun](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-JobRun) 객체의 배열입니다. 작업 노드가 나타내는 작업 실행에 대한 정보입니다. ## CrawlerNodeDetails 구조 워크플로에 있는 크롤러 노드의 세부 정보입니다. **필드** + `Crawls` – [Crawl](#aws-glue-api-workflow-Crawl) 객체의 배열입니다. 크롤 노드가 나타내는 크롤의 목록입니다. ## TriggerNodeDetails 구조 워크플로에 있는 트리거 노드의 세부 정보입니다. **필드** + `Trigger` – [트리거](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-Trigger) 객체입니다. 트리거 노드가 나타내는 트리거의 정보입니다. ## 크롤 구조 워크플로에 있는 크롤의 세부 정보입니다. **필드** + `State` – UTF-8 문자열입니다(유효 값: `RUNNING` \$1 `CANCELLING` \$1 `CANCELLED` \$1 `SUCCEEDED` \$1 `FAILED` \$1 `ERROR`). 크롤러의 상태입니다. + `StartedOn` – 타임스탬프입니다. 크롤이 시작된 날짜와 시간입니다. + `CompletedOn` – 타임스탬프입니다. 크롤이 완료된 날짜와 시간입니다. + `ErrorMessage` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다. 크롤과 연결된 오류 메시지입니다. + `LogGroup` – [Log group string pattern](aws-glue-api-common.md#aws-glue-api-regex-logGroup-id)과(와) 일치하는 1\$1512바이트 길이의 UTF-8 문자열입니다. 크롤과 연결된 로그 그룹입니다. + `LogStream` – [Log-stream string pattern](aws-glue-api-common.md#aws-glue-api-regex-logStream-id)과(와) 일치하는 1\$1512바이트 길이의 UTF-8 문자열입니다. 크롤과 연결된 로그 스트림입니다. ## 노드 구조 노드는 워크플로 그래프에서 AWS Glue 구성 요소(트리거, 크롤러 또는 작업)를 나타냅니다. **필드** + `Type` – UTF-8 문자열입니다(유효한 값: `CRAWLER` \$1 `JOB` \$1 `TRIGGER`). 노드가 나타내는 AWS Glue 구성 요소의 유형입니다. + `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 노드가 나타내는 AWS Glue 구성 요소의 이름입니다. + `UniqueId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 워크플로 내의 노드에 할당된 고유 ID입니다. + `TriggerDetails` – [TriggerNodeDetails](#aws-glue-api-workflow-TriggerNodeDetails) 객체입니다. 노드가 트리거를 나타낼 때 트리거의 세부 정보입니다. + `JobDetails` – [JobNodeDetails](#aws-glue-api-workflow-JobNodeDetails) 객체입니다. 노드가 작업을 나타낼 때 작업의 세부 정보입니다. + `CrawlerDetails` – [CrawlerNodeDetails](#aws-glue-api-workflow-CrawlerNodeDetails) 객체입니다. 노드가 크롤러를 나타낼 때 크롤러의 세부 정보입니다. ## 엣지 구조 엣지는 엣지가 속한 워크플로의 일부인 두 개의 AWS Glue 구성 요소 간에 방향이 있는 연결을 나타냅니다. **필드** + `SourceId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 엣지가 시작되는 워크플로 내 노드의 고유 ID입니다. + `DestinationId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 엣지가 종료되는 워크플로 내 노드의 고유 ID입니다. ## 워크플루 구조 워크플로는 복잡한 ETL 태스크를 완료하기 위해 실행되는 여러 종속 AWS Glue 작업 및 크롤러의 모음입니다. 워크플로는 모든 작업 및 크롤러의 실행 및 모니터링을 관리합니다. **필드** + `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 워크플로의 이름입니다. + `Description` – UTF-8 문자열입니다. 워크플로에 대한 설명입니다. + `DefaultRunProperties` – 키-값 페어의 맵 배열입니다. 각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 UTF-8 문자열입니다. 각 값은 UTF-8 문자열입니다. 워크플로의 각 실행의 일부로 사용할 속성 모음입니다. 실행 속성은 워크플로의 각 작업에서 사용할 수 있습니다. 작업은 흐름의 다음 작업에 대한 속성을 수정할 수 있습니다. + `CreatedOn` – 타임스탬프입니다. 워크플로가 생성된 날짜와 시간입니다. + `LastModifiedOn` – 타임스탬프입니다. 워크플로가 마지막으로 수정된 날짜와 시간입니다. + `LastRun` – [WorkflowRun](#aws-glue-api-workflow-WorkflowRun) 객체입니다. 워크플로의 마지막 실행에 대한 정보입니다. + `Graph` – [WorkflowGraph](#aws-glue-api-workflow-WorkflowGraph) 객체입니다. 워크플로에 속하는 모든 AWS Glue 구성 요소를 이들 간의 방향 있는 연결과 노드를 엣지로 나타내는 그래프입니다. + `CreationStatus` – UTF-8 문자열입니다(유효 값: `CREATING` \$1 `CREATED` \$1 `CREATION_FAILED`). 워크플로의 생성 상태입니다. + `MaxConcurrentRuns` - 숫자(정수)입니다. 이 파라미터를 사용하여 데이터에 대한 원치 않는 다중 업데이트를 방지하거나 비용을 제어하거나 경우에 따라 구성 요소 작업의 최대 동시 실행 수를 초과하는 것을 방지할 수 있습니다. 이 파라미터를 공백으로 두면 동시 워크플로 실행 수에 제한이 없습니다. + `BlueprintDetails` – [BlueprintDetails](#aws-glue-api-workflow-BlueprintDetails) 객체입니다. 이 구조는 이 특정 워크플로가 생성된 블루프린트의 세부 정보를 나타냅니다. ## WorkflowGraph 구조 워크플로 그래프는 워크플로에 있는 모든 AWS Glue 구성 요소와 그 사이의 모든 방향 있는 연결이 포함된 완전한 워크플로를 나타냅니다. **필드** + `Nodes` – [노드](#aws-glue-api-workflow-Node) 객체의 배열입니다. 노드로 나타내는 워크플로에 속한 AWS Glue 구성 요소의 목록입니다. + `Edges` – [Edge](#aws-glue-api-workflow-Edge) 객체의 배열입니다. 워크플로에 속한 노드 간의 모든 방향 있는 연결의 목록입니다. ## WorkflowRun 구조 워크플로 실행은 모든 실행 시간 정보를 제공하는 워크플로의 실행입니다. **필드** + `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 실행된 워크플로의 이름입니다. + `WorkflowRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 이 워크플로 실행의 ID입니다. + `PreviousRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 이전 워크플로 실행의 ID입니다. + `WorkflowRunProperties` – 키-값 페어의 맵 배열입니다. 각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 UTF-8 문자열입니다. 각 값은 UTF-8 문자열입니다. 실행 중에 설정된 워크플로 실행 속성입니다. + `StartedOn` – 타임스탬프입니다. 워크플로 실행이 시작된 날짜와 시간입니다. + `CompletedOn` – 타임스탬프입니다. 워크플로 실행이 완료된 날짜와 시간입니다. + `Status` – UTF-8 문자열입니다(유효 값: `RUNNING` \$1 `COMPLETED` \$1 `STOPPING` \$1 `STOPPED` \$1 `ERROR`). 워크플로 실행의 상태입니다. + `ErrorMessage` – UTF-8 문자열입니다. 이 오류 메시지는 워크플로 실행을 시작할 때 발생할 수 있는 모든 오류에 대해 설명합니다. 현재 유일한 오류 메시지는 "워크플로에 대한 동시 실행 초과(Concurrent runs exceeded for workflow): `foo`"입니다. + `Statistics` – [WorkflowRunStatistics](#aws-glue-api-workflow-WorkflowRunStatistics) 객체입니다. 실행의 통계입니다. + `Graph` – [WorkflowGraph](#aws-glue-api-workflow-WorkflowGraph) 객체입니다. 워크플로에 속하는 모든 AWS Glue 구성 요소를 이들 간의 방향 있는 연결과 노드를 엣지로 나타내는 그래프입니다. + `StartingEventBatchCondition` – [StartingEventBatchCondition](#aws-glue-api-workflow-StartingEventBatchCondition) 객체입니다. 워크플로 실행을 시작한 배치 조건입니다. ## WorkflowRunStatistics 구조 워크플로 실행 통계는 워크플로 실행에 대한 통계를 제공합니다. **필드** + `TotalActions` - 숫자(정수)입니다. 워크플로 실행에 있는 총 작업 수입니다. + `TimeoutActions` - 숫자(정수)입니다. 시간 초과된 총 작업 수입니다. + `FailedActions` - 숫자(정수)입니다. 실패한 총 작업 수입니다. + `StoppedActions` - 숫자(정수)입니다. 중지된 총 작업 수입니다. + `SucceededActions` - 숫자(정수)입니다. 성공한 총 작업 수입니다. + `RunningActions` - 숫자(정수)입니다. 실행 상태의 총 작업 수입니다. + `ErroredActions` - 숫자(정수)입니다. 워크플로 실행에서 ERROR 상태의 작업 실행 수를 나타냅니다. + `WaitingActions` - 숫자(정수)입니다. 워크플로 실행에서 WAITING 상태의 작업 실행 수를 나타냅니다. ## StartingEventBatchCondition 구조 워크플로 실행을 시작한 배치 조건입니다. BatchSize 멤버가 0이 아닌 경우 배치 크기의 이벤트 수가 도착했거나 BatchWindow 멤버가 0이 아닌 경우 배치 기간이 만료되었습니다. **필드** + `BatchSize` - 숫자(정수)입니다. 배치의 이벤트 수입니다. + `BatchWindow` - 숫자(정수)입니다. 배치 기간의 기간(초)입니다. ## 블루프린트 구조 블루프린트의 세부 정보입니다. **필드** + `Name` – [Custom string pattern #31](aws-glue-api-common.md#regex_31)과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다. 블루프린트의 이름입니다. + `Description` – 1\$1512바이트 길이의 UTF-8 문자열입니다. 블루프린트에 대한 설명입니다. + `CreatedOn` – 타임스탬프입니다. 블루프린트가 등록된 날짜 및 시간입니다. + `LastModifiedOn` – 타임스탬프입니다. 블루프린트가 마지막으로 수정된 날짜 및 시간입니다. + `ParameterSpec` – 1\$1131,072바이트 길이의 UTF-8 문자열입니다. 블루프린트에 대한 파라미터 사양 목록을 나타내는 JSON 문자열입니다. + `BlueprintLocation` – UTF-8 문자열입니다. 블루프린트가 게시되는 Amazon S3의 경로를 지정합니다. + `BlueprintServiceLocation` – UTF-8 문자열입니다. `CreateBlueprint/UpdateBlueprint`를 호출하여 AWS Glue에 블루프린트를 등록할 때 블루프린트가 복사되는 Amazon S3의 경로를 지정합니다. + `Status` – UTF-8 문자열입니다(유효 값: `CREATING` \$1 `ACTIVE` \$1 `UPDATING` \$1 `FAILED`). 블루프린트 등록의 상태입니다. + [생성(Creating)] - 블루프린트 등록이 진행 중입니다. + [활성(Active)] - 블루프린트가 성공적으로 등록되었습니다. + [업데이트 중(Updating)] - 블루프린트 등록에 대한 업데이트가 진행 중입니다. + [실패(Failed)] - 블루프린트 등록에 실패했습니다. + `ErrorMessage` – UTF-8 문자열입니다. 오류 메시지입니다. + `LastActiveDefinition` – [LastActiveDefinition](#aws-glue-api-workflow-LastActiveDefinition) 객체입니다. 블루프린트의 여러 버전이 있고 최신 버전에 일부 오류가 있는 경우 이 속성은 서비스에서 사용할 수 있는 마지막으로 성공한 블루프린트 정의를 나타냅니다. ## BlueprintDetails 구조 블루프린트의 세부 정보입니다. **필드** + `BlueprintName` – [Custom string pattern #31](aws-glue-api-common.md#regex_31)과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다. 블루프린트의 이름입니다. + `RunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 이 블루프린트의 실행 ID입니다. ## LastActiveDefinition 구조 블루프린트의 여러 버전이 있고 최신 버전에 일부 오류가 있는 경우 이 속성은 서비스에서 사용할 수 있는 마지막으로 성공한 블루프린트 정의를 나타냅니다. **필드** + `Description` – 1\$1512바이트 길이의 UTF-8 문자열입니다. 블루프린트에 대한 설명입니다. + `LastModifiedOn` – 타임스탬프입니다. 블루프린트가 마지막으로 수정된 날짜 및 시간입니다. + `ParameterSpec` – 1\$1131,072바이트 길이의 UTF-8 문자열입니다. 블루프린트의 파라미터를 지정하는 JSON 문자열입니다. + `BlueprintLocation` – UTF-8 문자열입니다. AWS Glue 개발자가 블루프린트를 게시하는 Amazon S3의 경로를 지정합니다. + `BlueprintServiceLocation` – UTF-8 문자열입니다. 블루프린트를 생성하거나 업데이트할 때 블루프린트가 복사되는 Amazon S3의 경로를 지정합니다. ## BlueprintRun 구조 블루프린트 실행의 세부 정보입니다. **필드** + `BlueprintName` – [Custom string pattern #31](aws-glue-api-common.md#regex_31)과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다. 블루프린트의 이름입니다. + `RunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 이 블루프린트 실행의 실행 ID입니다. + `WorkflowName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 성공적인 블루프린트 실행의 결과로 생성된 워크플로의 이름입니다. 블루프린트 실행에 오류가 있으면 워크플로가 생성되지 않습니다. + `State` – UTF-8 문자열입니다(유효 값: `RUNNING` \$1 `SUCCEEDED` \$1 `FAILED` \$1 `ROLLING_BACK`). 블루프린트 실행 상태입니다. 가능한 값은 다음과 같습니다. + [실행 중(Running)] - 블루프린트 실행이 진행 중입니다. + [성공(Succeeded)] - 블루프린트 실행이 성공적으로 완료되었습니다. + [실패(Failed)] - 블루프린트 실행이 실패하고 롤백이 완료되었습니다. + [롤백 중(Rolling Back)] - 블루프린트 실행이 실패하여 롤백이 진행 중입니다. + `StartedOn` – 타임스탬프입니다. 블루프린트 실행이 시작된 날짜 및 시간입니다. + `CompletedOn` – 타임스탬프입니다. 블루프린트 실행이 완료된 날짜 및 시간입니다. + `ErrorMessage` – UTF-8 문자열입니다. 블루프린트를 실행하는 동안 표시되는 모든 오류를 나타냅니다. + `RollbackErrorMessage` – UTF-8 문자열입니다. 워크플로의 엔터티를 생성하는 동안 오류가 발생하면 해당 시점까지 생성된 엔터티를 롤백하고 삭제하려고 합니다. 이 속성은 생성된 엔터티를 삭제하는 동안 발생한 오류를 나타냅니다. + `Parameters` – 1\$1131,072바이트 길이의 UTF-8 문자열입니다. 블루프린트 파라미터(문자열). `Blueprint$ParameterSpec`에 정의된 파라미터 사양에서 필요한 각 키에 대한 값을 제공해야 합니다. + `RoleArn` – [Custom string pattern #30](aws-glue-api-common.md#regex_30)과(와) 일치하는 1\$11,024바이트 길이의 UTF-8 문자열입니다. 역할 ARN입니다. 이 역할은 AWS Glue 서비스에서 수임하며 워크플로 및 워크플로의 기타 엔터티를 생성하는 데 사용됩니다. ## 운영 + [CreateWorkflow 작업(Python: create\$1workflow)](#aws-glue-api-workflow-CreateWorkflow) + [UpdateWorkflow 작업(Python: update\$1workflow)](#aws-glue-api-workflow-UpdateWorkflow) + [DeleteWorkflow 작업(Python: delete\$1workflow)](#aws-glue-api-workflow-DeleteWorkflow) + [GetWorkflow 작업(Python: get\$1workflow)](#aws-glue-api-workflow-GetWorkflow) + [ListWorkflows 작업(Python: list\$1workflows)](#aws-glue-api-workflow-ListWorkflows) + [BatchGetWorkflows 작업(Python: batch\$1get\$1workflows)](#aws-glue-api-workflow-BatchGetWorkflows) + [GetWorkflowRun 작업(Python: get\$1workflow\$1run)](#aws-glue-api-workflow-GetWorkflowRun) + [GetWorkflowRuns 작업(Python: get\$1workflow\$1runs)](#aws-glue-api-workflow-GetWorkflowRuns) + [GetWorkflowRunProperties 작업(Python: get\$1workflow\$1run\$1properties)](#aws-glue-api-workflow-GetWorkflowRunProperties) + [PutWorkflowRunProperties 작업(Python: put\$1workflow\$1run\$1properties)](#aws-glue-api-workflow-PutWorkflowRunProperties) + [CreateBlueprint 작업(Python: create\$1blueprint)](#aws-glue-api-workflow-CreateBlueprint) + [UpdateBlueprint 작업(Python: update\$1blueprint)](#aws-glue-api-workflow-UpdateBlueprint) + [DeleteBlueprint 작업(Python: delete\$1blueprint)](#aws-glue-api-workflow-DeleteBlueprint) + [ListBlueprints 작업(Python: list\$1blueprints)](#aws-glue-api-workflow-ListBlueprints) + [BatchGetBlueprints 작업(Python: batch\$1get\$1blueprints)](#aws-glue-api-workflow-BatchGetBlueprints) + [StartBlueprintRun 작업(Python: start\$1blueprint\$1run)](#aws-glue-api-workflow-StartBlueprintRun) + [GetBlueprintRun 작업(Python: get\$1blueprint\$1run)](#aws-glue-api-workflow-GetBlueprintRun) + [GetBlueprintRuns 작업(Python: get\$1blueprint\$1runs)](#aws-glue-api-workflow-GetBlueprintRuns) + [StartWorkflowRun 작업(Python: start\$1workflow\$1run)](#aws-glue-api-workflow-StartWorkflowRun) + [StopWorkflowRun 작업(Python: stop\$1workflow\$1run)](#aws-glue-api-workflow-StopWorkflowRun) + [ResumeWorkflowRun 작업(Python: resume\$1workflow\$1run)](#aws-glue-api-workflow-ResumeWorkflowRun) ## CreateWorkflow 작업(Python: create\$1workflow) 새 워크플로를 생성합니다. **요청** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 워크플로에 할당할 이름입니다. 이름은 계정 내에서 고유해야 합니다. + `Description` – UTF-8 문자열(120,000바이트 이하). 워크플로에 대한 설명입니다. + `DefaultRunProperties` – 키-값 페어의 맵 배열입니다. 각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 UTF-8 문자열입니다. 각 값은 UTF-8 문자열입니다. 워크플로의 각 실행의 일부로 사용할 속성 모음입니다. 실행 속성이 로깅될 수 있습니다. 일반 텍스트 보안 암호를 속성으로 전달하지 마세요. 워크플로우 실행 내에서 보안 암호를 사용하려는 경우 AWS Glue 연결, AWS Secrets Manager 또는 다른 보안 암호 관리 메커니즘에서 검색합니다. + `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다. 각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다. 각 값은 256 바이트 이하 길이의 UTF-8 문자열입니다. 이 워크플로에 사용할 태그입니다. + `MaxConcurrentRuns` - 숫자(정수)입니다. 이 파라미터를 사용하여 데이터에 대한 원치 않는 다중 업데이트를 방지하거나 비용을 제어하거나 경우에 따라 구성 요소 작업의 최대 동시 실행 수를 초과하는 것을 방지할 수 있습니다. 이 파라미터를 공백으로 두면 동시 워크플로 실행 수에 제한이 없습니다. **응답** + `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 요청의 일부로 제공된 워크플로의 이름입니다. **오류** + `AlreadyExistsException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `ResourceNumberLimitExceededException` + `ConcurrentModificationException` ## UpdateWorkflow 작업(Python: update\$1workflow) 기존 워크플로를 업데이트합니다. **요청** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 업데이트할 워크플로의 이름입니다. + `Description` – UTF-8 문자열(120,000바이트 이하). 워크플로에 대한 설명입니다. + `DefaultRunProperties` – 키-값 페어의 맵 배열입니다. 각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 UTF-8 문자열입니다. 각 값은 UTF-8 문자열입니다. 워크플로의 각 실행의 일부로 사용할 속성 모음입니다. 실행 속성이 로깅될 수 있습니다. 일반 텍스트 보안 암호를 속성으로 전달하지 마세요. 워크플로우 실행 내에서 보안 암호를 사용하려는 경우 AWS Glue 연결, AWS Secrets Manager 또는 다른 보안 암호 관리 메커니즘에서 검색합니다. + `MaxConcurrentRuns` - 숫자(정수)입니다. 이 파라미터를 사용하여 데이터에 대한 원치 않는 다중 업데이트를 방지하거나 비용을 제어하거나 경우에 따라 구성 요소 작업의 최대 동시 실행 수를 초과하는 것을 방지할 수 있습니다. 이 파라미터를 공백으로 두면 동시 워크플로 실행 수에 제한이 없습니다. **응답** + `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 입력에서 지정된 워크플로의 이름입니다. **오류** + `InvalidInputException` + `EntityNotFoundException` + `InternalServiceException` + `OperationTimeoutException` + `ConcurrentModificationException` ## DeleteWorkflow 작업(Python: delete\$1workflow) 워크플로를 삭제합니다. **요청** + `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` ## GetWorkflow 작업(Python: get\$1workflow) 워크플로에 대한 리소스 메타데이터를 검색합니다. **요청** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 검색할 워크플로의 이름입니다. + `IncludeGraph` – 부울입니다. 워크플로 리소스 메타데이터를 반환할 때 그래프를 포함할지 여부를 지정합니다. **응답** + `Workflow` – [워크플로](#aws-glue-api-workflow-Workflow) 객체입니다. 워크플로에 대한 리소스 메타데이터입니다. **오류** + `InvalidInputException` + `EntityNotFoundException` + `InternalServiceException` + `OperationTimeoutException` ## ListWorkflows 작업(Python: list\$1workflows) 계정에서 생성된 워크플로의 이름을 나열합니다. **요청** + `NextToken` – UTF-8 문자열입니다. 이것이 지속적인 요청이라면 지속적인 토큰입니다. + `MaxResults` - 1 이상 25 이하의 숫자(정수)입니다. 반환할 목록의 최대 크기. **응답** + `Workflows` – 1\$125개 문자열로 구성된 UTF-8 문자열의 배열입니다. 계정에 있는 워크플로의 이름 목록입니다. + `NextToken` – UTF-8 문자열입니다. 일부 워크플로 이름이 반환되지 않은 경우의 지속 토큰입니다. **오류** + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` ## BatchGetWorkflows 작업(Python: batch\$1get\$1workflows) 제공된 워크플로 이름 목록에 대한 리소스 메타데이터의 목록을 반환합니다. `ListWorkflows` 작업을 호출한 후에는 권한이 부여된 데이터에 액세스하기 위해 이 작업을 호출할 수 있습니다. 이 작업은 태그를 사용하는 권한 조건을 포함해 모든 IAM 권한을 지원합니다. **요청** + `Names` – *필수(Required):* 1\$125개 문자열의 UTF-8 문자열의 배열입니다. `ListWorkflows` 작업에서 반환된 이름일 수 있는 워크플로 이름의 목록입니다. + `IncludeGraph` – 부울입니다. 워크플로 리소스 메타데이터를 반환할 때 그래프를 포함할지 여부를 지정합니다. **응답** + `Workflows` – [워크플로](#aws-glue-api-workflow-Workflow) 객체의 배열이며 구조는 1\$125개입니다. 워크플로 리소스 메타데이터의 목록입니다. + `MissingWorkflows` – 1\$125개 문자열로 구성된 UTF-8 문자열의 배열입니다. 찾을 수 없는 워크플로의 이름 목록입니다. **오류** + `InternalServiceException` + `OperationTimeoutException` + `InvalidInputException` ## GetWorkflowRun 작업(Python: get\$1workflow\$1run) 제공된 워크플로 실행에 대한 메타데이터를 검색합니다. 워크플로 및 작업 실행의 경우 작업 실행 기록을 90일 동안 액세스할 수 있습니다. **요청** + `Name` – *필수(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입니다. + `IncludeGraph` – 부울입니다. 워크플로 그래프를 응답에 포함할지 여부를 지정합니다. **응답** + `Run` – [WorkflowRun](#aws-glue-api-workflow-WorkflowRun) 객체입니다. 요청된 워크플로 실행 메타데이터입니다. **오류** + `InvalidInputException` + `EntityNotFoundException` + `InternalServiceException` + `OperationTimeoutException` ## GetWorkflowRuns 작업(Python: get\$1workflow\$1runs) 제공된 워크플로의 모든 실행에 대한 메타데이터를 검색합니다. **요청** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 실행 메타데이터를 반환해야 하는 워크플로의 이름입니다. + `IncludeGraph` – 부울입니다. 워크플로 그래프를 응답에 포함할지 여부를 지정합니다. + `NextToken` – UTF-8 문자열입니다. 응답의 최대 크기입니다. + `MaxResults` – 1\$11,000의 숫자(정수)입니다. 응답에 포함할 최대 워크플로 실행 수입니다. **응답** + `Runs` – [WorkflowRun](#aws-glue-api-workflow-WorkflowRun) 객체의 배열이며 구조는 1\$11,000개입니다. 워크플로 실행 메타데이터 객체의 목록입니다. + `NextToken` – UTF-8 문자열입니다. 일부 요청된 워크플로 실행이 반환되지 않은 경우 지속 토큰입니다. **오류** + `InvalidInputException` + `EntityNotFoundException` + `InternalServiceException` + `OperationTimeoutException` ## GetWorkflowRunProperties 작업(Python: get\$1workflow\$1run\$1properties) 실행 중에 설정된 워크플로 실행 속성을 검색합니다. **요청** + `Name` – *필수(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입니다. **응답** + `RunProperties` – 키-값 페어의 맵 배열입니다. 각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 UTF-8 문자열입니다. 각 값은 UTF-8 문자열입니다. 지정된 실행 중에 설정된 워크플로 실행 속성입니다. **오류** + `InvalidInputException` + `EntityNotFoundException` + `InternalServiceException` + `OperationTimeoutException` ## PutWorkflowRunProperties 작업(Python: put\$1workflow\$1run\$1properties) 제공된 워크플로 실행에 대해 지정된 워크플로 실행 속성을 입력합니다. 지정된 실행에 대한 속성이 이미 있으면 이 속성이 값을 재정의하고 그렇지 않으면 속성을 기존 속성에 추가합니다. **요청** + `Name` – *필수(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입니다. + `RunProperties` – *필수(Required):* 키-값 페어의 맵 배열입니다. 각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 UTF-8 문자열입니다. 각 값은 UTF-8 문자열입니다. 지정된 실행에 대해 입력할 속성입니다. 실행 속성이 로깅될 수 있습니다. 일반 텍스트 보안 암호를 속성으로 전달하지 마세요. 워크플로우 실행 내에서 보안 암호를 사용하려는 경우 AWS Glue 연결, AWS Secrets Manager 또는 다른 보안 암호 관리 메커니즘에서 검색합니다. **응답** + *무응답 파라미터.* **오류** + `AlreadyExistsException` + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `ResourceNumberLimitExceededException` + `ConcurrentModificationException` ## CreateBlueprint 작업(Python: create\$1blueprint) AWS Glue에 블루프린트를 등록합니다. **요청** + `Name` – *필수(Required):* [Custom string pattern #31](aws-glue-api-common.md#regex_31)과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다. 블루프린트의 이름입니다. + `Description` – 1\$1512바이트 길이의 UTF-8 문자열입니다. 블루프린트에 대한 설명입니다. + `BlueprintLocation` – *필수(Required):* [Custom string pattern #32](aws-glue-api-common.md#regex_32)과(와) 일치하는 1\$18,192바이트 길이의 UTF-8 문자열입니다. 블루프린트가 게시되는 Amazon S3의 경로를 지정합니다. + `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다. 각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다. 각 값은 256 바이트 이하 길이의 UTF-8 문자열입니다. 이 블루프린트에 적용할 태그입니다. **응답** + `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 등록된 블루프린트의 이름을 반환합니다. **오류** + `AlreadyExistsException` + `InvalidInputException` + `OperationTimeoutException` + `InternalServiceException` + `ResourceNumberLimitExceededException` ## UpdateBlueprint 작업(Python: update\$1blueprint) 등록된 블루프린트를 업데이트합니다. **요청** + `Name` – *필수(Required):* [Custom string pattern #31](aws-glue-api-common.md#regex_31)과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다. 블루프린트의 이름입니다. + `Description` – 1\$1512바이트 길이의 UTF-8 문자열입니다. 블루프린트에 대한 설명입니다. + `BlueprintLocation` – *필수(Required):* [Custom string pattern #32](aws-glue-api-common.md#regex_32)과(와) 일치하는 1\$18,192바이트 길이의 UTF-8 문자열입니다. 블루프린트가 게시되는 Amazon S3의 경로를 지정합니다. **응답** + `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 업데이트된 블루프린트의 이름을 반환합니다. **오류** + `EntityNotFoundException` + `ConcurrentModificationException` + `InvalidInputException` + `OperationTimeoutException` + `InternalServiceException` + `IllegalBlueprintStateException` ## DeleteBlueprint 작업(Python: delete\$1blueprint) 기존 블루프린트를 삭제합니다. **요청** + `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` + `OperationTimeoutException` + `InternalServiceException` ## ListBlueprints 작업(Python: list\$1blueprints) 계정의 모든 블루프린트 이름을 나열합니다. **요청** + `NextToken` – UTF-8 문자열입니다. 이것이 지속적인 요청이라면 지속적인 토큰입니다. + `MaxResults` - 1 이상 25 이하의 숫자(정수)입니다. 반환할 목록의 최대 크기. + `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다. 각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다. 각 값은 256 바이트 이하 길이의 UTF-8 문자열입니다. AWS 리소스 태그로 목록을 필터링합니다. **응답** + `Blueprints` – UTF-8 문자열의 배열입니다. 계정에 있는 블루프린트의 이름 목록입니다. + `NextToken` – UTF-8 문자열입니다. 모든 블루프린트 이름이 반환하지 않은 경우의 지속 토큰입니다. **오류** + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` ## BatchGetBlueprints 작업(Python: batch\$1get\$1blueprints) 블루프린트 목록에 대한 정보를 검색합니다. **요청** + `Names` – *필수(Required):* 1\$125개 문자열의 UTF-8 문자열의 배열입니다. 블루프린트 이름의 목록입니다. + `IncludeBlueprint` – 부울입니다. 응답에 워크플로를 포함할지 여부를 지정합니다. + `IncludeParameterSpec` – 부울입니다. 응답에 블루프린트에 대한 파라미터를 JSON 문자열로 포함할지 여부를 지정합니다. **응답** + `Blueprints` – [블루프린트](#aws-glue-api-workflow-Blueprint) 객체의 배열입니다. 블루프린트 목록을 `Blueprints` 객체로 반환합니다. + `MissingBlueprints` – UTF-8 문자열의 배열입니다. 찾을 수 없는 `BlueprintNames` 목록을 반환합니다. **오류** + `InternalServiceException` + `OperationTimeoutException` + `InvalidInputException` ## StartBlueprintRun 작업(Python: start\$1blueprint\$1run) 지정된 블루프린트의 새 실행을 시작합니다. **요청** + `BlueprintName` – *필수(Required):* [Custom string pattern #31](aws-glue-api-common.md#regex_31)과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다. 블루프린트의 이름입니다. + `Parameters` – 1\$1131,072바이트 길이의 UTF-8 문자열입니다. 파라미터를 `BlueprintParameters` 객체로 지정합니다. + `RoleArn` – *필수(Required):* [Custom string pattern #30](aws-glue-api-common.md#regex_30)과(와) 일치하는 1\$11,024바이트 길이의 UTF-8 문자열입니다. 워크플로 생성에 사용되는 IAM 역할을 지정합니다. **응답** + `RunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 이 블루프린트 실행의 실행 ID입니다. **오류** + `InvalidInputException` + `OperationTimeoutException` + `InternalServiceException` + `ResourceNumberLimitExceededException` + `EntityNotFoundException` + `IllegalBlueprintStateException` ## GetBlueprintRun 작업(Python: get\$1blueprint\$1run) 블루프린트 실행의 세부 정보를 검색합니다. **요청** + `BlueprintName` – *필수(Required):* [Custom string pattern #31](aws-glue-api-common.md#regex_31)과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다. 블루프린트의 이름입니다. + `RunId` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 검색하려는 블루프린트 실행의 실행 ID입니다. **응답** + `BlueprintRun` – [BlueprintRun](#aws-glue-api-workflow-BlueprintRun) 객체입니다. `BlueprintRun` 객체를 반환합니다. **오류** + `EntityNotFoundException` + `InternalServiceException` + `OperationTimeoutException` ## GetBlueprintRuns 작업(Python: get\$1blueprint\$1runs) 지정된 블루프린트에 대한 블루프린트 실행의 세부 정보를 검색합니다. **요청** + `BlueprintName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 블루프린트의 이름입니다. + `NextToken` – UTF-8 문자열입니다. 이것이 지속적인 요청이라면 지속적인 토큰입니다. + `MaxResults` – 1\$11,000의 숫자(정수)입니다. 반환할 목록의 최대 크기. **응답** + `BlueprintRuns` – [BlueprintRun](#aws-glue-api-workflow-BlueprintRun) 객체의 배열입니다. `BlueprintRun` 객체 목록을 반환합니다. + `NextToken` – UTF-8 문자열입니다. 모든 블루프린트 실행이 반환하지 않은 경우의 지속 토큰입니다. **오류** + `EntityNotFoundException` + `InternalServiceException` + `OperationTimeoutException` + `InvalidInputException` ## StartWorkflowRun 작업(Python: start\$1workflow\$1run) 지정된 워크플로의 새 실행을 시작합니다. **요청** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 시작할 워크플로의 이름입니다. + `RunProperties` – 키-값 페어의 맵 배열입니다. 각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 UTF-8 문자열입니다. 각 값은 UTF-8 문자열입니다. 새 워크플로 실행에 대한 워크플로 실행 속성입니다. 실행 속성이 로깅될 수 있습니다. 일반 텍스트 보안 암호를 속성으로 전달하지 마세요. 워크플로우 실행 내에서 보안 암호를 사용하려는 경우 AWS Glue 연결, AWS Secrets Manager 또는 다른 보안 암호 관리 메커니즘에서 검색합니다. **응답** + `RunId` – [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` ## StopWorkflowRun 작업(Python: stop\$1workflow\$1run) 지정된 워크플로 실행의 실행을 중지합니다. **요청** + `Name` – *필수(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입니다. **응답** + *무응답 파라미터.* **오류** + `InvalidInputException` + `EntityNotFoundException` + `InternalServiceException` + `OperationTimeoutException` + `IllegalWorkflowStateException` ## ResumeWorkflowRun 작업(Python: resume\$1workflow\$1run) 이전에 부분적으로 완료된 워크플로 실행의 선택한 노드를 다시 시작하고 워크플로 실행을 재개합니다. 선택한 노드와 선택한 노드의 다운스트림에 있는 모든 노드가 실행됩니다. **요청** + `Name` – *필수(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입니다. + `NodeIds` – *필수(Required):* UTF-8 문자열의 배열입니다. 다시 시작하려는 노드의 노드 ID 목록입니다. 다시 시작될 노드에는 원래 실행에서 실행 시도가 있어야 합니다. **응답** + `RunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 재개된 워크플로 실행에 할당된 새 ID입니다. 워크플로 실행의 각 재개에는 새 실행 ID가 있습니다. + `NodeIds` – UTF-8 문자열의 배열입니다. 실제로 다시 시작된 노드의 노드 ID 목록입니다. **오류** + `InvalidInputException` + `EntityNotFoundException` + `InternalServiceException` + `OperationTimeoutException` + `ConcurrentRunsExceededException` + `IllegalWorkflowStateException`