Een product ophalen op basis van id

Haalt de opgegeven productresource op met behulp van een product-id.

Vereisten

• Referenties zoals beschreven in Partnercentrum-verificatie. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als App+User-referenties.

• Een product-id.

C#

Als u een specifiek product wilt zoeken op id, gebruikt u uw verzameling IAggregatePartner.Products , selecteert u het land met behulp van de methode ByCountry() en roept u vervolgens de methode ById() aan. Roep ten slotte de methode Get() of GetAsync() 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 partnercentrumresources. Het is een opensource-project dat wordt beheerd 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 wilt zoeken op id, gebruikt u de functie IAggregatePartner.getProducts , selecteert u het land met behulp van de functie byCountry() en roept u vervolgens de functie byId() aan. Roep ten slotte de functie get() aan om het product te retourneren.

// IAggregatePartner partnerOperations;

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

PowerShell

De PowerShell-module partnercentrum kan worden gebruikt voor het beheren van partnercentrumresources. Het is een opensource-project dat wordt beheerd 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	Type	Vereist	Beschrijving
product-id	tekenreeks	Ja	Een tekenreeks die het product identificeert.
country	tekenreeks	Ja	Een land-/regio-id.

Aanvraagheaders

Zie Rest-headers van partnercentrum voor meer informatie.

Aanvraagbody

Geen.

Voorbeeld van aanvraag

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: 7c1f6619-c176-4040-a88f-2c71f3ba4533

REST-antwoord

Als dit lukt, bevat de antwoordtekst een productresource .

Geslaagde respons- en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die een geslaagde of mislukte status aangeeft en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Foutcodes partnercentrum voor de volledige lijst.

Deze methode retourneert de volgende foutcodes:

HTTP-statuscode	Foutcode	Beschrijving
404	400013	Kan het product niet vinden.

Antwoordvoorbeeld voor Azure VM-reservering (Azure-plan)

HTTP/1.1 200 OK
Content-Length: 1918
Content-Type: application/json
MS-CorrelationId: 7c1f6619-c176-4040-a88f-2c71f3ba4533
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": []
        }
    }
}

Voorbeeld van een antwoord voor een product op basis van een nieuwe commerce-licentie

Notitie

De nieuwe commerce-ervaringen voor services op basis van licenties bevatten veel nieuwe mogelijkheden en zijn beschikbaar voor alle CSP's (Cloud Solution Provider). Zie overzicht van nieuwe commerce-ervaringen voor 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": []
        }
    }
}