Поделиться через

Завершение выпуска для отправки тестируемой возможности

  • Статья

Используйте этот метод в API отправки Microsoft Store, чтобы завершить развертывание пакета для отправки тестового пакета. Дополнительные сведения о процессе создания отправки тестового пакета с помощью API отправки пакета в Microsoft Store см. в статье "Управление отправкой тестового пакета".

Необходимые компоненты

Чтобы использовать этот метод, сначала необходимо выполнить следующие действия:

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

Запросить

Этот метод имеет следующий синтаксис. В следующих разделах приведены примеры использования и описания параметров заголовка и запроса.

Способ URI запроса
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/finalizepackagerollout

Заголовок запроса

Верхний колонтитул Тип Описание
Авторизация строка Обязательный. Маркер доступа Azure AD в маркере> носителя<формы.

Параметры запроса

Имя. Тип Описание
applicationId строка Обязательный. Идентификатор приложения, содержащего отправку тестового пакета, с развертыванием пакета, который требуется завершить. Дополнительные сведения об идентификаторе Магазина см. в разделе "Просмотр сведений об удостоверении приложения".
flightId строка Обязательный. Идентификатор тестового пакета, содержащего отправку с развертыванием пакета, который требуется завершить. Этот идентификатор доступен в данных ответа для запросов на создание тестового пакета и получение пакетов для приложения. Для полета, созданного в Центре партнеров, этот идентификатор также доступен в URL-адресе страницы полета в Центре партнеров.
submissionId строка Обязательный. Идентификатор отправки с развертыванием пакета, который требуется завершить. Этот идентификатор доступен в данных ответа для запросов на создание отправки тестового пакета. Для отправки, созданной в Центре партнеров, этот идентификатор также доступен в URL-адресе страницы отправки в Центре партнеров.

Текст запроса

Не предоставляйте текст запроса для этого метода.

Пример запроса

В следующем примере показано, как завершить развертывание пакета для отправки тестового пакета.

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

Response

В следующем примере показан текст ответа JSON для успешного вызова этого метода. Дополнительные сведения о значениях в тексте ответа см. в разделе "Развертывание пакета".

{
    "isPackageRollout": true,
    "packageRolloutPercentage": 100.0,
    "packageRolloutStatus": "PackageRolloutComplete",
    "fallbackSubmissionId": "1212922684621243058"
}

Коды ошибок

Если запрос не может быть выполнен успешно, ответ будет содержать один из следующих кодов ошибок HTTP.

Код ошибки Description
404 Не удалось найти отправку тестового пакета.
409 Этот код указывает на одну из следующих ошибок:

  • Отправка не находится в допустимом состоянии для постепенной операции развертывания (перед вызовом этого метода отправка должна быть опубликована, а значение packageRolloutStatus должно иметь значение PackageRolloutInProgress).
  • Отправка не принадлежит указанному приложению.
  • Приложение использует функцию Центра партнеров, которая в настоящее время не поддерживается API отправки Microsoft Store.