Memperbarui pengiriman penerbangan paket
Gunakan metode ini di API pengiriman Microsoft Store untuk memperbarui pengiriman penerbangan paket yang ada. Setelah berhasil memperbarui pengiriman dengan menggunakan metode ini, Anda harus melakukan pengiriman untuk penyerapan dan penerbitan.
Untuk informasi selengkapnya tentang bagaimana metode ini sesuai dengan 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 penerbangan paket untuk salah satu aplikasi Anda. Anda dapat melakukan ini di Pusat Mitra, atau Anda dapat melakukan ini dengan menggunakan metode membuat pengiriman penerbangan paket.
Minta
Metode ini memiliki sintaks berikut. Lihat bagian berikut untuk contoh penggunaan dan deskripsi header dan isi permintaan.
Metode | URI Permintaan |
---|---|
TARUH | https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId} |
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 ingin Anda perbarui pengiriman penerbangan paketnya. Untuk informasi selengkapnya tentang ID Penyimpanan, lihat Menampilkan detail identitas aplikasi. |
flightId | string | Harus diisi. ID penerbangan paket yang ingin Anda perbarui pengirimannya. 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 yang akan diperbarui. 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. |
Isi permintaan
Isi permintaan memiliki parameter berikut.
Nilai | Tipe | Deskripsi |
---|---|---|
flightPackages | array | Berisi objek yang memberikan detail tentang setiap paket dalam pengiriman. Untuk detail selengkapnya tentang nilai dalam isi respons, lihat Sumber daya paket penerbangan. Saat memanggil metode ini untuk memperbarui pengiriman aplikasi, hanya nilai fileName, fileStatus, minimumDirectXVersion, dan minimumSystemRam dari objek ini yang diperlukan dalam isi permintaan. Nilai lainnya diisi oleh Pusat Mitra. |
packageDeliveryOptions | object | Berisi peluncuran paket bertahap dan pengaturan pembaruan wajib untuk pengiriman. Untuk informasi selengkapnya, lihat Objek opsi pengiriman paket. |
targetPublishMode | string | Mode penerbitan untuk pengiriman. Ini bisa menjadi salah satu nilai berikut:
|
targetPublishDate | string | Tanggal penerbitan untuk pengiriman dalam format ISO 8601, jika targetPublishMode diatur ke SpecificDate. |
notesForCertification | string | Menyediakan info tambahan untuk penguji sertifikasi, seperti kredensial akun pengujian dan langkah-langkah untuk mengakses dan memverifikasi fitur. Untuk informasi selengkapnya, lihat Catatan untuk sertifikasi. |
Contoh permintaan
Contoh berikut menunjukkan cara memperbarui pengiriman penerbangan paket untuk aplikasi.
PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649 HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
"flightPackages": [
{
"fileName": "newPackage.appx",
"fileStatus": "PendingUpload",
"minimumDirectXVersion": "None",
"minimumSystemRam": "None"
}
],
"packageDeliveryOptions": {
"packageRollout": {
"isPackageRollout": false,
"packageRolloutPercentage": 0.0,
"packageRolloutStatus": "PackageRolloutNotStarted",
"fallbackSubmissionId": "0"
},
"isMandatoryUpdate": false,
"mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
},
"targetPublishMode": "Immediate",
"targetPublishDate": "",
"notesForCertification": "No special steps are required for certification of this app."
}
Respons
Contoh berikut menunjukkan isi respons JSON untuk panggilan yang berhasil ke metode ini. Isi respons berisi informasi tentang pengiriman yang diperbarui. Untuk detail selengkapnya tentang nilai dalam isi respons, lihat Sumber daya pengiriman penerbangan paket.
{
"id": "1152921504621243649",
"flightId": "cd2e368a-0da5-4026-9f34-0e7934bc6f23",
"status": "PendingCommit",
"statusDetails": {
"errors": [],
"warnings": [],
"certificationReports": []
},
"flightPackages": [
{
"fileName": "newPackage.appx",
"fileStatus": "PendingUpload",
"id": "",
"version": "1.0.0.0",
"languages": ["en-us"],
"capabilities": [],
"minimumDirectXVersion": "None",
"minimumSystemRam": "None"
}
],
"packageDeliveryOptions": {
"packageRollout": {
"isPackageRollout": false,
"packageRolloutPercentage": 0.0,
"packageRolloutStatus": "PackageRolloutNotStarted",
"fallbackSubmissionId": "0"
},
"isMandatoryUpdate": false,
"mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
},
"fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/8b389577-5d5e-4cbe-a744-1ff2e97a9eb8?sv=2014-02-14&sr=b&sig=wgMCQPjPDkuuxNLkeG35rfHaMToebCxBNMPw7WABdXU%3D&se=2016-06-17T21:29:44Z&sp=rwl",
"targetPublishMode": "Immediate",
"targetPublishDate": "",
"notesForCertification": "No special steps are required for certification of this app."
}
Kode kesalahan
Jika permintaan tidak berhasil diselesaikan, respons akan berisi salah satu kode kesalahan HTTP berikut.
Kode kesalahan | Deskripsi |
---|---|
400 | Pengiriman penerbangan paket tidak dapat diperbarui karena permintaan tidak valid. |
409 | Pengiriman penerbangan paket tidak dapat diperbarui karena status aplikasi saat ini, atau aplikasi menggunakan fitur Pusat Mitra yang saat ini tidak didukung oleh API pengiriman Microsoft Store. |
Topik terkait
- Membuat dan mengelola pengiriman menggunakan layanan Microsoft Store
- Mengelola pengiriman penerbangan paket
- Dapatkan pengiriman penerbangan paket
- Membuat pengiriman penerbangan paket
- Menerapkan pengiriman penerbangan paket
- Menghapus pengiriman penerbangan paket
- Mendapatkan status pengiriman penerbangan paket
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk