Table of Contents | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
Swarm Storage integrates with Elasticsearch to let , allowing client applications to list and search the metadata on the objects being stored in the Swarm cluster. You access Access these operations by applying query arguments that are specific to the search.
See Elasticsearch for Swarm for details on implementing and managing Elasticsearch.
Scope of Searching in Swarm
Swarm Search supports domain-level searching; to search on your an entire cluster , and iterate across the domains. Swarm looks up objects by the underlying contextid
so that you querying can query be performed by context (domain/bucket) name as usual but always get correct query results even if a domain or bucket has been renamed. After this lookup, Swarm generates the final content query after this lookup, which supports a wide range of functionality:
Filter by name or value. You can filter Name or Value: Filter by an object's
name
or by any of its metadata (field
) using equality checks, greater/less than comparisons, and wildcard matches.Filter by
buckets. You can filterBuckets: Filter the search to certain buckets (
To restrictcontext
) using greater/less than comparison (for buckets in numbered ranges) or wildcard matches (for buckets that match a prefix pattern).Include the bucket in the URL path to restrict the search to a single bucket
, you only need to include the bucket in the URL path.
Filter by object type. You can add Object Type: Add the
stype
argument to filter by one of these Swarm types: domain, bucket, named, alias, immutable, unnamed (both alias and immutable), or all.Operate on
metadata fields. You can performMetadata Fields: Perform AND and OR operations on the values of metadata fields to find the matching objects.
Sort by value. Your sort Value: Sort specification can combine multiple metadata fields, including the context.
Paginate large result sets with sort markers. You can apply Apply markers when the context is sorted (ascending or descending) and in conjunction with markers for other metadata fields, when the sort specification includes multiple fields.
Calculate disk usage. Disk Usage: The
du
aggregation filters the results to calculate disk usage, inclusive or exclusive of object replicas in the cluster.Locate
versions. If you are using versioning, you can useVersions: Use the
of theversions
argument to surface allhistorical versions of a single object or of all objects in the context if using versioning.
...