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:
Verwenden Sie Ihre IAggregatePartner.Products-Auflistung , um das Land/die Region mithilfe der ByCountry()- Methode auszuwählen.
Wählen Sie die Katalogansicht mit der ByTargetView()- Methode aus.
(Optional) Wählen Sie den Reservierungsbereich mithilfe der ByReservationScope()- Methode aus.
(Optional) Wählen Sie das Zielsegment mithilfe der ByTargetSegment()- Methode aus.
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, Standard von der Partnercommunity unterstützt und nicht offiziell von Microsoft 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:
Verwenden Sie Ihre Funktion "IAggregatePartner.getProducts ", um das Land mithilfe der Funktion byCountry() auszuwählen.
Wählen Sie die Katalogansicht mithilfe der byTargetView() -Funktion aus.
(Optional) Wählen Sie das Zielsegment mithilfe der ByTargetSegment() -Funktion aus.
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, Standard von der Partnercommunity unterstützt und nicht offiziell von Microsoft 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:
Führen Sie den Befehl "Get-PartnerProduct " aus.
Wählen Sie den Katalog aus, indem Sie den Parameter "Catalog" angeben.
(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 | Nein | Identifiziert das Zielsegment. Die Ansicht für unterschiedliche Zielgruppen. Die unterstützten Werte sind: Kommerziell education government Gemeinnützige |
| reservationScope | Zeichenfolge | Nein | 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: 7c1f6619-c176-4040-a88f-2c71f3ba4533
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: 7c1f6619-c176-4040-a88f-2c71f3ba4533
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: 7c1f6619-c176-4040-a88f-2c71f3ba4533
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: 7c1f6619-c176-4040-a88f-2c71f3ba4533
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"
}
}
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für