Dela via

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

  • Artikel

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 Partnercenter-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 samlingen IAggregatePartner.Products 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 hjälp av metoden ByReservationScope().

  4. (Valfritt) Välj målsegmentet med hjälp av 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 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. Kör kommandot Get-PartnerProduct.

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

  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 URI för förfrågan
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 Obligatoriskt Beskrivning
land string Ja Lands-/region-ID.
targetView sträng Ja Identifierar katalogens målvy. 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.

Programvara, 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 inkluderar 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)
targetSegment sträng Nej Identifierar målsegmentet. Vyn för olika målgrupper. De värden som stöds är:

kommersiell
utbildning
regering
ideell
reservationScope 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

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

Inga.

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-prenumerationer (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

Kommentar

De nya handelsupplevelserna för licensbaserade tjänster innehåller många nya funktioner och är tillgängliga för alla Dobavljač rešenja u oblaku (CSP:er). Mer information finns i översikten ö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 tjänster för handel identifieras med ID- och displayNames-vä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 produktresurser.

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

Kommentar

De nya handelsupplevelserna för licensbaserade tjänster innehåller många nya funktioner och är tillgängliga för alla Dobavljač rešenja u oblaku (CSP:er). Mer information finns i översikten ö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"
  }
}