Indexers - Get Status

Layanan:: Search Service

Versi API:: 2026-04-01

Mengembalikan status saat ini dan riwayat eksekusi pengindeks.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
endpoint	path	True	string (uri)	URL titik akhir layanan pencarian.
indexerName	path	True	string	Nama pengindeks.
api-version	query	True	string minLength: 1	Versi API yang akan digunakan untuk operasi ini.

Header Permintaan

Nama	Diperlukan	Jenis	Deskripsi
Accept		Accept	Header Terima.
x-ms-client-request-id		string (uuid)	Pengidentifikasi string yang buram dan unik secara global yang dihasilkan klien untuk permintaan tersebut.

Respons

Nama	Jenis	Deskripsi
200 OK	SearchIndexerStatus	Permintaan telah berhasil.
Other Status Codes	ErrorResponse	Respons kesalahan tak terduga.

Keamanan

api-key

Jenis: apiKey
Dalam: header

OAuth2Auth

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Cakupan

Nama	Deskripsi
https://search.azure.com/.default

Contoh

SearchServiceGetIndexerStatus

SearchServiceGetS3HDUnlimitedIndexerStatus

SearchServiceGetIndexerStatus

Permintaan sampel

HTTP

GET https://exampleservice.search.windows.net/indexers('myindexer')/search.status?api-version=2026-04-01

Respon sampel

Kode status:: 200

{
  "name": "myindexer",
  "status": "running",
  "lastResult": {
    "status": "success",
    "startTime": "2014-11-26T03:37:18.853Z",
    "endTime": "2014-11-26T03:37:19.012Z",
    "itemsProcessed": 11,
    "itemsFailed": 0,
    "errors": [],
    "warnings": []
  },
  "executionHistory": [
    {
      "status": "success",
      "startTime": "2014-11-26T03:37:18.853Z",
      "endTime": "2014-11-26T03:37:19.012Z",
      "itemsProcessed": 11,
      "itemsFailed": 0,
      "errors": [],
      "warnings": []
    },
    {
      "status": "transientFailure",
      "startTime": "2014-11-26T03:28:10.125Z",
      "endTime": "2014-11-26T03:28:12.007Z",
      "itemsProcessed": 1,
      "itemsFailed": 2,
      "errors": [
        {
          "key": "",
          "statusCode": 400,
          "errorMessage": "Document key cannot be missing or empty."
        },
        {
          "key": "document id 1",
          "statusCode": 400,
          "name": "DocumentExtraction.AzureBlob.MyDataSource",
          "errorMessage": "Could not read the value of column 'foo' at index '0'.",
          "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."
        },
        {
          "key": "document id 2",
          "name": "Enrichment.LanguageDetectionSkill.#4",
          "message": "Document was truncated to 50000 characters.",
          "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"
        }
      ]
    }
  ],
  "limits": {
    "maxRunTime": "PT22H",
    "maxDocumentExtractionSize": 256000000,
    "maxDocumentContentCharactersToExtract": 4000000
  }
}

SearchServiceGetS3HDUnlimitedIndexerStatus

Permintaan sampel

HTTP

GET https://exampleservice.search.windows.net/indexers('myindexer')/search.status?api-version=2026-04-01

Respon sampel

Kode status:: 200

{
  "name": "myindexer",
  "status": "running",
  "lastResult": {
    "status": "success",
    "startTime": "2014-11-26T03:37:18.853Z",
    "endTime": "2014-11-26T03:37:19.012Z",
    "itemsProcessed": 11,
    "itemsFailed": 0,
    "errors": [],
    "warnings": []
  },
  "executionHistory": [
    {
      "status": "success",
      "startTime": "2014-11-26T03:37:18.853Z",
      "endTime": "2014-11-26T03:37:19.012Z",
      "itemsProcessed": 11,
      "itemsFailed": 0,
      "errors": [],
      "warnings": []
    },
    {
      "status": "transientFailure",
      "startTime": "2014-11-26T03:28:10.125Z",
      "endTime": "2014-11-26T03:28:12.007Z",
      "itemsProcessed": 1,
      "itemsFailed": 2,
      "errors": [
        {
          "key": "",
          "statusCode": 400,
          "errorMessage": "Document key cannot be missing or empty."
        },
        {
          "key": "document id 1",
          "statusCode": 400,
          "name": "DocumentExtraction.AzureBlob.MyDataSource",
          "errorMessage": "Could not read the value of column 'foo' at index '0'.",
          "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."
        },
        {
          "key": "document id 2",
          "name": "Enrichment.LanguageDetectionSkill.#4",
          "message": "Document was truncated to 50000 characters.",
          "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"
        }
      ]
    }
  ],
  "limits": {
    "maxRunTime": "PT22H",
    "maxDocumentExtractionSize": 256000000,
    "maxDocumentContentCharactersToExtract": 4000000
  }
}

Definisi

Nama	Deskripsi
Accept	Header Terima.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Respons kesalahan umum untuk semua API Azure Resource Manager untuk mengembalikan detail kesalahan untuk operasi yang gagal. (Ini juga mengikuti format respons kesalahan OData.).
IndexerExecutionResult	Mewakili hasil eksekusi pengindeks individual.
IndexerExecutionStatus	Mewakili status eksekusi pengindeks individual.
IndexerStatus	Mewakili status pengindeks keseluruhan.
SearchIndexerError	Mewakili kesalahan pengindeksan tingkat item atau dokumen.
SearchIndexerLimits	Mewakili batas yang dapat diterapkan ke pengindeks.
SearchIndexerStatus	Mewakili status saat ini dan riwayat eksekusi pengindeks.
SearchIndexerWarning	Mewakili peringatan tingkat item.

Accept

Enumerasi

Header Terima.

Nilai	Deskripsi
application/json;odata.metadata=minimal

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info		Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Rincian kesalahan.
message	string	Pesan kesalahan.
target	string	Sasaran kesalahan.

ErrorResponse

Objek

Respons kesalahan umum untuk semua API Azure Resource Manager untuk mengembalikan detail kesalahan untuk operasi yang gagal. (Ini juga mengikuti format respons kesalahan OData.).

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

IndexerExecutionResult

Objek

Mewakili hasil eksekusi pengindeks individual.

Nama	Jenis	Deskripsi
endTime	string (date-time)	Waktu akhir eksekusi pengindeks ini, jika eksekusi telah selesai.
errorMessage	string	Pesan kesalahan yang menunjukkan kesalahan tingkat atas, jika ada.
errors	SearchIndexerError[]	Kesalahan pengindeksan tingkat item.
finalTrackingState	string	Ubah status pelacakan dengan eksekusi pengindeks selesai.
initialTrackingState	string	Ubah status pelacakan dengan mana eksekusi pengindeks dimulai.
itemsFailed	integer (int32)	Jumlah item yang gagal diindeks selama eksekusi pengindeks ini.
itemsProcessed	integer (int32)	Jumlah item yang diproses selama eksekusi pengindeks ini. Ini termasuk item dan item yang berhasil diproses di mana pengindeksan dicoba tetapi gagal.
startTime	string (date-time)	Waktu mulai eksekusi pengindeks ini.
status	IndexerExecutionStatus	Hasil dari eksekusi pengindeks ini.
warnings	SearchIndexerWarning[]	Peringatan pengindeksan tingkat item.

IndexerExecutionStatus

Enumerasi

Mewakili status eksekusi pengindeks individual.

Nilai	Deskripsi
transientFailure	Pemanggilan pengindeks telah gagal, tetapi kegagalannya mungkin bersifat sementara. Pemanggilan pengindeks akan berlanjut sesuai jadwal.
success	Eksekusi pengindeks berhasil diselesaikan.
inProgress	Eksekusi pengindeks sedang berlangsung.
reset	Pengindeks telah diatur ulang.

IndexerStatus

Enumerasi

Mewakili status pengindeks keseluruhan.

Nilai	Deskripsi
unknown	Menunjukkan bahwa pengindeks berada dalam keadaan tidak diketahui.
error	Menunjukkan bahwa pengindeks mengalami kesalahan yang tidak dapat diperbaiki tanpa campur tangan manusia.
running	Menunjukkan bahwa pengindeks berjalan normal.

SearchIndexerError

Objek

Mewakili kesalahan pengindeksan tingkat item atau dokumen.

Nama	Jenis	Deskripsi
details	string	Tambahan, detail verbose tentang kesalahan untuk membantu penelusuran kesalahan pengindeks. Ini mungkin tidak selalu tersedia.
documentationLink	string	Tautan ke panduan pemecahan masalah untuk kelas kesalahan ini. Ini mungkin tidak selalu tersedia.
errorMessage	string	Pesan yang menjelaskan kesalahan yang terjadi saat memproses item.
key	string	Kunci item yang pengindeksannya gagal.
name	string	Nama sumber tempat kesalahan berasal. Misalnya, ini dapat merujuk pada keterampilan tertentu dalam skillset yang terlampir. Ini mungkin tidak selalu tersedia.
statusCode	integer (int32)	Kode status yang menunjukkan mengapa operasi pengindeksan gagal. Nilai yang mungkin termasuk: 400 untuk dokumen input cacat, 404 untuk dokumen tidak ditemukan, 409 untuk konflik versi, 422 ketika indeks sementara tidak tersedia, atau 503 saat layanan terlalu sibuk.

SearchIndexerLimits

Objek

Mewakili batas yang dapat diterapkan ke pengindeks.

Nama	Jenis	Deskripsi
maxDocumentContentCharactersToExtract	integer (int64)	Jumlah maksimum karakter yang akan diekstrak dari dokumen yang diambil untuk pengindeksan.
maxDocumentExtractionSize	integer (int64)	Ukuran maksimum dokumen, dalam byte, yang akan dianggap valid untuk pengindeksan.
maxRunTime	string (duration)	Durasi maksimum pengindeks diizinkan untuk dijalankan untuk satu eksekusi.

SearchIndexerStatus

Objek

Mewakili status saat ini dan riwayat eksekusi pengindeks.

Nama	Jenis	Deskripsi
executionHistory	IndexerExecutionResult[]	Riwayat eksekusi pengindeks baru-baru ini, diurutkan dalam urutan kronologis terbalik.
lastResult	IndexerExecutionResult	Hasil dari eksekusi pengindeks terbaru atau yang sedang berlangsung.
limits	SearchIndexerLimits	Batas eksekusi untuk pengindeks.
name	string	Nama pengindeks.
status	IndexerStatus	Status pengindeks keseluruhan.

SearchIndexerWarning

Objek

Mewakili peringatan tingkat item.

Nama	Jenis	Deskripsi
details	string	Tambahan, detail verbose tentang peringatan untuk membantu men-debug pengindeks. Ini mungkin tidak selalu tersedia.
documentationLink	string	Tautan ke panduan pemecahan masalah untuk kelas peringatan ini. Ini mungkin tidak selalu tersedia.
key	string	Kunci item yang menghasilkan peringatan.
message	string	Pesan yang menjelaskan peringatan yang terjadi saat memproses item.
name	string	Nama sumber tempat peringatan berasal. Misalnya, ini dapat merujuk pada keterampilan tertentu dalam skillset yang terlampir. Ini mungkin tidak selalu tersedia.