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

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

Előfeltételek

  • Hitelesítő adatok, amint az a Partnerközpont hitelesítési-ben szerepel. 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ó hitelesítést használ a Partnerközpont API-kkal.

  • Ügyfélazonosító (customer-tenant-id). Ha nem ismeri az ügyfél azonosítóját, megkeresheti azt a Partnerközpontban a Ügyfelek munkaterület kiválasztásával, aztán válasszon egy ügyfelet az ügyféllistából, majd a Fiókot. 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).

  • 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 Create metódust, és adja meg a ProductUpgradesRequest objektumot, amely egy helyfejlécet sztringet ad vissza.

  4. A frissítésazonosító kinyerése a helyfejléc sztringbő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

Módszer URI kérése
POSTA {baseURL}/v1/productupgrades HTTP/1.1

Kérelemfejlécek

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

Kérelem tartalma

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 a GitHub töltheti le, 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 sikeres, a válasz tartalmaz egy Hely fejlécet, amely egy URI-val rendelkezik, amely a termékfrissítés állapotának 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 lista a Partner Center REST-hibakódjai.

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
  • Last updated on