다음을 통해 공유


제품 리소스

구매할 수 있는 상품 또는 서비스를 나타내는 리소스입니다. 제품 유형 및 셰이프(SKU)를 설명하고 인벤토리에서 제품의 가용성을 확인하기 위한 리소스를 포함합니다.

제품

구매 가능한 양수 또는 서비스를 나타냅니다. 제품 자체는 구매할 수 있는 항목이 아닙니다.

재산 유형 설명
아이디 문자열 제품의 ID입니다.
타이틀 문자열 제품 제목입니다.
설명 문자열 제품 설명입니다.
제품 유형 항목 유형 이 제품의 형식 분류를 설명하는 개체입니다.
isMicrosoftProduct Bool 제품이 Microsoft 제품인지를 나타냅니다.
출판사 이름 문자열 사용 가능한 경우 제품 게시자의 이름입니다.
링크 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의 유효한 복사본을 설치해야 한다는 것을 알고 있습니다."
증명 적용 불리언 증명이 구매에 필요한지 여부를 나타냅니다.