Indexers - Get Status

リファレンス

サービス:: Search Service

API バージョン:: 2024-07-01

インデクサーの現在の状態と実行履歴を返します。

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

URI パラメーター

名前	/	必須	型	説明
endpoint	path	True	string	検索サービスのエンドポイント URL。
indexerName	path	True	string	状態を取得するインデクサーの名前。
api-version	query	True	string	クライアント API のバージョン。

要求ヘッダー

名前	必須	型	説明
x-ms-client-request-id		string uuid	デバッグに役立つ要求と共に送信される追跡 ID。

応答

名前	型	説明
200 OK	SearchIndexerStatus
Other Status Codes	ErrorResponse	エラー応答。

例

SearchServiceGetIndexerStatus

要求のサンプル

HTTP

GET https://myservice.search.windows.net/indexers('myindexer')/search.status?api-version=2024-07-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
  }
}

定義

名前	説明
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
IndexerExecutionResult	個々のインデクサー実行の結果を表します。
IndexerExecutionStatus	個々のインデクサー実行の状態を表します。
IndexerStatus	インデクサーの全体的な状態を表します。
SearchIndexerError	アイテムレベルまたはドキュメントレベルのインデックス作成エラーを表します。
SearchIndexerLimits
SearchIndexerStatus	インデクサーの現在の状態と実行履歴を表します。
SearchIndexerWarning	項目レベルの警告を表します。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	ErrorDetail[]	エラーの詳細。
message	string	エラーメッセージ。
target	string	エラーターゲット。

ErrorResponse

エラー応答

名前	型	説明
error	ErrorDetail	エラーオブジェクト。

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	インデクサーが不明な状態であることを示します。

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	インデクサーが 1 回の実行に対して実行できる最大期間。

SearchIndexerStatus

インデクサーの現在の状態と実行履歴を表します。

名前	型	説明
executionHistory	IndexerExecutionResult[]	最近のインデクサー実行の履歴。時系列の逆順に並べ替えられます。
lastResult	IndexerExecutionResult	最新または進行中のインデクサー実行の結果。
limits	SearchIndexerLimits	インデクサーの実行制限。
status	IndexerStatus	インデクサーの全体的な状態。

SearchIndexerWarning

項目レベルの警告を表します。

名前	型	説明
details	string	インデクサーのデバッグに役立つ警告に関する詳細な詳細情報。これは常に使用できるわけではありません。
documentationLink	string	これらの警告クラスのトラブルシューティングガイドへのリンク。これは常に使用できるわけではありません。
key	string	警告を生成した項目のキー。
message	string	アイテムの処理中に発生した警告を説明するメッセージ。
name	string	警告が発生したソースの名前。たとえば、アタッチされたスキルセット内の特定のスキルを参照できます。これは常に使用できるわけではありません。

次の方法で共有

Indexers - Get Status

URI パラメーター

要求ヘッダー

応答

例

SearchServiceGetIndexerStatus

要求のサンプル

応答のサンプル

定義

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IndexerExecutionResult

IndexerExecutionStatus

IndexerStatus

SearchIndexerError

SearchIndexerLimits

SearchIndexerStatus

SearchIndexerWarning

その他のリソース