A rendelkezésre állás lekérése azonosító alapján

Cikk
10/13/2023

Lekéri a megadott termék és termékváltozat rendelkezésre állását egy rendelkezésre állási azonosító használatával. A rendelkezésre állási azonosítók változékonyak és dinamikusak, és rendszeresen újra ki vannak osztva. A partnereknek mindig meg kell győződniük arról, hogy a kosársorelemek elküldésekor vagy a rendelkezésre állási azonosítót igénylő egyéb tevékenységek végrehajtásakor mindig megkapják az aktuális rendelkezésre állá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 önálló alkalmazással és az App+Felhasználói hitelesítő adatokkal való hitelesítést is.
Termékazonosító.
Termékváltozat azonosítója.
Rendelkezésre állási azonosító.

C#

Egy adott rendelkezésre állás részleteinek lekéréséhez először az SKU-k lekérése azonosító alapján című lépésekkel szerezheti be egy adott termékváltozat műveleteinek felületét. Az eredményként kapott felületen válassza ki a Rendelkezésre állás tulajdonságot, és szerezze be a rendelkezésre állási műveletekhez használható felületet. Ezután adja át a rendelkezésre állási azonosítót a ById() metódusnak, hogy lekérje az adott rendelkezésre állás műveleteit, majd hívja meg a Get() vagy a GetAsync() függvényt a rendelkezésre állás részleteinek lekéréséhez.

IAggregatePartner partnerOperations;
string countryCode;
string productId;
string skuId;
string availabilityId;

// Get the availability details.
var availability = partnerOperations.Products.ByCountry(countryCode).ById(productId).Skus.ById(skuId).Availabilities.ById(availabilityId).Get();

Java

A Partnerközpont Java SDK-val kezelheti a Partnerközpont erőforrásait. Ez egy nyílt forráskódú projekt, amelyet a partnerközösség tart fenn, és amelyet a Microsoft hivatalosan nem támogat. Ha problémát tapasztal, segítséget kérhet a közösségtől, vagy problémákat nyithat meg a GitHubon.

Egy adott rendelkezésre állás részleteinek lekéréséhez először az SKU-k lekérése azonosító alapján című lépésekkel szerezheti be egy adott termékváltozat műveleteinek felületét. Az eredményként kapott felületen válassza ki a getAvailabilities függvényt a rendelkezésre állási lehetőségekhez elérhető műveletekkel rendelkező felület beszerzéséhez. Ezután adja át a rendelkezésre állási azonosítót a byId() függvénynek az adott rendelkezésre állás műveleteinek lekéréséhez, majd hívja meg a get() függvényt a rendelkezésre állás részleteinek lekéréséhez.

IAggregatePartner partnerOperations;
String countryCode;
String productId;
String skuId;
String availabilityId;

// Get the availability details.
Availability availability = partnerOperations.getProducts().byCountry(countryCode).byId(productId).getSkus().byId(skuId).getAvailabilities().byId(availabilityId).get();

PowerShell

A Partnerközpont PowerShell-modulja a Partnerközpont erőforrásainak kezelésére használható. Ez egy nyílt forráskódú projekt, amelyet a partnerközösség tart fenn, és amelyet a Microsoft hivatalosan nem támogat. Ha problémát tapasztal, segítséget kérhet a közösségtől, vagy problémákat nyithat meg a GitHubon.

Egy adott rendelkezésre állás részleteinek lekéréséhez hajtsa végre a Get-PartnerProductAvailability parancsot, és adja meg a Rendelkezésre állási azonosító, a CountryCode, a ProductId és az SkuId paramétereket a rendelkezésre állási adatok lekéréséhez.

Get-PartnerProductAvailability -Product $productId -SkuId $skuId -AvailabilityId $availabilityId

REST-kérés

Kérés szintaxisa

Metódus	Kérés URI-ja
GET	{baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities/{availability-id}?country={country-code} HTTP/1.1

URI-paraméter

Az alábbi elérési út és lekérdezési paraméterek használatával lekérhet egy adott rendelkezésre állást egy rendelkezésre állási azonosító használatával.

Név	Típus	Kötelező	Leírás
termékazonosító	sztring	Igen	A terméket azonosító GUID formátumú sztring.
termékváltozat azonosítója	sztring	Igen	A termékváltozatot azonosító GUID formátumú sztring.
rendelkezésre állási azonosító	sztring	Igen	A rendelkezésre állást azonosító GUID formátumú sztring.
országkód	sztring	Igen	Egy ország/régió azonosítója.

Kérésfejlécek

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

Kérés törzse

Nincs.

Példa kérése

GET http://api.partnercenter.microsoft.com/v1/products/DZH318Z0BQ3Q/skus/0001/availabilities/DZH318XZXPHL?country=US HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 2e12a576-ded5-437e-a5ec-dbfbcbd1624c
MS-CorrelationId: 83b644b5-e54a-4bdc-b354-f96c525b3c58
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
Host: api.partnercenter.microsoft.com

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, a válasz törzse rendelkezésre állási erőforrást tartalmaz.

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 hibakódjaiban találja.

Ez a metódus a következő hibakódokat adja vissza:

HTTP-állapotkód	Hibakód	Leírás
404	400013	A termék nem található.
404	400018	A termékváltozat nem található.
404	400019	A rendelkezésre állás nem található. Ez a hiba akkor fordulhat elő, ha kivesz egy bevásárlókocsit. A hibát kapó partnereknek új GET-t kell kiadniuk, hogy meggyőződjenek arról, hogy rendelkeznek az aktuális rendelkezésre állási azonosítóval, és újra megkísérlik a kosár kivételét.

Válasz példa azure-beli virtuálisgép-foglalásokhoz (Azure-csomag)

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/10.0
MS-CorrelationId: 83b644b5-e54a-4bdc-b354-f96c525b3c58,83b644b5-e54a-4bdc-b354-f96c525b3c58
MS-RequestId: 2e12a576-ded5-437e-a5ec-dbfbcbd1624c,2e12a576-ded5-437e-a5ec-dbfbcbd1624c
X-Locale: en-US,en-US
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcbWFtZW5kZVxkZXZcZHBzLXJwZVxSUEUuUGFydG5lci5TZXJ2aWNlLkNhdGFsb2dcV2ViQXBpc1xDYXRhbG9nU2VydmljZS5WMi5XZWJcdjFccHJvZHVjdHNcRFpIMzE4WjBCUTNRXHNrdXNcMDAwMVxhdmFpbGFiaWxpdGllc1xEWkgzMThaMEhNS1E=?=
X-Powered-By: ASP.NET
Date: Wed, 14 Mar 2018 22:19:43 GMT
Content-Length: 440

{
    "id": "DZH318XZXPHL",
    "productId": "DZH318Z0BQ3Q",
    "skuId": "0001",
    "catalogItemId": "DZH318Z0BQ3Q:0001:DZH318XZXPHL",
    "defaultCurrency": {
        "code": "USD",
        "symbol": "$"
    },
    "segment": "commercial",
    "country": "US",
    "isPurchasable": true,
    "isRenewable": false,
    "terms": [{
        "duration": "P1Y",
        "description": "1 Year Prepaid"
    }],
    "product": { ... },
    "sku": { ... },
    "links": {
        "self": {
            "uri": "/products/DZH318Z0BQ3Q/skus/0001/availabilities/DZH318XZXPHL?country=US",
            "method": "GET",
            "headers": []
        }
    }
}

Válasz példa új kereskedelmi licencalapú szolgáltatásokhoz

Feljegyzés

A licencalapú szolgáltatások új kereskedelmi szolgáltatásai számos új képességet tartalmaznak, és minden Felhőszolgáltató (CSP) számára elérhetők. További információkért tekintse meg az új kereskedelmi szolgáltatások áttekintését.

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/10.0
MS-CorrelationId: 83b644b5-e54a-4bdc-b354-f96c525b3c58,83b644b5-e54a-4bdc-b354-f96c525b3c58
MS-RequestId: 70324727-62d8-4195-8f99-70ea25058d02,70324727-62d8-4195-8f99-70ea25058d02
X-Locale: en-US,en-US
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcbWFtZW5kZVxkZXZcZHBzLXJwZVxSUEUuUGFydG5lci5TZXJ2aWNlLkNhdGFsb2dcV2ViQXBpc1xDYXRhbG9nU2VydmljZS5WMi5XZWJcdjFccHJvZHVjdHNcRFpIMzE4WjBCUTNRXHNrdXNcMDAwMVxhdmFpbGFiaWxpdGllcw==?=
X-Powered-By: ASP.NET
Date: Wed, 14 Mar 2018 22:19:37 GMT
Content-Length: 808

{
    "id": "CFQ7TTC0K971",
    "productId": "CFQ7TTC0LH18",
    "skuId": "0001",
    "catalogItemId": "CFQ7TTC0LH18:0001:CFQ7TTC0K971",
    "defaultCurrency": {
        "code": "USD",
        "symbol": "$"
    },
    "segment": "commercial",
    "country": "US",
    "isPurchasable": true,
    "isRenewable": true, 
    "renewalInstructions": [
        {
            "applicableTermIds": [
                "5aeco6mffyxo"
            ],
            "renewalOptions": [
                {
                    "renewToId": "CFQ7TTC0LH18:0001",
                    "isAutoRenewable": true
                }
            ]
        },
	 …
    ],
    "terms": [
        {
            "id": "5aeco6mffyxo",
            "duration": "P1Y",
            "description": "One-Year commitment for monthly/yearly billing",
            "billingCycle": "Annual",
            "cancellationPolicies": [
                {
                    "refundOptions": [
                        {
                            "sequenceId": 0,
                            "type": "Full",
                            "expiresAfter": "P1D"
                        }
                    ]
                }
            ]
        },
       …
    ],
    "product": { ... },
    "sku": { ... },
    "links": {
        "self": {
            "uri": "/products/CFQ7TTC0LH18/skus/0001/availabilities/CFQ7TTC0K971?country=US",
            "method": "GET",
            "headers": []
        }
    }
}