本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

部署自動化

在 Amazon Quick Automate 中建立和測試自動化之後，下一步是部署它們，以便它們可以在觸發時定期執行。部署可讓自動化運作並準備好執行。您可以將觸發新增至部署的自動化，以預先定義的排程執行它。部署涉及設定執行時間設定、為human-in-the-loop任務指派使用者、驗證登入資料和整合。

本節說明部署程序的每個步驟，以及如何設定自動化以取得可靠性、安全性和最佳效能。

先決條件

部署自動化之前，請確定下列步驟已完成：

部署自動化

您可以按一下部署，或導覽至自動化登陸頁面上的部署索引標籤，直接從 Canvas 部署自動化。啟動部署後，系統會引導您完成一系列步驟，以完成組態和發行程序。

版本詳細資訊

在版本詳細資訊頁面上，選取您要部署的自動化版本。只有遞交的版本可供部署，且會出現在下拉式清單中。

其他設定

其他設定包括：

執行時期組態

執行期組態是不同環境的參數，例如開發、測試和生產。

例如，傳送電子郵件的自動化步驟可能會在測試期間使用您的個人電子郵件地址，但應該切換到生產環境中的共用團隊地址。編寫自動化時，這類環境相關值可以定義為執行時間組態。

在部署時間，您可以檢閱和覆寫這些組態，以確保自動化在預期環境中正確執行。執行期參數可能包括：

此彈性有助於跨環境維持單一自動化定義，同時視需要調整關鍵參數。

任務​

為需要human-in-the-loop的每個任務選取解析程式使用者或使用者群組。

存取 （憑證和連線）

自動化通常需要連線到外部系統、資料庫或服務。Amazon Quick Automate 提供安全方法來管理登入資料和連線，而無需在自動化邏輯中內嵌敏感資訊。

連線和登入資料會安全地存放和加密，並在執行時間提供給工作流程，而不會向作者或最終使用者公開。此設計可確保將秘密與自動化定義緊密分離，同時改善安全性和可維護性。

您可以存放和使用兩種主要的登入資料類型：

在部署時，請確定已選取正確的登入資料和連線，以便自動化能夠安全且成功地存取所有必要的系統。

設定觸發條件

觸發會決定自動化執行的時間和方式。您可以將自動化設定為根據預先定義的排程開始，或透過 Amazon QuickSight API 以程式設計方式叫用。

排程

您可以設定自動化以根據預先定義的排程開始。若要設定觸發條件：

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 目標僅部署自動化。您必須先在 Amazon Quick Automate 主控台中遞交和部署自動化，才能透過 API 叫用它。

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 中測試時使用的表單相同。

使用排程觸發程序執行自動化

對於排程觸發，您可以在建立或編輯觸發時提供輸入值。每次觸發觸發時，儲存的值都會傳遞至自動化。

您可以執行下列動作：

若要設定排程觸發的輸入，請完成下列步驟：

檢視已部署執行的輸入和輸出

自動化執行完成後 （無論是手動啟動還是排程觸發程序啟動），在執行頁面的日誌面板中，輸入和輸出值會以結構化成品的形式提供。

成品會顯示為專用卡片：

根據預設，兩張卡片都會收合。當您展開它們時，您可以：