Freigeben über


SearchIndexClient.CreateOrUpdateIndexAsync Methode

Definition

Erstellt einen neuen Suchindex oder aktualisiert einen vorhandenen Index.

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Search.Documents.Indexes.Models.SearchIndex>> CreateOrUpdateIndexAsync (Azure.Search.Documents.Indexes.Models.SearchIndex index, bool allowIndexDowntime = false, bool onlyIfUnchanged = false, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateOrUpdateIndexAsync : Azure.Search.Documents.Indexes.Models.SearchIndex * bool * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Search.Documents.Indexes.Models.SearchIndex>>
override this.CreateOrUpdateIndexAsync : Azure.Search.Documents.Indexes.Models.SearchIndex * bool * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Search.Documents.Indexes.Models.SearchIndex>>
Public Overridable Function CreateOrUpdateIndexAsync (index As SearchIndex, Optional allowIndexDowntime As Boolean = false, Optional onlyIfUnchanged As Boolean = false, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of SearchIndex))

Parameter

index
SearchIndex

Erforderlich. Der SearchIndex , der erstellt oder aktualisiert werden soll.

allowIndexDowntime
Boolean

Optionaler Wert, der angibt, ob Analysetools, Tokenisierer, Tokenfilter oder Zeichenfilter dem Index hinzugefügt werden sollen, indem der Index vorübergehend für einige Sekunden offline geschaltet wird. Die Standardeinstellung ist „false“. Dadurch treten vorübergehend Indizierungs- und Abfragenfehler auf. Leistung und Schreibverfügbarkeit des Indexes können nach der Indexaktualisierung mehrere Minuten lang eingeschränkt sein, bei sehr großen Indizes auch länger.

onlyIfUnchanged
Boolean

True, um ein RequestFailedException auszulösen, wenn die ETag nicht mit der aktuellen Dienstversion übereinstimmt. Andernfalls wird die aktuelle Dienstversion überschrieben.

cancellationToken
CancellationToken

Optional CancellationToken zur Weitergabe von Benachrichtigungen, dass der Vorgang abgebrochen werden soll.

Gibt zurück

Der Response<T> vom Server mit dem, das SearchIndex erstellt oder aktualisiert wurde. Dies kann geringfügig von dem, was übergeben wurde, abweichen, da der Dienst Felder zurückgibt, die je nach Feldtyp und anderen Eigenschaften auf ihre Standardwerte festgelegt sind.

Ausnahmen

Wird ausgelöst, wenn index NULL ist.

Wird ausgelöst, wenn ein Fehler vom Suchdienst zurückgegeben wird.

Gilt für: