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

Статья
09/27/2024

Область применения: Центр партнеров | Центр партнеров, управляемый 21Vianet | Центр партнеров для Microsoft Cloud for US Government

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

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

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

C#

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

Используйте коллекцию IAggregatePartner.Products, чтобы выбрать страну или регион с помощью метода ByCountry().
Выберите представление каталога с помощью метода ByTargetView().
(Необязательно) Выберите область резервирования с помощью метода ByReservationScope().
(Необязательно) Выберите целевой сегмент с помощью метода ByTargetSegment( ).
Вызовите метод 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 для Java центра партнеров можно использовать для управления ресурсами Центра партнеров. Это проект с открытым исходным кодом, поддерживаемый сообществом партнеров и официально не поддерживаемый корпорацией Майкрософт. При необходимости вы можете получить помощь от сообщества или опубликовать проблему в GitHub.

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

Используйте функцию IAggregatePartner.getProducts, чтобы выбрать страну с помощью функции byCountry().
Выберите представление каталога с помощью функции byTargetView().
(Необязательно) Выберите целевой сегмент с помощью функции byTargetSegment( ).
Вызовите функцию 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.

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

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

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

Запрос REST

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

Способ	URI запроса
GET	{baseURL}/v1/products?country={country}&targetView={targetView}&targetSegment={targetSegment} HTTP/1.1

Параметры универсального кода ресурса (URI)

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

Имя.	Type	Обязательно	Описание
country	string	Да	Идентификатор страны или региона.
targetView	строка	Да	Определяет целевое представление каталога. Поддерживаемые значения: Azure, включающая все элементы Azure AzureReservations, который включает все элементы резервирования Azure AzureReservationsVM, который включает все элементы резервирования виртуальных машин AzureReservationsSQL, который включает все элементы резервирования SQL AzureReservationsCosmosDb, который включает все элементы резервирования базы данных Cosmos MicrosoftAzure, который включает элементы для подписок Microsoft Azure (MS-AZR-0145P) и планов Azure OnlineServices, который включает все элементы веб-службы, такие как традиционные службы на основе лицензий и новые коммерческие службы на основе лицензий. Программное обеспечение, которое включает все элементы программного обеспечения SoftwareSUSELinux, который включает все элементы SUSE Linux программного обеспечения SoftwarePerpetual, включающее все элементы программного обеспечения. SoftwareSubscriptions, включающее все элементы подписки на программное обеспечение Специализированныеoffers, которые включают специализированные предложения, которые были доступны некоторым партнерам MarketplaceSaaS, который включает все коммерческие предложения marketplace, опубликованные независимыми поставщиками программного обеспечения (ISV)
targetSegment	строка	Нет	Определяет целевой сегмент. Представление для разных целевых аудиторий. Поддерживаемые значения: торговый образование правительство некоммерческий
резервированиеScope	строка	Нет	При запросе списка продуктов для резервирования Azure укажите `reservationScope=AzurePlan` , чтобы получить список продуктов, применимых к планам Azure. Исключите этот параметр, чтобы получить список продуктов для резервирований Azure, которые применимы к подпискам Microsoft Azure (MS-AZR-0145P).

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

Дополнительные сведения см. в статье о заголовках 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

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

Примечание.

Новые возможности коммерческой торговли для служб на основе лицензий включают множество новых возможностей и доступны для всех поставщик облачных решений (ПОСТАВЩИКОВ УСЛУГ). Дополнительные сведения см . в обзоре новых коммерческих возможностей.

Следуйте этому примеру, чтобы получить список продуктов по странам для новых коммерческих служб на основе лицензий в рамках новой коммерческой предварительной версии. Новые коммерческие службы на основе лицензий будут определены по идентификатору и значениям displayNamesNCE 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

В случае успешного выполнения текст ответа содержит коллекцию ресурсов Product .

Коды успешного выполнения и ошибок в ответе

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

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

Код состояния HTTP	Код ошибки	Description
403	400030	Доступ к запрошенной целиSegment запрещен.
403	400036	Доступ к запрошенной целевой области не разрешен.

Пример ответа для резервирования виртуальных машин 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"
  }
}

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

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

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

C#

Java

PowerShell

Запрос REST

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

Параметры универсального кода ресурса (URI)

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

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

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

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

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

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

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

Ответ REST

Коды успешного выполнения и ошибок в ответе

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

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

Обратная связь

Дополнительные ресурсы