Операции псевдонима (предварительная версия REST API)

  • Статья
  • Чтение занимает 2 мин

Версия API: 2021-04-30-Preview

Важно!

Весь API — это предварительная версия функции.

В Когнитивный поиск Azure псевдоним индекса — это дополнительное имя, которое можно использовать для ссылки на индекс для запросов, индексирования и других операций. Можно создать псевдоним, сопоставляющийся с индексом поиска, и заменить его именем в местах, где в противном случае вы будете ссылаться на имя индекса. Это обеспечивает дополнительную гибкость, если вам когда-либо нужно изменить индекс, на который указывает приложение. Вместо обновления ссылок на имя индекса в приложении можно просто обновить сопоставление псевдонима.

Псевдонимы можно создавать в службе Когнитивный поиск Azure и управлять ими с помощью простых HTTP-запросов (POST, GET, PUT, DELETE) для заданного ресурса псевдонима. Псевдонимы — это ресурсы уровня обслуживания и поддерживаются независимо от индексов поиска. После создания индекса поиска можно создать псевдоним, который сопоставляется с этим индексом поиска.

Примечание

Псевдоним можно использовать только с операциями с документами. Псевдонимы не могут использоваться для получения или обновления определения индекса, не могут использоваться с API анализа текста и не могут использоваться в качестве targetIndexName индексатора.

Пример

В следующем примере показано, как создать псевдоним, который сопоставляется с существующим индексом поиска.

POST /aliases?api-version=2021-04-30-preview
{   
  "name" : "my-alias",  
  "indexes" : ["my-index"]
}

Операции с псевдонимами

Ключ API администратора необходим для всех операций псевдонима.

См. также: