고객의 사용량 지출 예산 업데이트

아티클
10/07/2024

적용 대상: 파트너 센터 | Microsoft Cloud for US Government 파트너 센터

고객의 사용량에 할당된 지출 예산을 업데이트합니다.

필수 구성 요소

자격 증명(파트너 센터 인증에서 설명). 이 시나리오는 독립 실행형 앱 및 App+사용자 자격 증명을 모두 사용하여 인증을 지원합니다.
고객 ID (customer-tenant-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 매개 변수

다음 쿼리 매개 변수를 사용하여 청구 프로필을 업데이트합니다.

Name	형식	필수	Description
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: aaaa0000-bb11-2222-33cc-444444dddddd
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: aaaa0000-bb11-2222-33cc-444444dddddd
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":[]
        }
    }
}

다음을 통해 공유