Validar uma assinatura para migração

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

Como validar uma assinatura para migração para New Commerce Experience

Pré-requisitos

• Credenciais na autenticação do Partner Center conforme descrito em . 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 o espaço de trabalho Clientes, depois o cliente da lista de clientes e, em seguida, Conta. Na página Conta do cliente, procure o de 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

Limitação de taxa

O limite da API de Validação de Migração é de 450 chamadas por combinação parceiro-cliente 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
POST	{baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/validate HTTP/1.1

Parâmetro URI

Esta tabela lista os parâmetros de consulta necessários para validar uma assinatura para migração.

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.
termoDuração	string	Não	A duração do prazo pode ser alterada após a migração.
ciclo de faturação	string	Não	O ciclo de faturamento pode ser alterado após a migração.
compra de prazo completo	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 e hora	Não	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

Cabeçalhos de solicitação

Para mais informações, consulte 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
idDeSubscriçãoAtual	cadeia de caracteres	Sim	Um identificador de assinatura que indica qual assinatura requer validação para migração.

Exemplo de solicitação

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

Resposta REST

Se bem-sucedido, esse método retorna um booleano "isEligible" no corpo da resposta, indicando se a assinatura atual é qualificada para migração para novo comércio. Observe que a API Validar Migração não fornece informações sobre a elegibilidade de uma assinatura para promoções no New Commerce.

Códigos de sucesso e erro de resposta

Cada resposta vem com um código de estado HTTP que indica sucesso ou falha e informações de depuração extra. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e outros parâmetros. Para obter a lista completa, consulte códigos de erro REST do Partner Center.

Exemplos de respostas

1. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": false,
        "errors": [
            {
                "code": 5,
                "description": "Subscription cannot be migrated to New Commerce because the equivalent offer is not yet available in New Commerce",
            }
        ]
    }

2. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": true,
        "catalogItemId": "CFQ7TTC0LF8S:0002:CFQ7TTC0KSVV"
    }