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

Makale
01/29/2024

Şunlar için geçerlidir: İş Ortağı Merkezi | Microsoft Cloud for US Government için İş 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 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ı, müşteri listesinden müşteriyi ve ardından Hesap'ı seçerek iş ortağınızı arayabilirsiniz. Müşterinin Hesap sayfasında, Müşteri Hesabı Bilgileri bölümünde Microsoft Kimliğini bulun. Microsoft kimliği, müşteri kimliğiyle (customer-tenant-id ile aynıdır).

C#

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

Güncelleştirilmiş tutarla yeni bir SpendingBudget nesnesi oluşturun.
Belirtilen müşterinin tanımlayıcısıyla ById() yöntemini çağırmak için IAggregatePartner.Customers koleksiyonunu kullanın.
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

Yöntem	İ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	Gerekli	Açıklama
customer-tenant-id	Guıd	Y	Değer, kurumsal bayinin bayiye ait belirli bir müşteri için sonuçları 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.

İstek gövdesi

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 bir 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 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. 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":[]
        }
    }
}

Aracılığıyla paylaş