Mettre à jour le renouvellement automatique d’un abonnement de la place de marché commercialeUpdate autorenew for a commercial marketplace subscription

S’applique àApplies To

  • Espace partenairesPartner Center

Mettez à jour la propriété renouvellement autorenouvelé pour une ressource d' abonnement de la place de marché commercial qui correspond à l’ID du client et de l’abonnement.Update the autorenew property for a commercial marketplace Subscription resource that matches the customer and subscription ID.

Dans le tableau de bord de l’espace partenaires, cette opération est effectuée en sélectionnant d’abord un client.In the Partner Center dashboard, this operation is performed by first selecting a customer. Sélectionnez ensuite l’abonnement que vous souhaitez mettre à jour.Then, select the subscription that you wish to update. Enfin, basculez l’option de renouvellement automatique , puis sélectionnez Envoyer.Finally, toggle the Auto-renew option, then select Submit.

PrérequisPrerequisites

  • Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires.Credentials as described in Partner Center authentication. Ce scénario prend en charge l’authentification avec les informations d’identification de l’application autonome et de l’application + utilisateur.This scenario supports authentication with both standalone App and App+User credentials.

  • ID du client (customer-tenant-id).A customer ID (customer-tenant-id). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans le tableau de bord de l’Espace partenaires.If you don't know the customer's ID, you can look it up in the Partner Center dashboard. Sélectionnez CSP dans le menu Espace partenaires, puis Clients.Select CSP from the Partner Center menu, followed by Customers. Sélectionnez le client dans la liste des clients, puis Compte.Select the customer from the customer list, then select Account. Dans la page du compte du client, recherchez l’ID Microsoft dans la section Informations sur le compte client.On the customer’s Account page, look for the Microsoft ID in the Customer Account Info section. L’ID Microsoft est le même que l’ID de client (customer-tenant-id).The Microsoft ID is the same as the customer ID (customer-tenant-id).

  • ID d’abonnement.A subscription ID.

C#C#

Pour mettre à jour l’abonnement d’un client, commencez par obtenir l’abonnement, puis définissez la propriété autoRenewEnabled de l’abonnement.To update a customer's subscription, first Get the subscription, then set the subscription's autoRenewEnabled property. Une fois la modification effectuée, utilisez votre collection collection iaggregatepartner. Customers et appelez la méthode méthode BYID () .Once the change is made, use your IAggregatePartner.Customers collection and call the ById() method. Appelez ensuite la propriété Subscriptions , suivie de la méthode méthode BYID () .Then call the Subscriptions property, followed by the ById() method. Ensuite, terminez en appelant la méthode patch () .Then, finish by calling the Patch() method.

// IAggregatePartner partnerOperations;
// var selectedCustomerId as string;
// Subscription selectedSubscription;

// turn off auto renew.
selectedSubscription.AutoRenewEnabled = false;
var updatedSubscription = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscription.Id).Patch(selectedSubscription);

Exemple: application de test console.Sample: Console test app. Projet: PartnerSDK. FeatureSample, classe: UpdateSubscription.csProject: PartnerSDK.FeatureSample Class: UpdateSubscription.cs

Demande RESTREST request

Syntaxe de la requêteRequest syntax

MéthodeMethod URI de requêteRequest URI
PATCHPATCH {baseURL}/v1/Customers/{Customer-tenant-ID}/subscriptions/{ID-for-subscription} http/1.1{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{id-for-subscription} HTTP/1.1

Paramètre d’URIURI parameter

Ce tableau répertorie le paramètre de requête requis pour suspendre l’abonnement.This table lists the required query parameter to suspend the subscription.

NomName TypeType ObligatoireRequired DescriptionDescription
customer-tenant-idcustomer-tenant-id GUIDGUID OY GUID correspondant au client.A GUID corresponding to the customer.
id-for-subscriptionid-for-subscription GUIDGUID OY GUID correspondant à l’abonnement.A GUID corresponding to the subscription.

En-têtes de requêteRequest headers

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.For more information, see Partner Center REST headers.

Corps de demandeRequest body

Une ressource d' abonnement de la place de marché commercial complète est requise dans le corps de la demande.A full commercial marketplace Subscription resource is required in the request body. Vérifiez que la propriété AutoRenewEnabled a été mise à jour.Ensure that the AutoRenewEnabled property has been updated.

Exemple de requêteRequest example

PATCH https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/subscriptions/<id-for-subscription> HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: ca7c39f7-1a80-43bc-90d8-ee7d1cad3831
MS-CorrelationId: ec8f62e5-1d92-47e9-8d5d-1924af105f2c
If-Match: <etag>
Content-Type: application/json
Content-Length: 1029
Expect: 100-continue
Connection: Keep-Alive

{
    "id": "6e7aa601-629e-461b-8933-0898c3cc3c7c",
    "offerId": "DZH318Z0BXWC:0001:DZH318Z0BMJX",
    "offerName": "offer Name",
    "friendlyName": "friendly Name",
    "quantity": 1,
    "unitType": "License(s)",
    "hasPurchasableAddons": false,
    "creationDate": "2019-01-04T01:00:12.6647304Z",
    "effectiveStartDate": "2019-01-09T00:21:45.9263727+00:00",
    "commitmentEndDate": "2019-02-08T00:21:45.9263727+00:00",
    "status": "active",
    "autoRenewEnabled": false,
    "isTrial": false,
    "billingType": "license",
    "billingCycle": "monthly",
    "termDuration": "P1M",
    "refundOptions": [{
        "type": "Full",
        "expiresAt": "2019-01-10T00:21:45.9263727+00:00"
    }],
    "isMicrosoftProduct": false,
    "partnerId": "",
    "contractType": "subscription",
    "publisherName": "publisher Name",
    "orderId": "ImxjLNL4_fOc-2KoyOxGTZcrlIquzls11",
    "attributes": {"objectType": "Subscription"},
}

Réponse RESTREST response

En cas de réussite, cette méthode retourne les propriétés de ressource d' abonnement mises à jour dans le corps de la réponse.If successful, this method returns updated Subscription resource properties in the response body.

Codes d’erreur et de réussite de la réponseResponse success and error codes

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.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires.Use a network trace tool to read this code, error type, and additional parameters. Pour obtenir la liste complète, consultez Codes d’erreur.For the full list, see Error Codes.

Exemple de réponseResponse example

HTTP/1.1 200 OK
Content-Length: 1322
Content-Type: application/json; charset=utf-8
MS-RequestId: ca7c39f7-1a80-43bc-90d8-ee7d1cad3831
MS-CorrelationId: ec8f62e5-1d92-47e9-8d5d-1924af105f2c
X-Locale: en-US

{
    "id": "6e7aa601-629e-461b-8933-0898c3cc3c7c",
    "offerId": "DZH318Z0BXWC:0001:DZH318Z0BMJX",
    "offerName": "offer Name",
    "friendlyName": "friendly Name",
    "quantity": 1,
    "unitType": "License(s)",
    "hasPurchasableAddons": false,
    "creationDate": "2019-01-04T01:00:12.6647304Z",
    "effectiveStartDate": "2019-01-09T00:21:45.9263727+00:00",
    "commitmentEndDate": "2019-02-08T00:21:45.9263727+00:00",
    "status": "active",
    "autoRenewEnabled": false,
    "isTrial": false,
    "billingType": "license",
    "billingCycle": "monthly",
    "termDuration": "P1M",
    "refundOptions": [
        {
            "type": "Full",
            "expiresAt": "2019-01-10T00:21:45.9263727+00:00"
        }
    ],
    "isMicrosoftProduct": false,
    "partnerId": "",
    "contractType": "subscription",
    "links": {
        "product": {
            "uri": "/products/DZH318Z0BXWC?country=US",
            "method": "GET",
            "headers": []
        },
        "sku": {
            "uri": "/products/DZH318Z0BXWC/skus/0001?country=US",
            "method": "GET",
            "headers": []
        },
        "availability": {
            "uri": "/products/DZH318Z0BXWC/skus/0001/availabilities/DZH318Z0BMJX?country=US",
            "method": "GET",
            "headers": []
        },
        "self": {
            "uri": "/customers/5921f00a-32c0-4457-aaa1-e8018c650895/subscriptions/6e7aa601-629e-461b-8933-0898c3cc3c7c",
            "method": "GET",
            "headers": []
        }
    },
    "publisherName": "publishe rName",
    "orderId": "ImxjLNL4_fOc-2KoyOxGTZcrlIquzls11",
    "attributes": {
        "etag": "",
        "objectType": "Subscription"
    }
}