製品リソース
購入可能な商品またはサービスを表すリソース。 製品の種類と形状 (SKU) を記述し、在庫内の製品の可用性を確認するためのリソースが含まれています。
Product
購入可能な商品またはサービスを表します。 製品自体は購入可能なアイテムではありません。
| プロパティ | タイプ | 説明 |
|---|---|---|
| id | String | 製品の ID。 |
| タイトル | String | 製品のタイトル。 |
| description | String | 製品の説明です。 |
| productType | アイテムの種類 | この製品の型分類を記述するオブジェクト。 |
| isMicrosoftProduct | Bool | 製品が Microsoft 製品かどうかを示します。 |
| publisherName | String | 製品の発行元の名前 (使用可能な場合)。 |
| リンク | ProductLinks | 製品に含まれるリソース リンク。 |
アイテムの種類
製品の種類を表します。
| プロパティ | タイプ | 説明 |
|---|---|---|
| id | String | 型識別子。 |
| displayName | String | 項目の種類の表示名。 |
| SubType | アイテムの種類 | 省略可能。 項目の種類のサブタイプの分類を記述するオブジェクト。 |
ProductLinks
Product のリンクの一覧が含まれています。
| プロパティ | タイプ | 説明 |
|---|---|---|
| skus | リンク | 基になる SKU にアクセスするためのリンク。 |
| リンク | ResourceLinks | リソース内に含まれるリソース リンク。 |
Sku
製品の購入可能な在庫保管単位 (SKU) を表します。
| プロパティ | タイプ | 説明 |
|---|---|---|
| id | String | SKU の ID。 ID は、親製品のコンテキスト内でのみ一意です。 |
| タイトル | String | SKU のタイトル。 |
| description | String | SKU の説明。 |
| productId | String | SKU を含む親 Product の ID。 |
| minimumQuantity | int | 購入可能な最小数量。 |
| maximumQuantity | int | 購入可能な最大数量。 |
| 試用版です | Bool | SKU が試用版アイテムかどうかを示します。 |
| supportedBillingCycles | 文字列の配列 | SKU でサポートされている支払いサイクルの一覧。 サポートされる値は、BillingCycleType で検出されたメンバー名です。 |
| purchasePrerequisites | 文字列の配列 | 品目を購入する前に必要な前提条件ステップまたはアクションの一覧。 サポートされる値は次のとおりです。 "InventoryCheck" - アイテムを購入する前に、品目の在庫を評価する必要があることを示します。 "AzureSubscriptionRegistration" - Azure サブスクリプションが必要であり、アイテムの購入を試みる前に登録する必要があることを示します。 |
| inventoryVariables | 文字列の配列 | 品目に対して在庫チェックを実行するために必要な変数の一覧。 サポートされる値は次のとおりです。 "CustomerId" - 購入対象となる顧客の ID。 "AzureSubscriptionId" - Azure 予約購入に使用される Azure サブスクリプションの ID。 "ArmRegionName" - インベントリを検証するリージョン。 この値は、SKU の DynamicAttributes の "ArmRegionName" と一致する必要があります。 |
| provisioningVariables | 文字列の配列 | アイテムを購入するときにcart 品目のプロビジョニング コンテキストに指定する必要がある変数の一覧。 サポートされる値は次のとおりです。 スコープ - Azure 予約購入のスコープ: "Single"、"Shared"。 "SubscriptionId" - Azure 予約購入に使用される Azure サブスクリプションの ID。 "Duration" - Azure 予約の期間: "1Year"、"3Year"。 |
| dynamicAttributes | キーと値のペア | 項目に適用される動的プロパティのディクショナリ。 ディクショナリ内のプロパティは動的であり、予告なしに変更される可能性があります。 パートナーは、プロパティの値に存在する特定のキーに強い依存関係を作成しないようにする必要があります。 |
| リンク | ResourceLinks | SKU に含まれるリソース リンク。 |
| AttestationProperties | AttestationProperties | SKU の構成証明プロパティ。 |
| consumptionType | String | sku が overage などの消費をサポートしている場合にのみ使用できます。 |
| specializedOfferProperties | specializedOfferProperties の一覧 | 製品が SpecializedOffer の subType である場合にのみ使用できます。 |
| minimumPurchaseCommitment | MinimumPurchaseCommitment | コンピューティング サービスでコミットされた固定金額。 |
動的 SKU 属性
新しいコマース ライセンス ベースの製品とサービスに関連する注目すべきプロパティ。
Note
ライセンスベースのサービスの新しいコマース エクスペリエンスには、多くの新機能が含まれており、すべてのクラウド ソリューション プロバイダー (CSP) で利用できます。 詳細については、新しいコマース エクスペリエンスの概要を参照してください。
| プロパティ | タイプ | 説明 |
|---|---|---|
| hasConstraints | Boolean | SKU に assetContraints が含まれているかどうかを説明します |
| isAddon | Boolean | SKU がアドオンであるかどうかを説明します |
| prerequisiteSkus | 文字列の配列 | アドオンが使用できる製品と SKU について説明します |
| upgradeTargetOffers | 文字列の配列 | 項目をアップグレードできる製品と SKU の一覧 |
| conversionInstructions | conversionInstructions の一覧 | 変換操作に適用できる手順の一覧 |
specializedOfferProperties
Note
ライセンスベースのサービスの新しいコマース エクスペリエンスには、多くの新機能が含まれており、すべてのクラウド ソリューション プロバイダー (CSP) で利用できます。 詳細については、新しいコマース エクスペリエンスの概要を参照してください。
製品サブタイプ "SpecializedOffers" にのみ適用されます
| プロパティ | タイプ | 説明 |
|---|---|---|
| startDate | String | 指示が適用される用語 ID |
| endDate | String | 更新を定義するオプション |
| pricingPolicies | pricingPolicies の一覧 | プロモーション割引の種類と値を定義するポリシーの一覧。 |
MinimumPurchaseCommitment
コンピューティング サービスでコミットできる最小量の属性。
| プロパティ | タイプ | 説明 |
|---|---|---|
| 穀物 | String | 最小購入コミットメントの期間。 |
| currencyCode | Dictionary<String、String> | コミットできる最小金額の "currency" と "symbol" です。 |
| 金額 | int | コンピューティング サービスでコミットできる最小量。 |
PricingPolicies
プロモーション割引の種類と値について説明します。
| プロパティ | タイプ | 説明 |
|---|---|---|
| type | String | 割引がパーセンテージに基づいているか、定額割引に基づいているかを説明します。 |
| 値 | String | 適用される割引の金額を定義します。 |
可用性
SKU を購入できる構成 (国/地域、通貨、業界セグメントなど) を表します。
| プロパティ | タイプ | 説明 |
|---|---|---|
| id | String | この可用性の ID。 この ID は、親 product および SKU のコンテキスト内でのみ一意です。 注 可用性 ID は時間の経過と同時に変化する可能性があります。 パートナーは、取得後の短い期間内にのみこの値に依存する必要があります。 |
| productId | String | この可用性を含む product の ID。 |
| skuId | String | この可用性を含む SKU の ID。 |
| catalogItemId | String | カタログ内のこのアイテムの一意識別子。 この ID は、親 SKU を購入するときに、OrderLineItem.OfferId または CartLineItem.CatalogItemId プロパティに入力する必要があります。 注 この ID は時間の経過と同時に変更される可能性があります。 この値は、取得後短時間でのみ使用する必要があります。 購入時にのみアクセスして使用する必要があります。 |
| defaultCurrency | String | この可用性でサポートされている既定の通貨。 |
| セグメント | String | この可用性の業界セグメント。 サポートされる値は、商用、教育、政府機関、非Profit です。 |
| country | String | この可用性が適用される国または地域 (ISO の国コード形式)。 |
| isPurchasable | Bool | この可用性が購入可能かどうかを示します。 |
| isRenewable | Bool | この可用性が更新可能かどうかを示します。 |
| RenewalInstructions | RenewalInstruction | 特定の可用性の更新手順を表します。 |
| product | 製品 | この可用性が対応する製品。 |
| sku | SKU | この可用性が対応する SKU。 |
| terms | Term リソースの配列 | この可用性に適用される用語のコレクション。 |
| リンク | ResourceLinks | 可用性に含まれるリソース リンク。 |
更新の指示
Note
ライセンスベースのサービスの新しいコマース エクスペリエンスには、多くの新機能が含まれており、すべてのクラウド ソリューション プロバイダー (CSP) で利用できます。 詳細については、新しいコマース エクスペリエンスの概要を参照してください。
特定の可用性の更新手順を表します。
| プロパティ | タイプ | 説明 |
|---|---|---|
| applicableTermIds | 文字列の配列 | 指示が適用される用語 ID |
| RenewalOptions | RenewalOption の配列 | 更新を定義するオプション |
RenewalOption
Note
ライセンスベースのサービスの新しいコマース エクスペリエンスには、多くの新機能が含まれており、すべてのクラウド ソリューション プロバイダー (CSP) で利用できます。 詳細については、新しいコマース エクスペリエンスの概要を参照してください。
特定の可用性の更新手順を表します。
| プロパティ | タイプ | 説明 |
|---|---|---|
| renewToId | String | 更新する製品と SKU を表します。 |
| isAutoRenewable | Bool | 可用性を自動更新できるかどうか |
Term
可用性を購入できる用語を表します。
| プロパティ | タイプ | 説明 |
|---|---|---|
| duration | String | 期間の ISO 8601 表現。 現在サポートされている値は、P1M (1 か月)、P1Y (1 年)、P3Y (3 年) です。 |
| description | String | 用語の説明。 |
InventoryCheckRequest
特定のカタログ アイテムに対してインベントリをチェックする要求を表します。
| プロパティ | タイプ | 説明 |
|---|---|---|
| targetItems | InventoryItem の配列 | 在庫チェックで評価されるカタログ アイテムの一覧。 |
| inventoryContext | キーと値のペア。 | 在庫チェックを実行するために必要なコンテキスト値のディクショナリ。 製品の各 SKU は、この操作を実行するために必要な値 (ある場合) を定義します。 |
| リンク | ResourceLinks | 在庫チェック要求に含まれるリソース リンク。 |
InventoryItem
在庫チェック操作の 1 つの項目を表します。 このリソースは、入力要求でターゲット項目を指定するために使用され、在庫チェック操作の出力結果を表すためにも使用されます。
| プロパティ | タイプ | 説明 |
|---|---|---|
| productId | String | (必須) productの ID。 |
| skuId | String | SKUの ID。 このリソースをインベントリ要求への入力として使用する場合、この値は省略可能です。 この値が指定されていない場合、製品のすべての SKU が在庫チェック操作の対象アイテムと見なされます。 |
| isRestricted | Bool | このアイテムに制限付きインベントリが見つかったかどうかを示します。 |
| 制限 | InventoryRestriction の配列 | この項目に対して検出された制限の詳細。 このプロパティは、 isRestricted = "true" の場合にのみ設定されます。 |
InventoryRestriction
インベントリ制限の詳細を表します。 これらの詳細は、入力要求ではなく、在庫チェックの出力結果にのみ適用されます。
| プロパティ | タイプ | 説明 |
|---|---|---|
| reasonCode | String | 制限の理由を識別するコード。 |
| description | String | インベントリ制限の説明。 |
| properties | キーと値のペア。 | 制限の詳細を提供できるプロパティのディクショナリ。 |
BillingCycleType
支払いサイクルの型を示す値を持つ [Enum/dotnet/api/system.enum)。
| Value | 配置 | 説明 |
|---|---|---|
| Unknown | 0 | 列挙型初期化子。 |
| 月ごと | 1 | パートナーが毎月課金されることを示します。 |
| 年単位 | 2 | パートナーが毎年課金されることを示します。 |
| なし | 3 | パートナーが課金されないことを示します。 この値は、試用版アイテムに使用できます。 |
| OneTime | 4 | パートナーに 1 回課金されることを示します。 |
| トリエンナーレ | 5 | パートナーが 3 年ごとに課金されることを示します。 |
AttestationProperties
構成証明の種類と、購入に必要な場合を表します。
| プロパティ | タイプ | 説明 |
|---|---|---|
| attestationType | String | 構成証明の種類を示します。 Windows 365 製品の値は Windows 365 になります。 Windows 365 構成証明のテキストは、「Windows ハイブリッド特典で Windows 365 Business を使用する各ユーザーも、プライマリ ワーク デバイスに Windows 10/11 Pro の有効なコピーをインストールする必要があることを理解しています」です。 |
| enforceAttestation | Boolean | 購入に構成証明が必要かどうかを示します。 |