Aracılığıyla paylaş


Dizin Oluşturucuları Listeleme (Azure AI Arama REST API'si)

Dizin Oluşturucuları Listele işlemi, Azure AI Arama hizmeti dizin oluşturucuların listesini döndürür.

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

URI Parametreleri

Parametre Açıklama
hizmet adı Gereklidir. Bunu arama hizmetinizin benzersiz, kullanıcı tanımlı adı olarak ayarlayın.
api-sürümü Gereklidir. Geçerli kararlı sürüm: api-version=2020-06-30. Daha fazla sürüm için bkz. API sürümleri.

İstek Üst Bilgileri

Aşağıdaki tabloda gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadır.

Alanlar Description
İçerik Türü Gereklidir. Bunu olarak ayarlayın application/json
api-key İsteğe bağlı olarak Azure rollerini kullanıyorsanız ve istekte taşıyıcı belirteci sağlanıyorsa bir anahtar gereklidir. Api anahtarı, arama hizmetinizde isteğin kimliğini doğrulayan benzersiz, sistem tarafından oluşturulan bir dizedir. Nesne tanımına yönelik alma istekleri, yönetici anahtarınıza ayarlanmış bir api-key alanı içermelidir (sorgu anahtarı yerine). Ayrıntılar için bkz. Anahtar kimlik doğrulamasını kullanarak Azure AI Search'e bağlanma .

İstek Gövdesi

Yok.

Yanıt

Başarılı bir istek için: 200 Tamam. Örnek yanıt gövdesi aşağıda verilmiştir:

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

Yanıtı yalnızca ilgilendiğiniz özelliklere göre filtreleyebilirsiniz. Örneğin, yalnızca dizin oluşturucu adlarının listesini istiyorsanız OData $select sorgu seçeneğini kullanın:

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

Bu durumda, yukarıdaki örnekten gelen yanıt aşağıdaki gibi görünür:

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

bu, Arama hizmeti çok fazla dizin oluşturucunuz varsa bant genişliğinden tasarruf etmek için kullanışlı bir tekniktir.

Not

Bir dizin oluşturucunun şifreleme anahtarı varsa, arama hizmetinin bu dizin oluşturucunun tanımındaki şifrelenmiş özellikleri almak için şifreleme anahtarına erişimi olmalıdır. Şifreleme anahtarına erişim olmadan, şifrelenmiş özellikler yerine bir "<encrypted>" yer tutucu döndürülür. Anahtara erişimi geri yüklemek, arama hizmetinin tam dizin oluşturucu tanımını yeniden almasını sağlar.

Ayrıca bkz.