Indexers - Reset Docs

Layanan:
Search Service
Versi API:
2025-11-01-preview

Mengatur ulang dokumen tertentu dalam sumber data untuk diserap kembali secara selektif oleh pengindeks.

POST {endpoint}/indexers('{indexerName}')/search.resetdocs?api-version=2025-11-01-preview
Dengan parameter opsional: 
POST {endpoint}/indexers('{indexerName}')/search.resetdocs?api-version=2025-11-01-preview&overwrite={overwrite}

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 digunakan untuk operasi ini.
overwrite
 query

boolean

Jika salah, kunci atau id akan ditambahkan ke yang sudah ada. Jika true, hanya kunci atau id dalam payload ini yang akan diantrek untuk diserap kembali.

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.

Isi Permintaan

Nama Jenis Deskripsi
datasourceDocumentIds

string[]

Pengidentifikasi dokumen sumber data yang akan diatur ulang
documentKeys

string[]

Kunci dokumen yang akan diatur ulang

Respons

Nama Jenis Deskripsi
204 No Content

Tidak ada konten untuk dikirim untuk permintaan ini, tetapi header mungkin berguna.
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

SearchServiceResetDocs

Permintaan sampel

POST https://previewexampleservice.search.windows.net/indexers('myindexer')/search.resetdocs?api-version=2025-11-01-preview&overwrite=True


{
  "documentKeys": [
    "1",
    "2",
    "3"
  ]
}

Respon sampel

Kode status:
204

Definisi

Nama Deskripsi
Accept

Header Terima.
DocumentKeysOrIds

Jenis kunciOrIds.
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.).

Accept

Enumerasi

Header Terima.

Nilai Deskripsi
application/json;odata.metadata=minimal

DocumentKeysOrIds

Objek

Jenis kunciOrIds.

Nama Jenis Deskripsi
datasourceDocumentIds

string[]

Pengidentifikasi dokumen sumber data yang akan diatur ulang
documentKeys

string[]

Kunci dokumen yang akan diatur ulang

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[]

Detail kesalahan.
message

string

Pesan kesalahan.
target

string

Target 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.