Ändern eines Kundenabonnements Abrechnungszeitraum
Gilt für: Partner Center | Partner Center-Betrieb durch 21Vianet | Partner Center für Microsoft Cloud for US Government
Tipp
Mit dieser API können Sie Ihre Abrechnungshäufigkeit nur für Ältere Abonnements ändern.
Um Ihre Abrechnungshäufigkeit für New Commerce Experience (NCE)-Abonnements und ältere Abonnements zu ändern, können Sie ein Abonnement nach ID – Partner-App-Entwickler | Microsoft Learn-API .
Aktualisiert eine Bestellung von monatlich auf jährliche Abrechnung oder von jährlicher bis monatlicher Abrechnung.
In Partner Center kann dieser Vorgang ausgeführt werden, indem er zur Abonnementdetailseite eines Kunden navigiert. Sobald sie vorhanden ist, wird eine Option zum Definieren der aktuellen Abrechnungszeitraum für das Abonnement mit der Möglichkeit angezeigt, es zu ändern und zu übermitteln.
Außerhalb des Umfangs für diesen Artikel:
- Ändern der Abrechnungszeitraum für Testversionen
- Ändern der Abrechnungszeitraum für nicht jährliche Laufzeitangebote (monatliche, sechsjährige) & Azure-Abonnements
- Ändern der Abrechnungszeitraum für inaktive Abonnements
- Ändern von Abrechnungszeitraum s für Microsoft Onlinedienste lizenzbasierte Abonnements
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 Seite "Konto" des Kunden im Abschnitt "Kundenkontoinformationen" nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id).Eine Auftrags-ID.
C#
Aktualisieren Sie die Order.BillingCycle-Eigenschaft, um die Häufigkeit des Abrechnungszeitraum zu ändern.
// IAggregatePartner partnerOperations;
// string customerId;
// string offerId;
// string orderId;
var order = new Order()
{
ReferenceCustomerId = customerId,
BillingCycle = BillingCycleType.Annual,
LineItems = new List<OrderLineItem>()
{
new OrderLineItem()
{
LineItemNumber = 0,
OfferId = offerId,
SubscriptionId = "69829602-C219-40FD-A3D5-4150FCA41A19",
Quantity = 1
}
}
};
var createdOrder = partnerOperations.Customers.ById(customerId).Orders.ById(orderId).Patch(order);
REST-Anforderung
Anforderungssyntax
| Methode | Anforderungs-URI |
|---|---|
| PATCH | {baseURL}/v1/customers/{customer-tenant-id}/orders/{order-id} HTTP/1.1 |
URI-Parameter
In dieser Tabelle ist der erforderliche Abfrageparameter aufgeführt, um die Anzahl des Abonnements zu ändern.
| Name | Type | Erforderlich | Beschreibung |
|---|---|---|---|
| customer-tenant-id | GUID | Y | Eine guid formatierte Kundenmandanten-ID , die den Kunden identifiziert |
| order-id | GUID | Y | Der Bestellbezeichner |
Anforderungsheader
Weitere Informationen finden Sie unter Partner Center-REST-Header.
Anforderungstext
In den folgenden Tabellen werden die Eigenschaften im Anforderungstext beschrieben.
Auftrag
| Eigenschaft | Type | Erforderlich | Beschreibung |
|---|---|---|---|
| Kennung | Zeichenfolge | N | Ein Auftragsbezeichner, der bei erfolgreicher Erstellung des Auftrags bereitgestellt wird |
| ReferenceCustomerId | Zeichenfolge | J | Der Kundenbezeichner |
| BillingCycle | Zeichenfolge | J | Gibt die Häufigkeit an, mit der der Partner für diese Bestellung in Rechnung gestellt wird. Die unterstützten Werte sind die in BillingCycleType angegebenen Elementnamen. |
| LineItems | Array von Objekten | Y | Ein Array von OrderLineItem-Ressourcen |
| CreationDate | datetime | N | Das Datum, an dem die Reihenfolge erstellt wurde, im Datums-/Uhrzeitformat |
| Attribute | Objekt | N | Enthält "ObjectType": "OrderLineItem" |
OrderLineItem
| Eigenschaft | Type | Erforderlich | Beschreibung |
|---|---|---|---|
| lineitemnumber | Zahl | Y | Die Nummer der Zeile, beginnend mit 0 |
| OfferId | Zeichenfolge | J | Die ID des Angebots |
| SubscriptionId | Zeichenfolge | J | Die ID des Abonnements |
| FriendlyName | Zeichenfolge | N | Der Anzeigename für das vom Partner definierte Abonnement, um mehrdeutig zu sein |
| Menge | Zahl | Y | Die Anzahl der Lizenzen oder Instanzen |
| PartnerIdOnRecord | Zeichenfolge | N | PartnerID des Datensatzpartners |
| Attribute | Objekt | N | Enthält "ObjectType": "OrderLineItem" |
Anforderungsbeispiel
Aktualisierung auf jährliche Abrechnung
PATCH https://api.partnercenter.microsoft.com/v1/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/orders/CF3B0E37-BE0B-4CDD-B584-D1A97D98A922 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 17a2658e-d2cc-439b-a2f0-2aefd9344fbc
MS-CorrelationId: 60efdd24-17ef-4080-9b02-4fc315f916ff
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 414
Expect: 100-continue
{
"Id": null,
"ReferenceCustomerId": "4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04",
"BillingCycle" : "Annual",
"LineItems": [{
"LineItemNumber": 0,
"OfferId": "2828BE95-46BA-4F91-B2FD-0BEF192ECF60",
"SubscriptionId": "69829602-C219-40FD-A3D5-4150FCA41A19",
"FriendlyName": "Some friendly name",
"Quantity": 2,
"PartnerIdOnRecord": null,
"Attributes": {
"ObjectType": "OrderLineItem"
}
}
],
"CreationDate": null,
"Attributes": {
"ObjectType": "Order"
}
}
REST-Antwort
Bei erfolgreicher Ausführung gibt diese Methode die aktualisierte Abonnementreihenfolge im Antworttext zurück.
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 findest du unter Partner-API: REST-Fehlercodes.
Beispielantwort
HTTP/1.1 200 OK
Content-Length: 1135
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 60efdd24-17ef-4080-9b02-4fc315f916ff
MS-RequestId: 17a2658e-d2cc-439b-a2f0-2aefd9344fbc
MS-CV: WtFy3zI8V0u2lnT9.0
MS-ServerId: 020021921
Date: Wed, 25 Jan 2017 23:01:08 GMT
{
"id": "cf3b0e37-be0b-4cdd-b584-d1a97d98a922",
"referenceCustomerId": "4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04",
"billingCycle": "Annual",
"lineItems": [{
"lineItemNumber": 0,
"offerId": "195416C1-3447-423A-B37B-EE59A99A19C4",
"subscriptionId": "1C2B75C1-74A5-472A-A729-7F8CEFC477F9",
"friendlyName": "new offer purchase",
"quantity": 5,
"links": {
"subscription": {
"uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/subscriptions/1C2B75C1-74A5-472A-A729-7F8CEFC477F9",
"method": "GET",
"headers": []
}
}
},
{
"lineItemNumber": 1,
"offerId": "2828BE95-46BA-4F91-B2FD-0BEF192ECF60",
"subscriptionId": "69829602-C219-40FD-A3D5-4150FCA41A19",
"friendlyName": "Some friendly name",
"quantity": 2,
"links": {
"subscription": {
"uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/subscriptions/69829602-C219-40FD-A3D5-4150FCA41A19",
"method": "GET",
"headers": []
}
}
}
],
"creationDate": "2017-01-25T14:53:12.093-08:00",
"links": {
"self": {
"uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/orders/cf3b0e37-be0b-4cdd-b584-d1a97d98a922",
"method": "GET",
"headers": []
}
},
"attributes": {
"etag": "eyJpZCI6ImNmM2IwZTM3LWJlMGItNGNkZC1iNTg0LWQxYTk3ZDk4YTkyMiIsInZlcnNpb24iOjJ9",
"objectType": "Order"
}
}
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