Automatisch verlengen bijwerken voor een abonnement op de commerciële marketplace of nieuwe commerce-abonnementen of softwareabonnementen

Artikel
03/08/2023

Van toepassing op: Partnercentrum

Notitie

De nieuwe commerce-ervaringen voor services op basis van licenties bevatten veel nieuwe mogelijkheden en zijn beschikbaar voor alle CSP's (Cloud Solution Provider). Zie overzicht van nieuwe commerce-ervaringen voor meer informatie.

Werk de eigenschap voor automatisch verlengen bij voor een commerciële marketplace, nieuwe commerce- of softwareabonnementsresource die overeenkomt met de klant- en abonnements-id.

In partnercentrum wordt deze bewerking uitgevoerd door eerst een klant te selecteren. Selecteer vervolgens het abonnement dat u wilt bijwerken. Schakel ten slotte de optie Automatisch verlengen in en selecteer verzenden.

Vereisten

Referenties zoals beschreven in Partnercentrum-verificatie. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als App+User-referenties.
Een klant-id (customer-tenant-id). Als u de id van de klant niet weet, kunt u deze opzoeken in partnercentrum. Selecteer Klanten op de startpagina, selecteer vervolgens de klant in de lijst met klanten en selecteer vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens . De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id).'
Een abonnements-id.

C#

Als u het abonnement van een klant wilt bijwerken, moet u eerst Het abonnement ophalen en vervolgens de eigenschap autoRenewEnabled van het abonnement instellen. Zodra de wijziging is aangebracht, gebruikt u uw verzameling IAggregatePartner.Customers en roept u de methode ById() aan. Roep vervolgens de eigenschap Subscriptions aan, gevolgd door de methode ById(). Voltooi vervolgens door de methode Patch() aan te roepen.

// 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);

Voorbeeld: Consoletest-app. Project: PartnerSDK.FeatureSample Klasse: UpdateSubscription.cs

REST-aanvraag

Aanvraagsyntaxis

Methode	Aanvraag-URI
PATCH	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{id-for-subscription} HTTP/1.1

URI-parameter

Deze tabel bevat de vereiste queryparameter om het abonnement te onderbreken.

Naam	Type	Vereist	Beschrijving
klant-tenant-id	GUID	J	Een GUID die overeenkomt met de klant.
id-for-subscription	GUID	J	Een GUID die overeenkomt met het abonnement.

Aanvraagheaders

Zie Rest-headers van partnercentrum voor meer informatie.

Aanvraagbody

Een volledige abonnementsresource is vereist in de aanvraagbody. Zorg ervoor dat de eigenschap AutoRenewEnabled is bijgewerkt.

Voorbeeld van aanvraag voor een abonnement op de commerciële marketplace

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

Voorbeeld van aanvraag voor een nieuw commerce-abonnement