Получение списка продуктов (по странам или регионам)
Область применения: Центр партнеров | Центр партнеров, управляемый 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.
Чтобы получить список продуктов, выполните следующие действия.
Выберите каталог, указав параметр каталога .
(Необязательно) Выберите целевой сегмент, указав параметр 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: 7c1f6619-c176-4040-a88f-2c71f3ba4533
Резервирования виртуальных машин 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: 7c1f6619-c176-4040-a88f-2c71f3ba4533
Резервирования виртуальных машин 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: 7c1f6619-c176-4040-a88f-2c71f3ba4533
Новые коммерческие службы на основе лицензий
Примечание.
Новые возможности коммерческой торговли для служб на основе лицензий включают множество новых возможностей и доступны для всех поставщик облачных решений (ПОСТАВЩИКОВ УСЛУГ). Дополнительные сведения см . в обзоре новых коммерческих возможностей.
Следуйте этому примеру, чтобы получить список продуктов по странам для новых коммерческих служб на основе лицензий в рамках новой коммерческой предварительной версии. Новые коммерческие службы на основе лицензий будут определены по идентификатору и значениям 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: 7c1f6619-c176-4040-a88f-2c71f3ba4533
Ответ 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"
}
}
Кері байланыс
Жақында қолжетімді болады: 2024 жыл бойы біз GitHub Issues жүйесін мазмұнға арналған кері байланыс механизмі ретінде біртіндеп қолданыстан шығарамыз және оны жаңа кері байланыс жүйесімен ауыстырамыз. Қосымша ақпаратты мұнда қараңыз: https://aka.ms/ContentUserFeedback.
Жіберу және пікірді көру