Kereskedelmi piactér vagy új kereskedelmi előfizetés lemondása Partnerközpont API-k használatával

  • Cikk

A következőre vonatkozik: Partnerközpont

Ez a cikk azt ismerteti, hogyan szakíthat meg egy kereskedelmi piacteret vagy egy új kereskedelmi előfizetési erőforrást a Partner Center API használatával, amely megfelel az ügyfélnek és az előfizetés azonosítójának.

Megjegyzés

A licencalapú szolgáltatások új kereskedelmi felületei számos új képességet tartalmaznak, és minden felhőszolgáltató (CSP) számára elérhetők. További információ: Új kereskedelmi szolgáltatások áttekintése.

Az új kereskedelmi előfizetések a vásárlást vagy megújítást követő 7 napon belül lemondhatók, kivéve, ha a törvény másként nem rendelkezik. Az ablak leteltét követően az előfizetések már nem mondhatók le, és az API hibát jelez.

Előfeltételek

  • Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv támogatja a hitelesítést önálló alkalmazással és app+felhasználói hitelesítő adatokkal is.

  • Ügyfélazonosító (customer-tenant-id). Ha nem ismeri az ügyfél azonosítóját, keresse meg a Partnerközpontban az Ügyfelek munkaterületen. Válassza ki az ügyfelet az ügyféllistából, majd válassza a Fiók lehetőséget. 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ó.

Partnerközpont metódus

Kereskedelmi piactér-előfizetés lemondása a Partnerközpontban:

  1. Válasszon ki egy ügyfelet.

  2. Válassza ki a lemondani kívánt előfizetést.

  3. Válassza az Előfizetés lemondása lehetőséget, majd válassza a Küldés lehetőséget.

C#

Az ügyfél előfizetésének lemondása:

  1. Az előfizetés lekérése azonosító alapján.

  2. Módosítsa az előfizetés Status tulajdonságát. Az állapotkódokkal kapcsolatos információkért lásd: SubscriptionStatus enumerálás.

  3. A módosítás után használja a gyűjteményt IAggregatePartner.Customers , és hívja meg a ById() metódust.

  4. Hívja meg az Előfizetések tulajdonságot, majd a ById() metódust.

  5. Hívja meg a Patch() metódust.

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

selectedSubscription.Status = SubscriptionStatus.Deleted;
var updatedSubscription = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscription.Id).Patch(selectedSubscription);

Mintakonzolteszt alkalmazás

Minta: Konzolteszt alkalmazás. Projekt: PartnerSDK.FeatureSample Osztály: UpdateSubscription.cs

REST-kérelem

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 előfizetés felfüggesztéséhez szükséges lekérdezési paramétert.

Név Típus Kötelező Leírás
customer-tenant-id guid Y Az ügyfélnek megfelelő GUID.
előfizetés-azonosító guid Y Az előfizetésnek megfelelő GUID.

Kérésfejlécek

További információt a Partnerközpont REST-fejlécei című témakörben talál.

A kérés törzse

A kérelem törzsében teljes előfizetési erőforrásra van szükség. Az előfizetés lemondásához győződjön meg arról, hogy az Állapot tulajdonság a értékre deletedlett frissítve.

Mező Típus Kötelező Leírás
Állapot sztring Y Az előfizetések állapota. A lehetőségek lehetnek : active, , suspendeddeleted

Példa kérésre

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

REST-válasz

Ha a kérés sikeres, ez a metódus a válasz törzsében adja vissza a törölt Előfizetés erőforrás-tulajdonságokat.

Sikeres válasz és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. Használja a hálózati nyomkövetési eszközt a kód, a hibatípus és a további paraméterek olvasásához. A teljes listaért lásd: Hibakódok.

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,
    "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": "deleted",
    "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": "publisher Name",
    "orderId": "ImxjLNL4_fOc-2KoyOxGTZcrlIquzls11",
    "attributes": {
        "etag": "",
        "objectType": "Subscription"
    }
}