Dağıtılan Uygulama Bilgilerini Alma

  • Makale

Service Fabric düğümünde dağıtılan bir uygulama hakkındaki bilgileri alır.

Sağlanan uygulama kimliği sistem uygulamasına yönelikse, bu sorgu sistem uygulama bilgilerini döndürür. Sonuçlar etkin, etkinleştirme ve indirme durumlarında dağıtılan uygulamaları kapsar. Bu sorgu, düğüm adının kümedeki bir düğüme karşılık geldiğini gerektirir. Sağlanan düğüm adı kümedeki etkin Service Fabric düğümlerine işaret etmiyorsa sorgu başarısız olur.

İstek

Yöntem İstek URI'si
GET /Nodes/{nodeName}/$/GetApplications/{applicationId}?api-version=6.1&timeout={timeout}&IncludeHealthState={IncludeHealthState}

Parametreler

Ad Tür Gerekli Konum
nodeName string Yes Yol
applicationId string Yes Yol
api-version string Yes Sorgu
timeout integer (int64) No Sorgu
IncludeHealthState boolean No Sorgu

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.

api-version

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

API'nin sürümü. Bu parametre gereklidir ve değeri '6.1' 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.

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.

IncludeHealthState

Tür: boole
Gerekli: Hayır
Varsayılan: false

Varlığın sistem durumunu ekleyin. Bu parametre false ise veya belirtilmezse, döndürülen sistem durumu "Bilinmiyor" olur. True olarak ayarlandığında, sonuçlar birleştirilmeden önce sorgu düğüme ve sistem durumu sistemi hizmetine paralel olarak gider. Sonuç olarak, sorgu daha pahalıdır ve daha uzun sürebilir.

Yanıtlar

HTTP Durum Kodu Description Yanıt Şeması
200 (Tamam) Başarılı bir işlem 200 durum kodunu ve dağıtılan uygulama hakkındaki bilgileri döndürür.
 DeployedApplicationInfo
204 (NoContent) Belirtilen uygulama düğümde dağıtılmazsa boş bir yanıt döndürülür.
Diğer tüm durum kodları Ayrıntılı hata yanıtı.
 Doku Oluşturucu

Örnekler

Uygulama kimliğine göre belirli bir dağıtılan uygulamayı alma ve sonucta sistem durumunu dahil edin

Bu örnekte, bir uygulama tanımlayıcısı kullanılarak belirli bir düğüme dağıtılan bir uygulama hakkında nasıl bilgi alındığı gösterilmektedir. Uygulama bulunursa bilgileri 200 durum koduyla döndürülür. Belirtilen uygulama düğüme dağıtılmadıysa, durum kodu 204 olan boş bir yanıt döndürülür.

İstek

GET http://localhost:19080/Nodes/_Node_0/$/GetApplications/samples~CalculatorApp?api-version=6.1&IncludeHealthState=True

200 Yanıt

Gövde
{
  "Id": "samples~CalculatorApp",
  "Name": "fabric:/samples/CalculatorApp",
  "TypeName": "CalculatorApp",
  "TypeVersion": "1.0.0",
  "Status": "Active",
  "WorkDirectory": "C:\\SfDevCluster\\Data\\_App\\_Node_1\\CalculatorApp_App0\\work",
  "LogDirectory": "C:\\SfDevCluster\\Data\\_App\\_Node_1\\CalculatorApp_App0\\log",
  "TempDirectory": "C:\\SfDevCluster\\Data\\_App\\_Node_1\\CalculatorApp_App0\\temp",
  "HealthState": "Ok"
}

204 Yanıtı

Gövde

Yanıt gövdesi boş.