İş Ortağı Merkezi API'lerini kullanarak tümleştirme korumalı alanından bir siparişi iptal etme

Makale
03/15/2024

Şunlar için geçerlidir: İş Ortağı Merkezi | 21Vianet tarafından işletilen İş Ortağı Merkezi | ABD Kamu için Microsoft Bulut İş Ortağı Merkezi

Bu makalede, tümleştirme korumalı alan hesaplarından farklı türlerdeki abonelik siparişlerini iptal etmek için İş Ortağı Merkezi API'lerinin nasıl kullanılacağı açıklanmaktadır. Bu tür siparişler ayrılmış örnekleri, yazılımları ve ticari market Hizmet Olarak Yazılım (SaaS) abonelik siparişlerini içerebilir.

Aşağıdaki tabloda korumalı alan ve üretimdeki iptal sırası gösterilmektedir.

Ürün türü	Korumalı alan güncelleştirme sırası	Korumalı alan güncelleştirme aboneliği	Üretim güncelleştirme siparişi	Üretim güncelleştirme aboneliği
Azure Ayrılmış Örnekleri	Y	N	N	N
Kalıcı yazılım	Y	N	Y	N
Yazılım abonelikleri	Y	Y	Y	Y
Yeni ticaret	N	Y	N	Y
Ticari market	N	Y	N	Y
Azure planı	N	Y	N	Y

Not

Ayrılmış örnek veya ticari market SaaS abonelik siparişlerinin iptali yalnızca tümleştirme korumalı alan hesaplarından yapılabilir. 60 günden eski korumalı alan siparişleri İş Ortağı Merkezi'nden iptal edilemez.

API aracılığıyla yazılımın üretim siparişlerini iptal etmek için cancel-software-purchases komutunu kullanın. Ayrıca, satın alma işlemini iptal etmek için pano aracılığıyla yazılımın üretim siparişlerini de iptal edebilirsiniz.

Önkoşullar

İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo hem tek başına Uygulama hem de Uygulama+Kullanıcı kimlik bilgileriyle kimlik doğrulamayı destekler.
Etkin ayrılmış örneğe / yazılıma / üçüncü taraf SaaS abonelik siparişlerine sahip bir müşterinin olduğu tümleştirme korumalı alan iş ortağı hesabı.

C#

Tümleştirme korumalı alanından bir siparişi iptal etmek için hesap kimlik bilgilerinizi yöntemine CreatePartnerOperations geçirerek iş ortağı işlemlerini almak için bir IPartner arabirim alın.

Belirli bir Siparişi seçmek için, müşteri tanımlayıcısıyla birlikte iş ortağı işlemlerini ve çağrı Customers.ById() yöntemini kullanarak müşteriyi belirtin, ardından Orders.ById() siparişi ve son olarak Get veya GetAsync alma yöntemini belirtmek için sipariş tanımlayıcısını kullanın.

özelliğini olarak Order.Status cancelled ayarlayın ve sırasını güncelleştirmek için yöntemini kullanın Patch() .

// 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 isteği

İstek söz dizimi

Metot	İstek URI'si
PATCH	{baseURL}/v1/customers/{customer-tenant-id}/orders/{order-id} HTTP/1.1

URI parametresi

Müşteriyi silmek için aşağıdaki sorgu parametresini kullanın.

Adı	Tür	Zorunlu	Açıklama
customer-tenant-id	Guıd	Y	Değer, kurumsal bayinin kurumsal bayiye ait belirli bir müşterinin sonuçlarını filtrelemesine olanak tanıyan GUID biçimli müşteri kiracı kimliğidir .
order-id	string	Y	değer, iptal edilmesi gereken sipariş kimliklerini belirten bir dizedir.

İstek üst bilgileri

Daha fazla bilgi için bkz . İş Ortağı Merkezi REST üst bilgileri.

Request body

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

İstek örneği

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 yanıtı

Başarılı olursa, bu yöntem iptal edilen sırayı döndürür.

Yanıt başarısı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu belirten bir HTTP durum kodu ve daha fazla hata ayıklama bilgisi ile birlikte gelir. Bu kodu, hata türünü ve diğer parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz . İş Ortağı Merkezi REST hata kodları.

Yanıt örneği

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

Aracılığıyla paylaş