Validar uma subscrição para migração

Artigo
10/28/2024

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

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

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

Limite da 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	URI do pedido
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	Type	Obrigatório	Description
ID do cliente-locatário	string	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.
faturamentoCiclo	string	Não	O ciclo de faturamento pode ser alterado após a migração.
compraFullTerm	booleano	Não	Um novo termo pode ser iniciado no NCE após a migração.
quantidade	número inteiro	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 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 do pedido

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

Corpo do pedido

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

Propriedade	Type	Obrigatório	Description
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 do 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 status HTTP que indica sucesso ou falha e informações de depuração extral. 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"
    }

Partilhar via