Dizin İstatistiklerini Alma (Önizleme REST API'si)

Şunlar için geçerlidir: 2023-07-01-Preview

Önemli

2023-07-01-Preview, bir dizin kapsamına sahip vectorIndexSize ekler.

Dizin İstatistiklerini Al işlemi geçerli dizin için belge sayısını, ayrıca dizin toplamı tarafından kullanılan toplam depolama miktarını ve yalnızca vektör verileri tarafından kullanılan depolama miktarını döndürür. Arama hizmeti, Get Service Statistics tarafından bildirilen vektör depolama miktarı üzerinde genel bir sınıra sahiptir. "vectorIndexSize" ölçümü, geçerli arama dizinindeki vektör alanları için ne kadar vektör depolama alanı kullanıldığını bildirir.

Not

Belge sayısı ve depolama boyutuyla ilgili istatistikler gerçek zamanlı olarak değil, birkaç dakikada bir toplanır. Bu nedenle, bu API tarafından döndürülen istatistikler son dizin oluşturma işlemlerinin neden olduğu değişiklikleri yansıtmayabilir.

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

URI Parametreleri

Parametre Açıklama
hizmet adı Gereklidir. Bu değeri arama hizmetinizin benzersiz, kullanıcı tanımlı adına ayarlayın.
dizin adı Gereklidir. İstek URI'si, istatistiklerin döndürülmesi gereken dizinin adını belirtir.
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. Bu değeri 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

Durum Kodu: Başarılı bir yanıt için "200 Tamam" döndürülür. Yanıt gövdesi aşağıdaki biçimdedir:

{  
  "documentCount": number,  
  "storageSize": number (size of the index in bytes), 
  "vectorIndexSize": number (size of the index in bytes) 
}

Dizinde vektör alanı yoksa, "vectorIndexSize" sıfırdır.

Ayrıca bkz.