Získání dostupnosti podle ID

Článek
11/05/2024

Získá dostupnost pro zadaný produkt a skladovou položku pomocí ID dostupnosti. ID dostupnosti jsou proměnlivá a dynamická, pravidelně se používají. Partneři by vždy měli mít jistotu, že při odesílání položek řádku košíku nebo provádění dalších aktivit, které vyžadují ID dostupnosti, vždy získáte aktuální dostupnost.

Požadavky

Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů aplikace i aplikace a uživatele.
ID produktu.
ID skladové položky.
ID dostupnosti.

C#

Pokud chcete získat podrobnosti o konkrétní dostupnosti, začněte postupem v části Získání skladové položky podle ID a získejte rozhraní pro konkrétní operace SKU . Z výsledného rozhraní vyberte vlastnost Dostupnost , abyste získali rozhraní s dostupnými operacemi pro dostupnost. Potom předejte ID dostupnosti metodě ById(), abyste získali operace pro danou konkrétní dostupnost, a pak zavolejte Get() nebo GetAsync() a načtěte podrobnosti o dostupnosti.

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

Sadu Java SDK Partnerského centra je možné použít ke správě prostředků Partnerského centra. Jedná se o opensourcový projekt spravovaný komunitou partnerů, který oficiálně nepodporuje Microsoft. Pokud narazíte na problém, můžete získat pomoc od komunity nebo otevřít problém na GitHubu .

Pokud chcete získat podrobnosti o konkrétní dostupnosti, začněte postupem v části Získání skladové položky podle ID a získejte rozhraní pro konkrétní operace SKU . Z výsledného rozhraní vyberte funkci getAvailabilities a získejte rozhraní s dostupnými operacemi pro dostupnost. Potom předejte ID dostupnosti funkci byId(), abyste získali operace pro danou konkrétní dostupnost, a pak zavolejte funkci get() a načtěte podrobnosti o dostupnosti.

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

Modul PowerShellu v Partnerském centru se dá použít ke správě prostředků Partnerského centra. Jedná se o opensourcový projekt spravovaný komunitou partnerů, který oficiálně nepodporuje Microsoft. Pokud narazíte na problém, můžete získat pomoc od komunity nebo otevřít problém na GitHubu .

Pokud chcete získat podrobnosti o konkrétní dostupnosti, spusťte Get-PartnerProductAvailability a zadejte parametry AvailabilityId, CountryCode, ProductId a SkuId pro načtení podrobností o dostupnosti.

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

Požadavek REST

Syntaxe požadavku

metoda	Identifikátor URI žádosti
GET	{baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities/{availability-id}?country={country-code} HTTP/1.1

Parametr identifikátoru URI

Pomocí následující cesty a parametrů dotazu získejte konkrétní dostupnost pomocí ID dostupnosti.

Name	Type	Požadováno	Popis
ID produktu	string	Ano	Řetězec formátovaný identifikátorem GUID, který identifikuje produkt.
SKU-ID	string	Ano	Formátovaný řetězec GUID, který identifikuje skladovou položku.
id dostupnosti	string	Ano	Řetězec formátovaný identifikátorem GUID, který identifikuje dostupnost.
kód země	string	Ano	ID země/oblasti.
IncludeLifeCycleState	string	No	Příznak řetězce, který může být nastaven na true pro vrácení hodnot stavu životního cyklu pro nabídky založené na nové komerční licenci. Pokud příznak nezahrnete, tyto hodnoty se nevrátí.

Záhlaví žádosti

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Nezaokrouhlovat.

Příklad požadavku

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: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
Host: api.partnercenter.microsoft.com

Důležité

Od června 2023 se teď archivuje nejnovější verze sady .NET SDK partnerského centra 3.4.0. Vydání sady SDK si můžete stáhnout z GitHubu spolu se souborem readme, který obsahuje užitečné informace.

Doporučujeme, aby partneři dál používali rozhraní REST API Partnerského centra.

Odpověď REST

V případě úspěchu obsahuje tělo odpovědi prostředek dostupnosti .

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který indikuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb v Partnerském centru.

Tato metoda vrátí následující kódy chyb:

Stavový kód HTTP	Kód chyby	Popis
404	400013	Produkt nebyl nalezen.
404	400018	Skladová položka nebyla nalezena.
404	400019	Dostupnost nebyla nalezena. K této chybě může dojít při rezervaci košíku. Partneři, kteří se zobrazí tuto chybu, by měli vydat novou funkci GET, aby měli aktuální ID dostupnosti a zkusili rezervovat košík znovu.

Příklad odpovědi pro rezervace virtuálních počítačů Azure (plán Azure)

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/10.0
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd,aaaa0000-bb11-2222-33cc-444444dddddd
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": []
        }
    }
}

Příklad odpovědi pro nové služby založené na obchodních licencích

Poznámka:

Nové komerční prostředí pro služby založené na licencích zahrnují mnoho nových funkcí a jsou k dispozici pro všechny poskytovatele cloudových řešení (CSP). Další informace najdete v přehledu nových obchodních prostředí.

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/10.0
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd,aaaa0000-bb11-2222-33cc-444444dddddd
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": []
        }
    }
}

Sdílet prostřednictvím