Termékek listájának lekérése (ország/régió szerint)

A következővonatkozik: Partnerközpont | A 21Vianet által üzemeltetett Partnerközpont | Partnerközpont a Microsoft Cloud for US Government számára

Az alábbi módszerekkel beszerezheti egy adott országban/régióban elérhető termékek gyűjteményét.

Előfeltételek

• A hitelesítő adatok, ahogyan a(z) Partnerközpont hitelesítés leírja. Ez a forgatókönyv támogatja az önálló alkalmazással és az App+Felhasználói hitelesítő adatokkal való hitelesítést is.

• Egy ország/régió.

C#

A termékek listájának lekérése:

1. Az IAggregatePartner.Products gyűjtemény használatával válassza ki az országot/régiót a ByCountry() metódussal.

2. Válassza ki a katalógusnézetet a ByTargetView() metódussal.

3. (Nem kötelező) Válassza ki a foglalási hatókört a ByReservationScope() metódus használatával.

4. (Nem kötelező) Válassza ki a célszegmenst a ByTargetSegment() metódussal.

5. Hívja meg a Get() vagy GetAsync() metódust a gyűjtemény visszaadásához.

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();

Jáva

A Partnerközpont Java SDK használható a Partnerközpont erőforrásainak kezelésére. Ez egy nyílt forráskódú projekt, amelyet a partnerközösség tart fenn, és amelyet a Microsoft hivatalosan nem támogat. Ha problémát tapasztal, kérhet segítséget a közösségtől, vagy hozzon létre egy hibajegyet a GitHubon.

A termékek listájának lekérése:

1. Használja a IAggregatePartner.getProducts függvényt, hogy kiválassza az országot a byCountry() függvény használatával.

2. Válassza ki a katalógusnézetet a byTargetView() függvény használatával.

3. (Nem kötelező) Válassza ki a célszegmenst a byTargetSegment() függvény használatával.

4. Hívja meg a get() függvényt a gyűjtemény visszaadásához.

// 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

A Partnerközpont PowerShell-modulja használható a Partnerközpont erőforrásainak kezelésére. Ez egy nyílt forráskódú projekt, amelyet a partnerközösség tart fenn, és amelyet a Microsoft hivatalosan nem támogat. Ha problémát tapasztal, kérhet segítséget a közösségtől, vagy hozzon létre egy hibajegyet a GitHubon.

A termékek listájának lekérése:

1. Hajtsa végre a Get-PartnerProduct parancsot.

2. Válassza ki a katalógust a katalógus paraméter megadásával.

3. (Nem kötelező) Válassza ki a célszegmenst a Szegmens paraméter megadásával.

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

REST-kérés

Kérés szintaxisa

URI-paraméterek

A termékek listájának lekéréséhez használja az alábbi elérési utat és lekérdezési paramétereket.

Kérelemfejlécek

További információért lásd: Partnerközpont REST-fejlécei.

Kérelem tartalma

Egyik sem.

Kérjen példákat

Termékek országonként

Kövesse ezt a példát a Microsoft Azure -előfizetések és Azure-csomagok termékek országonkénti listájának lekéréséhez.

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 virtuális gép foglalások (Azure-csomag)

Ezt a példát követve országonként lekérheti az Azure-beli virtuálisgép-foglalások termékeinek listáját, amelyek az Azure-csomagokra vonatkoznak.

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 virtuális gép foglalások Microsoft Azure előfizetésekhez (MS-AZR-0145P)

Kövesse ezt a példát a Microsoft Azure-előfizetésekre (MS-AZR-0145P) vonatkozó Azure-beli virtuálisgép-foglalások termékeinek országonkénti listájához.

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

Új kereskedelmi licencalapú szolgáltatások

Ezt a példát követve országonként lekérheti az új kereskedelmi licencalapú szolgáltatásokhoz tartozó termékek listáját az új kereskedelmi felület technikai előzetes verziójának részeként. Az új kereskedelmi licencalapú szolgáltatásokat a OnlineServicesNCEazonosító és displayNames értékei azonosítják. Lásd az alábbi válasz példáját.

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-válasz

Ha sikeres, a válasz törzse Termék-erőforrások gyűjteményét tartalmazza.

Válasz sikeresség és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. A kód, a hibatípus és a további paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes listáért lásd a Partnerközpont hibakódjai.

Ez a metódus a következő hibakódokat adja vissza:

Példa a válaszra Azure-beli virtuális gép foglalásokra (Azure-terv)

{
    "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"
    }
}

Válasz példa új kereskedelmi licencalapú szolgáltatásokhoz

{
  "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"
  }
}