제품 리소스
구매할 수 있는 상품 또는 서비스를 나타내는 리소스입니다. 제품 유형 및 셰이프(SKU)를 설명하고 인벤토리에서 제품의 가용성을 확인하기 위한 리소스를 포함합니다.
Product
구매 가능한 양수 또는 서비스를 나타냅니다. 제품 자체는 구매할 수 있는 항목이 아닙니다.
| 속성 | Type | 설명 |
|---|---|---|
| id | 문자열 | 제품의 ID입니다. |
| title | 문자열 | 제품 제목입니다. |
| description | 문자열 | 제품 설명입니다. |
| productType | ItemType | 이 제품의 형식 분류를 설명하는 개체입니다. |
| isMicrosoftProduct | Bool | 제품이 Microsoft 제품인지를 나타냅니다. |
| publisherName | 문자열 | 사용 가능한 경우 제품 게시자의 이름입니다. |
| 링크 | ProductLinks | 제품 내에 포함된 리소스 링크입니다. |
ItemType
제품의 유형을 나타냅니다.
| 속성 | Type | 설명 |
|---|---|---|
| id | 문자열 | 형식 식별자입니다. |
| displayName | 문자열 | 항목 형식의 표시 이름입니다. |
| subType | ItemType | 선택 사항. 항목 형식에 대한 하위 형식 분류를 설명하는 개체입니다. |
ProductLinks
제품에 대한 링크 목록을 포함합니다.
| 속성 | 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 | 문자열 | SKU의 ID입니다. 인벤토리 요청에 대한 입력으로 이 리소스를 사용하는 경우 이 값은 선택 사항입니다. 이 값이 제공되지 않으면 제품의 모든 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 | 증명이 구매에 필요한지 여부를 나타냅니다. |