製品リソース

2025-06-06

購入可能な商品またはサービスを表すリソース。製品の種類と形状 (SKU) を記述し、在庫内の製品の可用性を確認するためのリソースが含まれています。

プロダクト

購入可能な商品またはサービスを表します。製品自体は購入可能なアイテムではありません。

プロパティ	タイプ	説明
識別子	糸	製品の ID。
タイトル	糸	製品のタイトル。
説明	糸	製品の説明。
製品タイプ	アイテムタイプ	この製品の型分類を記述するオブジェクト。
isMicrosoftProduct	ブール	製品が Microsoft 製品かどうかを示します。
出版社名	糸	製品の発行元の名前 (使用可能な場合)。
リンク	ProductLinks	製品に含まれるリソースリンク。

アイテムの種類

製品の種類を表します。

プロパティ	タイプ	説明
識別子	糸	型識別子。
ディスプレイ名	糸	項目の種類の表示名。
SubType	アイテムタイプ	任意。項目の種類のサブタイプの分類を記述するオブジェクト。

製品リンク

製品のリンクの一覧が含まれています。

プロパティ	タイプ	説明
SKU (エスケーユー)	リンク	基になる SKU にアクセスするためのリンク。
リンク	リソースリンク	リソース内に含まれるリソースリンク。

SKU

製品の購入可能な在庫保管単位 (SKU) を表します。

プロパティ	タイプ	説明
識別子	糸	SKU の ID。 ID は、親製品のコンテキスト内でのみ一意です。
タイトル	糸	SKU のタイトル。
説明	糸	SKU の説明。
製品ID	糸	SKU を含む親製品の ID。
最小数量	整数	購入可能な最小数量。
最大数量	整数	購入可能な最大数量。
isTrial	ブール	SKU が試用版アイテムかどうかを示します。
対応課金サイクル	文字列の配列	SKU でサポートされている課金サイクルの一覧。サポートされている値は、 BillingCycleType にあるメンバー名です。
購入前提条件	文字列の配列	品目を購入する前に必要な前提条件ステップまたはアクションの一覧。サポートされる値は "InventoryCheck" - アイテムを購入する前に、品目の在庫を評価する必要があることを示します。 "AzureSubscriptionRegistration" - Azure サブスクリプションが必要であり、アイテムの購入を試みる前に登録する必要があることを示します。
在庫変数	文字列の配列	品目に対して在庫チェックを実行するために必要な変数の一覧。サポートされる値は "CustomerId" - 購入対象となる顧客の ID。 "AzureSubscriptionId" - Azure 予約購入に使用される Azure サブスクリプションの ID。 "ArmRegionName" - インベントリを検証するリージョン。この値は、SKU の DynamicAttributes の "ArmRegionName" と一致する必要があります。
プロビジョニング変数	文字列の配列	アイテムを購入するときにカートの品目のプロビジョニングコンテキストに指定する必要がある変数の一覧。サポートされる値はスコープ - Azure 予約購入のスコープ: 「シングル」、「共有」。 "SubscriptionId" - Azure 予約購入に使用される Azure サブスクリプションの ID。 "Duration" - Azure 予約の期間: "1Year"、"3Year"。
dynamicAttributes	キーと値のペア	項目に適用される動的プロパティのディクショナリ。ディクショナリ内のプロパティは動的であり、予告なしに変更される可能性があります。パートナーは、プロパティの値に存在する特定のキーに強い依存関係を作成しないようにする必要があります。
リンク	リソースリンク	SKU に含まれるリソースリンク。
アテステーションプロパティーズ	AttestationProperties	SKU の認証プロパティ。
消費タイプ	糸	SKU が超過分などの消費をサポートしている場合にのみ使用できます。
専門化された提供プロパティ	specializedOfferProperties の一覧	製品が SpecializedOffer の subType である場合にのみ使用できます。
最低購入義務	最低購入義務	コンピューティングサービスでコミットされた固定金額。

動的 SKU 属性

新しいコマースライセンスベースの製品とサービスに関連する注目すべきプロパティ。

注

ライセンスベースのサービスの新しいコマースエクスペリエンスには、多くの新機能が含まれており、すべてのクラウドソリューションプロバイダー (CSP) で利用できます。詳細については、新しいコマースエクスペリエンスの概要を参照してください。

プロパティ	タイプ	説明
制約がある	ボーリアン	SKU に assetContraints が含まれているかどうかを説明します
isAddon	ボーリアン	SKU がアドオンであるかどうかを説明します
前提条件SKU	文字列の配列	アドオンが使用できる製品と SKU について説明します
upgradeTargetOffers	文字列の配列	項目をアップグレードできる製品と SKU の一覧
変換指示	変換指示の一覧	変換操作に適用できる手順の一覧

専門化された提供プロパティ

注

製品サブタイプ "SpecializedOffers" にのみ適用されます

プロパティ	タイプ	説明
開始日	糸	指示が適用される ID の用語
終了日	糸	更新を定義するオプション
価格ポリシー	pricingPolicies の一覧	プロモーション割引の種類と値を定義するポリシーの一覧。

最低購入義務

コンピューティングサービスでコミットできる最小量の属性。

プロパティ	タイプ	説明
穀物	糸	最小購入コミットメントの期間。
通貨コード	Dictionary<String、String>	コミットできる最小金額の「通貨」と「記号」です。
金額	整数	コンピューティングサービスでコミットできる最小量。

価格方針

プロモーション割引の種類と値について説明します。

プロパティ	タイプ	説明
種類	糸	割引がパーセンテージに基づいているか、定額割引に基づいているかを説明します。
価値	糸	適用される割引の金額を定義します。

可用性

SKU を購入できる構成 (国/地域、通貨、業界セグメントなど) を表します。

プロパティ	タイプ	説明
識別子	糸	この可用性の ID。この ID は、親製品と SKU のコンテキスト内でのみ一意です。手記可用性 ID は、時間の経過と同時に変化する可能性があります。パートナーは、取得後の短い期間内にのみこの値に依存する必要があります。
製品ID	糸	この可用性を含む製品の ID。
スクイド	糸	この可用性を含む SKU の ID。
カタログアイテムID	糸	カタログ内のこの項目の一意の識別子。この ID は、親 SKU を購入するときに OrderLineItem.OfferId プロパティまたは CartLineItem.CatalogItemId プロパティに入力する必要があります。手記この ID は、時間の経過と同時に変更される可能性があります。この値は、取得後短時間でのみ使用する必要があります。購入時にのみアクセスして使用する必要があります。
デフォルト通貨	糸	この可用性でサポートされている既定の通貨。
セグメント	糸	この利用可能性のための業界セグメント。サポートされる値は、商用、教育、政府機関、非営利です。
国	糸	この可用性が適用される国または地域 (ISO の国コード形式)。
購入可能	ブール	この可用性が購入可能かどうかを示します。
再生可能か	ブール	この可用性が更新可能かどうかを示します。
更新手順	RenewalInstruction	特定の可用性の更新手順を表します。
製品	製品	対応する製品の可用性。
エスケーユー	SKU	この可用性が対応する SKU。
条件	用語リソースの配列	この可用性に適用される用語のコレクション。
リンク	リソースリンク	可用性に含まれるリソースリンク。

更新の指示

注

特定の可用性の更新手順を表します。

プロパティ	タイプ	説明
適用可能な項目ID	文字列の配列	指示が適用される ID の用語
更新オプション	RenewalOption の配列	更新を定義するオプション

更新オプション

注

特定の可用性の更新手順を表します。

プロパティ	タイプ	説明
renewToId	糸	更新する製品と SKU を表します。
自動更新可能である	ブール	可用性を自動更新できるかどうか

任期

可用性を購入できる用語を表します。

プロパティ	タイプ	説明
期間	糸	用語の期間を ISO 8601 で表したもの。現在サポートされている値は、P1M (1 か月)、P1Y (1 年)、P3Y (3 年) です。
説明	糸	用語の説明。
termLifeCycleState	糸	ライフサイクルの説明。サポートされるこれらの値には、GA (一般提供、EndOfSale、EndofSaleWithConversions) が含まれます。このプロパティは、id API による可用性の取得を呼び出すときに includeLifeCycleState が true に設定されている場合にのみ返されます。

インベントリチェックリクエスト

特定のカタログアイテムに対してインベントリをチェックする要求を表します。

プロパティ	タイプ	説明
ターゲットアイテム	InventoryItem の配列	在庫チェックで評価されるカタログアイテムの一覧。
在庫コンテキスト	キーと値のペア	在庫チェックを実行するために必要なコンテキスト値のディクショナリ。製品の各 SKU によって、この操作を実行するために必要な値 (ある場合) が決まります。
リンク	リソースリンク	在庫チェック要求に含まれるリソースリンク。

インベントリアイテム

在庫チェック操作の 1 つの項目を表します。このリソースは、入力要求でターゲット項目を指定するために使用され、在庫チェック操作の出力結果を表すためにも使用されます。

プロパティ	タイプ	説明
製品ID	糸	(必須) 製品の ID。
スクイド	糸	SKU の ID。この値は省略可能です。この値が指定されていない場合、製品のすべての SKU が在庫チェック操作のターゲット項目と見なされます。
制限されている	ブール	このアイテムに制限付きインベントリが見つかったかどうかを示します。
制限	InventoryRestriction の配列	この項目に対して検出された制限の詳細。このプロパティは、 isRestricted = "true" の場合にのみ設定されます。

インベントリの制限

インベントリ制限の詳細を表します。これらの詳細は、入力要求ではなく、在庫チェックの出力結果にのみ適用されます。

プロパティ	タイプ	説明
reasonCodeの	糸	制限の理由を識別するコード。
説明	糸	インベントリ制限の説明。
プロパティ	キーと値のペア	制限の詳細を提供できるプロパティのディクショナリ。

請求サイクルタイプ

課金サイクルの種類を示す値を持つ [Enum/dotnet/api/system.enum)。

価値	職位	説明
未知	0	列挙型初期化子。
月間	1	パートナーが毎月課金されることを示します。
年間	2	パートナーが毎年課金されることを示します。
無し	3	パートナーが課金されていないことを示します。この値は、試用版アイテムに使用できます。
ワンタイム	4	パートナーに 1 回課金されることを示します。
トリエンナーレ	5	パートナーは3年ごとに請求されることを示します。

アテステーションプロパティーズ

証明の種類と、それが購入に必要かどうかを表します。

プロパティ	タイプ	説明
認証タイプ	糸	認証の種類を示します。 Windows 365 製品には Windows 365 の価値があります。 Windows 365 構成証明テキストは、「Windows 365 Business と Windows ハイブリッド特典を使用する各ユーザーは、プライマリワークデバイスに Windows 10/11 Pro の有効なコピーをインストールする必要があることを理解しています」です。
アテステーションを強制する	ボーリアン	購入に証明書が必要かどうかを示します。