ゾーンオートシフト AWS CLI での の使用例

このセクションでは、 を使用して Amazon Application Recovery Controller (ARC) のゾーンオートシフト機能を API オペレーションを使用して操作 AWS Command Line Interface する、ゾーンオートシフトを使用する簡単なアプリケーション例について説明します。この例は、 CLI を使用してゾーンオートシフトを操作する方法の基本的な理解に役立つことを目的としています。

ゾーンオートシフトは ARC の機能です。ゾーンオートシフトを使用すると、 がユーザーに代わってイベント中にサポートされているアプリケーションリソーストラフィックをアベイラビリティーゾーンから遠ざけることを承認 AWS し、復旧までの時間を短縮できます。ゾーンオートシフトには練習実行が含まれており、トラフィックをアベイラビリティーゾーンから遠ざけて、オートシフトがアプリケーションにとって安全であることを確認するのに役立ちます。

詳細については、「サポート リソース」を参照してください。

このセクションでは、ゾーンオートシフトの始め方と操作方法を説明するために、以下の例を紹介します。

• リソースの練習実行設定を作成します。

• リソースのオートシフトを有効または無効にします。

• 練習実行によって開始されたゾーンシフトをキャンセルして、進行中の練習実行を終了します。

• リソースのゾーンオートシフト機能を無効にすることによって、進行中のオートシフトを終了します。

• リソースの練習実行設定を編集して、指定したアラーム、ブロックされた日付または時間枠を変更します。

• リソースの練習実行設定を作成します。

の使用の詳細については AWS CLI、AWS CLI 「 コマンドリファレンス」を参照してください。ゾーンオートシフト API アクションのリストと詳細情報へのリンクについては、「ゾーンオートシフト API オペレーション」を参照してください。

練習実行設定を作成する

リソースのゾーンオートシフトを有効にする前に、リソースの練習実行設定を作成し、必要な練習実行のオプションを選択する必要があります。create-practice-run-configuration コマンドを使用して CLI でリソースの練習実行設定を作成します。

リソースの練習実行設定を作成するときは、次の点に注意してください。

• 現時点でサポートされているアラームタイプは CLOUDWATCH のみです。

• リソースがデプロイされている AWS リージョン のと同じ にあるアラームを使用する必要があります。

• 結果アラームを指定する必要があります。ブロッキングアラームの指定はオプションです。

• ブロックする日付またはブロックする時間枠の指定はオプションです。

create-practice-run-configuration コマンドを使用して CLI で練習実行設定を作成します。

例えば、リソースの練習実行設定を作成するには、次のようなコマンドを使用します。

aws arc-zonal-shift create-practice-run-configuration \
      --resource-identifier="arn:aws:elasticloadbalancing:Region:111122223333:ExampleALB123456890" \
      --outcome-alarms type=CLOUDWATCH,alarmIdentifier=arn:aws:cloudwatch:Region:111122223333:alarm:Region-MyAppHealthAlarm \
      --blocking-alarms type=CLOUDWATCH,alarmIdentifier=arn:aws:cloudwatch:Region:111122223333:alarm:Region-BlockWhenALARM \
      --blocked-dates 2023-12-01 --blocked-windows Mon:10:00-Mon:10:30

{
   "arn": "arn:aws:elasticloadbalancing:us-west-2:111122223333:ExampleALB123456890",
   "name": "zonal-shift-elb"
   "zonalAutoshiftStatus": "DISABLED",
   "practiceRunConfiguration": {
       "blockingAlarms": [
                  {
               "type": "CLOUDWATCH",
               "alarmIdentifier": "arn:aws:cloudwatch:us-west-2:111122223333:alarm:us-west-2-BlockWhenALARM"
           }
       ]
       "outcomeAlarms": [
           {
               "type": "CLOUDWATCH",
               "alarmIdentifier": "arn:aws:cloudwatch:us-west-2:111122223333:alarm:us-west-2-MyAppHealthAlarm"
           }
       ],
       "blockedWindows": [
           "Mon:10:00-Mon:10:30"
       ],
       "blockedDates": [
           "2023-12-01"
       ]
}

オートシフトを有効または無効にする

リソースのオートシフトを有効または無効にするには、CLI でゾーンオートシフトのステータスを更新します。ゾーンオートシフトのステータスを変更するには、update-zonal-autoshift-configuration コマンドを使用します。

例えば、リソースのオートシフトを有効にするには、次のようなコマンドを使用します。

aws arc-zonal-shift update-zonal-autoshift-configuration \
      --resource-identifier="arn:aws:elasticloadbalancing:Region:111122223333:ExampleALB123456890" \
      --zonal-autoshift-status="ENABLED"

{
   "resourceIdentifier": "arn:aws:elasticloadbalancing:us-west-2:111122223333:ExampleALB123456890",
   "zonalAutoshiftStatus": "ENABLED"
}

進行中のオートシフトをキャンセルする

リソースの進行中のオートシフトをキャンセルするには、ゾーンオートシフト機能を無効にします。これは、一般にゾーンオートシフトを無効にするために使用するコマンドと同じであるため、ゾーンオートシフトを無効にして進行中のオートシフトをキャンセルしても、リソースは将来のオートシフトの影響を受けません。ゾーンオートシフトを更新して、いつでも再び有効にすることができます。

リソースの練習実行設定を削除しなくても、リソースのゾーンオートシフトを無効にできることに注意してください。

CLI でオートシフトをキャンセルするには、update-zonal-autoshift-configuration コマンドを使用してゾーンオートシフトを無効にします。例えば、リソースのオートシフトを終了するには、次のようなコマンドを使用します。

aws arc-zonal-shift update-zonal-autoshift-configuration \
      --resource-identifier="arn:aws:elasticloadbalancing:Region:111122223333:ExampleALB123456890" \
      --zonal-autoshift-status="DISABLED"

{
   "resourceIdentifier": "arn:aws:elasticloadbalancing:us-west-2:111122223333:ExampleALB123456890",
   "zonalAutoshiftStatus": "DISABLED"
}

進行中の練習実行をキャンセルする

CLI で進行中の練習実行をキャンセルするには、その練習実行が開始したリソースのゾーンシフトをキャンセルします。練習実行をキャンセルするには、cancel-zonal-shift コマンドを使用します。

例えば、リソースの練習実行をキャンセルするには、次のようなコマンドを使用します。

aws arc-zonal-shift cancel-zonal-shift \
   --zonal-shift-id="="arn:aws:testservice::111122223333:ExampleALB123456890" 

{
    "zonalShiftId": "2222222-3333-444-1111",
    "resourceIdentifier": "arn:aws:testservice::111122223333:ExampleALB123456890",
    "awayFrom": "usw2-az1",
    "expiryTime": 2024-11-15T10:35:42+00:00,
    "startTime": 2024-11-15T09:35:42+00:00,
    "status": "CANCELED",
    "comment": "Practice Run Started"
}

練習実行設定を編集する

CLI を使用してリソースの練習実行設定を編集して、練習実行のアラームの変更、ARC が練習実行を開始しない場合のブロックされた日付やブロックされたウィンドウの更新など、さまざまな設定オプションを更新できます。練習実行設定を編集するには、update-practice-run-configuration コマンドを使用します。

リソースの練習実行設定を編集するときには、次の点に注意してください。

• 現時点でサポートされているアラームタイプは CLOUDWATCH のみです。

• リソースがデプロイされている AWS リージョン のと同じ にあるアラームを使用する必要があります。

• 結果アラームを指定する必要があります。ブロッキングアラームの指定はオプションです。

• ブロックする日付またはブロックする時間枠の指定はオプションです。

• ブロックする日付またはブロックする時間枠を指定すると、、既存の値は置き換えられます。

例えば、リソースの練習実行設定を編集して、新しいブロックする日付を指定するには、次のようなコマンドを使用します。

aws arc-zonal-shift update-practice-run-configuration \
      --resource-identifier="arn:aws:elasticloadbalancing:Region:111122223333:ExampleALB123456890" \
      --blocked-dates 2024-03-01 

{
   "arn": "arn:aws:elasticloadbalancing:us-west-2:111122223333:ExampleALB123456890",
   "name": "zonal-shift-elb"
   "zonalAutoshiftStatus": "DISABLED",
   "practiceRunConfiguration": {
       "blockingAlarms": [
                  {
               "type": "CLOUDWATCH",
               "alarmIdentifier": "arn:aws:cloudwatch:us-west-2:111122223333:alarm:us-west-2-BlockWhenALARM"
           }
       ]
       "outcomeAlarms": [
           {
               "type": "CLOUDWATCH",
               "alarmIdentifier": "arn:aws:cloudwatch:us-west-2:111122223333:alarm:us-west-2-MyAppHealthAlarm"
           }
       ],
       "blockedWindows": [
           "Mon:10:00-Mon:10:30"
       ],
       "blockedDates": [
           "2024-03-01"
       ]
}

練習実行設定を削除する

リソースの練習実行設定を削除できますが、まず、リソースのゾーンオートシフトを無効にする必要があります。ゾーンオートシフトを有効にするには、リソースに練習実行設定が必要です。定期的な練習実行により、1 つのアベイラビリティーゾーンがなくてもアプリケーションが正常に動作することを確認できます。

CLI を使用して練習実行設定を削除するには、まず、必要に応じて update-zonal-autoshift コマンドを使用してゾーンオートシフトを無効にします。次に、練習実行設定を削除するには、delete-practice-run-configuration コマンドを使用します。

まず、次のようなコマンドを使用して、リソースのゾーンオートシフトを無効にします。

aws arc-zonal-shift update-zonal-autoshift-configuration \
      --resource-identifier="arn:aws:elasticloadbalancing:Region:111122223333:ExampleALB123456890" \
      --zonal-autoshift-status="DISABLED"

{
   "resourceIdentifier": "arn:aws:elasticloadbalancing:us-west-2:111122223333:ExampleALB123456890",
   "zonalAutoshiftStatus": "DISABLED"
}

次に、次のようなコマンドを使用して、練習実行設定を削除します。

aws arc-zonal-shift delete-practice-run-configuration \
      --resource-identifier="arn:aws:elasticloadbalancing:Region:111122223333:ExampleALB123456890"

{
   "arn": "arn:aws:elasticloadbalancing:us-west-2:111122223333:ExampleALB123456890",
   "name": "TestResource",
   "zonalAutoshiftStatus": "DISABLED"
}