İş ortağı MPN kimliğine göre bir müşterinin aboneliğini alma

Makale
12/01/2021
Okumak için 3 dakika

Uygulama:İş Ortağı Merkezi | İş Ortağı Merkezi 21Vianet | İş Ortağı Merkezi Microsoft Bulut Almanya için | İş Ortağı Merkezi için Microsoft Cloud for US Government

Belirli bir müşteri için belirli bir Microsoft İş Ortağı Ağı (MPN) iş ortağı tarafından sağlanan aboneliklerin listesini nasıl alabilirsiniz?

Önkoşullar

kimlik doğrulamasında açıklandığı gibi İş Ortağı Merkezi bilgileri. Bu senaryo hem tek başına Uygulama hem de Uygulama+Kullanıcı kimlik bilgileriyle kimlik doğrulamasını destekler.
Müşteri kimliği ( customer-tenant-id ). Müşterinin kimliğini bilmiyorsanız bu kimliği panoda İş Ortağı Merkezi. İş Ortağı Merkezi'den CSP'yi ve ardından Müşteriler'i seçin. Müşteri listesinden müşteriyi ve ardından Hesap'ı seçin. Müşterinin Hesap sayfasında Müşteri Hesabı Bilgileri bölümünde MicrosoftKimliği'ne bakın. Microsoft Kimliği, müşteri kimliği () ile customer-tenant-id aynıdır.
İş ortağı MPN tanımlayıcısı.

C#

Belirli bir iş ortağı tarafından belirtilen bir müşteriye sağlanan aboneliklerin listesini almak için önce müşteri kimliğiyle birlikte IAggregatePartner.Customers.ById yöntemini kullanarak müşteriyi tanıyın. Ardından Subscriptions özelliğinden müşteri aboneliği toplama işlemlerine bir arabirim alın ve iş ortağını tanımlamak ve iş ortağı abonelik işlemlerine yönelik bir arabirim almak için MPN kimliği ile ByPartner yöntemini arayın. Son olarak, koleksiyonu almak için Get veya GetAsync yöntemini arayın.

// IAggregatePartner partnerOperations;
// string customerId;
// string partnerMpnId;

var customerSubscriptionsByMpnId = partnerOperations.Customers.ById(customerId).Subscriptions.ByPartner(partnerMpnId).Get();

Örnek:Konsol test uygulaması. Project:İş Ortağı Merkezi SDK'sı Örnekler Sınıfı:GetSubscriptionsByMpnid.cs

Java

Bu İş Ortağı Merkezi Java SDK'sı, iş ortakları tarafından yaygın olarak kendi kaynak İş Ortağı Merkezi kullanılır. İş ortağı topluluğu tarafından bakımı yapılan açık kaynaklı bir projedir. Bu modül iş ortağı topluluğu tarafından korundu ve Microsoft tarafından resmi olarak desteklenmiyor. Bir sorun yaşamanıza yardımcı olmak için topluluktan yardım GitHub bir sorun açabilirsiniz.

Belirli bir iş ortağı tarafından belirtilen bir müşteriye sağlanan aboneliklerin listesini almak için önce müşteri kimliğiyle birlikte IAggregatePartner.getCustomers.byId işlevini kullanarak müşteriyi tanıyın. Ardından getSubscriptions işlevinden müşteri aboneliği toplama işlemlerine bir arabirim alın ve iş ortağını tanımlamak ve iş ortağı abonelik işlemlerine bir arabirim almak için MPN kimliğiyle byPartner işlevini çağırma. Son olarak, koleksiyonu almak için get işlevini çağır.

// IAggregatePartner partnerOperations;
// String customerId;
// String partnerMpnId;

ResourceCollection<Subscription> customerSubscriptionsByMpnId = partnerOperations.getCustomers().byId(customerId).getSubscriptions().byPartner(partnerMpnId).get();

PowerShell

PowerShell İş Ortağı Merkezi yaygın olarak iş ortakları tarafından kendi kaynaklarınızı yönetmek için İş Ortağı Merkezi kullanılır. İş ortağı topluluğu tarafından bakımı yapılan açık kaynaklı bir projedir. Bu modül iş ortağı topluluğu tarafından korundu ve Microsoft tarafından resmi olarak desteklenmiyor. Bir sorun yaşamanıza yardımcı olmak için topluluktan yardım GitHub bir sorun açabilirsiniz.

Belirli bir iş ortağı tarafından belirtilen bir müşteriye sağlanan aboneliklerin listesini almak için Get-PartnerCustomerSubscription komutunu yürütün. CustomerId parametresini kullanarak müşteriyi tanımlamak için müşteri kimliğini belirtin ve mpnId parametresini MPN kimliğiyle birlikte iş ortağını tanımlamak için girin.

# $customerId
# $partnerMpnId

Get-PartnerCustomerSubscription -CustomerId $customerId -MpnId $partnerMpnId

REST isteği

İstek söz dizimi

Yöntem	İstek URI'si
AL	{baseURL}/v1/customers/{customer-id}/subscriptions?mpn_id={mpn-id} HTTP/1.1

URI parametreleri

Müşteriyi ve iş ortağını tanımlamak için aşağıdaki yolu ve sorgu parametrelerini kullanın.

Ad	Tür	Gerekli	Açıklama
customer-id	string	Yes	Müşteriyi tanımlayan GUID biçimli bir dize.
mpn-id	int	Yes	İş Microsoft İş Ortağı Ağı tanımlayan bir kimlik.

İstek üst bilgileri

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

İstek gövdesi

Yok.

İstek örneği

GET https://api.partnercenter.microsoft.com/v1/customers/c501c3c4-d776-40ef-9ecf-9cefb59442c1/subscriptions?mpn_id=4847383 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive

REST yanıtı

Başarılı olursa yanıt gövdesi Abonelik kaynaklarının koleksiyonunu içerir.

Yanıt başarı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu gösteren bir HTTP durum kodu ve ek hata ayıklama bilgileriyle birlikte gelir. Bu kodu, hata türünü ve ek 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: 985
Content-Type: application/json; charset=utf-8
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CV: LdFhumtx6Ea0Kl5Z.0
MS-ServerId: 101112202
Date: Thu, 13 Apr 2017 20:58:08 GMT

{
    "totalCount": 1,
    "items": [{
            "id": "42226ED6-070A-4E0F-B80C-4CDFB3E97AA7",
            "offerId": "DB2E705F-B82A-4024-A3D5-D88E12F2DB35",
            "offerName": "Intune Device",
            "friendlyName": "new offer purchase",
            "quantity": 5,
            "unitType": "Licenses",
            "creationDate": "2017-04-10T23:02:26.02Z",
            "effectiveStartDate": "2017-04-10T00:00:00Z",
            "commitmentEndDate": "2018-05-07T00:00:00Z",
            "status": "active",
            "autoRenewEnabled": true,
            "isTrial": false,
            "billingType": "license",
            "billingCycle": "monthly",
            "partnerId": "4847383",
            "contractType": "subscription",
            "links": {
                "offer": {
                    "uri": "/offers/DB2E705F-B82A-4024-A3D5-D88E12F2DB35?country=US",
                    "method": "GET",
                    "headers": []
                },
                "self": {
                    "uri": "/customers/c501c3c4-d776-40ef-9ecf-9cefb59442c1/subscriptions/42226ED6-070A-4E0F-B80C-4CDFB3E97AA7",
                    "method": "GET",
                    "headers": []
                }
            },
            "orderId": "3EDDCAC6-63B2-4C40-B0B6-F47E18301492",
            "attributes": {
                "etag": "eyJpZCI6IjQyMjI2ZWQ2LTA3MGEtNGUwZi1iODBjLTRjZGZiM2U5N2FhNyIsInZlcnNpb24iOjF9",
                "objectType": "Subscription"
            }
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}

Ayrıca bkz.

İş Ortağı Merkezi Analizi - Kaynaklar