- Enterprise Search Guide: other versions:
- Getting started
- Prerequisites
- Ingestion
- Web crawler
- Connectors
- Native connectors
- Connector clients and frameworks
- Workplace Search connectors
- Usage
- Known issues
- Troubleshooting
- Logs
- Security
- Sync rules
- Content extraction
- Reference: Azure Blob Storage
- Reference: Confluence
- Reference: Google Cloud Storage
- Reference: Jira
- Reference: Microsoft SQL
- Reference: MongoDB
- Reference: MySQL
- Reference: Network drive
- Reference: Oracle
- Reference: PostgreSQL
- Reference: S3
- Reference: SharePoint
- Ingestion APIs
- Ingest pipelines
- Document enrichment with ML
- ELSER text expansion
- Indices, engines, content sources
- Programming language clients
- Behavioral analytics
- Search UI
- App Search and Workplace Search
- Search Applications
- Enterprise Search server
- Run using Docker images
- Run using downloads (packages)
- Enterprise Search server known issues
- Troubleshooting
- Troubleshooting setup
- Monitoring
- Read-only mode
- Management APIs
- Monitoring APIs
- Read-only mode API
- Storage API
- Configuration
- Configuring encryption keys
- Configuring a mail service
- Configuring SSL/TLS
- Upgrading and migrating
- Upgrading self-managed deployments
- Upgrading from Enterprise Search 7.x
- Upgrading from Enterprise Search 7.11 and earlier
- Migrating from App Search on Elastic Cloud
- Migrating from App Search on Swiftype.com
- Migrating from self-managed App Search
- Logs and logging
- Known issues
- Troubleshooting
- Help, support, and feedback
- Release notes
- 8.8.2 release notes
- 8.8.1 release notes
- 8.8.0 release notes
- 8.7.1 release notes
- 8.7.0 release notes
- 8.6.2 release notes
- 8.6.1 release notes
- 8.6.0 release notes
- 8.5.3 release notes
- 8.5.2 release notes
- 8.5.1 release notes
- 8.5.0 release notes
- 8.4.3 release notes
- 8.4.2 release notes
- 8.4.1 release notes
- 8.4.0 release notes
- 8.3.3 release notes
- 8.3.2 release notes
- 8.3.1 release notes
- 8.3.0 release notes
- 8.2.3 release notes
- 8.2.2 release notes
- 8.2.1 release notes
- 8.2.0 release notes
- 8.1.3 release notes
- 8.1.2 release notes
- 8.1.1 release notes
- 8.1.0 release notes
- 8.0.1 release notes
- 8.0.0 release notes
- 8.0.0-rc2 release notes
- 8.0.0-rc1 release notes
- 8.0.0-beta1 release notes
- 8.0.0-alpha2 release notes
- 8.0.0-alpha1 release notes
Storage API
editStorage API
editUse the Storage API to get information about internal indices created and managed by Enterprise Search, and how much space they occupy. You can also list or remove stale indices, which were left behind by older versions of Enterprise Search during upgrades.
Get storage API
editGet storage information for a deployment.
GET <enterprise-search-base-url>/api/ent/v1/internal/storage
Path parameters
edit-
enterprise-search-base-url
(required) - The Enterprise Search base URL for the deployment.
Response body
editEach response includes indices
and summary
.
Each index in the list of indices
has the following fields:
-
name
(required) - The index name.
-
size_in_bytes
(required) - Size of the index, in bytes.
The summary contains the following elements:
-
index_count
(required) - Total number of indices.
-
size_in_bytes
(required) - Total number of indices.
Examples
editList all Enterprise Search indices:
curl \ --request "GET" \ --url "${ENTERPRISE_SEARCH_BASE_URL}/api/ent/v1/internal/storage" \ --header "Authorization: Bearer ${API_KEY}"
Response:
{ "indices": [ { "name": ".ent-search-actastic-app_search_accounts_v10", "size_in_bytes": 5362 }, { "name": ".ent-search-actastic-app_search_accounts_v11", "size_in_bytes": 12317 }, { "name": ".ent-search-actastic-app_search_api_token_engines", "size_in_bytes": 226 }, ... ], "summary": { "index_count": 109, "size_in_bytes": 6572252 } }
Get stale storage API
editGet the list of outdated indices, left behind by older versions of Enterprise Search.
GET <enterprise-search-base-url>/api/ent/v1/internal/storage/stale
Path parameters
edit-
enterprise-search-base-url
(required) - The Enterprise Search base URL for the deployment.
Response body
editEach response includes indices
and summary
.
Each index in the list of indices
has the following fields:
-
name
(required) - The index name.
-
size_in_bytes
(required) - Size of the index, in bytes.
The summary contains the following elements:
-
index_count
(required) - Total number of indices.
-
size_in_bytes
(required) - Total number of indices.
Examples
editList outdated Enterprise Search indices:
curl \ --request "GET" \ --url "${ENTERPRISE_SEARCH_BASE_URL}/api/ent/v1/internal/storage/stale" \ --header "Authorization: Bearer ${API_KEY}"
Response:
{ "indices": [ { "name": ".ent-search-actastic-app_search_accounts_v10", "size_in_bytes": 5362 }, { "name": ".ent-search-actastic-app_search_role_engines_v3", "size_in_bytes": 226 }, { "name": ".ent-search-actastic-app_search_role_mapping_engines_v3", "size_in_bytes": 226 }, ... ], "summary": { "index_count": 40, "size_in_bytes": 379439 } }
Delete stale storage API
editDelete outdated indices, left behind by older versions of Enterprise Search.
DELETE <enterprise-search-base-url>/api/ent/v1/internal/storage/stale
Path parameters
edit-
enterprise-search-base-url
(required) - The Enterprise Search base URL for the deployment.
Query string parameters
edit-
force
(optional) -
If this flag is set to
true
, Enterprise Search will attempt to delete the outdated indices, even if the deployment indices are found to be in an inconsistent state. The default isfalse
.
Response body
editEach response includes indices
and index_count
.
-
indices
(required) - The list of deleted index names.
-
index_count
(required) - Total number of deleted indices.
Examples
editDelete outdated Enterprise Search indices:
curl \ --request "DELETE" \ --url "${ENTERPRISE_SEARCH_BASE_URL}/api/ent/v1/internal/storage/stale" \ --header "Authorization: Bearer ${API_KEY}"
Response:
{ "indices": [ ".ent-search-actastic-app_search_accounts_v10", ".ent-search-actastic-app_search_role_engines_v3", ".ent-search-actastic-app_search_role_mapping_engines_v3", ... ], "index_count": 40 }
On this page