Obtener una lista de productos (según el cliente)

Artículo
02/01/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 para un cliente existente.

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.
Un id. de cliente (customer-tenant-id). Si no conoce el identificador del cliente, puede buscarlo en el Centro de partners seleccionando el área de trabajo Clientes , luego el cliente de la lista de clientes y, a continuación , Cuenta. En la página Cuenta del cliente, busca el Id. de Microsoft en la sección Información de la cuenta del cliente. El id. de Microsoft es el mismo que el de cliente (customer-tenant-id).

Solicitud REST

Sintaxis de la solicitud

Método	URI de solicitud
POST	{baseURL}/v1/customers/{customer-tenant-id}/products?targetView={targetView} HTTP/1.1

Parámetros de URI de solicitud

Nombre	Type	Obligatorio	Descripción
customer-tenant-id	GUID	Sí	El valor es un elemento customer-tenant-id con formato de GUID, que es un identificador que te permite especificar un cliente.
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. Este targetView incluye marketplace comercial, servicios tradicionales basados en licencias y 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

Encabezado de solicitud

Para obtener más información, consulta Encabezados REST del Centro de partners.

Cuerpo de la solicitud

Ninguno.

Ejemplo de solicitud

Solicite una lista de productos basados en uso de Azure disponibles para un cliente determinado. Los productos de Microsoft Azure (MS-AZR-0145P) y los planes de Azure se devolverán para los clientes en la nube pública:

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: 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 o región para los 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/customers/65543400-f8b0-4783-8530-6d35ab8c6801/products?targetView=OnlineServices HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee

Respuesta REST

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	400036	No se permite el acceso a targetView solicitado.

Ejemplo de respuesta para el plan de Microsoft Azure y Azure

HTTP/1.1 200 OK
Content-Length: 1909
Content-Type: application/json; charset=utf-8
MS-CorrelationId: cccc2222-dd33-4444-55ee-666666ffffff
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"
    }
}

Ejemplo de respuesta para nuevos servicios basados en licencias comerciales