Abrufen von Rolloutinformationen für eine Flight-Paketübermittlung
Verwenden Sie diese Methode in der Microsoft Store-Übermittlungs-API, um Paketrolloutinformationen für eine Flight-Paketübermittlung abzurufen. 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:
- Falls noch nicht geschehen, füllen Sie alle Voraussetzungen für die Microsoft Store-Übermittlungs-API aus.
- Rufen Sie ein Azure AD-Zugriffstoken ab, das im Anforderungsheader für diese Methode verwendet wird. Nachdem Sie ein Zugriffstoken erhalten haben, haben Sie 60 Minuten Zeit, es zu verwenden, bevor es abläuft. Nachdem das Token abgelaufen ist, können Sie eine neue abrufen.
- Erstellen Sie eine Flight-Paketübermittlung für eine Ihrer Apps. Sie können dies im Partner Center tun, oder Sie können dies tun , indem Sie eine Flight-Paketübermittlungsmethode erstellen.
Anfordern
Diese Methode weist die folgende Syntax auf. In den folgenden Abschnitten finden Sie Verwendungsbeispiele und Beschreibungen der Header- und Anforderungsparameter.
| Methode | Anforderungs-URI |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/packagerollout |
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 den Paketrolloutinformationen enthält, die Sie abrufen 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 den Paketrolloutinformationen enthält, die Sie abrufen 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 den abzurufenden Paketrollout-Informationen. 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. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Anforderungsbeispiel
Im folgenden Beispiel wird veranschaulicht, wie Sie die Paketrolloutinformationen für eine Flight-Paketübermittlung abrufen.
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649/packagerollout HTTP/1.1
Authorization: Bearer <your access token>
Antwort
Im folgenden Beispiel wird der JSON-Antworttext für einen erfolgreichen Aufruf dieser Methode für eine Flight-Paketübermittlung mit aktiviertem graduellem Paketrollout veranschaulicht. Weitere Informationen zu den Werten im Antworttext finden Sie in der Paketrollout-Ressource.
{
"isPackageRollout": true,
"packageRolloutPercentage": 25.0,
"packageRolloutStatus": "PackageRolloutInProgress",
"fallbackSubmissionId": "1212922684621243058"
}
Wenn die Flight-Paketübermittlung nicht schrittweise Paketrollout aktiviert ist, wird der folgende Antworttext zurückgegeben.
{
"isPackageRollout": false,
"packageRolloutPercentage": 0.0,
"packageRolloutStatus": "PackageRolloutNotStarted",
"fallbackSubmissionId": "0"
}
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 | Die Flight-Paketübermittlung gehört nicht zum angegebenen Flight-Paket, oder die App verwendet ein Partner Center-Feature, das derzeit nicht von der Microsoft Store-Übermittlungs-API unterstützt wird. |