기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

자동화 배포

Amazon Quick Automate에서 자동화를 생성하고 테스트한 후 다음 단계는 트리거에서 정기적으로 실행할 수 있도록 자동화를 배포하는 것입니다. 배포를 통해 자동화가 작동하고 실행 준비가 됩니다. 배포된 자동화에 트리거를 추가하여 사전 정의된 일정에 따라 실행할 수 있습니다. 배포에는 런타임 설정 구성, 루프 human-in-the-loop 대한 사용자 할당, 자격 증명 및 통합 확인이 포함됩니다.

이 섹션에서는 배포 프로세스의 각 단계와 신뢰성, 보안 및 최적의 성능을 위해 자동화를 구성하는 방법을 설명합니다.

사전 조건

자동화를 배포하기 전에 다음 단계가 완료되었는지 확인합니다.

자동화 배포

배포를 클릭하거나 자동화 랜딩 페이지의 배포 탭으로 이동하여 Canvas에서 직접 자동화를 배포할 수 있습니다. 배포를 시작하면 시스템에서 구성 및 릴리스 프로세스를 완료하는 일련의 단계를 안내합니다.

릴리스 세부 정보

릴리스 세부 정보 페이지에서 배포하려는 자동화 버전을 선택합니다. 커밋된 버전만 배포에 사용할 수 있으며 드롭다운 목록에 표시됩니다.

추가 설정

추가 설정은 다음과 같습니다.

런타임 구성

런타임 구성은 개발, 테스트 및 프로덕션과 같은 환경마다 다를 수 있는 파라미터입니다.

예를 들어 이메일을 보내는 자동화 단계에서는 테스트 중에 개인 이메일 주소를 사용할 수 있지만 프로덕션 환경에서는 공유 팀 주소로 전환해야 합니다. 이러한 환경 종속 값은 자동화를 작성할 때 런타임 구성으로 정의할 수 있습니다.

배포 시 이러한 구성을 검토하고 재정의하여 자동화가 의도한 환경에서 올바르게 실행되는지 확인할 수 있습니다. 런타임 파라미터에는 다음이 포함될 수 있습니다.

이러한 유연성을 통해 환경에 걸쳐 단일 자동화 정의를 유지하는 동시에 필요에 따라 주요 파라미터를 조정할 수 있습니다.

작업

human-in-the-loop가 필요한 각 작업에 대해 해석기 사용자 또는 사용자 그룹을 선택합니다.

액세스(자격 증명 및 연결)

자동화는 외부 시스템, 데이터베이스 또는 서비스에 연결해야 하는 경우가 많습니다. Amazon Quick Automate는 자동화 로직 내에 민감한 정보를 포함하지 않고 자격 증명 및 연결을 관리할 수 있는 안전한 방법을 제공합니다.

연결 및 자격 증명 데이터는 안전하게 저장 및 암호화되며 작성자 또는 최종 사용자에게 노출되지 않고 런타임에 워크플로에서 사용할 수 있습니다. 이 설계는 자동화 정의와 보안 암호를 강력하게 분리하여 보안과 유지 관리를 모두 개선합니다.

두 가지 기본 유형의 자격 증명을 저장하고 사용할 수 있습니다.

배포 시 자동화가 필요한 모든 시스템에 안전하고 성공적으로 액세스할 수 있도록 올바른 자격 증명과 연결이 선택되어 있는지 확인합니다.

트리거 설정

트리거는 자동화 실행 시기와 방법을 결정합니다. 사전 정의된 일정에 따라 시작하거나 Amazon QuickSight API를 통해 프로그래밍 방식으로 호출하도록 자동화를 구성할 수 있습니다.

Schedules

사전 정의된 일정에 따라 시작하도록 자동화를 구성할 수 있습니다. 트리거를 설정하려면:

API 트리거

자동화 작업 APIs 사용하면 외부 애플리케이션에서 프로그래밍 방식으로 자동화 작업을 시작하고 모니터링할 수 있습니다. 이러한 APIs 사용하여 사용자 지정 입력 페이로드로 배포된 자동화를 호출하고 AWS SDK 및를 통해 실행 결과를 검색할 수 있습니다 AWS CLI.

자동화 작업 APIs 포함됩니다.

이러한 APIs는 Amazon QuickSight 서비스 네임스페이스의 일부입니다. AWS SDK 및의 quicksight 네임스페이스를 통해 액세스합니다 AWS CLI.

AWS SDKs 및 툴킷에 대한 자세한 내용은 AWS 시작하기 리소스 센터를 참조하세요.

사전 조건

자동화 작업 APIs를 호출하기 전에 다음 설정 단계를 완료합니다.

자동화 식별자 찾기

자동화 작업 APIs를 호출하려면 다음 식별자가 필요합니다.

자동화를 열고 배포된 버전이 있는 경우 배포 섹션에서 자동화 그룹 ID와 자동화 ID를 찾을 수 있습니다.

식별자를 찾으려면

IAM 권한 구성

자동화 작업 APIs에는 IAM 자격 증명(사용자, 역할 또는 그룹)에 연결된 IAM 권한이 필요합니다. 각 작업에는 별도의 권한이 필요합니다.

StartAutomationJob에 대한 권한

quicksight:StartAutomationJob 작업을 부여하는 정책을 연결합니다. 리소스 ARN의 범위를 허용하려는 특정 자동화로 지정합니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowStartAutomationJob",
            "Effect": "Allow",
            "Action": [
                "quicksight:StartAutomationJob"
            ],
            "Resource": [
                "arn:aws:quicksight:us-west-2:111122223333:automation-group/EXAMPLE-GROUP-ID/automation/EXAMPLE-AUTOMATION-ID"
            ]
        }
    ]
}

DescribeAutomationJob에 대한 권한

quicksight:DescribeAutomationJob 작업을 부여하는 정책을 연결합니다. 이 작업의 리소스 ARN에는 작업 ID 세그먼트가 포함됩니다. 자동화 중인 작업을 설명하도록 허용하려면 작업 세그먼트에 와일드카드(*)를 사용합니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowDescribeAutomationJob",
            "Effect": "Allow",
            "Action": [
                "quicksight:DescribeAutomationJob"
            ],
            "Resource": [
                "arn:aws:quicksight:us-west-2:111122223333:automation-group/EXAMPLE-GROUP-ID/automation/EXAMPLE-AUTOMATION-ID"
            ]
        }
    ]
}

AWS 에서는 최소 권한 원칙을 따르기 위해 각 권한을 가능한 가장 구체적인 리소스 ARN으로 조정할 것을 권장합니다. 자세한 내용은 다음을 참조하세요.

자동화 배포

StartAutomationJob API는 배포된 자동화만 대상으로 합니다. API를 통해 자동화를 호출하려면 먼저 Amazon Quick Automate 콘솔에서 자동화를 커밋하고 배포해야 합니다.

StartAutomationJob

배포된 자동화에 대한 새 작업을 시작합니다. 작업은 비동기식입니다. Amazon Quick Automate는 요청을 수락하고, 작업을 대기열에 넣고, JobId를 즉시 반환합니다. 자동화는 백그라운드에서 실행됩니다. 자동화에 입력 스키마가 정의된 경우 Amazon Quick Automate는 작업을 수락하기 전에 스키마에 대해 InputPayload를 검증합니다. 잘못된 페이로드로 인해 InvalidParameterValueException이 발생합니다.

요청 구문

POST /accounts/AwsAccountId/automation-groups/AutomationGroupId/automations/AutomationId/jobs HTTP/1.1
Content-type: application/json

{
    "InputPayload": "string"
}

요청 파라미터

응답 요소

오류

자세한 내용은 StartAutomationJob용 API 참조 가이드를 참조하세요.

DescribeAutomationJob

실행 타임스탬프, 선택적 입력 및 출력 페이로드를 포함하여 지정된 자동화 작업의 상태 및 세부 정보를 검색합니다. 이 작업을 사용하여 StartAutomationJob을 호출한 후 작업 완료를 폴링합니다.

응답에는 기본적으로 입력 및 출력 페이로드가 포함되지 않습니다. 요청하려면 IncludeInputPayload 및 IncludeOutputPayload 쿼리 파라미터를 로 설정합니다. true Amazon Quick Automate는 다음 조건이 모두 충족되는 경우에만 출력 페이로드를 반환합니다.

요청 구문

GET /accounts/AwsAccountId/automation-groups/AutomationGroupId/automations/AutomationId/jobs/JobId?IncludeInputPayload=boolean&IncludeOutputPayload=boolean HTTP/1.1

요청 파라미터

응답 필드

오류

자세한 내용은 DescribeAutomationJob에 대한 API 참조 가이드를 참조하세요.

입력 및 출력을 사용하여 API 트리거로 자동화 실행

API를 통해 자동화 작업을 시작할 때 입력 값을 JSON 페이로드로 포함할 수 있습니다. Amazon Quick Automate는 실행이 시작되기 전에 자동화의 입력 스키마에 대해 페이로드를 검증하고 작업이 완료되면 구조화된 출력 값을 반환합니다.

사전 조건

API 트리거를 사용하여 자동화를 실행하기 전에 다음 사항이 있는지 확인합니다.

API를 통해 입력 값 전송

입력 값을 포함하려면 InputPayload 파라미터를 사용하여 StartAutomationJob 요청에 JSON 페이로드를 전달합니다. InputPayload

Sample Request

POST /accounts/123456789012/automation-groups/a1b2c3d4-e5f6-7890-abcd-ef1234567890/automations/11111111-2222-3333-4444-555555555555/jobs
{
    "InputPayload": "{\"customer_id\":\"C-98765\",\"threshold\":100,\"region\":\"us-east-1\"}"
}

Sample Response

{
    "Arn": "arn:aws:quicksight:us-west-2:123456789012:automation-group/a1b2c3d4-e5f6-7890-abcd-ef1234567890/automation/11111111-2222-3333-4444-555555555555/job/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "JobId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "Status": 200,
    "RequestId": "req-12345678-abcd-efgh-ijkl-123456789012"
}

API를 통해 출력 값 검색

DescribeAutomationJob API를 호출하여 출력 값을 검색할 수 있습니다. 응답에 입력 및 출력 페이로드를 포함하려면 includeInputPayload 및 includeOutputPayload 쿼리 파라미터를 로 설정합니다true.

응답에는 자동화가 성공적으로 완료된 경우에만 OutputPayload 필드가 포함됩니다.

Sample Request

GET /accounts/123456789012/automation-groups/a1b2c3d4-e5f6-7890-abcd-ef1234567890/automations/11111111-2222-3333-4444-555555555555/jobs/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee?includeInputPayload=true&includeOutputPayload=true

Sample Response

{
    "Arn": "arn:aws:quicksight:us-west-2:123456789012:automation-group/a1b2c3d4-e5f6-7890-abcd-ef1234567890/automation/11111111-2222-3333-4444-555555555555/job/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "JobStatus": "SUCCEEDED",
    "CreatedAt": "2026-03-11T09:59:50Z",
    "StartedAt": "2026-03-11T10:00:00Z",
    "EndedAt": "2026-03-11T10:05:00Z",
    "InputPayload": "{\"customer_id\":\"C-98765\",\"threshold\":100,\"region\":\"us-east-1\"}",
    "OutputPayload": "{\"result\":\"success\",\"records_processed\":42,\"summary\":{\"passed\":40,\"failed\":2}}",
    "RequestId": "req-12345678-abcd-efgh-ijkl-123456789012"
}

입력 및 출력을 사용하여 자동화 배포 및 실행

이 섹션에서는 입력 및 출력 스키마를 사용하는 자동화를 배포하고, 수동 또는 일정에 따라 실행하고, 실행 결과를 보는 방법을 설명합니다.

배포 전 스키마 정보 보기

자동화를 배포하기 전에 자동화를 커밋하여 버전을 생성해야 합니다. 자세한 내용은 자동화 버전 유지 관리를 참조하세요.

입력 또는 출력 스키마를 사용하여 자동화를 커밋한 후 버전 세부 정보 페이지의 데이터 모델 섹션에서 스키마 세부 정보를 볼 수 있습니다. 이 섹션에는 입력과 출력 모두에 대한 전체 필드 정의가 표시됩니다.

입력 및 출력 스키마를 사용하여 자동화 배포

입력 또는 출력 스키마가 정의된 자동화를 배포하면 배포 대화 상자에 다음과 같은 스키마 정보가 데이터 모델 섹션에 표시됩니다.

배포를 완료하려면 스키마 정보를 검토하고 배포를 선택합니다.

배포된 자동화를 수동으로 실행

입력으로 배포된 자동화를 시작하려면 다음 단계를 완료하세요.

입력 양식은 Studio에서 테스트할 때 사용하는 양식과 동일합니다.

예약된 트리거로 자동화 실행

예약된 트리거의 경우 트리거를 생성하거나 편집할 때 입력 값을 제공합니다. 저장된 값은 트리거가 실행될 때마다 자동화로 전달됩니다.

다음을 수행할 수 있습니다.

예약된 트리거에 대한 입력을 구성하려면 다음 단계를 완료합니다.

배포된 실행의 입력 및 출력 보기

자동화 실행이 완료된 후(수동으로 시작하든 예약된 트리거로 시작하든), 입력 및 출력 값은 실행 페이지의 로그 패널에서 구조화된 아티팩트로 사용할 수 있습니다.

아티팩트는 전용 카드로 표시됩니다.

두 카드 모두 기본적으로 축소됩니다. 확장하면 다음을 수행할 수 있습니다.