SearchIndexClient.CreateOrUpdateIndex Método

Referência

Definição

Namespace:: Azure.Search.Documents.Indexes

Assembly:: Azure.Search.Documents.dll

Pacote:: Azure.Search.Documents v11.5.1

Pacote:: Azure.Search.Documents v11.6.0-beta.4

Origem:: SearchIndexClient.cs

Origem:: SearchIndexClient.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Cria um novo índice de pesquisa ou atualiza um índice existente.

public virtual Azure.Response<Azure.Search.Documents.Indexes.Models.SearchIndex> CreateOrUpdateIndex (Azure.Search.Documents.Indexes.Models.SearchIndex index, bool allowIndexDowntime = false, bool onlyIfUnchanged = false, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateOrUpdateIndex : Azure.Search.Documents.Indexes.Models.SearchIndex * bool * bool * System.Threading.CancellationToken -> Azure.Response<Azure.Search.Documents.Indexes.Models.SearchIndex>
override this.CreateOrUpdateIndex : Azure.Search.Documents.Indexes.Models.SearchIndex * bool * bool * System.Threading.CancellationToken -> Azure.Response<Azure.Search.Documents.Indexes.Models.SearchIndex>

Public Overridable Function CreateOrUpdateIndex (index As SearchIndex, Optional allowIndexDowntime As Boolean = false, Optional onlyIfUnchanged As Boolean = false, Optional cancellationToken As CancellationToken = Nothing) As Response(Of SearchIndex)

Parâmetros

index: SearchIndex

Obrigatórios. O SearchIndex a ser criado ou atualizado.

allowIndexDowntime: Boolean

Valor opcional que indica se os analisadores, os tokenizers, os filtros de token ou os filtros de caracteres devem ser adicionados ao índice, tornando o índice temporariamente offline por alguns segundos. O padrão é falso. Isso faz com que a indexação e as consultas falhem temporariamente. O desempenho e a disponibilidade de gravação do índice podem ser prejudicados por vários minutos após o índice ser atualizado, ou por mais tempo em caso de índices muito grandes.

onlyIfUnchanged: Boolean

True para gerar um RequestFailedException se o ETag não corresponder à versão de serviço atual; caso contrário, a versão do serviço atual será substituída.

cancellationToken: CancellationToken

Opcional CancellationToken para propagar notificações de que a operação deve ser cancelada.

Retornos

Response<SearchIndex>

O Response<T> do servidor que contém o SearchIndex que foi criado ou atualizado. Isso pode diferir ligeiramente do que foi passado, pois o serviço pode retornar campos definidos para seus valores padrão, dependendo do tipo de campo e de outras propriedades.

Exceções

ArgumentNullException

Lançado quando index é nulo.

RequestFailedException

Gerada quando uma falha é retornada pelo serviço Pesquisa.

Aplica-se a