Partilhar via


Cancelar um novo cronograma de migração de comércio

Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center for Microsoft Cloud for US Government

Funções apropriadas: Agente administrativo | Agente de vendas

Este artigo descreve como cancelar uma nova agenda de migração de comércio.

Pré-requisitos

  • Credenciais conforme descrito na 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 a área de trabalho Clientes e, em seguida, 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 é a mesma que a ID do cliente (customer-tenant-ID).

  • Um ID de subscrição atual

Pedido REST

Sintaxe da solicitação

Método Solicitar URI
POST {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules/{scheduleID}/cancel

Parâmetro URI

Esta tabela lista os parâmetros de consulta necessários para criar uma nova migração comercial.

Nome Tipo Necessário Descrição
ID do cliente-locatário string Sim Uma cadeia de caracteres formatada em GUID que identifica o cliente.
ID do cronograma string Sim Uma cadeia de caracteres formatada em GUID que identifica o agendamento

Cabeçalhos do pedido

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

Corpo da resposta

Esta tabela descreve as propriedades da assinatura na resposta.

Propriedade Tipo Necessário Descrição
ID String Não Uma cadeia de caracteres formatada em GUID que identifica o agendamento
currentSubscriptionID string Não Um identificador de assinatura que indica qual assinatura requer validação para migração.
termoDuração string Não Duração do prazo especificada para ser alterada após a migração.
faturamentoCiclo string Não Ciclo de faturamento especificado para ser alterado após a migração.
compraFullTerm booleano Não Um novo termo começou no DNO após a migração.
quantidade número inteiro Não A quantidade de licenças aumentou ou diminuiu após a migração.
customTermEndDate datetime Não Uma data final pode ser definida para se alinhar com uma assinatura ou mês de calendário do OnlineServices NCE existente que não seja de avaliação. Há mais informações sobre como alinhar as datas de término da assinatura aqui: Alinhar datas de término da assinatura no Partner Center
data-alvo datetime Não Data de destino quando agendar a migração.
migrateOnRenewal booleano Não Indica se a assinatura pode ser migrada na renovação.
status string Não Status da migração da agenda
createdTime datetime Não Quando o cronograma foi criado
lastModifiedTime datetime Não Quando o horário foi modificado pela última vez

Resposta do REST

Se for bem-sucedido, esse método retornará detalhes das assinaturas que estão sendo migradas (objeto de migração) no corpo da resposta.

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 outros parâmetros. Para obter a lista completa, consulte Códigos de erro REST do Partner Center.

Exemplos de respostas

{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"subscriptionEndDate": "2023-07-19T00:00:00Z",
"status": "Cancelled",
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00",
"createdTime": "2022-10-18T21:20:50.9668605+00:00",
"lastModifiedTime": "2022-10-18T21:29:32.8992819+00:00"
}

Consulte também