Freigeben über

Aktualisieren des Rollout-Prozentsatzes für eine Flight-Übermittlung

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

Voraussetzungen

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

Anfrage

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

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

Anforderungs-Kopfzeile

Kopfzeile Typ BESCHREIBUNG
Autorisierung Schnur Erforderlich. Das Azure AD-Zugriffstoken in der Form Bearer<token>.

Anforderungsparameter

Name Typ BESCHREIBUNG
Anwendungs-ID Schnur Erforderlich. Die Store-ID der App, die die Paketübermittlung mit dem Rollout-Prozentsatz enthält, den Sie aktualisieren möchten. Weitere Informationen zur Store-ID finden Sie unter Anzeigen von App-Identitätsdetails.
FlugId Schnur Erforderlich. Die ID des Paket-Flights, das die Einreichung mit dem Paketrollout-Prozentsatz enthält, den Sie aktualisieren möchten. Diese ID ist in den Antwortdaten für Anforderungen zum Erstellen eines Flugpakets und zum Abrufen von Flugpaketen für eine Appverfügbar. Für einen Flug, der im Partner Center erstellt wurde, ist diese ID auch in der URL der Flugseite im Partner Center verfügbar.
Einreichungs-ID Schnur Erforderlich. Die ID der Einsendung mit dem Paketrollout-Prozentsatz, den Sie aktualisieren möchten. Diese ID ist in den Antwortdaten für Anforderungen zum Erstellen einer Flight-Paketübermittlungverfü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.
Prozentwert Schweben Erforderlich. Der Prozentsatz der Benutzer, die das graduelle Rollout-Paket erhalten.

Anfragekörper

Geben Sie keinen Request-Body für diese Methode an.

Beispielanfrage

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 angezeigt. Weitere Informationen zu den Werten im Antwortkörper finden Sie unter Paket-Rollout-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 Einreichung für den Flugpaketversand konnte nicht gefunden werden.
409 Dieser Code gibt einen der folgenden Fehler an:

  • Die Einsendung befindet sich nicht in einem gültigen Zustand für den stufenweisen Rollout-Vorgang (vor dem Aufrufen dieser Methode muss die Einsendung veröffentlicht werden, und der packageRolloutStatus--Wert muss auf PackageRolloutInProgressfestgelegt werden).
  • Die Einsendung gehört nicht zur angegebenen App.
  • Die App verwendet eine Partner Center-Funktion, die derzeit von der Microsoft Store-Einreichungs-APInicht unterstützt wird.
  • Last updated on