Kimliğe göre bir abonelik alma
Şunlar için geçerlidir: İş Ortağı Merkezi | 21Vianet tarafından sağlanan İş Ortağı Merkezi | Microsoft Cloud for US Government için İş Ortağı Merkezi
Müşteri kimliği ve abonelik kimliğiyle eşleşen bir Abonelik kaynağı alır.
Önkoşullar
İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo hem tek başına Uygulama hem de App+User kimlik bilgileriyle kimlik doğrulamayı destekler.
Müşteri kimliği (
customer-tenant-id). Müşterinin kimliğini bilmiyorsanız, İş Ortağı Merkezi'ndeMüşteriler çalışma alanını ve ardından müşteri listesinden müşteriyi ve ardından Hesap'ı seçerek bunu arayabilirsiniz. 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ğiyle (customer-tenant-id) aynıdır.Abonelik kimliği.
C#
Kimliğe göre abonelik almak için, müşteriyi tanımlamak için müşteri kimliğiyle IAggregatePartner.Customers.ById yöntemini ve aboneliği tanımlamak için Subscriptions.ById yöntemini çağırarak abonelik işlemlerine bir arabirim alarak başlayın. Get çağrısı yaparak abonelik ayrıntılarını almak için bu arabirimi kullanın.
// IAggregatePartner partnerOperations;
// string selectedCustomerId;
// string subscriptionID;
var subscriptionDetails = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(subscriptionID).Get();
Örnek: Konsol test uygulaması. Proje: İş Ortağı Merkezi SDK Örnekleri Sınıfı: GetSubscription.cs
REST isteği
İstek söz dizimi
| Yöntem | İstek URI'si |
|---|---|
| GET | {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{id-for-subscription} HTTP/1.1 |
URI parametresi
Bu tabloda, aboneliği almak için gerekli sorgu parametreleri listelenir.
| Ad | Tür | Gerekli | Açıklama |
|---|---|---|---|
| customer-tenant-id | Guıd | Y | Müşteriye karşılık gelen GUID. |
| abonelik için kimlik | Guıd | Y | Aboneliğe karşılık gelen GUID. |
İ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/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/subscriptions/A356AC8C-E310-44F4-BF85-C7F29044AF99 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 8f489776-a3f3-47cb-91c3-538e1f70f560
MS-CorrelationId: e72e1dc3-4abd-4ce0-908b-d23fdaedcb28
X-Locale: en-US
Host: api.partnercenter.microsoft.com
REST yanıtı
Başarılı olursa, bu yöntem yanıt gövdesinde bir Abonelik kaynağı döndürür.
Yanıt başarısı ve hata kodları
Her yanıt, başarıyı veya başarısızlığı ve ek hata ayıklama bilgilerini gösteren bir HTTP durum koduyla 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ı.
Microsoft Azure aboneliği için yanıt örneği
HTTP/1.1 200 OK
Content-Length: 833
Content-Type: application/json; charset=utf-8
MS-CorrelationId: e72e1dc3-4abd-4ce0-908b-d23fdaedcb28
MS-RequestId: 8f489776-a3f3-47cb-91c3-538e1f70f560
MS-CV: 7v11Wa//5EuGEo+A.0
MS-ServerId: 202010406
Date: Fri, 27 Jan 2017 21:51:40 GMT
{
"id": "A356AC8C-E310-44F4-BF85-C7F29044AF99",
"entitlementId": "42226ED6-070A-4E0F-B80C-4CDFB3E97AA7",
"offerId": "MS-AZR-0145P",
"offerName": "Microsoft Azure",
"friendlyName": "Microsoft Azure",
"quantity": 1,
"unitType": "Usage-based",
"creationDate": "2016-05-10T07:30:05.427Z",
"effectiveStartDate": "2016-05-10T00:00:00Z",
"commitmentEndDate": "9999-12-10T00:00:00Z",
"status": "active",
"autoRenewEnabled": false,
"billingType": "usage",
"contractType": "subscription",
"links": {
"offer": {
"uri": "/offers/MS-AZR-0145P?country=US",
"method": "GET",
"headers": []
},
"self": {
"uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/subscriptions/A356AC8C-E310-44F4-BF85-C7F29044AF99",
"method": "GET",
"headers": []
}
},
"orderId": "B23FDEDD-D6BD-415A-8B71-3624C81C9644",
"attributes": {
"etag": "eyJpZCI6ImEzNTZhYzhjLWUzMTAtNDRmNC1iZjg1LWM3ZjI5MDQ0YWY5OSIsInZlcnNpb24iOjJ9",
"objectType": "Subscription"
}
}
Eklenti aboneliği için yanıt örneği
Eklenti aboneliğinin yanıtı, gövdede ve bağlantılarda üst abonelik kimliğini içerir.
HTTP/1.1 200 OK
Content-Length: 1132
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 6eacec93-852d-4167-9d96-c57809bea7ed
MS-RequestId: 22bfd0fb-d1e6-4a8f-aa1a-124b7c820d80
MS-CV: cmde2DtbuUWi8JLq.0
MS-ServerId: 201022015
Date: Fri, 27 Jan 2017 00:12:53 GMT
{
"id": "968BA1CF-C146-4ADF-A300-308DCF718EEE",
"offerId": "2828BE95-46BA-4F91-B2FD-0BEF192ECF60",
"offerName": "Exchange Online Archiving for Exchange Online",
"friendlyName": "Some friendly name",
"quantity": 2,
"unitType": "Licenses",
"parentSubscriptionId": "1C2B75C1-74A5-472A-A729-7F8CEFC477F9",
"creationDate": "2017-01-25T23:01:08.693Z",
"effectiveStartDate": "2017-01-25T00:00:00Z",
"commitmentEndDate": "2018-02-10T00:00:00Z",
"commitmentEndDateTime": "2018-02-10T00:00:00Z",
"status": "active",
"autoRenewEnabled": true,
"billingType": "license",
"contractType": "subscription",
"links": {
"offer": {
"uri": "/offers/2828BE95-46BA-4F91-B2FD-0BEF192ECF60?country=US",
"method": "GET",
"headers": []
},
"parentSubscription": {
"uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/subscriptions/1C2B75C1-74A5-472A-A729-7F8CEFC477F9",
"method": "GET",
"headers": []
},
"self": {
"uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/subscriptions/968BA1CF-C146-4ADF-A300-308DCF718EEE",
"method": "GET",
"headers": []
}
},
"orderId": "CF3B0E37-BE0B-4CDD-B584-D1A97D98A922",
"attributes": {
"etag": "eyJpZCI6Ijk2OGJhMWNmLWMxNDYtNGFkZi1hMzAwLTMwOGRjZjcxOGVlZSIsInZlcnNpb24iOjF9",
"objectType": "Subscription"
}
}
Yeni ticaret aboneliği için yanıt örneği
Not
Lisans tabanlı hizmetlere yönelik yeni ticaret deneyimleri birçok yeni özellik içerir ve tüm Bulut Çözümü Sağlayıcısı (CSP' ler) tarafından kullanılabilir. Daha fazla bilgi için bkz. Yeni ticaret deneyimlerine genel bakış.
HTTP/1.1 200 OK
Content-Length: 1132
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 4ercec93-852d-4167-9d96-c57809bea7ed
MS-RequestId: 54sfd0fb-d1e6-4a8f-aa1a-124b7c820d80
MS-CV: cmde2DtbuUWi8JLq.0
MS-ServerId: 201022015
Date: Fri, 19 Feb 2021 00:14:53 GMT
{
"id": "a4c1340d-6911-4758-bba3-0c4c6007d161",
"offerId": "CFQ7TTC0LH18:0001:CFQ7TTC0K971",
"offerName": "Microsoft 365 Business Basic",
"friendlyName": "Microsoft 365 Business Basic",
"productType": {
"id": "OnlineServicesNCE",
"displayName": "OnlineServicesNCE"
},
"quantity": 15,
"unitType": "Licenses",
"hasPurchasableAddons": false,
"creationDate": "2021-01-14T16:57:15.0966728Z",
"effectiveStartDate": "2021-01-14T16:57:14.498252Z",
"commitmentEndDate": "2022-01-13T00:00:00Z",
"commitmentEndDateTime": "2022-01-13T23:59:59Z",
"status": "expired",
"autoRenewEnabled": false,
"isTrial": false,
"billingType": "license",
"billingCycle": "monthly",
"termDuration": "P1Y",
"renewalTermDuration": "",
"refundOptions": [
{
"type": "Full",
"expiresAt": "2021-01-15T00:00:00Z"
}
],
"isMicrosoftProduct": true,
"partnerId": "",
"attentionNeeded": false,
"actionTaken": false,
"contractType": "subscription",
"links": {
"product": {
"uri": "/products/CFQ7TTC0LH18?country=US",
"method": "GET",
"headers": []
},
"sku": {
"uri": "/products/CFQ7TTC0LH18/skus/0001?country=US",
"method": "GET",
"headers": []
},
"availability": {
"uri": "/products/CFQ7TTC0LH18/skus/0001/availabilities/CFQ7TTC0K971?country=US",
"method": "GET",
"headers": []
},
"self": {
"uri": "/customers/d8202a51-69f9-4228-b900-d0e081af17d7/subscriptions/a4c1340d-6911-4758-bba3-0c4c6007d161",
"method": "GET",
"headers": []
}
},
"publisherName": "Microsoft Corporation",
"refundableQuantity": {
"totalQuantity": 10,
"details": [
{
"quantity": 10,
"allowedUntilDateTime": "2021-01-24T20:39:17.182697Z"
}
]
}
"orderId": "34b37d7340cc",
"attributes": {
"objectType": "Subscription"
}
}