public final class SearchServiceClient extends Object
Modifier and Type | Method and Description |
---|---|
PagedIterable<TokenInfo> |
analyzeText(String indexName,
AnalyzeRequest analyzeRequest)
Shows how an analyzer breaks text into tokens.
|
PagedIterable<TokenInfo> |
analyzeText(String indexName,
AnalyzeRequest analyzeRequest,
RequestOptions requestOptions,
Context context)
Shows how an analyzer breaks text into tokens.
|
DataSource |
createDataSource(DataSource dataSource)
Creates a new Azure Cognitive Search data source
|
Response<DataSource> |
createDataSourceWithResponse(DataSource dataSource,
RequestOptions requestOptions,
Context context)
Creates a new Azure Cognitive Search data source
|
Index |
createIndex(Index index)
Creates a new Azure Cognitive Search index
|
Indexer |
createIndexer(Indexer indexer)
Creates a new Azure Cognitive Search indexer.
|
Response<Indexer> |
createIndexerWithResponse(Indexer indexer,
RequestOptions requestOptions,
Context context)
Creates a new Azure Cognitive Search indexer.
|
Response<Index> |
createIndexWithResponse(Index index,
RequestOptions requestOptions,
Context context)
Creates a new Azure Cognitive Search index
|
DataSource |
createOrUpdateDataSource(DataSource dataSource)
Creates a new Azure Cognitive Search data source or updates a data source if it already exists
|
Response<DataSource> |
createOrUpdateDataSourceWithResponse(DataSource dataSource,
MatchConditions accessCondition,
RequestOptions requestOptions,
Context context)
Creates a new Azure Cognitive Search data source or updates a data source if it already exists.
|
Index |
createOrUpdateIndex(Index index)
Creates a new Azure Cognitive Search index or updates an index if it already exists.
|
Indexer |
createOrUpdateIndexer(Indexer indexer)
Creates a new Azure Cognitive Search indexer or updates an indexer if it already exists.
|
Response<Indexer> |
createOrUpdateIndexerWithResponse(Indexer indexer,
MatchConditions accessCondition,
RequestOptions requestOptions,
Context context)
Creates a new Azure Cognitive Search indexer or updates an indexer if it already exists.
|
Response<Index> |
createOrUpdateIndexWithResponse(Index index,
boolean allowIndexDowntime,
MatchConditions accessCondition,
RequestOptions requestOptions,
Context context)
Creates a new Azure Cognitive Search index or updates an index if it already exists.
|
Skillset |
createOrUpdateSkillset(Skillset skillset)
Creates a new Azure Cognitive Search skillset or updates a skillset if it already exists.
|
Response<Skillset> |
createOrUpdateSkillsetWithResponse(Skillset skillset,
MatchConditions accessCondition,
RequestOptions requestOptions,
Context context)
Creates a new Azure Cognitive Search skillset or updates a skillset if it already exists.
|
SynonymMap |
createOrUpdateSynonymMap(SynonymMap synonymMap)
Creates a new Azure Cognitive Search synonym map or updates a synonym map if it already exists.
|
Response<SynonymMap> |
createOrUpdateSynonymMapWithResponse(SynonymMap synonymMap,
MatchConditions accessCondition,
RequestOptions requestOptions,
Context context)
Creates a new Azure Cognitive Search synonym map or updates a synonym map if it already exists.
|
Skillset |
createSkillset(Skillset skillset)
Creates a new skillset in an Azure Cognitive Search service.
|
Response<Skillset> |
createSkillsetWithResponse(Skillset skillset,
RequestOptions requestOptions,
Context context)
Creates a new skillset in an Azure Cognitive Search service.
|
SynonymMap |
createSynonymMap(SynonymMap synonymMap)
Creates a new Azure Cognitive Search synonym map.
|
Response<SynonymMap> |
createSynonymMapWithResponse(SynonymMap synonymMap,
RequestOptions requestOptions,
Context context)
Creates a new Azure Cognitive Search synonym map.
|
void |
deleteDataSource(String dataSourceName)
Delete a DataSource
|
Response<Void> |
deleteDataSourceWithResponse(String dataSourceName,
MatchConditions accessCondition,
RequestOptions requestOptions,
Context context)
Delete a DataSource with Response
|
void |
deleteIndex(String indexName)
Deletes an Azure Cognitive Search index and all the documents it contains.
|
void |
deleteIndexer(String indexerName)
Deletes an Azure Cognitive Search indexer.
|
Response<Void> |
deleteIndexerWithResponse(String indexerName,
MatchConditions accessCondition,
RequestOptions requestOptions,
Context context)
Deletes an Azure Cognitive Search indexer.
|
Response<Void> |
deleteIndexWithResponse(String indexName,
MatchConditions accessCondition,
RequestOptions requestOptions,
Context context)
Deletes an Azure Cognitive Search index and all the documents it contains.
|
void |
deleteSkillset(String skillsetName)
Deletes a cognitive skillset in an Azure Cognitive Search service.
|
Response<Void> |
deleteSkillsetWithResponse(String skillsetName,
MatchConditions accessCondition,
RequestOptions requestOptions,
Context context)
Deletes a cognitive skillset in an Azure Cognitive Search service.
|
void |
deleteSynonymMap(String synonymMapName)
Deletes an Azure Cognitive Search synonym map.
|
Response<Void> |
deleteSynonymMapWithResponse(String synonymMapName,
MatchConditions accessCondition,
RequestOptions requestOptions,
Context context)
Deletes an Azure Cognitive Search synonym map.
|
DataSource |
getDataSource(String dataSourceName)
Retrieves a DataSource from an Azure Cognitive Search service.
|
Response<DataSource> |
getDataSourceWithResponse(String dataSourceName,
RequestOptions requestOptions,
Context context)
Retrieves a DataSource from an Azure Cognitive Search service.
|
String |
getEndpoint()
Gets the endpoint for the Azure Cognitive Search service.
|
Index |
getIndex(String indexName)
Retrieves an index definition from the Azure Cognitive Search.
|
SearchIndexClient |
getIndexClient(String indexName)
Initializes a new
SearchIndexClient using the given Index name and the same configuration as the
SearchServiceClient. |
Indexer |
getIndexer(String indexerName)
Retrieves an indexer definition.
|
IndexerExecutionInfo |
getIndexerStatus(String indexerName)
Returns the current status and execution history of an indexer.
|
Response<IndexerExecutionInfo> |
getIndexerStatusWithResponse(String indexerName,
RequestOptions requestOptions,
Context context)
Returns the current status and execution history of an indexer.
|
Response<Indexer> |
getIndexerWithResponse(String indexerName,
RequestOptions requestOptions,
Context context)
Retrieves an indexer definition.
|
GetIndexStatisticsResult |
getIndexStatistics(String indexName)
Returns statistics for the given index, including a document count and storage usage.
|
Response<GetIndexStatisticsResult> |
getIndexStatisticsWithResponse(String indexName,
RequestOptions requestOptions,
Context context)
Returns statistics for the given index, including a document count and storage usage.
|
Response<Index> |
getIndexWithResponse(String indexName,
RequestOptions requestOptions,
Context context)
Retrieves an index definition from the Azure Cognitive Search.
|
ServiceStatistics |
getServiceStatistics()
Returns service level statistics for a search service, including service counters and limits.
|
Response<ServiceStatistics> |
getServiceStatisticsWithResponse(RequestOptions requestOptions,
Context context)
Returns service level statistics for a search service, including service counters and limits.
|
SearchServiceVersion |
getServiceVersion()
Gets search service version.
|
Skillset |
getSkillset(String skillsetName)
Retrieves a skillset definition.
|
Response<Skillset> |
getSkillsetWithResponse(String skillsetName,
RequestOptions requestOptions,
Context context)
Retrieves a skillset definition.
|
SynonymMap |
getSynonymMap(String synonymMapName)
Retrieves a synonym map definition.
|
Response<SynonymMap> |
getSynonymMapWithResponse(String synonymMapName,
RequestOptions requestOptions,
Context context)
Retrieves a synonym map definition.
|
PagedIterable<DataSource> |
listDataSources()
List all DataSources from an Azure Cognitive Search service.
|
PagedIterable<DataSource> |
listDataSources(String select,
RequestOptions requestOptions,
Context context)
List all DataSources from an Azure Cognitive Search service.
|
PagedIterable<Indexer> |
listIndexers()
Lists all indexers available for an Azure Cognitive Search service.
|
PagedIterable<Indexer> |
listIndexers(String select,
RequestOptions requestOptions,
Context context)
Lists all indexers available for an Azure Cognitive Search service.
|
PagedIterable<Index> |
listIndexes()
Lists all indexes available for an Azure Cognitive Search service.
|
PagedIterable<Index> |
listIndexes(String select,
RequestOptions requestOptions,
Context context)
Lists all indexes available for an Azure Cognitive Search service.
|
PagedIterable<Skillset> |
listSkillsets()
Lists all skillsets available for an Azure Cognitive Search service.
|
PagedIterable<Skillset> |
listSkillsets(String select,
RequestOptions requestOptions,
Context context)
Lists all skillsets available for an Azure Cognitive Search service.
|
PagedIterable<SynonymMap> |
listSynonymMaps()
Lists all synonym maps available for an Azure Cognitive Search service.
|
PagedIterable<SynonymMap> |
listSynonymMaps(String select,
RequestOptions requestOptions,
Context context)
Lists all synonym maps available for an Azure Cognitive Search service.
|
void |
resetIndexer(String indexerName)
Resets the change tracking state associated with an indexer.
|
Response<Void> |
resetIndexerWithResponse(String indexerName,
RequestOptions requestOptions,
Context context)
Resets the change tracking state associated with an indexer.
|
void |
runIndexer(String indexerName)
Runs an indexer on-demand.
|
Response<Void> |
runIndexerWithResponse(String indexerName,
RequestOptions requestOptions,
Context context)
Runs an indexer on-demand.
|
public SearchIndexClient getIndexClient(String indexName)
SearchIndexClient
using the given Index name and the same configuration as the
SearchServiceClient.indexName
- the name of the Index for the clientSearchIndexClient
created from the service client configurationpublic SearchServiceVersion getServiceVersion()
public String getEndpoint()
public DataSource createOrUpdateDataSource(DataSource dataSource)
dataSource
- The definition of the data source to create or update.public Response<DataSource> createOrUpdateDataSourceWithResponse(DataSource dataSource, MatchConditions accessCondition, RequestOptions requestOptions, Context context)
dataSource
- the definition of the data source to create or updateaccessCondition
- the condition where the operation will be performed if the ETag on the server matches or
doesn't match specified valuesrequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- additional context that is passed through the HTTP pipeline during the service callpublic DataSource createDataSource(DataSource dataSource)
dataSource
- The definition of the data source to createpublic Response<DataSource> createDataSourceWithResponse(DataSource dataSource, RequestOptions requestOptions, Context context)
dataSource
- the definition of the data source to create doesn't match specified valuesrequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- additional context that is passed through the HTTP pipeline during the service callpublic DataSource getDataSource(String dataSourceName)
dataSourceName
- the name of the data source to retrievepublic Response<DataSource> getDataSourceWithResponse(String dataSourceName, RequestOptions requestOptions, Context context)
dataSourceName
- the name of the data source to retrieverequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debugging.context
- additional context that is passed through the HTTP pipeline during the service callpublic PagedIterable<DataSource> listDataSources()
public PagedIterable<DataSource> listDataSources(String select, RequestOptions requestOptions, Context context)
select
- Selects which top-level properties of DataSource definitions to retrieve. Specified as a
comma-separated list of JSON property names, or '*' for all properties. The default is all properties.requestOptions
- Additional parameters for the operation. Contains the tracking ID sent with the request to
help with debugging.context
- Additional context that is passed through the HTTP pipeline during the service call.public void deleteDataSource(String dataSourceName)
dataSourceName
- the name of the data source to be deletedpublic Response<Void> deleteDataSourceWithResponse(String dataSourceName, MatchConditions accessCondition, RequestOptions requestOptions, Context context)
dataSourceName
- the name of the data source to be deletedaccessCondition
- the condition where the operation will be performed if the ETag on the server matches or
doesn't match specified valuesrequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- additional context that is passed through the HTTP pipeline during the service callpublic Indexer createIndexer(Indexer indexer)
indexer
- definition of the indexer to create.public Response<Indexer> createIndexerWithResponse(Indexer indexer, RequestOptions requestOptions, Context context)
indexer
- definition of the indexer to createrequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- additional context that is passed through the HTTP pipeline during the service callpublic Indexer createOrUpdateIndexer(Indexer indexer)
indexer
- The definition of the indexer to create or update.public Response<Indexer> createOrUpdateIndexerWithResponse(Indexer indexer, MatchConditions accessCondition, RequestOptions requestOptions, Context context)
indexer
- The definition of the indexer to create or update.accessCondition
- the condition where the operation will be performed if the ETag on the server matches or
doesn't match specified valuesrequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- additional context that is passed through the HTTP pipeline during the service callpublic PagedIterable<Indexer> listIndexers()
public PagedIterable<Indexer> listIndexers(String select, RequestOptions requestOptions, Context context)
select
- Selects which top-level properties of the indexers to retrieve. Specified as a comma-separated list
of JSON property names, or '*' for all properties. The default is all properties.requestOptions
- Additional parameters for the operation.context
- additional context that is passed through the HTTP pipeline during the service callpublic Indexer getIndexer(String indexerName)
indexerName
- the name of the indexer to retrievepublic Response<Indexer> getIndexerWithResponse(String indexerName, RequestOptions requestOptions, Context context)
indexerName
- the name of the indexer to retrieverequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- additional context that is passed through the HTTP pipeline during the service callpublic void deleteIndexer(String indexerName)
indexerName
- the name of the indexer to deletepublic Response<Void> deleteIndexerWithResponse(String indexerName, MatchConditions accessCondition, RequestOptions requestOptions, Context context)
indexerName
- the name of the indexer to deleteaccessCondition
- the condition where the operation will be performed if the ETag on the server matches or
doesn't match specified valuesrequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- the contextpublic void resetIndexer(String indexerName)
indexerName
- the name of the indexer to resetpublic Response<Void> resetIndexerWithResponse(String indexerName, RequestOptions requestOptions, Context context)
indexerName
- the name of the indexer to resetrequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- additional context that is passed through the HTTP pipeline during the service callpublic void runIndexer(String indexerName)
indexerName
- the name of the indexer to runpublic Response<Void> runIndexerWithResponse(String indexerName, RequestOptions requestOptions, Context context)
indexerName
- the name of the indexer to runrequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- additional context that is passed through the HTTP pipeline during the service callpublic IndexerExecutionInfo getIndexerStatus(String indexerName)
indexerName
- the name of the indexer for which to retrieve statuspublic Response<IndexerExecutionInfo> getIndexerStatusWithResponse(String indexerName, RequestOptions requestOptions, Context context)
indexerName
- the name of the indexer for which to retrieve statusrequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- additional context that is passed through the HTTP pipeline during the service callpublic Index createIndex(Index index)
index
- definition of the index to createpublic Response<Index> createIndexWithResponse(Index index, RequestOptions requestOptions, Context context)
index
- definition of the index to createrequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- additional context that is passed through the HTTP pipeline during the service callpublic Index getIndex(String indexName)
indexName
- the name of the index to retrievepublic Response<Index> getIndexWithResponse(String indexName, RequestOptions requestOptions, Context context)
indexName
- the name of the index to retrieverequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- additional context that is passed through the HTTP pipeline during the service callpublic GetIndexStatisticsResult getIndexStatistics(String indexName)
indexName
- the name of the index for which to retrieve statisticspublic Response<GetIndexStatisticsResult> getIndexStatisticsWithResponse(String indexName, RequestOptions requestOptions, Context context)
indexName
- the name of the index for which to retrieve statisticsrequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- additional context that is passed through the HTTP pipeline during the service callpublic PagedIterable<Index> listIndexes()
public PagedIterable<Index> listIndexes(String select, RequestOptions requestOptions, Context context)
select
- selects which top-level properties of the index definitions to retrieve. Specified as a
comma-separated list of JSON property names, or '*' for all properties. The default is all propertiesrequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- additional context that is passed through the HTTP pipeline during the service callpublic Index createOrUpdateIndex(Index index)
index
- the definition of the index to create or updatepublic Response<Index> createOrUpdateIndexWithResponse(Index index, boolean allowIndexDowntime, MatchConditions accessCondition, RequestOptions requestOptions, Context context)
index
- the definition of the index to create or updateallowIndexDowntime
- allows new analyzers, tokenizers, token filters, or char filters to be added to an
index by taking the index offline for at least a few seconds. This temporarily causes indexing and query requests
to fail. Performance and write availability of the index can be impaired for several minutes after the index is
updated, or longer for very large indexes.accessCondition
- the condition where the operation will be performed if the ETag on the server matches or
doesn't match specified valuesrequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- additional context that is passed through the HTTP pipeline during the service callpublic void deleteIndex(String indexName)
indexName
- the name of the index to deletepublic Response<Void> deleteIndexWithResponse(String indexName, MatchConditions accessCondition, RequestOptions requestOptions, Context context)
indexName
- the name of the index to deleteaccessCondition
- the condition where the operation will be performed if the ETag on the server matches or
doesn't match specified valuesrequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- additional context that is passed through the Http pipeline during the service callpublic PagedIterable<TokenInfo> analyzeText(String indexName, AnalyzeRequest analyzeRequest)
indexName
- the name of the index for which to test an analyzeranalyzeRequest
- the text and analyzer or analysis components to testpublic PagedIterable<TokenInfo> analyzeText(String indexName, AnalyzeRequest analyzeRequest, RequestOptions requestOptions, Context context)
indexName
- the name of the index for which to test an analyzeranalyzeRequest
- the text and analyzer or analysis components to testrequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- additional context that is passed through the HTTP pipeline during the service callpublic Skillset createSkillset(Skillset skillset)
skillset
- definition of the skillset containing one or more cognitive skillspublic Response<Skillset> createSkillsetWithResponse(Skillset skillset, RequestOptions requestOptions, Context context)
skillset
- definition of the skillset containing one or more cognitive skillsrequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- additional context that is passed through the HTTP pipeline during the service callpublic Skillset getSkillset(String skillsetName)
skillsetName
- the name of the skillset to retrievepublic Response<Skillset> getSkillsetWithResponse(String skillsetName, RequestOptions requestOptions, Context context)
skillsetName
- the name of the skillset to retrieverequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- additional context that is passed through the HTTP pipeline during the service callpublic PagedIterable<Skillset> listSkillsets()
public PagedIterable<Skillset> listSkillsets(String select, RequestOptions requestOptions, Context context)
select
- selects which top-level properties of the skillset definitions to retrieve. Specified as a
comma-separated list of JSON property names, or '*' for all properties. The default is all propertiesrequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- additional context that is passed through the HTTP pipeline during the service callpublic Skillset createOrUpdateSkillset(Skillset skillset)
skillset
- the definition of the skillset to create or updatepublic Response<Skillset> createOrUpdateSkillsetWithResponse(Skillset skillset, MatchConditions accessCondition, RequestOptions requestOptions, Context context)
skillset
- the definition of the skillset to create or updateaccessCondition
- the condition where the operation will be performed if the ETag on the server matches or
doesn't match specified valuesrequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- additional context that is passed through the HTTP pipeline during the service callpublic void deleteSkillset(String skillsetName)
skillsetName
- the name of the skillset to deletepublic Response<Void> deleteSkillsetWithResponse(String skillsetName, MatchConditions accessCondition, RequestOptions requestOptions, Context context)
skillsetName
- the name of the skillset to deleteaccessCondition
- the condition where the operation will be performed if the ETag on the server matches or
doesn't match specified valuesrequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- additional context that is passed through the HTTP pipeline during the service callpublic SynonymMap createSynonymMap(SynonymMap synonymMap)
synonymMap
- the definition of the synonym map to createSynonymMap
.public Response<SynonymMap> createSynonymMapWithResponse(SynonymMap synonymMap, RequestOptions requestOptions, Context context)
synonymMap
- the definition of the synonym map to createrequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- additional context that is passed through the HTTP pipeline during the service callpublic SynonymMap getSynonymMap(String synonymMapName)
synonymMapName
- name of the synonym map to retrieveSynonymMap
definitionpublic Response<SynonymMap> getSynonymMapWithResponse(String synonymMapName, RequestOptions requestOptions, Context context)
synonymMapName
- name of the synonym map to retrieverequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- a context that is passed through the HTTP pipeline during the service callpublic PagedIterable<SynonymMap> listSynonymMaps()
public PagedIterable<SynonymMap> listSynonymMaps(String select, RequestOptions requestOptions, Context context)
select
- selects which top-level properties of the index definitions to retrieve. Specified as a
comma-separated list of JSON property names, or '*' for all properties. The default is all propertiesrequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- additional context that is passed through the HTTP pipeline during the service callpublic SynonymMap createOrUpdateSynonymMap(SynonymMap synonymMap)
synonymMap
- the definition of the synonym map to create or updatepublic Response<SynonymMap> createOrUpdateSynonymMapWithResponse(SynonymMap synonymMap, MatchConditions accessCondition, RequestOptions requestOptions, Context context)
synonymMap
- the definition of the synonym map to create or updateaccessCondition
- the condition where the operation will be performed if the ETag on the server matches or
doesn't match specified valuesrequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- additional context that is passed through the HTTP pipeline during the service callpublic void deleteSynonymMap(String synonymMapName)
synonymMapName
- the name of the synonym map to deletepublic Response<Void> deleteSynonymMapWithResponse(String synonymMapName, MatchConditions accessCondition, RequestOptions requestOptions, Context context)
synonymMapName
- the name of the synonym map to deleteaccessCondition
- the condition where the operation will be performed if the ETag on the server matches or
doesn't match specified valuesrequestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- additional context that is passed through the Http pipeline during the service callpublic ServiceStatistics getServiceStatistics()
public Response<ServiceStatistics> getServiceStatisticsWithResponse(RequestOptions requestOptions, Context context)
requestOptions
- additional parameters for the operation. Contains the tracking ID sent with the request to
help with debuggingcontext
- additional context that is passed through the HTTP pipeline during the service callCopyright © 2020 Microsoft Corporation. All rights reserved.