Abrufen einer Liste von Produkten (nach Land/Region)

Gilt für: Partner Center | Partner Center-Betrieb durch 21Vianet | Partner Center für Microsoft Cloud for US Government

Mit den folgenden Methoden können Sie eine Sammlung von Produkten abrufen, die in einem bestimmten Land/einer bestimmten Region verfügbar sind.

Voraussetzungen

• Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.

• Ein Land/eine Region.

C#

So rufen Sie eine Liste der Produkte ab:

1. Verwenden Sie Ihre IAggregatePartner.Products-Auflistung , um das Land/die Region mithilfe der ByCountry()- Methode auszuwählen.

2. Wählen Sie die Katalogansicht mit der ByTargetView()- Methode aus.

3. (Optional) Wählen Sie den Reservierungsbereich mithilfe der ByReservationScope()- Methode aus.

4. (Optional) Wählen Sie das Zielsegment mithilfe der ByTargetSegment()- Methode aus.

5. Rufen Sie die Methode Get() oder GetAsync() auf, um die Auflistung zurückzugeben.

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

Das Partner Center Java SDK kann zum Verwalten von Partner Center-Ressourcen verwendet werden. Es handelt sich um ein Open-Source-Projekt, das von der Partnercommunity verwaltet wird und von Microsoft nicht offiziell unterstützt wird. Sie können Hilfe von der Community erhalten oder ein Issue auf GitHub öffnen, wenn ein Problem auftritt.

So rufen Sie eine Liste der Produkte ab:

1. Verwenden Sie Ihre Funktion "IAggregatePartner.getProducts ", um das Land mithilfe der Funktion byCountry() auszuwählen.

2. Wählen Sie die Katalogansicht mithilfe der byTargetView() -Funktion aus.

3. (Optional) Wählen Sie das Zielsegment mithilfe der ByTargetSegment() -Funktion aus.

4. Rufen Sie die Get() -Funktion auf, um die Auflistung zurückzugeben.

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

Das Partner Center PowerShell-Modul kann zum Verwalten von Partner Center-Ressourcen verwendet werden. Es handelt sich um ein Open-Source-Projekt, das von der Partnercommunity verwaltet wird und von Microsoft nicht offiziell unterstützt wird. Sie können Hilfe von der Community erhalten oder ein Issue auf GitHub öffnen, wenn ein Problem auftritt.

So rufen Sie eine Liste der Produkte ab:

1. Führen Sie den Befehl "Get-PartnerProduct " aus.

2. Wählen Sie den Katalog aus, indem Sie den Parameter "Catalog" angeben.

3. (Optional) Wählen Sie das Zielsegment aus, indem Sie den Parameter Segment angeben.

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

REST-Anforderung

Anforderungssyntax

URI-Parameter

Verwenden Sie die folgenden Pfad- und Abfrageparameter, um eine Liste von Produkten abzurufen.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Keine.

Beispiele für Anforderungen

Produkte nach Land

Folgen Sie diesem Beispiel, um eine Liste der Produkte nach Land für Microsoft Azure -Abonnements (MS-AZR-0145P) und Azure-Pläne abzurufen.

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 Reservations (Azure-Plan)

Folgen Sie diesem Beispiel, um eine Liste der Produkte nach Land für Azure-VM-Reservierungen abzurufen, die für Azure-Pläne gelten.

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 Reservations für Microsoft Azure (MS-AZR-0145P)-Abonnements

Folgen Sie diesem Beispiel, um eine Liste der Produkte nach Land für Azure-VM-Reservierungen abzurufen, die für Microsoft Azure-Abonnements (MS-AZR-0145P) gelten.

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

Neue lizenzbasierte Dienste für den Handel

Folgen Sie diesem Beispiel, um eine Liste der Produkte nach Land für neue handelslizenzbasierte Dienste im Rahmen der technischen Vorschau der neuen Commerce-Erfahrung zu erhalten. Neue commerce-lizenzbasierte Dienste werden durch ID- und displayNames-Werte von OnlineServicesNCE identifiziert. Siehe Antwortbeispiel unten.

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

Bei erfolgreicher Ausführung enthält der Antworttext eine Sammlung von Produktressourcen.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-Fehlercodes.

Diese Methode gibt die folgenden Fehlercodes zurück:

Antwortbeispiel für Azure VM Reservations (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"
    }
}

Antwortbeispiel für neue commerce-lizenzbasierte Dienste

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