사용자 지정 용어 종료 날짜 가져오기

아티클
02/21/2024

적용 대상: 파트너 센터 | 21Vianet에서 운영되는 파트너 센터 | Microsoft Cloud for US Government 파트너 센터

파트너는 고객을 위해 구매하는 NCE 라이선스 기반 구독에 대해 허용되는 사용자 지정 기간 종료 날짜를 볼 수 있습니다. 파트너는 해당 월의 끝 또는 기존 고객 구독과의 공동 기간에 맞는 종료 날짜를 볼 수 있습니다.

API는 기존 구독 갱신이 아닌 새 구독 구매에 대한 사용자 지정 기간 종료 날짜 계산만 지원합니다.

필수 조건

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

REST 요청

요청 구문

메서드	요청 URI
GET	{baseURL}/v1/customers/{customerId}/subscriptions/customTermEndDates

쿼리 문자열

이 표에는 사용자 지정 용어 종료 날짜를 필터링하고 검색하는 데 필요한 쿼리 문자열이 나열되어 있습니다.

이름:	필수:	설명:
term_duration	예	용어 기간의 ISO 8601 표현입니다. 현재 지원되는 값은 P1M (1개월), P1Y (1년) 및 P3Y (3년)입니다.
term_start_date	아니요	원하는 구매 날짜입니다. 이것은 과거에 있을 수 없습니다.
target_coterm_subscription_id	아니요	상호 작용할 구독을 식별하는 GUID 형식 문자열입니다.

요청 헤더

자세한 내용은 파트너 센터 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"
    }
 }