Creación de una transferencia para el nuevo comercio mediante las API REST del Centro de partners

Artículo
09/20/2024

Los partners pueden transferir nuevas suscripciones comerciales de un asociado de transacción a otro. Un asociado de destino crea la solicitud de transferencia. El asociado de origen actualiza la transferencia con los detalles del elemento de línea. En este tema se explica la API a la que llamaría un asociado de destino para crear la solicitud de transferencia. Este tema solo es relevante para las reservas, los planes de ahorro y las suscripciones de Azure Plan y las nuevas suscripciones basadas en licencias comerciales. Puede encontrar información más valiosa en la documentación de transferencia de suscripciones.

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).
Roles adecuados: Agente de administración

Solicitud REST

Sintaxis de la solicitud

Método	URI de solicitud
POST	{baseURL}/v1/customers/{customer-ID}/transfers HTTP/1.1

Parámetro de URI

Use el siguiente parámetro de ruta de acceso para identificar al cliente.

Nombre	Type	Obligatorio	Descripción
customer-id	string	Sí	Identificador de cliente con formato GUID que identifica al cliente.

Encabezados de solicitud

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

Cuerpo de la solicitud

En esta tabla se describen las propiedades TransferEntity del cuerpo de la solicitud para crear una nueva solicitud de transferencia comercial.

Propiedad	Type	Obligatorio	Descripción
sourcePartnerTenantId	string	Sí	Identificador de asociado con formato GUID que identifica al asociado que inicia la transferencia.
sourcePartnerName	string	Sí	Nombre de la organización del asociado que inicia la transferencia.
customerEmailId	string	Sí	Cadena del cliente para recibir notificaciones de la creación de la transferencia.
customerName	string	No	Opcional. Nombre del cliente cuyas suscripciones se transfieren.
targetPartnerTenantId	string	No	Identificador de inquilino del asociado con formato GUID que identifica al asociado al que se dirige la transferencia. El contexto de autorización del asociado se resuelve en el identificador de inquilino del asociado si se omite.
targetPartnerEmailId	string	No	Identificador de inquilino del asociado con formato GUID que identifica al asociado al que se dirige la transferencia. El contexto de autorización del asociado se resuelve en el identificador de inquilino del asociado si se omite.
transferType	string	Sí	Cadena que define el tipo de transferencia. 3 representa NewCommerce y debe usarse para el plan de Azure y las nuevas suscripciones basadas en licencias comerciales.

Ejemplo de solicitud

{
    "id": "43fb1d3a-79fe-45a9-863e-9a4acf17b630",
    "status": "InProgress",
    "transferType": 3,
    "customerEmailId": "",
    "createdTime": "2024-04-30T18:31:41.5133355Z",
    "lastModifiedTime": "2024-05-01T00:51:55Z",
    "expirationTime": "2024-05-31T00:00:00Z",
    "customerName": "ipdbtrans2",
    "customerTenantId": "a624f7f8-408b-49d0-9320-df79e56bed55",
    "partnertenantid": "a94dcde1-ecd7-wace-a6ef-ef73ba6b8ba5",
    "sourcePartnerName": "Test_Test_IP4_AG",
    "sourcePartnerTenantId": "a94dcde1-ecd7-4ace-a6ef-ef73ba6b8ba5",
    "targetPartnerName": "Test_Test_DB_AG",
    "targetPartnerTenantId": "817512dd-0689-47a0-bbf2-a7f11ae1fc11",
    "targetPartnerEmailId": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
    "transferDirection": 2,
    "ignoreEligibilityCheck": false,
    "lastModifiedUser": "1671774b-679f-4543-a152-1f8b14006c0e",
    "lineItems": [{
        "id": 0,
        "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "billingCycle": "unknown",
        "quantity": 0,
        "productType": 5,
        "status": "InProgress"
    }],
    "links": {
        "self": {
            "uri": "/customers/a624f7f8-408b-49d0-9320-df79e56bed55/transfers/43fb1d3a-79fe-45a9-863e-9a4acf17b630",
            "method": "GET",
            "headers": []
        }
    }
}

Respuesta REST

Si se ejecuta correctamente, este método devuelve el recurso TransferEnity rellenado en el cuerpo de la respuesta.

Códigos de error y de respuesta correctos

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

Ejemplo de respuesta

HTTP/1.1 201 Created
Content-Length: 138
Content-Type: application/json; charset=utf-8
MS-RequestId: 4fa6dad6-a89f-4875-8247-7294a10ae1cf
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US,en-US

{
"id": "43fb1d3a-79fe-45a9-863e-9a4acf17b630",
"status": "Pending",
"transferType": 3,
"customerEmailId": "",
"createdTime": "2024-04-30T18:31:41.5133355Z",
"lastModifiedTime": "2024-04-30T18:31:41Z",
"expirationTime": "2024-05-31T00:00:00Z",
"customerName": "ipdbtrans2",
"customerTenantId": "a624f7f8-408b-49d0-9320-df79e56bed55",
"partnertenantid": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"sourcePartnerName": "Test_Test_IP4_AG",
"sourcePartnerTenantId": "a94dcde1-ecd7-4ace-a6ef-ef73ba6b8ba5",
"targetPartnerName": "Test_Test_DB_AG",
"targetPartnerTenantId": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"targetPartnerEmailId": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"transferDirection": 1,
"ignoreEligibilityCheck": false,
"lastModifiedUser": "7ffdaa28-3b1c-4a61-b580-e1aa6ecf833c",
"links": {
    "self": {
        "uri": "/customers/a624f7f8-408b-49d0-9320-df79e56bed55/transfers/43fb1d3a-79fe-45a9-863e-9a4acf17b630",
        "method": "GET",
        "headers": []
    }
}
}

Compartir vía