적용 대상
- 파트너 센터
적절한 역할
- 관리 에이전트
참고
라이선스 기반 서비스에 대한 새로운 상거래 환경에는 많은 새로운 기능이 포함되며 모든 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 매개 변수
다음 쿼리 매개 변수를 사용하여 고객의 초과분 반환
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
| 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"
}
}