Criar uma nova migração comercial

Aplica-se a: Centro de Parceiros | Centro de Parceiros operado pela 21Vianet | Centro de Parceiros para a Microsoft Cloud para o Governo dos EUA

Como criar uma migração de uma assinatura para New Commerce Experience

Pré-requisitos

  • Credenciais tal como descritas em a 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, depois o cliente da lista de clientes e, em seguida, Conta. Na página da Conta do Cliente, procure o ID da Microsoft na secção de 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

Limitação de taxa

O limite da API Create Migration é de 100 chamadas feitas por um parceiro em 5 minutos. Mais informações sobre limites de taxa e limitação estão disponíveis em API throttling guidance.

Pedido REST

Sintaxe da solicitação

Método Solicitar URI
PUBLICAR {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce HTTP/1.1

Parâmetro URI

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

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

Cabeçalhos de solicitação

Para mais informações, veja os cabeçalhos REST do Partner Center.

Corpo do pedido

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

Propriedade Tipo Necessário Descrição
idAssinaturaAtual cadeia de caracteres Sim Um identificador de assinatura que indica qual assinatura requer validação para migração.
duração do termo cadeia de caracteres Não A duração do prazo pode ser alterada após a migração.
ciclo de faturação cadeia de caracteres Não O ciclo de faturamento pode ser alterado após a migração.
compraFullTerm Bool Não Um novo período pode ser iniciado no NCE após a migração.
Quantidade Int Não A quantidade de licença para uma assinatura pode ser aumentada ou diminuída após a migração.
customTermEndDate (Data de Término Personalizada) data e hora Não Uma data final pode ser definida para se alinhar com uma assinatura existente do OnlineServicesNCE que não esteja em fase de avaliação ou com o mês de calendário. 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

Exemplo de solicitação

Note que os complementos aninhados (assinaturas de complementos com outras assinaturas de complementos) devem ser escritos no corpo da solicitação como uma lista plana dentro de addOnMigrations e não devem ser aninhados dentro de outras assinaturas de complementos na solicitação; consulte o último exemplo de solicitação para saber como os complementos podem ser escritos no corpo da solicitação.

{
    "currentSubscriptionId" : "9beb6319-6889-4d28-a155-68ca9c783842"
}

{ 
    "currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC", 
    "termDuration": "P1M", 
    "billingCycle": "Monthly", 
} 

{
    "currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC", 
    "purchaseFullTerm": true 
}

{
    "currentSubscriptionId": "66E738D6-E0BC-4FFB-8818-BDE99BC7008B",
    "quantity": 1,
    "billingCycle": "Annual",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "359011DC-B5B0-4660-850B-A8FA9B2E3309",
            "quantity": 1,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M"
        },
        {
            "currentSubscriptionId": "159D9F87-CE39-4EBD-B9C2-ECF0892A85A1",
            "quantity": 1,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y"
        }
    ]
}

Resposta REST

Se for bem-sucedido, este método retornará detalhes das Assinaturas de que estão a ser 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 de depuração extras. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro, outros parâmetros. Para obter a lista completa, consulte códigos de erro REST do Partner Center.

Exemplos de respostas

{
    "addOnMigrations": [
        {
            "currentSubscriptionId": "E3AFD30D-D6E7-45AF-A6C5-FB905992AE00",
            "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "catalogItemId": "CFQ7TTC0LH0T:0001:CFQ7TTC0K4KQ",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        },
        {
            "currentSubscriptionId": "80906BD9-E45C-4D1B-92A8-EA3F3FB6E105",
            "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "catalogItemId": "CFQ7TTC0LH0R:0001:CFQ7TTC0K0SK",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        },
        {
            "currentSubscriptionId": "72E424F4-10FF-4C76-B101-C274F73BA498",
            "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "catalogItemId": "CFQ7TTC0LHXJ:0001:CFQ7TTC0KHTR",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        }
    ],
    "id": "7123c075-fc05-42d6-a21e-1d2036fa490b",
    "startedTime": "2022-02-23T13:00:48.4489832Z",
    "currentSubscriptionId": "2E56C7F5-E120-4CA4-BFF3-7DA763B4D777",
    "status": "Processing",
    "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
    "subscriptionEndDate": "2023-02-22T00:00:00Z",
    "quantity": 1,
    "termDuration": "P1Y",
    "billingCycle": "Monthly",
    "purchaseFullTerm": false
}
  • Last updated on