Agendar uma nova migração de comércio

Artigo
10/15/2024

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

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

Este artigo descreve como agendar uma Nova Experiência de Comércio.

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
POST	{baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules

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.

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.
termDuration	string	Não	A duração do prazo pode ser especificada para ser alterada na migração.
billingCycle	string	Não	O ciclo de faturamento pode ser especificado para ser alterado na migração.
purchaseFullTerm	bool	Não	Um novo período pode ser iniciado no NCE após a migração.
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	Obrigatório (se o migrateOnRenewal for nulo/falso)	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	Obrigatório (se targetDate for nulo)	Se o sinalizador for definido como true para migrateOnRenewal, não será necessário especificar o targetDate para agendar uma migração.
addOnMigrationSchedules	bool	Não	Inclui uma lista de assinaturas de complemento 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 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 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": "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
        }
    ]
}

Compartilhar via