Abrufen des Status einer Flight-Paketübermittlung

  • Artikel

Verwenden Sie diese Methode in der Microsoft Store-Übermittlungs-API, um die status einer Flight-Paketübermittlung abzurufen. Weitere Informationen zum Erstellen einer Flight-Paketübermittlung mithilfe der Microsoft Store-Übermittlungs-API finden Sie unter Verwalten von Flight-Paketübermittlungen.

Voraussetzungen

Zur Verwendung dieser Methode sind folgende Schritte erforderlich:

  • Wenn Sie dies noch nicht getan haben, müssen Sie alle Voraussetzungen für die Microsoft Store-Übermittlungs-API erfüllen.
  • 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. Wenn das Token abgelaufen ist, können Sie ein neues abrufen.
  • Erstellen Sie eine Flight-Paketübermittlung für eine Ihrer Apps. Sie können dies im Partner Center oder mithilfe der Methode zum Erstellen eines Flight-Pakets tun.

Anforderung

Diese Methode hat die folgende Syntax. In den folgenden Abschnitten finden Sie Verwendungsbeispiele und Beschreibungen des Header und Anforderungstexts.

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

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 Flight-Paketübermittlung, für die der Status abgerufen werden soll. Weitere Informationen zur Store-ID finden Sie unter Anzeigen von Details zur App-Identität.
flightId Zeichenfolge Erforderlich. Die ID des Flight-Pakets mit der Übermittlung, für die der Status abgerufen werden soll. Diese ID ist in den Antwortdaten für Anforderungen zum Erstellen eines Flight-Pakets und zum Abrufen von Flight-Paketen für eine App verfügbar. Für einen Flug, der in Partner Center erstellt wurde, ist diese ID auch in der URL für die Flight-Seite in Partner Center verfügbar.
submissionId Zeichenfolge Erforderlich. Die ID der Übermittlung, für die der Status abgerufen werden sollen. Diese ID ist in den Antwortdaten für Anforderungen zum Erstellen einer Flight-Paketü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.

Anforderungstext

Stellen Sie keinen Anforderungstext für diese Methode bereit.

Anforderungsbeispiel

Im folgenden Beispiel wird veranschaulicht, wie der Status einer Flight-Paketübermittlung abgerufen werden kann.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649/status HTTP/1.1
Authorization: Bearer <your access token>

Antwort

Das folgende Beispiel veranschaulicht den JSON-Antworttext für einen erfolgreichen Aufruf dieser Methode. Der Antworttext enthält Informationen über die angegebene Übermittlung. Weitere Informationen zu den Werten im Antworttext finden Sie im folgenden Abschnitt.

{
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
}

Antworttext

Wert Typ BESCHREIBUNG
status Zeichenfolge Der Status der Übermittlung. Mögliche Werte:
  • Keine
  • Canceled
  • PendingCommit
  • CommitStarted
  • CommitFailed
  • PendingPublication
  • Veröffentlichung
  • Veröffentlicht
  • PublishFailed
  • PreProcessing
  • PreProcessingFailed
  • Zertifizierung
  • CertificationFailed
  • Freigabe
  • ReleaseFailed
statusDetails Objekt (object) Enthält zusätzliche Details über den Status der Übermittlung, einschließlich Informationen zu Fehlern. Weitere Informationen finden Sie unter Statusdetails-Ressource.

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 Die App verwendet ein Partner Center-Feature, das derzeit von der Microsoft Store-Übermittlungs-API nicht unterstützt wird.