Retirar uma transferência
Observação
Este tópico se aplica apenas a serviços tradicionais baseados em licença e não a novas experiências de comércio. Para obter mais informações sobre como transferir novas assinaturas baseadas em licenças de comércio, consulte o novo tópico de transferência de comércio.
Pré-requisitos
Credenciais, conforme descrito em Autenticação do Partner Center. Esse cenário oferece suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.
Uma ID do cliente (
customer-tenant-id). Se você não souber a ID do cliente, poderá procurá-la no Partner Center selecionando o espaço de trabalho Clientes, o cliente na lista de clientes e, em seguida, Conta. Na página Conta do cliente, procure a ID da Microsoft na seção Informações da Conta do Cliente. A ID da Microsoft é igual à ID do cliente (customer-tenant-id).Um identificador de transferência para uma transferência existente.
Solicitação REST
Sintaxe da solicitação
| Método | URI da solicitação |
|---|---|
| DELETE | {baseURL}/v1/customers/{customer-id}/transfers/{transfer-id} HTTP/1.1 |
Parâmetro do URI
Use o seguinte parâmetro de caminho para identificar o cliente.
| Nome | Digitar | Obrigatória | Descrição |
|---|---|---|---|
| id do cliente | string | Sim | Um ID de cliente formatado por GUID que identifica o cliente. |
| transfer-id | string | Sim | Um ID de transferência formatado por GUID que identifica a transferência. |
Cabeçalhos da solicitação
Para obter mais informações, confira 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 bem-sucedido, esse método retorna Sem conteúdo (204).
Códigos de êxito e de erro de resposta
Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais. Para obter a lista completa, confira 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