Bagikan melalui

Memperbarui persentase peluncuran untuk pengiriman penerbangan

  • Artikel

Gunakan metode ini di API pengiriman Microsoft Store untuk memperbarui persentase peluncuran untuk pengiriman penerbangan paket. Untuk informasi selengkapnya tentang proses pembuatan pengiriman penerbangan paket dengan menggunakan API pengiriman Microsoft Store, lihat Mengelola pengiriman penerbangan paket.

Prasyarat

Untuk menggunakan metode ini, Anda harus terlebih dahulu melakukan hal berikut:

  • Jika Anda belum melakukannya, selesaikan semua prasyarat untuk API pengiriman Microsoft Store.
  • Dapatkan token akses Azure ACTIVE Directory untuk digunakan di header permintaan untuk metode ini. Setelah mendapatkan token akses, Anda memiliki waktu 60 menit untuk menggunakan token akses sebelum masa berlakunya habis. Setelah token kedaluwarsa, Anda dapat memperoleh yang baru.
  • Buat pengiriman untuk salah satu aplikasi Anda. Anda dapat melakukan ini di Pusat Mitra, atau Anda dapat melakukan ini dengan menggunakan metode buat pengiriman aplikasi.
  • Aktifkan peluncuran paket bertahap untuk pengiriman. Anda dapat melakukan ini di Pusat Mitra, atau Anda dapat melakukan ini dengan menggunakan API pengiriman Microsoft Store.

Minta

Metode ini memiliki sintaks berikut. Lihat bagian berikut untuk contoh penggunaan dan deskripsi parameter header dan permintaan.

Metode URI Permintaan
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/updatepackagerolloutpercentage

Header permintaan

Header Tipe Deskripsi
Authorization string Harus diisi. Token akses Microsoft Azure ACTIVE Directory dalam bentuk token> Pembawa<.

Parameter permintaan

Nama Tipe Deskripsi
applicationId string Harus diisi. ID Toko aplikasi yang berisi pengiriman penerbangan paket dengan persentase peluncuran paket yang ingin Anda perbarui. Untuk informasi selengkapnya tentang ID Penyimpanan, lihat Menampilkan detail identitas aplikasi.
flightId string Harus diisi. ID penerbangan paket yang berisi pengiriman dengan persentase peluncuran paket yang ingin Anda perbarui. ID ini tersedia dalam data respons untuk permintaan membuat penerbangan paket dan mendapatkan penerbangan paket untuk aplikasi. Untuk penerbangan yang dibuat di Pusat Mitra, ID ini juga tersedia di URL untuk halaman penerbangan di Pusat Mitra.
submissionId string Harus diisi. ID pengiriman dengan persentase peluncuran paket yang ingin Anda perbarui. ID ini tersedia dalam data respons untuk permintaan membuat pengiriman penerbangan paket. Untuk pengiriman yang dibuat di Pusat Mitra, ID ini juga tersedia di URL untuk halaman pengiriman di Pusat Mitra.
persentase float Harus diisi. Persentase pengguna yang akan menerima paket peluncuran bertahap.

Isi permintaan

Jangan berikan isi permintaan untuk metode ini.

Contoh permintaan

Contoh berikut menunjukkan cara memperbarui persentase peluncuran paket untuk pengiriman penerbangan paket.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243680/updatepackagerolloutpercentage?percentage=25 HTTP/1.1
Authorization: Bearer <your access token>

Respons

Contoh berikut menunjukkan isi respons JSON untuk panggilan yang berhasil ke metode ini. Untuk detail selengkapnya tentang nilai dalam isi respons, lihat Sumber daya peluncuran paket.

{
    "isPackageRollout": true,
    "packageRolloutPercentage": 25.0,
    "packageRolloutStatus": "PackageRolloutInProgress",
    "fallbackSubmissionId": "1212922684621243058"
}

Kode kesalahan

Jika permintaan tidak berhasil diselesaikan, respons akan berisi salah satu kode kesalahan HTTP berikut.

Kode kesalahan Deskripsi
404 Pengiriman penerbangan paket tidak dapat ditemukan.
409 Kode ini menunjukkan salah satu kesalahan berikut:

  • Pengiriman tidak dalam status valid untuk operasi peluncuran bertahap (sebelum memanggil metode ini, pengiriman harus diterbitkan dan nilai packageRolloutStatus harus diatur ke PackageRolloutInProgress).
  • Pengiriman bukan milik aplikasi yang ditentukan.
  • Aplikasi ini menggunakan fitur Pusat Mitra yang saat ini tidak didukung oleh API pengiriman Microsoft Store.