顧客の使用支出予算を更新する
適用対象: パートナー センター | Microsoft Cloud for US Government のパートナー センター
顧客の使用量に割り当てられた 支出予算 を更新します。
前提条件
パートナー センターの認証に関するページで説明している資格情報。 このシナリオでは、スタンドアロンの App と App+User の両方の資格情報を使用した認証がサポートされています。
顧客 ID です (
customer-tenant-id
)。 顧客の ID がわからない場合は、 パートナー センター で [顧客] ワークスペースを選択し、 次に顧客 の一覧から [顧客]、[ アカウント] の順に選択して、その ID を検索できます。 お客様のアカウント ページで、 [顧客のアカウント情報] セクションの Microsoft ID を探します。 Microsoft ID は、顧客 ID (customer-tenant-id
) と同じです。
C#
顧客の使用量支出予算を更新するには、まず、更新された金額を使用して新しい SpendingBudget オブジェクトを作成します。 次に、 IAggregatePartner.Customers コレクションを使用し、指定した顧客の ID で ById() メソッドを呼び出します。 次に 、UsageBudget プロパティに アクセスし、更新された使用量予算を Patch() または PatchAsync() メソッドに 渡します。
// 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.Patch(newUsageBudget);
REST 要求
要求の構文
認証方法 | 要求 URI |
---|---|
PATCH | {baseURL}/v1/customers/{customer-tenant-id}/usagebudget HTTP/1.1 |
URI パラメーター
課金プロファイルを更新するには、次のクエリ パラメーターを使用します。
名前 | Type | 必須 | 説明 |
---|---|---|---|
customer-tenant-id | guid | Y | 値は、リセラーがリセラーに属する特定の顧客の結果をフィルター処理できるようにする GUID 形式の customer-tenant-id です。 |
要求ヘッダー
詳細については、「パートナー センター REST ヘッダー」を参照してください。
[要求本文]
完全なリソース。
要求の例
PATCH 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"
{
"Amount": 100,
"Attributes": {
"ObjectType": "SpendingBudget"
}
}
REST 応答
成功した場合、このメソッドは更新された金額でユーザーの支出予算を返します。
応答の成功とエラーのコード
各応答には、成功または失敗を示す HTTP ステータス コードと、追加のデバッグ情報が付属しています。 このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワーク トレース ツールを使用します。 完全な一覧については、エラー コードに関するページを参照してください。
応答の例
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, 10 Nov 2015 19:09:59 GMT
{
{
"amount": 100,
"usageSpendingBudget": 100,
"attributes":{
"objectType":"SpendingBudget"
}
},
"links":{
"self":{
"uri":"/v1/customers/<customer-tenant-id>/usagebudget",
"method":"PATCH",
"headers":[]
}
}
}