Retirar una transferencia
Nota:
Este tema solo se aplica a los servicios tradicionales basados en licencias y no a nuevas experiencias comerciales. Para obtener más información sobre cómo transferir nuevas suscripciones basadas en licencias comerciales, consulte el tema nueva transferencia comercial.
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, busque el identificador de Microsoft en la sección Información de la cuenta de cliente. El id. de Microsoft es el mismo que el de cliente (customer-tenant-id
).Identificador de transferencia para una transferencia existente.
Solicitud REST
Sintaxis de la solicitud
Método | URI de solicitud |
---|---|
DELETE | {baseURL}/v1/customers/{customer-id}/transfers/{transfer-id} 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. |
transfer-id | string | Sí | Identificador de transferencia con formato GUID que identifica la transferencia. |
Encabezados de solicitud
Para obtener más información, consulta Encabezados REST del Centro de partners.
Ejemplo de solicitud
DELETE /v1/customers/d6bf25b7-e0a8-4f2d-a31b-97b55cfc774d/transfers/67c5b05b-09b5-47ba-9047-5056fe2afa4f HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: cdf6e25c-7b32-4cc3-d8bc-53e0b37eebd8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Connection: keep-alive
Respuesta REST
Si se ejecuta correctamente, este método devuelve No Content (204).
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.
Ejemplo de respuesta
HTTP/1.1 204 No Content
Content-Length: 0
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: cdf6e25c-7b32-4cc3-d8bc-53e0b37eebd8
Date: Tue, 24 Mar 2020 23:44:06 GMT