Aracılığıyla paylaş

Uygulama Bilgilerini Alma

  • Makale

Service Fabric uygulaması hakkında bilgi alır.

Oluşturulan veya Service Fabric kümesinde oluşturulma sürecinde olan ve adı parametre olarak belirtilen uygulamayla eşleşen uygulama hakkındaki bilgileri döndürür. Yanıt ad, tür, durum, parametreler ve uygulama hakkındaki diğer ayrıntıları içerir.

İstek

Yöntem İstek URI'si
GET /Applications/{applicationId}?api-version=6.0&ExcludeApplicationParameters={ExcludeApplicationParameters}&timeout={timeout}

Parametreler

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

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.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.

ExcludeApplicationParameters

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

Uygulama parametrelerinin sonuçtan dışlanıp dışlanmayacağını belirten bayrak.

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.

Yanıtlar

HTTP Durum Kodu Description Yanıt Şeması
200 (Tamam) Uygulama hakkında bilgi.
 Applicationınfo
204 (NoContent) Belirtilen applicationId kümede bulunmazsa 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 uygulamayı alma

Bu örnekte, bir uygulamanın tanımlayıcısını kullanarak uygulama hakkında bilgi alma gösterilmektedir. Uygulama bulunursa, ilgili bilgiler 200 durum koduyla döndürülür. Uygulama bulunamazsa, 204 durum koduyla boş içerik döndürülür.

İstek

GET http://localhost:19080/Applications/samples~CalculatorApp?api-version=6.0

200 Yanıt

Gövde
{
  "Id": "samples~CalculatorApp",
  "Name": "fabric:/samples/CalculatorApp",
  "TypeName": "CalculatorApp",
  "TypeVersion": "1.0",
  "Status": "Ready",
  "Parameters": [
    {
      "Key": "CalculatorAppParameter1",
      "Value": "314"
    },
    {
      "Key": "CalculatorAppParameter2",
      "Value": "271"
    }
  ],
  "HealthState": "Ok",
  "ApplicationDefinitionKind": "ServiceFabricApplicationDescription"
}

204 Yanıtı

Gövde

Yanıt gövdesi boş.