Validar uma assinatura para migração

Artigo
10/14/2023

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

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

Pré-requisitos

Credenciais, conforme descrito em Autenticação do Partner Center. Esse cenário oferece 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 espaço de trabalho Clientes, 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 é igual à ID do cliente (customer-tenant-id).
Um ID de assinatura atual

Limite de taxa

O limite da API de Migração de Validaçã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 Diretrizes de limitação de API.

Solicitação REST

Sintaxe da solicitação

Método	URI da solicitação
POST	{baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/validate HTTP/1.1

Parâmetro do URI

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

Nome	Digitar	Obrigatório	Descrição
id de locatário do cliente	string	Sim	Uma cadeia com formato de GUID que identifica o cliente.
prazoDuração	string	Não	A duração do prazo pode ser alterada após a migração.
billingCycle	string	Não	O ciclo de faturamento pode ser alterado após a migração.
compraFullTerm	bool	Não	Um novo termo pode ser iniciado no NCE após a migração.
quantity	INT	Não	A quantidade de licença para 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 OnlineServicesNCE não experimental existente ou a um mês de calendário. Há mais informações sobre como alinhar datas de término de assinatura aqui: Alinhar datas de término de assinatura no Partner Center

Cabeçalhos de solicitação

Para obter mais informações, confira Cabeçalhos REST do Partner Center.

Corpo da solicitação

Esta tabela descreve as propriedades Subscription no corpo da solicitação.

Propriedade	Type	Obrigatório	Descrição
currentSubscriptionId	string	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 for bem-sucedido, esse método retornará um booleano "isEligible" no corpo da resposta, indicando se a assinatura atual é elegível para migração para novo comércio. Observe que a API de Validação de Migração não fornece informações sobre a qualificação de uma assinatura para promoções no New Commerce.

Códigos de êxito e de erro de resposta

Cada resposta vem com um código de status HTTP que indica sucesso ou falha e informações extras de depuração. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e outros parâmetros. Para obter a lista completa, confira 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"
    }