Abrufen einer Liste von Produkten (nach Kunde)
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 für einen vorhandenen Kunden abrufen.
Voraussetzungen
Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.
Eine Kunden-ID (
customer-tenant-id). Wenn Sie die KUNDEN-ID nicht kennen, können Sie sie im Partner Center nachschlagen, indem Sie den Arbeitsbereich "Kunden " und dann den Kunden aus der Kundenliste und dann "Konto" auswählen. Suchen Sie auf der Kontoseite des Kunden im Abschnitt Kundenkontoinfo nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id).
REST-Anforderung
Anforderungssyntax
| Methode | Anforderungs-URI |
|---|---|
| POST | {baseURL}/v1/customers/{customer-tenant-id}/products?targetView={targetView} HTTP/1.1 |
URI-Parameter der Anforderung
| Name | Type | Erforderlich | Beschreibung |
|---|---|---|---|
| customer-tenant-id | GUID | Ja | Der Wert ist eine als GUID formatierte customer-tenant-id, bei der es sich um einen Bezeichner handelt, mit dem Sie einen Kunden angeben können. |
| 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 enthält. Diese TargetView umfasst kommerziellen Marketplace, herkömmliche lizenzbasierte Dienste und neue kommerzielle Lizenzdienste. 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 |
Anforderungsheader
Weitere Informationen finden Sie unter Partner Center-REST-Header.
Anforderungstext
Keine.
Beispiel für eine Anfrage
Fordern Sie eine Liste der nutzungsbasierten Azure-Produkte an, die einem bestimmten Kunden zur Verfügung stehen. Produkte für Microsoft Azure (MS-AZR-0145P) und Azure-Pläne werden für Kunden in der öffentlichen Cloud zurückgegeben:
GET https://api.partnercenter.microsoft.com/v1/customers/65543400-f8b0-4783-8530-6d35ab8c6801/products?targetView=MicrosoftAzure HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 83643f5e-5dfd-4375-88ed-054412460dc8
MS-CorrelationId: b1939cb2-e83d-4fb0-989f-514fb741b734
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/Region für neue lizenzbasierte Commerce-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/customers/65543400-f8b0-4783-8530-6d35ab8c6801/products?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
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 | 400036 | Der Zugriff auf die angeforderte targetView ist nicht zulässig. |
Antwortbeispiel für Microsoft Azure und Azure-Plan
HTTP/1.1 200 OK
Content-Length: 1909
Content-Type: application/json; charset=utf-8
MS-CorrelationId: cad955c2-8efc-47fe-b112-548ff002ba18
MS-RequestId: ae7288e2-2673-4ad4-8c12-7aad818d5949
{
"totalCount": 2,
"items": [
{
"id": "MS-AZR-0145P",
"productId": "9DEA7946-EC2C-441E-9FFD-E3B275F7E838",
"title": "Microsoft Azure",
"description": "Azure Cloud Solution Provider offer for Partner and Resellers",
"minimumQuantity": 1,
"maximumQuantity": 1,
"isTrial": false,
"supportedBillingCycles": [
"monthly"
],
"purchasePrerequisites": [
"MicrosoftCloudAgreement"
],
"actions": [
"Refund"
],
"dynamicAttributes": {
"isMicrosoftProduct": true,
"billingType": "usage",
"category": "Enterprise",
"isAddon": false,
"prerequisiteSkus": [],
"rank": 1413,
"hasAddOns": false,
"isAutoRenewable": false,
"upgradeTargetOffers": null,
"conversionTargetOffers": [],
"unitType": "Usage-based",
"limitUnitOfMeasure": "None",
"limit": 0,
"reselleeQualifications": [],
"resellerQualifications": []
},
"links": {
"availabilities": {
"uri": "/products/9DEA7946-EC2C-441E-9FFD-E3B275F7E838/skus/MS-AZR-0145P/availabilities?country=US&targetSegment=Commercial",
"method": "GET",
"headers": []
},
"self": {
"uri": "/products/9DEA7946-EC2C-441E-9FFD-E3B275F7E838/skus/MS-AZR-0145P?country=US",
"method": "GET",
"headers": []
}
}
},
{
"id": "0001",
"productId": "DZH318Z0BPS6",
"title": "Microsoft Azure plan",
"description": "Microsoft Azure plan (MS-AZR-0017G)",
"minimumQuantity": 1,
"maximumQuantity": 1,
"isTrial": false,
"supportedBillingCycles": [
"one_time"
],
"purchasePrerequisites": [
"MicrosoftCustomerAgreement"
],
"inventoryVariables": [],
"provisioningVariables": [],
"actions": [
"Refund"
],
"dynamicAttributes": {
"isMicrosoftProduct": true,
"pilotProgram": "modernazurepilot"
},
"links": {
"availabilities": {
"uri": "/products/DZH318Z0BPS6/skus/0001/availabilities?country=US&targetSegment=Commercial",
"method": "GET",
"headers": []
},
"self": {
"uri": "/products/DZH318Z0BPS6/skus/0001?country=US",
"method": "GET",
"headers": []
}
}
}
],
"links": {
"self": {
"uri": "/customers/e2a0c0f3-0f74-4d1c-808c-dfa511481913/products/all/skus?targetView=MicrosoftAzure&targetSegment=Commercial",
"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