Megosztás a következőn keresztül:


Indexelők listázása (Azure AI Search REST API)

Az Indexelők listázása művelet az Indexelők listáját adja vissza az Azure AI-Search szolgáltatás.

GET https://[service name].search.windows.net/indexers?api-version=[api-version]  
  Content-Type: application/json  
  api-key: [admin key]  

URI-paraméterek

Paraméter Leírás
szolgáltatásnév Kötelező. Állítsa be ezt a keresési szolgáltatás egyedi, felhasználó által definiált nevére.
api-verzió Kötelező. A jelenlegi stabil verzió a következő api-version=2020-06-30: . További verziókért lásd: API-verziók .

Kérelemfejlécek

Az alábbi táblázat a szükséges és nem kötelező kérésfejléceket ismerteti.

Mezők Description
Content-Type Kötelező. Állítsa a következőre: application/json
api-key Nem kötelező , ha Azure-szerepköröket használ, és egy tulajdonosi jogkivonatot ad meg a kéréshez, ellenkező esetben kulcsra van szükség. Az API-kulcs egy egyedi, rendszer által generált sztring, amely hitelesíti a kérést a keresési szolgáltatásnak. Az objektumdefiníciók kéréseinek tartalmazniuk kell egy api-key mezőt, amely a rendszergazdai kulcsra van állítva (a lekérdezési kulcs helyett). A részletekért lásd: Csatlakozás az Azure AI Search szolgáltatáshoz kulcshitelesítés használatával .

Kérelem törzse

Nincsenek.

Reagálás

Sikeres kérés esetén: 200 OK. Íme egy példa a válasz törzsére:

{  
      "value" : [  
      {  
        "name" : "myindexer",  
        "description" : "a cool indexer",  
        "dataSourceName" : "ordersds",  
        "targetIndexName" : "orders",  
        ... other indexer properties  
      }]  
    }  

A választ a kívánt tulajdonságokra szűrheti le. Ha például csak az indexelők nevét szeretné listázni, használja az OData $select lekérdezési lehetőséget:

GET /indexers?api-version=2020-06-30&$select=name  

Ebben az esetben a fenti példa válasza a következőképpen jelenik meg:

{  
      "value" : [ { "name": "myindexer" } ]  
    }  

Ez hasznos módszer a sávszélesség megtakarítására, ha sok indexelő van a Search szolgáltatás.

Megjegyzés

Ha egy indexelő rendelkezik titkosítási kulccsal, a keresési szolgáltatásnak hozzáféréssel kell rendelkeznie a titkosítási kulcshoz az indexelő definíciójában található titkosított tulajdonságok lekéréséhez. A titkosítási kulcshoz való hozzáférés nélkül a rendszer egy helyőrzőt "<encrypted>" ad vissza a titkosított tulajdonságok helyett. A kulcshoz való hozzáférés visszaállítása lehetővé teszi, hogy a keresési szolgáltatás ismét lekérje a teljes indexelődefiníciót.

Lásd még