업데이트 초과분

아티클
09/25/2024

적용 대상

파트너 센터

적절한 역할

관리 에이전트

참고 항목

라이선스 기반 서비스에 대한 새로운 상거래 환경에는 많은 새로운 기능이 포함되며 모든 CSP(클라우드 솔루션 공급자)에서 사용할 수 있습니다. 자세한 내용은 새 상거래 환경 개요를 참조하세요.

지정된 고객에 대한 초과분이 소비 구독으로 설정되는 데 사용됩니다. false로 설정하여 초과분 제거에도 사용할 수 있습니다. 초과분은 고객이 명시된 한도를 초과하여 서비스를 사용하는 경우 서비스를 계속 사용할 수 있게 해줍니다. 초과분은 종량제가 발생할 소비 구독 초과를 정의합니다.

필수 조건

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

REST 요청

[PUT] /customers/{customer-tenant-id}/subscriptions/overage

요청 구문

메서드	요청 URI
PUT	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/overage HTTP/1.1

URI 매개 변수

다음 쿼리 매개 변수를 사용하여 고객의 초과분 반환

속성	Type	필수	설명
customer-tenant-id	guid	Y	고객의 테넌트에 해당하는 GUID입니다.

요청 헤더

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

요청 본문

이름	형식	설명
azureEntitlementId	guid	초과분에 대한 소비 구독을 정의하는 GUID입니다.
partnerId	guid	간접 재판매인의 PartnerID입니다. 두 계층 모델(간접 공급자)에만 적용됩니다.
overageEnabled	부울	지정된 사용량 구독에 초과분이 사용하도록 설정되어야 하는지 여부를 나타냅니다.

요청 예제

PUT https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/overage HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

{
    "azureEntitlementId": "ea1c26b7-8c99-42bb-ba7d-c535831fae8e",
    "partnerId": "5357563",
    "overageEnabled": true
}

REST 응답

성공하면 이 메서드는 고객에 대한 초과분이 반환됩니다.

응답 성공 및 오류 코드

각 응답에는 성공 또는 실패와 추가 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 추가 매개 변수를 읽을 수 있습니다. 전체 목록은 오류 코드를 참조하세요.

응답 예제

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
    "azureEntitlementId": "ea1c26b7-8c99-42bb-ba7d-c535831fae8e",
    "partnerId": "5357563",
    "type": "PhoneServices",
    "overageEnabled": true,
    "links": {
        "overage": {
            "uri": "/customers/f62cf10b-8f76-4fc4-9774-c5291f8faf86/subscriptions/overage",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Overage"
    }
}

다음을 통해 공유