Atualizar uma nova agenda de migração comercial

Artigo
10/26/2023

Aplica-se a: Centro de Parceiros | Centro de Parceiros operado pela 21Vianet | Centro de Parceiros para Microsoft Cloud for US Government

Este artigo descreve como atualizar uma nova agenda de migração comercial. Os parceiros podem atualizar antes da data de destino agendada.

Importante

Atualmente, esta API só está disponível no inquilino do Sandbox.

Pré-requisitos

Credenciais conforme descrito na autenticação do Centro de Parceiros. Este cenário suporta a autenticação com credenciais autónomas da Aplicação e da Aplicação+Utilizador.
Um ID de cliente (customer-tenant-id). Se não souber o ID do cliente, pode procurá-lo no Centro de Parceiros 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 o ID Microsoft na secção Informações da Conta de Cliente . O ID da Microsoft é o mesmo que o ID do cliente (customer-tenant-id).
Um ID de subscrição atual

Pedido REST

Sintaxe do pedido

Método	URI do pedido
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	Obrigatório	Descrição
customer-tenant-id	string	Yes	Uma cadeia formatada por GUID que identifica o cliente.
scheduleID	string	Yes	Uma cadeia formatada por GUID que identificou a agenda

Cabeçalhos do pedido

Para obter mais informações, veja Cabeçalhos REST do Centro de Parceiros.

Corpo do pedido

Esta tabela descreve as propriedades da subscrição no corpo do pedido.

Propriedade	Tipo	Obrigatório	Descrição
currentSubscriptionId	string	Yes	Um identificador de subscrição que indica que subscrição requer validação para migração. Não permitido para a operação de atualização.
termDuration	cadeia (de carateres)	No	A duração do termo pode ser especificada para ser alterada após a migração.
Ciclo de Faturação	cadeia (de carateres)	No	O ciclo de faturação pode ser especificado para ser alterado após a migração.
purchaseFullTerm	bool	Não	Um novo termo pode ser iniciado no NCE após a migração.
quantidade	int	No	A quantidade de licenças de uma subscrição pode ser aumentada ou diminuída após a migração.
customTermEndDate	datetime	Não	Uma data de fim pode ser definida para estar alinhada com uma subscrição OnlineServicesNCE ou mês de calendário existente que não seja de avaliação. Existem mais informações sobre como alinhar as datas de fim da subscrição aqui: Alinhar as datas de fim da subscrição no Centro de Parceiros
targetDate	datetime	Não	Data de Destino quando agendar a migração. Se targetDate estiver definido para a data especificada, a migrationOnRenewal pode ser definida como nula ou falsa.
migrateOnRenewal	bool	Não	Se o sinalizador for definido como verdadeiro para migrateOnRenewal, não é necessário especificar o targetDate para agendar uma migração.

Exemplo de pedido

{
"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 do REST

Se for bem-sucedido, este método devolve detalhes das subscrições que estão a ser migradas (objeto de migração) no corpo da resposta.

Códigos de erro e êxito da resposta

Cada resposta inclui um código de estado HTTP que indica êxito ou falha e informações adicionais de depuração. Utilize uma ferramenta de rastreio de rede para ler este código, tipo de erro e parâmetros adicionais. Para obter a lista completa, veja Códigos de erro REST do Centro de Parceiros.

Exemplos de resposta

{
"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"
}

Partilhar via