Obtener una lista de productos (según el país)Get a list of products (by country)

Se aplica a:Applies to:

  • Centro de partnersPartner Center
  • Centro de partners operado por 21VianetPartner Center operated by 21Vianet
  • Centro de partners para Microsoft Cloud AlemaniaPartner Center for Microsoft Cloud Germany
  • Centro de partners para Microsoft Cloud for US GovernmentPartner Center for Microsoft Cloud for US Government

Puede usar los métodos siguientes para obtener una colección de productos disponibles en un país determinado.You can use the following methods to get a collection of products available in a particular country.

Requisitos previosPrerequisites

  • Credenciales tal como se describen en el artículo Autenticación del Centro de partners.Credentials as described in Partner Center authentication. Este escenario admite la autenticación con las credenciales de aplicación y aplicación independientes.This scenario supports authentication with both standalone App and App+User credentials.

  • Un país.A country.

C#C#

Para obtener una lista de productos:To get a list of products:

  1. Use la colección colección iaggregatepartner. Products para seleccionar el país mediante el método ByCountry () .Use your IAggregatePartner.Products collection to select the country by using the ByCountry() method.

  2. Seleccione la vista de catálogo mediante el método ByTargetView () .Select the catalog view using the ByTargetView() method.

  3. Opta Seleccione el ámbito de reserva mediante el método ByReservationScope () .(Optional) Select the reservation scope using the ByReservationScope() method.

  4. Opta Seleccione el segmento de destino mediante el método ByTargetSegment () .(Optional) Select the target segment using the ByTargetSegment() method.

  5. Llame al método get () o GetAsync () para devolver la colección.Call the Get() or GetAsync() method to return the collection.

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();

JavaJava

Los partners suelen usar el SDK de Java del Centro de partners para administrar los recursos del Centro de partners.The Partner Center Java SDK is commonly used by partners to manage their Partner Center resources. Se trata de un proyecto de código abierto que mantiene la comunidad de partners.It's an open-source project maintained by the partner community. Dado que este módulo lo mantiene la comunidad de partners, Microsoft no lo admite oficialmente.Since this module is maintained by the partner community, it isn't officially supported by Microsoft. Puedes obtener ayuda de la comunidad o abrir una incidencia en GitHub si se produce un problema.You can get help from the community or open an issue on GitHub if you experience a problem.

Para obtener una lista de productos:To get a list of products:

  1. Use la función colección iaggregatepartner. getProducts para seleccionar el país mediante la función byCountry () .Use your IAggregatePartner.getProducts function to select the country by using the byCountry() function.

  2. Seleccione la vista de catálogo mediante la función byTargetView () .Select the catalog view using the byTargetView() function.

  3. Opta Seleccione el segmento de destino mediante la función byTargetSegment () .(Optional) Select the target segment using the byTargetSegment() function.

  4. Llame a la función get () para devolver la colección.Call the get() function to return the collection.

// 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();

PowerShellPowerShell

Los partners suelen usar el módulo de PowerShell del Centro de partners para administrar los recursos del Centro de partners.The Partner Center PowerShell module is commonly used by partners to manage their Partner Center resources. Se trata de un proyecto de código abierto que mantiene la comunidad de partners.It's an open-source project maintained by the partner community. Dado que este módulo lo mantiene la comunidad de partners, Microsoft no lo admite oficialmente.Since this module is maintained by the partner community, it isn't officially supported by Microsoft. Puedes obtener ayuda de la comunidad o abrir una incidencia en GitHub si se produce un problema.You can get help from the community or open an issue on GitHub if you experience a problem.

Para obtener una lista de productos:To get a list of products:

  1. Ejecute el comando Get-PartnerProduct .Execute the Get-PartnerProduct command.

  2. Seleccione el catálogo especificando el parámetro de Catálogo .Select the catalog by specifying the Catalog parameter.

  3. Opta Seleccione el segmento de destino especificando el parámetro Segment .(Optional) Select the target segment by specifying the Segment parameter.

Get-PartnerProduct -Catalog 'Azure' -Segment 'commercial'

Solicitud RESTREST request

Sintaxis de la solicitudRequest syntax

MétodoMethod URI de la solicitudRequest URI
GETGET {baseurl}/v1/Products? Country = {country} &targetView = {targetView} &targetSegment = {TARGETSEGMENT} http/1.1{baseURL}/v1/products?country={country}&targetView={targetView}&targetSegment={targetSegment} HTTP/1.1

Parámetros de URIURI parameters

Use la ruta de acceso y los parámetros de consulta siguientes para obtener una lista de productos.Use the following path and query parameters to get a list of products.

NombreName TipoType ObligatorioRequired DescripciónDescription
countrycountry stringstring Yes El id. del país o región.The country/region ID.
targetViewtargetView stringstring Yes Identifica la vista de destino del catálogo.Identifies the target view of the catalog. Los valores admitidos son:The supported values are:
  • Azure, que incluye todos los elementos de AzureAzure, which includes all Azure items
  • AzureReservations, que incluye todos los elementos de reserva de AzureAzureReservations, which includes all Azure reservation items
  • AzureReservationsVM, que incluye todos los elementos de reserva de la máquina virtual (VM)AzureReservationsVM, which includes all virtual machine (VM) reservation items
  • AzureReservationsSQL, que incluye todos los elementos de reserva de SQLAzureReservationsSQL, which includes all SQL reservation items
  • AzureReservationsCosmosDb, que incluye todos los elementos de reserva de base de datos cosmosAzureReservationsCosmosDb, which includes all Cosmos database reservation items
  • MicrosoftAzure, que incluye elementos para suscripciones Microsoft Azure (MS-AZR-0145P) y planes de AzureMicrosoftAzure, which includes items for Microsoft Azure subscriptions (MS-AZR-0145P) and Azure plans
  • OnlineServices, que incluye todos los elementos de servicio en línea (incluidos los productos de Marketplace comerciales)OnlineServices, which includes all online service items (including commercial marketplace products)
  • Software, que incluye todos los elementos de softwareSoftware, which includes all software items
  • SoftwareSUSELinux, que incluye todos los elementos de software de SUSE LinuxSoftwareSUSELinux, which includes all software SUSE Linux items
  • SoftwarePerpetual, que incluye todos los elementos de software perpetuosSoftwarePerpetual, which includes all perpetual software items
  • SoftwareSubscriptions, que incluye todos los elementos de suscripción de softwareSoftwareSubscriptions, which includes all software subscription items
targetSegmenttargetSegment stringstring NoNo Identifica el segmento de destino.Identifies the target segment. La vista para diferentes audiencias de destino.The view for different target audiences. Los valores admitidos son:The supported values are:
  • actividadcommercial
  • universitariaeducation
  • administrativogovernment
  • sin ánimononprofit
reservationScopereservationScope stringstring NoNo Al consultar una lista de productos de Azure Reservations, especifique reservationScope=AzurePlan para obtener una lista de los productos que se pueden aplicar a los planes de Azure.When querying for a list of products for Azure Reservations, specify reservationScope=AzurePlan to get a list of products that are applicable to Azure plans. Excluya este parámetro para obtener una lista de productos para las reservas de Azure, que son aplicables a las suscripciones de Microsoft Azure (MS-AZR-0145P).Exclude this parameter to get a list of products for Azure reservations, which are applicable to Microsoft Azure (MS-AZR-0145P) subscriptions.

Encabezados de solicitudRequest headers

Para obtener más información, consulta Encabezados REST del Centro de partners.For more information, see Partner Center REST headers.

Cuerpo de la solicitudRequest body

Ninguno.None.

Ejemplos de solicitudRequest examples

Productos por paísProducts by country

Siga este ejemplo para obtener una lista de productos por país para las suscripciones de Microsoft Azure (MS-AZR-0145P) y los planes de Azure.Follow this example to get a list of products by country for Microsoft Azure (MS-AZR-0145P) subscriptions and Azure plans.

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)Azure VM reservations (Azure plan)

Siga este ejemplo para obtener una lista de productos por país para las reservas de máquinas virtuales de Azure que se aplican a los planes de Azure.Follow this example to get a list of products by country for Azure VM reservations that are applicable to Azure plans.

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)Azure VM reservations for Microsoft Azure (MS-AZR-0145P) subscriptions

Siga este ejemplo para obtener una lista de productos por país para las reservas de máquinas virtuales de Azure que se aplican a las suscripciones de Microsoft Azure (MS-AZR-0145P).Follow this example to get a list of products by country for Azure VM reservations that are applicable to Microsoft Azure (MS-AZR-0145P) subscriptions.

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

Respuesta RESTREST response

Si se realiza correctamente, el cuerpo de la respuesta contiene una colección de recursos del producto .If successful, the response body contains a collection of Product resources.

Códigos de error y de respuesta correctosResponse success and error codes

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.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales.Use a network trace tool to read this code, error type, and additional parameters. Para obtener la lista completa, consulte códigos de error del centro de Partners.For the full list, see Partner Center error codes.

Este método devuelve los siguientes códigos de error:This method returns the following error codes:

Código de estado HTTPHTTP Status Code Código de errorError code DescripciónDescription
403403 400030400030 No se permite el acceso a la targetSegment solicitada.Access to the requested targetSegment is not allowed.
403403 400036400036 No se permite el acceso a la targetView solicitada.Access to the requested targetView is not allowed.

Ejemplo de respuestaResponse example

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