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

Получение состояния отправки тестового пакета

  • Статья

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

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

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

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

Запросить

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

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

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

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

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

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

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

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

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

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

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>

Response

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

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

Текст ответа

Значение Тип Описание
статус строка Состояние отправки. Это может быть одно из следующих значений:
  • нет
  • Отмененные
  • ОжиданиеCommit
  • CommitStarted
  • CommitFailed
  • Ожидание публикации
  • Публикация
  • Опубликованные
  • PublishFailed
  • Предварительная обработка
  • PreProcessingFailed
  • Сертификация
  • CertificationFailed
  • Выпуск
  • ReleaseFailed
statusDetails объект Содержит дополнительные сведения о состоянии отправки, включая сведения об ошибках. Дополнительные сведения см . в ресурсе сведений о состоянии.

Коды ошибок

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

Код ошибки Description
404 Не удалось найти отправку.
409 Приложение использует функцию Центра партнеров, которая в настоящее время не поддерживается API отправки Microsoft Store.