Aktualisieren des Prozentsatzes eines Rollouts einer App-Übermittlung

  • Artikel

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

Voraussetzungen

Zur Verwendung dieser Methode sind folgende Schritte erforderlich:

Anforderung

Diese Methode hat die folgende Syntax. In den folgenden Abschnitten finden Sie Verwendungsbeispiele und Beschreibungen des Headers und der Anforderungsparameter.

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

Anforderungsheader

Header type BESCHREIBUNG
Authorization Zeichenfolge Erforderlich. Das Azure AD-Zugriffstoken im Format Bearertoken<>.

Anforderungsparameter

Name Typ Beschreibung
applicationId Zeichenfolge Erforderlich. Die Store-ID der App mit der Übermittlung, deren Paketrollout-Prozentsatz aktualisiert werden soll. Weitere Informationen zur Store-ID finden Sie unter Anzeigen von Details zur App-Identität.
submissionId Zeichenfolge Erforderlich. Die ID der Übermittlung, deren Paketrollout-Prozentsatz aktualisiert werden soll. Diese ID ist in den Antwortdaten für Anforderungen zum Erstellen einer App-Übermittlung verfügbar. Für eine Übermittlung, die in Partner Center erstellt wurde, ist diese ID auch in der URL für die Übermittlungsseite in Partner Center verfügbar.
Prozentwert float Erforderlich. Der Prozentsatz der Benutzer, die das Paket für den schrittweisen Rollout erhalten.

Anforderungstext

Stellen Sie keinen Anforderungstext für diese Methode bereit.

Anforderungsbeispiel

Im folgenden Beispiel wird das Aktualisieren des Paketrollout-Prozentsatzes einer App-Übermittlung veranschaulicht.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621243680/updatepackagerolloutpercentage?percentage=25 HTTP/1.1
Authorization: Bearer <your access token>

Antwort

Das folgende Beispiel veranschaulicht den JSON-Antworttext für einen erfolgreichen Aufruf dieser Methode. Weitere Informationen zu den Werten im Antworttext finden Sie unter der Ressource zum Paketrollout.

{
    "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 Übermittlung konnte nicht gefunden werden.
409 Dieser Code weist auf einen der folgenden Fehler hin: