Zrušení objednávky z sandboxu integrace pomocí rozhraní API Partnerského centra

Článek
03/15/2024

Platí pro: Partnerské centrum | Partnerské centrum provozované společností 21Vianet | Partnerské centrum pro Microsoft Cloud pro státní správu USA

Tento článek popisuje, jak pomocí rozhraní API Partnerského centra zrušit různé typy objednávek předplatného z účtů sandboxu integrace. Tyto objednávky můžou zahrnovat rezervované instance, software a objednávky předplatného SaaS (Software as a Service) komerčního marketplace.

Následující tabulka ukazuje pořadí zrušení v sandboxu a produkčním prostředí.

Typ produktu	Pořadí aktualizací sandboxu	Předplatné aktualizace sandboxu	Výrobní objednávka aktualizace	Odběr aktualizace produkčního prostředí
Rezervované instance Azure	Y	N	N	N
Časově neomezený software	Y	N	Y	N
Předplatná softwaru	Y	Y	Y	Y
Nový obchod	N	Y	N	Y
Komerční marketplace	N	Y	N	Y
Plán Azure	N	Y	N	Y

Poznámka:

Zrušení rezervované instance nebo objednávky předplatného SaaS na komerčním marketplace jsou možné jenom z účtů sandboxu integrace. Z Partnerského centra nejdou zrušit všechny objednávky sandboxu, které jsou starší než 60 dnů.

Pokud chcete zrušit výrobní objednávky softwaru prostřednictvím rozhraní API, použijte nákupy typu cancel-software. Výrobní objednávky softwaru můžete také zrušit prostřednictvím řídicího panelu pomocí zrušení nákupu.

Požadavky

Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů aplikace i aplikace a uživatele.
Partnerový účet sandboxu integrace se zákazníkem, který má aktivní rezervovanou instanci nebo software / objednávky předplatného SaaS třetích stran.

C#

Pokud chcete zrušit objednávku z sandboxu integrace, předejte přihlašovací údaje účtu metodě CreatePartnerOperations , abyste získali IPartner rozhraní pro získání partnerských operací.

Pokud chcete vybrat konkrétní objednávku, pomocí operací partnera a metody volání Customers.ById() s identifikátorem zákazníka určete zákazníka a potom Orders.ById() identifikátor objednávky k určení objednávky a nakonec Get nebo GetAsync metodu k jeho načtení.

Order.Status Nastavte vlastnost na cancelled a použijte metodu Patch() k aktualizaci pořadí.

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

Požadavek REST

Syntaxe požadavku

metoda	Identifikátor URI žádosti
PATCH	{baseURL}/v1/customers/{customer-tenant-id}/orders/{order-id} HTTP/1.1

Parametr identifikátoru URI

K odstranění zákazníka použijte následující parametr dotazu.

Name	Type	Požadováno	Popis
customer-tenant-id	identifikátor guid	Y	Hodnota je GUID formátované ID tenanta zákazníka, které umožňuje prodejci filtrovat výsledky pro daného zákazníka, který patří k prodejci.
order-id	string	Y	Hodnota je řetězec označující ID objednávek, které je potřeba zrušit.

Záhlaví žádosti

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

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

Příklad požadavku

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

Odpověď REST

V případě úspěchu vrátí tato metoda zrušenou objednávku.

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který indikuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb REST v Partnerském centru.

Příklad odpovědi

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

Sdílet prostřednictvím