고객의 사용량 지출 예산 가져오기

아티클
06/27/2024

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

고객 사용 요약(CustomerUsageSummary 리소스)에서 지출 예산(SpendingBudget 개체)을 업데이트할 수 있습니다.

필수 조건

자격 증명(파트너 센터 인증에서 설명). 이 시나리오는 독립 실행형 앱과 App+사용자 자격 증명을 모두 사용하여 인증을 지원합니다.
고객 ID (customer-tenant-id). 고객의 ID를 모르는 경우 고객 작업 영역을 선택하고 고객 목록에서 고객을 선택한 다음 계정을 선택하여 파트너 센터에서 조회할 수 있습니다. 고객 계정 페이지의 고객 계정 정보 섹션에서 Microsoft ID를 찾습니다. Microsoft ID는 고객 ID(customer-tenant-id)와 동일합니다.

C#

고객의 사용량 지출 예산을 업데이트하려면 다음을 수행합니다.

업데이트된 금액으로 새 SpendingBudget 개체를 만듭니다.
IAggregatePartner.Customers 컬렉션을 사용하여 지정된 고객의 식별자를 사용하여 ById() 메서드를 호출합니다.
Get 또는 GetAsync 메서드를 호출하여 고객의 사용 예산을 가져옵니다.

// 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 요청

요청 구문

메서드	요청 URI
GET	{baseURL}/v1/customers/{customer-tenant-id}/usagebudget HTTP/1.1

URI 매개 변수

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

속성	Type	필수	설명
customer-tenant-id	guid	Y	이 값은 재판매인이 자신에게 속한 특정 고객에 대한 결과를 필터링할 수 있도록 하는 GUID 유형의 customer-tenant-id입니다.

요청 헤더

자세한 내용은 파트너 센터 REST 헤더를 참조하세요.

요청 본문

전체 리소스입니다.

요청 예제

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: aaaa0000-bb11-2222-33cc-444444dddddd
Content-Type: application/json;charset=utf-8
X-Locale: "en-US"

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

다음을 통해 공유