Atualizar um agendamento de migração para o novo comércio

  • Artigo

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 agendada.

Importante

No momento, essa API só está disponível no locatário da Área Restrita.

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á pesquisá-la no Partner Center selecionando o workspace 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).

  • 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 migração de comércio.

Nome Tipo Necessário Descrição
customer-tenant-id string Sim Uma cadeia com formato de GUID que identifica o cliente.
Scheduleid string Sim Uma cadeia de caracteres formatada por GUID que identificou o agendamento

Cabeçalhos de 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 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 a operação de atualização.
termDuration string Não A duração do prazo pode ser especificada para ser alterada após a migração.
billingCycle string Não O ciclo de cobrança pode ser especificado para ser alterado após a migração.
purchaseFullTerm bool Não Um novo termo pode ser iniciado na NCE após a migração.
quantidade INT Não A quantidade de licenças de uma assinatura pode ser aumentada ou reduzida após a migração.
customTermEndDate DATETIME Não Uma data de término pode ser definida para se alinhar a uma assinatura onlineservicesnce ou mês do calendário existente que não seja de avaliação. Há mais informações sobre como alinhar as datas de término da assinatura aqui: Alinhar as datas de término da assinatura no Partner Center
targetDate DATETIME Não Data de destino quando agendar a migração. Se targetDate for definido para a data especificada, migrationOnRenewal poderá ser definido como nulo ou falso.
migrateOnRenewal bool Não Se o sinalizador for definido como true para migrateOnRenewal, não será necessário 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": "6f297517-16e6-4313-8c6d-4e10496d2871",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00"
}

Resposta REST

Se tiver êxito, este 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 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 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": "6f297517-16e6-4313-8c6d-4e10496d2871",
"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"
}

Confira também