Freigeben über

Aktualisieren des Prozentsatzes eines Rollouts für eine Flight-Paketübermittlung

  • Artikel

Verwenden Sie diese Methode in der Microsoft Store-Übermittlungs-API, um den Rolloutprozentsatz für eine Flight-Paketübermittlung zu aktualisieren. Weitere Informationen zum Prozess des Erstellens einer Flight-Paketübermittlung mithilfe der Microsoft Store-Übermittlungs-API finden Sie unter Verwalten von Flight-Paketübermittlungen.

Voraussetzungen

Um diese Methode zu verwenden, müssen Sie zuerst Folgendes tun:

Anfordern

Diese Methode weist die folgende Syntax auf. In den folgenden Abschnitten finden Sie Verwendungsbeispiele und Beschreibungen der Header- und Anforderungsparameter.

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

Anforderungsheader

Header Typ Beschreibung
Autorisierung Zeichenfolge Erforderlich. Das Azure AD-Zugriffstoken im Formular Bearer<-Token>.

Anforderungsparameter

Name Typ Beschreibung
applicationId Zeichenfolge Erforderlich. Die Store-ID der App, die die Flight-Paketübermittlung mit dem Prozentsatz des Paketrollouts enthält, den Sie aktualisieren möchten. Weitere Informationen zur Store-ID finden Sie unter Anzeigen von App-Identitätsdetails.
flightId Zeichenfolge Erforderlich. Die ID des Flight-Pakets, das die Übermittlung mit dem Paketrollout-Prozentsatz enthält, den Sie aktualisieren möchten. Diese ID steht in den Antwortdaten für Anforderungen zum Erstellen eines Flight-Pakets und zum Abrufen von Flight-Paketen für eine App zur Verfügung. Für einen Test-Flight, der im Partner Center erstellt wurde, steht diese ID auch in der URL für die Flight-Seite im Partner Center zur Verfügung.
submissionId Zeichenfolge Erforderlich. Die ID der Übermittlung mit dem Prozentsatz des Paketrollouts, den Sie aktualisieren möchten. Diese ID ist in den Antwortdaten für Anforderungen zum Erstellen einer Flight-Paketübermittlung verfügbar. Für eine Übermittlung, die im Partner Center erstellt wurde, ist diese ID auch in der URL für die Übermittlungsseite im Partner Center verfügbar.
percentage float Erforderlich. Der Prozentsatz der Benutzer, die das graduelle Rollout-Paket erhalten.

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Anforderungsbeispiel

Im folgenden Beispiel wird veranschaulicht, wie der Prozentsatz des Paketrollouts für eine Flight-Paketübermittlung aktualisiert wird.

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>

Antwort

Im folgenden Beispiel wird der JSON-Antworttext für einen erfolgreichen Aufruf dieser Methode veranschaulicht. Weitere Informationen zu den Werten im Antworttext finden Sie in der Paketrollout-Ressource.

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

Fehlercodes

Wenn die Anforderung nicht erfolgreich abgeschlossen werden kann, enthält die Antwort einen der folgenden HTTP-Fehlercodes.

Fehlercode BESCHREIBUNG
404 Die Flight-Paketübermittlung konnte nicht gefunden werden.
409 Dieser Code gibt einen der folgenden Fehler an:

  • Die Übermittlung befindet sich nicht in einem gültigen Zustand für den schrittweisen Rolloutvorgang (vor dem Aufrufen dieser Methode muss die Übermittlung veröffentlicht werden, und der PackageRolloutStatus-Wert muss auf PackageRolloutInProgress festgelegt werden).
  • Die Übermittlung gehört nicht zur angegebenen App.
  • Die App verwendet ein Partner Center-Feature, das derzeit von der Microsoft Store-Übermittlungs-API nicht unterstützt wird.