Управление подачей полетных заявок на пакет

Создание отправки тестового пакета

Чтобы создать заявку на пакетный рейс, выполните этот процесс.

1. Если вы еще не сделали этого, выполните предварительные требования, описанные в статье Создание отправки и управление ими с помощью служб Microsoft Store, включая связывание приложения Azure AD с учетной записью Центра партнеров и получение идентификатора клиента и ключа. Это нужно сделать только один раз; После того как у вас есть идентификатор клиента и ключ, их можно повторно использовать в любое время, когда необходимо создать новый маркер доступа Azure AD.

2. Получите токен доступа Azure AD. Этот маркер доступа необходимо передать методам в API отправки Microsoft Store. После получения маркера доступа у вас есть 60 минут, чтобы использовать его до истечения срока действия. После истечения срока действия токена вы можете получить новый.

3. создать отправки тестового пакета, выполнив следующий метод в API отправки Microsoft Store. Этот метод создает новую заявку в процессе, которая является копией вашей последней опубликованной заявки.

   POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions
   

   Текст ответа содержит ресурс отправки рейса, который включает идентификатор новой отправки, подписанный URL-адрес совместного доступа (SAS) для загрузки любых пакетов отправки в Azure Blob Storage, а также данные для новой отправки (включая все списки и информацию о ценах).

   Заметка

   URI SAS предоставляет доступ к защищенному ресурсу в службе хранилища Azure, не требуя ключей учетной записи. Дополнительные сведения о подписях общего доступа URIs и их использовании с хранилищем BLOB в Azure см. в Подписи общего доступа, часть 1: Общие сведения о модели SAS и Подписи общего доступа, часть 2: Создание и использование SAS с хранилищем BLOB.

4. Если вы добавляете новые пакеты к отправке, подготовьте пакеты и добавьте их в ZIP-архив.

5. Измените данные подготовки релизного пакета с любыми необходимыми изменениями для новой подачи и выполните следующую инструкцию, чтобы обновить пакетную подготовку.

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

   Заметка

   Если вы добавляете новые пакеты для отправки, обязательно обновите данные отправки, чтобы ссылаться на имя и относительный путь к этим файлам в ZIP-архиве.

6. Если вы добавляете новые пакеты для отправки, отправьте ZIP-архив в хранилище BLOB-объектов Azure с помощью URI SAS, предоставленного в ответе метода POST, который вы вызывали ранее. Существуют различные библиотеки Azure, которые можно использовать для этого на различных платформах, в том числе:

   • клиентская библиотека службы хранилища Azure для .NET
   • Azure SDK пакет службы хранилища для Java
   • SDK службы хранилища Azure для Python

   В следующем примере кода C# показано, как отправить ZIP-архив в хранилище BLOB-объектов Azure с помощью класса CloudBlockBlob в клиентской библиотеке службы хранилища Azure для .NET. В этом примере предполагается, что ZIP-архив уже записан в объект потока.

   string sasUrl = "https://productingestionbin1.blob.core.windows.net/ingestion/26920f66-b592-4439-9a9d-fb0f014902ec?sv=2014-02-14&sr=b&sig=usAN0kNFNnYE2tGQBI%2BARQWejX1Guiz7hdFtRhyK%2Bog%3D&se=2016-06-17T20:45:51Z&sp=rwl";
   Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob blockBob =
       new Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob(new System.Uri(sasUrl));
   await blockBob.UploadFromStreamAsync(stream);
   

7. Подтвердите отправку пакета путем выполнения следующего метода. При этом центр партнеров будет оповещен о том, что вы выполнили отправку и что обновления теперь должны применяться к вашей учетной записи.

   POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/commit
   

8. Проверьте статус коммита, выполнив следующий метод, чтобы получить статус отправки пакетного полёта.

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

   Чтобы подтвердить состояние отправки, просмотрите значение состояния в тексте ответа. Это значение должно измениться с CommitStarted на PreProcessing, если запрос выполнен успешно, или на CommitFailed, если в запросе возникают ошибки. Если возникают ошибки, поле statusDetails содержит дополнительные сведения об ошибке.

9. После успешного завершения коммита данные отправляются в магазин для обработки. Вы можете продолжать отслеживать ход отправки с помощью предыдущего метода или посетить Центр партнеров.

{
  "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."
}

{
  "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"
  },
}