Müşterinin aboneliğini alma

Uygulama hedefi: Iş Ortağı Merkezi | 21Vianet tarafından işletilen iş ortağı Merkezi | Microsoft Bulut Almanya için iş ortağı Merkezi | Microsoft Cloud for US Government için iş ortağı Merkezi

Müşterinin aboneliklerinin bir koleksiyonunu alma.

Önkoşullar

• Iş ortağı merkezi kimlik doğrulamasındaaçıklandığı gibi kimlik bilgileri. Bu senaryo, hem tek başına uygulama hem de uygulama + kullanıcı kimlik bilgileriyle kimlik doğrulamayı destekler.

• Bir müşteri KIMLIĞI ( customer-tenant-id ). Müşterinin KIMLIĞINI bilmiyorsanız Iş Ortağı Merkezi panosundabulabilirsiniz. Iş Ortağı Merkezi menüsünden CSP ' yi ve ardından müşteriler' i seçin. Müşteri listesinden müşteriyi seçin ve ardından Hesap' ı seçin. Müşterinin hesap sayfasında, müşteri hesabı bilgileri bölümünde Microsoft kimliği ' ni arayın. Microsoft KIMLIĞI, müşteri KIMLIĞI () ile aynıdır customer-tenant-id .

C#

Müşterinin aboneliklerinin tümünün bir listesini almak için, önce müşteriyi tanımlamak üzere ıaggregatepartner. Customers. Byıd yöntemini müşteri tanımlayıcısıyla birlikte kullanın. Ardından, abonelik koleksiyonu işlemlerine bir arabirim almak için abonelikler özelliğini kullanın. Son olarak, müşterinin abonelikler koleksiyonunu almak için Get veya GetAsync yöntemlerini çağırın.

// IAggregatePartner partnerOperations;
// string customerId;

var customerSubscriptions = partnerOperations.Customers.ById(customerId).Subscriptions.Get();

Örnek: konsol test uygulaması. Project: iş ortağı merkezi SDK örnekleri sınıfı: getabonelikler. cs

REST isteği

İstek sözdizimi

URI parametresi

Bu tablo, tüm abonelikleri almak için gerekli sorgu parametresini listeler.

İstek üst bilgileri

Daha fazla bilgi için bkz. Iş ortağı MERKEZI Rest üstbilgileri.

İstek gövdesi

Yok.

İstek örneği

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/subscriptions HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: b2d13828-2ca5-41d4-94fb-9946214f4244
MS-CorrelationId: c49004b1-224f-4d86-a607-6c8bcc52cfdd
Connection: Keep-Alive

REST yanıtı

Başarılı olursa, bu yöntem yanıt gövdesinde bir abonelik kaynakları koleksiyonu döndürür.

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

Her yanıt başarı veya başarısızlık ve ek hata ayıklama bilgilerini gösteren bir HTTP durum kodu ile gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz. Iş ortağı MERKEZI Rest hata kodları.

Yanıt örnekleri

HTTP/1.1 200 OK
Content-Length: 73754
Content-Type: application/json
MS-CorrelationId: c49004b1-224f-4d86-a607-6c8bcc52cfdd
MS-RequestId: b2d13828-2ca5-41d4-94fb-9946214f4244
Date: Wed, 25 Nov 2015 05:43:06 GMT

{
    "totalCount": 37,
    "items": [{
        "id": "83ef9d05-4169-4ef9-9657-0e86b1eab1de",
        "entitlementId": "a356ac8c-e310-44f4-bf85-C7f29044af99",
        "friendlyName": "nickname",
        "quantity": 1,
        "unitType": "none",
        "creationDate": "2015-11-25T06: 41: 12Z",
        "effectiveStartDate": "2015-11-24T08: 00: 00Z",
        "commitmentEndDate": "2016-12-12T08: 00: 00Z",
        "status": "active",
        "autoRenewEnabled": false,
        "billingType": "none",
        "contractType": "subscription",
        "links": {
            "offer": {
                "uri": "/v1/offers/0CCA44D6-68E9-4762-94EE-31ECE98783B9",
                "method": "GET",
                "headers": []
            },
            "self": {
                "uri": "/subscriptions?key=<key>",
                "method": "GET",
                "headers": []
            }
        },
        "orderId": "6183db3d-6318-4e52-877e-25806e4971be",
        "attributes": {
            "etag": "<etag>",
            "objectType": "Subscription"
        }
    }],
    "attributes": {
        "objectType": "Collection"
    }
}

{ 
    "totalCount": 1, 
    "items": [ 
        { 
            "id": "924671ba-eab9-45d7-95ed-dbd9477f182b", 
            "offerId": "DG7GMGF0FKZV:0003:DG7GMGF0DQLM", 
            "offerName": "SQL Server Enterprise - 2 Core License Pack - 3 year", 
            "friendlyName": "SQL Server Enterprise - 2 Core License Pack - 3 year", 
            "productType": { 
                "id": "Software", 
                "displayName": "Software" 
            }, 
            "quantity": 1, 
            "unitType": "Licenses", 
            "hasPurchasableAddons": false, 
            "creationDate": "2021-10-15T21:28:19.3058617Z", 
            "effectiveStartDate": "2021-10-15T21:28:18.4786844Z", 
            "commitmentEndDate": "2024-10-14T00:00:00Z", 
            "cancellationAllowedUntilDate": "2021-11-14T23:59:00Z", 
            "status": "active", 
            "autoRenewEnabled": true, 
            "isTrial": false, 
            "billingType": "license", 
            "billingCycle": "triennial", 
            "termDuration": "P3Y", 
            "renewalTermDuration": "", 
            "isMicrosoftProduct": true, 
            "partnerId": "", 
            "attentionNeeded": false, 
            "actionTaken": false, 
            "contractType": "subscription", 
            "links": { 
                "product": { 
                    "uri": "/products/DG7GMGF0FKZV?country=US", 
                    "method": "GET", 
                    "headers": [] 
                }, 
                "sku": { 
                    "uri": "/products/DG7GMGF0FKZV/skus/0003?country=US", 
                    "method": "GET", 
                    "headers": [] 
                }, 
                "availability": { 
                    "uri": "/products/DG7GMGF0FKZV/skus/0003/availabilities/DG7GMGF0DQLM?country=US", 
                    "method": "GET", 
                    "headers": [] 
                }, 
                "self": { 
                    "uri": "/customers/954ca09a-1132-4088-bb58-30438dea2756/subscriptions/924671ba-eab9-45d7-95ed-dbd9477f182b", 
                    "method": "GET", 
                    "headers": [] 
                } 
            }, 
            "publisherName": "Microsoft", 
            "orderId": "12345678901", 
            "attributes": { 
                "objectType": "Subscription" 
            } 
        } 
    ], 
    "links": { 
        "self": { 
            "uri": "/customers/954ca09a-1132-4088-bb58-30438dea2756/subscriptions", 
            "method": "GET", 
            "headers": [] 
        } 
    }, 
    "attributes": { 
        "objectType": "Collection" 
    } 
}