Amazon OpenSearch Service のオフピークウィンドウの定義

AWS CLI を使用してオフピークウィンドウを変更するには、UpdateDomainConfig リクエストを送信します。

aws opensearch update-domain-config \
  --domain-name my-domain \
  --off-peak-window-options 'Enabled=true, OffPeakWindow={WindowStartTime={Hours=02,Minutes=00}}'

カスタムのウィンドウ開始時刻を指定しない場合、00:00 UTC がデフォルトの時刻となります。

AWS CLI を使用してカスタムのオフピークウィンドウを設定するには、UpdateDomainConfig リクエストを送信し、24 時間表記で時と分を指定します。

例えば、次のリクエストを送信すると、ウィンドウの開始時刻が UTC の午前 2 時に変更されます。

aws opensearch update-domain-config \
  --domain-name my-domain \
  --off-peak-window-options 'OffPeakWindow={WindowStartTime={Hours=02,Minutes=00}}'

ウィンドウの開始時刻を指定しなかった場合、ドメインが作成された AWS リージョン の現地時間午後 10 時がデフォルトで開始時刻となります。

OpenSearch Service コンソールには、ドメイン設定内でスケジュールされているすべてのアクションが、各アクションの重要度や現在のステータスと併せて表示されます。

AWS CLI を使用してスケジュールされたアクションを表示するには、ListScheduledActions リクエストを送信します。

aws opensearch list-scheduled-actions \
  --domain-name my-domain

レスポンス:

{
    "ScheduledActions": [
        {
            "Cancellable": true,
            "Description": "The Deployment type is : BLUE_GREEN.",
            "ID": "R20220721-P13",
            "Mandatory": false,
            "Severity": "HIGH",
            "ScheduledBy": "CUSTOMER",
            "ScheduledTime": 1.673871601E9,
            "Status": "PENDING_UPDATE",
            "Type": "SERVICE_SOFTWARE_UPDATE",
        },
        {
            "Cancellable": true,
            "Description": "Amazon Opensearch will adjust the young generation JVM arguments on your domain to improve performance",
            "ID": "Auto-Tune",
            "Mandatory": true,
            "Severity": "MEDIUM",
            "ScheduledBy": "SYSTEM",
            "ScheduledTime": 1.673871601E9,
            "Status": "PENDING_UPDATE",
            "Type": "JVM_HEAP_SIZE_TUNING",
        }
    ]
}

AWS CLI を使用してアクションのスケジュールを変更するには、UpdateScheduledAction リクエストを送信します。アクション ID を取得するには、ListScheduledActions リクエストを送信します。

次のリクエストを送信すると、サービスソフトウェアの更新が特定の日時にスケジュール変更されます。

aws opensearch update-scheduled-action \
  --domain-name my-domain \
  --action-id R20220721-P13 \
  --action-type "SERVICE_SOFTWARE_UPDATE" \
  --desired-start-time 1677348395000 \
  --schedule-at TIMESTAMP

レスポンス:

{
   "ScheduledAction": { 
      "Cancellable": true,
      "Description": "Cluster status is updated.",
      "Id": "R20220721-P13",
      "Mandatory": false,
      "ScheduledBy": "CUSTOMER",
      "ScheduledTime": 1677348395000,
      "Severity": "HIGH",
      "Status": "PENDING_UPDATE",
      "Type": "SERVICE_SOFTWARE_UPDATE"
   }
}

リクエストが SlotNotAvailableException により失敗した場合は、指定した日時が容量上の理由で利用できないことを意味し、別の日時を指定する必要があります。OpenSearch Service が、応答で、利用可能な別の時間帯を提案します。

AWS CLI を使用して Auto-Tune メンテナンスウィンドウからオフピークウィンドウへ移行するには、UpdateDomainConfig リクエストを送信します。

aws opensearch update-domain-config \
  --domain-name my-domain \
  --auto-tune-options DesiredState=ENABLED,UseOffPeakWindow=true,MaintenanceSchedules=[]

ドメインを Auto-Tune メンテナンスウィンドウからオフピークウィンドウへ移行するには、オフピークウィンドウをオンにします。オフピークウィンドウは、個別のリクエストで、または同じリクエストで有効にすることができます。手順については、オフピークウィンドウの有効化 を参照してください。