Fazla kullanımı Güncelleştir

Uygulama hedefi

  • İş Ortağı Merkezi

Uygun roller

  • Genel yönetici
  • Yönetim Aracısı

Not

yeni ticaret değişiklikleri şu anda yalnızca Microsoft 365/dynamics 365 yeni ticaret deneyimi technical preview 'ın parçası olan iş ortakları tarafından kullanılabilir.

Belirli bir müşteri için tüketim aboneliğine fazla kullanım ayarlamak için kullanılır. , Yanlış olarak ayarlanarak fazla kullanım kaldırmak için de kullanılabilir. Fazla kullanım, bir müşterinin belirtilen limitlerin ötesinde hizmeti kullanması durumunda Hizmetleri kullanmaya devam etmesine olanak sağlar. Fazla kullanım, Kullandıkça Öde süresi fazla olan tüketim aboneliğini ücretlendirilecektir.

Ö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 .

  • Geçirilecek abonelik için bir abonelik KIMLIĞI.

REST isteği

[PUT]/Customers/{Customer-Tenant-ID}/Subscriptions/overage

İstek sözdizimi

Yöntem İstek URI'si
AL {BaseUrl}/v1/Customers/{Customer-Tenant-ID}/Subscriptions/overage http/1.1

URI parametresi

Müşterinin fazla kullanım süresini döndürmek için aşağıdaki sorgu parametrelerini kullanın.

Ad Tür Gerekli Açıklama
Müşteri-Kiracı kimliği guid Y Müşterinin kiracısına karşılık gelen bir GUID.

İstek üst bilgileri

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

İstek gövdesi

Ad Tür Description
azureEntitlementId guid Fazla kullanım için tüketim aboneliğini tanımlayan bir GUID.
iş ortağı kimliği guid Bir dolaylı satıcıdan MPN KIMLIĞI. Yalnızca iki katmanlı model (dolaylı sağlayıcı) için geçerlidir.

| | | | | Belirli bir tüketim aboneliği için fazla kullanım etkinleştirilip etkinleştirilmeyeceğini tanımlar. |

İstek örneği

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/overage HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
X-Locale: en-US

{
    "azureEntitlementId": "ea1c26b7-8c99-42bb-ba7d-c535831fae8e",
    "partnerId": "5357563",
    "overageEnabled": true
}

REST yanıtı

Başarılı olursa, bu yöntem bir müşterinin fazla kullanım süresini 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. hata kodları.

Yanıt örneği

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
    "azureEntitlementId": "ea1c26b7-8c99-42bb-ba7d-c535831fae8e",
    "partnerId": "5357563",
    "type": "PhoneServices",
    "overageEnabled": true,
    "links": {
        "overage": {
            "uri": "/customers/f62cf10b-8f76-4fc4-9774-c5291f8faf86/subscriptions/overage",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Overage"
    }
}