---
title: "清理 S3 仓库时需要指定区域或端点选项 – 如何解决此 Elasticsearch 异常"
date: 2026-02-23
lastmod: 2026-02-23
description: "当 Elasticsearch 尝试清理 S3 仓库时，如果未指定区域或端点，则会发生此错误。Elasticsearch 需要这些详细信息来定位 S3 存储桶。"
tags: ["S3仓库", "区域配置", "端点配置", "存储清理"]
summary: "版本： 7.4-7.17
 简而言之，当 Elasticsearch 尝试清理 S3 仓库但未指定区域或端点时，会发生此错误。Elasticsearch 需要这些详细信息来定位 S3 存储桶。要解决此问题，您可以在 Elasticsearch 配置文件中指定区域或端点，或者将其作为参数在 API 调用中提供。另一种方法是将区域或端点设置为环境变量。请确保指定的区域或端点与您的 S3 存储桶所在的区域或端点相匹配。
日志上下文 #  日志 “region or endpoint option is required for cleaning up S3 repository” 的类名是 CleanupS3RepositoryCommand.java。 我们从 Elasticsearch 源代码中提取了以下内容，以供那些寻求深入上下文的人员参考：
String region = regionOption.value(options); String endpoint = endpointOption.value(options); if (Strings.isNullOrEmpty(region) && Strings.isNullOrEmpty(endpoint)) { throw new ElasticsearchException("region or endpoint option is required for cleaning up S3 repository"); } if (Strings.isNullOrEmpty(region) == false && Strings."
---



> **版本：** 7.4-7.17


简而言之，当 Elasticsearch 尝试清理 S3 仓库但未指定区域或端点时，会发生此错误。Elasticsearch 需要这些详细信息来定位 S3 存储桶。要解决此问题，您可以在 Elasticsearch 配置文件中指定区域或端点，或者将其作为参数在 API 调用中提供。另一种方法是将区域或端点设置为环境变量。请确保指定的区域或端点与您的 S3 存储桶所在的区域或端点相匹配。

日志上下文
-----------

日志 "region or endpoint option is required for cleaning up S3 repository" 的类名是 [CleanupS3RepositoryCommand.java。](https://www.geeksforgeeks.org/java-lang-class-class-java-set-1/) 我们从 Elasticsearch 源代码中提取了以下内容，以供那些寻求深入上下文的人员参考：

```java
    String region = regionOption.value(options);
    String endpoint = endpointOption.value(options);  if (Strings.isNullOrEmpty(region) && Strings.isNullOrEmpty(endpoint)) {
        throw new ElasticsearchException("region or endpoint option is required for cleaning up S3 repository");
    }  if (Strings.isNullOrEmpty(region) == false && Strings.isNullOrEmpty(endpoint) == false) {
        throw new ElasticsearchException("you must not specify both region and endpoint");
    }
```