Új kereskedelmi előfizetés módosításainak ütemezése a Partnerközpont API-kkal

Cikk
02/24/2024

A következőre vonatkozik: Partnerközpont

Ez a cikk azt ismerteti, hogyan ütemezheti a Partner Center API-t egy új kereskedelmi előfizetés módosításainak ütemezéséhez, amelyek csak a megújítás során történnek.

Feljegyzés

A licencalapú szolgáltatások új kereskedelmi szolgáltatásai számos új képességet tartalmaznak, és minden Felhőszolgáltató (CSP) számára elérhetők. További információkért tekintse meg az új kereskedelmi szolgáltatások áttekintését.

Az ütemezett módosítások létrehozásával automatikusan módosíthatja előfizetését, amikor a következő megújítás megtörténik. A módosítások ütemezésével növelheti vagy csökkentheti a licencek számát, módosíthatja a számlázási időtartamot és a gyakoriságot, és akár a termékváltozat frissítését is választhatja. Az ütemezési módosítások lehetővé teszik az előfizetés módosítását a megújításkor, nem pedig közvetlenül az aktuális időszakban.

Fontos

Ha a megújítás dátuma előtt félidős (azonnali) módosítást hajt végre, a rendszer törli az összes olyan ütemezett módosítást, amelyet korábban a megújításkor ütemezett.

Előfeltételek

Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv támogatja az önálló alkalmazással és az App+Felhasználói hitelesítő adatokkal való hitelesítést is.
Ügyfélazonosító (customer-tenant-id). Ha nem ismeri az ügyfél azonosítóját, megkeresheti a Partnerközpontban az Ügyfelek munkaterület kiválasztásával, majd az ügyféllistából, majd a Fiók listában. Az ügyfél Fiók lapján keresse meg a Microsoft-azonosítót az Ügyfélfiók adatai szakaszban. A Microsoft-azonosító megegyezik az ügyfél-azonosítóval (customer-tenant-id).
Előfizetés-azonosító.
Az automatikus megújítás engedélyezve van az előfizetésben.

Partnerközpont metódus

Előfizetés módosításainak ütemezése a Partnerközpontban:

Válasszon ki egy ügyfelet.
Válassza ki azt az előfizetést, amelybe módosításokat szeretne ütemezni.
Automatikus megújítás engedélyezése.
Válassza a Megújítás kezelése lehetőséget.
Módosítsa az előfizetést a megújítás során.
Az oldalpanel bezárásához válassza az Ok gombot .
kattintson a Küldés gombra a módosítások mentéséhez.

Feljegyzés

A megújítások feldolgozása a ciklus utolsó napja után történik, a következő naptól (UTC) 12:00-tól kezdve. A megújítások feldolgozása várólistán történik, és a feldolgozás akár 24 órát is igénybe vehet.

C#

Az ügyfél előfizetésének módosításainak ütemezése:

Az előfizetés lekérése azonosító alapján.
Hozzon létre egy ScheduledNextTermInstructions objektumot , és állítsa be az előfizetés tulajdonságára.
Hívja meg a Patch() metódust, hogy frissítse az előfizetést az ütemezett módosításokkal.

var selectedSubscription = subscriptionOperations.Get();
selectedSubscription.ScheduledNextTermInstructions = new ScheduledNextTermInstructions
{
    Product = new ProductTerm
    {
        ProductId = changeToProductId,
        SkuId = changeToSkuId,
        AvailabilityId = changeToAvailabilityId,
        BillingCycle = changeToBillingCycle,
        TermDuration = changeToTermDuration,
    },
    Quantity = changeToQuantity,
    customTermEndDate = DateTime,
};
var updatedSubscription = subscriptionOperations.Patch(selectedSubscription);

REST-kérés

Kérés szintaxisa

Metódus	Kérés URI-ja
JAVÍTÁS	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id} HTTP/1.1

URI-paraméter

Ez a táblázat felsorolja az API meghívásához szükséges lekérdezési paramétereket.

Név	Típus	Kötelező	Leírás
ügyfél-bérlő-azonosító	Guid	I	Az ügyfélnek megfelelő GUID.
előfizetés-azonosító	Guid	I	Az előfizetésnek megfelelő GUID.

Kérésfejlécek

További információ: Partnerközpont – REST fejlécek.

Kérés törzse

A kérelem törzsében teljes előfizetési erőforrásra van szükség, a scheduledNextTermInstructions tulajdonság meg van határozva. Az előfizetés módosításainak ütemezéséhez győződjön meg arról, hogy az AutoRenewEnabled tulajdonság értéke igaz.

Mező	Típus	Kötelező	Leírás
ütemezettNextTermInstructions	Objektum	I	Meghatározza az előfizetés következő kifejezési utasításait. A tulajdonság tartalmazza az `product` objektumot és a `quantity` mezőt.

Példa kérése

PATCH https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/subscriptions/<subscription-id> 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,
    "customTermEndDate": "2019-01-09T00:21:45.9263727",
    "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": true,
    "scheduledNextTermInstructions": { 
      "product": { 
         "productId":  "DG7GMGF0DVSV", 
         "skuId":  "000P", 
         "availabilityId":  "DG7GMGF0F3Q9", 
         "billingCycle":  "Annual", 
         "termDuration":  "P3Y",
         "promotionId": "39NFJQT1PFPJ:000H:39NFJQT1Q5DK"
        }, 
      "quantity":  1 
      "customTermEndDate" : "2019-01-09T00:21:45.9263727",
     },  // original value = null 
    "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"},
}

REST-válasz

Ha a kérés sikeres, ez a metódus a válasz törzsében adja vissza az előfizetés frissített erőforrás-tulajdonságait.

Válasz sikeresség és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint egyéb hibakeresési információkat. A kód, hibatípus és egyéb paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes listát a Hibakódok című témakörben találja.

Példa válaszra

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,
    "customTermEndDate": "2019-01-09T00:21:45.9263727",
    "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": true,
    "scheduledNextTermInstructions": { 
      "product": { 
         "productId":  "DG7GMGF0DVSV", 
         "skuId":  "000P", 
         "availabilityId":  "DG7GMGF0F3Q9", 
         "billingCycle":  "Annual", 
         "termDuration":  "P3Y",
         "promotionId": "39NFJQT1PFPJ:000H:39NFJQT1Q5DK"
        }, 
      "quantity":  1 
      "customTermEndDate": "2019-01-09T00:21:45.9263727",
     },  // original value = null 
    "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"},
}

Megosztás a következőn keresztül: