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

aws:executeScript – 執行指令碼

執行使用指定的執行時間和處理程序提供的 Python 或 PowerShell 指令碼。每個 aws:executeScript 動作最久可執行 600 秒 (10 分鐘)。您可以透過指定 aws:executeScript 步驟的 timeoutSeconds 參數來限制逾時。

在函數中使用傳回陳述式將輸出加入輸出承載。有關 aws:executeScript 動作定義輸出的範例，請參閱 範例 2：指令碼式 Runbook。您也可以把 Runbook 的 aws:executeScript 動作輸出傳送到您指定的 Amazon CloudWatch Logs 日誌群組。如需詳細資訊，請參閱使用 CloudWatch Logs 記錄自動化動作輸出。

如果您想要將aws:executeScript動作的輸出傳送至 CloudWatch Logs，或者您為aws:executeScript動作指定的指令碼呼叫 AWS API 操作，則一律需要 AWS Identity and Access Management (IAM) 服務角色 （或擔任角色） 才能執行 Runbook。

aws:executeScript 動作包含下列預先安裝的 PowerShell Core 模組。

若要使用未預先安裝的 PowerShell Core 模組，您的指令碼必須使用 -Force 旗標安裝模組，如下列命令所示。不支援 AWSPowerShell.NetCore 模組。把 ModuleName (模組名稱) 取代為您想要安裝的模組。

Install-Module ModuleName -Force

若要在指令碼中使用 PowerShell Core Cmdlet，建議您使用 AWS.Tools 模組，如下列命令所示。將每個範例資源預留位置取代為您自己的資訊。

如果指令碼除了使用 PowerShell Core Cmdlet 之外，還會初始化新物件，您也必須匯入模組，如下列命令所示。

Install-Module AWS.Tools.EC2 -Force
Import-Module AWS.Tools.EC2

$tag = New-Object Amazon.EC2.Model.Tag
$tag.Key = "Tag"
$tag.Value = "TagValue"

New-EC2Tag -Resource i-02573cafcfEXAMPLE -Tag $tag

如需在 Runbook 內容中安裝和匯入 AWS.Tools 模組，以及使用 PowerShell Core Cmdlet 的範例，請參閱 Automation 執行手冊的視覺化設計體驗。

輸入

提供執行指令碼所需訊息。將每個範例資源預留位置取代為您自己的資訊。

YAML

action: "aws:executeScript"
inputs: 
 Runtime: runtime
 Handler: "functionName"
 InputPayload: 
  scriptInput: '{{parameterValue}}'
 Script: |-
   def functionName(events, context):
   ...
 Attachment: "scriptAttachment.zip"

JSON

{
    "action": "aws:executeScript",
    "inputs": {
        "Runtime": "runtime",
        "Handler": "functionName",
        "InputPayload": {
            "scriptInput": "{{parameterValue}}"
        },
        "Attachment": "scriptAttachment.zip"
    }
}

搭配 aws:executeScript 使用附件

附件提供了一種強大的方法，可將複雜的指令碼、多個模組和外部相依性與您的 aws:executeScript 動作一起封裝並重複使用。當您需要進行下列操作時，請使用附件：

附件結構和封裝

您可以連接單一檔案或是包含多個檔案的 zip 套件。結構取決於您的使用案例：

單一檔案附件

對於簡單的指令碼，您可以連接單一 .py 檔案 (Python) 或包含單一 PowerShell 指令碼的 .zip 檔案。

多模組套件

對於需要多個模組的複雜自動化，請以下列建議的結構建立 zip 套件：

my-automation-package.zip
├── main.py                    # Entry point script
├── utils/
│   ├── __init__.py           # Required for Python module imports
│   ├── helper_functions.py   # Utility functions
│   └── aws_operations.py     # AWS-specific operations
├── config/
│   ├── __init__.py
│   └── settings.py           # Configuration settings
└── requirements.txt          # Optional: document dependencies

PowerShell 套件結構

PowerShell 附件必須使用下列結構，封裝在 zip 檔案中：

my-powershell-package.zip
├── Main.ps1                  # Entry point script
├── Modules/
│   ├── HelperFunctions.ps1   # Utility functions
│   └── AWSOperations.ps1     # AWS-specific operations
└── Config/
    └── Settings.ps1          # Configuration settings

建立含有附件的執行手冊

請依照下列步驟建立使用附件的執行手冊：

aws:executeScript 附件範例

下列範例示範搭配 aws:executeScript 動作使用附件的不同方式。

範例 1：單一檔案附件

此範例說明如何使用單一 Python 檔案作為附件來處理 EC2 執行個體資料。

附件檔案：process_instance.py

使用下列內容建立 Python 檔案：

import boto3
import json

def process_instance_data(events, context):
    """Process EC2 instance data and return formatted results."""
    try:
        instance_id = events.get('instanceId')
        if not instance_id:
            raise ValueError("instanceId is required")
        
        ec2 = boto3.client('ec2')
        
        # Get instance details
        response = ec2.describe_instances(InstanceIds=[instance_id])
        instance = response['Reservations'][0]['Instances'][0]
        
        # Format the response
        result = {
            'instanceId': instance_id,
            'instanceType': instance['InstanceType'],
            'state': instance['State']['Name'],
            'availabilityZone': instance['Placement']['AvailabilityZone'],
            'tags': {tag['Key']: tag['Value'] for tag in instance.get('Tags', [])}
        }
        
        print(f"Successfully processed instance {instance_id}")
        return result
        
    except Exception as e:
        print(f"Error processing instance: {str(e)}")
        raise

完成執行手冊

下方是使用單一檔案附件的完整執行手冊：

description: Process EC2 instance data using single file attachment
schemaVersion: '0.3'
assumeRole: '{{AutomationAssumeRole}}'
parameters:
  AutomationAssumeRole:
    type: String
    description: (Required) IAM role for automation execution
  InstanceId:
    type: String
    description: (Required) EC2 instance ID to process

files:
  process_instance.py:
    checksums:
      sha256: "abc123def456..."

mainSteps:
  - name: processInstance
    action: aws:executeScript
    inputs:
      Runtime: python3.11
      Handler: process_instance.process_instance_data
      Attachment: process_instance.py
      InputPayload:
        instanceId: '{{InstanceId}}'
    outputs:
      - Type: StringMap
        Name: InstanceData
        Selector: $.Payload

outputs:
  - processInstance.InstanceData

範例 2：多模組套件

此範例示範如何使用包含多個 Python 模組的 zip 套件進行複雜的 S3 儲存貯體操作。

套件結構

使用下列結構建立 zip 套件：

s3-operations.zip
├── main.py
├── utils/
│   ├── __init__.py
│   ├── s3_helper.py
│   └── validation.py
└── config/
    ├── __init__.py
    └── settings.py

main.py (進入點)

協調操作的主要指令碼：

from utils.s3_helper import S3Operations
from utils.validation import validate_bucket_name
from config.settings import get_default_settings

def cleanup_s3_bucket(events, context):
    """Clean up S3 bucket based on specified criteria."""
    try:
        bucket_name = events.get('bucketName')
        max_age_days = events.get('maxAgeDays', 30)
        
        # Validate inputs
        if not validate_bucket_name(bucket_name):
            raise ValueError(f"Invalid bucket name: {bucket_name}")
        
        # Initialize S3 operations
        s3_ops = S3Operations()
        settings = get_default_settings()
        
        # Perform cleanup
        deleted_objects = s3_ops.delete_old_objects(
            bucket_name, 
            max_age_days,
            settings['dry_run']
        )
        
        result = {
            'bucketName': bucket_name,
            'deletedCount': len(deleted_objects),
            'deletedObjects': deleted_objects[:10],  # Return first 10 for brevity
            'dryRun': settings['dry_run']
        }
        
        print(f"Cleanup completed for bucket {bucket_name}")
        return result
        
    except Exception as e:
        print(f"Error during S3 cleanup: {str(e)}")
        raise

對 aws:executeScript 附件進行疑難排解

使用以下指引來解決 aws:executeScript 附件的常見問題：

模組匯入錯誤

如果您在使用多模組套件時收到匯入錯誤：

找不到附件錯誤

如果您的 Automation 無法找到附件：

處理常式函數錯誤

如果您收到與處理常式相關的錯誤：

指令碼執行失敗

如果您的指令碼在執行期間失敗：

結束程式碼和錯誤處理

若要正確處理錯誤並傳回結束程式碼：