Indexers - Get Status

Ссылка

Служба:: Search Service

Версия API:: 2023-11-01

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

GET {endpoint}/indexers('{indexerName}')/search.status?api-version=2023-11-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
endpoint	path	True	string	URL-адрес конечной точки службы поиска.
indexerName	path	True	string	Имя индексатора, для которого необходимо вернуть состояние.
api-version	query	True	string	Версия API клиента.

Заголовок запроса

Имя	Обязательно	Тип	Описание
x-ms-client-request-id		string uuid	Идентификатор отслеживания, отправленный с запросом на помощь в отладке.

Ответы

Имя	Тип	Описание
200 OK	SearchIndexerStatus
Other Status Codes	SearchError	Ответ об ошибке.

Примеры

SearchServiceGetIndexerStatus

Образец запроса

HTTP

GET https://myservice.search.windows.net/indexers('myindexer')/search.status?api-version=2023-11-01

Пример ответа

Код состояния:: 200

{
  "status": "running",
  "lastResult": {
    "status": "success",
    "errorMessage": null,
    "startTime": "2014-11-26T03:37:18.853Z",
    "endTime": "2014-11-26T03:37:19.012Z",
    "errors": [],
    "warnings": [],
    "itemsProcessed": 11,
    "itemsFailed": 0,
    "initialTrackingState": null,
    "finalTrackingState": null
  },
  "executionHistory": [
    {
      "status": "success",
      "errorMessage": null,
      "startTime": "2014-11-26T03:37:18.853Z",
      "endTime": "2014-11-26T03:37:19.012Z",
      "errors": [],
      "warnings": [],
      "itemsProcessed": 11,
      "itemsFailed": 0,
      "initialTrackingState": null,
      "finalTrackingState": null
    },
    {
      "status": "transientFailure",
      "errorMessage": null,
      "startTime": "2014-11-26T03:28:10.125Z",
      "endTime": "2014-11-26T03:28:12.007Z",
      "errors": [
        {
          "key": "",
          "errorMessage": "Document key cannot be missing or empty.",
          "statusCode": 400,
          "name": null,
          "details": null,
          "documentationLink": null
        },
        {
          "key": "document id 1",
          "errorMessage": "Could not read the value of column 'foo' at index '0'.",
          "statusCode": 400,
          "name": "DocumentExtraction.AzureBlob.MyDataSource",
          "details": "The file could not be parsed.",
          "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2049388"
        }
      ],
      "warnings": [
        {
          "key": "document id",
          "message": "A warning doesn't stop indexing, and is intended to inform you of certain interesting situations, like when a blob indexer truncates the amount of text extracted from a blob.",
          "name": null,
          "details": null,
          "documentationLink": null
        },
        {
          "key": "document id 2",
          "message": "Document was truncated to 50000 characters.",
          "name": "Enrichment.LanguageDetectionSkill.#4",
          "details": "The skill did something that didn't break anything, nonetheless something we didn't expect happened, so it might be worth double checking.",
          "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2099692"
        }
      ],
      "itemsProcessed": 1,
      "itemsFailed": 2,
      "initialTrackingState": null,
      "finalTrackingState": null
    }
  ],
  "limits": {
    "maxRunTime": "PT22H",
    "maxDocumentExtractionSize": 256000000,
    "maxDocumentContentCharactersToExtract": 4000000
  }
}

Определения

Имя	Описание
IndexerExecutionResult	Представляет результат выполнения отдельного индексатора.
IndexerExecutionStatus	Представляет состояние выполнения отдельного индексатора.
IndexerStatus	Представляет общее состояние индексатора.
SearchError	Описывает условие ошибки для API.
SearchIndexerError	Представляет ошибку индексации уровня элемента или документа.
SearchIndexerLimits
SearchIndexerStatus	Представляет текущее состояние и журнал выполнений индексатора.
SearchIndexerWarning	Представляет предупреждение на уровне элемента.

IndexerExecutionResult

Представляет результат выполнения отдельного индексатора.

Имя	Тип	Описание
endTime	string	Время окончания выполнения индексатора, если выполнение уже завершено.
errorMessage	string	Сообщение об ошибке, указывающее на ошибку верхнего уровня, если она есть.
errors	SearchIndexerError[]	Ошибки индексирования на уровне элементов.
finalTrackingState	string	Состояние отслеживания изменений, с которым завершено выполнение индексатора.
initialTrackingState	string	Состояние отслеживания изменений, с которым началось выполнение индексатора.
itemsFailed	integer	Количество элементов, которые не удалось проиндексировать во время выполнения этого индексатора.
itemsProcessed	integer	Количество элементов, которые были обработаны во время выполнения этого индексатора. Сюда входят как успешно обработанные элементы, так и элементы, в которых попытка индексирования была выполнена, но не удалось.
startTime	string	Время начала выполнения этого индексатора.
status	IndexerExecutionStatus	Результат выполнения этого индексатора.
warnings	SearchIndexerWarning[]	Предупреждения об индексировании на уровне элемента.

IndexerExecutionStatus

Представляет состояние выполнения отдельного индексатора.

Имя	Тип	Описание
inProgress	string	Идет выполнение индексатора.
reset	string	Индексатор был сброшен.
success	string	Выполнение индексатора успешно завершено.
transientFailure	string	Сбой вызова индексатора, но ошибка может быть временной. Вызовы индексатора продолжатся по расписанию.

IndexerStatus

Представляет общее состояние индексатора.

Имя	Тип	Описание
error	string	Указывает, что индексатор столкнулся с ошибкой, которую невозможно исправить без вмешательства человека.
running	string	Указывает, что индексатор работает нормально.
unknown	string	Указывает, что индексатор находится в неизвестном состоянии.

SearchError

Описывает условие ошибки для API.

Имя	Тип	Описание
code	string	Один из определяемого сервером набора кодов ошибок.
details	SearchError[]	Массив сведений о конкретных ошибках, которые привели к этой сообщаемой ошибке.
message	string	Удобочитаемое представление ошибки.

SearchIndexerError

Представляет ошибку индексации уровня элемента или документа.

Имя	Тип	Описание
details	string	Дополнительные подробные сведения об ошибке для отладки индексатора. Это может быть недоступно не всегда.
documentationLink	string	Ссылка на руководство по устранению неполадок для этих классов ошибок. Это может быть недоступно не всегда.
errorMessage	string	Сообщение, описывающее ошибку, которая произошла при обработке элемента.
key	string	Ключ элемента, для которого произошел сбой индексирования.
name	string	Имя источника, в котором возникла ошибка. Например, это может относиться к определенному навыку в присоединенном наборе навыков. Это может быть недоступно не всегда.
statusCode	integer	Код состояния, указывающий, почему произошел сбой операции индексирования. Возможные значения: 400 для неправильно сформированного входного документа, 404 для документа не найден, 409 для конфликта версий, 422, когда индекс временно недоступен, или 503 для слишком загруженной службы.

SearchIndexerLimits

Имя	Тип	Описание
maxDocumentContentCharactersToExtract	number	Максимальное количество символов, которые будут извлечены из документа, выбранного для индексирования.
maxDocumentExtractionSize	number	Максимальный размер документа в байтах, который будет считаться допустимым для индексирования.
maxRunTime	string	Максимальная продолжительность выполнения индексатора в течение одного выполнения.

SearchIndexerStatus

Представляет текущее состояние и журнал выполнений индексатора.

Имя	Тип	Описание
executionHistory	IndexerExecutionResult[]	Журнал последних выполнений индексатора, отсортированный в обратном хронологическом порядке.
lastResult	IndexerExecutionResult	Результат последнего или выполнения индексатора.
limits	SearchIndexerLimits	Ограничения выполнения для индексатора.
status	IndexerStatus	Общее состояние индексатора.

SearchIndexerWarning

Представляет предупреждение на уровне элемента.

Имя	Тип	Описание
details	string	Дополнительные подробные сведения о предупреждении для помощи в отладке индексатора. Это может быть недоступно не всегда.
documentationLink	string	Ссылка на руководство по устранению неполадок для этих классов предупреждений. Это может быть недоступно не всегда.
key	string	Ключ элемента, создавший предупреждение.
message	string	Сообщение, описывающее предупреждение, которое произошло во время обработки элемента.
name	string	Имя источника, от которого возникло предупреждение. Например, это может относиться к определенному навыку в присоединенном наборе навыков. Это может быть недоступно не всегда.

Поделиться через