Source-only repository

You can use a source-only repository to take minimal, source-only snapshots that use up to 50% less disk space than regular snapshots.

Unlike other repository types, a source-only repository doesn’t directly store snapshots. It delegates storage to another registered snapshot repository.

When you take a snapshot using a source-only repository, Elasticsearch creates a source-only snapshot in the delegated storage repository. This snapshot only contains stored fields and metadata. It doesn’t include index or doc values structures and isn’t immediately searchable when restored. To search the restored data, you first have to reindex it into a new data stream or index.

Before registering a source-only repository, use Kibana or the create snapshot repository API to register a snapshot repository of another type to use for storage. Then register the source-only repository and specify the delegated storage repository in the request.

resp = client.snapshot.create_repository(
    name="my_src_only_repository",
    repository={
        "type": "source",
        "settings": {
            "delegate_type": "fs",
            "location": "my_backup_repository"
        }
    },
)
print(resp)

response = client.snapshot.create_repository(
  repository: 'my_src_only_repository',
  body: {
    type: 'source',
    settings: {
      delegate_type: 'fs',
      location: 'my_backup_repository'
    }
  }
)
puts response

const response = await client.snapshot.createRepository({
  name: "my_src_only_repository",
  repository: {
    type: "source",
    settings: {
      delegate_type: "fs",
      location: "my_backup_repository",
    },
  },
});
console.log(response);

PUT _snapshot/my_src_only_repository
{
  "type": "source",
  "settings": {
    "delegate_type": "fs",
    "location": "my_backup_repository"
  }
}