Agendar uma nova migração comercial

Artigo
07/25/2023

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

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

Este artigo descreve como agendar uma nova experiência 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

Method	Solicitar URI
POST	{baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules

Parâmetro URI

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

Name	Tipo	Obrigatório	Descrição
ID do cliente-locatário	cadeia	Sim	Uma cadeia de caracteres formatada em GUID que identifica o cliente.

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	Obrigatório	Descrição
currentSubscriptionId	cadeia	Sim	Um identificador de assinatura que indica qual assinatura requer validação para migração.
termoDuração	cadeia	Não	A duração do prazo pode ser especificada para ser alterada após a migração.
faturamentoCiclo	cadeia	Não	O ciclo de faturamento pode ser especificado para ser alterado após a migração.
compraFullTerm	booleano	No	Um novo termo pode ser iniciado em DNO após a migração.
quantidade	número inteiro	No	A quantidade de licença para uma assinatura pode ser aumentada ou diminuída após a migração.
customTermEndDate	datetime	No	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	Obrigatório (se o migrateOnRenewal for null/false)	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	Obrigatório (se targetDate for null)	Se o sinalizador for definido true para migrateOnRenewal, não há necessidade de especificar targetDate para agendar uma migração.
addOnMigrationSchedules	booleano	No	Inclui uma lista de assinaturas AddOn a serem incluídas na migração agendada.

Exemplo de solicitação

{
    "currentSubscriptionId": "2591295E-DDEB-425A-93F9-C1B4F5AD7FB6",
    "quantity": 1,
    "billingCycle": "monthly",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "customTermEndDate": null,
    "targetDate": "2023-08-09T00:00:00.000Z",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "5B882C48-53C6-46AF-B8A4-0691F19BAD94",
            "quantity": 17,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M",
            "customTermEndDate": null
        },
        {
            "currentSubscriptionId": "C7D0DB12-9482-4297-8F09-190EB04F9C05",
            "quantity": 23,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y",
            "customTermEndDate": null
        }
    ]
}

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

Exemplos de respostas

{
    "id": "f016c025-a873-47af-8b52-2516fbef4c65",
    "currentSubscriptionId": "2591295E-DDEB-425A-93F9-C1B4F5AD7FB6",
    "quantity": 1,
    "billingCycle": "monthly",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "customTermEndDate": null,
    "targetDate": "2023-08-09T00:00:00.000Z",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "5B882C48-53C6-46AF-B8A4-0691F19BAD94",
            "quantity": 17,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M",
            "customTermEndDate": null
        },
        {
            "currentSubscriptionId": "C7D0DB12-9482-4297-8F09-190EB04F9C05",
            "quantity": 23,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y",
            "customTermEndDate": null
        }
    ]
}

Share via