Az ügyfél termékfrissítési állapotának lekérése

A ProductUpgradeRequest erőforrással lekérheti egy új termékcsaládra való frissítés állapotát. Ez az erőforrás akkor érvényes, ha egy ügyfelet Microsoft Azure-előfizetésről (MS-AZR-0145P) frissít egy Azure-csomagra. A sikeres kérés visszaadja a ProductUpgradesEligibility erőforrást.

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

• A termékcsalád.

• A frissítési kérelem frissítésazonosítója.

C#

Annak ellenőrzéséhez, hogy az ügyfél jogosult-e az Azure-csomagra való frissítésre:

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 ById metódust, és adja meg a frissítési azonosítót.

4. Hívja meg a CheckStatus metódust, és adja meg a ProductUpgradesRequest objektumot, amely egy ProductUpgradeStatus objektumot ad vissza.

// IAggregatePartner partnerOperations;

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

string selectedProductFamily = "azure";

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

ProductUpgradesStatus productUpgradeStatus = partnerOperations.ProductUpgrades.ById(selectedUpgradeId).CheckStatus(productUpgradeRequest);

if (productUpgradeEligibility.IsEligibile)
{
    ....
}

REST-kérés

Kérés szintaxisa

Method	Kérés URI-ja
POST	{baseURL}/v1/productUpgrades/{upgrade-id}/status HTTP/1.1

URI-paraméter

A következő lekérdezési paraméterrel adja meg azt az ügyfelet, akinek termékfrissítési állapotot kap.

Name	Type	Kötelező	Leírás
frissítésazonosító	GUID	Igen	Az érték egy GUID formátumú frissítési azonosító. Ezzel az azonosítóval megadhat egy nyomon követendő frissítést.

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/42d075a4-bfe7-43e7-af6d-7c68a57edcb4/status  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"
  }
  "Attributes": {
  "ObjectType": "ProductUpgradeRequest"
  }
}

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 sikeres, ez a metódus egy ProductUpgradesEligibility erőforrást ad vissza a törzsben.

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 200 Ok
Content-Length: 150
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: cb82f7d6-f0d9-44d4-82f9-f6eee6e68390
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525
Date: Thu, 04 Oct 2019 20:35:35 GMT

{
    "id": "42d075a4-bfe7-43e7-af6d-7c68a57edcb4",
    "status": "Completed",
    "productFamily": "Azure",
    "lineItems": [
        {
            "sourceProduct": {
                "id": "b1beb621-3cad-4d7a-b360-62db33ce028e",
                "name": "AzureSubscription"
            },
            "targetProduct": {
                "id": "d231908e-31c1-de0e-027b-bc5ce11f09d9",
                "name": "Microsoft Azure plan"
            },
            "upgradedDate": "2019-08-29T23:47:28.8524555Z",
            "status": "Completed"
        }
    ]
}