Activer un abonnement bac à sable pour les produits SaaS de la Place de marché commerciale pour activer la facturation

  • Article

Comment activer un abonnement pour les produits SaaS (Software as a Service) de la Place de marché commerciale à partir de comptes de bac à sable d’intégration pour activer la facturation.

Remarque

Il est uniquement possible d’activer un abonnement pour les produits SaaS de la Place de marché commerciale à partir de comptes de bac à sable d’intégration. Si vous disposez d’un abonnement de production, vous devez visiter le site de l’éditeur pour terminer le processus d’installation. La facturation de l’abonnement commence uniquement une fois l’installation terminée.

Prérequis

  • Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec les informations d’identification d’application et d’application+utilisateur autonomes.
  • Un compte partenaire de bac à sable d’intégration avec un client disposant d’un abonnement actif pour les produits SaaS de la Place de marché commerciale.
  • Pour les partenaires qui utilisent le Kit de développement logiciel (SDK) .NET de l’Espace partenaires, vous devez utiliser le SDK version 1.14.0 ou ultérieure pour accéder à cette fonctionnalité.

Important

Depuis juin 2023, la dernière version du Kit de développement logiciel (SDK) .NET de l’Espace partenaires version 3.4.0 est désormais archivée. Vous pouvez télécharger la version du SDK à partir de GitHub, ainsi qu’un fichier lisezmoi contenant des informations utiles.

Les partenaires sont encouragés à continuer à utiliser les API REST de l’Espace partenaires.

C#

Pour activer un abonnement pour les produits SaaS de la Place de marché commerciale, procédez comme suit :

  1. Mettre une interface à la disposition des opérations d’abonnement. Vous devez identifier le client et spécifier l’identificateur d’abonnement de l’abonnement d’évaluation.

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

  2. Activez l’abonnement à l’aide de l’opération Activate .

    var subscriptionActivationResult = subscriptionOperations.Activate();

Demande REST

Syntaxe de la requête

Méthode URI de demande
POST {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/activate HTTP/1.1

Paramètre d’URI

Nom Type Requise Description
id-locataire-client guid Y La valeur est un identificateur de locataire client au format GUID (customer-tenant-id), qui vous permet de spécifier un client.
id-abonnement guid Y La valeur est un identificateur d’abonnement au format GUID (subscription-id), qui vous permet de spécifier un abonnement.

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Corps de la demande

Aucune.

Exemple de requête

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

Réponse REST

Cette méthode retourne les propriétés d’id d’abonnement et d’état .

Codes d’erreur et de réussite de la réponse

Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez Codes d’erreur REST de l’Espace partenaires.

Exemple de réponse

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"
}