Abrufen einer SKU nach ID
Ruft eine SKU für das angegebene Produkt mithilfe der angegebenen SKU-ID ab.
Voraussetzungen
Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.
Eine Produkt-ID.
Eine SKU-ID.
C#
Um die Details einer bestimmten SKU abzurufen, führen Sie zunächst die Schritte unter "Produkt nach ID abrufen" aus, um die Schnittstelle für die Vorgänge eines bestimmten Produkts abzurufen. Wählen Sie auf der resultierenden Schnittstelle die Skus-Eigenschaft aus, um eine Schnittstelle mit den verfügbaren Vorgängen für SKUs abzurufen. Übergeben Sie die SKU-ID an die ById() -Methode, und rufen Sie Get() oder GetAsync() auf, um die SKU-Details abzurufen.
IAggregatePartner partnerOperations;
string countryCode;
string productId;
string skuId;
// Get the SKU details.
var sku = partnerOperations.Products.ByCountry(countryCode).ById(productId).Skus.ById(skuId).Get();
REST-Anforderung
Anforderungssyntax
| Methode | Anforderungs-URI |
|---|---|
| GET | {baseURL}/v1/products/{product-id}/skus/{sku-id}?country={country-code} HTTP/1.1 |
URI-Parameter
Verwenden Sie den folgenden Pfad und Abfrageparameter, um eine SKU für das angegebene Produkt mithilfe der angegebenen SKU-ID abzurufen.
| Name | Type | Erforderlich | Beschreibung |
|---|---|---|---|
| product-id | Zeichenfolge | Ja | Eine Zeichenfolge, die das Produkt identifiziert. |
| sku-id | Zeichenfolge | Ja | Eine Zeichenfolge, die die SKU identifiziert. |
| Ländercode | Zeichenfolge | Ja | Eine Landes-/Regions-ID. |
Anforderungsheader
Weitere Informationen finden Sie unter Partner Center-REST-Header.
Anforderungstext
Keine.
Beispiel für eine Anfrage
GET http://api.partnercenter.microsoft.com/v1/products/DZH318Z0BQ3V/skus/00G1?country=US HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e0ae69a5-6322-4d7e-809d-59e02b51d71f
MS-CorrelationId: 956eae17-7650-4470-94d2-4f61b9b02a23
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
MS-PartnerCenter-Application: Partner Center .NET SDK Samples
Host: api.partnercenter.microsoft.com
Wichtig
Ab Juni 2023 ist jetzt die neueste Partner Center .NET SDK-Version 3.4.0 archiviert. Sie können das SDK-Release von GitHub zusammen mit einer Infodatei herunterladen, die nützliche Informationen enthält.
Partnern wird empfohlen, weiterhin die Partner Center-REST-APIs zu verwenden.
REST-Antwort
Bei erfolgreicher Ausführung enthält der Antworttext eine SKU-Ressource .
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 |
|---|---|---|
| 404 | 400013 | Das Produkt wurde nicht gefunden. |
| 404 | 400018 | Die Sku wurde nicht gefunden. |
Antwortbeispiel für Azure VM Reservations (Azure Plan)
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/10.0
MS-CorrelationId: 956eae17-7650-4470-94d2-4f61b9b02a23,956eae17-7650-4470-94d2-4f61b9b02a23
MS-RequestId: e0ae69a5-6322-4d7e-809d-59e02b51d71f,e0ae69a5-6322-4d7e-809d-59e02b51d71f
X-Locale: en-US,en-US
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcbWFtZW5kZVxkZXZcZHBzLXJwZVxSUEUuUGFydG5lci5TZXJ2aWNlLkNhdGFsb2dcV2ViQXBpc1xDYXRhbG9nU2VydmljZS5WMi5XZWJcdjFccHJvZHVjdHNcRFpIMzE4WjBCUTNWXHNrdXNcMDBHMQ==?=
X-Powered-By: ASP.NET
Date: Thu, 15 Mar 2018 17:43:25 GMT
Content-Length: 1108
{
"id": "00G1",
"productId": "DZH318Z0BQ3V",
"title": "Reserved VM Instance, Standard_D32s_v3, US West 2, 3 Years",
"description": "Reserved Virtual Machines Instance, Standard_D32s_v3, US West 2, 3 Years",
"minimumQuantity": 1,
"maximumQuantity": 999999999,
"isTrial": false,
"supportedBillingCycles": [
"one_time"
],
"purchasePrerequisites": [
"AzureSubscriptionRegistration",
"InventoryCheck"
],
"inventoryVariables": [
"CustomerId",
"AzureSubscriptionId"
],
"provisioningVariables": [
"Scope",
"SubscriptionId"
],
"dynamicAttributes": {
"armSkuName": "Standard_D32s_v3",
"cores": "32",
"ram": "128",
"skuDisplayName": "D32s v3",
"category": "General purpose",
"armRegionName": "westus2",
"duration": "3Years",
"region": "US West 2",
"diskType": "Ssd"
},
"links": {
"availabilities": {
"uri": "/products/DZH318Z0BQ3V/skus/00G1/availabilities?country=us",
"method": "GET",
"headers": []
},
"self": {
"uri": "/products/DZH318Z0BQ3V/skus/00G1?country=us",
"method": "GET",
"headers": []
}
}
}
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.
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/10.0
MS-CorrelationId: e75c1060-852e-4b49-92b0-cd15167a0d51,e75c1060-852e-4b49-92b0-cd15167a0d51
MS-RequestId: 18b41adf-29b5-48eb-b14f-c9683a4e5b7d,18b41adf-29b5-48eb-b14f-c9683a4e5b7d
X-Locale: en-US,en-US
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcbWFtZW5kZVxkZXZcZHBzLXJwZVxSUEUuUGFydG5lci5TZXJ2aWNlLkNhdGFsb2dcV2ViQXBpc1xDYXRhbG9nU2VydmljZS5WMi5XZWJcdjFccHJvZHVjdHNcRFpIMzE4WjBCUTVTXHNrdXM=?=
X-Powered-By: ASP.NET
Date: Thu, 15 Mar 2018 21:06:03 GMT
Content-Length: 50917
{
"id": "0001",
"productId": "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.",
"minimumQuantity": 1,
"maximumQuantity": 300,
"isTrial": false,
"supportedBillingCycles": [
"annual",
"monthly"
],
"purchasePrerequisites": [
"MicrosoftCloudAgreement"
],
"inventoryVariables": [],
"provisioningVariables": [],
"actions": [
"Refund"
],
"dynamicAttributes": {
"isMicrosoftProduct": true,
"hasConstraints": true,
"isAddon": false,
"prerequisiteSkus": [],
"isSoftwareAssuranceApplicable": false,
"upgradeTargetOffers": [
"CFQ7TTC0LDPB:0001",
"CFQ7TTC0LF8Q:0001"
…
],
"provisioningId": "3b555118-da6a-4418-894f-7df1e2096870",
"internal": false
},
"links": {
"availabilities": {
"uri": "/products/CFQ7TTC0LH18/skus/0001/availabilities?country=US",
"method": "GET",
"headers": []
},
"self": {
"uri": "/products/CFQ7TTC0LH18/skus/0001?country=US",
"method": "GET",
"headers": []
}
}
}
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