Atualizar 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
Este artigo descreve como atualizar uma nova agenda de migração de comércio. Os parceiros podem atualizar antes da data-alvo agendada.
Importante
Atualmente, essa API só está disponível no locatário da Sandbox.
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 |
|---|---|
| PUT | {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules/{scheduleID} |
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 identificou o agendamento |
Cabeçalhos do pedido
Para obter mais informações, consulte Cabeçalhos REST do Partner Center.
Corpo do pedido
Esta tabela descreve as propriedades da assinatura no corpo da solicitação.
| Propriedade | Tipo | Necessário | Descrição |
|---|---|---|---|
| currentSubscriptionId | string | Sim | Um identificador de assinatura que indica qual assinatura requer validação para migração. Não permitido para operação de atualização. |
| termoDuração | string | Não | Duração do prazo para a migração. |
| faturamentoCiclo | string | Não | Ciclo de faturamento para a migração. |
| compraFullTerm | booleano | Não | Se a migração continua o termo legado atual ou inicia um novo. |
| quantidade | número inteiro | Não | A quantidade de licença para uma assinatura pode ser aumentada ou diminuída 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. Se targetDate for definido para a data especificada, migrationOnRenewal poderá ser definido como null ou false. |
| migrateOnRenewal | booleano | Não | Se o sinalizador for definido true para migrateOnRenewal, não há necessidade de especificar targetDate para agendar uma migração. |
Exemplo de solicitação
{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"status": "Created",
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00"
}
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 de depuração extras. 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": "Created",
"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"
}