Ügyfél rendelésének létrehozása Partnerközpont API-k használatával

A következővonatkozik: Partnerközpont | A 21Vianet által üzemeltetett Partnerközpont | Partnerközpont az amerikai kormányzat Microsoft Cloud szolgáltatása számára

A fenntartott Azure-beli virtuálisgép-példányok termékeihez rendelés létrehozása csak vonatkozik:

• Partnerközpont

A jelenleg értékesíthető dolgokról további információt a Partnerajánlatok a Felhőszolgáltató programbantalálhat.

Előfeltételek

• Hitelesítő adatok, amint a Partnerközpont hitelesítési leírásában szerepel . 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élazonosítót, megkeresheti a Partnerközpontban a Ügyfelek munkaterület kiválasztásával, majd az ügyfél kiválasztásával az ügyféllistából, végül a Fiók. Az ügyfél Fiók lapján keresse meg a Microsoft-azonosító az Ügyfélfiók adatai szakaszban. A Microsoft-azonosító megegyezik az ügyfél-azonosítóval (customer-tenant-id).

• Ajánlatazonosító.

C#

Rendelés létrehozása egy ügyfél számára:

1. Példányosítson egy Order objektumot, és állítsa be a ReferenceCustomerID tulajdonságot az ügyfélazonosítóra az ügyfél rögzítéséhez.

2. Hozzon létre egy listát OrderLineItem objektumokról, és rendelje hozzá a listát a rendelés LineItems tulajdonságához. Minden rendeléssorelem egy ajánlat beszerzési adatait tartalmazza. Legalább egy rendelési tétel szükséges.

3. Szerezzen be egy felületet a műveletek elvégzéséhez. Először hívja meg az IAggregatePartner.Customers.ById metódust az ügyfélazonosítóval az ügyfél azonosításához. Ezután kérje le a felületet az Orders tulajdonságból.

4. Hívja meg a Create vagy CreateAsync metódust, és adja meg a Order objektumot.

5. Az igazolás befejezéséhez és további viszonteladók hozzáadásához tekintse meg a következő mintakérési és válaszmintákat:

Példa kérése

{
    "PartnerOnRecordAttestationAccepted":true, 
    "lineItems": [
        {
            "offerId": "CFQ7TTC0LH0Z:0001:CFQ7TTC0K18P",
            "quantity": 1,
            "lineItemNumber": 0,
            "PartnerIdOnRecord": "873452",
            "AdditionalPartnerIdsOnRecord":["4847383","873452"]
        }
    ],
    "billingCycle": "monthly"
}

Példa válaszra

{
    "id": "5cf72f146967",
    "alternateId": "5cf72f146967",
    "referenceCustomerId": "f81d98dd-c2f4-499e-a194-5619e260344e",
    "billingCycle": "monthly",
    "currencyCode": "USD",
    "currencySymbol": "$",
    "lineItems": [
        {
            "lineItemNumber": 0,
            "offerId": "CFQ7TTC0LH0Z:0001:CFQ7TTC0K18P",
            "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
            "termDuration": "P1M",
            "transactionType": "New",
            "friendlyName": "AI Builder Capacity add-on",
            "quantity": 1,
            "partnerIdOnRecord": "873452",
            "additionalPartnerIdsOnRecord": [
                "4847383",
                "873452"
            ],
            "links": {
                "product": {
                    "uri": "/products/CFQ7TTC0LH0Z?country=US",
                    "method": "GET",
                    "headers": []
                },
                "sku": {
                    "uri": "/products/CFQ7TTC0LH0Z/skus/0001?country=US",
                    "method": "GET",
                    "headers": []
                },
                "availability": {
                    "uri": "/products/CFQ7TTC0LH0Z/skus/0001/availabilities/CFQ7TTC0K18P?country=US",
                    "method": "GET",
                    "headers": []
                }
            }
        }
    ],
    "creationDate": "2021-08-17T18:13:11.3122226Z",
    "status": "pending",
    "transactionType": "UserPurchase",
    "links": {
        "self": {
            "uri": "/customers/f81d98dd-c2f4-499e-a194-5619e260344e/orders/5cf72f146967",
            "method": "GET",
            "headers": []
        },
        "provisioningStatus": {
            "uri": "/customers/f81d98dd-c2f4-499e-a194-5619e260344e/orders/5cf72f146967/provisioningstatus",
            "method": "GET",
            "headers": []
        },
        "patchOperation": {
            "uri": "/customers/f81d98dd-c2f4-499e-a194-5619e260344e/orders/5cf72f146967",
            "method": "PATCH",
            "headers": []
        }
    },
    "client": {},
    "attributes": {
        "objectType": "Order"
    }
}

IAggregatePartner partnerOperations;
string customerId;
string offerId;

var order = new Order()
{
    ReferenceCustomerId = customerId,
    LineItems = new List<OrderLineItem>()
    {
        new OrderLineItem()
        {
            OfferId = offerId,
            FriendlyName = "new offer purchase",
            Quantity = 1,
            ProvisioningContext = new Dictionary<string, string>
            {
                { "subscriptionId", "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f" },
                { "scope", "shared" },
                { "duration", "3Years" }
            }
        }
    }
};

var createdOrder = partnerOperations.Customers.ById(customerId).Orders.Create(order);

minta: konzolteszt alkalmazás. Projekt: Partnerközpont SDK-minták osztály: CreateOrder.cs

REST-kérés

Kérés szintaxisa

URI-paraméterek

Az ügyfél azonosításához használja az alábbi elérési út paramétert.

Kérelemfejlécek

További információ: Partnerközpont REST-fejlécei.

Kérési törzs

Megrendelés

Ez a táblázat a kérelemtörzsben található Rendelés tulajdonságait ismerteti.

Rendelési Tétel

Ez a táblázat a kérelemtörzs OrderLineItem tulajdonságait ismerteti.

RenewsTo

Ez a táblázat a kérési törzs RenewsTo tulajdonságait írja le.

Példa kérése

POST https://api.partnercenter.microsoft.com/v1/customers/b0d70a69-4c42-4b27-b17b-91a835d8686a/orders HTTP/1.1
Authorization: Bearer <token>
Host: api.partnercenter.microsoft.com
Content-Length: 691
Content-Type: application/json

{
  "BillingCycle": "one_time",
  "CurrencyCode": "USD",
  "LineItems": [
    {
      "LineItemNumber": 0,
      "ProvisioningContext": {
        "subscriptionId": "cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a",
        "scope": "shared",
        "duration": "1Year"
      },
      "OfferId": "DZH318Z0BQ4B:0047:DZH318Z0DSM8",
      "FriendlyName": "A_sample_Azure_RI",
      "Quantity": 1
    }
  ]
}

REST-válasz

Ha sikeres, a metódus egy Order erőforrást ad vissza a válasz törzsében.

Ha a rendelés egy vagy több előfizetést tartalmaz, a megfelelő előfizetés-azonosító értékek csak akkor jelennek meg a REST-válaszban, ha a megfelelő előfizetések ki lettek építve az API-hívás időpontjában. Az előfizetések kiépítése aszinkron módon történik, ezért előfordulhat, hogy az előfizetés-azonosító értékek nem mindig jelennek meg a Rendelés létrehozása hívás REST-válaszában. A megfelelő előfizetések kiépítése után azonban az előfizetés-azonosítójuk értékei a Rendelések lekérése és a Rendelés lekérése AZONOSÍTÓ API-hívások segítségével érhetők el.

Válasz sikeresség é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. A kód, a hibatípus és a további paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes listáért lásd a Partnerközpont hibakódjai.

Példa válaszra

HTTP/1.1 201 Created
Content-Length: 788
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 025f4c19-217f-49d6-a056-391902c62fb3
Date: Thu, 15 Mar 2018 22:30:02 GMT

{
  "id": "Cs_jyTxubLpvdJXdo8xcQZN6I2RsLrgZ1",
  "referenceCustomerId": "b0d70a69-4c42-4b27-b17b-91a835d8686a",
  "billingCycle": "one_time",
  "currencyCode": "USD",
  "lineItems": [
    {
        "lineItemNumber": 0,
        "offerId": "84A03D81-6B37-4D66-8D4A-FAEA24541538",
        "friendlyName": "A_sample_Azure_RI",
        "quantity": 1,
        "links": {
            "sku": {
                "uri": "/products/DZH318Z0BQ4B/skus/0047?country=US",
                "method": "GET",
                "headers": []
            }
        }
    } ],
    "creationDate": "2018-03-15T22:30:02.085152Z",
    "status": "pending",
    "links": {
        "provisioningStatus": {
            "uri": "/customers/b0d70a69-4c42-4b27-b17b-91a835d8686a/orders/Cs_jyTxubLpvdJXdo8xcQZN6I2RsLrgZ1/provisioningstatus",
            "method": "GET",
            "headers": []
        },
        "self": {
            "uri": "/customers/b0d70a69-4c42-4b27-b17b-91a835d8686a/orders/Cs_jyTxubLpvdJXdo8xcQZN6I2RsLrgZ1",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Order"
    }
}