Aliases - Create Or Update

Referência

Serviço:: Search Service

Versão da API:: 2024-05-01-preview

Cria um novo alias de pesquisa ou atualiza um alias se ele já existir.

PUT {endpoint}/aliases('{aliasName}')?api-version=2024-05-01-preview

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
aliasName	path	True	string	A definição do alias a ser criado ou atualizado.
endpoint	path	True	string	A URL do ponto de extremidade do serviço de pesquisa.
api-version	query	True	string	Versão da API do cliente.

Cabeçalho da solicitação

Nome	Obrigatório	Tipo	Description
x-ms-client-request-id		string uuid	A ID de rastreamento enviada com a solicitação para ajudar na depuração.
If-Match		string	Define a condição de If-Match. A operação será executada somente se a ETag no servidor corresponder a esse valor.
If-None-Match		string	Define a condição If-None-Match. A operação será executada somente se a ETag no servidor não corresponder a esse valor.
Prefer	True	string	Para solicitações HTTP PUT, instrui o serviço a retornar o recurso criado/atualizado com êxito.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
indexes	True	string[]	O nome do índice para o qual esse alias é mapeado. Somente um nome de índice pode ser especificado.
name	True	string	O nome do alias.
@odata.etag		string	A ETag do alias.

Respostas

Nome	Tipo	Description
200 OK	SearchAlias
201 Created	SearchAlias
Other Status Codes	ErrorResponse	Resposta de erro.

Exemplos

SearchServiceCreateOrUpdateAlias

Solicitação de exemplo

HTTP

PUT https://myservice.search.windows.net/aliases('production')?api-version=2024-05-01-preview


{
  "name": "production",
  "indexes": [
    "hotels"
  ]
}

Resposta de exemplo

Código de status:: 200

{
  "name": "production",
  "indexes": [
    "hotels"
  ]
}

Código de status:: 201

{
  "name": "production",
  "indexes": [
    "hotels"
  ]
}

Definições

Nome	Description
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
SearchAlias	Representa um alias de índice, que descreve um mapeamento do nome do alias para um índice. O nome do alias pode ser usado no lugar do nome do índice para operações com suporte.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

SearchAlias

Representa um alias de índice, que descreve um mapeamento do nome do alias para um índice. O nome do alias pode ser usado no lugar do nome do índice para operações com suporte.

Nome	Tipo	Description
@odata.etag	string	A ETag do alias.
indexes	string[]	O nome do índice para o qual esse alias é mapeado. Somente um nome de índice pode ser especificado.
name	string	O nome do alias.

Compartilhar via