Anuluj zamówienie w środowisku testowym integracji przy użyciu interfejsów API Centrum partnerskiego

Artykuł
03/07/2025

Dotyczy: Centrum partnerskie | Centrum partnerskie obsługiwane przez firmę 21Vianet | Centrum partnerskie dla chmury firmy Microsoft dla instytucji rządowych USA

W tym artykule opisano sposób używania interfejsów API Centrum partnerskiego do anulowania różnych typów zamówień subskrypcji z poziomu kont piaskownicy integracji. Takie zamówienia mogą obejmować wystąpienia zarezerwowane, oprogramowanie oraz subskrypcje oprogramowania jako usługi (SaaS) z komercyjnego rynku.

W poniższej tabeli przedstawiono kolejność anulacji w środowisku testowym i środowisku produkcyjnym.

Typ produktu	Kolejność aktualizacji piaskownicy	Subskrypcja aktualizacji środowiska testowego	Zlecenie aktualizacji produkcji	Subskrypcja aktualizacji produkcyjnej
Wystąpienia zarezerwowane platformy Azure	Y	N	N	N
Oprogramowanie bezterminowe	Y	N	Y	N
Subskrypcje oprogramowania	Y	Y	Y	Y
Nowy handel	N	Y	N	Y
Komercyjna platforma handlowa	N	Y	N	Y
Plan Azure	N	Y	N	Y

Notatka

Anulowanie rezerwacyjnych wystąpień lub zamówień subskrypcji SaaS z komercyjnego rynku jest możliwe tylko z kont w piaskownicy integracyjnej. Nie można anulować żadnych zamówień piaskownicy starszych niż 60 dni w Centrum partnerskim.

Aby anulować zamówienia na produkcję oprogramowania poprzez API, użyj anulowanie-zamówień-na-produkcję-oprogramowania. Możesz również anulować zamówienia produkcyjne oprogramowania za pomocą pulpitu nawigacyjnego, anulować zakup.

Warunki wstępne

Poświadczenia, jak opisano w uwierzytelnianie Centrum Partnerów. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu samodzielnych poświadczeń aplikacji, jak i poświadczeń aplikacji i użytkownika.
Konto partnera w piaskownicy integracyjnej z klientem posiadającym aktywne zamówienia na zarezerwowane instancje, oprogramowanie lub subskrypcje SaaS od zewnętrznych dostawców.

C#

Aby anulować zamówienie z piaskownicy integracji, przekaż poświadczenia konta do metody CreatePartnerOperations, aby uzyskać interfejs IPartner do realizacji operacji partnerskich.

Aby wybrać określone zamówienie nr, użyj operacji partnera i wywołaj metodę Customers.ById() z identyfikatorem klienta, a następnie Orders.ById() z identyfikatorem zamówienia, aby określić zamówienie, a na koniec metodę Get lub GetAsync, aby je pobrać.

Ustaw właściwość Order.Status na cancelled i użyj metody Patch(), aby zaktualizować kolejność.

// 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);

Żądanie REST

Składnia żądania

Metoda	Identyfikator URI żądania
PATCH	{baseURL}/v1/customers/{customer-tenant-id}/orders/{order-id} HTTP/1.1

Parametr identyfikatora URI

Użyj następującego parametru zapytania, aby usunąć klienta.

Nazwa	Typ	Wymagane	Opis
identyfikator klienta-najemcy	guid	Y	Wartość to identyfikator GUID sformatowany customer-tenant-id, który umożliwia odsprzedawcy filtrowanie wyników dla danego klienta należącego do odsprzedawcy.
identyfikator zamówienia	ciąg	Y	Wartość jest ciągiem oznaczającym identyfikatory zamówień, które należy anulować.

Nagłówki żądań

Aby uzyskać więcej informacji, zapoznaj się z Nagłówki REST Centrum partnerskiego.

Treść żądania

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

Przykład żądania

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",
}

Odpowiedź REST

W przypadku powodzenia ta metoda zwraca anulowane zamówienie.

Kody sukcesu i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i więcej informacji o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i inne parametry. Aby uzyskać pełną listę, zobacz Kody błędów REST Centrum partnerskiego.

Przykład odpowiedzi

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"
    }
}

Udostępnij za pośrednictwem