Obtener una lista de productos (según el país o región)

Artículo
09/27/2024

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 de 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 sin ánimo de 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: aaaa0000-bb11-2222-33cc-444444dddddd

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: aaaa0000-bb11-2222-33cc-444444dddddd

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: aaaa0000-bb11-2222-33cc-444444dddddd

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: aaaa0000-bb11-2222-33cc-444444dddddd

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:

{
  "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"
  }
}

Compartir vía

Obtener una lista de productos (según el país o región)

Requisitos previos

C#

Java

PowerShell

Solicitud REST

Sintaxis de la solicitud

Parámetros de URI

Encabezados de solicitud

Cuerpo de la solicitud

Ejemplos de solicitud

Productos por país

Reservas de máquinas virtuales de Azure (plan de Azure)

Reservas de máquinas virtuales de Azure para suscripciones de Microsoft Azure (MS-AZR-0145P)

Nuevos servicios basados en licencias comerciales

Respuesta REST

Códigos de error y de respuesta correctos

Ejemplo de respuesta para reservas de máquinas virtuales de Azure (plan de Azure)

Ejemplo de respuesta para nuevos servicios basados en licencias comerciales

Comentarios

Recursos adicionales