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

Создание сущности обновления продукта для клиента

Вы можете создать сущность обновления продукта, чтобы обновить клиента до определенного семейства продуктов (например, плана Azure) с помощью ресурса ProductUpgradeRequest .

Предпосылки

  • Учетные данные, как описано в разделе Аутентификация в Центре партнеров. Этот сценарий поддерживает проверку подлинности с помощью учетных данных app+User. Следуйте модели безопасного приложения при использовании аутентификации App+User с API Центра партнеров.

  • Идентификатор клиента (customer-tenant-id). Если вы не знаете идентификатор клиента, его можно найти в Центре партнеров, выбрав рабочую область Клиенты, затем клиента из списка, и далее учетную запись. На странице "Учетная запись клиента" найдите идентификатор Майкрософт в разделе Сведения об учетной записи клиента. Идентификатор Microsoft совпадает с идентификатором клиента (customer-tenant-id).

  • Семейство продуктов, до которого вы хотите обновить клиента.

C#

Чтобы обновить клиента до плана Azure, выполните следующие действия.

  1. Создайте объект ProductUpgradesRequest и укажите идентификатор клиента и "Azure" в качестве семейства продуктов.

  2. Используйте коллекцию IAggregatePartner.ProductUpgrades.

  3. Вызовите метод Create и передайте объект ProductUpgradesRequest , который вернет строку заголовка местоположения .

  4. Извлеките upgrade-id из строки заголовка расположения, которую можно использовать для запроса состояния обновления.

// IAggregatePartner partnerOperations;

string selectedCustomerId = "58e2af4f-0ad3-4688-8744-be2357cd939a";

string selectedProductFamily = "Azure";

var productUpgradeRequest = new ProductUpgradesRequest
{
    CustomerId = selectedCustomerId,
    ProductFamily = selectedProductFamily
};

var productUpgradeLocationHeader = partnerOperations.ProductUpgrades.Create(productUpgradeRequest);

var upgradeId = Regex.Split(productUpgradeLocationHeader, "/")[1];

REST-запрос

Синтаксис запроса

Метод Запрос URI
ПОМЕСТИТЬ {baseURL}/v1/productupgrades HTTP/1.1

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

Дополнительные сведения см. в заголовках REST API Центра партнеров.

Основное содержание запроса

Тело запроса должно содержать ресурс ProductUpgradeRequest .

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

POST https://api.partnercenter.microsoft.com/v1/productupgrades HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: c245d5f2-1de3-4ae0-9e42-95e38e3cb8ff
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
MS-PartnerCenter-Application: Partner Center .NET SDK Samples
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 340
Expect: 100-continue
Connection: Keep-Alive
{
  "customerId": "4c721420-72ad-4708-a0a7-371a2f7b0969",
  "productFamily": "Azure"
}

Это важно

По состоянию на июнь 2023 г. последняя версия пакета SDK для .NET для Центра партнеров 3.4.0 теперь архивируется. Вы можете скачать релиз SDK с сайта GitHub, вместе с файлом README, который содержит полезные сведения.

Партнерам рекомендуется продолжать использовать REST API партнёрского центра.

Ответ сервиса REST

В случае успеха ответ содержит заголовок Location с универсальным кодом ресурса (URI), который можно использовать для получения информации о состоянии обновления продукта. Сохраните этот универсальный код ресурса (URI) для использования с другими связанными REST API.

Коды успешного и ошибочного ответа

Каждый ответ содержит код состояния HTTP, указывающий на успешность или сбой и дополнительные сведения об отладке. Используйте средство трассировки сети для чтения этого кода, типа ошибки и дополнительных параметров. Полный список см. в разделе Коды ошибок REST Центра партнеров.

Пример ответа

HTTP/1.1 202 Accepted
Content-Length: 0
Location: productUpgrades/42d075a4-bfe7-43e7-af6d-7c68a57edcb4
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: cb82f7d6-f0d9-44d4-82f9-f6eee6e68390
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525
Date: Thu, 28 Sep 2019 20:35:35 GMT
  • Last updated on