적용 대상: 파트너 센터 | 21Vianet이 운영하는 파트너 센터 | 미국 정부용 Microsoft Cloud 파트너 센터
구독을 사용하면 고객이 특정 기간 동안 서비스를 사용할 수 있습니다. 모든 필드가 모든 구독에 적용되는 것은 아닙니다. 구독이 일시 중단되거나 취소되는 경우와 같이 수명 주기의 특정 지점에만 많은 필드가 적용됩니다.
구독
비고
구독 리소스의 속도 제한은 테넌트 식별자당 분당 500개 요청입니다.
구독 리소스는 구독의 수명 주기를 나타내며 구독 수명 주기 동안 상태를 정의하는 속성을 포함합니다.
| 재산 | 유형 | 설명 |
|---|---|---|
| 아이디 | 문자열 | 구독 식별자입니다. |
| 오퍼 ID | 문자열 | 오퍼 식별자입니다. |
| 사용권 ID | 문자열 | 권한 식별자(Azure 구독 ID)입니다. |
| 오퍼이름 | 문자열 | 제안 이름입니다. |
| 친근한 이름 | 문자열 | 명확하게 구분하기 위해 파트너가 정의한 구독의 이름입니다. |
| 수량 | 숫자 | 수량입니다. 이 속성은 라이선스 기반 청구에 대한 라이선스 수로 설정됩니다. |
| 단위 유형 | 문자열 | 구독의 수량을 정의하는 단위: "라이선스", "사용량 기반" 또는 "혜택" |
| 상위 구독 ID | 문자열 | 부모 구독 식별자를 가져오거나 설정합니다. |
| 생성일 | 문자열 | 만든 날짜를 날짜-시간 형식으로 가져오거나 설정합니다. |
| 유효 시작일 | UTC 날짜/시간 형식의 문자열 | 이 구독의 유효 시작 날짜를 날짜-시간 형식으로 가져오거나 설정합니다. 이 속성은 마이그레이션된 구독의 날짜를 다시 지정하거나 다른 구독과 정렬하는 데 사용됩니다. |
| 약정 종료일 | UTC 날짜/시간 형식의 문자열 | 이 구독의 약정 종료 날짜(날짜-시간 형식)입니다. 자동 갱신할 수 없는 구독의 경우 이 속성은 나중에 멀리 떨어진 날짜를 나타냅니다. 새로운 상거래 종료 날짜는 포함성을 가지며, 즉, 계약 기간의 종료는 하루가 끝날 때 이루어집니다. 레거시 종료 날짜는 포함되지 않습니다. |
| 약정종료일시 | UTC 날짜/시간 형식의 문자열 | 이 구독에 대한 약정 종료 날짜 및 시간(날짜-시간 형식)입니다. 자동 갱신할 수 없는 구독의 경우 이 속성은 나중에 멀리 떨어진 날짜를 나타냅니다. |
| 상태 | 문자열 | 구독 상태: "none"(없음), "active"(활성), "pending"(대기 중), "suspended"(일시 중단), "expired"(만료됨), "disabled"(비활성화) 또는 "deleted"(삭제됨). |
| 자동 갱신 사용 설정 | 불리언 | 구독이 자동으로 갱신되는지 여부를 나타내는 값을 가져옵니다. |
| 청구 유형 | 문자열 | 구독 요금 청구 방식: "없음", "사용량", "라이선스", "혜택". |
| 빌링사이클 | 문자열 | 이 주문에 대해 파트너에게 요금이 청구되는 빈도를 나타냅니다. 지원되는 값은 BillingCycleType에 있는 멤버 이름입니다. |
| 구매 가능한 추가 기능 보유 | 불리언 | 구독에 구매할 수 있는 추가 기능이 있는지 여부를 나타내는 값을 가져오거나 설정합니다. |
| isTrial | 불리언 | 구독이 평가판인지 여부를 나타내는 값입니다. |
| Microsoft제품인지 | 불리언 | 구독이 Microsoft 제품인지 여부를 나타내는 값입니다. |
| 출판사 이름 | 문자열 | 게시자 이름입니다. |
| 행동 | 문자열 배열 | 허용되는 작업을 가져오거나 설정합니다. 가능한 값: "edit", "cancel" |
| partnerId | 문자열 | 간접 파트너 모델에 사용되는 레코드 재판매인의 PartnerID입니다. |
| 추가 파트너 ID | 문자열 배열 | EU/EFTA 시장에서 유통업체만 사용하는 PartnerID 모음입니다. |
| 정지 사유 | 문자열 배열 | 읽기 전용입니다. 구독이 일시 중단된 경우 이유를 나타냅니다. |
| 계약 유형 | 문자열 | 읽기 전용입니다. 계약 유형: "subscription", "productKey" 또는 "redemptionCode." |
| 환불 옵션 | RefundOption 리소스 배열 | 읽기 전용입니다. 이 구독에 사용할 수 있는 환불 옵션 집합입니다. |
| 다음 학기 일정 지침 (scheduledNextTermInstructions) | 다음 학기 일정 안내 | 다음 기간이 시작될 때 실행되는 예정된 명령을 가져오거나 설정합니다. |
| 다음 충전 지침 | nextChargeInstructions | 현재 기간이 끝날 때 보류 중인 청구 주기 변경에 대한 다음 기간 청구 지침에 대한 세부 정보를 가져옵니다. |
| 링크 | SubscriptionLinks | 구독 링크를 가져오거나 설정합니다. |
| 주문 ID | 문자열 | 구독을 시작하기 위해 배치된 주문의 ID입니다. |
| 기간 | 문자열 | 해당 용어의 기간을 ISO 8601 형식으로 표현한 것입니다. 현재 지원되는 값은 P1M(1개월), P1Y(1년) 및 P3Y(3년)입니다. |
| 용어 생명주기 상태 | 문자열 | 구독 기간 수명 주기 상태의 표현입니다. 현재 지원되는 값은 GA (일반 공급), EndOfSale 및 EndOfSaleWithConversions 입니다(변환할 수 있음). |
| 특성 | ResourceAttributes | 구독에 해당하는 메타데이터 특성입니다. |
| 갱신 기간 | 문자열 | 해당 용어의 기간을 ISO 8601 형식으로 표현한 것입니다. 현재 지원되는 값은 P1M(1개월) 및 P1Y(1년)입니다. |
| 제품 유형 | 항목 유형 | 읽기 전용입니다. 구독의 제품 유형입니다. |
| 소비 유형 | 초과분 리소스 배열 | 지정된 고객에 대한 초과분(overage)을 가져오거나 설정합니다. |
| promotionId | 문자열 | 구독에 적용되는 경우 승격 식별자입니다. 형식 예제: "39NFJQT1PJQB:0001:39NFJQT1Q5KN" |
| 취소 허용 기한 | 날짜와 시간 | 취소의 마지막 날짜입니다. |
| 청구 주기 종료일 | 날짜와 시간 | 이 구독의 청구 주기 종료 날짜를 날짜-시간 형식으로 가져오거나 설정합니다. |
| 청구 주기 종료 날짜 및 시간 | 날짜와 시간 | 이 구독에 대한 청구 주기 종료 날짜 시간을 날짜-시간 형식으로 가져옵니다. |
| 제품 주문 ID | 문자열 | 특정 제품 구매에 대한 식별자입니다(예: 예약 또는 Azure 저축 계획). |
| lineItems | SubscriptionLineItem | 품목에는 특정 구독의 구매 세부 정보가 포함됩니다. |
구독 링크
SubscriptionLinks 리소스는 구독 리소스에 연결된 링크의 컬렉션을 설명합니다.
| 재산 | 유형 | 설명 |
|---|---|---|
| 제안 | 링크 | 제안을 가져오거나 설정합니다. |
| 상위 구독 | 링크 | 부모 구독을 가져오거나 설정합니다. |
| 제품 | 링크 | 구독과 연결된 제품을 가져옵니다. |
| SKU (재고 관리 코드) | 링크 | 구독과 연결된 제품 sku를 가져옵니다. |
| 가용도 | 링크 | 구독과 연결된 제품 sku 가용성을 가져옵니다. |
| 활성화 링크 | 링크 | 구독과 연결된 활성화 링크 목록을 가져옵니다. |
| 자신 | 링크 | 자체 URI입니다. |
| 다음 | 링크 | 항목의 다음 페이지입니다. |
| 이전 | 링크 | 항목의 이전 페이지입니다. |
구독 프로비저닝 상태
SubscriptionProvisioningStatus 리소스는 구독의 프로비저닝 상태에 대한 정보를 제공합니다.
| 재산 | 유형 | 설명 |
|---|---|---|
| 스쿠이드 | 문자열 | 제품 SKU를 식별하는 문자열입니다. |
| 상태 | 문자열 | 프로비저닝 상태를 나타냅니다: "성공", "보류 중" 또는 "실패". |
| 수량 | 숫자 | 프로비전 후 구독 수량을 제공합니다. |
| 종료일 | UTC 날짜/시간 형식의 문자열 | 구독의 종료 날짜입니다. |
| 특성 | ResourceAttributes | 메타데이터 특성입니다. |
다음 학기 일정 지침 (scheduledNextTermInstructions)
scheduledNextTermInstructions 리소스는 구독의 다음 기간이 시작될 때 적용할 지침을 정의합니다. 예약된 변경 내용이 설정되거나 모든 평가판 구독에만 존재합니다.
| 재산 | 유형 | 설명 |
|---|---|---|
| 제품 | 제품 | 제품 SKU를 식별하는 GUID 형식 문자열입니다. |
| 수량 | 숫자 | 프로비전 후 구독 수량을 제공합니다. |
| 사용자 정의 계약 종료일 | UTC 날짜/시간 형식의 문자열 | 다른 구독의 종료 날짜에 맞춰진 경우 구독에 대한 사용자 지정 종료 날짜 |
제품
scheduledNextTermInstructions.product 리소스 및 특성은 예약된 변경 내용이 다음 기간에 적용됩니다.
| 재산 | 유형 | 설명 |
|---|---|---|
| 제품 ID | 문자열 | 제품의 ID입니다. |
| 스쿠이드 | 문자열 | 프로비전 후 구독 수량을 제공합니다. |
| 가용성ID | 문자열 | 해당 가용성의 ID입니다. 이 ID는 부모 제품 및 SKU컨텍스트 내에서만 고유합니다. 가용성 ID는 시간이 지남에 따라 변경될 수 있습니다. 파트너는 값을 얻은 후 짧은 시간 내에만 이를 사용해야 합니다. |
| 빌링사이클 | 문자열 | 이 주문에 대해 파트너에게 요금이 청구되는 빈도를 나타냅니다. 지원되는 값은 BillingCycleType에 있는 멤버 이름입니다. |
| 기간 | 문자열 | 해당 용어의 기간을 ISO 8601 형식으로 표현한 것입니다. 현재 지원되는 값은 P1M(1개월) 및 P1Y(1년)입니다. |
| promotionId | 문자열 | 다음 예약된 기간에 적용할 프로모션 ID입니다. 형식 예제: "39NFJQT1PJQB:0001:39NFJQT1Q5KN." |
다음 충전 지침
nextChargeInstructions 리소스는 구독의 다음 기간이 시작될 때 적용되는 청구 주기 지침을 정의합니다. 보류 중인 청구 주기 변경이 보류 중인 경우에만 존재합니다.
| 재산 | 유형 | 설명 |
|---|---|---|
| 제품 | 제품 | 제품 SKU를 식별하는 GUID 형식 문자열입니다. |
| 수량 | 숫자 | 프로비전 후 구독 수량을 제공합니다. |
구독 등록 상태
SubscriptionRegistrationStatus 리소스는 구독 리소스에 연결된 링크의 컬렉션을 설명합니다.
| 재산 | 유형 | 설명 |
|---|---|---|
| 구독ID | 문자열 | 구독 식별자입니다. |
| 상태 | 문자열 | 등록 상태를 나타냅니다: "등록됨", "등록 중", 또는 "미등록". |
지원 연락처
SupportContact 리소스는 고객의 구독에 대한 지원 연락처를 나타냅니다.
| 재산 | 유형 | 설명 |
|---|---|---|
| 지원테넌트아이디 | 문자열 | 지원 연락처의 테넌트 식별자를 나타내는 GUID 형식 문자열입니다. |
| supportMpnId (지원 MPN ID) | 문자열 | 연락처의 파트너 식별자입니다. |
| 이름 | 문자열 | 지원 연락처의 이름입니다. |
| 링크 | ResourceLinks | 지원 연락처 관련 링크입니다. |
| 특성 | ResourceAttributes | 메타데이터 특성입니다. "objectType": "SupportContact"를 포함합니다. |
초과분
초과분 리소스는 소비 구독의 초과 사용량이 할당되었는지 여부와 이에 할당된 재판매인을 나타냅니다.
| 재산 | 유형 | 설명 |
|---|---|---|
| azureEntitlementId | 문자열 | 소비 구독 식별자를 나타내는 GUID 형식 문자열입니다. |
| partnerId | 문자열 | 구독과 연결된 재판매인의 파트너 식별자입니다. |
| 유형 | 문자열 | 초과분 유형은 "PhoneServices"일 수 있습니다. |
| 초과분 | 불리언 | 초과분 사용 여부를 나타내는 값입니다. |
| 링크 | ResourceLinks | 초과분 관련 링크입니다. |
| 특성 | ResourceAttributes | 메타데이터 특성입니다. "objectType": "Overage"를 포함합니다. |
구독 등록
RegisterSubscription 리소스는 구독의 등록 상태를 쿼리하는 데 사용할 수 있는 링크를 반환합니다. 등록 상태는 성공적으로 수락된 Azure 구독 등록 요청의 응답 본문에 반환됩니다.
| 재산 | 유형 | 설명 |
|---|---|---|
| httpResponseMessage | 객체 | 등록 상태를 쿼리하는 링크가 포함된 위치 헤더를 사용하여 HTTP 상태 코드 202 "수락됨"을 반환합니다. 예를 들어 "/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus" |
환불 옵션
RefundOption 리소스는 구독에 대한 가능한 환불 옵션을 나타냅니다.
| 재산 | 유형 | 설명 |
|---|---|---|
| 유형 | 문자열 | 환불 유형입니다. 지원되는 값은 "Partial" 및 "Full"입니다. |
| 만료 후 | UTC 날짜/시간 형식의 문자열 | 이 옵션이 만료되는 타임스탬프입니다. null이면 환불 작업에 만료가 없습니다. |
Azure 사용 권한
AzureEntitlement 리소스는 구독에 대한 Azure 자격을 나타냅니다.
| 재산 | 유형 | 설명 |
|---|---|---|
| 아이디 | 문자열 | 권한 식별자 |
| 친근한 이름 | 문자열 | 자격의 친근한 이름입니다. |
| 상태 | 문자열 | 자격 상태. |
| 구독ID | 문자열 | 권한이 속한 구독 식별자입니다. |
구독항목
품목에는 특정 구독의 구매 세부 정보가 포함됩니다.
| 재산 | 유형 | 설명 |
|---|---|---|
| 아이디 | 문자열 | 구독 항목 식별자입니다. |
| 친근한 이름 | 문자열 | 명확하게 구분하기 위해 파트너가 정의한 구독 품목의 이름입니다. |
| 범위 | 범위 | 범위는 혜택이 적용되는 위치를 나타냅니다. |
| 자동 갱신 사용 설정 | 불리언 (Boolean) | 구독이 자동으로 갱신되는지 여부를 나타내는 값을 가져옵니다. |
| 상태 | 문자열 | 구독 상태: "none"(없음), "active"(활성), "pending"(대기 중), "suspended"(일시 중단), "expired"(만료됨), "disabled"(비활성화) 또는 "deleted"(삭제됨). |
| 구매 약정 | 구매 약정 | 컴퓨팅 서비스에 커밋된 고정 금액입니다. |
범위
범위는 혜택이 적용되는 위치를 나타냅니다.
| 재산 | 유형 | 설명 |
|---|---|---|
| 유형 | 문자열 | 구매의 범위 유형: "단일", "공유", "리소스 그룹" 또는 "관리 그룹" |
| 구독ID | 문자열 | 구매에 사용할 Azure 플랜의 ID입니다. 공유 범위에 필요합니다. |
| 사용권 ID | 문자열 | 구매에 사용할 Azure 구독의 ID입니다. 단일 범위에 필요합니다. |
| 관리 그룹 ID | 문자열 | 구매에 사용할 관리 그룹의 ID입니다. 이 범위는 현재 Azure Portal을 통해서만 선택할 수 있지만 업데이트는 PC에 반영됩니다. |
| 리소스그룹ID | 문자열 | 구매에 사용할 리소스 그룹의 ID입니다. 이 범위는 현재 Azure Portal을 통해서만 선택할 수 있지만 업데이트는 PC에 반영됩니다. |
구매 약정
컴퓨팅 서비스에 커밋된 고정 금액입니다.
| 재산 | 유형 | 설명 |
|---|---|---|
| 양 | 문자열 | 고정 금액 약정입니다. |
| 곡물 | 문자열 | 약정 기간입니다. |
| 통화 | 문자열 | 약정의 통화. |