Obtener una lista de productos (según el cliente)Get a list of products (by customer)

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 para un cliente existente.You can use the following methods to get a collection of products for an existing customer.

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 id. de cliente (customer-tenant-id).A customer ID (customer-tenant-id). Si no conoces el identificador del cliente, puedes buscarlo en el panel del Centro de partners.If you don't know the customer's ID, you can look it up in the Partner Center dashboard. Selecciona CSP en el menú del Centro de partners, seguido de Clientes.Select CSP from the Partner Center menu, followed by Customers. En la lista de clientes, selecciona el cliente y, a continuación, elige Cuenta.Select the customer from the customer list, then select Account. En la página Cuenta del cliente, busca el Id. de Microsoft en la sección Información de la cuenta del cliente.On the customer’s Account page, look for the Microsoft ID in the Customer Account Info section. El identificador de Microsoft es el mismo que el de cliente (customer-tenant-id).The Microsoft ID is the same as the customer ID (customer-tenant-id).

Solicitud RESTREST request

Sintaxis de la solicitudRequest syntax

MétodoMethod URI de solicitudRequest URI
POSTPOST * { baseurl } */v1/customers/{customer-tenant-ID}/Products? targetView = {targetView} http/1.1{baseURL}/v1/customers/{customer-tenant-id}/products?targetView={targetView} HTTP/1.1

Parámetros de URI de solicitudRequest URI parameters

NombreName TipoType ObligatorioRequired DescripciónDescription
customer-tenant-idcustomer-tenant-id GUIDGUID Yes El valor es un elemento customer-tenant-id con formato de GUID, que es un identificador que te permite especificar un cliente.The value is a GUID-formatted customer-tenant-id, which is an identifier that allows you to specify a customer.
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 comerciales de MarketplaceOnlineServices, 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

Encabezado de la solicitudRequest header

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.

Ejemplo de solicitudRequest example

Solicite una lista de productos basados en el uso de Azure disponibles para un cliente determinado.Request for a list of Azure usage-based products available to a given customer. Los productos de Microsoft Azure (MS-AZR-0145P) y los planes de Azure se devolverán para los clientes de la nube pública:Products for both Microsoft Azure (MS-AZR-0145P) and Azure plans will be returned for customers in public cloud:

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: b1939cb2-e83d-4fb0-989f-514fb741b734

Respuesta de RESTRest response

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 400036400036 No se permite el acceso a la targetView solicitada.Access to the requested targetView is not allowed.

Ejemplo de respuestaResponse example

HTTP/1.1 200 OK
Content-Length: 1909
Content-Type: application/json; charset=utf-8
MS-CorrelationId: cad955c2-8efc-47fe-b112-548ff002ba18
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"
    }
}