Retirar uma transferência

Artigo
03/09/2025

Observação

Este tópico aplica-se apenas a serviços tradicionais baseados em licenças e não a novas experiências comerciais. Para obter mais informações sobre como transferir novas assinaturas baseadas em licença de comércio, consulte o tópico nova transferência de comércio.

Pré-requisitos

Credenciais conforme descrito em autenticação do Partner Center. Este cenário oferece suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.
Um ID de cliente (customer-tenant-id). Se não souber o ID do cliente, pode procurá-lo no Partner Center, selecionando o espaço de trabalho Clientes, depois o cliente da lista de clientes e, em seguida, Conta. Na página Conta do cliente, procure o de ID da Microsoft na seção Informações da Conta do Cliente. A ID da Microsoft é a mesma que a ID do cliente (customer-tenant-id).
Um identificador de transferência para uma transferência existente.

Pedido REST

Sintaxe da solicitação

Método	Solicitar URI
EXCLUIR	{baseURL}/v1/customers/{customer-id}/transfers/{transfer-id} HTTP/1.1

Parâmetro URI

Utilize o seguinte parâmetro de caminho para identificar o cliente.

Nome	Tipo	Necessário	Descrição
ID do cliente	string	Sim	Um ID de cliente formatado em GUID que identifica o cliente.
identificação de transferência	cadeia de caracteres	Sim	Um ID de transferência formatado em GUID que identifica a transferência.

Cabeçalhos de solicitação

Para obter mais informações, consulte cabeçalhos REST do Partner Center.

Exemplo de solicitação

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

Resposta REST

Se for bem-sucedido, esse método retornará No Content (204).

Códigos de sucesso e erro de resposta

Cada resposta vem com um código de status HTTP que indica sucesso ou falha e informações adicionais de depuração. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e parâmetros adicionais. Para obter a lista completa, consulte Códigos de erro.

Exemplo de resposta

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

Partilhar via