创建运行脚本的运行手册（命令行） - Amazon Systems Manager
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

创建运行脚本的运行手册（命令行）

以下示例说明了如何使用 Amazon CLI 或 Amazon Tools for PowerShell 创建使用 Attachment 参数运行脚本的运行手册。

开始前的准备工作

在开始之前，请确保您准备好了以下资源。

  • 作为具有 .yaml 扩展名的 YAML 格式文件的运行手册的内容，例如 MyAutomationDocument.yaml。

  • 要附加到运行手册的文件。您可以附加脚本文件或 .zip 文件。

    对于脚本，自动化支持 Python 3.6 和 3.7 以及 PowerShell Core 6.0。

  • 安装并配置 Amazon CLI 或 Amazon Tools for PowerShell（如果尚未执行该操作）。

    想要了解有关信息，请参阅安装或升级 Amazon 命令行工具.

附加 S3 存储桶中的单个文件

运行以下命令，以使用 S3 存储桶中存储的脚本文件创建运行手册。

Linux & macOS
aws ssm create-document \
  --name CustomAutomationScript \
  --content file://Runbook.yaml \
  --document-format YAML \
  --attachments "Key=S3FileUrl,Name=script.py,Values=https://DOC-EXAMPLE-BUCKET.s3-aws-region.amazonaws.com/filePath" \
  --document-type Automation
Windows
aws ssm create-document ^
  --name CustomAutomationScript ^
  --content file://AutomationDocument.yaml ^
  --document-format YAML ^
  --attachments Key=S3FileUrl,Name=script.py,Values="https://DOC-EXAMPLE-BUCKET.s3-aws-region.amazonaws.com/filePath" ^
  --document-type Automation
PowerShell
New-SSMDocument `
  -Name CustomAutomationScript `
  -Content file://AutomationDocument.yaml `
  -DocumentFormat YAML `
  -Attachments @{
      "Key"="S3FileUrl";
      "Name"="script.py";
      "Values"="https://DOC-EXAMPLE-BUCKET.s3-aws-region.amazonaws.com/filePath"
    }, @{
      "Key"="S3FileUrl";
      "Name"="Zip-file.zip";
      "Values"="https://DOC-EXAMPLE-BUCKET.s3-aws-region.amazonaws.com/filePath"
    } `
  -DocumentType Automation

附加 S3 存储桶中的文件

运行以下命令，以使用 S3 存储桶中存储的一个或多个脚本文件创建运行手册。未指定文件的 Name 密钥。该命令附加 S3 存储桶位置中的所有支持的文件。

Linux & macOS
aws ssm create-document \
  --name CustomAutomationScript \
  --content file://Runbook.yaml \
  --document-format YAML \
  --attachments Key=SourceUrl,Values="https://DOC-EXAMPLE-BUCKET.s3-aws-region.amazonaws.com/filePath" \
  --document-type Automation
Windows
aws ssm create-document ^
  --name CustomAutomationScript ^
  --content file://Runbook.yaml ^
  --document-format YAML ^
  --attachments Key=SourceUrl,Values="https://DOC-EXAMPLE-BUCKET.s3-aws-region.amazonaws.com/filePath" ^
  --document-type Automation
PowerShell
New-SSMDocument `
  -Name CustomAutomationScript `
  -Content file://Runbook.yaml `
  -DocumentFormat YAML `
  -Attachments @{
      "Key"="SourceUrl";
      "Values"="https://DOC-EXAMPLE-BUCKET.s3-aws-region.amazonaws.com/filePath"
    } `
  -DocumentType Automation

附加来自 Amazon Web Services 账户 中的另一个运行手册的文件

运行以下命令以使用已附加到您账户中另一个运行手册的脚本创建运行手册。

此命令中键值的格式是 runbook-name/runbook-version-number/file-name。请参阅以下 示例。

"MyDocument/2/script.py"
Linux & macOS
aws ssm create-document \
  --name CustomAutomationScript \
  --content file://Runbook.yaml \
  --document-format YAML \
  --attachments Key=AttachmentReference,Values="runbook-name/runbook-version-number/file-name" \
  --document-type Automation
Windows
aws ssm create-document ^
  --name CustomAutomationScript ^
  --content file://Runbook.yaml ^
  --document-format YAML ^
  --attachments Key=AttachmentReference,Values="runbook-name/runbook-version-number/file-name" ^
  --document-type Automation
PowerShell
New-SSMDocument `
  -Name CustomAutomationScript `
  -Content file://Runbook.yaml `
  -DocumentFormat YAML `
  -Attachments @{
      "Key"="AttachmentReference";
      "Values"="runbook-name/runbook-version-number/file-name"
    } `
  -DocumentType Automation

附加来自另一个 Amazon Web Services 账户 中运行手册的文件

运行以下命令以使用已附加到已从另一个 Amazon Web Services 账户 与您共享的运行手册的脚本创建运行手册。

此命令中键值的格式是 runbook-arn/runbook-version-number/file-name。请参阅以下 示例。

"arn:aws:ssm:us-east-2:123456789012:document/OtherAccountDocument/2/script.py"
Linux & macOS
aws ssm create-document \
  --name CustomAutomationScript \
  --content file://Runbook.yaml \
  --document-format YAML \
  --attachments Key=AttachmentReference,Values="runbook-arn/runbook-version-number/file-name/file-name" \
  --document-type Automation
Windows
aws ssm create-document ^
  --name CustomAutomationScript ^
  --content file://Runbook.yaml ^
  --document-format YAML ^
  --attachments Key=AttachmentReference,Values="runbook-arn/runbook-version-number/file-name" ^
  --document-type Automation
PowerShell
New-SSMDocument `
  -Name CustomAutomationScript `
  -Content file://Runbook.yaml `
  -DocumentFormat YAML `
  -Attachments @{
      "Key"="AttachmentReference";
      "Values"="runbook-arn/runbook-version-number/file-name"
    } `
  -DocumentType Automation