备份和恢复

将创建备份的路径。如果该路径不是绝对路径，则备份路径将相对于 Solr 的实例目录。

快照将在名为 snapshot.<name> 的目录中创建。如果未指定名称，则目录名称将具有以下格式：snapshot.<_yyyyMMddHHmmssSSS_>。

要保留的备份数量。如果在 solrconfig.xml 中的复制处理程序上指定了 maxNumberOfBackups，则始终使用 maxNumberOfBackups，并且尝试使用 numberToKeep 将导致错误。此外，如果指定了备份名称，则不考虑此参数。有关 maxNumberOfBackups 的更多信息，请参阅 配置 ReplicationHandler 部分。

用于备份的存储库的名称。如果未指定存储库，则会自动使用本地文件系统存储库。

在使用 CREATESNAPSHOT 命令创建快照时使用的提交的名称。

备份快照文件的位置。如果未指定，它会在 Solr 的数据目录中查找备份。

要还原的备份索引快照的名称。如果未提供名称，它会在位置目录中查找具有 snapshot.<timestamp> 格式的备份。在这种情况下，它会选择最新的时间戳备份。

用于备份的存储库的名称。如果未指定存储库，则会自动使用本地文件系统存储库。

用于跟踪此操作的请求 ID，该操作将异步处理。

用于跟踪此操作的请求 ID，该操作将异步处理。

用于跟踪此操作的请求 ID，该操作将异步处理。

用于备份存储和检索的有效文件路径（Solr 在本地可以访问）。当用户在其备份或还原 API 命令中未提供 location 参数时，用作回退。

用于将数据传输到 HDFS 和从 HDFS 传输数据的缓冲区的大小（以字节为单位）。在内存允许的情况下，使用较大的缓冲区通常可以获得更好的吞吐量。

格式为 hdfs://<host>:<port>/<hdfsBaseFilePath> 的 HDFS URI，将 Solr 指向 HDFS 群集以存储（或检索）备份文件。

在 HDFS 中创建文件时使用的权限 umask。

HDFS 群集上的有效目录路径，用于备份存储和检索。当用户在其备份或还原 API 命令中未提供 location 参数时，用作回退。

用于读取和写入所有备份文件的 GCS 存储桶。如果未指定，GCSBackupRepository 将使用 GCS_BUCKET 环境变量的值。如果这两个值都不存在，则默认使用值 solrBackupsBucket。

本地文件系统（Solr 可访问）上指向 Google Cloud 服务帐户密钥文件的路径。如果未指定，GCSBackupRepository 将使用 GCS_CREDENTIAL_PATH 环境变量的值。如果这两个值都不存在，并且 Solr 在 GCP 内部运行，则 GCS 客户端将尝试使用 GCP 的 “Compute Engine 元数据服务器” 或 工作负载身份功能进行身份验证。如果这两个值都不存在，并且 Solr 在 GCP 外部运行，它将无法进行身份验证，并且任何备份或还原操作都将失败。

在给定的 GCS 存储桶中用于备份存储和检索的有效“目录”路径。（GCS 使用平面存储模型，但 Solr 的备份功能以近似于分层目录存储的方式命名 Blob。）当用户未在其备份或还原 API 命令中提供 location 参数时，用作回退。

向 GCS 发送数据时使用的缓冲区大小（以字节为单位）。

从 GCS 复制数据时使用的缓冲区大小（以字节为单位）。

GCS 客户端发出的所有 HTTP 请求的连接超时时间（以毫秒为单位）。可以使用 0 请求无限超时。负整数或根本不指定值将导致使用默认值。

在已建立的连接上读取数据的读取超时时间（以毫秒为单位）。可以使用 0 请求无限超时。负整数或根本不指定值将导致使用默认值。

操作失败时重试的最大次数。GCS 客户端将重试操作，直到达到此值，或者所有尝试的总时间超过 gcsClientMaxRequestTimeoutMillis。可以使用 0 指定不应进行重试。

在所有失败操作的重试中花费的最大时间。GCS 客户端将重试操作，直到达到此超时时间，或者直到 gcsClientMaxRetries 次尝试失败。

失败的 HTTP 请求首次重试之前的延迟时间（以毫秒为单位）。此值还会影响后续的重试 - 有关更多信息，请参见下面的 gcsClientHttpRetryDelayMultiplier 说明。如果 gcsClientMaxRetries 为 0，则忽略此属性，因为不进行任何重试。

一个浮点乘数，用于缩放每次连续重试失败的 HTTP 请求之间的延迟。此数字越大，重试延迟的复合和缩放速度越快。

Under the covers, the GSC client uses an exponential backoff strategy between retries, governed by the formula: . The first retry will have a delay of , the second a delay of , the third a delay of , and so on.

如果未指定，则默认使用值 1.0，确保在每次重试尝试之间使用 gcsClientHttpInitialRetryDelayMillis。

失败的 HTTP 请求的重试尝试之间的最大延迟时间（以毫秒为单位）。这通常用于限制多次尝试中发生的重试延迟的指数增长。有关在不受此最大值限制的情况下如何计算每个延迟的更多信息，请参见上面的 gcsClientHttpRetryDelayMultiplier 说明。

在 RPC 请求超时之前等待的时间（以毫秒为单位）。此值还会影响后续的重试 - 有关更多信息，请参见下面的 gcsClientRpcTimeoutMultiplier 说明。如果 gcsClientMaxRetries 为 0，则忽略此属性，因为不进行任何重试。

一个浮点乘数，用于缩放每次连续尝试失败的 RPC 请求的超时时间。此数字越大，超时时间的复合和缩放速度越快。

Under the covers, the GSC client uses an exponential backoff strategy for RPC timeouts, governed by the formula: . The first retry will have a delay of , the second a delay of , the third a delay of , and so on.

如果未指定，则默认使用值 1.0，确保在每次 RPC 尝试时使用 gcsClientRpcInitialTimeoutMillis。

失败的 RPC 请求的重试尝试的最大超时时间（以毫秒为单位）。这通常用于限制多次尝试中发生的超时时间的指数增长。有关在不受此最大值限制的情况下如何计算每个超时时间的更多信息，请参见上面的 gcsClientRpcTimeoutMultiplier 说明。

用于读取和写入所有备份文件的 S3 存储桶。可以通过设置 S3_BUCKET_NAME 环境变量来覆盖。

一个配置文件，用于从配置文件加载 AWS 设置。配置文件允许为多个 S3 存储库设置独立的设置。可以通过设置 AWS_PROFILE 环境变量或 -Daws.profile 系统属性来覆盖。有关设置每个配置文件的更多信息，请参阅 AWS Java SDK 文档

配置您的存储桶所在的有效的 Amazon S3 区域字符串。您必须具有此存储桶的读取和写入权限。有关区域的完整列表，请参考 S3 文档。可以通过设置 S3_REGION 环境变量或在 AWS 配置文件中设置区域来覆盖。

显式的 S3 端点。在使用 AWS S3 时，正常操作下不需要（S3 客户端可以从 s3.region 推断出端点）。如果使用模拟 S3 框架并希望显式覆盖 S3 请求的路由位置（例如使用 S3Mock 时），此参数很有用。可以通过设置 S3_ENDPOINT 环境变量来覆盖。

如果需要，S3 客户端将请求路由通过的代理 URL。该 URL 应包含 <scheme>://<hostname>:<port>，但是如果缺少，则可以推断端口和方案可能。

如果使用，这将覆盖设置的所有系统代理设置。无需禁用 s3.proxy.useSystemSettings 选项。如果您需要使用代理 username、password 或 nonProxyHosts，请使用下面列出的系统属性。

默认情况下，如果设置了系统代理设置，则在与 S3 服务器通信时使用系统代理设置。支持的代理系统属性是：

禁用所有 S3 操作的重试。不建议这样做。