Aracılığıyla paylaş


Müşterinin kullanım harcaması bütçesini alma

Şunlar için geçerlidir: İş Ortağı Merkezi | ABD Kamu için Microsoft Bulut İş Ortağı Merkezi

Harcama bütçesini (SpendingBudget nesnesi) müşteri kullanım özetinde ( CustomerUsageSummary kaynağı) güncelleştirebilirsiniz.

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

C#

Müşterinin kullanım harcaması bütçesini güncelleştirmek için:

  1. Güncelleştirilmiş miktarla yeni bir SpendingBudget nesnesi oluşturun.

  2. Belirtilen müşterinin tanımlayıcısıyla ById() yöntemini çağırmak için IAggregatePartner.Customers koleksiyonunu kullanın.

  3. Müşterinin kullanım bütçesini almak için Get veya GetAsync yöntemini çağırın.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

// Create a new spending budget with the udpated amount.
var newUsageBudget = new SpendingBudget()
{
    Amount = 100
};

// Update the customer's usage budget.
var usageBudget = partnerOperations.Customers.ById(selectedCustomerId).UsageBudget.Get();

REST isteği

İstek söz dizimi

Metot İstek URI'si
GET {baseURL}/v1/customers/{customer-tenant-id}/usagebudget HTTP/1.1

URI parametresi

Faturalama profilini güncelleştirmek için aşağıdaki sorgu parametresini kullanın.

Adı Tür Zorunlu Açıklama
customer-tenant-id Guıd Y Değer, kurumsal bayinin kurumsal bayiye ait belirli bir müşterinin sonuçlarını filtrelemesine olanak tanıyan GUID biçimli müşteri kiracı kimliğidir .

İstek üst bilgileri

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

Request body

Kaynağın tamamı.

İstek örneği

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/usagebudget HTTP/1.1
Authorization: Bearer <token>
Accept: application/json, text/plain, */*
MS-RequestId: 312b044d-dc41-4b37-c2d5-7d27322d9654
MS-CorrelationId: 7cb67bb7-4750-403d-cc2e-6bc44c52d52c
Content-Type: application/json;charset=utf-8
X-Locale: "en-US"

REST yanıtı

Başarılı olursa, bu yöntem güncelleştirilmiş tutarla kullanıcının harcama bütçesini 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 ve diğer hata ayıklama bilgilerini gösteren bir HTTP durum koduyla birlikte gelir. Bu kodu, hata türünü ve diğer 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: 12014
Content-Type: application/json
MS-CorrelationId: 7cb67bb7-4750-403d-cc2e-6bc44c52d52c
MS-RequestId: be82a8ba-4a53-49f7-8313-b033c058687e
Date: Tue, 17 Sep 2019 20:31:45 GMT

{
    "amount": 100,
    "usageSpendingBudget": 100,
    "attributes": {
        "objectType": "SpendingBudget"
    },
    "links": {
        "self": {
            "uri": "/v1/customers/<customer-tenant-id>/usagebudget",
            "method": "GET",
            "headers": []
        }
    }
}