Aşım Güncellemesi

Şunun için geçerlidir:

  • İş Ortağı Merkezi

Uygun roller

  • Yönetim temsilcisi

Not

Lisans tabanlı hizmetlere yönelik yeni ticaret deneyimleri birçok yeni özellik içerir ve tüm Bulut Çözümü Sağlayıcıları (CSP' ler) tarafından kullanılabilir. Daha fazla bilgi için, Yeni ticaret deneyimlerine genel bakış'a bakın.

Belirli bir müşterinin aşım oranını tüketim bazlı aboneliğe ayarlamak için kullanılır. Aşımı kaldırmak için false olarak ayarlayarak da kullanılabilir. Fazla kullanım, müşterinin hizmeti belirtilen sınırların ötesinde kullanması durumunda hizmetleri kullanmaya devam etmelerini sağlar. Fazla kullanım, kullandıkça öde esasına göre tüketim aboneliğinin hangi hesaba yansıtılacağını tanımlar.

Kaynak grubu her zaman M365'tir. İş ortakları kaynak grubuna etiketler ve konumlar ekleyebilir ancak değiştiremez.

Önkoşullar

  • Partner Center 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.

  • Müşteri kimliği (customer-tenant-id). Eğer müşterinin kimliğini bilmiyorsanız, İş Ortağı Merkezi’nde Müşteriler çalışma alanını, daha sonra müşteri listesinden ilgili müşteriyi ve ardından Hesap seçeneğini seçerek bunu bulabilirsiniz. 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 (customer-tenant-id) ile aynıdır.

  • Müşteri için satın alınmış en az bir uygun ek kullanım aboneliği.

REST isteği

[PUT] /customers/{customer-tenant-id}/subscriptions/overage

İstek söz dizimi

Metot İstek URI'si
PUT {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/overage HTTP/1.1

URI parametresi

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

Adı Tür Zorunlu Açıklama
müşteri-kiracı-kimliği Guid Y Müşterinin kiracısına karşılık gelen GUID.

İstek başlıkları

Daha fazla bilgi için İş Ortağı Merkezi REST üst bilgilerine bakın.

İstek gövdesi

Adı Tür Açıklama
azureEntitlementId Guid Gerekli. Fazla kullanım için tüketim aboneliğini tanımlayan GUID.
azureResourceGroup object Optional. Etiketlerin ad değeri ve kaynak grubunun konumu.
partnerId Guid Yalnızca iki katman modeli (Dolaylı Sağlayıcı) için geçerlidir. Dolaylı Bayinin Partner Kimliği.
overageEnabled bool Gerekli. Belirli bir tüketim aboneliği için fazla kullanım özelliğinin etkinleştirilip etkinleştirilmeydiğini belirtin.

İstek örneği

PUT https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/overage HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 00000000-0000-0000-0000-000000000000
MS-CorrelationId: 00000000-0000-0000-0000-000000000000
X-Locale: en-US

{
    "azureEntitlementId": "00000000-0000-0000-0000-000000000000",
    "partnerId": "5357563",
    "azureResourceGroup": {
        "tags": {
          "teams phone": "pay as you go calls"
    },
    "location": "canadacentral"
  },
    "overageEnabled": true
}

REST yanıtı

Eğer başarılı olursa, bu yöntem bir müşteri için aşım miktarını 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 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 listeyi görmek için Hata Kodları bölümüne bakın.

Yanıt örneği

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: 00000000-0000-0000-0000-000000000000
MS-RequestId: 00000000-0000-0000-0000-000000000000
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
    "azureEntitlementId": "00000000-0000-0000-0000-000000000000",
    "partnerId": "5357563",
    "azureResourceGroup": {
        "tags": {
          "teams phone": "pay as you go calls"
    },
    "location": "canadacentral"
    },
    "type": "PhoneServices",
    "overageEnabled": true,
    "links": {
        "overage": {
            "uri": "/customers/00000000-0000-0000-0000-000000000000/subscriptions/overage",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Overage"
    }
}