Uygulama Yükseltmeyi Başlat
Service Fabric kümesindeki bir uygulamayı yükseltmeye başlar.
Sağlanan uygulama yükseltme parametrelerini doğrular ve parametreler geçerliyse uygulamayı yükseltmeye başlar. ApplicationParameter'ınbir uygulama yükseltmesinde korunmadığını unutmayın. Geçerli uygulama parametrelerini korumak için, kullanıcı önce GetApplicationInfo işlemini kullanarak parametreleri almalı ve bunları örnekte gösterildiği gibi yükseltme API'si çağrısına geçirmelidir.
İstek
Yöntem | İstek URI'si |
---|---|
POST | /Applications/{applicationId}/$/Upgrade?api-version=6.0&timeout={timeout} |
Parametreler
Ad | Tür | Gerekli | Konum |
---|---|---|---|
applicationId |
string | Yes | Yol |
api-version |
string | Yes | Sorgu |
timeout |
integer (int64) | No | Sorgu |
ApplicationUpgradeDescription |
ApplicationUpgradeDescription | Yes | Gövde |
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 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 belgelenenden farklı olabilir.
Buna ek olarak ç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 ediyor. 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.
ApplicationUpgradeDescription
Tür: ApplicationUpgradeDescription
Gerekli: Evet
Uygulama yükseltme parametreleri.
Yanıtlar
HTTP Durum Kodu | Description | Yanıt Şeması |
---|---|---|
200 (Tamam) | Başarılı bir yanıt, uygulama yükseltmesinin başlatıldığını gösterir. Yükseltmenin durumunu almak için GetApplicationUpgrade işlemini kullanın. |
|
Diğer tüm durum kodları | Ayrıntılı hata yanıtı. |
Doku Oluşturucu |
Örnekler
Geçerli uygulama parametrelerini koruyarak bir uygulamayı yükseltme
Bu örnekte, Service Fabric kümesindeki bir uygulamayı yükseltmeye başlama gösterilmektedir.
İstek
POST http://localhost:19080/Applications/samples~CalculatorApp/$/Upgrade?api-version=6.0
Gövde
{
"Name": "fabric:/samples/CalculatorApp",
"TargetApplicationTypeVersion": "2.0",
"Parameters": [
{
"Key": "CalculatorAppParameter1",
"Value": "314"
},
{
"Key": "CalculatorAppParameter2",
"Value": "271"
}
],
"UpgradeKind": "Rolling",
"RollingUpgradeMode": "Monitored",
"MonitoringPolicy": {
"FailureAction": "Rollback"
}
}
200 Yanıt
Gövde
Yanıt gövdesi boş.