Fazla kullanım güncelleştirme

Makale
09/25/2024

Şunun için geçerlidir:

İş Ortağı Merkezi

Uygun roller

Yönetici aracısı

Not

Lisans tabanlı hizmetler için 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ış.

Belirli bir müşterinin fazla kullanım değerini tüketim aboneliğine ayarlamak için kullanılır. Fazla kullanımları false olarak ayarlayarak kaldırmak için de 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 tüketim aboneliğinin tahakkuk ettirileceğini tanımlar.

Önkoşullar

İş Ortağı Merkezi 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). Müşterinin kimliğini bilmiyorsanız, İş Ortağı Merkezi'nde Müşteriler çalışma alanını, 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.
Müşteri için satın alınan en az bir uygun fazla 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
customer-tenant-id	Guıd	Y	Müşterinin kiracısına karşılık gelen GUID.

İstek üst bilgileri

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

Request body

Adı	Tür	Açıklama
azureEntitlementId	Guıd	Fazla kullanım için tüketim aboneliğini tanımlayan GUID.
partnerId	Guıd	Dolaylı Kurumsal Bayinin İş Ortağı Kimliği. Yalnızca iki katman modeli (Dolaylı Sağlayıcı) için geçerlidir.
overageEnabled	bool	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: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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üşteri için fazla kullanım 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 liste için bkz . Hata Kodları.

Yanıt örneği

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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"
    }
}

Aracılığıyla paylaş