적용 : 파트너 센터 | 21Vianet에서 운영하는 파트너 센터 | 미국 정부를 위한 Microsoft 클라우드 파트너 센터
파트너는 고객을 위해 구매하는 NCE 라이선스 기반 구독에 대해 허용되는 사용자 지정 기간 종료 날짜를 볼 수 있습니다. 파트너는 해당 월의 끝 또는 기존 고객 구독과의 공동 기간에 맞는 종료 날짜를 볼 수 있습니다.
API는 기존 구독 갱신이 아닌 새 구독 구매에 대한 사용자 지정 기간 종료 날짜 계산만 지원합니다.
필수 구성 요소
파트너 센터 인증에 설명된 대로 자격 증명. 이 시나리오는 독립 실행형 앱 및 App+사용자 자격 증명을 모두 사용하여 인증을 지원합니다.
CustomerTenantId입니다. 고객의 ID를 모르는 경우 파트너 센터고객 작업 영역을 선택한 다음 고객 목록에서 고객을 선택한 다음 계정 조회할 수 있습니다. 고객의 계정 페이지에서 고객 계정 정보 섹션에서 Microsoft ID 찾습니다. Microsoft ID는 고객 ID와 동일합니다.
REST 요청
요청 구문
| 메서드 | 요청된 URI |
|---|---|
| 가져오기 | {baseURL}/v1/customers/{customerId}/subscriptions/customTermEndDates |
쿼리 문자열
이 표에는 사용자 지정 용어 종료 날짜를 필터링하고 검색하는 데 필요한 쿼리 문자열이 나열되어 있습니다.
| 이름: | 필수: | 묘사: |
|---|---|---|
| 기간_지속 | 예 | 용어 기간의 길이에 대한 ISO 8601 표현. 현재 지원되는 값은 P1M(1개월), P1Y(1년) 및 P3Y(3년)입니다. |
| 기간 시작일 | 아니요 | 원하는 구매 날짜입니다. 이것은 과거에 있을 수 없습니다. |
| target_coterm_subscription_id | 아니요 | 상호 작용할 구독을 식별하는 GUID 형식 문자열입니다. |
비고
API에 전달된 P1M 또는 월별 용어의 기간은 용어 맞춤에 사용되지 않을 수 있는 공동 용어 결과를 반환합니다. 월의 마지막 날짜가 아닌 한 월의 28일, 29일 또는 30일에 종료되는 구독에는 월별 맞춤을 사용할 수 없습니다.
요청 헤더
자세한 내용은 파트너 센터 REST 헤더 참조하세요. API의 응답은 최대 300개 페이지 레코드를 반환합니다. 입력된 쿼리에서 300개가 넘는 레코드가 반환되면 응답 헤더에 연속 토큰이 제공됩니다. 연속 토큰은 쿼리된 추가 페이지 레코드를 반환하기 위해 다음 요청의 헤더에 입력될 수 있습니다.
요청 본문
없음.
REST 응답
성공하면 이 메서드는 응답 본문에서 마이그레이션된 구독의 세부 정보를 반환합니다. 여기에는 마이그레이션 ID가 포함됩니다.
응답 성공 및 오류 코드
각 응답에는 성공 또는 실패 및 추가 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 추가 매개 변수를 읽습니다. 전체 목록은 파트너 센터 REST 오류 코드를 참조하세요.
요청 URL 예제
baseurl/v1/customers/94cd6638-11b6-4323-8c9f-6ae3088adc59/subscriptions/customTermEndDates?term_duration=P1M
응답 예제
{
"totalCount": 2,
"items": [
{
"allowedCustomTermEndDateType": "calendarMonthAligned",
"allowedCustomTermEndDate": "2023-07-31T00:00:00"
},
{
"allowedCustomTermEndDateType": "subscriptionAligned",
"cotermSubscriptionIds": [
"5fcf618b-1daa-4604-da99-cc3e1c9ee422",
"d30a9ff9-713e-4546-c97e-f06b9dcf6ef6"
],
"allowedCustomTermEndDate": "2023-08-01T00:00:00"
}
],
"links": {
"self": {
"uri": "/customers/94cd6638-11b6-4323-8c9f-6ae3088adc59/subscriptions/customTermEndDates?term_duration=P1M",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Collection"
}
}