Freigeben über

Aktualisieren einer Flight-Paket-Übermittlung

  • Artikel

Verwenden Sie diese Methode in der Microsoft Store-Übermittlungs-API, um eine vorhandene Flight-Paketübermittlung zu aktualisieren. Nachdem Sie eine Übermittlung mithilfe dieser Methode erfolgreich aktualisiert haben, müssen Sie die Übermittlung für die Aufnahme und Veröffentlichung übernehmen.

Weitere Informationen dazu, wie diese Methode in den Prozess der Erstellung einer Flight-Paketübermittlung mithilfe der Microsoft Store-Übermittlungs-API passt, 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 des Headers und des Anforderungstexts.

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

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, für die Sie eine Flight-Paketübermittlung aktualisieren möchten. Weitere Informationen zur Store-ID finden Sie unter Anzeigen von App-Identitätsdetails.
flightId Zeichenfolge Erforderlich. Die ID des Flight-Pakets, für das Sie eine Übermittlung 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 zu aktualisierenden Übermittlung. 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.
packageId Zeichenfolge Erforderlich. Die ID des vorhandenen Pakets.

Anforderungstext

Der Anforderungstext weist die folgenden Parameter auf.

Wert Typ Beschreibung
flightPackages array Enthält Objekte, die Details zu den einzelnen Paketen in der Übermittlung bereitstellen. Weitere Informationen zu den Werten im Antworttext finden Sie in der Flight-Paketressource. Beim Aufrufen dieser Methode zum Aktualisieren einer App-Übermittlung sind nur die Werte "fileName", "fileStatus", "minimumDirectXVersion" und "minimumSystemRam" dieser Objekte im Anforderungstext erforderlich. Die anderen Werte werden vom Partner Center aufgefüllt.
packageDeliveryOptions Objekt Enthält schrittweise Paketrollouts und obligatorische Updateeinstellungen für die Übermittlung. Weitere Informationen finden Sie im Objekt "Paketzustellungsoptionen".
targetPublishMode Zeichenfolge Der Veröffentlichungsmodus für die Übermittlung. Dies kann einer der folgenden Werte sein:
  • Direkt
  • Manuell
  • SpecificDate
targetPublishDate Zeichenfolge Das Veröffentlichungsdatum für die Übermittlung im ISO 8601-Format, wenn der targetPublishMode auf SpecificDate festgelegt ist.
notesForCertification Zeichenfolge Stellt zusätzliche Informationen für die Zertifizierungstester bereit, z. B. Testkontoanmeldeinformationen und Schritte zum Zugreifen auf und Überprüfen von Features. Weitere Informationen finden Sie in den Hinweisen zur Zertifizierung.

Anforderungsbeispiel

Im folgenden Beispiel wird veranschaulicht, wie eine Flight-Paketübermittlung für eine App aktualisiert wird.

PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649 HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
  "flightPackages": [
    {
      "id": "existingPackage.Id",
      "fileName": "newPackage.appx",
      "fileStatus": "PendingUpload",
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "targetPublishMode": "Immediate",
  "targetPublishDate": "",
  "notesForCertification": "No special steps are required for certification of this app."
}

Antwort

Im folgenden Beispiel wird der JSON-Antworttext für einen erfolgreichen Aufruf dieser Methode veranschaulicht. Der Antworttext enthält Informationen zur aktualisierten Übermittlung. Weitere Informationen zu den Werten im Antworttext finden Sie in der Flight-Paketübermittlungsressource.

{
  "id": "1152921504621243649",
  "flightId": "cd2e368a-0da5-4026-9f34-0e7934bc6f23",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
  "flightPackages": [
    {
      "fileName": "newPackage.appx",
      "fileStatus": "PendingUpload",
      "id": "",
      "version": "1.0.0.0",
      "languages": ["en-us"],
      "capabilities": [],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/8b389577-5d5e-4cbe-a744-1ff2e97a9eb8?sv=2014-02-14&sr=b&sig=wgMCQPjPDkuuxNLkeG35rfHaMToebCxBNMPw7WABdXU%3D&se=2016-06-17T21:29:44Z&sp=rwl",
  "targetPublishMode": "Immediate",
  "targetPublishDate": "",
  "notesForCertification": "No special steps are required for certification of this app."
}

Fehlercodes

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

Fehlercode Beschreibung
400 Die Flight-Paketübermittlung konnte nicht aktualisiert werden, da die Anforderung ungültig ist.
409 Die Flight-Paketübermittlung konnte aufgrund des aktuellen Zustands der App nicht aktualisiert werden, oder die App verwendet ein Partner Center-Feature, das derzeit nicht von der Microsoft Store-Übermittlungs-API unterstützt wird.