Sdílet prostřednictvím


Získat dostupnost podle ID

Získá dostupnost pro zadaný produkt a skladovou položku pomocí ID dostupnosti. ID dostupnosti jsou proměnlivá a dynamická, pravidelně se obnovují. 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 uvedené v části Ověřování Partner Center. Tento scénář podporuje ověřování jak pomocí samostatných přihlašovacích údajů aplikace, tak prostřednictvím přihlašovacích údajů pro aplikaci 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

Java SDK Partnerského centra lze 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 Typ Požadováno Popis
ID produktu řetězec Ano Řetězec ve formátu GUID, který identifikuje produkt.
SKU-ID řetězec Ano Formátovaný řetězec GUID, který identifikuje skladovou položku.
id dostupnosti řetězec Ano Řetězec ve formátu GUID, který identifikuje dostupnost.
kód země řetězec Ano ID země/oblasti.
ZahrnoutStavŽivotníhoCyklu řetězec Ne Řetězcový příznak, který může být nastaven na hodnotu "true", aby vrátil hodnoty stavu životního cyklu pro nabídky založené na nové komerční licenci. Pokud příznak nezahrnete, tyto hodnoty se nevrátí.

Hlavičky žádosti

Další informace viz Hlavičky REST Partnerského centra.

Text požadavku

Žádný.

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 zdroj 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 dokončování nákupu. Partneři, kteří se setkají s touto chybou, by měli provést nový GET, aby měli aktuální ID dostupnosti a zkusili znovu dokončit nákup v košíku.

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": []
        }
    }
}