Stornieren einer Bestellung aus der Integrations-Sandbox mithilfe von Partner Center-APIs

Artikel
03/15/2024

Gilt für: Partner Center | Partner Center-Betrieb durch 21Vianet | Partner Center für Microsoft Cloud for US Government

In diesem Artikel wird beschrieben, wie Sie Partner Center-APIs verwenden, um verschiedene Arten von Abonnementbestellungen aus Integrations-Sandkastenkonten abzubrechen. Solche Bestellungen können reservierte Instanzen, Software und kommerzielle Marketplace-Software as a Service (SaaS)-Abonnementbestellungen enthalten.

Die folgende Tabelle zeigt die Abbruchreihenfolge in Sandkasten und Produktion.

Produkttyp	Sandkastenaktualisierungsreihenfolge	Sandkastenupdateabonnement	Produktionsaktualisierungsauftrag	Produktionsupdateabonnement
Reservierte Azure-VM-Instanzen	Y	N	N	N
Unbefristete Software	Y	N	Y	N
Softwareabonnements	Y	Y	Y	Y
Neuer Handel	N	Y	N	J
Kommerzieller Marketplace	N	Y	N	J
Azure-Plan	N	Y	N	J

Hinweis

Stornierungen einer reservierten Instanz oder kommerzielle Marketplace SaaS-Abonnementbestellungen sind nur über Integrations-Sandbox-Konten möglich. Alle Sandkastenbestellungen, die älter als 60 Tage sind, können nicht vom Partner Center storniert werden.

Um Produktionsaufträge von Software über DIE API abzubrechen, verwenden Sie Cancel-Software-Käufe. Sie können produktionsbezogene Bestellungen von Software auch über das Dashboard stornieren, indem Sie einen Kauf stornieren.

Voraussetzungen

Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.
Ein Integrations-Sandbox-Partnerkonto mit einem Kunden, der über aktive reservierte Instanzen/Software/Drittanbieter-SaaS-Abonnementbestellungen verfügt.

C#

Um eine Bestellung aus der Integrations-Sandbox abzubrechen, übergeben Sie Ihre Kontoanmeldeinformationen an die CreatePartnerOperations Methode, um eine IPartner Schnittstelle zum Abrufen von Partnervorgängen abzurufen.

Verwenden Sie zum Auswählen einer bestimmten Bestellung die Partnervorgänge und die Anrufmethode Customers.ById() mit der Kunden-ID, um den Kunden anzugeben, gefolgt von Orders.ById() der Auftrags-ID, um die Bestellung und schließlich Get die GetAsync Methode zum Abrufen anzugeben.

Legen Sie die Order.Status Eigenschaft auf cancelled und verwenden Sie die Patch() Methode, um die Reihenfolge zu aktualisieren.

// IPartnerCredentials tipAccountCredentials;
// Customer tenant Id to be deleted.
// string customerTenantId;

IPartner tipAccountPartnerOperations = PartnerService.Instance.CreatePartnerOperations(tipAccountCredentials);

// Cancel order
var order = tipAccountPartnerOperations.Customers.ById(customerTenantId).Orders.ById(orderId).Get();
order.Status = "cancelled";
order = tipAccountPartnerOperations.Customers.ById(customerTenantId).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

Verwenden Sie den folgenden Abfrageparameter, um einen Kunden zu löschen.

Name	Type	Erforderlich	Beschreibung
customer-tenant-id	guid	Y	Der Wert ist eine GUID-formatierte Kundenmandanten-ID , die es dem Händler ermöglicht, die Ergebnisse für einen bestimmten Kunden zu filtern, der zum Händler gehört.
order-id	string	J	Der Wert ist eine Zeichenfolge, die die Bestell-IDs angibt, die abgebrochen werden müssen.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

{
    "id": "UKXASSO1dezh3HdxClHxSp5UEFXGbAnt1",
    "status": "cancelled",
}

Anforderungsbeispiel

PATCH https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/orders/<order-id> HTTP/1.1
Accept: application/json
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

{
    "id": "UKXASSO1dezh3HdxClHxSp5UEFXGbAnt1",
    "status": "cancelled",
}

REST-Antwort

Wenn die Methode erfolgreich verläuft, wird die abgebrochene Reihenfolge zurückgegeben.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Erfolg oder Fehler und weitere Debuginformationen angibt. Verwenden Sie ein Netzwerkablaufverfolgungstool, um diesen Code, fehlertyp und andere Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-REST-Fehlercodes.

Beispielantwort

HTTP/1.1 200 OK
Content-Length: 866
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5

{
    "id": "UKXASSO1dezh3HdxClHxSp5UEFXGbAnt1",
    "alternateId": "11fc4bdfd47a",
    "referenceCustomerId": "bd59b416-37f9-4d8f-8df3-5750111fc615",
    "billingCycle": "one_time",
    "currencyCode": "USD",
    "currencySymbol": "$",
    "lineItems": [
        {
            "lineItemNumber": 0,
            "offerId": "DG7GMGF0DWT0:0001:DG7GMGF0DSQR",
            "termDuration": "",
            "transactionType": "New",
            "friendlyName": "Microsoft Identity Manager 2016 - 1 User CAL",
            "quantity": 1,
            "links": {
                "product": {
                    "uri": "/products/DG7GMGF0DWT0?country=US",
                    "method": "GET",
                    "headers": []
                },
                "sku": {
                    "uri": "/products/DG7GMGF0DWT0/skus/0001?country=US",
                    "method": "GET",
                    "headers": []
                },
                "availability": {
                    "uri": "/products/DG7GMGF0DWT0/skus/0001/availabilities/DG7GMGF0DSQR?country=US",
                    "method": "GET",
                    "headers": []
                }
            }
        }
    ],
    "creationDate": "2019-02-21T17:56:21.1335741Z",
    "status": "cancelled",
    "transactionType": "UserPurchase",
    "attributes": {
        "objectType": "Order"
    }
}

Freigeben über