Получение сведений о продукте по идентификатору

Статья
01/31/2024

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

Предварительные условия

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

C#

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

// IAggregatePartner partnerOperations;

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

Java

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

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

// IAggregatePartner partnerOperations;

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

PowerShell

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

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

Get-PartnerProduct -ProductId 'DZH318Z0BQ3Q'

Запрос REST

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

Метод	Универсальный код ресурса (URI) запроса
GET	{baseURL}/v1/products/{product-id}?country={country} HTTP/1.1

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

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

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

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

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

Тело запроса

Нет.

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

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: 7c1f6619-c176-4040-a88f-2c71f3ba4533

Ответ REST

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

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

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

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

Код состояния HTTP	Код ошибки	Описание
404	400013	Продукт не найден.

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

HTTP/1.1 200 OK
Content-Length: 1918
Content-Type: application/json
MS-CorrelationId: 7c1f6619-c176-4040-a88f-2c71f3ba4533
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": []
        }
    }
}

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

Примечание

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

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

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