AWS-UpdateLinuxAmi - AWS Systems Manager オートメーションランブックリファレンス

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWS-UpdateLinuxAmi

説明

Linux ディストリビューションパッケージと Amazon のソフトウェアを使用して、Amazon Machine Image (AMI) を更新します。

このオートメーションを実行する (コンソール)

ドキュメントタイプ

オートメーション

[所有者]

Amazon

[Platforms] (プラットフォーム)

Linux

パラメータ

  • AutomationAssumeRole

    タイプ: 文字列

    説明: (オプション) Systems Manager Automation がユーザーに代わってアクションを実行できるようにする AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN)。ロールを指定しない場合、Systems Manager Automation はこのランブックを開始するユーザーのアクセス許可を使用します。

    許可されたパターン: ^$|^arn:aws[a-z0-9-]*:iam::(\d{12}|\{\{global:ACCOUNT_ID\}\}):role/[\w/.@+=,-]{1,1017}$

    • 有効な IAM ロール ARN または空の文字列である必要があります。システム変数{{global:ACCOUNT_ID}}は、ARN の AWS アカウント ID の代わりに使用できます。

  • ExcludePackages

    タイプ: 文字列

    デフォルト: なし

    説明: (オプション) すべての条件の下で、更新を保留するパッケージの名前。デフォルト ("none") では、パッケージは除外されません。

    許可されたパターン: ^(none|[a-zA-Z0-9\s,._+:=<>()\[\]/*-]+)$

    • 「なし」、または文字、数字、スペース、および次の文字で構成される項目のカンマ区切りリストである必要があります。 , . _ + : = < > ( ) [ ] / * -

  • IamInstanceProfileName

    タイプ: 文字列

    デフォルト: ManagedInstanceProfile

    説明: (必須) インスタンスを管理できるよう Systems Manager を有効にするインスタンスプロファイル。

    許可されたパターン: ^[\w+=,.@-]{1,128}$

    • 1~128 文字で、文字、数字、およびこれらの文字のみを含める必要があります。 + = , . @ - _

  • IncludePackages

    タイプ: 文字列

    デフォルト: all

    説明: (オプション) これらの名前付きパッケージのみを更新します。デフォルト ("all") では、すべての利用可能な更新が適用されます。

    許可されたパターン: ^(all|[a-zA-Z0-9\s,._+:=<>()\[\]/*-]+)$

    • 「すべて」、または文字、数字、スペース、および次の文字で構成されるカンマ区切りの項目リストである必要があります。 , . _ + : = < > ( ) [ ] / * -

  • InstanceType

    タイプ: 文字列

    デフォルト: t2.micro

    説明: (オプション) ワークスペースホストとして起動するインスタンスの種類。インスタンスタイプは、リージョンによって異なります。

    許可されたパターン: ^[a-z0-9]+(-[a-z0-9]+)*\.[a-z0-9]+$

    • 両方の部分に小文字と数字が含まれ、プレフィックスにハイフンが含まれる可能性がある prefix.suffix の形式である必要があります。

  • MetadataOptions

    型: StringMap

    デフォルト: {"HttpEndpoint": "enabled", "HttpTokens": "optional"}

    説明: (オプション) インスタンスのメタデータオプション。詳細については、「InstanceMetadataOptionsRequest」を参照してください。

    許可されたパターン: ^\{[^<>\$;|&\\]*\}$

    • 中括弧 { } でラップする必要があり、次の文字を含めることはできません。 < > $ ; | & \

  • PostUpdateScript

    タイプ: 文字列

    デフォルト: なし

    説明: (オプション) パッケージの更新の適用後に実行するスクリプトの URL。デフォルト ("none") は、スクリプトを実行しません。

    許可されたパターン: ^(none|https?://[\w\-._~:/?#\[\]@!$&'()*+,;=%]+)$

    • 「なし」または有効な HTTP/HTTPS URL である必要があります

  • PreUpdateScript

    タイプ: 文字列

    デフォルト: なし

    説明: (オプション) 更新の適用前に実行するスクリプトの URL。デフォルト ("none") は、スクリプトを実行しません。

    許可されたパターン: ^(none|https?://[\w\-._~:/?#\[\]@!$&'()*+,;=%]+)$

    • 「なし」または有効な HTTP/HTTPS URL である必要があります

  • SecurityGroupIds

    タイプ: 文字列

    説明: (必須) に適用するセキュリティグループの IDs のカンマ区切りリストAMI。

    許可されたパターン: ^sg-[a-z0-9]{8,17}$

    • 「sg-」で始まり、その後に 8~17 個の小文字または数字が続く必要があります

  • SourceAmiId

    タイプ: 文字列

    説明: (必須) Amazon マシンイメージ ID のソース。

    許可されたパターン: ^ami-[a-z0-9]{8,17}$

    • 「ami-」で始まり、その後に 8~17 個の小文字または数字が続く必要があります

  • SubnetId

    タイプ: 文字列

    説明: (オプション) インスタンスを起動するサブネットの ID。デフォルトの VPC を削除した場合は、このパラメータは必須です。

    許可されたパターン: ^$|^subnet-[a-z0-9]{8,17}$

    • 空にするか、「subnet-」で始まり、その後に 8~17 個の小文字または数字が続く必要があります

  • TargetAmiName

    タイプ: 文字列

    デフォルト: UpdateLinuxAmi_from_{{SourceAmiId}}_on_{{global:DATE_TIME}}

    説明: (オプション) 作成される新しい AMI の名前。デフォルトは、ソース AMI ID および作成日時を含む、システム生成文字列です。

    許可されたパターン: ^[a-zA-Z0-9()\[\]\{\} ./'@_:-]{3,128}$

    • 3~128 文字で、文字、数字、スペース、およびこれらの文字のみを含める必要があります。 ( ) [ ] { } . / ' @ _ : -