Обновление процента выпуска для отправки тестируемой возможности
Используйте этот метод в 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}/updatepackagerolloutpercentage |
Заголовок запроса
| Верхний колонтитул | Тип | Описание |
|---|---|---|
| Авторизация | строка | Обязательный. Маркер доступа Azure AD в маркере> носителя<формы. |
Параметры запроса
| Имя. | Тип | Описание |
|---|---|---|
| applicationId | строка | Обязательный. Идентификатор приложения, содержащего отправку тестового пакета, с процентом развертывания пакета, который требуется обновить. Дополнительные сведения об идентификаторе Магазина см. в разделе "Просмотр сведений об удостоверении приложения". |
| flightId | строка | Обязательный. Идентификатор тестового пакета, содержащего отправку с процентом развертывания пакета, который требуется обновить. Этот идентификатор доступен в данных ответа для запросов на создание тестового пакета и получение пакетов для приложения. Для полета, созданного в Центре партнеров, этот идентификатор также доступен в URL-адресе страницы тестовой страницы в Центре партнеров. |
| submissionId | строка | Обязательный. Идентификатор отправки с процентом развертывания пакета, который требуется обновить. Этот идентификатор доступен в данных ответа для запросов на создание отправки тестового пакета. Для отправки, созданной в Центре партнеров, этот идентификатор также доступен в URL-адресе страницы отправки в Центре партнеров. |
| percentage | с плавающей запятой | Обязательный. Процент пользователей, которые получат пакет постепенного развертывания. |
Текст запроса
Не предоставляйте текст запроса для этого метода.
Пример запроса
В следующем примере показано, как обновить процент развертывания пакета для отправки тестового пакета.
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243680/updatepackagerolloutpercentage?percentage=25 HTTP/1.1
Authorization: Bearer <your access token>
Response
В следующем примере показан текст ответа JSON для успешного вызова этого метода. Дополнительные сведения о значениях в тексте ответа см. в разделе "Развертывание пакета".
{
"isPackageRollout": true,
"packageRolloutPercentage": 25.0,
"packageRolloutStatus": "PackageRolloutInProgress",
"fallbackSubmissionId": "1212922684621243058"
}
Коды ошибок
Если запрос не может быть выполнен успешно, ответ будет содержать один из следующих кодов ошибок HTTP.
| Код ошибки | Description |
|---|---|
| 404 | Не удалось найти отправку тестового пакета. |
| 409 | Этот код указывает на одну из следующих ошибок:
|