本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

部署自动化

在 Amazon Quick Automate 中创建并测试自动化后，下一步是部署它们，以便它们可以在触发器上定期运行。部署使自动化可以运行并准备执行。您可以向已部署的自动化添加触发器，使其按预定义的计划运行。部署包括配置运行时设置、为人工在环任务分配用户、验证凭据和集成。

本节介绍部署过程的每个步骤，以及如何配置自动化以实现可靠性、安全性和最佳性能。

先决条件

在部署自动化之前，请确保完成以下步骤：

部署自动化

您可以直接从画布部署自动化，方法是单击 “部署”，或者导航到自动化登录页面上的 “部署” 选项卡。启动部署后，系统将引导您完成一系列步骤以完成配置和发布过程。

发行版详细信息

在版本详细信息页面上，选择要部署的自动化版本。只有已提交的版本可供部署，并且会显示在下拉列表中。

其他设置

其他设置包括：

运行时配置

运行时配置是在开发、测试和生产等环境之间可能存在差异的参数。

例如，发送电子邮件的自动化步骤可能会在测试期间使用您的个人电子邮件地址，但在生产环境中应切换到共享的团队地址。在创作自动化时，可以将此类与环境相关的值定义为运行时配置。

在部署时，您可以查看和覆盖这些配置，以确保自动化在预期环境中正确运行。运行时参数可以包括：

这种灵活性有助于在不同环境中保持单一的自动化定义，同时根据需要调整关键参数。

任务

为需要人机交互的每项任务选择解析者用户或用户组。

访问权限（凭证和连接）

自动化通常需要连接到外部系统、数据库或服务。Amazon Quick Automate 提供了管理凭证和连接的安全方法，无需在自动化逻辑中嵌入敏感信息。

连接和凭证数据被安全存储和加密，并在运行时可供工作流程使用，而不会将其暴露给作者或最终用户。这种设计可确保将机密与自动化定义牢固分开，从而提高安全性和可维护性。

您可以存储和使用两种主要类型的证书：

在部署时，请确保选择正确的凭据和连接，以便自动化可以安全、成功地访问所有必需的系统。

设置触发器

触发器决定自动化的运行时间和方式。您可以将自动化配置为根据预定义的计划启动，也可以通过 Ama QuickSight zon API 以编程方式调用自动化。

Schedules

您可以将自动化配置为根据预定义的计划启动。要设置触发器，请执行以下操作：

API 触发器

Automation Job API 使您能够以编程方式启动和监控来自外部应用程序的自动化作业。您可以使用这些 API 调用带有自定义输入负载的已部署自动化，并通过 AWS SDK 和检索执行结果。 AWS CLI

Automation Job API 包括两个操作：

这些 API 是亚马逊 QuickSight 服务命名空间的一部分。您可以通过 AWS SDK 中的quicksight命名空间访问它们，然后 AWS CLI。

有关 AWS SDK 和工具包的更多信息，请参阅AWS 入门资源中心。

先决条件

在调用 Automation Job API 之前，请完成以下设置步骤。

查找您的自动化标识符

要调用 Automation Job API，你需要以下标识符：

当您打开任何自动化并部署版本时，可以在部署部分中找到自动化组 ID 和自动化 ID。

要查找您的标识符

配置 IAM 权限

Automation Job API 需要附加到您的 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"
}

请求参数

响应元素

错误

如需了解更多详情，请参阅的 API 参考指南 StartAutomationJob。

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

请求参数

响应字段

错误

如需了解更多详情，请参阅的 API 参考指南 DescribeAutomationJob。

使用输入和输出通过 API 触发器运行自动化

通过 API 启动自动化作业时，您可以将输入值作为 JSON 有效负载。Amazon Quick Automate 会在执行开始之前根据自动化的输入架构验证有效负载，并在任务完成时返回结构化输出值。

先决条件

在使用 API 触发器运行自动化之前，请确保以下各项准备就绪：

通过 API 发送输入值

要包含输入值，StartAutomationJob请使用InputPayload参数在请求中传递 JSON 有效负载。

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 检索输出值

您可以通过调用 DescribeAutomationJobAPI 来检索输出值。要在响应中包含输入和输出负载，请将包含InputPayload和包含OutputPayload查询参数设置为。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"
}

使用输入和输出部署和运行自动化

本节介绍如何部署使用输入和输出架构的自动化、手动或按计划运行这些自动化，以及如何查看运行结果。

部署前查看架构信息

在部署自动化之前，必须提交自动化以创建版本。有关更多信息，请参阅维护自动化版本。

提交带有输入或输出架构的自动化后，您可以在版本详细信息页面的数据模型部分查看架构详细信息。本部分显示输入和输出的完整字段定义。

使用输入和输出架构部署自动化

部署已定义输入或输出架构的自动化时，部署对话框将在数据模型部分显示架构信息，包括：

要完成部署，请查看架构信息并选择 Deploy。

手动运行已部署的自动化

要使用输入启动已部署的自动化，请完成以下步骤：

输入表单与您在 Studio 中测试时使用的表单相同。

使用计划触发器运行自动化

对于计划触发器，您可以在创建或编辑触发器时提供输入值。每次触发器触发时，存储的值都会传递给自动化。

您可执行以下操作：

要配置定时触发器的输入，请完成以下步骤：

查看已部署运行的输入和输出

自动化运行完成后（无论是手动启动还是通过计划触发器启动），输入和输出值将作为结构化构件显示在 “运行” 页面的日志面板中。

这些神器以专用卡牌的形式出现：

默认情况下，两张牌都处于折叠状态。当你扩展它们时，你可以：