SearchIndexClient.CreateOrUpdateIndexAsync 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.Aliases.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 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))

Parâmetros

index: SearchIndex

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

allowIndexDowntime: Boolean

Valor opcional que indica se os analisadores, tokenizadores, filtros de token ou filtros de caracteres devem ser adicionados ao índice temporariamente, tornando o índice 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

Task<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 como seus valores padrão, dependendo do tipo de campo e de outras propriedades.

Exceções

ArgumentNullException

Lançado quando index é nulo.

RequestFailedException

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

Aplica-se a