Teilen über

Abrufen einer Liste von Produkten (nach Land/Region)

  • Artikel

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

Methode Anforderungs-URI
GET {baseURL}/v1/products?country={country}&targetView={targetView}&targetSegment={targetSegment} HTTP/1.1

URI-Parameter

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

Name Type Erforderlich Beschreibung
country Zeichenfolge Ja Die Landes-/Regions-ID
targetView Zeichenfolge Ja Identifiziert die Zielansicht des Katalogs. Die unterstützten Werte sind:

Azure, das alle Azure-Elemente enthält

AzureReservations, das alle Azure-Reservierungselemente enthält

AzureReservationsVM, das alle Reservierungselemente des virtuellen Computers (VM) enthält

AzureReservationsSQL, das alle SQL-Reservierungselemente enthält

AzureReservationsCosmosDb, das alle Cosmos-Datenbankreservierungselemente enthält

MicrosoftAzure, das Elemente für Microsoft Azure-Abonnements (MS-AZR-0145P) und Azure-Pläne enthält

OnlineServices, die alle Onlinedienstelemente wie herkömmliche lizenzbasierte Dienste und neue, lizenzbasierte Dienste umfassen.

Software, die alle Softwareelemente enthält

SoftwareSUSELinux, die alle Software-SUSE Linux-Elemente enthält

SoftwarePerpetual, das alle unbefristeten Softwareelemente enthält

SoftwareSubscriptions, die alle Softwareabonnementelemente enthält

SpecializedOffers, das spezielle Angebote enthält, die einigen Partnern zur Verfügung gestellt wurden

MarketplaceSaaS, das alle kommerziellen Marketplace-Angebote umfasst, die von unabhängigen Softwareanbietern (ISVs) veröffentlicht werden
targetSegment Zeichenfolge No Identifiziert das Zielsegment. Die Ansicht für unterschiedliche Zielgruppen. Die unterstützten Werte sind:

Kommerziell
education
government
gemeinnützig
reservationScope Zeichenfolge No Geben Sie reservationScope=AzurePlan beim Abfragen einer Liste von Produkten für Azure Reservations an, um eine Liste der Produkte abzurufen, die für Azure-Pläne gelten. Schließen Sie diesen Parameter aus, um eine Liste der Produkte für Azure-Reservierungen abzurufen, die für Microsoft Azure-Abonnements (MS-AZR-0145P) gelten.

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

Hinweis

Die neuen Commerce-Umgebungen für lizenzbasierte Dienste enthalten zahlreiche neue Funktionen und stehen allen Cloud Solution Providern (CSP) zur Verfügung. Weitere Informationen finden Sie in der Übersicht über neue Commerce-Erfahrungen.

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:

HTTP-Statuscode Fehlercode BESCHREIBUNG
403 400030 Der Zugriff auf das angeforderte targetSegment ist nicht zulässig.
403 400036 Der Zugriff auf die angeforderte targetView ist nicht zulässig.

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

Hinweis

Die neuen Commerce-Umgebungen für lizenzbasierte Dienste enthalten zahlreiche neue Funktionen und stehen allen Cloud Solution Providern (CSP) zur Verfügung. Weitere Informationen finden Sie in der Übersicht über neue Commerce-Erfahrungen.

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