Comprobación de la idoneidad de un cliente para actualizar a un plan de AzureCheck a customer's eligibility for upgrading to an Azure plan

Se aplica a:Applies to:

  • Centro de partnersPartner Center

Puede usar el recurso ProductUpgradeRequest para comprobar si un cliente es apto para la actualización a un plan de Azure desde una suscripción de Microsoft Azure (MS-AZR-0145P). este método devuelve un recurso ProductUpgradesEligibility con la idoneidad de la actualización del producto del cliente.You can use the ProductUpgradeRequest resource to check if a customer is eligible to upgrade to an Azure plan from a Microsoft Azure (MS-AZR-0145P) subscription This method returns a ProductUpgradesEligibility resource with the customer's product upgrade eligibility.

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 credenciales de aplicación y usuario.This scenario supports authentication with App+User credentials. Siga el modelo de aplicación segura al usar la autenticación de usuario y aplicación con las API del centro de Partners.Follow the secure app model when using App+User authentication with Partner Center APIs.

  • 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).

  • Familia de productos.The product family.

C#C#

Para comprobar si un cliente es válido para actualizarse a Azure plan:To check if a customer is eligible to upgrade to Azure plan:

  1. Cree un objeto ProductUpgradesRequest y especifique el identificador de cliente y "Azure" como la familia de productos.Create a ProductUpgradesRequest object and specify the customer identifier and "Azure" as the product family.

  2. Use la colección colección iaggregatepartner. ProductUpgrades .Use the IAggregatePartner.ProductUpgrades collection.

  3. Llame al método CheckEligibility y pase el objeto ProductUpgradesRequest , que devolverá un objeto ProductUpgradesEligibility .Call the CheckEligibility method and pass in the ProductUpgradesRequest object, which will return a ProductUpgradesEligibility object.

// IAggregatePartner partnerOperations;

string selectedCustomerId = "58e2af4f-0ad3-4688-8744-be2357cd939a";

string selectedProductFamily = "azure";

var productUpgradeRequest = new ProductUpgradesRequest
{
    CustomerId = selectedCustomerId,
    ProductFamily = selectedProductFamily
};

ProductUpgradesEligibility productUpgradeEligibility = partnerOperations.ProductUpgrades.CheckEligibility(productUpgradeRequest);

if (productUpgradeEligibility.IsEligibile)
{
    ....
}

Solicitud RESTREST request

Sintaxis de la solicitudRequest syntax

MétodoMethod URI de la solicitudRequest URI
POSTPOST {baseurl}/v1/productUpgrades/Eligibility http/1.1{baseURL}/v1/productUpgrades/eligibility HTTP/1.1

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

El cuerpo de la solicitud debe contener un recurso ProductUpgradeRequest .The request body must contain a ProductUpgradeRequest resource.

Ejemplo de solicitudRequest example

POST https://api.partnercenter.microsoft.com/v1/productupgrades/eligibility HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: c245d5f2-1de3-4ae0-9e42-95e38e3cb8ff
MS-CorrelationId: e3f26e6a-044f-4371-ad52-0d91ce4200be
X-Locale: en-US
MS-PartnerCenter-Application: Partner Center .NET SDK Samples
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 340
Expect: 100-continue
Connection: Keep-Alive
{
        "customerId": "4c721420-72ad-4708-a0a7-371a2f7b0969",
        "productFamily": "azure"
}

Respuesta RESTREST response

Si es correcto, este método devuelve un recurso ProductUpgradesEligibility en el cuerpo.If successful, this method returns a ProductUpgradesEligibility resource in the body.

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, consulta Códigos de error de REST del Centro de partners.For the full list, see Partner Center REST error codes.

Ejemplo de respuestaResponse example

HTTP/1.1 200 Ok
Content-Length: 150
MS-CorrelationId: 772871a9-399b-4f3b-b8c7-38f550e4f22a
MS-RequestId: cb82f7d6-f0d9-44d4-82f9-f6eee6e68390
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525
Date: Thu, 04 Oct 2019 20:35:35 GMT

{
    "customerId": "c1958bc7-3284-4952-a257-de594ee64743",
    "isEligible": true,
    "productFamily": "azure"
}