Sdílet prostřednictvím


Získání produktu podle ID

Získá zadaný prostředek produktu pomocí produktového ID.

Požadavky

  • Přihlašovací údaje, jak je popsáno v ověřování v Partnerském centru. Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů pro aplikaci a pro aplikaci i uživatele.

  • ID produktu.

C#

Pokud chcete vyhledat konkrétní produkt podle ID, použijte kolekci IAggregatePartner.Products, vyberte zemi pomocí metody ByCountry() a pak volejte metodu ById(). Nakonec zavolejte metodu Get() nebo GetAsync() k vrácení produktu.

// IAggregatePartner partnerOperations;

Product productDetail = partnerOperations.Products.ByCountry("US").ById("DZH318Z0BQ3Q").Get();

Java

Sadu Partner Center Java SDK 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 najít konkrétní produkt podle ID, použijte funkci IAggregatePartner.getProduct s, vyberte zemi pomocí funkce byCountry() a pak volejte funkci byId(). Nakonec zavolejte funkci get() k vrácení produktu.

// IAggregatePartner partnerOperations;

Product productDetail = partnerOperations.getProducts().byCountry("US").byId("DZH318Z0BQ3Q").get();

PowerShell

K správě prostředků v Partnerském centru je možné použít modul Prostředí PowerShell. 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 založit issue na GitHubu.

Pokud chcete vyhledat konkrétní produkt podle ID, spusťte příkaz Get-PartnerProduct a zadejte parametr ProductId. Parametr CountryCode je možnost, pokud není zadaný, použije se země přidružená k prodejci.

Get-PartnerProduct -ProductId 'DZH318Z0BQ3Q'

Požadavek REST

Syntaxe požadavku

Metoda Požadavek URI
GET {baseURL}/v1/products/{id_produktu}?country={country} HTTP/1.1

Parametr identifikátoru URI

K získání zadaného produktu použijte následující parametry cesty.

Jméno Typ Povinný Popis
ID produktu řetězec Ano Řetězec, který identifikuje produkt.
země řetězec Ano ID země/oblasti.

Hlavičky požadavku

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

Text požadavku

Žádný.

Příklad požadavku

GET https://api.partnercenter.microsoft.com/v1/products/{product-id}?country=US HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

Odpověď REST

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

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

Každá odpověď obsahuje stavový kód HTTP, který označuje ú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 seznamu kódů chyb Partnerského centra.

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

Stavový kód HTTP Kód chyby Popis
404 400013 Produkt nebyl nalezen.

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

HTTP/1.1 200 OK
Content-Length: 1918
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: ac943950-ba3d-47a0-bd2a-c5617a7fefe8
Date: Tue, 23 Jan 2018 23:13:01 GMT

{
    "id": "DZH318Z0BQ3Q",
    "title": "Virtual Machines DSv2 Series",
    "description": "Dsv2-series instances are the latest generation of D-series instances that will carry more powerful CPUs which are on average about 35% faster than D-series instances, and carry the same memory and disk configurations as the D-series. Dsv2-series instances are based on the latest generation 2.4 GHz Intel Xeon® E5-2673 v3 (Haswell) processor, and with Intel Turbo Boost Technology 2.0 can go to 3.2 GHz.",
    "productType": {
        "id": "Azure",
        "displayName": "Azure",
        "subType": {
            "id": "VirtualMachines",
            "displayName": "VirtualMachines"
        }
    },
    "isMicrosoftProduct": true,
    "publisherName": "Microsoft",
    "links": {
        "skus": {
            "uri": "/products/DZH318Z0BQ3Q/skus?country=US",
            "method": "GET",
            "headers": []
        },
        "self": {
            "uri": "/products/DZH318Z0BQ3Q?country=US",
            "method": "GET",
            "headers": []
        }
    }
}

Příklad odpovědi na nový produkt založený na komerční licenci

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 tématu přehled nových obchodních prostředí.

{
    "id": "CFQ7TTC0LH18",
    "title": "Microsoft 365 Business Basic",
    "description": "Best for businesses that need professional email, cloud file storage, and online meetings & chat. Desktop versions of Office apps like Excel, Word, and PowerPoint not included. For businesses with up to 300 employees.",
    "productType": {
        "id": "OnlineServicesNCE",
        "displayName": "OnlineServicesNCE"
    },
    "isMicrosoftProduct": true,
    "publisherName": "Microsoft Corporation",
    "links": {
        "skus": {
            "uri": "/products/CFQ7TTC0LH18/skus?country=US",
            "method": "GET",
            "headers": []
        },
        "self": {
        "uri": "/products/CFQ7TTC0LH18?country=US",
            "method": "GET",
            "headers": []
        }
    }
}