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

Termékfrissítési entitás létrehozása egy ügyfél számára

  • Cikk

A ProductUpgradeRequest erőforrás használatával létrehozhat egy termékfrissítési entitást, amely egy adott termékcsaládra (például Azure-csomagra) frissít egy ügyfelet .

Előfeltételek

  • Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv támogatja az App+Felhasználói hitelesítő adatokkal való hitelesítést. Kövesse a biztonságos alkalmazásmodellt , amikor Alkalmazás+Felhasználói hitelesítést használ a Partnerközpont API-ival.

  • Ü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).

  • Az a termékcsalád, amelyre frissíteni szeretné az ügyfelet.

C#

Az ügyfél azure-csomagra való frissítése:

  1. Hozzon létre egy ProductUpgradesRequest objektumot, és adja meg az ügyfélazonosítót és az "Azure"-t termékcsaládként.

  2. Használja az IAggregatePartner.ProductUpgrades gyűjteményt .

  3. Hívja meg a Létrehozás metódust, és adja meg a ProductUpgradesRequest objektumot, amely egy hely fejlécsztringet ad vissza.

  4. Bontsa ki a frissítés azonosítóját a hely fejlécének sztringéből, amely a frissítés állapotának lekérdezéséhez használható.

// IAggregatePartner partnerOperations;

string selectedCustomerId = "58e2af4f-0ad3-4688-8744-be2357cd939a";

string selectedProductFamily = "Azure";

var productUpgradeRequest = new ProductUpgradesRequest
{
    CustomerId = selectedCustomerId,
    ProductFamily = selectedProductFamily
};

var productUpgradeLocationHeader = partnerOperations.ProductUpgrades.Create(productUpgradeRequest);

var upgradeId = Regex.Split(productUpgradeLocationHeader, "/")[1];

REST-kérés

Kérés szintaxisa

Method Kérés URI-ja
POST {baseURL}/v1/productupgrades HTTP/1.1

Kérelemfejlécek

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

A kérés törzse

A kérelem törzsének tartalmaznia kell egy ProductUpgradeRequest erőforrást.

Példa kérése

POST https://api.partnercenter.microsoft.com/v1/productupgrades HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: c245d5f2-1de3-4ae0-9e42-95e38e3cb8ff
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
MS-PartnerCenter-Application: Partner Center .NET SDK Samples
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 340
Expect: 100-continue
Connection: Keep-Alive
{
  "customerId": "4c721420-72ad-4708-a0a7-371a2f7b0969",
  "productFamily": "Azure"
}

Fontos

2023 júniusától a partnerközpont .NET SDK legújabb, 3.4.0-s kiadását archiváljuk. Az SDK-kiadást letöltheti a GitHubról, valamint egy hasznos információkat tartalmazó olvasófájlt.

A partnereket arra ösztönzik, hogy továbbra is használják a Partnerközpont REST API-jait.

REST-válasz

Ha a válasz sikeres, a válasz tartalmaz egy URI-val rendelkező helyfejlécet , amely a termékfrissítési állapot lekérésére használható. Mentse ezt az URI-t más kapcsolódó REST API-khoz való használatra.

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át a Partnerközpont REST-hibakódjaiban találja.

Példa válaszra

HTTP/1.1 202 Accepted
Content-Length: 0
Location: productUpgrades/42d075a4-bfe7-43e7-af6d-7c68a57edcb4
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: cb82f7d6-f0d9-44d4-82f9-f6eee6e68390
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525
Date: Thu, 28 Sep 2019 20:35:35 GMT