Ativar uma assinatura de área restrita para produtos SaaS do Microsoft Marketplace para habilitar a cobrança

Funções apropriadas: Agente administrativo

Este artigo mostra como ativar uma assinatura para produtos SaaS (Software como serviço) do Microsoft Marketplace a partir de contas de área restrita de integração para habilitar a cobrança.

Observação

Só é possível ativar uma assinatura para produtos SaaS do Microsoft Marketplace a partir de contas de área restrita de integração. Se você tiver uma assinatura de produção, deverá visitar o site do editor para concluir o processo de instalação. A cobrança da assinatura será iniciada somente após a conclusão da instalação.

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 conta de parceiro de área restrita de integração com um cliente que tem uma assinatura ativa para produtos SaaS do Microsoft Marketplace.
  • Para parceiros que usam o SDK do .NET do Partner Center, você deve usar o SDK versão 1.14.0 ou superior para acessar essa funcionalidade.

Importante

A partir de junho de 2023, a versão mais recente do SDK do .NET do Partner Center 3.4.0 foi arquivada. Você pode baixar o lançamento do SDK no GitHub, juntamente com um arquivo README que contém informações úteis.

Os parceiros são incentivados a continuar a usar as APIs REST do Partner Center.

Como usar C#

Use as seguintes etapas para ativar uma assinatura para produtos SaaS do Microsoft Marketplace:

  1. Disponibilize uma interface para as operações de assinatura. Você deve identificar o cliente e especificar o identificador da assinatura de avaliação.

    var subscriptionOperations = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId);

  2. Ative a assinatura usando a operação Ativar .

    var subscriptionActivationResult = subscriptionOperations.Activate();

Enviar uma solicitação REST

Use a sintaxe a seguir para enviar uma solicitação REST.

Sintaxe da solicitação

Método URI de solicitação
POST {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/activate HTTP/1.1

Parâmetro URI

Nome Tipo Obrigatório Descrição
id do cliente-inquilino guid S O valor é um identificador de locatário do cliente (customer-tenant-id) com formato de GUID, que permite que você especifique um cliente.
subscription-id guid S O valor é um identificador de assinatura formatado por GUID (id de assinatura), que permite especificar uma assinatura.

Cabeçalhos da solicitação

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

Corpo da solicitação

Nenhum.

Exemplo de solicitação

POST https://api.partnercenter.microsoft.com/v1/customers/42b5f772-5c5c-4bce-b9d7-bdadeecca411/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/activate HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5

Examinar a resposta REST

Esse método retorna as propriedades de id de assinatura e status .

Códigos de erro e êxito 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 ver a lista completa, consulte Códigos de erro REST do Partner Center.

Exemplo de resposta

HTTP/1.1 200 OK
Content-Length: 79
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5

{
    "subscriptionId":"aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
    "status":"Success"
}

Conteúdo relacionado

  • Last updated on