Delen via


Een product ophalen op basis van id

Hiermee haalt u de opgegeven productresource op met behulp van een product-id.

Voorwaarden

  • Referenties zoals beschreven in Partnercentrum-authenticatie. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.

  • Een product-id.

C#

Als u een specifiek product op id wilt zoeken, gebruikt u uw verzameling IAggregatePartner.Products, selecteert u het land met behulp van de methode ByCountry() en roept u de methode ById() aan. Roep tot slot de Get() of GetAsync() methode aan om het product te retourneren.

// IAggregatePartner partnerOperations;

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

Java

De Partner Center Java SDK- kan worden gebruikt voor het beheren van Partnercentrum-resources. Het is een opensource-project dat wordt onderhouden door de partnercommunity en niet officieel wordt ondersteund door Microsoft. U kunt hulp krijgen van de community of een probleem openen op GitHub als u een probleem ondervindt.

Als u een specifiek product op id wilt zoeken, gebruikt u uw functie IAggregatePartner.getProducts, selecteert u het land met behulp van de byCountry() functie en roept u vervolgens de byId() functie aan. Roep tot slot de functie get() get() aan om het product te retourneren.

// IAggregatePartner partnerOperations;

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

PowerShell

De PowerShell-module van partnercentrum kan worden gebruikt voor het beheren van Partnercentrum-resources. Het is een opensource-project dat wordt onderhouden door de partnercommunity en niet officieel wordt ondersteund door Microsoft. U kunt hulp krijgen van de community of een probleem openen op GitHub als u een probleem ondervindt.

Als u een specifiek product op id wilt zoeken, voert u de opdracht Get-PartnerProduct uit en geeft u de parameter ProductId op. De parameter CountryCode is opties, als deze niet is opgegeven, wordt het land gebruikt dat is gekoppeld aan de reseller.

Get-PartnerProduct -ProductId 'DZH318Z0BQ3Q'

REST-aanvraag

Aanvraagsyntaxis

Methode Aanvraag URI
GET- {baseURL}/v1/products/{product-id}?country={country} HTTP/1.1

URI-parameter

Gebruik de volgende padparameters om het opgegeven product op te halen.

Naam Soort Vereist Beschrijving
product-id snaar Ja Een tekenreeks die het product identificeert.
land koord Ja Een land-/regio-id.

Aanvraagkoppen

Zie Partnercentrum REST-headersvoor meer informatie.

Aanvraagbody

Geen.

Aanvraagvoorbeeld

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

REST-antwoord

Als dit lukt, bevat de antwoordtekst een Product-resource.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft of de aanvraag is geslaagd of mislukt en biedt aanvullende foutopsporingsinformatie. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Partnercentrum-foutcodesvoor de volledige lijst.

Deze methode retourneert de volgende foutcodes:

HTTP-statuscode Foutcode Beschrijving
404 400013 Het product is niet gevonden.

Antwoordvoorbeeld voor Azure VM-reservering (Azure-abonnement)

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

Antwoordvoorbeeld voor nieuw product op basis van handelslicenties

Notitie

De nieuwe commerce-ervaringen voor services op basis van licenties omvatten veel nieuwe mogelijkheden en zijn beschikbaar voor alle CSP's (Cloud Solution Provider). Zie overzicht van nieuwe commerce-ervaringenvoor meer informatie.

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