Bagikan melalui

Mulai Peningkatan Aplikasi

  • Artikel

Mulai meningkatkan aplikasi di kluster Service Fabric.

Memvalidasi parameter peningkatan aplikasi yang disediakan dan mulai meningkatkan aplikasi jika parameter valid. Catatan, ApplicationParameters tidak dipertahankan di seluruh peningkatan aplikasi. Untuk mempertahankan parameter aplikasi saat ini, pengguna harus mendapatkan parameter menggunakan operasi GetApplicationInfo terlebih dahulu dan meneruskannya ke panggilan API peningkatan seperti yang ditunjukkan dalam contoh.

Minta

Metode URI Permintaan
POST /Applications/{applicationId}/$/Upgrade?api-version=6.0&timeout={timeout}

Parameter

Nama Jenis Diperlukan Lokasi
applicationId string Ya Jalur
api-version string Ya Kueri
timeout bilangan bulat (int64) Tidak Kueri
ApplicationUpgradeDescription ApplicationUpgradeDescription Ya Isi

applicationId

Jenis: string
Diperlukan: Ya

Identitas aplikasi. Ini biasanya nama lengkap aplikasi tanpa skema URI 'fabric:'. Mulai dari versi 6.0, nama hierarki dibatasi dengan karakter “~”. Misalnya, jika nama aplikasi adalah "fabric:/myapp/app1", identitas aplikasi akan menjadi "myapp~app1" di versi 6.0+ dan "myapp/app1" di versi sebelumnya.

api-version

Jenis: string
Diperlukan: Ya
Default: 6.0

Versi API. Parameter ini diperlukan dan nilainya harus '6.0'.

Versi SERVICE Fabric REST API didasarkan pada versi runtime tempat API diperkenalkan atau diubah. Runtime Service Fabric mendukung lebih dari satu versi API. Ini adalah versi TERBARU api yang didukung. Jika versi API yang lebih rendah diteruskan, respons yang dikembalikan mungkin berbeda dari yang didokumenkan dalam spesifikasi ini.

Selain itu, runtime menerima versi apa pun yang lebih tinggi dari versi terbaru yang didukung hingga versi runtime saat ini. Jadi jika versi API terbaru adalah 6.0, tetapi jika runtime adalah 6.1, untuk mempermudah penulisan klien, runtime akan menerima versi 6.1 untuk API tersebut. Namun perilaku API akan sesuai versi 6.0 yang didokumentasikan.

timeout

Jenis: bilangan bulat (int64)
Diperlukan: Tidak
Default: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Batas waktu server untuk melakukan operasi dalam hitungan detik. Batas waktu ini menentukan durasi waktu klien bersedia menunggu operasi yang diminta selesai. Nilai default untuk parameter ini adalah 60 detik.

ApplicationUpgradeDescription

Jenis: ApplicationUpgradeDescription
Diperlukan: Ya

Parameter untuk peningkatan aplikasi.

Respons

Kode Status HTTP Deskripsi Skema Respons
200 (OK) Respons yang berhasil berarti bahwa peningkatan aplikasi telah dimulai. Gunakan operasi GetApplicationUpgrade untuk mendapatkan status peningkatan.
Semua kode status lainnya Respons kesalahan terperinci.
 FabricError

Contoh

Meningkatkan aplikasi yang mempertahankan parameter aplikasi saat ini

Contoh ini menunjukkan cara mulai meningkatkan aplikasi dalam kluster Service Fabric.

Minta

POST http://localhost:19080/Applications/samples~CalculatorApp/$/Upgrade?api-version=6.0
Isi
{
  "Name": "fabric:/samples/CalculatorApp",
  "TargetApplicationTypeVersion": "2.0",
  "Parameters": [
    {
      "Key": "CalculatorAppParameter1",
      "Value": "314"
    },
    {
      "Key": "CalculatorAppParameter2",
      "Value": "271"
    }
  ],
  "UpgradeKind": "Rolling",
  "RollingUpgradeMode": "Monitored",
  "MonitoringPolicy": {
    "FailureAction": "Rollback"
  }
}

Respons 200

Isi

Isi respons kosong.