제품 리소스
구매할 수 있는 상품 또는 서비스를 나타내는 리소스입니다. 제품 유형 및 셰이프(SKU)를 설명하고 인벤토리에서 제품의 가용성을 확인하기 위한 리소스를 포함합니다.
제품
구매 가능한 양수 또는 서비스를 나타냅니다. 제품 자체는 구매할 수 있는 항목이 아닙니다.
재산 | 유형 | 설명 |
---|---|---|
아이디 | 문자열 | 제품의 ID입니다. |
타이틀 | 문자열 | 제품 제목입니다. |
설명 | 문자열 | 제품 설명입니다. |
제품 유형 | 항목 유형 | 이 제품의 형식 분류를 설명하는 개체입니다. |
isMicrosoftProduct | Bool | 제품이 Microsoft 제품인지를 나타냅니다. |
출판사 이름 | 문자열 | 사용 가능한 경우 제품 게시자의 이름입니다. |
링크 | ProductLinks | 제품 내에 포함된 리소스 링크입니다. |
항목 유형
제품의 유형을 나타냅니다.
재산 | 유형 | 설명 |
---|---|---|
아이디 | 문자열 | 형식 식별자입니다. |
표시 이름 | 문자열 | 항목 형식의 표시 이름입니다. |
하위 유형 | 항목 유형 | 선택적. 항목 형식에 대한 하위 형식 분류를 설명하는 개체입니다. |
ProductLinks
제품의 링크 목록을 포함하고 있습니다.
재산 | 유형 | 설명 |
---|---|---|
SKU 목록 | 링크 | 기본 SKU에 액세스하기 위한 링크입니다. |
링크 | 리소스 링크 | 리소스 내에 포함된 리소스 링크입니다. |
Sku
제품 아래에 있는 구매 가능한 SKU(재고 보관 장치)를 나타냅니다.
재산 | 유형 | 설명 |
---|---|---|
아이디 | 문자열 | SKU의 ID입니다. ID는 부모 제품의 컨텍스트 내에서만 고유합니다. |
타이틀 | 문자열 | SKU의 제목입니다. |
설명 | 문자열 | SKU에 대한 설명입니다. |
productId | 문자열 | SKU를 포함하는 상위 제품의 ID입니다 (Product). |
최소 수량 | Int | 구매에 허용되는 최소 수량입니다. |
최대 수량 | Int | 구매에 허용되는 최대 수량입니다. |
isTrial | Bool | SKU가 평가판 항목인지 여부를 나타냅니다. |
지원되는 청구 주기 | 문자열 배열 | SKU에 대해 지원되는 청구 주기 목록입니다. 지원되는 값은 BillingCycleType있는 멤버 이름입니다. |
구매 전제 조건 | 문자열 배열 | 항목을 구매하기 전에 필요한 필수 조건 단계 또는 작업 목록입니다. 지원되는 값은 다음과 같습니다. "InventoryCheck" - 항목 구매를 시도하기 전에 항목의 인벤토리를 평가해야 임을 나타냅니다. "AzureSubscriptionRegistration" - Azure 구독이 필요하고 항목을 구매하기 전에 등록해야 임을 나타냅니다. |
재고변수 | 문자열 배열 | 항목에 대한 인벤토리 검사를 실행하는 데 필요한 변수 목록입니다. 지원되는 값은 다음과 같습니다. "CustomerId" - 구매 대상 고객의 ID입니다. "AzureSubscriptionId" - Azure 예약 구매에 사용할 Azure 구독의 ID입니다. "ArmRegionName" - 인벤토리를 확인할 지역입니다. 이 값은 SKU의 DynamicAttributes에서 "ArmRegionName"과 일치해야 합니다. |
프로비저닝 변수 | 문자열 배열 | 항목을 구매할 때, 카트 품목의 프로비저닝 컨텍스트에 제공해야 하는 변수 목록입니다. 지원되는 값은 다음과 같습니다. 범위 - Azure 예약 구매의 범위: "단일", "공유". "SubscriptionId" - Azure 예약 구매에 사용할 Azure 구독의 ID입니다. "기간" - Azure 예약 기간: "1Year", "3Year". |
dynamicAttributes | 키/값 쌍 | 항목에 적용되는 동적 속성의 사전입니다. 사전의 속성은 동적이며 예고 없이 변경할 수 있습니다. 파트너는 속성 값에 존재하는 특정 키에 대한 강력한 종속성을 만들지 않아야 합니다. |
링크 | 리소스 링크 | SKU 내에 포함된 리소스 링크입니다. |
인증 속성 | AttestationProperties | SKU에 대한 증명 속성입니다. |
소비 유형 | 문자열 | sku가 초과분과 같은 소비를 지원하는 경우에만 사용 가능합니다. |
특화된 제안 속성 | 'specializedOfferProperties' 목록 | 제품이 SpecializedOffer의 subType인 경우에만 사용할 수 있습니다. |
최소 구매 약정 | 최소 구매 약정 | 컴퓨팅 서비스에 커밋된 고정 금액입니다. |
동적 SKU 특성
새로운 상거래 라이선스 기반 제품 및 서비스와 관련된 주목할 만한 속성입니다.
메모
라이선스 기반 서비스에 대한 새로운 상거래 환경에는 많은 새로운 기능이 포함되며 모든 CSP(클라우드 솔루션 공급자)에서 사용할 수 있습니다. 자세한 내용은 새 상거래 환경 개요참조하세요.
재산 | 유형 | 설명 |
---|---|---|
제약조건이 있음 | 불리언 | SKU에 assetContraints가 포함되어 있는지 설명합니다. |
추가 기능 여부 | 불리언 | SKU가 추가 기능인지 설명합니다. |
필수 선행 조건 SKU | 문자열 배열 | 추가 기능이 사용할 수 있는 제품 및 SKU에 대해 설명합니다. |
upgradeTargetOffers | 문자열 배열 | 항목이 업그레이드할 수 있는 제품 및 SKU 목록 |
변환지침 | 변환 지침 목록 | 변환 작업에 적용할 수 있는 지침 목록 |
특화된 제안 속성
메모
라이선스 기반 서비스에 대한 새로운 상거래 환경에는 많은 새로운 기능이 포함되며 모든 CSP(클라우드 솔루션 공급자)에서 사용할 수 있습니다. 자세한 내용은 새 상거래 환경 개요참조하세요.
제품 하위 유형 "SpecializedOffers"에만 적용됩니다.
재산 | 유형 | 설명 |
---|---|---|
시작 날짜 | 문자열 | 지침이 적용되는 용어 ID |
종료일 | 문자열 | 갱신을 정의하는 옵션 |
가격 정책 | 가격 정책 목록 | 프로모션 할인 유형 및 값을 정의하는 정책 목록입니다. |
최소 구매 약정
컴퓨팅 서비스에서 커밋할 수 있는 최소 금액의 특성입니다.
재산 | 유형 | 설명 |
---|---|---|
곡물 | 문자열 | 최소 구매 약정 기간입니다. |
통화 코드 | 딕셔너리<문자열, 문자열> | 커밋할 수 있는 최소 금액의 "통화" 및 "기호"입니다. |
양 | Int | 컴퓨팅 서비스에서 커밋할 수 있는 최소 금액입니다. |
가격 정책
프로모션 할인 유형 및 값을 설명합니다.
재산 | 유형 | 설명 |
---|---|---|
유형 | 문자열 | 할인이 백분율 또는 정액 할인을 기반으로 하는지를 설명합니다. |
값 | 문자열 | 적용되는 할인 금액을 정의합니다. |
가용도
SKU를 구매할 수 있는 구성(예: 국가/지역, 통화 및 산업 세그먼트)을 나타냅니다.
재산 | 유형 | 설명 |
---|---|---|
아이디 | 문자열 | 해당 가용성의 ID입니다. 이 ID는 부모 제품 및 SKU컨텍스트 내에서만 고유합니다. 가용성 ID는 시간이 지남에 따라 변경될 수 있습니다. 파트너는 값을 얻은 후 짧은 시간 내에만 이를 사용해야 합니다. |
productId | 문자열 | 이 가용성을 포함하는 제품의 ID입니다. |
skuId | 문자열 | 이 가용성을 포함하는 SKU 의 ID는입니다. |
카탈로그 항목 ID | 문자열 | 카탈로그에서 이 항목의 고유 식별자입니다. 부모 SKU구매할 때 이 ID는 OrderLineItem.OfferId 또는 CartLineItem.CatalogItemId 속성으로 채워야 합니다. 참고 사항: 이 ID는 시간이 지남에 따라 변경될 수 있습니다. 이 값은 검색 후 짧은 시간 내에만 사용해야 합니다. 구매 시에만 액세스하여 사용해야 합니다. |
기본통화 | 문자열 | 이 가용성에 지원되는 기본 통화입니다. |
세그먼트 | 문자열 | 이 가용성에 대한 업계 세그먼트입니다. 지원되는 값은 상용, 교육, 정부, NonProfit입니다. |
나라 | 문자열 | 이 가용성이 적용되는 국가 또는 지역(ISO 국가 코드 형식)입니다. |
구매 가능함 | Bool | 이 가용성을 구매할 수 있는지 여부를 나타냅니다. |
재생 가능 여부 | Bool | 이 가용성이 재생 가능한지 여부를 나타냅니다. |
갱신 지침 | RenewalInstruction | 지정된 가용성에 대한 갱신 지침을 나타냅니다. |
제품 | 제품 | 이 가용성에 해당하는 제품입니다. |
SKU (재고 관리 코드) | Sku | 이 가용성이 해당하는 SKU입니다. |
용어 | Term 리소스 배열 | 이 가용성에 적용되는 용어의 컬렉션입니다. |
링크 | 리소스 링크 | 가용성 내에 포함된 리소스 링크입니다. |
갱신 지침
메모
라이선스 기반 서비스에 대한 새로운 상거래 환경에는 많은 새로운 기능이 포함되며 모든 CSP(클라우드 솔루션 공급자)에서 사용할 수 있습니다. 자세한 내용은 새 상거래 환경 개요참조하세요.
지정된 가용성에 대한 갱신 지침을 나타냅니다.
재산 | 유형 | 설명 |
---|---|---|
적용가능한용어ID | 문자열 배열 | 지침이 적용되는 용어 ID |
갱신 옵션 | 갱신 옵션 배열 | 갱신을 정의하는 옵션 |
갱신 옵션
메모
라이선스 기반 서비스에 대한 새로운 상거래 환경에는 많은 새로운 기능이 포함되며 모든 CSP(클라우드 솔루션 공급자)에서 사용할 수 있습니다. 자세한 내용은 새 상거래 환경 개요참조하세요.
지정된 가용성에 대한 갱신 지침을 나타냅니다.
재산 | 유형 | 설명 |
---|---|---|
renewToId | 문자열 | 갱신할 제품 및 sku를 나타냅니다. |
자동 갱신 가능 여부 | Bool | 가용성을 자동 갱신할 수 있는지 여부 |
기간
가용성을 구매할 수 있는 용어를 나타냅니다.
재산 | 유형 | 설명 |
---|---|---|
기간 | 문자열 | 용어 지속 기간의 ISO 8601 표현입니다. 현재 지원되는 값은 P1M(1개월), P1Y(1년) 및 P3Y(3년)입니다. |
설명 | 문자열 | 용어에 대한 설명입니다. |
재고 확인 요청
특정 카탈로그 항목에 대해 인벤토리를 확인하는 요청을 나타냅니다.
재산 | 유형 | 설명 |
---|---|---|
대상 항목들 | 인벤토리 항목 배열 | 인벤토리 검사에서 평가할 카탈로그 항목 목록입니다. |
재고 컨텍스트 | 키/값 쌍 | 인벤토리 검사를 수행하는 데 필요한 컨텍스트 값의 사전입니다. 제품의 각 SKU 이 작업을 수행하는 데 필요한 값(있는 경우)을 정의합니다. |
링크 | 리소스 링크 | 인벤토리 확인 요청에 포함된 리소스 링크입니다. |
재고 항목
인벤토리 검사 작업의 단일 항목을 나타냅니다. 이 리소스는 입력 요청에서 대상 항목을 지정하는 데 사용되며 인벤토리 검사 작업의 출력 결과를 나타내는 데도 사용됩니다.
재산 | 유형 | 설명 |
---|---|---|
productId | 문자열 | (필수) 제품ID입니다. |
skuId | 문자열 | SKUID입니다. 인벤토리 요청에 대한 입력으로 이 리소스를 사용하는 경우 이 값은 선택 사항입니다. 이 값이 제공되지 않으면 제품의 모든 SKU가 인벤토리 검사 작업의 대상 항목으로 간주됩니다. |
제한됨 | Bool | 이 항목에 제한된 인벤토리가 있는지 여부를 나타냅니다. |
제한 | InventoryRestriction 배열 | 이 항목에 대해 발견된 제한 사항에 대한 세부 정보입니다. 이 제한된 경우 = "true"일 때만 이 속성이 채워집니다. |
재고 제한
인벤토리 제한의 세부 정보를 나타냅니다. 이러한 세부 정보는 입력 요청이 아니라 인벤토리 검사 출력 결과에만 적용됩니다.
재산 | 유형 | 설명 |
---|---|---|
이유코드 | 문자열 | 제한 이유를 식별하는 코드입니다. |
설명 | 문자열 | 인벤토리 제한에 대한 설명입니다. |
속성 | 키/값 쌍 | 제한에 대한 자세한 정보를 제공할 수 있는 속성의 사전입니다. |
청구 주기 유형
청구 주기 유형을 나타내는 값이 있는 [Enum/dotnet/api/system.enum)입니다.
값 | 위치 | 설명 |
---|---|---|
알려지지 않은 | 0 | 열거형 이니셜라이저 |
매월 | 1 | 파트너가 매월 청구됨을 나타냅니다. |
연례 | 2 | 파트너에게 매년 청구된다는 것을 나타냅니다. |
없음 | 3 | 파트너에게 요금이 부과되지 않음을 나타냅니다. 이 값은 평가판 항목에 사용할 수 있습니다. |
일회성 | 4 | 파트너에게 일회 비용이 청구된다는 것을 나타냅니다. |
3년마다 열리는 | 5 | 파트너에게 3년마다 한 번씩 청구된다는 것을 나타냅니다. |
인증 속성
증명 유형과 구매에 필요한 경우를 나타냅니다.
재산 | 유형 | 설명 |
---|---|---|
인증 유형 | 문자열 | 증명 유형을 나타냅니다. Windows 365 제품은 Windows 365의 가치를 가집니다. Windows 365 증명 텍스트는 "Windows 하이브리드 혜택이 있는 Windows 365 Business를 사용하는 각 사용자도 기본 작업 장치에 Windows 10/11 Pro의 유효한 복사본을 설치해야 한다는 것을 알고 있습니다." |
증명 적용 | 불리언 | 증명이 구매에 필요한지 여부를 나타냅니다. |