azure.search.documents.indexes package

class azure.search.documents.indexes.SearchIndexClient(endpoint: str, credential: AzureKeyCredential | TokenCredential, **kwargs: Any)[source]

A client to interact with Azure search service index.

Parameters:
Keyword Arguments:

  • api_version (str) – The Search API version to use for requests.

  • audience (str) – sets the Audience to use for authentication with Azure Active Directory (AAD). The audience is not considered when using a shared key. If audience is not provided, the public cloud audience will be assumed.

analyze_text(index_name: str, analyze_request: AnalyzeTextOptions, **kwargs: Any) → AnalyzeResult[source]

Shows how an analyzer breaks text into tokens.

Parameters:

  • index_name (str) – The name of the index for which to test an analyzer.

  • analyze_request (AnalyzeTextOptions) – The text and analyzer or analysis components to test.

Returns:

AnalyzeResult

Return type:

AnalyzeResult

Raises:

HttpResponseError – If the operation fails.

Example:

Analyze text
from azure.core.credentials import AzureKeyCredential
from azure.search.documents.indexes import SearchIndexClient
from azure.search.documents.indexes.models import AnalyzeTextOptions

client = SearchIndexClient(service_endpoint, AzureKeyCredential(key))

analyze_request = AnalyzeTextOptions(text="One's <two/>", analyzer_name="standard.lucene")

result = client.analyze_text(index_name, analyze_request)
print(result.as_dict())
close() → None[source]

Close the session.

Returns:

None

Return type:

None

create_alias(alias: SearchAlias, **kwargs: Any) → SearchAlias[source]

Creates a new search alias.

Parameters:

alias (SearchAlias) – The alias object.

Returns:

The alias created

Return type:

SearchAlias

Raises:

HttpResponseError – If the operation fails.

Example:

Creating a new alias.
alias = SearchAlias(name=alias_name, indexes=[index_name])
result = client.create_alias(alias)
create_index(index: SearchIndex, **kwargs: Any) → SearchIndex[source]

Creates a new search index.

Parameters:

index (SearchIndex) – The index object.

Returns:

The index created

Return type:

SearchIndex

Raises:

HttpResponseError – If the operation fails.

Example:

Creating a new index.
client = SearchIndexClient(service_endpoint, AzureKeyCredential(key))
name = "hotels"
fields = [
    SimpleField(name="hotelId", type=SearchFieldDataType.String, key=True),
    SimpleField(name="hotelName", type=SearchFieldDataType.String, searchable=True),
    SimpleField(name="baseRate", type=SearchFieldDataType.Double),
    SearchableField(name="description", type=SearchFieldDataType.String, collection=True),
    ComplexField(
        name="address",
        fields=[
            SimpleField(name="streetAddress", type=SearchFieldDataType.String),
            SimpleField(name="city", type=SearchFieldDataType.String),
        ],
        collection=True,
    ),
]
cors_options = CorsOptions(allowed_origins=["*"], max_age_in_seconds=60)
scoring_profiles: List[ScoringProfile] = []
index = SearchIndex(name=name, fields=fields, scoring_profiles=scoring_profiles, cors_options=cors_options)

result = client.create_index(index)
create_or_update_alias(alias: SearchAlias, *, match_condition: MatchConditions = MatchConditions.Unconditionally, **kwargs: Any) → SearchAlias[source]

Creates a new search alias or updates an alias if it already exists.

Parameters:

alias (SearchAlias) – The definition of the alias to create or update.

Keyword Arguments:

match_condition (MatchConditions) – The match condition to use upon the etag

Returns:

The index created or updated

Return type:

SearchAlias

Raises:

Example:

Updating an alias.
new_index_name = "hotels"
fields = [
    SimpleField(name="hotelId", type=SearchFieldDataType.String, key=True),
    SimpleField(name="baseRate", type=SearchFieldDataType.Double),
    SearchableField(name="description", type=SearchFieldDataType.String, collection=True),
    SearchableField(name="hotelName", type=SearchFieldDataType.String),
    ComplexField(
        name="address",
        fields=[
            SimpleField(name="streetAddress", type=SearchFieldDataType.String),
            SimpleField(name="city", type=SearchFieldDataType.String),
            SimpleField(name="state", type=SearchFieldDataType.String),
        ],
        collection=True,
    ),
]
cors_options = CorsOptions(allowed_origins=["*"], max_age_in_seconds=60)
scoring_profile = ScoringProfile(name="MyProfile")
scoring_profiles = []
scoring_profiles.append(scoring_profile)
index = SearchIndex(
    name=new_index_name, fields=fields, scoring_profiles=scoring_profiles, cors_options=cors_options
)

result_index = client.create_or_update_index(index=index)

alias = SearchAlias(name=alias_name, indexes=[new_index_name])
result = client.create_or_update_alias(alias)
create_or_update_index(index: SearchIndex, allow_index_downtime: bool | None = None, *, match_condition: MatchConditions = MatchConditions.Unconditionally, **kwargs: Any) → SearchIndex[source]

Creates a new search index or updates an index if it already exists.

Parameters:

  • index (SearchIndex) – The index object.

  • allow_index_downtime (bool) – 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.

Keyword Arguments:

match_condition (MatchConditions) – The match condition to use upon the etag

Returns:

The index created or updated

Return type:

SearchIndex

Raises:

Example:

Update an index.
client = SearchIndexClient(service_endpoint, AzureKeyCredential(key))
name = "hotels"
fields = [
    SimpleField(name="hotelId", type=SearchFieldDataType.String, key=True),
    SimpleField(name="hotelName", type=SearchFieldDataType.String, searchable=True),
    SimpleField(name="baseRate", type=SearchFieldDataType.Double),
    SearchableField(name="description", type=SearchFieldDataType.String, collection=True),
    ComplexField(
        name="address",
        fields=[
            SimpleField(name="streetAddress", type=SearchFieldDataType.String),
            SimpleField(name="city", type=SearchFieldDataType.String),
            SimpleField(name="state", type=SearchFieldDataType.String),
        ],
        collection=True,
    ),
]
cors_options = CorsOptions(allowed_origins=["*"], max_age_in_seconds=60)
scoring_profile = ScoringProfile(name="MyProfile")
scoring_profiles = []
scoring_profiles.append(scoring_profile)
index = SearchIndex(name=name, fields=fields, scoring_profiles=scoring_profiles, cors_options=cors_options)

result = client.create_or_update_index(index=index)
create_or_update_synonym_map(synonym_map: SynonymMap, *, match_condition: MatchConditions = MatchConditions.Unconditionally, **kwargs: Any) → SynonymMap[source]

Create a new Synonym Map in an Azure Search service, or update an existing one.

Parameters:

synonym_map (SynonymMap) – The Synonym Map object

Keyword Arguments:

match_condition (MatchConditions) – The match condition to use upon the etag

Returns:

The created or updated Synonym Map

Return type:

SynonymMap

create_synonym_map(synonym_map: SynonymMap, **kwargs: Any) → SynonymMap[source]

Create a new Synonym Map in an Azure Search service

Parameters:

synonym_map (SynonymMap) – The Synonym Map object

Returns:

The created Synonym Map

Return type:

SynonymMap

Example:

Create a Synonym Map
synonyms = [
    "USA, United States, United States of America",
    "Washington, Wash. => WA",
]
synonym_map = SynonymMap(name="test-syn-map", synonyms=synonyms)
result = client.create_synonym_map(synonym_map)
print("Create new Synonym Map 'test-syn-map succeeded")
delete_alias(alias: str | SearchAlias, *, match_condition: MatchConditions = MatchConditions.Unconditionally, **kwargs: Any) → None[source]

Deletes a search alias and its associated mapping to an index. This operation is permanent, with no recovery option. The mapped index is untouched by this operation

Parameters:

alias (str or SearchAlias) – The alias name or object to delete.

Keyword Arguments:

match_condition (MatchConditions) – The match condition to use upon the etag

Raises:

HttpResponseError – If the operation fails.

Example:

Deleting an alias.

client.delete_alias(alias_name)
delete_index(index: str | SearchIndex, *, match_condition: MatchConditions = MatchConditions.Unconditionally, **kwargs: Any) → None[source]

Deletes a search index and all the documents it contains. The model must be provided instead of the name to use the access conditions.

Parameters:

index (str or SearchIndex) – The index name or object to delete.

Keyword Arguments:

match_condition (MatchConditions) – The match condition to use upon the etag

Raises:

HttpResponseError – If the operation fails.

Example:

Delete an index.
client = SearchIndexClient(service_endpoint, AzureKeyCredential(key))
name = "hotels"
client.delete_index(name)
delete_synonym_map(synonym_map: str | SynonymMap, *, match_condition: MatchConditions = MatchConditions.Unconditionally, **kwargs: Any) → None[source]

Delete a named Synonym Map in an Azure Search service. To use access conditions, the SynonymMap model must be provided instead of the name. It is enough to provide the name of the synonym map to delete unconditionally.

Parameters:

synonym_map (str or SynonymMap) – The synonym map name or object to delete

Keyword Arguments:

match_condition (MatchConditions) – The match condition to use upon the etag

Example:

Delete a Synonym Map
client.delete_synonym_map("test-syn-map")
print("Synonym Map 'test-syn-map' deleted")
get_alias(name: str, **kwargs: Any) → SearchAlias[source]
Parameters:

name (str) – The name of the alias to retrieve.

Returns:

SearchAlias object

Return type:

SearchAlias

Raises:

HttpResponseError – If the operation fails.

get_index(name: str, **kwargs: Any) → SearchIndex[source]

Retrieve a named index in an Azure Search service

Parameters:

name (str) – The name of the index to retrieve.

Returns:

SearchIndex object

Return type:

SearchIndex

Raises:

HttpResponseError – If the operation fails.

Example:

Get an index.
client = SearchIndexClient(service_endpoint, AzureKeyCredential(key))
name = "hotels"
result = client.get_index(name)
get_index_statistics(index_name: str, **kwargs: Any) → MutableMapping[str, Any][source]

Returns statistics for the given index, including a document count and storage usage.

Parameters:

index_name (str) – The name of the index to retrieve.

Returns:

Statistics for the given index, including a document count and storage usage.

Return type:

Dict

Raises:

HttpResponseError – If the operation fails.

get_search_client(index_name: str, **kwargs: Any) → SearchClient[source]

Return a client to perform operations on Search

Parameters:

index_name (str) – The name of the Search Index

Returns:

SearchClient object

Return type:

SearchClient

get_service_statistics(**kwargs: Any) → MutableMapping[str, Any][source]

Get service level statistics for a search service.

Returns:

Service statistics result.

Return type:

dict

get_synonym_map(name: str, **kwargs: Any) → SynonymMap[source]

Retrieve a named Synonym Map in an Azure Search service

Parameters:

name (str) – The name of the Synonym Map to get

Returns:

The retrieved Synonym Map

Return type:

SynonymMap

Raises:

ResourceNotFoundError – If the Synonym Map doesn’t exist.

Example:

Get a Synonym Map
result = client.get_synonym_map("test-syn-map")
print("Retrived Synonym Map 'test-syn-map' with synonyms")
if result:
    for syn in result.synonyms:
        print("    {}".format(syn))
get_synonym_map_names(**kwargs: Any) → List[str][source]

List the Synonym Map names in an Azure Search service.

Returns:

List of synonym maps

Return type:

list[str]

Raises:

HttpResponseError – If the operation fails.

get_synonym_maps(*, select: List[str] | None = None, **kwargs) → List[SynonymMap][source]

List the Synonym Maps in an Azure Search service.

Keyword Arguments:

select (list[str]) – Selects which top-level properties of the skillsets to retrieve. Specified as a list of JSON property names, or ‘*’ for all properties. The default is all properties.

Returns:

List of synonym maps

Return type:

list[SynonymMap]

Raises:

HttpResponseError – If the operation fails.

Example:

List Synonym Maps
result = client.get_synonym_maps()
names = [x.name for x in result]
print("Found {} Synonym Maps in the service: {}".format(len(result), ", ".join(names)))
list_alias_names(**kwargs: Any) → ItemPaged[str][source]

List the alias names in an Azure Search service.

Returns:

List of alias names

Return type:

ItemPaged[str]

Raises:

HttpResponseError – If the operation fails.

list_aliases(*, select: List[str] | None = None, **kwargs: Any) → ItemPaged[SearchAlias][source]

List the aliases in an Azure Search service.

Keyword Arguments:

select (list[str]) – Selects which top-level properties of the skillsets to retrieve. Specified as a list of JSON property names, or ‘*’ for all properties. The default is all properties.

Returns:

List of Aliases

Return type:

ItemPaged[SearchAlias]

Raises:

HttpResponseError – If the operation fails.

list_index_names(**kwargs: Any) → ItemPaged[str][source]

List the index names in an Azure Search service.

Returns:

List of index names

Return type:

ItemPaged[str]

Raises:

HttpResponseError – If the operation fails.

list_indexes(*, select: List[str] | None = None, **kwargs: Any) → ItemPaged[SearchIndex][source]

List the indexes in an Azure Search service.

Keyword Arguments:

select (list[str]) – Selects which top-level properties of the skillsets to retrieve. Specified as a list of JSON property names, or ‘*’ for all properties. The default is all properties.

Returns:

List of indexes

Return type:

ItemPaged[SearchIndex]

Raises:

HttpResponseError – If the operation fails.

send_request(request: HttpRequest, *, stream: bool = False, **kwargs) → HttpResponse[source]

Runs a network request using the client’s existing pipeline.

Parameters:

request (HttpRequest) – The network request you want to make.

Keyword Arguments:

stream (bool) – Whether the response payload will be streamed. Defaults to False.

Returns:

The response of your network call. Does not do error handling on your response.

Return type:

HttpResponse

class azure.search.documents.indexes.SearchIndexerClient(endpoint: str, credential: AzureKeyCredential | TokenCredential, **kwargs: Any)[source]

A client to interact with Azure search service Indexers.

Parameters:
Keyword Arguments:

  • api_version (str) – The Search API version to use for requests.

  • audience (str) – sets the Audience to use for authentication with Azure Active Directory (AAD). The audience is not considered when using a shared key. If audience is not provided, the public cloud audience will be assumed.

close() → None[source]

Close the session.

Returns:

None

Return type:

None

create_data_source_connection(data_source_connection: SearchIndexerDataSourceConnection, **kwargs: Any) → SearchIndexerDataSourceConnection[source]

Creates a new data source connection.

Parameters:

data_source_connection (SearchIndexerDataSourceConnection) – The definition of the data source connection to create.

Returns:

The created SearchIndexerDataSourceConnection

Return type:

SearchIndexerDataSourceConnection

Example:

Create a Data Source
container = SearchIndexerDataContainer(name="searchcontainer")
data_source_connection = SearchIndexerDataSourceConnection(
    name="sample-data-source-connection", type="azureblob", connection_string=connection_string, container=container
)
result = client.create_data_source_connection(data_source_connection)
print(result)
print("Create new Data Source Connection - sample-data-source-connection")
create_indexer(indexer: SearchIndexer, **kwargs: Any) → SearchIndexer[source]

Creates a new SearchIndexer.

Parameters:

indexer (SearchIndexer) – The definition of the indexer to create.

Returns:

The created SearchIndexer

Return type:

SearchIndexer

Example:

Create a SearchIndexer
# create a datasource
container = SearchIndexerDataContainer(name="searchcontainer")
data_source_connection = SearchIndexerDataSourceConnection(
    name="indexer-datasource", type="azureblob", connection_string=connection_string, container=container
)
data_source = indexers_client.create_data_source_connection(data_source_connection)

# create an indexer
indexer = SearchIndexer(
    name="sample-indexer", data_source_name="indexer-datasource", target_index_name="indexer-hotels"
)
result = indexers_client.create_indexer(indexer)
print("Create new Indexer - sample-indexer")
create_or_update_data_source_connection(data_source_connection: SearchIndexerDataSourceConnection, *, match_condition: MatchConditions = MatchConditions.Unconditionally, skip_indexer_reset_requirement_for_cache: bool | None = None, **kwargs: Any) → SearchIndexerDataSourceConnection[source]

Creates a new data source connection or updates a data source connection if it already exists.

Parameters:

data_source_connection (SearchIndexerDataSourceConnection) – The definition of the data source connection to create or update.

Keyword Arguments:

  • match_condition (MatchConditions) – The match condition to use upon the etag

  • skip_indexer_reset_requirement_for_cache (bool) – Ignores cache reset requirements.

Returns:

The created SearchIndexerDataSourceConnection

Return type:

SearchIndexerDataSourceConnection

create_or_update_indexer(indexer: SearchIndexer, *, match_condition: MatchConditions = MatchConditions.Unconditionally, skip_indexer_reset_requirement_for_cache: bool | None = None, disable_cache_reprocessing_change_detection: bool | None = None, **kwargs: Any) → SearchIndexer[source]

Creates a new indexer or updates an indexer if it already exists.

Parameters:

indexer (SearchIndexer) – The definition of the indexer to create or update.

Keyword Arguments:

  • match_condition (MatchConditions) – The match condition to use upon the etag

  • skip_indexer_reset_requirement_for_cache (bool) – Ignores cache reset requirements.

  • disable_cache_reprocessing_change_detection (bool) – Disables cache reprocessing change detection.

Returns:

The created SearchIndexer

Return type:

SearchIndexer

create_or_update_skillset(skillset: SearchIndexerSkillset, *, match_condition: MatchConditions = MatchConditions.Unconditionally, skip_indexer_reset_requirement_for_cache: bool | None = None, disable_cache_reprocessing_change_detection: bool | None = None, **kwargs: Any) → SearchIndexerSkillset[source]

Create a new SearchIndexerSkillset in an Azure Search service, or update an existing one.

Parameters:

skillset (SearchIndexerSkillset) – The SearchIndexerSkillset object to create or update

Keyword Arguments:

  • match_condition (MatchConditions) – The match condition to use upon the etag

  • skip_indexer_reset_requirement_for_cache (bool) – Ignores cache reset requirements.

  • disable_cache_reprocessing_change_detection (bool) – Disables cache reprocessing change detection.

Returns:

The created or updated SearchIndexerSkillset

Return type:

SearchIndexerSkillset

create_skillset(skillset: SearchIndexerSkillset, **kwargs: Any) → SearchIndexerSkillset[source]

Create a new SearchIndexerSkillset in an Azure Search service

Parameters:

skillset (SearchIndexerSkillset) – The SearchIndexerSkillset object to create

Returns:

The created SearchIndexerSkillset

Return type:

SearchIndexerSkillset

delete_data_source_connection(data_source_connection: str | SearchIndexerDataSourceConnection, *, match_condition: MatchConditions = MatchConditions.Unconditionally, **kwargs: Any) → None[source]

Deletes a data source connection. To use access conditions, the SearchIndexerDataSourceConnection model must be provided instead of the name. It is enough to provide the name of the data source connection to delete unconditionally

Parameters:

data_source_connection (str or SearchIndexerDataSourceConnection) – The data source connection to delete.

Keyword Arguments:

match_condition (MatchConditions) – The match condition to use upon the etag

Example:

Delete a SearchIndexerDataSourceConnection
client.delete_data_source_connection("sample-data-source-connection")
print("Data Source Connection 'sample-data-source-connection' successfully deleted")
delete_indexer(indexer: str | SearchIndexer, *, match_condition: MatchConditions = MatchConditions.Unconditionally, **kwargs: Any) → None[source]

Deletes an indexer. To use access conditions, the SearchIndexer model must be provided instead of the name. It is enough to provide the name of the indexer to delete unconditionally.

Parameters:

indexer (str or SearchIndexer) – The indexer to delete.

Keyword Arguments:

match_condition (MatchConditions) – The match condition to use upon the etag

Example:

Delete a SearchIndexer
indexers_client.delete_indexer("sample-indexer")
print("Indexer 'sample-indexer' successfully deleted")
delete_skillset(skillset: str | SearchIndexerSkillset, *, match_condition: MatchConditions = MatchConditions.Unconditionally, **kwargs: Any) → None[source]

Delete a named SearchIndexerSkillset in an Azure Search service. To use access conditions, the SearchIndexerSkillset model must be provided instead of the name. It is enough to provide the name of the skillset to delete unconditionally

Parameters:

skillset (str or SearchIndexerSkillset) – The SearchIndexerSkillset to delete

Keyword Arguments:

match_condition (MatchConditions) – The match condition to use upon the etag

get_data_source_connection(name: str, **kwargs: Any) → SearchIndexerDataSourceConnection[source]

Retrieves a data source connection definition.

Parameters:

name (str) – The name of the data source connection to retrieve.

Returns:

The SearchIndexerDataSourceConnection that is fetched.

Return type:

SearchIndexerDataSourceConnection

Example:

Retrieve a SearchIndexerDataSourceConnection
result = client.get_data_source_connection("sample-data-source-connection")
print("Retrived Data Source Connection 'sample-data-source-connection'")
get_data_source_connection_names(**kwargs: Any) → Sequence[str][source]

Lists all data source connection names available for a search service.

Returns:

List of all the data source connection names.

Return type:

list[str]

get_data_source_connections(*, select: List[str] | None = None, **kwargs: Any) → Sequence[SearchIndexerDataSourceConnection][source]

Lists all data source connections available for a search service.

Keyword Arguments:

select (list[str]) – Selects which top-level properties of the skillsets to retrieve. Specified as a list of JSON property names, or ‘*’ for all properties. The default is all properties.

Returns:

List of all the data source connections.

Return type:

list[SearchIndexerDataSourceConnection]

Example:

List all the SearchIndexerDataSourceConnections
result = client.get_data_source_connections()
names = [ds.name for ds in result]
print("Found {} Data Source Connections in the service: {}".format(len(result), ", ".join(names)))
get_indexer(name: str, **kwargs: Any) → SearchIndexer[source]

Retrieves an indexer definition.

Parameters:

name (str) – The name of the indexer to retrieve.

Returns:

The SearchIndexer that is fetched.

Return type:

SearchIndexer

Example:

Retrieve a SearchIndexer
result = indexers_client.get_indexer("sample-indexer")
print("Retrived Indexer 'sample-indexer'")
return result
get_indexer_names(**kwargs: Any) → Sequence[str][source]

Lists all indexer names available for a search service.

Returns:

List of all the SearchIndexers.

Return type:

list[str]

Example:

List all the SearchIndexers
result = indexers_client.get_indexers()
names = [x.name for x in result]
print("Found {} Indexers in the service: {}".format(len(result), ", ".join(names)))
get_indexer_status(name: str, **kwargs: Any) → SearchIndexerStatus[source]

Get the status of the indexer.

Parameters:

name (str) – The name of the indexer to fetch the status.

Returns:

SearchIndexerStatus

Return type:

SearchIndexerStatus

Example:

Get a SearchIndexer’s status
result = indexers_client.get_indexer_status("sample-indexer")
print("Retrived Indexer status for 'sample-indexer'")
return result
get_indexers(*, select: List[str] | None = None, **kwargs: Any) → Sequence[SearchIndexer][source]

Lists all indexers available for a search service.

Keyword Arguments:

select (list[str]) – Selects which top-level properties of the skillsets to retrieve. Specified as a list of JSON property names, or ‘*’ for all properties. The default is all properties.

Returns:

List of all the SearchIndexers.

Return type:

list[SearchIndexer]

Example:

List all the SearchIndexers
result = indexers_client.get_indexers()
names = [x.name for x in result]
print("Found {} Indexers in the service: {}".format(len(result), ", ".join(names)))
get_skillset(name: str, **kwargs: Any) → SearchIndexerSkillset[source]

Retrieve a named SearchIndexerSkillset in an Azure Search service

Parameters:

name (str) – The name of the SearchIndexerSkillset to get

Returns:

The retrieved SearchIndexerSkillset

Return type:

SearchIndexerSkillset

Raises:

ResourceNotFoundError – If the skillset cannot be found.

get_skillset_names(**kwargs: Any) → List[str][source]

List the SearchIndexerSkillset names in an Azure Search service.

Returns:

List of SearchIndexerSkillset names

Return type:

list[str]

Raises:

HttpResponseError – If there is an error in the REST request.

get_skillsets(*, select: List[str] | None = None, **kwargs: Any) → List[SearchIndexerSkillset][source]

List the SearchIndexerSkillsets in an Azure Search service.

Keyword Arguments:

select (list[str]) – Selects which top-level properties of the skillsets to retrieve. Specified as a list of JSON property names, or ‘*’ for all properties. The default is all properties.

Returns:

List of SearchIndexerSkillsets

Return type:

list[SearchIndexerSkillset]

Raises:

HttpResponseError – If there is an error in the REST request.

reset_documents(indexer: str | SearchIndexer, keys_or_ids: DocumentKeysOrIds, *, overwrite: bool = False, **kwargs: Any) → None[source]

Resets specific documents in the datasource to be selectively re-ingested by the indexer.

Parameters:
Returns:

None, or the result of cls(response)

Keyword Arguments:

overwrite (bool) – If false, keys or ids will be appended to existing ones. If true, only the keys or ids in this payload will be queued to be re-ingested. The default is false.

Return type:

None

Raises:

HttpResponseError – If there is an error in the REST request.

reset_indexer(name: str, **kwargs: Any) → None[source]

Resets the change tracking state associated with an indexer.

Parameters:

name (str) – The name of the indexer to reset.

Example:

Reset a SearchIndexer’s change tracking state
result = indexers_client.reset_indexer("sample-indexer")
print("Reset the Indexer 'sample-indexer'")
return result
reset_skills(skillset: str | SearchIndexerSkillset, skill_names: List[str], **kwargs: Any) → None[source]

Reset an existing skillset in a search service.

Parameters:

  • skillset (str or SearchIndexerSkillset) – The SearchIndexerSkillset to reset

  • skill_names (List[str]) – the names of skills to be reset.

Returns:

None, or the result of cls(response)

Return type:

None

Raises:

HttpResponseError – If there is an error in the REST request.

run_indexer(name: str, **kwargs: Any) → None[source]

Run an indexer.

Parameters:

name (str) – The name of the indexer to run.

Example:

Run a SearchIndexer
result = indexers_client.run_indexer("sample-indexer")
print("Ran the Indexer 'sample-indexer'")
return result

Subpackages