Package org.opensearch.client.opensearch.snapshot

Class RestoreSnapshotRequest.Builder

java.lang.Object
org.opensearch.client.util.ObjectBuilderBase
org.opensearch.client.opensearch._types.RequestBase.AbstractBuilder<RestoreSnapshotRequest.Builder>
org.opensearch.client.opensearch.snapshot.RestoreSnapshotRequest.Builder
All Implemented Interfaces:
CopyableBuilder<RestoreSnapshotRequest.Builder,RestoreSnapshotRequest>, MutableBuilder<RestoreSnapshotRequest.Builder,RestoreSnapshotRequest>, ObjectBuilder<RestoreSnapshotRequest>
Enclosing class:
RestoreSnapshotRequest
public static class RestoreSnapshotRequest.Builder extends RequestBase.AbstractBuilder<RestoreSnapshotRequest.Builder> implements CopyableBuilder<RestoreSnapshotRequest.Builder,RestoreSnapshotRequest>
Builder for RestoreSnapshotRequest.

  • Constructor Details

    • Builder

      public Builder()

  • Method Details

    • copy

      @Nonnull public RestoreSnapshotRequest.Builder copy()
      Description copied from interface: CopyableBuilder
      Create a new builder CopyableBuilder that is a copy of this one.
      Specified by:
      copy in interface CopyableBuilder<RestoreSnapshotRequest.Builder,RestoreSnapshotRequest>
      Returns:
      a new builder instance.

    • self

      @Nonnull protected RestoreSnapshotRequest.Builder self()
      Specified by:
      self in class RequestBase.AbstractBuilder<RestoreSnapshotRequest.Builder>

    • clusterManagerTimeout

      @Nonnull public final RestoreSnapshotRequest.Builder clusterManagerTimeout(@Nullable Time value)
      The amount of time to wait for a response from the cluster manager node. For more information about supported time units, see Common parameters.

      API name: cluster_manager_timeout

    • clusterManagerTimeout

      @Nonnull public final RestoreSnapshotRequest.Builder clusterManagerTimeout(Function<Time.Builder,ObjectBuilder<Time>> fn)
      The amount of time to wait for a response from the cluster manager node. For more information about supported time units, see Common parameters.

      API name: cluster_manager_timeout

    • ignoreIndexSettings

      @Nonnull public final RestoreSnapshotRequest.Builder ignoreIndexSettings(List<String> list)
      A comma-delimited list of index settings to ignore when restoring indexes from a snapshot.

      API name: ignore_index_settings

      Adds all elements of list to ignoreIndexSettings.

    • ignoreIndexSettings

      @Nonnull public final RestoreSnapshotRequest.Builder ignoreIndexSettings(String value, String... values)
      A comma-delimited list of index settings to ignore when restoring indexes from a snapshot.

      API name: ignore_index_settings

      Adds one or more values to ignoreIndexSettings.

    • ignoreUnavailable

      @Nonnull public final RestoreSnapshotRequest.Builder ignoreUnavailable(@Nullable Boolean value)
      How to handle data streams or indexes that are missing or closed. When false, the request returns an error for any data stream or index that is missing or closed. When true, the request ignores data streams and indexes in indexes that are missing or closed.

      API name: ignore_unavailable

    • includeAliases

      @Nonnull public final RestoreSnapshotRequest.Builder includeAliases(@Nullable Boolean value)
      How to handle index aliases from the original snapshot. When true, index aliases from the original snapshot are restored. When false, aliases along with associated indexes are not restored.

      API name: include_aliases

    • includeGlobalState

      @Nonnull public final RestoreSnapshotRequest.Builder includeGlobalState(@Nullable Boolean value)
      Whether to restore the current cluster state. When false, the cluster state is not restored. When true, the current cluster state is restored.

      API name: include_global_state

    • indexSettings

      @Nonnull public final RestoreSnapshotRequest.Builder indexSettings(@Nullable IndexSettings value)
      A comma-delimited list of settings to add or change in all restored indexes. Use this parameter to override index settings during snapshot restoration. For data streams, these index settings are applied to the restored backing indexes.

      API name: index_settings

    • indexSettings

      @Nonnull public final RestoreSnapshotRequest.Builder indexSettings(Function<IndexSettings.Builder,ObjectBuilder<IndexSettings>> fn)
      A comma-delimited list of settings to add or change in all restored indexes. Use this parameter to override index settings during snapshot restoration. For data streams, these index settings are applied to the restored backing indexes.

      API name: index_settings

    • indices

      @Nonnull public final RestoreSnapshotRequest.Builder indices(List<String> list)
      API name: indices

      Adds all elements of list to indices.

    • indices

      @Nonnull public final RestoreSnapshotRequest.Builder indices(String value, String... values)
      API name: indices

      Adds one or more values to indices.

    • masterTimeout

      @Deprecated @Nonnull public final RestoreSnapshotRequest.Builder masterTimeout(@Nullable Time value)
      Deprecated.
      Explicit operation timeout for connection to cluster-manager node

      API name: master_timeout

    • masterTimeout

      @Deprecated @Nonnull public final RestoreSnapshotRequest.Builder masterTimeout(Function<Time.Builder,ObjectBuilder<Time>> fn)
      Deprecated.
      Explicit operation timeout for connection to cluster-manager node

      API name: master_timeout

    • partial

      @Nonnull public final RestoreSnapshotRequest.Builder partial(@Nullable Boolean value)
      How the restore operation will behave if indexes in the snapshot do not have all primary shards available. When false, the entire restore operation fails if any indexes in the snapshot do not have all primary shards available. When true, allows the restoration of a partial snapshot of indexes with unavailable shards. Only shards that were successfully included in the snapshot are restored. All missing shards are recreated as empty. By default, the entire restore operation fails if one or more indexes included in the snapshot do not have all primary shards available. To change this behavior, set partial to true.

      API name: partial

    • renameAliasPattern

      @Nonnull public final RestoreSnapshotRequest.Builder renameAliasPattern(@Nullable String value)
      The pattern to apply to the restored aliases. Aliases matching the rename pattern will be renamed according to the rename_alias_replacement setting. The rename pattern is applied as defined by the regular expression that supports referencing the original text. If two or more aliases are renamed into the same name, these aliases will be merged into one.

      API name: rename_alias_pattern

    • renameAliasReplacement

      @Nonnull public final RestoreSnapshotRequest.Builder renameAliasReplacement(@Nullable String value)
      The rename replacement string for aliases.

      API name: rename_alias_replacement

    • renamePattern

      @Nonnull public final RestoreSnapshotRequest.Builder renamePattern(@Nullable String value)
      The pattern to apply to the restored data streams and indexes. Data streams and indexes matching the rename pattern will be renamed according to the rename_replacement setting. The rename pattern is applied as defined by the regular expression that supports referencing the original text. The request fails if two or more data streams or indexes are renamed into the same name. If you rename a restored data stream, its backing indexes are also renamed. For example, if you rename the logs data stream to recovered-logs, the backing index .ds-logs-1 is renamed to .ds-recovered-logs-1. If you rename a restored stream, ensure an index template matches the new stream name. If there are no matching index template names, the stream cannot roll over and new backing indexes are not created.

      API name: rename_pattern

    • renameReplacement

      @Nonnull public final RestoreSnapshotRequest.Builder renameReplacement(@Nullable String value)
      The rename replacement string.

      API name: rename_replacement

    • repository

      @Nonnull public final RestoreSnapshotRequest.Builder repository(String value)
      Required - The name of the repository containing the snapshot

      API name: repository

    • snapshot

      @Nonnull public final RestoreSnapshotRequest.Builder snapshot(String value)
      Required - The name of the snapshot to restore.

      API name: snapshot

    • sourceRemoteStoreRepository

      @Nonnull public final RestoreSnapshotRequest.Builder sourceRemoteStoreRepository(@Nullable String value)
      The name of the remote store repository of the source index being restored. If not provided, the Snapshot Restore API will use the repository that was registered when the snapshot was created.

      API name: source_remote_store_repository

    • storageType

      @Nonnull public final RestoreSnapshotRequest.Builder storageType(@Nullable String value)
      Where will be the authoritative store of the restored indexes' data. A value of local indicates that all snapshot metadata and index data will be downloaded to local storage. A value of remote_snapshot indicates that snapshot metadata will be downloaded to the cluster, but the remote repository will remain the authoritative store of the index data. Data will be downloaded and cached as necessary to service queries. At least one node in the cluster must be configured with the search role in order to restore a snapshot using the type remote_snapshot.

      API name: storage_type

    • waitForCompletion

      @Nonnull public final RestoreSnapshotRequest.Builder waitForCompletion(@Nullable Boolean value)
      -| Whether to return a response after the restore operation has completed. When false, the request returns a response when the restore operation initializes. When true, the request returns a response when the restore operation completes.

      API name: wait_for_completion

    • build

      @Nonnull public RestoreSnapshotRequest build()
      Builds a RestoreSnapshotRequest.
      Specified by:
      build in interface ObjectBuilder<RestoreSnapshotRequest>
      Throws:
      NullPointerException - if some of the required fields are null.