Ativar uma assinatura de área restrita para produtos do marketplace comercialActivate a sandbox subscription for commercial marketplace products

Aplica-se a:Applies to:

  • Partner CenterPartner Center

Como ativar a assinatura para produtos de software como serviço (SaaS) do Marketplace comercial por meio da integração de contas de área restrita para habilitar a cobrança.How to activate subscription for commercial marketplace Software as a Service (SaaS) products from integration sandbox accounts to enable billing.

Observação

Só é possível ativar uma assinatura para produtos SaaS do Marketplace comercial de contas de área restrita de integração.It's only possible to activate a subscription for commercial marketplace SaaS products from integration sandbox accounts. Se você tiver uma assinatura de produção, deverá visitar o site do editor para concluir o processo de instalação.If you have a production subscription, you must visit the publisher's site to complete the setup process. A cobrança da assinatura será iniciada somente após a conclusão da instalação.Subscription billing will begin only after setup is complete.

Pré-requisitosPrerequisites

  • Credenciais, conforme descrito em Autenticação do Partner Center.Credentials as described in Partner Center authentication. Esse cenário dá suporte à autenticação com aplicativos autônomos e aplicativos + credenciais de usuário.This scenario supports authentication with both standalone App and App+User credentials.

  • Uma conta de parceiro da área restrita de integração com um cliente que tem uma assinatura ativa para produtos SaaS do Marketplace comercial.An integration sandbox partner account with a customer having an active subscription for commercial marketplace SaaS products.

  • 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 esse recurso.For partners using Partner Center .NET SDK, you must use SDK version 1.14.0 or higher to access this capability.

C#C#

Use as etapas a seguir para ativar uma assinatura para produtos SaaS do Marketplace comercial:Use the following steps to activate a subscription for commercial marketplace SaaS products:

  1. Torne uma interface para as operações de assinatura disponíveis.Make an interface to the subscription operations available. Você deve identificar o cliente e especificar o identificador da assinatura de avaliação.You must identify the customer and specify the subscription identifier of the trial subscription.

    var subscriptionOperations = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId);
    
  2. Ative a assinatura usando a operação Ativar .Activate the subscription using the Activate operation.

    var subscriptionActivationResult = subscriptionOperations.Activate();
    

Solicitação RESTREST request

Sintaxe da solicitaçãoRequest syntax

MétodoMethod URI da solicitaçãoRequest URI
POSTPOST {baseURL}/v1/Customers/{Customer-Tenant-ID}/subscriptions/{Subscription-ID}/Activate http/1.1{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/activate HTTP/1.1

Parâmetro do URIURI parameter

NomeName TipoType ObrigatórioRequired DescriçãoDescription
customer-tenant-idcustomer-tenant-id guidguid SY O valor é um identificador de locatário do cliente formatado por GUID (Customer-Tenant-ID), que permite que você especifique um cliente.The value is a GUID-formatted customer tenant identifier (customer-tenant-id), which allows you to specify a customer.
ID da assinaturasubscription-id guidguid SY O valor é um identificador de assinatura formatado por GUID (Subscription-ID), que permite que você especifique uma assinatura.The value is a GUID-formatted subscription identifier (subscription-id), which allows you to specify a subscription.

Cabeçalhos de solicitaçãoRequest headers

Para obter mais informações, confira Cabeçalhos REST do Partner Center.For more information, see Partner Center REST headers.

Corpo da solicitaçãoRequest body

Nenhum.None.

Exemplo de solicitaçãoRequest example

POST https://api.partnercenter.microsoft.com/v1/customers/42b5f772-5c5c-4bce-b9d7-bdadeecca411/subscriptions/87363db7-39ab-dd25-d371-94340aaa2f97/activate HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5

Resposta RESTREST response

Esse método retorna as propriedades Subscription-ID e status .This method returns the subscription-id and status properties.

Códigos de êxito e de erro de respostaResponse success and error codes

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais.Use a network trace tool to read this code, error type, and additional parameters. Para obter a lista completa, confira Códigos de erro REST do Partner Center.For the full list, see Partner Center REST error codes.

Exemplo de respostaResponse example

HTTP/1.1 200 OK
Content-Length: 79
Content-Type: application/json
MS-CorrelationId: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5

{
    "subscriptionId":"87363db7-39ab-dd25-d371-94340aaa2f97",
    "status":"Success"
}