Получение списка продуктов (по странам или регионам)

применимо к: Центр партнеров | Центр партнеров, управляемый 21Vianet | Центр партнеров для Microsoft Cloud для государственных организаций США

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

Необходимые условия

• Учетные данные, как описано в аутентификации в Центре партнеров. Этот сценарий поддерживает аутентификацию как с помощью самостоятельных учетных данных приложения, так и с учетными данными приложения и пользователя.

• Страна или регион.

C#

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

1. Используйте коллекцию IAggregatePartner.Products, чтобы выбрать страну или регион методом ByCountry().

2. Выберите представление каталога с помощью метода ByTargetView().

3. (Необязательно) Выберите область резервирования с помощью метода ByReservationScope().

4. (Необязательно) Выберите целевой сегмент с помощью метода ByTargetSegment().

5. Вызовите метод Get() или GetAsync(), чтобы вернуть коллекцию.

IAggregatePartner partnerOperations;

// Get the products for the specified catalog view.
ResourceCollection<Products> products = partnerOperations.Products.ByCountry("US").ByTargetView("MicrosoftAzure").Get();

// Get the products filtered by target view and target segment.
ResourceCollection<Products> products = partnerOperations.Products.ByCountry("US").ByTargetView("MicrosoftAzure").ByTargetSegment("commercial").Get();

// Get the products for Azure reservations which are applicable to Microsoft Azure (MS-AZR-0145P) subscriptions only.
ResourceCollection<Product> products = partnerOperations.Products.ByCountry("US").ByTargetView("AzureReservations").Get();

// Get the products for Azure reservations which are applicable to Azure plans only.
ResourceCollection<Product> products = partnerOperations.Products.ByCountry("US").ByTargetView("AzureReservations").ByReservationScope("AzurePlan").Get();

Ява

Пакет Java SDK для Центра партнеров можно использовать для управления ресурсами Центра партнеров. Это проект с открытым исходным кодом, поддерживаемый сообществом партнеров и официально не поддерживаемый корпорацией Майкрософт. Вы можете получить помощь от сообщества или сообщить о проблеме на сайте GitHub, если у вас возникла проблема.

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

1. Используйте функцию IAggregatePartner.getProducts, чтобы с помощью функции byCountry() выбрать страну.

2. Выберите представление каталога с помощью функции byTargetView().

3. (Необязательно) Выберите целевой сегмент с помощью функции byTargetSegment().

4. Вызовите функцию get(), чтобы вернуть коллекцию.

// IAggregatePartner partnerOperations;

// Get the products for the specified catalog view.
ResourceCollection<Products> products = partnerOperations.getProducts().byCountry("US").byTargetView("Azure").get();

// Get the products filtered by target view and target segment.
ResourceCollection<Products> products = partnerOperations.getProducts().byCountry("US").byTargetView("Azure").byTargetSegment("commercial").get();

PowerShell

Модуль PowerShell Центра партнеров можно использовать для управления его ресурсами. Это проект с открытым исходным кодом, поддерживаемый сообществом партнеров и официально не поддерживаемый корпорацией Майкрософт. Вы можете получить помощь от сообщества или сообщить о проблеме на сайте GitHub, если у вас возникла проблема.

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

1. Выполните команду get-PartnerProduct.

2. Выберите каталог, указав параметр каталога .

3. (Необязательно) Выберите целевой сегмент, указав параметр сегмента.

Get-PartnerProduct -Catalog 'Azure' -Segment 'commercial'

Запрос REST

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

Параметры URI

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

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

Для получения дополнительной информации см. заголовки REST Центра партнеров.

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

Нет.

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

Продукты по странам

Следуйте этому примеру, чтобы получить список продуктов по странам для подписок Microsoft Azure (MS-AZR-0145P) и планов Azure.

GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=MicrosoftAzure HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

Резервирование виртуальных машин Azure (план Azure)

Следуйте этому примеру, чтобы получить список продуктов по странам для резервирования виртуальных машин Azure, применимых к планам Azure.

GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=AzureAzureReservationsVM&reservationScope=AzurePlan HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

Резервирование виртуальных машин Azure для подписок Microsoft Azure (MS-AZR-0145P)

Следуйте этому примеру, чтобы получить список продуктов по странам для резервирования виртуальных машин Azure, применимых к подпискам Microsoft Azure (MS-AZR-0145P).

GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=AzureReservationsVM HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

Новые коммерческие службы на основе лицензий

Следуйте этому примеру, чтобы получить список продуктов по странам для новых лицензионных коммерческих услуг в рамках технического предварительного просмотра нового коммерческого опыта. Новые коммерческие службы на основе лицензий будут определяться по идентификатору и значениям displayNames OnlineServicesNCE. См. пример ответа ниже.

GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=OnlineServices HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

Ответ REST

В случае успеха текст ответа содержит коллекцию ресурсов Продукт.

Коды успешных ответов и ошибок

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

Этот метод возвращает следующие коды ошибок:

Пример ответа для резервирования виртуальных машин Azure (план Azure)

{
    "totalCount": 19,
    "items": [
        {
            "id": "DZH318Z0BQ3Q",
            "title": "Virtual Machines DSv2 Series",
            "description": "Dsv2-series instances are the latest generation of D-series instances that will carry more powerful CPUs which are on average about 35% faster than D-series instances, and carry the same memory and disk configurations as the D-series. Dsv2-series instances are based on the latest generation 2.4 GHz Intel Xeon® E5-2673 v3 (Haswell) processor, and with Intel Turbo Boost Technology 2.0 can go to 3.2 GHz.",
            "productType": {
                "id": "Azure",
                "displayName": "Azure",
                "subType": {
                "id": "VirtualMachines",
                "displayName": "VirtualMachines"
                }
            },
            "isMicrosoftProduct": true,
            "publisherName": "Microsoft",
            "links": {
                "skus": {
                    "uri": "/products/DZH318Z0BQ3Q/skus?country=US",
                    "method": "GET",
                    "headers": []
                },
                "self": {
                    "uri": "/products/DZH318Z0BQ3Q?country=US",
                    "method": "GET",
                    "headers": []
                }
            }
        },
        ...
    ],
    "links": {
        "self": {
            "uri": "/products?country=US&targetView=Azure",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
}

Пример ответа для новых лицензируемых коммерческих услуг

{
  "totalCount": 19,
  "items": [{
      "id": "CFQ7TTC0LH18",
      "title": "Microsoft 365 Business Basic",
      "description": "Best for businesses that need professional email, cloud file storage, and online meetings & chat. Desktop versions of Office apps like Excel, Word, and PowerPoint not included. For businesses with up to 300 employees.",
      "productType": {
        "id": "OnlineServicesNCE",
        "displayName": "OnlineServicesNCE"
      },
      "isMicrosoftProduct": true,
      "publisherName": "Microsoft Corporation",
      "links": {
        "skus": {
          "uri": "/products/CFQ7TTC0LH18/skus?country=US",
          "method": "GET",
          "headers": []
        },
        "self": {
          "uri": "/products/CFQ7TTC0LH18?country=US",
          "method": "GET",
          "headers": []
        }
      }
    },
    ...
  ],
  "links": {
    "self": {
      "uri": "/products?country=US&targetView=OnlineServices",
      "method": "GET",
      "headers": []
    }
  },
  "attributes": {
    "objectType": "Collection"
  }
}