本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # Amazon OpenSearch 服务重命名-变更摘要 2021 年 9 月 8 日，我们的搜索和分析套件更名为亚马逊 OpenSearch 服务。 OpenSearch 服务支持 OpenSearch 以及传统的 Elasticsearch OSS。以下各节介绍了随重命名而更改的不同服务部分，以及您需要执行哪些操作来确保域继续正常运行。 其中一些更改仅在您将域名从 Elasticsearch 升级到时才适用。 OpenSearch在其他情况下（例如，在“账单和成本管理”控制台中），体验将立即更改。 请注意，此列表并不详尽。虽然产品的其他部分也发生了更改，但这些更新是最相关的。 ## 新 API 版本 新版本的 OpenSearch 服务配置 API (2021-01-01) 适用于传统的 Elasticsearc OpenSearch h OSS。21 个 API 操作被更简洁且与引擎无关的名称所取代（例如，`CreateElasticsearchDomain`更改为`CreateDomain`），但是 S OpenSearch ervice 继续支持这两个 API 版本。 我们建议您使用新的 API 操作来创建和管理后续域。请注意，当您使用新 API 操作创建域时，您需要指定采用格式 `Elasticsearch_X.Y` 或者 `OpenSearch_X.Y` 的 `EngineVersion` 参数，而不仅仅是版本号。如果您未指定版本，则默认为最新版本的 OpenSearch。 AWS CLI 将您的域名升级到 1.20.40 或更高版本，`aws opensearch ...`以便用于创建和管理您的域名。有关新的 CLI 格式，请参阅 [OpenSearch CLI 参考](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/opensearch/index.html)。 ## 重命名的实例类型 Amazon S OpenSearch ervice 中的实例类型现在采用了格式，`..search`例如，`m6g.large.search`而不`m6g.large.elasticsearch`是。您不需要采取任何措施。现有域将自动启动引用 API 以及“账单和成本管理”控制台中的新实例类型。 如果您有预留实例 (RIs)，则您的合同不会受到变更的影响。旧的配置 API 版本仍与旧的命名格式兼容，但如果要使用新的 API 版本，则需要使用新格式。 ## 访问策略更改 以下各节介绍了更新访问策略需要执行的操作。 ### IAM 策略 我们建议您更新 [IAM 策略](ac.md)以使用重命名的 API 操作。但是，S OpenSearch ervice 将继续通过在内部复制旧的 API 权限来遵守现有政策。例如，如果您当前有权执行 `CreateElasticsearchDomain` 操作，则您现在可以调用 `CreateElasticsearchDomain`（旧的 API 操作）和 `CreateDomain`（新的 API 操作）。这同样适用于显式拒绝。有关更新的 API 操作的列表，请参阅[策略元素引用](ac.md#ac-reference)。 ### SCP 策略 与标准 IAM 相比，[服务控制策略 (SCPs)](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scps.html) 增加了复杂性。为了防止 SCP 策略中断，您需要将旧的*和*新的 API 操作添加到您的每个 SCP 策略中。例如，如果用户当前具有 `CreateElasticsearchDomain` 的允许权限，您还需要授予它们 `CreateDomain` 的允许权限，以便他们能够保留创建域的能力。这同样适用于显式拒绝。 例如： ``` "Statement": [ { "Effect": "Allow", "Action": [ "es:CreateElasticsearchDomain", "es:CreateDomain" ... ], }, "Effect": "Deny", "Action:" [ "es:DeleteElasticsearchDomain", "es:DeleteDomain" ... ``` ## 新资源类型 OpenSearch 服务引入了以下新的资源类型： | 资源 | 说明 | | --- | --- | | `AWS::OpenSearchService::Domain` | 代表 Amazon OpenSearch 服务域名。此资源存在于服务级别，并不特定于域上运行的软件。它适用于 [CloudFormation](https://aws.amazon.com/cloudformation/) 和 [AWS Resource Groups](https://docs.aws.amazon.com/ARG/latest/userguide/welcome.html)等服务，您可以在其中创建和管理整个服务的资源。 有关将内定义的域 CloudFormation 从 Elasticsearch 升级到的说明 OpenSearch，请参阅 CloudFormation 用户指南中的[备注](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-opensearchservice-domain.html#aws-resource-opensearchservice-domain--remarks)。 | | `AWS::OpenSearch::Domain` | 表示在域上运行的 OpenSearch/Elasticsearch 软件。此资源适用于[AWS CloudTrail](https://aws.amazon.com/documentation/cloudtrail/)和之类的服务 [AWS Config](https://aws.amazon.com/config/)，这些服务引用的是域上运行的软件，而不是整个 OpenSearch 服务。这些服务现在包含运行 Elasticsearch () 的域和运行 (AWS::Elasticsearch::Domain) 的域的不同资源类型。 OpenSearch AWS::OpenSearch::Domain | **注意** 在中 [AWS Config](https://aws.amazon.com/config/)，即使您将一个或多个域名升级到，您仍将在几周内继续在现有`AWS::Elasticsearch::Domain`资源类型下看到您的数据 OpenSearch。 ## Kibana 已重命名为控制面板 OpenSearch [OpenSearch 仪表板](dashboards.md)是 Kibana 的 AWS 替代品，是一种开源可视化工具，专为与之配合使用而设计。 OpenSearch将域名从 Elasticsearch 升级到后 OpenSearch，`/_plugin/kibana`终端节点将变为。`/_dashboards` OpenSearch 服务会将所有请求重定向到新的终端节点，但是如果您在任何 IAM 策略中使用 Kibana 终端节点，请更新这些策略以同时包含新的`/_dashboards`终端节点。 如果您正在使用[仪表板的 SAML 身份验证 OpenSearch](saml.md)，则在将域升级到之前 OpenSearch，您需要将身份提供商 (IdP) 中 URLs 配置的所有 Kibana 从更改为。`/_plugin/kibana` `/_dashboards`最常见 URLs 的是断言消费者服务 (ACS) URLs 和接收方 URLs。 OpenSearch 仪表板的默认`kibana_read_only`角色已重命名为`opensearch_dashboards_read_only`，该`kibana_user`角色已重命名为`opensearch_dashboards_user`。此更改适用于所有*新创建的 1* OpenSearch . *x* 个运行服务软件 R20211203 或更高版本的域。如果将现有域升级到服务软件 R20211203，则角色名称将保持不变。 ## 已重命名的 CloudWatch 指标 域名正在运行的几个 CloudWatch 指标会发生变化 OpenSearch。当您将域名升级到时 OpenSearch，指标会自动更改，您当前的 CloudWatch 警报将中断。在将集群从 Elasticsearch OpenSearch 版本升级到某个版本之前，请务必更新 CloudWatch 警报以使用新的指标。 更改了以下指标： | 原始指标名称 | 新名称 | | --- | --- | | `KibanaHealthyNodes` | `OpenSearchDashboardsHealthyNodes` | | `KibanaConcurrentConnections` | `OpenSearchDashboardsConcurrentConnections` | | `KibanaHeapTotal` | `OpenSearchDashboardsHeapTotal` | | `KibanaHeapUsed` | `OpenSearchDashboardsHeapUsed` | | `KibanaHeapUtilization` | `OpenSearchDashboardsHeapUtilization` | | `KibanaOS1MinuteLoad` | `OpenSearchDashboardsOS1MinuteLoad` | | `KibanaRequestTotal` | `OpenSearchDashboardsRequestTotal` | | `KibanaResponseTimesMaxInMillis` | `OpenSearchDashboardsResponseTimesMaxInMillis` | | `ESReportingFailedRequestSysErrCount` | `KibanaReportingFailedRequestSysErrCount` | | `ESReportingRequestCount` | `KibanaReportingRequestCount` | | `ESReportingFailedRequestUserErrCount` | `KibanaReportingFailedRequestUserErrCount` | | `ESReportingSuccessCount` | `KibanaReportingSuccessCount` | | `ElasticsearchRequests` | `OpenSearchRequests` | 有关 OpenSearch 服务发送给 Amazon 的指标的完整列表 CloudWatch，请参阅[使用 Amazon 监控 OpenSearch 集群指标 CloudWatch](managedomains-cloudwatchmetrics.md)。 ## 账单和成本管理控制台更改 [账单和成本管理控制台以及成本](https://console.aws.amazon.com/billing/home)[和使用情况报告](https://aws.amazon.com/aws-cost-management/aws-cost-and-usage-reporting/)中的历史数据将继续使用旧的服务名称，因此在搜索数据时，您需要开始使用**亚马逊 OpenSearch 服务和**旧版 Elasticsearch 名称的筛选条件。如果您已保存报告，请更新过滤器以确保其中也包含 OpenSearch 服务。当你的 Elasticsearch 使用量减少并增加时，你最初可能会收到警报 OpenSearch，但它会在几天之内消失。 除了服务名称以外，所有报告、账单和价格列表 API 操作的以下字段也将更改： | 字段 | 旧格式 | 新格式 | | --- | --- | --- | | 实例类型 | `m5.large.elasticsearch` | `m5.large.search` | | 产品系列 | Elasticsearch 实例 Elasticsearch 卷 | Amazon OpenSearch 服务实例 亚马逊 OpenSearch 服务量 | | 定价说明 | c5.18xlarge.elasticsearch 实例小时（或部分小时）5.098 美元 - 欧盟 | c5.18xlarge.search 实例小时（或部分小时）5.098 美元 - 欧盟 | | 实例系列 | `ultrawarm.elasticsearch` | `ultrawarm.search` | ## 新事件格式 OpenSearch 服务发送给亚马逊 EventBridge 和亚马逊的事件格式 CloudWatch 已更改，特别是该`detail-type`字段。源字段 (`aws.es`) 保持不变。有关每种事件类型的完整格式，请参阅 [使用 Amazon 监控 OpenSearch 服务事件 EventBridge](monitoring-events.md)。如果您具有取决于旧格式的现有事件规则，请确保更新它们以符合新格式。 ## 什么保持不变？ 以下特性和功能以及未列出的其他特性和功能将保持不变： + 服务委托人 (`es.amazonaws.com`) + 供应商代码 + 域名 ARNs + 域终端节点 ## 开始吧：将您的域名升级到 OpenSearch 1.x OpenSearch 1。 *x* 支持从 Elasticsearch 版本 6.8 和 7 进行升级。 *x*。有关升级域的说明，请参阅 [升级域（控制台）](starting-upgrades.md)。如果您使用 AWS CLI 或配置 API 来升级您的域名，则需要指定`TargetVersion`为`OpenSearch_1.x`。 OpenSearch 1。 *x* 引入了一个名为 “**启用兼容模式**” 的附加域设置。由于某些 Elasticsearch OSS 客户端和插件在连接之前会检查集群版本，因此兼容模式设置 OpenSearch 为将其版本报告为 7.10，因此这些客户端可以继续工作。 在首次创建 OpenSearch 域名时，或者 OpenSearch 从 Elasticsearch 版本升级到时，您可以启用兼容模式。如果未设置，则创建域时参数默认为 `false`，并且在升级域时默认为 `true`。 要使用[配置 API](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_UpgradeDomain.html) 启用兼容模式，请将 `override_main_response_version` 设置为 `true`： ``` POST https://es.us-east-1.amazonaws.com/2021-01-01/opensearch/upgradeDomain { "DomainName": "domain-name", "TargetVersion": "OpenSearch_1.0", "AdvancedOptions": { "override_main_response_version": "true" } } ``` 要在*现有* OpenSearch域名上启用或禁用兼容模式，您需要使用 OpenSearch [\$1cluster/](https://docs.opensearch.org/latest/opensearch/rest-api/cluster-settings/) settings API 操作： ``` PUT /_cluster/settings { "persistent" : { "compatibility.override_main_response_version" : true } } ```