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

Статья
03/07/2025

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

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

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

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

Запрос REST

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

Метод	URI запроса
ПОСТ	{baseURL}/v1/customers/{customer-tenant-id}/products?targetView={targetView} HTTP/1.1

Параметры URI запроса

Имя	Тип	Обязательно	Описание
идентификатор клиента-арендатора	GUID	Да	Это значение представляет собой идентификатор клиента, отформатированный как GUID , который позволяет указать клиента.
целеваяПросмотр	струна	Да	Определяет целевое представление каталога. Поддерживаемые значения: Azure, которая включает все элементы Azure AzureReservations, включающую все элементы резервирования Azure. AzureReservationsVM, которая включает все элементы резервирования виртуальных машин (VM) AzureReservationsSQL, которое включает все элементы резервирования SQL AzureReservationsCosmosDb, которая включает все элементы резервации базы данных Cosmos DB MicrosoftAzure, которая включает элементы для подписок Microsoft Azure (MS-AZR-0145P) и планы для Azure OnlineServices, которая включает все элементы веб-службы. Этот элемент targetView включает в себя коммерческую торговую площадку, традиционные службы на основе лицензий и новые коммерческие службы на основе лицензий. Программное обеспечение, включающее все элементы программного обеспечения SoftwareSUSELinux, который включает в себя все компоненты программного обеспечения SUSE Linux SoftwarePerpetual, включающие все бессрочные элементы программного обеспечения. SoftwareSubscriptions, которая включает все элементы подписки на программное обеспечение Специализированные предложения, которые включают специализированные предложения, которые были доступны некоторым партнерам

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

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

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

Нет.

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

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

GET https://api.partnercenter.microsoft.com/v1/customers/65543400-f8b0-4783-8530-6d35ab8c6801/products?targetView=MicrosoftAzure HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 83643f5e-5dfd-4375-88ed-054412460dc8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

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

Заметка

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

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

GET https://api.partnercenter.microsoft.com/v1/customers/65543400-f8b0-4783-8530-6d35ab8c6801/products?targetView=OnlineServices HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee

Ответ REST

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

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

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

Код состояния HTTP	Код ошибки	Описание
403	400036	Доступ к запрошенной targetView не разрешен.

Пример ответа для Microsoft Azure и плана Azure

HTTP/1.1 200 OK
Content-Length: 1909
Content-Type: application/json; charset=utf-8
MS-CorrelationId: cccc2222-dd33-4444-55ee-666666ffffff
MS-RequestId: ae7288e2-2673-4ad4-8c12-7aad818d5949

{
    "totalCount": 2,
    "items": [
        {
            "id": "MS-AZR-0145P",
            "productId": "9DEA7946-EC2C-441E-9FFD-E3B275F7E838",
            "title": "Microsoft Azure",
            "description": "Azure Cloud Solution Provider offer for Partner and Resellers",
            "minimumQuantity": 1,
            "maximumQuantity": 1,
            "isTrial": false,
            "supportedBillingCycles": [
                "monthly"
            ],
            "purchasePrerequisites": [
                "MicrosoftCloudAgreement"
            ],
            "actions": [
                "Refund"
            ],
            "dynamicAttributes": {
                "isMicrosoftProduct": true,
                "billingType": "usage",
                "category": "Enterprise",
                "isAddon": false,
                "prerequisiteSkus": [],
                "rank": 1413,
                "hasAddOns": false,
                "isAutoRenewable": false,
                "upgradeTargetOffers": null,
                "conversionTargetOffers": [],
                "unitType": "Usage-based",
                "limitUnitOfMeasure": "None",
                "limit": 0,
                "reselleeQualifications": [],
                "resellerQualifications": []
            },
            "links": {
                "availabilities": {
                    "uri": "/products/9DEA7946-EC2C-441E-9FFD-E3B275F7E838/skus/MS-AZR-0145P/availabilities?country=US&targetSegment=Commercial",
                    "method": "GET",
                    "headers": []
                },
                "self": {
                    "uri": "/products/9DEA7946-EC2C-441E-9FFD-E3B275F7E838/skus/MS-AZR-0145P?country=US",
                    "method": "GET",
                    "headers": []
                }
            }
        },
        {
            "id": "0001",
            "productId": "DZH318Z0BPS6",
            "title": "Microsoft Azure plan",
            "description": "Microsoft Azure plan (MS-AZR-0017G)",
            "minimumQuantity": 1,
            "maximumQuantity": 1,
            "isTrial": false,
            "supportedBillingCycles": [
                "one_time"
            ],
            "purchasePrerequisites": [
                "MicrosoftCustomerAgreement"
            ],
            "inventoryVariables": [],
            "provisioningVariables": [],
            "actions": [
                "Refund"
            ],
            "dynamicAttributes": {
                "isMicrosoftProduct": true,
                "pilotProgram": "modernazurepilot"
            },
            "links": {
                "availabilities": {
                    "uri": "/products/DZH318Z0BPS6/skus/0001/availabilities?country=US&targetSegment=Commercial",
                    "method": "GET",
                    "headers": []
                },
                "self": {
                    "uri": "/products/DZH318Z0BPS6/skus/0001?country=US",
                    "method": "GET",
                    "headers": []
                }
            }
        }
    ],
    "links": {
        "self": {
            "uri": "/customers/e2a0c0f3-0f74-4d1c-808c-dfa511481913/products/all/skus?targetView=MicrosoftAzure&targetSegment=Commercial",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
}

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