本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 为 Amazon OpenSearch 服务定义非高峰时段
创建 Amazon S OpenSearch ervice 域时，您可以定义每天 10 小时的时段，该窗口被视为*非高峰*时段。 OpenSearch 只要有可能，服务就会使用此窗口来安排服务软件更新和自动调整优化，这些更新和自动调整需要在相对较低的流量时间内[部署蓝/绿](managedomains-configuration-changes.md)。 Blue/green 是指为域更新创建新环境并在更新完成后将用户路由到新环境的过程。
尽管 blue/green 部署不会造成中断，但为了最大限度地减少 blue/green 部署资源消耗时[对性能的任何潜在影响](managedomains-configuration-changes.md#initiating-tracking-configuration-changes)，我们建议您在域配置的非高峰时段安排这些部署。不在非高峰窗口进行诸如节点替换之类的更新或者需要立即部署到域中的更新。
您可以修改非高峰窗口的开始时间，但不能修改窗口时长。
**注意**
非高峰窗口于 2023 年 2 月 16 日推出。默认情况下，在此日期之前创建的所有域都禁用非高峰窗口。您必须手动启用和配置这些域的非高峰窗口。默认情况下，在此日期*之后*创建的所有域都启用非高峰窗口。启用域的非高峰窗口后，您将无法再将其禁用。
## 非高峰窗口服务软件更新
OpenSearch 服务有两大类服务软件更新：*可选*的和*必需*的。这两种类型都需要 blue/green 部署。不会对您的域强制执行可选更新，但如果您在指定的截止日期（通常是更新可用两周）之前不采取任何操作，则会自动安装必需更新。有关更多信息，请参阅 [可选更新与必需更新](service-software.md#service-software-optional-required)。
启动*可选*更新后，您可以选择立即应用更新，计划在随后的非高峰窗口进行，或者指定自定义的日期和时间来应用更新。
![\[Software update dialog with options to apply now, schedule off-peak, or set specific time.\]](http://docs.aws.amazon.com/zh_cn/opensearch-service/latest/developerguide/images/off-peak-sso.png)
对于*所需的*更新，S OpenSearch ervice 会自动安排在非高峰时段执行更新的日期和时间。您会在计划更新前的三天收到通知，而且您也可以在必需的部署期限内将其重新安排到稍后的日期和时间。有关说明，请参阅[重新计划操作](#off-peak-reschedule)。
## 非高峰期自动调整优化
以前，Auto-Tune 使用[维护窗口](auto-tune-schedule.md)来安排需要 blue/green 部署的更改。在引入非高峰窗口之前已经启用自动调整和维护窗口的域将继续使用维护窗口进行这些更新，除非您将其迁移到使用非高峰窗口。
建议您将域迁移到使用非高峰窗口，因为该窗口用于计划域上诸如服务软件更新之类的其他活动。有关说明，请参阅[从自动调整维护窗口迁移](#off-peak-migrate)。将域迁移到非高峰窗口后，您将无法恢复到使用维护窗口。
2023 年 2 月 16 日之后创建的所有域名都将使用非高峰时段（而不是传统的维护时段）来安排 blue/green 部署。您无法禁用域的非高峰窗口。有关需要蓝绿部署的自动调整优化的列表，请参阅 [更改类型](auto-tune.md#auto-tune-types)。
## 启用非高峰窗口
默认情况下，在 2023 年 2 月 16 日（引入非高峰窗口）之前创建的所有域都禁用该功能。您必须手动为这些域启用该功能。启用非高峰窗口后，您将无法再将其禁用。
### 控制台
**要启用域的非高峰窗口**
1. 在[https://console.aws.amazon.com/aos/家](https://console.aws.amazon.com/aos/home )中打开亚马逊 OpenSearch 服务控制台。
1. 选择域的名称以打开其配置。
1. 导航至**非高峰窗口**选项卡，然后选择**编辑**。
1. 您可以使用协调世界时 (UTC) 格式自定义开始时间。例如，要配置美国西部（俄勒冈州）区域的开始时间为晚上 11:30，请指定 **07:30**。
1. 选择**保存更改**。
### CLI
要使用修改非高峰时段 AWS CLI，[UpdateDomainConfig](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_UpdateDomainConfig.html)请发送请求：
```
aws opensearch update-domain-config \
--domain-name my-domain \
--off-peak-window-options 'Enabled=true, OffPeakWindow={WindowStartTime={Hours=02,Minutes=00}}'
```
如果您未指定自定义窗口的开始时间，则默认为世界标准时间 00:00。
## 配置自定义非高峰窗口
您可以采用协调世界时 (UTC) 指定域的自定义非高峰窗口。例如，如果您要为域配置美国东部（弗吉尼亚州北部）区域的非高峰窗口开始时间为晚上 11:00，请指定 04:00 UTC。
### 控制台
**要修改域的非高峰窗口**
1. 在[https://console.aws.amazon.com/aos/家](https://console.aws.amazon.com/aos/home )中打开亚马逊 OpenSearch 服务控制台。
1. 选择域的名称以打开其配置。
1. 导航至**非高峰窗口**选项卡。您可以查看已配置的非高峰窗口以及即将为域执行的计划操作列表。
1. 选择**编辑**，然后采用 UTC 指定新的开始时间。例如，要配置美国东部（弗吉尼亚州北部）区域的开始时间晚上 9:00，请指定 **02:00 UCT**。
1. 选择**保存更改**。
### CLI
要使用配置自定义非高峰时段 AWS CLI，[UpdateDomainConfig](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_UpdateDomainConfig.html)请发送请求并以 24 小时时间格式指定小时和分钟。
例如，以下请求将窗口开始时间更改为 UTC 凌晨 2:00：
```
aws opensearch update-domain-config \
--domain-name my-domain \
--off-peak-window-options 'OffPeakWindow={WindowStartTime={Hours=02,Minutes=00}}'
```
如果您未指定窗口开始时间，则创建域的 AWS 区域 默认时间为当地时间晚上 10:00。
## 查看计划的操作
您可以查看每个域的当前计划、正在进行或待处理的所有操作。操作的严重程度可分为`HIGH`、`MEDIUM` 和`LOW`。
操作具有以下状态：
+ `Pending update`— 操作正在待处理的队列中。
+ `In progress`— 操作当前正在进行中。
+ `Failed`— 操作未能完成。
+ `Completed`— 操作已成功完成。
+ `Not eligible`— 仅适用于服务软件更新。更新无法继续，因为集群运行状况不佳。
+ `Eligible`— 仅适用于服务软件更新。该域符合更新条件。
### 控制台
OpenSearch 服务控制台显示域配置中的所有计划操作，以及每个操作的严重性和当前状态。
**要查看域的计划操作**
1. 在[https://console.aws.amazon.com/aos/家](https://console.aws.amazon.com/aos/home )中打开亚马逊 OpenSearch 服务控制台。
1. 选择域的名称以打开其配置。
1. 导航至**非高峰窗口**选项卡。
1. 在**计划操作**下，查看域的当前计划、正在进行或待处理的所有操作。
### CLI
要使用查看计划操作 AWS CLI，[ListScheduledActions](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_ListScheduledActions.html)请发送请求：
```
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",
}
]
}
```
## 重新计划操作
OpenSearch 服务会通知您定期服务软件更新和自动调整优化。您可以选择立即应用更新，也可以将其重新安排到稍后的日期和时间。
**注意**
OpenSearch 服务可以在您选择的时间后一小时内安排操作。例如，如果您选择在下午 5 点应用更新，则更新会在下午 5 点到 6 点之间进行。
### 控制台
**要重新安排操作**
1. 在[https://console.aws.amazon.com/aos/家](https://console.aws.amazon.com/aos/home )中打开亚马逊 OpenSearch 服务控制台。
1. 选择域的名称以打开其配置。
1. 导航至**非高峰窗口**选项卡。
1. 在**计划操作**下，依次选择操作和**重新安排**。
1. 请选择以下选项之一：
+ **立即应用更新** - *如果有可用容量*，则立即安排在当前小时执行更新。如果容量不足，我们会提供其他可用时段供您选择。
+ **将其安排在非高峰窗口** - 标记要在即将到来的非高峰窗口中进行操作。无法保证在下一个窗口会执行更改。视容量而定，可能会在接下来的几天内更新。
+ **重新安排此更新** - 允许您指定应用更改的自定义日期和时间。如果出于容量原因指定的时间不可用，则可以选择其他时段。
+ **取消计划更新** - 取消更新。此选项只适用于可选服务软件更新。它不适用于自动调整操作或必需的软件更新。
1. 选择**保存更改**。
### CLI
要使用重新安排操作 AWS CLI，请发送请求。[UpdateScheduledAction](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_UpdateScheduledAction.html)要检索操作 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 服务会在响应中提供其他可用时段建议。
## 从自动调整维护窗口迁移
如果域名是在 2023 年 2 月 16 日之前创建的，则它可以使用[维护窗口](auto-tune-schedule.md)来安排需要部署的 Auto-Tune 优化。 blue/green 您可以迁移现有的自动调整域，以改为使用非高峰窗口。
**注意**
将域迁移到使用非高峰窗口后，您将无法恢复到使用维护窗口。
### 控制台
**要将域迁移到使用非高峰窗口**
1. 在 Amazon S OpenSearch ervice 控制台中，选择域名以打开其配置。
1. 转到**自动调整**选项卡，选择**编辑**。
1. 选择**迁移到非高峰窗口**。
1. 对于**开始时间 (UTC)**，采用协调世界时间 (UTC) 为非高峰窗口的每日开始时间。
1. 选择 **Save changes**（保存更改）。
### CLI
要使用从 Auto-Tune 维护窗口迁移到非高峰时段 AWS CLI，请发送[UpdateDomainConfig](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_UpdateDomainConfig.html)请求：
```
aws opensearch update-domain-config \
--domain-name my-domain \
--auto-tune-options DesiredState=ENABLED,UseOffPeakWindow=true,MaintenanceSchedules=[]
```
要将域从自动调整维护窗口迁移到非高峰窗口，必须打开非高峰窗口。您可以在单独的请求中或在同一个请求中启用非高峰窗口。有关说明，请参阅[启用非高峰窗口](#off-peak-enable)。