Dela via


Hämta en lista över produkter (efter land/region)

gäller för: Partnercenter | Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud for US Government

Du kan använda följande metoder för att hämta en samling produkter som är tillgängliga i ett visst land/en viss region.

Förutsättningar

  • Autentiseringsuppgifter enligt beskrivningen i Partner Center-autentisering. Det här scenariot stöder autentisering med både fristående app- och App+User-autentiseringsuppgifter.

  • Ett land/en region.

C#

Så här hämtar du en lista över produkter:

  1. Använd din IAggregatePartner.Products-samling för att välja land/region med hjälp av metoden ByCountry().

  2. Välj katalogvyn med hjälp av metoden ByTargetView().

  3. (Valfritt) Välj reservationsomfånget med metoden ByReservationScope().

  4. (Valfritt) Välj målsegmentet med metoden ByTargetSegment().

  5. Anropa metoden Get() eller GetAsync() för att returnera samlingen.

IAggregatePartner partnerOperations;

// Get the products for the specified catalog view.
ResourceCollection<Products> products = partnerOperations.Products.ByCountry("US").ByTargetView("MicrosoftAzure").Get();

// Get the products filtered by target view and target segment.
ResourceCollection<Products> products = partnerOperations.Products.ByCountry("US").ByTargetView("MicrosoftAzure").ByTargetSegment("commercial").Get();

// Get the products for Azure reservations which are applicable to Microsoft Azure (MS-AZR-0145P) subscriptions only.
ResourceCollection<Product> products = partnerOperations.Products.ByCountry("US").ByTargetView("AzureReservations").Get();

// Get the products for Azure reservations which are applicable to Azure plans only.
ResourceCollection<Product> products = partnerOperations.Products.ByCountry("US").ByTargetView("AzureReservations").ByReservationScope("AzurePlan").Get();

Java

Java SDK för Partnercenter kan användas för att hantera Partnercenter-resurser. Det är ett projekt med öppen källkod som underhålls av partnercommunityn och stöds inte officiellt av Microsoft. Du kan få hjälp från communityn eller öppna ett problem på GitHub om du får problem.

Så här hämtar du en lista över produkter:

  1. Använd funktionen IAggregatePartner.getProducts för att välja land med hjälp av funktionen byCountry().

  2. Välj katalogvyn med hjälp av funktionen byTargetView().

  3. (Valfritt) Välj målsegmentet med hjälp av funktionen byTargetSegment().

  4. Anropa funktionen get() för att returnera samlingen.

// IAggregatePartner partnerOperations;

// Get the products for the specified catalog view.
ResourceCollection<Products> products = partnerOperations.getProducts().byCountry("US").byTargetView("Azure").get();

// Get the products filtered by target view and target segment.
ResourceCollection<Products> products = partnerOperations.getProducts().byCountry("US").byTargetView("Azure").byTargetSegment("commercial").get();

PowerShell

PowerShell-modulen Partner Center kan användas för att hantera Partnercenter-resurser. Det är ett projekt med öppen källkod som underhålls av partnercommunityn och stöds inte officiellt av Microsoft. Du kan få hjälp från communityn eller öppna ett problem på GitHub om du får problem.

Så här hämtar du en lista över produkter:

  1. Kör kommandot Get-PartnerProduct.

  2. Välj katalogen genom att ange parametern Catalog.

  3. (Valfritt) Välj målsegmentet genom att ange parametern Segment.

Get-PartnerProduct -Catalog 'Azure' -Segment 'commercial'

REST-begäran

Syntax för begäran

Metod Begäran-URI
GET {baseURL}/v1/products?country={country}&targetView={targetView}&targetSegment={targetSegment} HTTP/1.1

URI-parametrar

Använd följande sökväg och frågeparametrar för att hämta en lista över produkter.

Namn Typ Krävs Beskrivning
land sträng Ja Lands-/region-ID.
targetView sträng Ja Identifierar den önskade vyn av katalogen. De värden som stöds är:

Azure, som innehåller alla Azure-objekt

AzureReservations, som innehåller alla Azure-reservationsobjekt

AzureReservationsVM, som innehåller alla reservationsobjekt för virtuella datorer (VM)

AzureReservationsSQL, som innehåller alla SQL-reservationsobjekt

AzureReservationsCosmosDb, som innehåller alla Cosmos-databasreservationsobjekt

MicrosoftAzure, som innehåller objekt för Microsoft Azure-prenumerationer (MS-AZR-0145P) och Azure-abonnemang

OnlineServices, som innehåller alla onlinetjänstobjekt som traditionella licensbaserade tjänster och nya handelslicensbaserade tjänster.

Software, som innehåller alla programvaruobjekt

SoftwareSUSELinux, som innehåller alla SUSE Linux-objekt för programvara

SoftwarePerpetual, som innehåller alla eviga programvaruobjekt

SoftwareSubscriptions, som innehåller alla programprenumerationsobjekt

SpecializedOffers, som innehåller specialiserade erbjudanden som har gjorts tillgängliga för vissa partner

MarketplaceSaaS, som innehåller alla erbjudanden på den kommersiella marknadsplatsen som publicerats av oberoende programvaruleverantörer (ISV:er)
målsegment sträng Nej Identifierar målsegmentet. Vyn för olika målgrupper. De värden som stöds är:

kommersiella
utbildning
regeringen
ideella
reservationsomfattning sträng Nej När du frågar efter en lista över produkter för Azure-reservationer anger du reservationScope=AzurePlan för att hämta en lista över produkter som är tillämpliga på Azure-planer. Undanta den här parametern för att hämta en lista över produkter för Azure-reservationer, som gäller för Microsoft Azure -prenumerationer (MS-AZR-0145P).

Begärandehuvuden

För mer information, se Partner Center REST-huvuden.

Begärandetext

Ingen.

Exempel på begäran

Produkter efter land

Följ det här exemplet för att hämta en lista över produkter per land för Microsoft Azure-prenumerationer (MS-AZR-0145P) och Azure-planer.

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

Azure VM-reservationer (Azure-plan)

Följ det här exemplet för att hämta en lista över produkter per land för azure VM-reservationer som gäller för Azure-planer.

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

Azure VM-reservationer för Microsoft Azure-prenumerationerna (MS-AZR-0145P)

Följ det här exemplet för att hämta en lista över produkter per land för Azure VM-reservationer som gäller för Microsoft Azure-prenumerationer (MS-AZR-0145P).

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

Nya licensbaserade tjänster för handel

Not

De nya handelsupplevelserna för licensbaserade tjänster innehåller många nya funktioner och är tillgängliga för alla molnlösningsleverantörer (CSP:er). Mer information finns i översikt över nya handelsupplevelser.

Följ det här exemplet för att få en lista över produkter per land för nya licensbaserade tjänster för handel som en del av den nya tekniska förhandsversionen av handelsupplevelsen. Nya licensbaserade handelsrelaterade tjänster identifieras med ID- och visningsnamnsvärden för OnlineServicesNCE. Se svarsexemplet nedan.

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

REST-svar

Om det lyckas innehåller svarstexten en samling av resurserna produkt.

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i felkoder för Partnercenter.

Den här metoden returnerar följande felkoder:

HTTP-statuskod Felkod Beskrivning
403 400030 Åtkomst till det begärda targetSegment tillåts inte.
403 400036 Åtkomst till den begärda targetView tillåts inte.

Svarsexempel för Azure VM-reservationer (Azure-plan)

{
    "totalCount": 19,
    "items": [
        {
            "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": []
                }
            }
        },
        ...
    ],
    "links": {
        "self": {
            "uri": "/products?country=US&targetView=Azure",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
}

Svarsexempel för nya licensbaserade tjänster för handel

Anmärkning

De nya handelsupplevelserna för licensbaserade tjänster innehåller många nya funktioner och är tillgängliga för alla molnlösningsleverantörer (CSP:er). Mer information finns i översikt över nya handelsupplevelser.

{
  "totalCount": 19,
  "items": [{
      "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": []
        }
      }
    },
    ...
  ],
  "links": {
    "self": {
      "uri": "/products?country=US&targetView=OnlineServices",
      "method": "GET",
      "headers": []
    }
  },
  "attributes": {
    "objectType": "Collection"
  }
}