Aracılığıyla paylaş

İlke Kullanarak Dağıtılan Hizmet Paketi Durumunu Alma

  • Makale

Belirtilen ilkeyi kullanarak bir Service Fabric düğümünde dağıtılan belirli bir uygulama için hizmet paketinin sistem durumu hakkındaki bilgileri alır.

Service Fabric düğümünde dağıtılan belirli bir uygulama için hizmet paketinin sistem durumu hakkındaki bilgileri alır. belirtilen ilkeyi kullanarak. İsteğe bağlı olarak, sistem durumu temelinde dağıtılan hizmet paketinde bildirilen HealthEvent nesnelerinin koleksiyonunu filtrelemek için EventsHealthStateFilter 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'nin 'ConsiderWarningAsError' alanını kullanır. Dağıtılan hizmet paketinin durumu değerlendirilirken kalan alanlar yoksayılır.

İstek

Yöntem İstek URI'si
POST /Nodes/{nodeName}/$/GetApplications/{applicationId}/$/GetServicePackages/{servicePackageName}/$/GetHealth?api-version=6.0&EventsHealthStateFilter={EventsHealthStateFilter}&timeout={timeout}

Parametreler

Ad Tür Gerekli Konum
nodeName string Yes Yol
applicationId string Yes Yol
servicePackageName string Yes Yol
api-version string Yes Sorgu
EventsHealthStateFilter tamsayı No Sorgu
timeout integer (int64) No Sorgu
ApplicationHealthPolicy ApplicationHealthPolicy No Gövde

nodeName

Tür: dize
Gerekli: Evet

Düğümün adı.

applicationId

Tür: dize
Gerekli: Evet

Uygulamanın kimliği. Bu genellikle 'fabric:' URI şeması olmayan uygulamanın tam adıdır. Sürüm 6.0'dan başlayarak, hiyerarşik adlar "~" karakteriyle sınırlandırılır. Örneğin, uygulama adı "fabric:/myapp/app1" ise, uygulama kimliği 6.0+ sürümünde "myapp~app1" ve önceki sürümlerde "myapp/app1" olacaktır.

servicePackageName

Tür: dize
Gerekli: Evet

Hizmet paketinin adı.

api-version

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

API'nin 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ıldığı veya değiştirildiği çalışma zamanı sürümünü temel alır. Service Fabric çalışma zamanı API'nin birden fazla sürümünü destekler. Bu, API'nin desteklenen en son sürümüdür. Daha düşük bir API sürümü geçirilirse, döndürülen yanıt bu belirtimde belgelenen yanıttan farklı olabilir.

Ayrıca çalışma zamanı, çalışma zamanının geçerli sürümüne kadar desteklenen en son sürümden daha yüksek olan tüm sürümleri kabul edin. Bu nedenle, 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 için 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 koleksiyonunun filtrelenmesine izin verir. Bu parametrenin olası değerleri aşağıdaki sistem durumu durumlarından birinin tamsayı değerini içerir. Yalnızca filtreyle eşleşen olaylar döndürülür. Toplanan sistem durumunu değerlendirmek için tüm olaylar kullanılır. Belirtilmezse, tüm girdiler döndürülür. Durum değerleri bayrak tabanlı sabit listesidir, bu nedenle değer bit düzeyinde 'OR' işleci kullanılarak elde edilen bu değerlerin bir birleşimi olabilir. Örneğin, sağlanan değer 6 ise, HealthState değeri Ok (2) ve Warning (4) olan tüm olaylar döndürülür.

  • Varsayılan - Varsayılan değer. Herhangi bir HealthState ile eşleşir. Değer sıfırdır.
  • Hiçbiri - Herhangi bir HealthState değeriyle eşleşmeyen filtre. Belirli bir durum koleksiyonunda sonuç döndürmemek için kullanılır. Değer 1'dir.
  • Tamam - HealthState değeri Ok olan girişle eşleşen filtre. Değer 2'dir.
  • Uyarı - HealthState değeri Warning ile girişle eşleşen filtre. Değer 4'dür.
  • Error - HealthState değeriyle girişle eşleşen filtre Error. Değer 8'dir.
  • Tümü - Herhangi bir HealthState değeriyle girişle eşleşen filtre. Değer 65535'tir.

timeout

Tür: tamsayı (int64)
Gerekli: Hayır
Varsayılan: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

İşlemi saniyeler içinde gerçekleştirmek için sunucu zaman aşımı. Bu zaman aşımı, istemcinin istenen işlemin tamamlanmasını beklemeye istekli olduğu 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. Yoksa, sistem durumu değerlendirmesi uygulama bildiriminden veya varsayılan sistem durumu ilkesinden sistem durumu ilkesini kullanır.

Yanıtlar

HTTP Durum Kodu Description Yanıt Şeması
200 (Tamam) Başarılı bir işlem, belirli bir düğüm ve uygulama için 200 durum kodunu ve dağıtılan hizmet paketinin sistem durumu bilgilerini döndürür.
 DeployedServicePackageHealth
Diğer tüm durum kodları Ayrıntılı hata yanıtı.
 Doku Oluşturucu