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

# `AWSPremiumSupport-ChangeInstanceTypeIntelToAMD`
<a name="automation-aws-changeinstancetypeinteltoamd"></a>

 **説明** 

`AWSPremiumSupport-ChangeInstanceTypeIntelToAMD` ランブックでは、Intel 搭載の Amazon Elastic Compute Cloud (Amazon EC2) インスタンスから同等の AMD 搭載インスタンスタイプへの移行を自動化します。このランブックは、Nitro システムで構築された汎用 (M)、バースタブル汎用 (T)、コンピューティング最適化 (C)、およびメモリ最適化 (R) インスタンスをサポートします。このランブックは、Systems Manager によって管理されていないインスタンスでも使用できます。

データ損失やダウンタイムの潜在的なリスクを軽減するために、ランブックはインスタンスの停止動作、インスタンスが Amazon EC2 Auto Scaling グループに属しているかどうか、インスタンスの状態、および同等の AMD 搭載インスタンスタイプが同じアベイラビリティーゾーンで利用可能かどうかをチェックします。デフォルトでは、インスタンスストアボリュームがアタッチされている場合、またはインスタンスが AWS CloudFormation スタックの一部である場合、このランブックはインスタンスタイプを変更しません。この動作を変更する場合は、`AllowInstanceStoreInstances` および `AllowCloudFormationInstances` パラメータのいずれかに `yes` を指定してください。

**重要**  
`AWSPremiumSupport-*` ランブックにアクセスするには、Business \$1 Support、Enterprise Support、または Unified Operations Subscription が必要です。詳細については、[「 AWS サポート プランの比較」](https://aws.amazon.com/premiumsupport/plans/)を参照してください。

 **考慮事項** 
+ このランブックを使用する前にインスタンスをバックアップすることをおすすめします。
+ インスタンスタイプを変更すると、ランブックでインスタンスを停止する必要があります。インスタンスが停止すると、RAM またはインスタンスストアボリュームに保存されているデータはすべて失われ、自動パブリック IPv4 アドレスは解放されます。詳細については、「[インスタンスの停止と起動](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Stop_Start.html)」を参照してください。
+ `TargetInstanceType` パラメータに値を指定しない場合、ランブックは同じインスタンスファミリー内の仮想 CPU とメモリの観点から同等の AMD インスタンスを識別しようとします。同等の AMD インスタンスタイプを特定できない場合、ランブックは終了します。
+ `DryRun` オプションを使用すると、インスタンスタイプを実際に変更しなくても、同等の AMD インスタンスタイプを取得して要件を検証できます。

 [このオートメーションを実行する (コンソール)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSPremiumSupport-ChangeInstanceTypeIntelToAMD) 

**ドキュメントタイプ**

オートメーション

**[所有者]**

Amazon

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

Linux、macOS、Windows

**パラメータ**
+ AutomationAssumeRole

  タイプ: 文字列

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

  タイプ: 文字列

  説明: (必須) 現在実行中のターゲットインスタンスが停止することを確認するには `yes` を入力してください。
+ InstanceId

  タイプ: 文字列

  説明: (必須) タイプを変更する Amazon EC2 インスタンスの ID。
+ TargetInstanceType

  タイプ: 文字列

  デフォルト: 自動

  説明: (オプション) 変更したい AMD インスタンスのタイプ。デフォルトの `automatic` 値では、仮想 CPU とメモリに関しては同等のインスタンスタイプを使用します。たとえば、m5.large は m5a.large に変更されます。
+ AllowInstanceStoreInstances

  タイプ: 文字列

  有効な値: no \$1 yes

  デフォルト: いいえ

  説明: (オプション) `yes` を指定すると、インスタンスストアボリュームがアタッチされているインスタンスでランブックを実行できるようになります。
+ AllowCloudFormationInstances

  タイプ: 文字列

  有効な値: no \$1 yes

  デフォルト: いいえ

  説明: (オプション) に設定すると`yes`、ランブックは CloudFormation スタックの一部であるインスタンスで実行されます。
+ AllowCrossGeneration

  タイプ: 文字列

  有効な値: no \$1 yes

  デフォルト: いいえ

  説明: (オプション) `yes` に設定すると、ランブックは同じインスタンスファミリー内の最新かつ同等の AMD インスタンスタイプを検索しようとします。
+ DryRun

  タイプ: 文字列

  有効な値: no \$1 yes

  デフォルト: いいえ

  説明: (オプション) `yes` に設定すると、ランブックは同等の AMD インスタンスタイプを返し、インスタンスタイプを変更せずに移行要件を検証します。
+ SleepWait

  タイプ: 文字列

  デフォルト: PT3S

  説明: (オプション) 新しい自動化を開始する前にランブックが待機する必要がある時間です。このパラメータに指定する値は、ISO 8601 標準と一致する必要があります。ISO 8601 文字列の作成の詳細については、[「Systems Manager の日付と時刻の文字列のフォーマット」](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-datetime-strings.html#systems-manager-datetime-strings-format)を参照してください。

**必要な IAM アクセス許可**

`AutomationAssumeRole` パラメータでは、ランブックを正常に使用するために、次のアクションが必要です。
+  `ssm:DescribeAutomationExecutions` 
+  `ssm:GetAutomationExecution` 
+  `ssm:StartAutomationExecution` 
+  `ec2:GetInstanceTypesFromInstanceRequirements` 
+  `ec2:DescribeInstanceAttribute` 
+  `ec2:DescribeInstances` 
+  `ec2:DescribeInstanceStatus` 
+  `ec2:DescribeInstanceTypeOfferings` 
+  `ec2:DescribeInstanceTypes` 
+  `ec2:DescribeTags` 
+  `ec2:ModifyInstanceAttribute` 
+  `ec2:StartInstances` 
+  `ec2:StopInstances` 

 **ドキュメントステップ** 

1. `aws:assertAwsResourceProperty`: ターゲット Amazon EC2 インスタンスのステータスが`running`、`pending`、`stopped` または `stopping` であることを確認します。それ以外の場合、自動化は終了します。

1. `aws:executeAwsApi`: ターゲット Amazon EC2 インスタンスからプロパティを収集します。

1. `aws:branch`: Amazon EC2 インスタンスの状態に基づいて自動化を分岐します。

   1. `stopped` または `stopping` の場合、Amazon EC2 インスタンスが完全に停止するまで自動化が `aws:waitForAwsResourceProperty` を実行します。

   1. `running` または `pending` の場合、Amazon EC2 インスタンスがステータスチェックに合格するまで自動化が `aws:waitForAwsResourceProperty` を実行します。

1. `aws:assertAwsResourceProperty`: `aws:autoscaling:groupName` タグが適用されているかどうかを確認することで、Amazon EC2 インスタンスが Auto Scaling グループに含まれていないことを確認します。

1. `aws:executeAwsApi`: 現在のインスタンスタイププロパティを収集して、同等の AMD インスタンスタイプを見つけます。

1. `aws:assertAwsResourceProperty`: AWS Marketplace 製品コードが Amazon EC2 インスタンスに関連付けられていないことを確認します。一部の製品は、すべてのインスタンスタイプで使用できるわけではありません。

1. `aws:branch`: Amazon EC2 インスタンスが CloudFormation スタックの一部であるかどうかをオートメーションで確認するかどうかに応じて、オートメーションを分岐させます

   1. `aws:cloudformation:stack-name` タグがインスタンスに適用されると、オートメーションが実行され`aws:assertAwsResourceProperty`、インスタンスが CloudFormation スタックの一部ではないことが確認されます。

1. `aws:branch`: インスタンスのルートボリュームタイプが Amazon Elastic Block Store (Amazon EBS) であるかどうかに基づいて自動化を分岐させます。

1. `aws:assertAwsResourceProperty`: インスタンスのシャットダウン動作が `stop` であり、`terminate`ではないことを確認します。

1. `aws:executeScript`: 現在のインスタンスをターゲットとするこのランブックの自動化が 1 つしかないことを確認します。同じインスタンスをターゲットとする別の自動化がすでに進行中の場合は、エラーを返して終了します。

1. `aws:executeAwsApi`: 同じ量のメモリと vCPU を搭載した AMD インスタンスタイプのリストを返します。

1. `aws:executeScript`: 現在のインスタンスタイプがサポートされているかどうかを確認し、同等の AMD インスタンスタイプを返します。対応するものがない場合は、自動化は終了します。

1. `aws:executeScript`: AMD インスタンスタイプが同じアベイラビリティーゾーンで利用可能であることを確認し、提供された IAM 権限を検証します。

1. `aws:branch`: `DryRun` パラメータ値が `yes` であるかどうかに基づいて自動化を分岐させます。

1. `aws:branch`: 元のインスタンスタイプとターゲットインスタンスタイプが同じかどうかを確認します。一致する場合、自動化は終了します。

1. `aws:executeAwsApi`: 現在のインスタンスの状態を取得します。

1. `aws:changeInstanceState`: Amazon EC2 インスタンスを停止します。

1. `aws:changeInstanceState`: インスタンスが停止の状態で動かなくなった場合、インスタンスを強制的に停止します。

1. `aws:executeAwsApi`: インスタンスタイプをターゲットの AMD インスタンスタイプに変更します。

1. `aws:sleep`: インスタンスタイプを変更した後、最終的に一貫性が保たれるまで 3 秒間待ちます。

1. `aws:branch`: 前のインスタンスの状態に基づいて自動化を分岐します。`running` であった場合、インスタンスが起動されます。

   1. `aws:changeInstanceState`: インスタンスタイプを変更する前に Amazon EC2 インスタンスが起動していた場合、Amazon EC2 インスタンスを起動します。

   1. `aws:waitForAwsResourceProperty`: Amazon EC2 インスタンスがステータスチェックに合格するのを待ちます。インスタンスがステータスチェックに合格しない場合、インスタンスは元のインスタンスタイプに戻されます。

      1. `aws:changeInstanceState`: Amazon EC2 インスタンスを停止してから、元のインスタンスタイプに変更します。

      1. `aws:changeInstanceState`: Amazon EC2 インスタンスが停止状態で停止した場合に、元のインスタンスタイプに変更する前に強制的に Amazon EC2 インスタンスを停止します。

      1. `aws:executeAwsApi`: Amazon EC2 インスタンスを元のタイプに変更します。

      1. `aws:sleep`: インスタンスタイプを変更した後、最終的に一貫性が保たれるまで 3 秒間待ちます。

      1. `aws:changeInstanceState`: インスタンスタイプを変更する前に Amazon EC2 インスタンスが起動していた場合、Amazon EC2 インスタンスを起動します。

      1. `aws:waitForAwsResourceProperty`: Amazon EC2 インスタンスがステータスチェックに合格するのを待ちます。

1. `aws:sleep`: ランブックを終了するまで待ちます。