Obtener una lista de productos (según el país o región)
Se aplica a: Centro de partners | Centro de partners operado por 21Vianet | Centro de partners para Microsoft Cloud for US Government
Puede usar los métodos siguientes para obtener una colección de productos disponibles en un país o región concretos.
Requisitos previos
Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación con credenciales de aplicación independiente y app+usuario.
País o región.
C#
Para obtener una lista de productos:
Use la colección IAggregatePartner.Products para seleccionar el país o región mediante el método ByCountry().
Seleccione la vista de catálogo mediante el método ByTargetView().
(Opcional) Seleccione el ámbito de reserva mediante el método ByReservationScope().
(Opcional) Seleccione el segmento de destino mediante el método ByTargetSegment().
Llame al método Get() o GetAsync() para devolver la colección.
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
El SDK de Java del Centro de partners se puede usar para administrar los recursos del Centro de partners. Es un proyecto de código abierto mantenido por la comunidad de partners y no es compatible oficialmente con Microsoft. Puedes obtener ayuda de la comunidad o abrir una incidencia en GitHub si se produce un problema.
Para obtener una lista de productos:
Use la función IAggregatePartner.getProducts para seleccionar el país mediante la función byCountry().
Seleccione la vista de catálogo mediante la función byTargetView().
(Opcional) Seleccione el segmento de destino mediante la función byTargetSegment().
Llame a la función get() para devolver la colección.
// 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
El módulo de PowerShell del Centro de partners se puede usar para administrar los recursos del Centro de partners. Es un proyecto de código abierto mantenido por la comunidad de partners y no es compatible oficialmente con Microsoft. Puedes obtener ayuda de la comunidad o abrir una incidencia en GitHub si se produce un problema.
Para obtener una lista de productos:
Ejecute el comando Get-PartnerProduct.
Seleccione el catálogo especificando el parámetro Catalog .
(Opcional) Seleccione el segmento de destino especificando el parámetro Segment .
Get-PartnerProduct -Catalog 'Azure' -Segment 'commercial'
Solicitud REST
Sintaxis de la solicitud
| Método | URI de solicitud |
|---|---|
| GET | {baseURL}/v1/products?country={country}&targetView={targetView}&targetSegment={targetSegment} HTTP/1.1 |
Parámetros del identificador URI
Use la siguiente ruta de acceso y parámetros de consulta para obtener una lista de productos.
| Nombre | Type | Obligatorio | Descripción |
|---|---|---|---|
| country | string | Sí | El id. del país o región. |
| targetView | string | Sí | Identifica la vista de destino del catálogo. Los valores admitidos son: Azure, que incluye todos los elementos de Azure AzureReservations, que incluye todos los elementos de reserva de Azure AzureReservationsVM, que incluye todos los elementos de reserva de máquina virtual (VM) AzureReservationsSQL, que incluye todos los elementos de reserva de SQL AzureReservationsCosmosDb, que incluye todos los elementos de reserva de base de datos de Cosmos MicrosoftAzure, que incluye elementos para suscripciones de Microsoft Azure (MS-AZR-0145P) y planes de Azure OnlineServices, que incluye todos los elementos de servicio en línea, como los servicios tradicionales basados en licencias y los nuevos servicios basados en licencias comerciales. Software, que incluye todos los elementos de software SoftwareSUSELinux, que incluye todos los elementos de SUSE Linux de software SoftwarePerpetual, que incluye todos los elementos de software perpetuo SoftwareSubscriptions, que incluye todos los elementos de suscripción de software SpecializedOffers, que incluye ofertas especializadas que se han puesto a disposición de algunos asociados MarketplaceSaaS, que incluye todas las ofertas de marketplace comercial publicadas por proveedores de software independientes (ISV) |
| targetSegment | string | No | Identifica el segmento de destino. Vista para diferentes audiencias de destino. Los valores admitidos son: Comercial education government Lucro |
| reservationScope | string | No | Al consultar una lista de productos para Azure Reservations, especifique reservationScope=AzurePlan para obtener una lista de productos que son aplicables a los planes de Azure. Excluya este parámetro para obtener una lista de productos para reservas de Azure, que son aplicables a las suscripciones de Microsoft Azure (MS-AZR-0145P). |
Encabezados de solicitud
Para obtener más información, consulta Encabezados REST del Centro de partners.
Cuerpo de la solicitud
Ninguno.
Ejemplos de solicitud
Productos por país
Siga este ejemplo para obtener una lista de productos por país para suscripciones de Microsoft Azure (MS-AZR-0145P) y planes de 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
Reservas de máquinas virtuales de Azure (plan de Azure)
Siga este ejemplo para obtener una lista de productos por país para las reservas de máquinas virtuales de Azure que son aplicables a los planes de 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
Reservas de máquinas virtuales de Azure para suscripciones de Microsoft Azure (MS-AZR-0145P)
Siga este ejemplo para obtener una lista de productos por país para las reservas de máquinas virtuales de Azure que son aplicables a las suscripciones de 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
Nuevos servicios basados en licencias comerciales
Nota:
Las nuevas experiencias comerciales para los servicios basados en licencias incluyen muchas funcionalidades nuevas y están disponibles para todos los Proveedores de soluciones en la nube (CSP). Para más información, consulte Introducción a las nuevas experiencias comerciales.
Siga este ejemplo para obtener una lista de productos por país para nuevos servicios basados en licencias comerciales como parte de la nueva experiencia comercial Technical Preview. Los nuevos servicios basados en licencias comerciales se identificarán mediante los valores id. y displayNames de OnlineServicesNCE. Consulte el ejemplo de respuesta siguiente.
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
Respuesta REST
Si se ejecuta correctamente, el cuerpo de la respuesta contiene una colección de recursos product.
Códigos de error y de respuesta correctos
Cada respuesta incluye un código de estado HTTP que indica si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales. Para obtener la lista completa, consulte Códigos de error del Centro de partners.
Este método devuelve los siguientes códigos de error:
| Código de estado HTTP | Código de error | Descripción |
|---|---|---|
| 403 | 400030 | No se permite el acceso al targetSegment solicitado. |
| 403 | 400036 | No se permite el acceso a targetView solicitado. |
Ejemplo de respuesta para reservas de máquinas virtuales de Azure (plan de 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"
}
}
Ejemplo de respuesta para nuevos servicios basados en licencias comerciales
Nota:
Las nuevas experiencias comerciales para los servicios basados en licencias incluyen muchas funcionalidades nuevas y están disponibles para todos los Proveedores de soluciones en la nube (CSP). Para más información, consulte Introducción a las nuevas experiencias comerciales.
{
"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"
}
}
Comentaris
Properament: al llarg del 2024 eliminarem gradualment GitHub Issues com a mecanisme de retroalimentació del contingut i el substituirem per un nou sistema de retroalimentació. Per obtenir més informació, consulteu: https://aka.ms/ContentUserFeedback.
Envieu i consulteu els comentaris de