Ilkeyi kullanarak çoğaltma durumunu alma

Service Fabric durum bilgisi olan bir hizmet çoğaltmasının veya belirtilen ilkeyi kullanarak durum bilgisi olmayan hizmet örneğinin sistem durumunu alır.

Service Fabric durum bilgisi olan bir hizmet çoğaltmasının veya durum bilgisi olmayan hizmet örneğinin sistem durumunu alır. Kümede bildirilen sistem durumu olaylarının toplanmasını sistem durumuna göre filtrelemek için EventsHealthStateFilter ' i kullanın. İsteğe bağlı olarak sistem durumunu değerlendirmek için kullanılan sistem durumu ilkelerini geçersiz kılmak için ApplicationHealthPolicy kullanın. Bu API yalnızca ApplicationHealthPolicy ' ConsiderWarningAsError ' alanını kullanır. Çoğaltmanın sistem durumu değerlendirilirken alanların geri kalanı yok sayılır.

İstek

Yöntem İstek URI'si
POST /Partitions/{partitionId}/$/GetReplicas/{replicaId}/$/GetHealth?api-version=6.0&EventsHealthStateFilter={EventsHealthStateFilter}&timeout={timeout}

Parametreler

Ad Tür Gerekli Konum
partitionId dize (UUID) Yes Yol
replicaId string Yes Yol
api-version string Yes Sorgu
EventsHealthStateFilter tamsayı Hayır Sorgu
timeout tamsayı (Int64) Hayır Sorgu
ApplicationHealthPolicy ApplicationHealthPolicy Hayır Gövde

partitionId

Tür: String (UUID)
Gerekli: Evet

Bölümün kimliği.


replicaId

Tür: dize
Gerekli: Evet

Çoğaltmanın tanımlayıcısı.


api-version

Tür: dize
Gerekli: Evet
Varsayılan: 6.0

API sürümü. Bu parametre gereklidir ve değeri ' 6,0 ' olmalıdır.

Service Fabric REST API sürümü, API 'nin tanıtılmasından veya değiştiği çalışma zamanı sürümünü temel alır. Service Fabric Runtime, API 'nin birden fazla sürümünü destekler. Bu, API 'nin desteklenen son sürümüdür. Daha düşük bir API sürümü geçirilirse, döndürülen yanıt bu belirtimde açıklandan farklı olabilir.

Ayrıca, çalışma zamanı en son desteklenen sürümden daha yüksek olan sürümleri, çalışma zamanının geçerli sürümüne kadar kabul eder. En son API sürümü 6,0 ise, ancak çalışma zamanı 6,1 ise, istemcileri yazmayı kolaylaştırmak için çalışma zamanı bu API 'nin sürüm 6,1 ' i kabul eder. Ancak API 'nin davranışı, belgelenen 6,0 sürümüne göre olacaktır.


EventsHealthStateFilter

Tür: tamsayı
Gerekli: Hayır
Varsayılan: 0

Sistem durumu temelinde döndürülen HealthEvent nesnelerinin toplanmasını filtrelemeye izin verir. Bu parametre için olası değerler aşağıdaki sistem durumlarından birine ait tamsayı değerini içerir. Yalnızca filtreyle eşleşen olaylar döndürülür. Tüm olaylar, toplanan sistem durumunu değerlendirmek için kullanılır. Belirtilmezse, tüm girişler döndürülür. Durum değerleri bayrak tabanlı numaralandırmadır, bu nedenle değer bit düzeyinde ' OR ' işleci kullanılarak elde edilen bu değerlerin bir birleşimi olabilir. Örneğin, girilen değer 6 ise, HealthState değeri (2) ve uyarı (4) olan tüm olaylar döndürülür.

  • Varsayılan değer varsayılan değer. Herhangi bir HealthState ile eşleşir. Değer sıfırdır.
  • None-hiçbir HealthState değerle eşleşmeyen filtre. Belirli bir durum koleksiyonuna sonuç döndürmek için kullanılır. Değer 1 ' dir.
  • Ok-HealthState değer ile girişle eşleşen filtre tamam. Değer 2 ' dir.
  • Uyarı-değerle HealthState değer uyarısıyla eşleşen filtre. Değer 4 ' dir.
  • Hata-değerle HealthState değer hatası ile eşleşen filtre. Değer 8 ' dir.
  • Herhangi bir HealthState değeri ile girişle eşleşen All filtresi. Değer 65535 ' dir.

timeout

Tür: tamsayı (Int64)
Gerekli: Hayır
Varsayılan: 60
Yani Ivemaksimum değer:4294967295
Yani Iveminimum:1

İşlemi saniye cinsinden gerçekleştirmek için sunucu zaman aşımı. Bu zaman aşımı, istemcinin istenen işlemin tamamlanmasını beklemek istediği süreyi belirtir. Bu parametre için varsayılan değer 60 saniyedir.


ApplicationHealthPolicy

Tür: applicationhealthpolicy
Gerekli: Hayır

Bir uygulamanın veya alt öğelerinden birinin sistem durumunu değerlendirmek için kullanılan sistem durumu ilkelerini açıklar. Mevcut değilse, sistem durumu değerlendirmesi uygulama bildirimi veya varsayılan sistem durumu ilkesi 'nden sistem durumu ilkesini kullanır.

Yanıtlar

HTTP durum kodu Açıklama Yanıt Şeması
200 (TAMAM) Başarılı bir işlem, 200 durum kodunu ve istenen çoğaltma sistem durumu bilgilerini döndürür.
ReplicaHealth
Tüm diğer durum kodları Ayrıntılı hata yanıtı.
FabricError