Consultar migraciones comerciales nuevas

  • Artículo

Se aplica a: Centro de partners | Centro de partners operado por 21Vianet | Centro de partners para Microsoft Cloud for US Government

Consulta de suscripciones migradas basadas en el identificador de cliente, el identificador de suscripción actual o el identificador de referencia externo

Roles adecuados: Administrador global | Agente de administración | Agente de ventas

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.

Esta API puede filtrar en función de las cadenas de consulta que selecciona el asociado. Las cadenas de consulta seleccionadas pueden ser cualquiera de las tres opciones siguientes:

  • A CustomerTenantId. 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, busque el identificador de Microsoft en la sección Información de la cuenta de cliente. El identificador de Microsoft es el mismo que el identificador de cliente.

  • CurrentSubscriptionId (el identificador heredado de una suscripción que se ha migrado)

  • ExternalReferenceId (el identificador de lote devuelto por la herramienta de migración por lotes que está disponible para su descarga a través del SDK del Centro de partners)

Solicitud REST

Sintaxis de la solicitud

Método URI de solicitud
GET {baseURL}/v1/migrations/newcommerce HTTP/1.1

Cadenas de consulta

En esta tabla se enumeran las cadenas de consulta necesarias para filtrar y recuperar nuevas migraciones comerciales. Al menos uno de los tres identificadores es necesario para consultar correctamente las migraciones. La entrada de varios identificadores para la consulta se acepta, pero no es necesario.

Nombre Descripción
CustomerTenantId Cadena con formato de GUID que identifica al cliente.
CurrentSubscriptionId Cadena con formato GUID que identifica una suscripción heredada migrada.
ExternalReferenceId Cadena con formato GUID que identifica el lote de migración.

Encabezados de solicitud

Para obtener más información, consulta Encabezados REST del Centro de partners. La respuesta de la API devuelve un máximo de 300 registros de página. Si se devuelven más de 300 registros en una consulta con entrada, se proporciona un token de continuación en el encabezado de respuesta. El token de continuación puede escribirse en el encabezado de una solicitud siguiente para devolver registros de página adicionales consultados.

Cuerpo de la solicitud

Ninguno.

Respuesta REST

Si se ejecuta correctamente, este método devuelve detalles de las suscripciones que se migraron (objeto de migración) en el cuerpo de la respuesta. Esto incluye el identificador de migración.

Códigos de error y de respuesta correctos

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

Ejemplos de dirección URL de solicitud

baseurl/v1/migrations/newcommerce?CustomerTenantId=83c51838-fed5-44a4-a275-afa201d53699&CurrentSubscriptionId=6CCC6A93-93E4-4382-AF1F-E51237232833&ExternalReferenceId=9ab61899-0b2b-4320-bd6d-8196c53607d6

baseurl/v1/migrations/newcommerce?CurrentSubscriptionId=6CCC6A93-93E4-4382-AF1F-E51237232833

Ejemplos de respuesta

[
{
"addOnMigrations": [],
"id": "8ce7115e-0324-41b1-8ca3-7c7ae3b64f75",
"startedTime": "2022-02-24T23:50:30.4384819Z",
"completedTime": "2022-02-24T23:53:14.0813711Z",
"currentSubscriptionId": "9E289691-2FF3-419D-B39B-26B3E5A817FB",
"status": "Completed",
"customerTenantId": "ce6fcc21-c276-447b-9605-874decb9024b",
"catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
"newCommerceSubscriptionId": "f2d6534b-9e30-4cf5-c7b0-5d6393dbf12d",
"newCommerceOrderId": "09714c93092a",
"subscriptionEndDate": "2023-02-14T00:00:00Z",
"quantity": 2,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"externalReferenceId": "771317a4-275d-47d9-9724-3eefa4a168ad"
}
]