Creación de una entidad de actualización de producto para un cliente

Puede crear una entidad de actualización de productos para actualizar un cliente a una familia de productos determinada (por ejemplo, un plan de Azure) mediante el recurso ProductUpgradeRequest .

Prerrequisitos

• Credenciales tal como se describe en Autenticación del Centro de asociados. Este escenario admite la autenticación con credenciales de aplicación+usuario. Siga el modelo de aplicación segura al usar la autenticación Aplicación+Usuario con las API del Centro de partners.

• Un ID de cliente (customer-tenant-id). Si no conoce el identificador del cliente, puede buscarlo en Partner Center 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, busque el Id. de Microsoft en la sección Información de la cuenta de cliente. El ID de Microsoft es el mismo que el ID de cliente (customer-tenant-id).

• La familia de productos a la que desea actualizar el cliente.

C#

Para actualizar un cliente al plan de Azure:

1. Cree un objeto ProductUpgradesRequest y especifique el identificador de cliente y "Azure" como familia de productos.

2. Use la colección IAggregatePartner.ProductUpgrades .

3. Llame al método Create y pase el objeto ProductUpgradesRequest , que devolverá una cadena de encabezado de ubicación .

4. Extraiga el identificador de actualización de la cadena de encabezado de ubicación que se puede usar para consultar el estado de la actualización.

// IAggregatePartner partnerOperations;

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

string selectedProductFamily = "Azure";

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

var productUpgradeLocationHeader = partnerOperations.ProductUpgrades.Create(productUpgradeRequest);

var upgradeId = Regex.Split(productUpgradeLocationHeader, "/")[1];

Solicitud REST

Sintaxis de la solicitud

Cabeceras de solicitud

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

Cuerpo de la solicitud

El cuerpo de la solicitud debe contener un recurso ProductUpgradeRequest .

Ejemplo de solicitud

POST https://api.partnercenter.microsoft.com/v1/productupgrades HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: c245d5f2-1de3-4ae0-9e42-95e38e3cb8ff
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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 REST

Si se realiza correctamente, la respuesta contiene un encabezado Location que tiene un URI que se puede usar para recuperar el estado de actualización del producto. Guarde este URI para usarlo con otras API de REST relacionadas.

Códigos de éxito y de error de la respuesta

Cada respuesta incluye un código de estado HTTP que indica el éxito o error y la información adicional de depuración. Use una herramienta de seguimiento de red para leer este código, tipo de error y parámetros adicionales. Para obtener la lista completa, consulta Códigos de error de REST del Centro de socios.

Ejemplo de respuesta

HTTP/1.1 202 Accepted
Content-Length: 0
Location: productUpgrades/42d075a4-bfe7-43e7-af6d-7c68a57edcb4
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: cb82f7d6-f0d9-44d4-82f9-f6eee6e68390
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525
Date: Thu, 28 Sep 2019 20:35:35 GMT