다음을 통해 공유


제품 리소스

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

Product

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

속성 Type 설명
id 문자열 제품의 ID입니다.
title 문자열 제품 제목입니다.
description 문자열 제품 설명입니다.
productType ItemType 이 제품의 형식 분류를 설명하는 개체입니다.
isMicrosoftProduct Bool 제품이 Microsoft 제품인지를 나타냅니다.
publisherName 문자열 사용 가능한 경우 제품 게시자의 이름입니다.
링크 ProductLinks 제품 내에 포함된 리소스 링크입니다.

ItemType

제품의 유형을 나타냅니다.

속성 Type 설명
id 문자열 형식 식별자입니다.
displayName 문자열 항목 형식의 표시 이름입니다.
subType ItemType 선택 사항. 항목 형식에 대한 하위 형식 분류를 설명하는 개체입니다.

제품에 대한 링크 목록을 포함합니다.

속성 Type 설명
skus 링크 기본 SKU에 액세스하기 위한 링크입니다.
링크 ResourceLinks 리소스 내에 포함된 리소스 링크입니다.

SKU

제품 아래에 있는 구매 가능한 SKU(재고 보관 장치)를 나타냅니다.

속성 Type 설명
id 문자열 SKU의 ID입니다. ID는 부모 제품의 컨텍스트 내에서만 고유합니다.
title 문자열 SKU의 제목입니다.
description 문자열 SKU에 대한 설명입니다.
productId 문자열 SKU를 포함하는 부모 제품의 ID입니다.
minimumQuantity 정수 구매에 허용되는 최소 수량입니다.
maximumQuantity 정수 구매에 허용되는 최대 수량입니다.
isTrial Bool SKU가 평가판 항목인지 여부를 나타냅니다.
supportedBillingCycles 문자열 배열 SKU에 대해 지원되는 청구 주기 목록입니다. 지원되는 값은 BillingCycleType에 있는 멤버 이름입니다.
purchasePrerequisites 문자열 배열 항목을 구매하기 전에 필요한 필수 조건 단계 또는 작업 목록입니다. 지원되는 값은 다음과 같습니다.
"InventoryCheck" - 항목 구매를 시도하기 전에 항목의 인벤토리를 평가해야 임을 나타냅니다.
"AzureSubscriptionRegistration" - Azure 구독이 필요하고 항목을 구매하기 전에 등록해야 임을 나타냅니다.
inventoryVariables 문자열 배열 항목에 대한 인벤토리 검사를 실행하는 데 필요한 변수 목록입니다. 지원되는 값은 다음과 같습니다.
"CustomerId" - 구매 대상 고객의 ID입니다.
"AzureSubscriptionId" - Azure 예약 구매에 사용할 Azure 구독의 ID입니다.
"ArmRegionName" - 인벤토리를 확인할 지역입니다. 이 값은 SKU의 DynamicAttributes에서 "ArmRegionName"과 일치해야 합니다.
provisioningVariables 문자열 배열 항목을 구매할 때 카트 품목의 프로비저닝 컨텍스트에 제공해야 하는 변수 목록입니다. 지원되는 값은 다음과 같습니다.
범위 - Azure 예약 구매 범위: "Single", "Shared".
"SubscriptionId" - Azure 예약 구매에 사용할 Azure 구독의 ID입니다.
"기간" - Azure 예약 기간: "1Year", "3Year".
dynamicAttributes 키/값 쌍 항목에 적용되는 동적 속성의 사전입니다. 사전의 속성은 동적이며 예고 없이 변경할 수 있습니다. 파트너는 속성 값에 존재하는 특정 키에 대한 강력한 종속성을 만들지 않아야 합니다.
링크 ResourceLinks SKU 내에 포함된 리소스 링크입니다.
AttestationProperties AttestationProperties SKU에 대한 증명 속성입니다.
consumptionType 문자열 sku가 초과분과 같은 소비를 지원하는 경우에만 사용할 수 있습니다.
specializedOfferProperties specializedOfferProperties 목록 제품이 SpecializedOffer의 subType인 경우에만 사용할 수 있습니다.
minimumPurchaseCommitment MinimumPurchaseCommitment 컴퓨팅 서비스에 커밋된 고정 금액입니다.

동적 SKU 특성

새로운 상거래 라이선스 기반 제품 및 서비스와 관련된 주목할 만한 속성입니다.

참고 항목

라이선스 기반 서비스에 대한 새로운 상거래 환경에는 많은 새로운 기능이 포함되며 모든 CSP(클라우드 솔루션 공급자)에서 사용할 수 있습니다. 자세한 내용은 새 상거래 환경 개요를 참조하세요.

속성 Type 설명
hasConstraints Boolean SKU에 assetContraints가 포함되어 있는지 설명합니다.
isAddon Boolean SKU가 추가 기능인지 설명합니다.
prerequisiteSkus 문자열 배열 추가 기능이 사용할 수 있는 제품 및 SKU에 대해 설명합니다.
upgradeTargetOffers 문자열 배열 항목이 업그레이드할 수 있는 제품 및 SKU 목록
conversionInstructions conversionInstructions 목록 변환 작업에 적용할 수 있는 지침 목록

specializedOfferProperties

참고 항목

라이선스 기반 서비스에 대한 새로운 상거래 환경에는 많은 새로운 기능이 포함되며 모든 CSP(클라우드 솔루션 공급자)에서 사용할 수 있습니다. 자세한 내용은 새 상거래 환경 개요를 참조하세요.

제품 하위 유형 "SpecializedOffers"에만 적용됩니다.

속성 Type 설명
startDate 문자열 지침이 적용되는 용어 ID
endDate 문자열 갱신을 정의하는 옵션
pricingPolicies pricingPolicies 목록 프로모션 할인 유형 및 값을 정의하는 정책 목록입니다.

MinimumPurchaseCommitment

컴퓨팅 서비스에서 커밋할 수 있는 최소 금액의 특성입니다.

속성 Type 설명
곡물 문자열 최소 구매 약정 기간입니다.
currencyCode <사전 문자열, 문자열> 커밋할 수 있는 최소 금액의 "통화" 및 "기호"입니다.
금액 정수 컴퓨팅 서비스에서 커밋할 수 있는 최소 금액입니다.

PricingPolicies

프로모션 할인 유형 및 값을 설명합니다.

속성 Type 설명
type 문자열 할인이 백분율 또는 정액 할인을 기반으로 하는지를 설명합니다.
value 문자열 적용되는 할인 금액을 정의합니다.

가용성

SKU를 구매할 수 있는 구성(예: 국가/지역, 통화 및 산업 세그먼트)을 나타냅니다.

속성 Type 설명
id 문자열 이 가용성의 ID입니다. 이 ID는 부모 제품SKU의 컨텍스트 내에서만 고유합니다. 가용성 ID는 시간이 지남에 따라 변경될 수 있습니다. 파트너는 검색한 후 짧은 시간 내에만 이 값을 사용해야 합니다.
productId 문자열 이 가용성을 포함하는 제품의 ID입니다.
skuId 문자열 이 가용성을 포함하는 SKU 의 ID입니다.
catalogItemId 문자열 카탈로그에서 이 항목의 고유 식별자입니다. 부모 SKU구매할 때 이 ID는 OrderLineItem.OfferId 또는 CartLineItem.CatalogItemId 속성으로 채워져야 합니다. 이 ID는 시간이 지남에 따라 변경 될 수 있습니다. 이 값은 검색 후 짧은 시간 내에만 사용해야 합니다. 구매 시에만 액세스하여 사용해야 합니다.
defaultCurrency 문자열 이 가용성에 지원되는 기본 통화입니다.
세그먼트 문자열 이 가용성에 대한 업계 세그먼트입니다. 지원되는 값은 상용, 교육, 정부, NonProfit입니다.
country 문자열 이 가용성이 적용되는 국가 또는 지역(ISO 국가 코드 형식)입니다.
isPurchasable Bool 이 가용성을 구매할 수 있는지 여부를 나타냅니다.
isRenewable Bool 이 가용성이 재생 가능한지 여부를 나타냅니다.
RenewalInstructions RenewalInstruction 지정된 가용성에 대한 갱신 지침을 나타냅니다.
product Product 이 가용성에 해당하는 제품입니다.
sku Sku 이 가용성이 해당하는 SKU입니다.
terms 용어 리소스 배열 이 가용성에 적용되는 용어의 컬렉션입니다.
링크 ResourceLinks 가용성 내에 포함된 리소스 링크입니다.

갱신 지침

참고 항목

라이선스 기반 서비스에 대한 새로운 상거래 환경에는 많은 새로운 기능이 포함되며 모든 CSP(클라우드 솔루션 공급자)에서 사용할 수 있습니다. 자세한 내용은 새 상거래 환경 개요를 참조하세요.

지정된 가용성에 대한 갱신 지침을 나타냅니다.

속성 Type 설명
applicableTermIds 문자열 배열 지침이 적용되는 용어 ID
RenewalOptions RenewalOption 배열 갱신을 정의하는 옵션

RenewalOption

참고 항목

라이선스 기반 서비스에 대한 새로운 상거래 환경에는 많은 새로운 기능이 포함되며 모든 CSP(클라우드 솔루션 공급자)에서 사용할 수 있습니다. 자세한 내용은 새 상거래 환경 개요를 참조하세요.

지정된 가용성에 대한 갱신 지침을 나타냅니다.

속성 Type 설명
renewToId 문자열 갱신할 제품 및 sku를 나타냅니다.
isAutoRenewable Bool 가용성을 자동 갱신할 수 있는지 여부

용어

가용성을 구매할 수 있는 용어를 나타냅니다.

속성 Type 설명
duration 문자열 용어 기간의 ISO 8601 표현입니다. 현재 지원되는 값은 P1M(1개월), P1Y(1년) 및 P3Y(3년)입니다.
description 문자열 용어에 대한 설명입니다.

InventoryCheckRequest

특정 카탈로그 항목에 대해 인벤토리를 확인하는 요청을 나타냅니다.

속성 Type 설명
targetItems InventoryItem 배열 인벤토리 검사에서 평가할 카탈로그 항목 목록입니다.
inventoryContext 키/값 쌍 인벤토리 검사를 수행하는 데 필요한 컨텍스트 값의 사전입니다. 제품의 각 SKU 는 이 작업을 수행하는 데 필요한 값(있는 경우)을 정의합니다.
링크 ResourceLinks 인벤토리 확인 요청에 포함된 리소스 링크입니다.

InventoryItem

인벤토리 검사 작업의 단일 항목을 나타냅니다. 이 리소스는 입력 요청에서 대상 항목을 지정하는 데 사용되며 인벤토리 검사 작업의 출력 결과를 나타내는 데도 사용됩니다.

속성 Type 설명
productId 문자열 (필수) 제품의 ID입니다.
skuId 문자열 SKUID입니다. 인벤토리 요청에 대한 입력으로 이 리소스를 사용하는 경우 이 값은 선택 사항입니다. 이 값이 제공되지 않으면 제품의 모든 SKU가 인벤토리 검사 작업의 대상 항목으로 간주됩니다.
isRestricted Bool 이 항목에 제한된 인벤토리가 있는지 여부를 나타냅니다.
제한 사항 InventoryRestriction의 배열 이 항목에 대해 발견된 제한 사항에 대한 세부 정보입니다. isRestricted = "true"인 경우에만 이 속성이 채워집니다.

InventoryRestriction

인벤토리 제한의 세부 정보를 나타냅니다. 이러한 세부 정보는 입력 요청이 아니라 인벤토리 검사 출력 결과에만 적용됩니다.

속성 Type 설명
reasonCode 문자열 제한 이유를 식별하는 코드입니다.
description 문자열 인벤토리 제한에 대한 설명입니다.
속성 키/값 쌍 제한에 대한 자세한 정보를 제공할 수 있는 속성의 사전입니다.

BillingCycleType

청구 주기 형식을 나타내는 값이 있는 [Enum/dotnet/api/system.enum)입니다.

Position 설명
알 수 없음 0 열거형 이니셜라이저입니다.
매월 1 파트너가 매월 청구됨을 나타냅니다.
매년 2 파트너가 매년 청구됨을 나타냅니다.
None 3 파트너가 청구되지 않음을 나타냅니다. 이 값은 평가판 항목에 사용할 수 있습니다.
OneTime 4 파트너가 한 번 청구됨을 나타냅니다.
3년 주기 5 파트너가 3년마다 청구됨을 나타냅니다.

AttestationProperties

증명 유형과 구매에 필요한 경우를 나타냅니다.

속성 Type 설명
attestationType 문자열 증명 유형을 나타냅니다. Windows 365 제품의 값은 Windows 365입니다. Windows 365 증명 텍스트는 "Windows 하이브리드 혜택 Windows 365 Business를 사용하는 각 사용자도 기본 작업 장치에 Windows 10/11 Pro의 유효한 복사본을 설치해야 한다는 것을 알고 있습니다."
enforceAttestation Boolean 증명이 구매에 필요한지 여부를 나타냅니다.