Atualizar um agendamento de migração para o novo comércio
Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center para o Microsoft Cloud for US Government
Este artigo descreve como atualizar um novo agendamento de migração de comércio. Os parceiros podem atualizar antes da data de destino programada.
Importante
No momento, essa API só está disponível no locatário do Sandbox.
Pré-requisitos
Credenciais, conforme descrito em Autenticação do Partner Center. Esse cenário dá 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 workspace Clientes, o cliente da 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).Uma ID de assinatura atual
Solicitação REST
Sintaxe da solicitação
| Método | URI da solicitação |
|---|---|
| PUT | {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules/{scheduleID} |
Parâmetro do URI
Esta tabela lista os parâmetros de consulta necessários para criar uma nova migração comercial.
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| id de locatário do cliente | string | Sim | Uma cadeia com formato de GUID que identifica o cliente. |
| ID do cronograma | string | Sim | Uma cadeia de caracteres formatada em GUID que identificou o agendamento |
Cabeçalhos da solicitação
Para obter mais informações, confira Cabeçalhos REST do Partner Center.
Corpo da solicitação
Esta tabela descreve as propriedades da assinatura no corpo da solicitação.
| Propriedade | Tipo | Obrigató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. |
| termDuration | string | Não | Duração do prazo para a migração. |
| billingCycle | string | Não | Ciclo de faturamento para a migração. |
| purchaseFullTerm | bool | Não | Se a migração continua o prazo herdado atual ou inicia um novo. |
| quantity | int | Não | A quantidade de licenças de uma assinatura pode ser aumentada ou diminuída após a migração. |
| customTermEndDate | datetime | Não | Uma data de término pode ser definida para se alinhar a uma assinatura ou mês de calendário existente do OnlineServicesNCE sem 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 |
| targetDate | datetime | Não | Data de destino para agendar a migração. Se targetDate for definido para a data especificada, o migrationOnRenewal poderá ser definido como null ou false. |
| migrateOnRenewal | bool | Não | Se o sinalizador for definido como true para migrateOnRenewal, não será necessário especificar o 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 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 êxito e de erro de resposta
Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações extras 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, confira 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"
}