Получить продукт по идентификатору

Статья
03/08/2025

Возвращает указанный ресурс продукта с помощью идентификатора продукта.

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

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

C#

Чтобы найти определенный продукт по идентификатору, используйте коллекцию IAggregatePartner.Products, выберите страну с помощью метода byCountry(), а затем вызовите метод ById(). Наконец, вызовите метод Get() или GetAsync(), чтобы вернуть продукт.

// IAggregatePartner partnerOperations;

Product productDetail = partnerOperations.Products.ByCountry("US").ById("DZH318Z0BQ3Q").Get();

Ява

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

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

// IAggregatePartner partnerOperations;

Product productDetail = partnerOperations.getProducts().byCountry("US").byId("DZH318Z0BQ3Q").get();

PowerShell

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

Чтобы найти определенный продукт по идентификатору, выполните команду get-PartnerProductи укажите параметр ProductId. Параметр CountryCode — это параметры, если он не указан, будет использоваться страна, связанная с торговым посредником.

Get-PartnerProduct -ProductId 'DZH318Z0BQ3Q'

Запрос REST

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

Метод	URI запроса
GET	{baseURL}/v1/products/{product-id}?country={country} HTTP/1.1

Параметр URI

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

Имя	Тип	Обязательно	Описание
идентификатор продукта	струна	Да	Строка, определяющая продукт.
страна	струна	Да	Идентификатор страны или региона.

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

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

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

Отсутствует.

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

GET https://api.partnercenter.microsoft.com/v1/products/{product-id}?country=US 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	Код ошибки	Описание
404	400013	Продукт не найден.

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

HTTP/1.1 200 OK
Content-Length: 1918
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: ac943950-ba3d-47a0-bd2a-c5617a7fefe8
Date: Tue, 23 Jan 2018 23:13:01 GMT

{
    "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&reg; 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": []
        }
    }
}

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

Заметка

Новые коммерческие возможности для служб на основе лицензий включают множество новых возможностей и доступны для всех поставщиков облачных решений (CSPS). Дополнительные сведения см. в обзор новых коммерческих возможностей.

{
    "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": []
        }
    }
}

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