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

# 第三方
<a name="automation-ref-third-party"></a>

 AWS Systems Manager 自動化為第三方產品和服務提供預先定義的 Runbook。如需有關執行手冊的詳細資訊，請參閱 [Working with runbooks](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-documents.html)。如需如何檢視 Runbook 內容的詳細資訊，請參閱 [檢視 Runbook 內容](automation-runbook-reference.md#view-automation-json)。

**Topics**
+ [`AWS-CreateJiraIssue`](automation-aws-createjiraissue.md)
+ [`AWS-CreateServiceNowIncident`](automation-aws-createservicenowincident.md)
+ [`AWS-RunPacker`](automation-aws-runpacker.md)

# `AWS-CreateJiraIssue`
<a name="automation-aws-createjiraissue"></a>

 **Description** 

在 Jira 建立問題。

 [執行此自動化 （主控台）](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-CreateJiraIssue) 

**文件類型**

 自動化

**擁有者**

Amazon

**平台**

Linux、macOS、 Windows

**參數**
+ AssigneeName

  類型：字串

  描述：(選用) 應指派問題之人員的使用者名稱。
+ DueDate

  類型：字串

  描述：(選用) 問題的到期日，格式為 yyyy-mm-dd。
+ IssueDescription

  類型：字串

  描述：(必要) 問題的詳細說明。
+ IssueSummary

  類型：字串

  描述：(必要) 問題的簡要說明。
+ IssueTypeName

  類型：字串

  描述：(必要) 您要建立的問題類型名稱 (例如，任務、子任務、錯誤等)。
+ JiraURL

  類型：字串

  描述：(必要) Jira 執行個體的 URL。
+ JiraUsername

  類型：字串

  描述：(必要) 要建立問題的使用者名稱。
+ PriorityName

  類型：字串

  描述：(選用) 問題優先順序的名稱。
+ ProjectKey

  類型：字串

  描述：(必要) 應該在其中建立問題之專案的金鑰。
+ SSMParameterName

  類型：字串

  描述：(必要) 包含 Jira 使用者 API 金鑰或密碼之加密 SSM 參數的名稱。

 **文件步驟** 

 `aws:createStack` - 建立 CloudFormation 堆疊以建立 Lambda IAM 角色和函數。

 `aws:invokeLambdaFunction` - 叫用 Lambda 函數來建立 Jira 問題 

 `aws:deleteStack` - 刪除建立的 CloudFormation 堆疊。

 **輸出** 

IssueId：新建立的 Jira 問題 ID

# `AWS-CreateServiceNowIncident`
<a name="automation-aws-createservicenowincident"></a>

 **Description** 

在 ServiceNow 事件表格中建立事件。

 [執行此自動化 （主控台）](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-CreateServiceNowIncident) 

**文件類型**

 自動化

**擁有者**

Amazon

**平台**

Linux、macOS、 Windows

**參數**
+ AutomationAssumeRole

  類型：字串

  描述：（選用） 允許 Systems Manager Automation 代表您執行動作的 (IAM) 角色的 AWS Identity and Access Management Amazon Resource Name (ARN)。如果未指定角色，Systems Manager Automation 會使用啟動此 Runbook 之使用者的許可。
+ Category 

  類型：字串

  描述：(選用) 事件的類別。

  有效值：無 \$1 查詢/說明 \$1 軟體 \$1 硬體 \$1 網路 \$1 資料庫

  預設值：無
+ Description

  類型：字串

  描述：(必要) 有關事件的詳細說明。
+ 影響

  類型：字串

  摘要：(選用) 事件對業務造成的影響。

  有效值：高 \$1 中 \$1 低

  預設值：低
+ ServiceNowInstanceUsername

  類型：字串

  描述：(必要) 要建立事件的使用者名稱。
+ ServiceNowInstancePassword

  類型：字串

  描述：(必要) 包含 ServiceNow 使用者密碼之加密 SSM 參數的名稱。
+ ServiceNowInstanceURL

  類型：字串

  描述：(必要) ServiceNow 執行個體的 URL
+ ShortDescription

  類型：字串

  描述：(必要) 事件的簡短描述。
+ Subcategory

  類型：字串

  描述：(選用) 事件的子類別。

  有效值：無 \$1 防毒 \$1 電子郵件 \$1 內部應用程式 \$1 作業系統 \$1 CPU \$1 磁碟 \$1 鍵盤 \$1 硬體 \$1 記憶體 \$1 監視器 \$1 滑鼠 \$1 DHCP \$1 DNS \$1 IP 地址 \$1 VPN \$1 無線 \$1 DB2 \$1 MS SQL Server \$1 Oracle 

  預設值：無

 **文件步驟** 

Push\$1incident – 將事件資訊推送至 ServiceNow。

 **輸出** 

Push\$1incident.incidentID – 建立的事件 ID。

# `AWS-RunPacker`
<a name="automation-aws-runpacker"></a>

 **Description** 

 此 Runbook 使用 HashiCorp [Packer](https://www.packer.io/) 工具來驗證、修正或建置用於建立機器映像的套件範本。此 Runbook 使用 Packer v1.7.2。

**注意**  
 如果您指定 `vpc_id` 值，也必須指定公用子網路的 `subnet_id` 值。除非您修改子網路的 IPv4 公用定址屬性，否則您也必須將 `associate_public_ip_address` 設定為 true。

 [執行此自動化 （主控台）](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-RunPacker) 

**文件類型**

 自動化

**擁有者**

Amazon

**平台**

Linux、macOS、 Windows

**參數**
+ AutomationAssumeRole

  類型：字串

  描述：（選用） 允許 Systems Manager Automation 代表您執行動作的 (IAM) 角色的 AWS Identity and Access Management Amazon Resource Name (ARN)。如果未指定角色，Systems Manager Automation 會使用啟動此 Runbook 之使用者的許可。
+ Force

  類型：布林值

  描述：一個 Packer 選項，以強制建置器在成品來自舊版建置時執行，否則防止建置執行。
+ Mode

  類型：字串

   描述：對範本進行驗證時要使用 Packer 的模式或命令。選項包括 `Build` 、 `Validate` 和 `Fix` 。
+ TemplateFileName

  類型：字串

  描述：S3 儲存貯體中範本檔案的名稱或鍵。
+ TemplateS3BucketName

  類型：字串

  描述：包含套件程式範本的 S3 儲存貯體名稱。

 **文件步驟** 

RunPackerProcessTemplate – 使用 Packer 工具對範本執行選取的模式。

 **輸出** 

RunPackerProcessTemplate.output – Packer 工具中的 stdout。

RunPackerProcessTemplate.fixed\$1template\$1key – 存放在 S3 儲存貯體中的範本名稱，僅在「固定」模式下執行時使用。

RunPackerProcessTemplate.s3\$1bucket – S3 儲存貯體的名稱，其中包含僅在「固定」模式下執行時使用的固定範本。