Partilhar via


SearchIndexClient.CreateOrUpdateIndexAsync Método

Definição

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

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

Lançado quando index é nulo.

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

Aplica-se a