Microsoft.Billing (stable:2025-05-01)

2026/01/05 • 4 updated methods

ProductGet_GetByBillingProfile (updated)
Description :  Gets a single product by billing profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProductGet_GetByBillingProfile",
  "$responses": {
    "200": {
      "$properties": {
        "plans": {
          "$properties": {
            "availabilities": {
              "$properties": {
                "terms": {
                  "$properties": {
                    "@added_767a1b3fca594493add7367bb0dd69ca": {
                      "#name": "lifecyclePolicy",
                      "Description": "Defines the lifecycle management policy for the term",
                      "Required": false,
                      "Type": "object",
                      "$properties": [
                        {
                          "#name": "graceDuration",
                          "Description": "Grace period duration where customers retain access to their product. Examples: 'P1M' (1 month), 'P30D' (30 days), 'P0D' (0 days)",
                          "Required": false,
                          "Type": "string"
                        },
                        {
                          "#name": "inactiveDuration",
                          "Description": "Inactive period duration",
                          "Required": false,
                          "Type": "string"
                        },
                        {
                          "#name": "lockoutDuration",
                          "Description": "Lockout period duration",
                          "Required": false,
                          "Type": "string"
                        }
                      ]
                    },
                    "@added_388c2da5cd7648c4bb994a45cbd12d20": {
                      "#name": "productCode",
                      "Description": "Product code for this term",
                      "Required": false,
                      "Type": "string"
                    },
                    "@added_bcfce1bbd882451992b60185a056faba": {
                      "#name": "state",
                      "Description": "Term state",
                      "Required": false,
                      "Type": "string"
                    },
                    "@added_1877b49d1a604b9ea55d2cc36486381a": {
                      "#name": "actions",
                      "Description": "Term Actions",
                      "Required": false,
                      "Type": "array",
                      "$items": {
                        "Type": "string"
                      }
                    }
                  }
                }
              }
            },
            "@added_a6a59a158a504d869c02b17e7b9f6fc7": {
              "#name": "hasConsumptionComponents",
              "Description": "Indicates if this SKU has consumption components",
              "Required": false,
              "Type": "boolean"
            },
            "@added_ec1eb56850134b1c9b23f56d6a4cf5fc": {
              "#name": "isEndUserEligible",
              "Description": "Indicates if this SKU is available for end users",
              "Required": false,
              "Type": "boolean"
            },
            "@added_ccc2bee3f6164f109568e44e8bf7ed7b": {
              "#name": "isAdminEligible",
              "Description": "Indicates if this SKU is available for admins",
              "Required": false,
              "Type": "boolean"
            },
            "@added_162a230d261b4c719385abb1906afb2a": {
              "#name": "entraIdVersion",
              "Description": "The entra id version for products that come with entra id support",
              "Required": false,
              "Type": "string"
            },
            "@added_f1c24f5a2ca54450ac46b27bee705401": {
              "#name": "technicalRequirements",
              "Description": "Technical Requirements",
              "Required": false,
              "Type": "string"
            },
            "@added_714406fc589d42b092ad82488aa20517": {
              "#name": "faqUri",
              "Description": "The URI to the FAQ page",
              "Required": false,
              "Type": "string"
            },
            "@added_a601a186289547db997a4b193d9af5f8": {
              "#name": "fulfillmentData",
              "Description": "Fulfillment instructions for this SKU",
              "Required": false,
              "Type": "object",
              "$properties": [
                {
                  "#name": "fulfillmentType",
                  "Description": "Differentiates between fulfillment types",
                  "Required": false,
                  "Type": "string"
                },
                {
                  "#name": "attributes",
                  "Description": "Fulfillment attributes",
                  "Required": false,
                  "Type": "object",
                  "$properties": [
                    {
                      "#name": "fulfillmentTiming",
                      "Description": "Timing configuration for product fulfillment",
                      "Required": false,
                      "Type": "string"
                    },
                    {
                      "#name": "fulfillmentDelayMitigation",
                      "Description": "Mitigation explanation for delayed fulfillment",
                      "Required": false,
                      "Type": "string"
                    }
                  ]
                },
                {
                  "#name": "additionalProducts",
                  "Description": "Bundled products included defining additional product/SKU combinations",
                  "Required": false,
                  "Type": "array",
                  "$items": {
                    "Description": "Configuration for additional products bundled with early access pass SKUs",
                    "Type": "object",
                    "$properties": [
                      {
                        "#name": "productSkuId",
                        "Description": "Product and SKU ID for bundled products included with the license",
                        "Required": false,
                        "Type": "string"
                      },
                      {
                        "#name": "defaultKeyActivationCount",
                        "Description": "Quantity of the bundled product per license ",
                        "Format": "int32",
                        "Required": false,
                        "Type": "integer"
                      }
                    ]
                  }
                }
              ]
            },
            "@added_baecd5f3774a4015a8f0345cac8c6570": {
              "#name": "benefits",
              "Description": "Provides promotion data",
              "Required": false,
              "Type": "array",
              "$items": {
                "Description": "Benefit information for a plan",
                "Type": "object",
                "$properties": [
                  {
                    "#name": "benefitType",
                    "Description": "Benefit type",
                    "Required": false,
                    "Type": "string"
                  },
                  {
                    "#name": "basePlanId",
                    "Description": "Base plan ID",
                    "Required": false,
                    "Type": "string"
                  },
                  {
                    "#name": "billingPlan",
                    "Description": "Billing plan",
                    "Required": false,
                    "Type": "string"
                  },
                  {
                    "#name": "termDuration",
                    "Description": "Term duration. Examples: 'P1M' (1 month), 'P30D' (30 days)",
                    "Required": false,
                    "Type": "string"
                  }
                ]
              }
            },
            "@added_67da7e8c0981401fb3e9eff64f90ca96": {
              "#name": "constraintsData",
              "Description": "Contains constraint product properties to determine eligibility",
              "Required": false,
              "Type": "object",
              "$properties": [
                {
                  "#name": "seatConstraints",
                  "Description": "Seat constraint configurations defining minimum and maximum seat limits",
                  "Required": false,
                  "Type": "array",
                  "$items": {
                    "Description": "Defines minimum and maximum seat limits for a specific constraint type",
                    "Type": "object",
                    "$properties": [
                      {
                        "#name": "type",
                        "Description": "Constraint type",
                        "Required": false,
                        "Type": "string"
                      },
                      {
                        "#name": "minSeats",
                        "Description": "Minimum seats",
                        "Format": "int32",
                        "Required": false,
                        "Type": "integer"
                      },
                      {
                        "#name": "maxSeats",
                        "Description": "Maximum seats",
                        "Format": "int32",
                        "Required": false,
                        "Type": "integer"
                      }
                    ]
                  }
                },
                {
                  "#name": "assetOwnershipLimits",
                  "Description": "Asset ownership limits",
                  "Required": false,
                  "Type": "array",
                  "$items": {
                    "Description": "Defines ownership restrictions and limits for SKU assets",
                    "Type": "object",
                    "$properties": [
                      {
                        "#name": "type",
                        "Description": "Limit type",
                        "Required": false,
                        "Type": "string"
                      },
                      {
                        "#name": "minAssets",
                        "Description": "Minimum number of assets",
                        "Format": "int32",
                        "Required": false,
                        "Type": "integer"
                      },
                      {
                        "#name": "maxAssets",
                        "Description": "Maximum number of assets",
                        "Format": "int32",
                        "Required": false,
                        "Type": "integer"
                      }
                    ]
                  }
                },
                {
                  "#name": "prerequisiteSkus",
                  "Description": "Lists eligible prerequisite SKUs",
                  "Required": false,
                  "Type": "object",
                  "$properties": [
                    {
                      "#name": "mustHaveAll",
                      "Description": "Prerequisite sets where all specified SKUs must be owned",
                      "Required": false,
                      "Type": "array",
                      "$items": {
                        "Description": "Prerequisite set",
                        "Type": "object",
                        "$properties": [
                          {
                            "#name": "productId",
                            "Description": "Product ID",
                            "Required": false,
                            "Type": "string"
                          },
                          {
                            "#name": "skuIds",
                            "Description": "SKU IDs",
                            "Required": false,
                            "Type": "array",
                            "$items": {
                              "Type": "string"
                            }
                          }
                        ]
                      }
                    },
                    {
                      "#name": "mustHaveAny",
                      "Description": "Prerequisite sets where any one of the specified SKUs must be owned",
                      "Required": false,
                      "Type": "array",
                      "$items": {
                        "Description": "Prerequisite set",
                        "Type": "object",
                        "$properties": [
                          {
                            "#name": "productId",
                            "Description": "Product ID",
                            "Required": false,
                            "Type": "string"
                          },
                          {
                            "#name": "skuIds",
                            "Description": "SKU IDs",
                            "Required": false,
                            "Type": "array",
                            "$items": {
                              "Type": "string"
                            }
                          }
                        ]
                      }
                    },
                    {
                      "#name": "seatConstraints",
                      "Description": "Percentage-based seat constraints for prerequisite SKUs",
                      "Required": false,
                      "Type": "array",
                      "$items": {
                        "Description": "Minimum and maximum percentage seats constraint",
                        "Type": "object",
                        "$properties": [
                          {
                            "#name": "type",
                            "Description": "Constraint type",
                            "Required": false,
                            "Type": "string"
                          },
                          {
                            "#name": "minPercentSeats",
                            "Description": "Minimum percent seats",
                            "Format": "double",
                            "Required": false,
                            "Type": "number"
                          },
                          {
                            "#name": "maxPercentSeats",
                            "Description": "Maximum percent seats",
                            "Format": "double",
                            "Required": false,
                            "Type": "number"
                          }
                        ]
                      }
                    }
                  ]
                }
              ]
            },
            "@added_c1de8a93dfe54b3cb5c1fa1ab3d1a921": {
              "#name": "meterTypeDescriptions",
              "Description": "Meter type descriptions",
              "Required": false,
              "Type": "array",
              "$items": {
                "Description": "Meter type description",
                "Type": "object",
                "$properties": [
                  {
                    "#name": "key",
                    "Description": "Meter Type Description key",
                    "Required": false,
                    "Type": "string"
                  },
                  {
                    "#name": "value",
                    "Description": "Meter type description value",
                    "Required": false,
                    "Type": "object",
                    "$properties": [
                      {
                        "#name": "meterType",
                        "Description": "The type of meter",
                        "Required": false,
                        "Type": "string"
                      },
                      {
                        "#name": "unitOfMeasure",
                        "Description": "The unit of measurement for the meter",
                        "Required": false,
                        "Type": "string"
                      }
                    ]
                  }
                ]
              }
            },
            "@added_f26ed703c91e4fddb93a0d52393b83c8": {
              "#name": "usageUnit",
              "Description": "Usage unit",
              "Required": false,
              "Type": "string"
            },
            "@added_df898b4ca0d74dcd93d7ad7eb9f73806": {
              "#name": "skuName",
              "Description": "Sku name",
              "Required": false,
              "Type": "string"
            }
          }
        },
        "@added_ba0ed654629a4594b78a0dea4d3e3ecf": {
          "#name": "hasAddOns",
          "Description": "Indicates that the SKU has add-ons",
          "Required": false,
          "Type": "boolean"
        }
      }
    }
  }
}

⚼ Request

GET:  /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.Marketplace/products/{productId}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
billingAccountId:
{
Description: The ID of the target billing account. ,
Required: True ,
}
string ,
billingProfileId:
{
Description: The ID of the target billing account. ,
Required: True ,
}
string ,
productId:
{
Description: The ID of the product ,
Required: True ,
}
string ,
includeStopSoldPlans:
{
Description: Indicates whether to include plans that are no longer available for purchase in the response. By default, includeStopSoldPlans is set to FALSE. ,
Required: False ,
}
boolean ,
language:
{
Description: Language to search, ISO 639-1 two-letter code, possible values - 'en,cs,de,es,fr,hu,it,ja,ko,nl,pl,pt-br,pt-pt,ru,sv,tr,id,zh-hans,zh-hant'. Default is "en" ,
Required: False ,
}
string ,
includeHiddenPlans:
{
Description: Indicates whether to include hidden plans in the response. By default, includeHiddenPlans is set to FALSE. ,
Required: False ,
}
boolean ,
includeServiceInstructionTemplates:
{
Description: Indicates whether to include the product's service instruction templates in the response. By default, includeServiceInstructionTemplates is set to FALSE. ,
Required: False ,
}
boolean ,
planId:
{
Description: Optional to pass the plan id to filter to a specific plan within the product. If not specified, the response will include all plans of the product. ,
Required: False ,
}
string ,
skuId:
{
Description: Optional to pass the sku id to filter to a specific sku within the product. If not specified, the response will include all skus of the product. ,
Required: False ,
}
string ,
}

⚐ Response (200)

{
displayName:
{
Description: Product display name ,
Required: False ,
}
string ,
popularity:
{
Description: Popularity of the product ,
Format: double ,
Required: False ,
}
number ,
categoryIds:
{
Description: Array of product categories ,
Required: False ,
}
[
string ,
]
,
industryIds:
{
Description: List of industry IDs the item belongs to ,
Required: False ,
}
[
string ,
]
,
publisherId:
{
Description: Publisher id ,
Required: False ,
}
string ,
azureBenefit:
{
Description: Indicates whether product purchases count toward Azure consumption commitment benefits for enterprise customers. - `Eligible` - Product costs apply to Azure consumption commitment benefit calculations and credits - `NotEligible` - Product costs do not qualify for Azure consumption commitment benefit programs ,
Required: False ,
}
string ,
badges:
{
Description: Displays certification and qualification badges earned by the product for marketplace visibility. - `PreferredSolution` - Microsoft-recognized solution meeting specific quality and partnership criteria - `PowerBICertified` - Certified compatibility and integration with Microsoft Power BI platform - `AdditionalPurchaseRequirement` - Product requires additional purchases or subscriptions for full functionality ,
Required: False ,
}
[
string ,
]
,
publisherType:
{
Description: Identifies the publisher relationship to Microsoft for support and partnership classification. - `Microsoft` - First-party Microsoft product with direct Microsoft support and development - `ThirdParty` - Independent software vendor product with publisher-provided support and maintenance ,
Required: False ,
}
string ,
publishingStage:
{
Description: Indicates the product availability status and customer access level within Azure Marketplace. - `Preview` - Limited availability to selected customers for testing and early access evaluation - `Public` - General availability to all Azure Marketplace customers for production deployment ,
Required: False ,
}
string ,
uniqueProductId:
{
Description: Unique product identifier ,
Required: True ,
}
string ,
productType:
{
Description: Specifies the primary deployment model and hosting architecture for the marketplace product stored in the Marketplace Catalog. - `None` - Unspecified product type, typically used for products without a defined deployment model - `ManagedApplication` - Azure Managed Applications that deploy and manage resources in customer subscriptions - `VirtualMachine` - Pre-configured virtual machine images deployable to Azure compute infrastructure - `AzureApplication` - Native Azure applications leveraging platform services and APIs - `Container` - Containerized applications deployed through Azure Container Instances or similar services - `SaaS` - Software as a Service solutions hosted and managed by the publisher - `SolutionTemplate` - Azure Resource Manager templates that provision multiple Azure resources - `IotEdgeModules` - Modules designed for deployment to Azure IoT Edge runtime environments - `ManagedServices` - Fully managed services where the publisher handles infrastructure and operations - `ContainerApps` - Applications built for Azure Container Apps serverless container platform - `DynamicsOps` - Microsoft Dynamics 365 Finance and Operations applications and extensions - `DynamicsCE` - Microsoft Dynamics 365 Customer Engagement applications and customizations - `DynamicsBC` - Microsoft Dynamics 365 Business Central applications and add-ons - `PowerBI` - Microsoft Power BI reports, dashboards, and data visualization components - `ConsultingServices` - Professional services offerings including implementation and advisory services - `CosellOnly` - Products available exclusively through Microsoft co-sell partner programs - `CoreVirtualMachine` - Core virtual machine offerings with baseline Azure compute capabilities - `PowerBIVisuals` - Custom visualizations for Microsoft Power BI reporting platform - `Office365` - Microsoft 365 and Office 365 applications, add-ins, and integrations - `AADApps` - Azure Active Directory integrated applications supporting organizational identity - `AzureServices` - Native Azure platform services and resource providers - `AppService` - Web applications hosted on Azure App Service platform - `LogAnalytics` - Azure Monitor Log Analytics solutions and workspace configurations - `MicrosoftProduct` - First-party Microsoft products available through marketplace channels ,
Required: True ,
}
string ,
productSubType:
{
Description: Product sub type ,
Required: False ,
}
string ,
productFamily:
{
Description: Product Family ,
Required: False ,
}
string ,
operatingSystems:
{
Description: Operating system info for this product ,
Required: False ,
}
[
string ,
]
,
pricingTypes:
{
Description: Indicates the billing models and cost structures available for the plan. - `Free` - No charge for plan usage, typically for community editions or basic service tiers - `FreeTrial` - Time-limited free access period before transitioning to paid billing model - `Byol` - Bring Your Own License model where customers provide existing software licenses - `Payg` - Pay As You Go consumption-based billing calculated on actual resource usage - `Ri` - Reserved Instance billing with upfront commitment for discounted long-term pricing ,
Required: False ,
}
[
string ,
]
,
publisherDisplayName:
{
Description: Publisher display name ,
Required: False ,
}
string ,
longSummary:
{
Description: Product long summary ,
Required: False ,
}
string ,
summary:
{
Description: Product summary ,
Required: False ,
}
string ,
smallIconUri:
{
Description: URI to the small product icon ,
Required: False ,
}
string ,
description:
{
Description: The product description text ,
Required: False ,
}
string ,
cspLegalTermsUri:
{
Description: The legal terms of the product for the CSP ,
Required: False ,
}
string ,
privacyPolicyUri:
{
Description: The privacy policy of the product ,
Required: False ,
}
string ,
ratingBuckets:
{
Description: Categorizes products by customer rating thresholds for marketplace filtering and discovery. - `AboveOne` - Products with customer ratings exceeding 1.0 stars based on marketplace reviews - `AboveTwo` - Products with customer ratings exceeding 2.0 stars based on marketplace reviews - `AboveThree` - Products with customer ratings exceeding 3.0 stars based on marketplace reviews - `AboveFour` - Products with customer ratings exceeding 4.0 stars based on marketplace reviews ,
Required: False ,
}
[
string ,
]
,
ratingAverage:
{
Description: Average rating for the offer ,
Format: double ,
Required: False ,
}
number ,
ratingCount:
{
Description: Total number of ratings for the offer ,
Format: int32 ,
Required: False ,
}
integer ,
supportedProducts:
{
Description: Maps to the list of compatible products ,
Required: False ,
}
[
string ,
]
,
applicableProducts:
{
Description: Product categories the offer belongs to ,
Required: False ,
}
[
string ,
]
,
lastModifiedDateTime:
{
Description: Latest update date of the product ,
Required: False ,
}
string ,
locations:
{
Description: List of locations which are available on the SKUs ,
Required: False ,
}
[
string ,
]
,
serviceFamily:
{
Description: The service family of the product, such as 'Compute' ,
Required: False ,
}
string ,
service:
{
Description: The service name of the product, such as 'Virtual Machines' ,
Required: False ,
}
string ,
productId:
{
Description: The unique id of the product ,
Required: False ,
}
string ,
hasRiPlans:
{
Description: Indication whether the product has plans with reservations ,
Required: False ,
}
boolean ,
hasMarketplaceFootprint:
{
Description: Indication if product has a representation in the marketplace ,
Required: False ,
}
boolean ,
attributes:
{
Description: Set of products attributes ,
Required: False ,
}
[
{
key:
{
Description: The attribute key ,
Required: False ,
}
string ,
value:
{
Description: The attribute value ,
Required: False ,
}
string ,
}
,
]
,
videos:
{
Description: List of product videos ,
Required: False ,
}
[
{
caption:
{
Description: Video Caption ,
Required: False ,
}
string ,
uri:
{
Description: Video uri ,
Required: False ,
}
string ,
videoPurpose:
{
Description: Video purpose ,
Required: False ,
}
string ,
previewImage:
{
Description: Preview image ,
Required: False ,
}
{
caption:
{
Description: Image caption ,
Required: False ,
}
string ,
uri:
{
Description: Image uri ,
Required: False ,
}
string ,
imagePurpose:
{
Description: Purpose of the image ,
Required: False ,
}
string ,
}
,
}
,
]
,
images:
{
Description: List of Images ,
Required: False ,
}
[
{
context:
{
Description: Context of the image group ,
Required: False ,
}
string ,
items:
{
Description: List of images ,
Required: False ,
}
[
{
id:
{
Description: Image id ,
Required: False ,
}
string ,
uri:
{
Description: Image uri ,
Required: False ,
}
string ,
type:
{
Description: Image type ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
linkedAddIns:
{
Description: List of linked add ins provided for the item ,
Required: False ,
}
[
string ,
]
,
links:
{
Description: List of Links provided for the item ,
Required: False ,
}
[
{
id:
{
Description: Id of the link ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the link ,
Required: False ,
}
string ,
uri:
{
Description: Uri of the link ,
Required: False ,
}
string ,
}
,
]
,
language:
{
Description: The product language ,
Required: False ,
}
string ,
hasStandardContractAmendments:
{
Description: A value indicating whether standard contract amendments are present ,
Required: False ,
}
boolean ,
offerId:
{
Description: The offer id ,
Required: False ,
}
string ,
standardContractAmendmentsRevisionId:
{
Description: Standard contract amendments for the product ,
Required: False ,
}
string ,
universalAmendmentUrl:
{
Description: The universal amendment link for an enterprise contract ,
Required: False ,
}
string ,
isPrivate:
{
Description: Indicates if a product is private ,
Required: True ,
}
boolean ,
isStopSell:
{
Description: Indicates if a product is no longer available for sale ,
Required: True ,
}
boolean ,
legalTermsUri:
{
Description: Legal terms URI ,
Required: False ,
}
string ,
legalTermsType:
{
Description: Identifies the legal agreement framework governing product licensing and usage terms. - `None` - Standard marketplace terms apply without additional legal agreement requirements - `EA` - Microsoft Enterprise Agreement terms for volume licensing and enterprise customer deployments ,
Required: False ,
}
string ,
supportUri:
{
Description: Support uri of the product ,
Required: False ,
}
string ,
uiDefinitionUri:
{
Description: User interface definition uri ,
Required: False ,
}
string ,
screenshotUris:
{
Description: List of screenshot image URIs ,
Required: False ,
}
[
string ,
]
,
mediumIconUri:
{
Description: URI to the medium product icon ,
Required: False ,
}
string ,
largeIconUri:
{
Description: URI to the large product icon ,
Required: False ,
}
string ,
wideIconUri:
{
Description: URI to the wide product icon ,
Required: False ,
}
string ,
pricingDetailsUri:
{
Description: Pricing details uri of the product ,
Required: False ,
}
string ,
isReseller:
{
Description: A value indicating whether microsoft is acting as a reseller ,
Required: False ,
}
boolean ,
productOwnershipSellingMotion:
{
Description: Product ownership selling motion ,
Required: False ,
}
string ,
disableSendEmailOnPurchase:
{
Description: Indication to disable sending email on purchase ,
Required: False ,
}
boolean ,
isCoreVm:
{
Description: Indicates if VM was originally a Core Virtual Machine ,
Required: False ,
}
boolean ,
stopSellInfo:
{
Description: A StopSellInfo object providing stop sell related data ,
Required: False ,
}
{
startDate:
{
Description: A value indicating when the sale of this item is going to be stopped ,
Format: date-time ,
Required: False ,
}
string ,
reason:
{
Description: Specifies the business or technical justification for discontinuing product sales in the marketplace. - `EndOfSupport` - Product lifecycle has reached end-of-support status with no further updates or maintenance - `SecurityIssue` - Critical security vulnerability or compliance issue requiring immediate sales suspension - `Other` - Alternative business reason not covered by standard discontinuation categories ,
Required: False ,
}
string ,
alternativeOfferId:
{
Description: A value indicating an ID of an alternative offer provided by the same publisher ,
Required: False ,
}
string ,
alternativePlanId:
{
Description: A value indicating an ID of an alternative plan of the same offer ,
Required: False ,
}
string ,
}
,
marketingMaterial:
{
Description: Includes links to the learning and marketing materials as configured by the publisher ,
Required: False ,
}
{
path:
{
Description: Path to the marketing site ,
Required: False ,
}
string ,
learnUri:
{
Description: Path to the learn site ,
Required: False ,
}
string ,
}
,
artifacts:
{
Description: List of artifacts ,
Required: False ,
}
[
{
name:
{
Description: Artifact name ,
Required: False ,
}
string ,
uri:
{
Description: Artifact uri ,
Required: False ,
}
string ,
artifactType:
{
Description: Defines the artifact resource type and its role in the marketplace offering deployment process. - `Template` - Primary Azure Resource Manager template containing the main deployment configuration - `Fragment` - Nested Azure Resource Manager template referenced by the primary template for modular deployments - `Custom` - Publisher-defined artifact with specialized deployment or configuration requirements - `Metadata` - Supplementary information and configuration data supporting the deployment process ,
Required: True ,
}
string ,
}
,
]
,
plans:
{
Description: Full set of plan/SKU attributes ,
Required: False ,
}
[
{
planId:
{
Description: Plan identifier ,
Required: False ,
}
string ,
uniquePlanId:
{
Description: Unique plan identifier which is prefixed by combining uniqueProductId and PlanId with no separator in between ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the plan / sku ,
Required: False ,
}
string ,
vmArchitectureType:
{
Description: Specifies the virtual machine processor architecture and generation. Applies exclusively to Virtual Machine product types. - `X64Gen1` - x64 processor architecture with Generation 1 virtual machine firmware and BIOS support - `X64Gen2` - x64 processor architecture with Generation 2 virtual machine firmware and UEFI support - `Arm64` - ARM 64-bit processor architecture optimized for energy efficiency and cloud-native workloads ,
Required: False ,
}
string ,
cspState:
{
Description: Controls plan availability and partner access within the Microsoft Cloud Solution Provider (CSP) program. - `OptIn` - Enables all authorized Cloud Solution Provider partners to resell and deploy the product to customers - `OptOut` - Excluded from Cloud Solution Provider program, available only through direct channels - `SelectiveOptIn` - Available only to selected Cloud Solution Provider partners for resale and customer deployment ,
Required: False ,
}
string ,
metadata:
{
Description: Expanded plan/SKU metadata. ,
Required: False ,
}
{
generation:
{
Description: The VM image generation (applicable to Virtual Machine products only) ,
Required: False ,
}
string ,
altStackReference:
{
Description: Pointing to a planId which holds the alternative stack reference ,
Required: False ,
}
string ,
}
,
altStackReference:
{
Description: Alternative stack reference ,
Required: False ,
}
string ,
stackType:
{
Description: Stack type : Classic, Gen1, Gen2 ,
Required: False ,
}
string ,
altArchitectureReference:
{
Description: The alternative architecture reference ,
Required: False ,
}
string ,
categoryIds:
{
Description: Plan CategoryIds ,
Required: False ,
}
[
string ,
]
,
hasProtectedArtifacts:
{
Description: Set to true if plan has artifacts that are to be hidden for non authenticated users ,
Required: False ,
}
boolean ,
pricingTypes:
{
Description: Indicates the billing models and cost structures available for the plan. - `Free` - No charge for plan usage, typically for community editions or basic service tiers - `FreeTrial` - Time-limited free access period before transitioning to paid billing model - `Byol` - Bring Your Own License model where customers provide existing software licenses - `Payg` - Pay As You Go consumption-based billing calculated on actual resource usage - `Ri` - Reserved Instance billing with upfront commitment for discounted long-term pricing ,
Required: False ,
}
[
string ,
]
,
vmSecuritytypes:
{
Description: Defines the security enhancement level for virtual machine deployments. Applies exclusively to Virtual Machine product types. - `None` - Standard virtual machine security without additional protection features - `Trusted` - Trusted Launch security with secure boot and virtual Trusted Platform Module capabilities - `Confidential` - Confidential computing with memory encryption and attestation for sensitive workloads ,
Required: False ,
}
[
string ,
]
,
summary:
{
Description: The plan summary text ,
Required: False ,
}
string ,
description:
{
Description: Plan / sku description ,
Required: False ,
}
string ,
skuId:
{
Description: The SKU id ,
Required: False ,
}
string ,
planType:
{
Description: Specifies the primary deployment model and hosting architecture for the marketplace product. Currently supported values are: - `None` - Unspecified product type, typically used for products without a defined deployment model - `DevService` - Development-focused services and tools for software creation workflows - `ManagedApplication` - Azure Managed Applications that deploy and manage resources in customer subscriptions - `VirtualMachine` - Pre-configured virtual machine images deployable to Azure compute infrastructure - `AzureApplication` - Native Azure applications leveraging platform services and APIs - `Container` - Containerized applications deployed through Azure Container Instances or similar services - `SaaS` - Software as a Service solutions hosted and managed by the publisher - `SolutionTemplate` - Azure Resource Manager templates that provision multiple Azure resources - `IotEdgeModules` - Modules designed for deployment to Azure IoT Edge runtime environments - `ManagedServices` - Fully managed services where the publisher handles infrastructure and operations - `ContainerApps` - Applications built for Azure Container Apps serverless container platform - `VisualStudioExtension` - Extensions that integrate with Visual Studio IDE functionality - `DynamicsOps` - Microsoft Dynamics 365 Finance and Operations applications and extensions - `DynamicsCE` - Microsoft Dynamics 365 Customer Engagement applications and customizations - `DynamicsBC` - Microsoft Dynamics 365 Business Central applications and add-ons - `PowerBI` - Microsoft Power BI reports, dashboards, and data visualization components - `ConsultingServices` - Professional services offerings including implementation and advisory services - `CosellOnly` - Products available exclusively through Microsoft co-sell partner programs - `CoreVirtualMachine` - Core virtual machine offerings with baseline Azure compute capabilities - `PowerBIVisuals` - Custom visualizations for Microsoft Power BI reporting platform - `Office365` - Microsoft 365 and Office 365 applications, add-ins, and integrations - `AADApps` - Azure Active Directory integrated applications supporting organizational identity - `AzureServices` - Native Azure platform services and resource providers - `AppService` - Web applications hosted on Azure App Service platform - `LogAnalytics` - Azure Monitor Log Analytics solutions and workspace configurations - `MicrosoftProduct` - First-party Microsoft products available through marketplace channels ,
Required: True ,
}
string ,
displayRank:
{
Description: The order the plan is displayed in the 'Plans' table ,
Required: False ,
}
string ,
isPrivate:
{
Description: Indication that the plan is accessible to restricted audience only ,
Required: False ,
}
boolean ,
hasRi:
{
Description: Indication whether the SKU supports reservations ,
Required: False ,
}
boolean ,
id:
{
Description: The id ,
Required: False ,
}
string ,
availabilities:
{
Description: List of availabilities for this plan ,
Required: False ,
}
[
{
id:
{
Description: The document id ,
Required: False ,
}
string ,
actions:
{
Description: List of allowed actions ,
Required: False ,
}
[
string ,
]
,
meter:
{
Description: Applicable billing meter information ,
Required: False ,
}
{
meterId:
{
Description: Meter id ,
Required: False ,
}
string ,
partNumber:
{
Description: Compute part number ,
Required: False ,
}
string ,
consumptionResourceId:
{
Description: Consumption resource id ,
Required: False ,
}
string ,
price:
{
Description: Retail price with currency ,
Required: False ,
}
{
currencyCode:
{
Description: Currency code i.e. 'USD' ,
Required: False ,
}
string ,
isPiRequired:
{
Description: A value indicating whether a payment instrument is required ,
Required: True ,
}
boolean ,
listPrice:
{
Description: Retail price for the item ,
Format: float ,
Required: True ,
}
number ,
msrp:
{
Description: Manufacturer's suggested retail price for the item ,
Format: float ,
Required: True ,
}
number ,
}
,
type:
{
Description: Type of this meter ,
Required: False ,
}
string ,
includedQuantityProperties:
{
Description: Included quantity properties ,
Required: False ,
}
[
{
termId:
{
Description: Term id ,
Required: False ,
}
string ,
quantity:
{
Description: Included quantity ,
Required: False ,
}
string ,
}
,
]
,
}
,
pricingAudience:
{
Description: Specifies the distribution channel and customer segment for product pricing and availability. Possible values: - `Direct-Commercial` - Available through direct Azure Marketplace purchases for commercial customers without intermediaries like partners or resellers - `Partner-Commercial` - Available through Cloud Solution Provider partner channel for reseller distribution ,
Required: True ,
}
string ,
terms:
{
Description: List of applicable terms ,
Required: False ,
}
[
{
termDescriptionParameters:
{
Description: Term description parameters ,
Required: False ,
}
[
{
parameter:
{
Description: Description parameter ,
Required: False ,
}
string ,
value:
{
Description: Parameter's value ,
Required: False ,
}
string ,
}
,
]
,
termId:
{
Description: Term id ,
Required: False ,
}
string ,
termUnit:
{
Description: Term unit ,
Required: False ,
}
string ,
prorationPolicy:
{
Description: Defines the rules for calculating prorated charges or refunds for a subscription. ,
Required: False ,
}
{
minimumProratedUnits:
{
Description: Minimum prorated units ,
Required: False ,
}
string ,
}
,
termDescription:
{
Description: Term description ,
Required: False ,
}
string ,
price:
{
Description: Retail price with currency ,
Required: False ,
}
{
currencyCode:
{
Description: Currency code i.e. 'USD' ,
Required: False ,
}
string ,
isPiRequired:
{
Description: A value indicating whether a payment instrument is required ,
Required: True ,
}
boolean ,
listPrice:
{
Description: Retail price for the item ,
Format: float ,
Required: True ,
}
number ,
msrp:
{
Description: Manufacturer's suggested retail price for the item ,
Format: float ,
Required: True ,
}
number ,
}
,
renewTermId:
{
Description: Renew term id ,
Required: False ,
}
string ,
renewTermUnits:
{
Description: Renew term units ,
Required: False ,
}
string ,
billingPlan:
{
Description: Billing Plan ,
Required: False ,
}
{
billingPeriod:
{
Description: Billing period ,
Required: False ,
}
string ,
title:
{
Description: Title of the billing plan ,
Required: False ,
}
string ,
description:
{
Description: Description of the billing plan ,
Required: False ,
}
string ,
price:
{
Description: Retail price with currency ,
Required: False ,
}
{
currencyCode:
{
Description: Currency code i.e. 'USD' ,
Required: False ,
}
string ,
isPiRequired:
{
Description: A value indicating whether a payment instrument is required ,
Required: True ,
}
boolean ,
listPrice:
{
Description: Retail price for the item ,
Format: float ,
Required: True ,
}
number ,
msrp:
{
Description: Manufacturer's suggested retail price for the item ,
Format: float ,
Required: True ,
}
number ,
}
,
}
,
renewToTermBillingPlan:
{
Description: Renew Billing Plan ,
Required: False ,
}
string ,
isAutorenewable:
{
Description: Indicates if autorenew is enabled ,
Required: False ,
}
boolean ,
lifecyclePolicy:
{
Description: Defines the lifecycle management policy for the term ,
Required: False ,
}
{
graceDuration:
{
Description: Grace period duration where customers retain access to their product. Examples: 'P1M' (1 month), 'P30D' (30 days), 'P0D' (0 days) ,
Required: False ,
}
string ,
inactiveDuration:
{
Description: Inactive period duration ,
Required: False ,
}
string ,
lockoutDuration:
{
Description: Lockout period duration ,
Required: False ,
}
string ,
}
,
productCode:
{
Description: Product code for this term ,
Required: False ,
}
string ,
state:
{
Description: Term state ,
Required: False ,
}
string ,
actions:
{
Description: Term Actions ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
hasFreeTrials:
{
Description: A value indicating whether it has free trials ,
Required: True ,
}
boolean ,
consumptionUnitType:
{
Description: Consumption unit type ,
Required: False ,
}
string ,
displayRank:
{
Description: Display rank ,
Format: int32 ,
Required: True ,
}
integer ,
}
,
]
,
uiDefinitionUri:
{
Description: What blade to open when someone wants to create a marketplace item ,
Required: False ,
}
string ,
artifacts:
{
Description: Files related to the marketplace item ,
Required: False ,
}
[
{
name:
{
Description: Artifact name ,
Required: False ,
}
string ,
uri:
{
Description: Artifact uri ,
Required: False ,
}
string ,
artifactType:
{
Description: Defines the artifact resource type and its role in the marketplace offering deployment process. - `Template` - Primary Azure Resource Manager template containing the main deployment configuration - `Fragment` - Nested Azure Resource Manager template referenced by the primary template for modular deployments - `Custom` - Publisher-defined artifact with specialized deployment or configuration requirements - `Metadata` - Supplementary information and configuration data supporting the deployment process ,
Required: True ,
}
string ,
}
,
]
,
version:
{
Description: Version of the marketplace item ,
Required: False ,
}
string ,
isHidden:
{
Description: A value indicating whether the plan is hidden ,
Required: True ,
}
boolean ,
isStopSell:
{
Description: A value indicating whether plan has been stopped from selling ,
Required: True ,
}
boolean ,
stopSellInfo:
{
Description: A StopSellInfo object providing stop sell related data ,
Required: False ,
}
{
startDate:
{
Description: A value indicating when the sale of this item is going to be stopped ,
Format: date-time ,
Required: False ,
}
string ,
reason:
{
Description: Specifies the business or technical justification for discontinuing product sales in the marketplace. - `EndOfSupport` - Product lifecycle has reached end-of-support status with no further updates or maintenance - `SecurityIssue` - Critical security vulnerability or compliance issue requiring immediate sales suspension - `Other` - Alternative business reason not covered by standard discontinuation categories ,
Required: False ,
}
string ,
alternativeOfferId:
{
Description: A value indicating an ID of an alternative offer provided by the same publisher ,
Required: False ,
}
string ,
alternativePlanId:
{
Description: A value indicating an ID of an alternative plan of the same offer ,
Required: False ,
}
string ,
}
,
minQuantity:
{
Description: Min quantity ,
Format: int32 ,
Required: False ,
}
integer ,
maxQuantity:
{
Description: Max quantity ,
Format: int32 ,
Required: False ,
}
integer ,
isQuantifiable:
{
Description: A value indicating whether the plan is quantifiable ,
Required: True ,
}
boolean ,
billingComponents:
{
Description: Billing components ,
Required: False ,
}
[
{
billingTag:
{
Description: Billing Tag ,
Required: False ,
}
string ,
}
,
]
,
purchaseDurationDiscounts:
{
Description: List of purchase duration discounts ,
Required: False ,
}
[
{
duration:
{
Description: The duration ,
Required: False ,
}
string ,
discountPercentage:
{
Description: The discount percentage ,
Format: float ,
Required: True ,
}
number ,
}
,
]
,
isHiddenPrivateOffer:
{
Description: A value indicating whether the plan is used as hidden private offer requiring a quote ,
Required: False ,
}
boolean ,
certifications:
{
Description: List of certifications ,
Required: False ,
}
[
{
id:
{
Description: Id of the link ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the link ,
Required: False ,
}
string ,
uri:
{
Description: Uri of the link ,
Required: False ,
}
string ,
}
,
]
,
customerInstruction:
{
Description: Plan's customer instruction for purchasing ,
Required: False ,
}
string ,
planLabels:
{
Description: Plan labels ,
Required: False ,
}
[
string ,
]
,
skuType:
{
Description: SKU type ,
Required: False ,
}
string ,
skuTitle:
{
Description: Sku title localized ,
Required: False ,
}
string ,
location:
{
Description: SKU location ,
Required: False ,
}
string ,
armRegionName:
{
Description: The Arm region name ,
Required: False ,
}
string ,
cloud:
{
Description: Applicable cloud, such as 'Global' ,
Required: False ,
}
string ,
locationType:
{
Description: The location type, such as 'Region' ,
Required: False ,
}
string ,
region:
{
Description: The region ,
Required: False ,
}
string ,
skuGroupId:
{
Description: The sku group id ,
Required: False ,
}
string ,
zone:
{
Description: The zone, such as 'Zone 1' ,
Required: False ,
}
string ,
feature:
{
Description: The feature, such as 'Spot' ,
Required: False ,
}
string ,
serviceType:
{
Description: The service type ,
Required: False ,
}
string ,
skuAttributes:
{
Description: Set of SKU attributes (varies per sku type), where each attribute is represented by a pair of key (attribute name) and value(attribute value) ,
Required: False ,
}
[
{
key:
{
Description: The attribute key ,
Required: False ,
}
string ,
value:
{
Description: The attribute value ,
Required: False ,
}
string ,
}
,
]
,
skuProperties:
{
Description: The sku properties ,
Required: False ,
}
{
category:
{
Description: The sku category ,
Required: False ,
}
string ,
dataDiskType:
{
Description: The data disk type, such as 'Ssd' ,
Required: False ,
}
string ,
diskType:
{
Description: The disk type, such as 'Ssd' ,
Required: False ,
}
string ,
numberOfCores:
{
Description: The number of cores ,
Required: False ,
}
string ,
ram:
{
Description: The RAM ,
Required: False ,
}
string ,
vCpu:
{
Description: The number of virtual CPUs ,
Required: False ,
}
string ,
armSkuName:
{
Description: The ARM SKU name ,
Required: False ,
}
string ,
accessTier:
{
Description: The access tier, such as 'Standard' ,
Required: False ,
}
string ,
}
,
offeringProperties:
{
Description: SKU price related properties. ,
Required: False ,
}
[
{
productCode:
{
Description: The product code (UPN) ,
Required: False ,
}
string ,
termId:
{
Description: The term id ,
Required: False ,
}
string ,
meterType:
{
Description: The meter type ,
Required: False ,
}
string ,
billingMeterId:
{
Description: The billing meter id ,
Required: False ,
}
string ,
offeringId:
{
Description: The offering id ,
Required: False ,
}
string ,
type:
{
Description: Entitlement, Consumption or Reservation ,
Required: False ,
}
string ,
}
,
]
,
hasConsumptionComponents:
{
Description: Indicates if this SKU has consumption components ,
Required: False ,
}
boolean ,
isEndUserEligible:
{
Description: Indicates if this SKU is available for end users ,
Required: False ,
}
boolean ,
isAdminEligible:
{
Description: Indicates if this SKU is available for admins ,
Required: False ,
}
boolean ,
entraIdVersion:
{
Description: The entra id version for products that come with entra id support ,
Required: False ,
}
string ,
technicalRequirements:
{
Description: Technical Requirements ,
Required: False ,
}
string ,
faqUri:
{
Description: The URI to the FAQ page ,
Required: False ,
}
string ,
fulfillmentData:
{
Description: Fulfillment instructions for this SKU ,
Required: False ,
}
{
fulfillmentType:
{
Description: Differentiates between fulfillment types ,
Required: False ,
}
string ,
attributes:
{
Description: Fulfillment attributes ,
Required: False ,
}
{
fulfillmentTiming:
{
Description: Timing configuration for product fulfillment ,
Required: False ,
}
string ,
fulfillmentDelayMitigation:
{
Description: Mitigation explanation for delayed fulfillment ,
Required: False ,
}
string ,
}
,
additionalProducts:
{
Description: Bundled products included defining additional product/SKU combinations ,
Required: False ,
}
[
{
productSkuId:
{
Description: Product and SKU ID for bundled products included with the license ,
Required: False ,
}
string ,
defaultKeyActivationCount:
{
Description: Quantity of the bundled product per license ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
benefits:
{
Description: Provides promotion data ,
Required: False ,
}
[
{
benefitType:
{
Description: Benefit type ,
Required: False ,
}
string ,
basePlanId:
{
Description: Base plan ID ,
Required: False ,
}
string ,
billingPlan:
{
Description: Billing plan ,
Required: False ,
}
string ,
termDuration:
{
Description: Term duration. Examples: 'P1M' (1 month), 'P30D' (30 days) ,
Required: False ,
}
string ,
}
,
]
,
constraintsData:
{
Description: Contains constraint product properties to determine eligibility ,
Required: False ,
}
{
seatConstraints:
{
Description: Seat constraint configurations defining minimum and maximum seat limits ,
Required: False ,
}
[
{
type:
{
Description: Constraint type ,
Required: False ,
}
string ,
minSeats:
{
Description: Minimum seats ,
Format: int32 ,
Required: False ,
}
integer ,
maxSeats:
{
Description: Maximum seats ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
assetOwnershipLimits:
{
Description: Asset ownership limits ,
Required: False ,
}
[
{
type:
{
Description: Limit type ,
Required: False ,
}
string ,
minAssets:
{
Description: Minimum number of assets ,
Format: int32 ,
Required: False ,
}
integer ,
maxAssets:
{
Description: Maximum number of assets ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
prerequisiteSkus:
{
Description: Lists eligible prerequisite SKUs ,
Required: False ,
}
{
mustHaveAll:
{
Description: Prerequisite sets where all specified SKUs must be owned ,
Required: False ,
}
[
{
productId:
{
Description: Product ID ,
Required: False ,
}
string ,
skuIds:
{
Description: SKU IDs ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
mustHaveAny:
{
Description: Prerequisite sets where any one of the specified SKUs must be owned ,
Required: False ,
}
[
{
productId:
{
Description: Product ID ,
Required: False ,
}
string ,
skuIds:
{
Description: SKU IDs ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
seatConstraints:
{
Description: Percentage-based seat constraints for prerequisite SKUs ,
Required: False ,
}
[
{
type:
{
Description: Constraint type ,
Required: False ,
}
string ,
minPercentSeats:
{
Description: Minimum percent seats ,
Format: double ,
Required: False ,
}
number ,
maxPercentSeats:
{
Description: Maximum percent seats ,
Format: double ,
Required: False ,
}
number ,
}
,
]
,
}
,
}
,
meterTypeDescriptions:
{
Description: Meter type descriptions ,
Required: False ,
}
[
{
key:
{
Description: Meter Type Description key ,
Required: False ,
}
string ,
value:
{
Description: Meter type description value ,
Required: False ,
}
{
meterType:
{
Description: The type of meter ,
Required: False ,
}
string ,
unitOfMeasure:
{
Description: The unit of measurement for the meter ,
Required: False ,
}
string ,
}
,
}
,
]
,
usageUnit:
{
Description: Usage unit ,
Required: False ,
}
string ,
skuName:
{
Description: Sku name ,
Required: False ,
}
string ,
}
,
]
,
hasAddOns:
{
Description: Indicates that the SKU has add-ons ,
Required: False ,
}
boolean ,
}

⚐ Response (default)

{
error:
{
Description: The error details object ,
Required: True ,
}
{
code:
{
Description: The HTTP error code ,
Required: True ,
}
string ,
message:
{
Description: The error message ,
Required: True ,
}
string ,
}
,
}
ProductGet_GetByBillingAccount (updated)
Description :  Gets a single product by billing account.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProductGet_GetByBillingAccount",
  "$responses": {
    "200": {
      "$properties": {
        "plans": {
          "$properties": {
            "availabilities": {
              "$properties": {
                "terms": {
                  "$properties": {
                    "@added_66c9855980e94a46be9124116732e027": {
                      "#name": "lifecyclePolicy",
                      "Description": "Defines the lifecycle management policy for the term",
                      "Required": false,
                      "Type": "object",
                      "$properties": [
                        {
                          "#name": "graceDuration",
                          "Description": "Grace period duration where customers retain access to their product. Examples: 'P1M' (1 month), 'P30D' (30 days), 'P0D' (0 days)",
                          "Required": false,
                          "Type": "string"
                        },
                        {
                          "#name": "inactiveDuration",
                          "Description": "Inactive period duration",
                          "Required": false,
                          "Type": "string"
                        },
                        {
                          "#name": "lockoutDuration",
                          "Description": "Lockout period duration",
                          "Required": false,
                          "Type": "string"
                        }
                      ]
                    },
                    "@added_ac2af67b77a0456fbe41efb0814ad550": {
                      "#name": "productCode",
                      "Description": "Product code for this term",
                      "Required": false,
                      "Type": "string"
                    },
                    "@added_d3376b4ab8a74be89ab86a271b2ad344": {
                      "#name": "state",
                      "Description": "Term state",
                      "Required": false,
                      "Type": "string"
                    },
                    "@added_972ee7348c4e423ba1730585375ea359": {
                      "#name": "actions",
                      "Description": "Term Actions",
                      "Required": false,
                      "Type": "array",
                      "$items": {
                        "Type": "string"
                      }
                    }
                  }
                }
              }
            },
            "@added_29ab453d0d504cafa614fa3cbbd56f3b": {
              "#name": "hasConsumptionComponents",
              "Description": "Indicates if this SKU has consumption components",
              "Required": false,
              "Type": "boolean"
            },
            "@added_3d06ca9c22bc4b7b9df194fa14e2c6e0": {
              "#name": "isEndUserEligible",
              "Description": "Indicates if this SKU is available for end users",
              "Required": false,
              "Type": "boolean"
            },
            "@added_024c1d4691274c199b02fdd7f4b74a43": {
              "#name": "isAdminEligible",
              "Description": "Indicates if this SKU is available for admins",
              "Required": false,
              "Type": "boolean"
            },
            "@added_25a9a440b1724d30ab91203b0480aa36": {
              "#name": "entraIdVersion",
              "Description": "The entra id version for products that come with entra id support",
              "Required": false,
              "Type": "string"
            },
            "@added_c66c91fe198147d2b1d837bf4ad2b857": {
              "#name": "technicalRequirements",
              "Description": "Technical Requirements",
              "Required": false,
              "Type": "string"
            },
            "@added_73e6d9ed3e6749fa805c1bef8526c858": {
              "#name": "faqUri",
              "Description": "The URI to the FAQ page",
              "Required": false,
              "Type": "string"
            },
            "@added_0942123afa674b7297ffb84aac39b3be": {
              "#name": "fulfillmentData",
              "Description": "Fulfillment instructions for this SKU",
              "Required": false,
              "Type": "object",
              "$properties": [
                {
                  "#name": "fulfillmentType",
                  "Description": "Differentiates between fulfillment types",
                  "Required": false,
                  "Type": "string"
                },
                {
                  "#name": "attributes",
                  "Description": "Fulfillment attributes",
                  "Required": false,
                  "Type": "object",
                  "$properties": [
                    {
                      "#name": "fulfillmentTiming",
                      "Description": "Timing configuration for product fulfillment",
                      "Required": false,
                      "Type": "string"
                    },
                    {
                      "#name": "fulfillmentDelayMitigation",
                      "Description": "Mitigation explanation for delayed fulfillment",
                      "Required": false,
                      "Type": "string"
                    }
                  ]
                },
                {
                  "#name": "additionalProducts",
                  "Description": "Bundled products included defining additional product/SKU combinations",
                  "Required": false,
                  "Type": "array",
                  "$items": {
                    "Description": "Configuration for additional products bundled with early access pass SKUs",
                    "Type": "object",
                    "$properties": [
                      {
                        "#name": "productSkuId",
                        "Description": "Product and SKU ID for bundled products included with the license",
                        "Required": false,
                        "Type": "string"
                      },
                      {
                        "#name": "defaultKeyActivationCount",
                        "Description": "Quantity of the bundled product per license ",
                        "Format": "int32",
                        "Required": false,
                        "Type": "integer"
                      }
                    ]
                  }
                }
              ]
            },
            "@added_cad0aa12fe844731aa5c22c9c8a17d8d": {
              "#name": "benefits",
              "Description": "Provides promotion data",
              "Required": false,
              "Type": "array",
              "$items": {
                "Description": "Benefit information for a plan",
                "Type": "object",
                "$properties": [
                  {
                    "#name": "benefitType",
                    "Description": "Benefit type",
                    "Required": false,
                    "Type": "string"
                  },
                  {
                    "#name": "basePlanId",
                    "Description": "Base plan ID",
                    "Required": false,
                    "Type": "string"
                  },
                  {
                    "#name": "billingPlan",
                    "Description": "Billing plan",
                    "Required": false,
                    "Type": "string"
                  },
                  {
                    "#name": "termDuration",
                    "Description": "Term duration. Examples: 'P1M' (1 month), 'P30D' (30 days)",
                    "Required": false,
                    "Type": "string"
                  }
                ]
              }
            },
            "@added_ae04b2ffebbf46ae95569b1882be7dcb": {
              "#name": "constraintsData",
              "Description": "Contains constraint product properties to determine eligibility",
              "Required": false,
              "Type": "object",
              "$properties": [
                {
                  "#name": "seatConstraints",
                  "Description": "Seat constraint configurations defining minimum and maximum seat limits",
                  "Required": false,
                  "Type": "array",
                  "$items": {
                    "Description": "Defines minimum and maximum seat limits for a specific constraint type",
                    "Type": "object",
                    "$properties": [
                      {
                        "#name": "type",
                        "Description": "Constraint type",
                        "Required": false,
                        "Type": "string"
                      },
                      {
                        "#name": "minSeats",
                        "Description": "Minimum seats",
                        "Format": "int32",
                        "Required": false,
                        "Type": "integer"
                      },
                      {
                        "#name": "maxSeats",
                        "Description": "Maximum seats",
                        "Format": "int32",
                        "Required": false,
                        "Type": "integer"
                      }
                    ]
                  }
                },
                {
                  "#name": "assetOwnershipLimits",
                  "Description": "Asset ownership limits",
                  "Required": false,
                  "Type": "array",
                  "$items": {
                    "Description": "Defines ownership restrictions and limits for SKU assets",
                    "Type": "object",
                    "$properties": [
                      {
                        "#name": "type",
                        "Description": "Limit type",
                        "Required": false,
                        "Type": "string"
                      },
                      {
                        "#name": "minAssets",
                        "Description": "Minimum number of assets",
                        "Format": "int32",
                        "Required": false,
                        "Type": "integer"
                      },
                      {
                        "#name": "maxAssets",
                        "Description": "Maximum number of assets",
                        "Format": "int32",
                        "Required": false,
                        "Type": "integer"
                      }
                    ]
                  }
                },
                {
                  "#name": "prerequisiteSkus",
                  "Description": "Lists eligible prerequisite SKUs",
                  "Required": false,
                  "Type": "object",
                  "$properties": [
                    {
                      "#name": "mustHaveAll",
                      "Description": "Prerequisite sets where all specified SKUs must be owned",
                      "Required": false,
                      "Type": "array",
                      "$items": {
                        "Description": "Prerequisite set",
                        "Type": "object",
                        "$properties": [
                          {
                            "#name": "productId",
                            "Description": "Product ID",
                            "Required": false,
                            "Type": "string"
                          },
                          {
                            "#name": "skuIds",
                            "Description": "SKU IDs",
                            "Required": false,
                            "Type": "array",
                            "$items": {
                              "Type": "string"
                            }
                          }
                        ]
                      }
                    },
                    {
                      "#name": "mustHaveAny",
                      "Description": "Prerequisite sets where any one of the specified SKUs must be owned",
                      "Required": false,
                      "Type": "array",
                      "$items": {
                        "Description": "Prerequisite set",
                        "Type": "object",
                        "$properties": [
                          {
                            "#name": "productId",
                            "Description": "Product ID",
                            "Required": false,
                            "Type": "string"
                          },
                          {
                            "#name": "skuIds",
                            "Description": "SKU IDs",
                            "Required": false,
                            "Type": "array",
                            "$items": {
                              "Type": "string"
                            }
                          }
                        ]
                      }
                    },
                    {
                      "#name": "seatConstraints",
                      "Description": "Percentage-based seat constraints for prerequisite SKUs",
                      "Required": false,
                      "Type": "array",
                      "$items": {
                        "Description": "Minimum and maximum percentage seats constraint",
                        "Type": "object",
                        "$properties": [
                          {
                            "#name": "type",
                            "Description": "Constraint type",
                            "Required": false,
                            "Type": "string"
                          },
                          {
                            "#name": "minPercentSeats",
                            "Description": "Minimum percent seats",
                            "Format": "double",
                            "Required": false,
                            "Type": "number"
                          },
                          {
                            "#name": "maxPercentSeats",
                            "Description": "Maximum percent seats",
                            "Format": "double",
                            "Required": false,
                            "Type": "number"
                          }
                        ]
                      }
                    }
                  ]
                }
              ]
            },
            "@added_59d123d9e11c4b3b96554cf6c90912c4": {
              "#name": "meterTypeDescriptions",
              "Description": "Meter type descriptions",
              "Required": false,
              "Type": "array",
              "$items": {
                "Description": "Meter type description",
                "Type": "object",
                "$properties": [
                  {
                    "#name": "key",
                    "Description": "Meter Type Description key",
                    "Required": false,
                    "Type": "string"
                  },
                  {
                    "#name": "value",
                    "Description": "Meter type description value",
                    "Required": false,
                    "Type": "object",
                    "$properties": [
                      {
                        "#name": "meterType",
                        "Description": "The type of meter",
                        "Required": false,
                        "Type": "string"
                      },
                      {
                        "#name": "unitOfMeasure",
                        "Description": "The unit of measurement for the meter",
                        "Required": false,
                        "Type": "string"
                      }
                    ]
                  }
                ]
              }
            },
            "@added_bb256c40f5814cfa8f97fa76d3941e9f": {
              "#name": "usageUnit",
              "Description": "Usage unit",
              "Required": false,
              "Type": "string"
            },
            "@added_a025d72901e147b19e7696b9bfb1603b": {
              "#name": "skuName",
              "Description": "Sku name",
              "Required": false,
              "Type": "string"
            }
          }
        },
        "@added_39a8a236bc7a4667aff93a01b2c65a28": {
          "#name": "hasAddOns",
          "Description": "Indicates that the SKU has add-ons",
          "Required": false,
          "Type": "boolean"
        }
      }
    }
  }
}

⚼ Request

GET:  /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Marketplace/products/{productId}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
billingAccountId:
{
Description: The ID of the target billing account. ,
Required: True ,
}
string ,
productId:
{
Description: The ID of the product ,
Required: True ,
}
string ,
includeStopSoldPlans:
{
Description: Indicates whether to include plans that are no longer available for purchase in the response. By default, includeStopSoldPlans is set to FALSE. ,
Required: False ,
}
boolean ,
language:
{
Description: Language to search, ISO 639-1 two-letter code, possible values - 'en,cs,de,es,fr,hu,it,ja,ko,nl,pl,pt-br,pt-pt,ru,sv,tr,id,zh-hans,zh-hant'. Default is "en" ,
Required: False ,
}
string ,
includeHiddenPlans:
{
Description: Indicates whether to include hidden plans in the response. By default, includeHiddenPlans is set to FALSE. ,
Required: False ,
}
boolean ,
includeServiceInstructionTemplates:
{
Description: Indicates whether to include the product's service instruction templates in the response. By default, includeServiceInstructionTemplates is set to FALSE. ,
Required: False ,
}
boolean ,
planId:
{
Description: Optional to pass the plan id to filter to a specific plan within the product. If not specified, the response will include all plans of the product. ,
Required: False ,
}
string ,
skuId:
{
Description: Optional to pass the sku id to filter to a specific sku within the product. If not specified, the response will include all skus of the product. ,
Required: False ,
}
string ,
}

⚐ Response (200)

{
displayName:
{
Description: Product display name ,
Required: False ,
}
string ,
popularity:
{
Description: Popularity of the product ,
Format: double ,
Required: False ,
}
number ,
categoryIds:
{
Description: Array of product categories ,
Required: False ,
}
[
string ,
]
,
industryIds:
{
Description: List of industry IDs the item belongs to ,
Required: False ,
}
[
string ,
]
,
publisherId:
{
Description: Publisher id ,
Required: False ,
}
string ,
azureBenefit:
{
Description: Indicates whether product purchases count toward Azure consumption commitment benefits for enterprise customers. - `Eligible` - Product costs apply to Azure consumption commitment benefit calculations and credits - `NotEligible` - Product costs do not qualify for Azure consumption commitment benefit programs ,
Required: False ,
}
string ,
badges:
{
Description: Displays certification and qualification badges earned by the product for marketplace visibility. - `PreferredSolution` - Microsoft-recognized solution meeting specific quality and partnership criteria - `PowerBICertified` - Certified compatibility and integration with Microsoft Power BI platform - `AdditionalPurchaseRequirement` - Product requires additional purchases or subscriptions for full functionality ,
Required: False ,
}
[
string ,
]
,
publisherType:
{
Description: Identifies the publisher relationship to Microsoft for support and partnership classification. - `Microsoft` - First-party Microsoft product with direct Microsoft support and development - `ThirdParty` - Independent software vendor product with publisher-provided support and maintenance ,
Required: False ,
}
string ,
publishingStage:
{
Description: Indicates the product availability status and customer access level within Azure Marketplace. - `Preview` - Limited availability to selected customers for testing and early access evaluation - `Public` - General availability to all Azure Marketplace customers for production deployment ,
Required: False ,
}
string ,
uniqueProductId:
{
Description: Unique product identifier ,
Required: True ,
}
string ,
productType:
{
Description: Specifies the primary deployment model and hosting architecture for the marketplace product stored in the Marketplace Catalog. - `None` - Unspecified product type, typically used for products without a defined deployment model - `ManagedApplication` - Azure Managed Applications that deploy and manage resources in customer subscriptions - `VirtualMachine` - Pre-configured virtual machine images deployable to Azure compute infrastructure - `AzureApplication` - Native Azure applications leveraging platform services and APIs - `Container` - Containerized applications deployed through Azure Container Instances or similar services - `SaaS` - Software as a Service solutions hosted and managed by the publisher - `SolutionTemplate` - Azure Resource Manager templates that provision multiple Azure resources - `IotEdgeModules` - Modules designed for deployment to Azure IoT Edge runtime environments - `ManagedServices` - Fully managed services where the publisher handles infrastructure and operations - `ContainerApps` - Applications built for Azure Container Apps serverless container platform - `DynamicsOps` - Microsoft Dynamics 365 Finance and Operations applications and extensions - `DynamicsCE` - Microsoft Dynamics 365 Customer Engagement applications and customizations - `DynamicsBC` - Microsoft Dynamics 365 Business Central applications and add-ons - `PowerBI` - Microsoft Power BI reports, dashboards, and data visualization components - `ConsultingServices` - Professional services offerings including implementation and advisory services - `CosellOnly` - Products available exclusively through Microsoft co-sell partner programs - `CoreVirtualMachine` - Core virtual machine offerings with baseline Azure compute capabilities - `PowerBIVisuals` - Custom visualizations for Microsoft Power BI reporting platform - `Office365` - Microsoft 365 and Office 365 applications, add-ins, and integrations - `AADApps` - Azure Active Directory integrated applications supporting organizational identity - `AzureServices` - Native Azure platform services and resource providers - `AppService` - Web applications hosted on Azure App Service platform - `LogAnalytics` - Azure Monitor Log Analytics solutions and workspace configurations - `MicrosoftProduct` - First-party Microsoft products available through marketplace channels ,
Required: True ,
}
string ,
productSubType:
{
Description: Product sub type ,
Required: False ,
}
string ,
productFamily:
{
Description: Product Family ,
Required: False ,
}
string ,
operatingSystems:
{
Description: Operating system info for this product ,
Required: False ,
}
[
string ,
]
,
pricingTypes:
{
Description: Indicates the billing models and cost structures available for the plan. - `Free` - No charge for plan usage, typically for community editions or basic service tiers - `FreeTrial` - Time-limited free access period before transitioning to paid billing model - `Byol` - Bring Your Own License model where customers provide existing software licenses - `Payg` - Pay As You Go consumption-based billing calculated on actual resource usage - `Ri` - Reserved Instance billing with upfront commitment for discounted long-term pricing ,
Required: False ,
}
[
string ,
]
,
publisherDisplayName:
{
Description: Publisher display name ,
Required: False ,
}
string ,
longSummary:
{
Description: Product long summary ,
Required: False ,
}
string ,
summary:
{
Description: Product summary ,
Required: False ,
}
string ,
smallIconUri:
{
Description: URI to the small product icon ,
Required: False ,
}
string ,
description:
{
Description: The product description text ,
Required: False ,
}
string ,
cspLegalTermsUri:
{
Description: The legal terms of the product for the CSP ,
Required: False ,
}
string ,
privacyPolicyUri:
{
Description: The privacy policy of the product ,
Required: False ,
}
string ,
ratingBuckets:
{
Description: Categorizes products by customer rating thresholds for marketplace filtering and discovery. - `AboveOne` - Products with customer ratings exceeding 1.0 stars based on marketplace reviews - `AboveTwo` - Products with customer ratings exceeding 2.0 stars based on marketplace reviews - `AboveThree` - Products with customer ratings exceeding 3.0 stars based on marketplace reviews - `AboveFour` - Products with customer ratings exceeding 4.0 stars based on marketplace reviews ,
Required: False ,
}
[
string ,
]
,
ratingAverage:
{
Description: Average rating for the offer ,
Format: double ,
Required: False ,
}
number ,
ratingCount:
{
Description: Total number of ratings for the offer ,
Format: int32 ,
Required: False ,
}
integer ,
supportedProducts:
{
Description: Maps to the list of compatible products ,
Required: False ,
}
[
string ,
]
,
applicableProducts:
{
Description: Product categories the offer belongs to ,
Required: False ,
}
[
string ,
]
,
lastModifiedDateTime:
{
Description: Latest update date of the product ,
Required: False ,
}
string ,
locations:
{
Description: List of locations which are available on the SKUs ,
Required: False ,
}
[
string ,
]
,
serviceFamily:
{
Description: The service family of the product, such as 'Compute' ,
Required: False ,
}
string ,
service:
{
Description: The service name of the product, such as 'Virtual Machines' ,
Required: False ,
}
string ,
productId:
{
Description: The unique id of the product ,
Required: False ,
}
string ,
hasRiPlans:
{
Description: Indication whether the product has plans with reservations ,
Required: False ,
}
boolean ,
hasMarketplaceFootprint:
{
Description: Indication if product has a representation in the marketplace ,
Required: False ,
}
boolean ,
attributes:
{
Description: Set of products attributes ,
Required: False ,
}
[
{
key:
{
Description: The attribute key ,
Required: False ,
}
string ,
value:
{
Description: The attribute value ,
Required: False ,
}
string ,
}
,
]
,
videos:
{
Description: List of product videos ,
Required: False ,
}
[
{
caption:
{
Description: Video Caption ,
Required: False ,
}
string ,
uri:
{
Description: Video uri ,
Required: False ,
}
string ,
videoPurpose:
{
Description: Video purpose ,
Required: False ,
}
string ,
previewImage:
{
Description: Preview image ,
Required: False ,
}
{
caption:
{
Description: Image caption ,
Required: False ,
}
string ,
uri:
{
Description: Image uri ,
Required: False ,
}
string ,
imagePurpose:
{
Description: Purpose of the image ,
Required: False ,
}
string ,
}
,
}
,
]
,
images:
{
Description: List of Images ,
Required: False ,
}
[
{
context:
{
Description: Context of the image group ,
Required: False ,
}
string ,
items:
{
Description: List of images ,
Required: False ,
}
[
{
id:
{
Description: Image id ,
Required: False ,
}
string ,
uri:
{
Description: Image uri ,
Required: False ,
}
string ,
type:
{
Description: Image type ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
linkedAddIns:
{
Description: List of linked add ins provided for the item ,
Required: False ,
}
[
string ,
]
,
links:
{
Description: List of Links provided for the item ,
Required: False ,
}
[
{
id:
{
Description: Id of the link ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the link ,
Required: False ,
}
string ,
uri:
{
Description: Uri of the link ,
Required: False ,
}
string ,
}
,
]
,
language:
{
Description: The product language ,
Required: False ,
}
string ,
hasStandardContractAmendments:
{
Description: A value indicating whether standard contract amendments are present ,
Required: False ,
}
boolean ,
offerId:
{
Description: The offer id ,
Required: False ,
}
string ,
standardContractAmendmentsRevisionId:
{
Description: Standard contract amendments for the product ,
Required: False ,
}
string ,
universalAmendmentUrl:
{
Description: The universal amendment link for an enterprise contract ,
Required: False ,
}
string ,
isPrivate:
{
Description: Indicates if a product is private ,
Required: True ,
}
boolean ,
isStopSell:
{
Description: Indicates if a product is no longer available for sale ,
Required: True ,
}
boolean ,
legalTermsUri:
{
Description: Legal terms URI ,
Required: False ,
}
string ,
legalTermsType:
{
Description: Identifies the legal agreement framework governing product licensing and usage terms. - `None` - Standard marketplace terms apply without additional legal agreement requirements - `EA` - Microsoft Enterprise Agreement terms for volume licensing and enterprise customer deployments ,
Required: False ,
}
string ,
supportUri:
{
Description: Support uri of the product ,
Required: False ,
}
string ,
uiDefinitionUri:
{
Description: User interface definition uri ,
Required: False ,
}
string ,
screenshotUris:
{
Description: List of screenshot image URIs ,
Required: False ,
}
[
string ,
]
,
mediumIconUri:
{
Description: URI to the medium product icon ,
Required: False ,
}
string ,
largeIconUri:
{
Description: URI to the large product icon ,
Required: False ,
}
string ,
wideIconUri:
{
Description: URI to the wide product icon ,
Required: False ,
}
string ,
pricingDetailsUri:
{
Description: Pricing details uri of the product ,
Required: False ,
}
string ,
isReseller:
{
Description: A value indicating whether microsoft is acting as a reseller ,
Required: False ,
}
boolean ,
productOwnershipSellingMotion:
{
Description: Product ownership selling motion ,
Required: False ,
}
string ,
disableSendEmailOnPurchase:
{
Description: Indication to disable sending email on purchase ,
Required: False ,
}
boolean ,
isCoreVm:
{
Description: Indicates if VM was originally a Core Virtual Machine ,
Required: False ,
}
boolean ,
stopSellInfo:
{
Description: A StopSellInfo object providing stop sell related data ,
Required: False ,
}
{
startDate:
{
Description: A value indicating when the sale of this item is going to be stopped ,
Format: date-time ,
Required: False ,
}
string ,
reason:
{
Description: Specifies the business or technical justification for discontinuing product sales in the marketplace. - `EndOfSupport` - Product lifecycle has reached end-of-support status with no further updates or maintenance - `SecurityIssue` - Critical security vulnerability or compliance issue requiring immediate sales suspension - `Other` - Alternative business reason not covered by standard discontinuation categories ,
Required: False ,
}
string ,
alternativeOfferId:
{
Description: A value indicating an ID of an alternative offer provided by the same publisher ,
Required: False ,
}
string ,
alternativePlanId:
{
Description: A value indicating an ID of an alternative plan of the same offer ,
Required: False ,
}
string ,
}
,
marketingMaterial:
{
Description: Includes links to the learning and marketing materials as configured by the publisher ,
Required: False ,
}
{
path:
{
Description: Path to the marketing site ,
Required: False ,
}
string ,
learnUri:
{
Description: Path to the learn site ,
Required: False ,
}
string ,
}
,
artifacts:
{
Description: List of artifacts ,
Required: False ,
}
[
{
name:
{
Description: Artifact name ,
Required: False ,
}
string ,
uri:
{
Description: Artifact uri ,
Required: False ,
}
string ,
artifactType:
{
Description: Defines the artifact resource type and its role in the marketplace offering deployment process. - `Template` - Primary Azure Resource Manager template containing the main deployment configuration - `Fragment` - Nested Azure Resource Manager template referenced by the primary template for modular deployments - `Custom` - Publisher-defined artifact with specialized deployment or configuration requirements - `Metadata` - Supplementary information and configuration data supporting the deployment process ,
Required: True ,
}
string ,
}
,
]
,
plans:
{
Description: Full set of plan/SKU attributes ,
Required: False ,
}
[
{
planId:
{
Description: Plan identifier ,
Required: False ,
}
string ,
uniquePlanId:
{
Description: Unique plan identifier which is prefixed by combining uniqueProductId and PlanId with no separator in between ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the plan / sku ,
Required: False ,
}
string ,
vmArchitectureType:
{
Description: Specifies the virtual machine processor architecture and generation. Applies exclusively to Virtual Machine product types. - `X64Gen1` - x64 processor architecture with Generation 1 virtual machine firmware and BIOS support - `X64Gen2` - x64 processor architecture with Generation 2 virtual machine firmware and UEFI support - `Arm64` - ARM 64-bit processor architecture optimized for energy efficiency and cloud-native workloads ,
Required: False ,
}
string ,
cspState:
{
Description: Controls plan availability and partner access within the Microsoft Cloud Solution Provider (CSP) program. - `OptIn` - Enables all authorized Cloud Solution Provider partners to resell and deploy the product to customers - `OptOut` - Excluded from Cloud Solution Provider program, available only through direct channels - `SelectiveOptIn` - Available only to selected Cloud Solution Provider partners for resale and customer deployment ,
Required: False ,
}
string ,
metadata:
{
Description: Expanded plan/SKU metadata. ,
Required: False ,
}
{
generation:
{
Description: The VM image generation (applicable to Virtual Machine products only) ,
Required: False ,
}
string ,
altStackReference:
{
Description: Pointing to a planId which holds the alternative stack reference ,
Required: False ,
}
string ,
}
,
altStackReference:
{
Description: Alternative stack reference ,
Required: False ,
}
string ,
stackType:
{
Description: Stack type : Classic, Gen1, Gen2 ,
Required: False ,
}
string ,
altArchitectureReference:
{
Description: The alternative architecture reference ,
Required: False ,
}
string ,
categoryIds:
{
Description: Plan CategoryIds ,
Required: False ,
}
[
string ,
]
,
hasProtectedArtifacts:
{
Description: Set to true if plan has artifacts that are to be hidden for non authenticated users ,
Required: False ,
}
boolean ,
pricingTypes:
{
Description: Indicates the billing models and cost structures available for the plan. - `Free` - No charge for plan usage, typically for community editions or basic service tiers - `FreeTrial` - Time-limited free access period before transitioning to paid billing model - `Byol` - Bring Your Own License model where customers provide existing software licenses - `Payg` - Pay As You Go consumption-based billing calculated on actual resource usage - `Ri` - Reserved Instance billing with upfront commitment for discounted long-term pricing ,
Required: False ,
}
[
string ,
]
,
vmSecuritytypes:
{
Description: Defines the security enhancement level for virtual machine deployments. Applies exclusively to Virtual Machine product types. - `None` - Standard virtual machine security without additional protection features - `Trusted` - Trusted Launch security with secure boot and virtual Trusted Platform Module capabilities - `Confidential` - Confidential computing with memory encryption and attestation for sensitive workloads ,
Required: False ,
}
[
string ,
]
,
summary:
{
Description: The plan summary text ,
Required: False ,
}
string ,
description:
{
Description: Plan / sku description ,
Required: False ,
}
string ,
skuId:
{
Description: The SKU id ,
Required: False ,
}
string ,
planType:
{
Description: Specifies the primary deployment model and hosting architecture for the marketplace product. Currently supported values are: - `None` - Unspecified product type, typically used for products without a defined deployment model - `DevService` - Development-focused services and tools for software creation workflows - `ManagedApplication` - Azure Managed Applications that deploy and manage resources in customer subscriptions - `VirtualMachine` - Pre-configured virtual machine images deployable to Azure compute infrastructure - `AzureApplication` - Native Azure applications leveraging platform services and APIs - `Container` - Containerized applications deployed through Azure Container Instances or similar services - `SaaS` - Software as a Service solutions hosted and managed by the publisher - `SolutionTemplate` - Azure Resource Manager templates that provision multiple Azure resources - `IotEdgeModules` - Modules designed for deployment to Azure IoT Edge runtime environments - `ManagedServices` - Fully managed services where the publisher handles infrastructure and operations - `ContainerApps` - Applications built for Azure Container Apps serverless container platform - `VisualStudioExtension` - Extensions that integrate with Visual Studio IDE functionality - `DynamicsOps` - Microsoft Dynamics 365 Finance and Operations applications and extensions - `DynamicsCE` - Microsoft Dynamics 365 Customer Engagement applications and customizations - `DynamicsBC` - Microsoft Dynamics 365 Business Central applications and add-ons - `PowerBI` - Microsoft Power BI reports, dashboards, and data visualization components - `ConsultingServices` - Professional services offerings including implementation and advisory services - `CosellOnly` - Products available exclusively through Microsoft co-sell partner programs - `CoreVirtualMachine` - Core virtual machine offerings with baseline Azure compute capabilities - `PowerBIVisuals` - Custom visualizations for Microsoft Power BI reporting platform - `Office365` - Microsoft 365 and Office 365 applications, add-ins, and integrations - `AADApps` - Azure Active Directory integrated applications supporting organizational identity - `AzureServices` - Native Azure platform services and resource providers - `AppService` - Web applications hosted on Azure App Service platform - `LogAnalytics` - Azure Monitor Log Analytics solutions and workspace configurations - `MicrosoftProduct` - First-party Microsoft products available through marketplace channels ,
Required: True ,
}
string ,
displayRank:
{
Description: The order the plan is displayed in the 'Plans' table ,
Required: False ,
}
string ,
isPrivate:
{
Description: Indication that the plan is accessible to restricted audience only ,
Required: False ,
}
boolean ,
hasRi:
{
Description: Indication whether the SKU supports reservations ,
Required: False ,
}
boolean ,
id:
{
Description: The id ,
Required: False ,
}
string ,
availabilities:
{
Description: List of availabilities for this plan ,
Required: False ,
}
[
{
id:
{
Description: The document id ,
Required: False ,
}
string ,
actions:
{
Description: List of allowed actions ,
Required: False ,
}
[
string ,
]
,
meter:
{
Description: Applicable billing meter information ,
Required: False ,
}
{
meterId:
{
Description: Meter id ,
Required: False ,
}
string ,
partNumber:
{
Description: Compute part number ,
Required: False ,
}
string ,
consumptionResourceId:
{
Description: Consumption resource id ,
Required: False ,
}
string ,
price:
{
Description: Retail price with currency ,
Required: False ,
}
{
currencyCode:
{
Description: Currency code i.e. 'USD' ,
Required: False ,
}
string ,
isPiRequired:
{
Description: A value indicating whether a payment instrument is required ,
Required: True ,
}
boolean ,
listPrice:
{
Description: Retail price for the item ,
Format: float ,
Required: True ,
}
number ,
msrp:
{
Description: Manufacturer's suggested retail price for the item ,
Format: float ,
Required: True ,
}
number ,
}
,
type:
{
Description: Type of this meter ,
Required: False ,
}
string ,
includedQuantityProperties:
{
Description: Included quantity properties ,
Required: False ,
}
[
{
termId:
{
Description: Term id ,
Required: False ,
}
string ,
quantity:
{
Description: Included quantity ,
Required: False ,
}
string ,
}
,
]
,
}
,
pricingAudience:
{
Description: Specifies the distribution channel and customer segment for product pricing and availability. Possible values: - `Direct-Commercial` - Available through direct Azure Marketplace purchases for commercial customers without intermediaries like partners or resellers - `Partner-Commercial` - Available through Cloud Solution Provider partner channel for reseller distribution ,
Required: True ,
}
string ,
terms:
{
Description: List of applicable terms ,
Required: False ,
}
[
{
termDescriptionParameters:
{
Description: Term description parameters ,
Required: False ,
}
[
{
parameter:
{
Description: Description parameter ,
Required: False ,
}
string ,
value:
{
Description: Parameter's value ,
Required: False ,
}
string ,
}
,
]
,
termId:
{
Description: Term id ,
Required: False ,
}
string ,
termUnit:
{
Description: Term unit ,
Required: False ,
}
string ,
prorationPolicy:
{
Description: Defines the rules for calculating prorated charges or refunds for a subscription. ,
Required: False ,
}
{
minimumProratedUnits:
{
Description: Minimum prorated units ,
Required: False ,
}
string ,
}
,
termDescription:
{
Description: Term description ,
Required: False ,
}
string ,
price:
{
Description: Retail price with currency ,
Required: False ,
}
{
currencyCode:
{
Description: Currency code i.e. 'USD' ,
Required: False ,
}
string ,
isPiRequired:
{
Description: A value indicating whether a payment instrument is required ,
Required: True ,
}
boolean ,
listPrice:
{
Description: Retail price for the item ,
Format: float ,
Required: True ,
}
number ,
msrp:
{
Description: Manufacturer's suggested retail price for the item ,
Format: float ,
Required: True ,
}
number ,
}
,
renewTermId:
{
Description: Renew term id ,
Required: False ,
}
string ,
renewTermUnits:
{
Description: Renew term units ,
Required: False ,
}
string ,
billingPlan:
{
Description: Billing Plan ,
Required: False ,
}
{
billingPeriod:
{
Description: Billing period ,
Required: False ,
}
string ,
title:
{
Description: Title of the billing plan ,
Required: False ,
}
string ,
description:
{
Description: Description of the billing plan ,
Required: False ,
}
string ,
price:
{
Description: Retail price with currency ,
Required: False ,
}
{
currencyCode:
{
Description: Currency code i.e. 'USD' ,
Required: False ,
}
string ,
isPiRequired:
{
Description: A value indicating whether a payment instrument is required ,
Required: True ,
}
boolean ,
listPrice:
{
Description: Retail price for the item ,
Format: float ,
Required: True ,
}
number ,
msrp:
{
Description: Manufacturer's suggested retail price for the item ,
Format: float ,
Required: True ,
}
number ,
}
,
}
,
renewToTermBillingPlan:
{
Description: Renew Billing Plan ,
Required: False ,
}
string ,
isAutorenewable:
{
Description: Indicates if autorenew is enabled ,
Required: False ,
}
boolean ,
lifecyclePolicy:
{
Description: Defines the lifecycle management policy for the term ,
Required: False ,
}
{
graceDuration:
{
Description: Grace period duration where customers retain access to their product. Examples: 'P1M' (1 month), 'P30D' (30 days), 'P0D' (0 days) ,
Required: False ,
}
string ,
inactiveDuration:
{
Description: Inactive period duration ,
Required: False ,
}
string ,
lockoutDuration:
{
Description: Lockout period duration ,
Required: False ,
}
string ,
}
,
productCode:
{
Description: Product code for this term ,
Required: False ,
}
string ,
state:
{
Description: Term state ,
Required: False ,
}
string ,
actions:
{
Description: Term Actions ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
hasFreeTrials:
{
Description: A value indicating whether it has free trials ,
Required: True ,
}
boolean ,
consumptionUnitType:
{
Description: Consumption unit type ,
Required: False ,
}
string ,
displayRank:
{
Description: Display rank ,
Format: int32 ,
Required: True ,
}
integer ,
}
,
]
,
uiDefinitionUri:
{
Description: What blade to open when someone wants to create a marketplace item ,
Required: False ,
}
string ,
artifacts:
{
Description: Files related to the marketplace item ,
Required: False ,
}
[
{
name:
{
Description: Artifact name ,
Required: False ,
}
string ,
uri:
{
Description: Artifact uri ,
Required: False ,
}
string ,
artifactType:
{
Description: Defines the artifact resource type and its role in the marketplace offering deployment process. - `Template` - Primary Azure Resource Manager template containing the main deployment configuration - `Fragment` - Nested Azure Resource Manager template referenced by the primary template for modular deployments - `Custom` - Publisher-defined artifact with specialized deployment or configuration requirements - `Metadata` - Supplementary information and configuration data supporting the deployment process ,
Required: True ,
}
string ,
}
,
]
,
version:
{
Description: Version of the marketplace item ,
Required: False ,
}
string ,
isHidden:
{
Description: A value indicating whether the plan is hidden ,
Required: True ,
}
boolean ,
isStopSell:
{
Description: A value indicating whether plan has been stopped from selling ,
Required: True ,
}
boolean ,
stopSellInfo:
{
Description: A StopSellInfo object providing stop sell related data ,
Required: False ,
}
{
startDate:
{
Description: A value indicating when the sale of this item is going to be stopped ,
Format: date-time ,
Required: False ,
}
string ,
reason:
{
Description: Specifies the business or technical justification for discontinuing product sales in the marketplace. - `EndOfSupport` - Product lifecycle has reached end-of-support status with no further updates or maintenance - `SecurityIssue` - Critical security vulnerability or compliance issue requiring immediate sales suspension - `Other` - Alternative business reason not covered by standard discontinuation categories ,
Required: False ,
}
string ,
alternativeOfferId:
{
Description: A value indicating an ID of an alternative offer provided by the same publisher ,
Required: False ,
}
string ,
alternativePlanId:
{
Description: A value indicating an ID of an alternative plan of the same offer ,
Required: False ,
}
string ,
}
,
minQuantity:
{
Description: Min quantity ,
Format: int32 ,
Required: False ,
}
integer ,
maxQuantity:
{
Description: Max quantity ,
Format: int32 ,
Required: False ,
}
integer ,
isQuantifiable:
{
Description: A value indicating whether the plan is quantifiable ,
Required: True ,
}
boolean ,
billingComponents:
{
Description: Billing components ,
Required: False ,
}
[
{
billingTag:
{
Description: Billing Tag ,
Required: False ,
}
string ,
}
,
]
,
purchaseDurationDiscounts:
{
Description: List of purchase duration discounts ,
Required: False ,
}
[
{
duration:
{
Description: The duration ,
Required: False ,
}
string ,
discountPercentage:
{
Description: The discount percentage ,
Format: float ,
Required: True ,
}
number ,
}
,
]
,
isHiddenPrivateOffer:
{
Description: A value indicating whether the plan is used as hidden private offer requiring a quote ,
Required: False ,
}
boolean ,
certifications:
{
Description: List of certifications ,
Required: False ,
}
[
{
id:
{
Description: Id of the link ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the link ,
Required: False ,
}
string ,
uri:
{
Description: Uri of the link ,
Required: False ,
}
string ,
}
,
]
,
customerInstruction:
{
Description: Plan's customer instruction for purchasing ,
Required: False ,
}
string ,
planLabels:
{
Description: Plan labels ,
Required: False ,
}
[
string ,
]
,
skuType:
{
Description: SKU type ,
Required: False ,
}
string ,
skuTitle:
{
Description: Sku title localized ,
Required: False ,
}
string ,
location:
{
Description: SKU location ,
Required: False ,
}
string ,
armRegionName:
{
Description: The Arm region name ,
Required: False ,
}
string ,
cloud:
{
Description: Applicable cloud, such as 'Global' ,
Required: False ,
}
string ,
locationType:
{
Description: The location type, such as 'Region' ,
Required: False ,
}
string ,
region:
{
Description: The region ,
Required: False ,
}
string ,
skuGroupId:
{
Description: The sku group id ,
Required: False ,
}
string ,
zone:
{
Description: The zone, such as 'Zone 1' ,
Required: False ,
}
string ,
feature:
{
Description: The feature, such as 'Spot' ,
Required: False ,
}
string ,
serviceType:
{
Description: The service type ,
Required: False ,
}
string ,
skuAttributes:
{
Description: Set of SKU attributes (varies per sku type), where each attribute is represented by a pair of key (attribute name) and value(attribute value) ,
Required: False ,
}
[
{
key:
{
Description: The attribute key ,
Required: False ,
}
string ,
value:
{
Description: The attribute value ,
Required: False ,
}
string ,
}
,
]
,
skuProperties:
{
Description: The sku properties ,
Required: False ,
}
{
category:
{
Description: The sku category ,
Required: False ,
}
string ,
dataDiskType:
{
Description: The data disk type, such as 'Ssd' ,
Required: False ,
}
string ,
diskType:
{
Description: The disk type, such as 'Ssd' ,
Required: False ,
}
string ,
numberOfCores:
{
Description: The number of cores ,
Required: False ,
}
string ,
ram:
{
Description: The RAM ,
Required: False ,
}
string ,
vCpu:
{
Description: The number of virtual CPUs ,
Required: False ,
}
string ,
armSkuName:
{
Description: The ARM SKU name ,
Required: False ,
}
string ,
accessTier:
{
Description: The access tier, such as 'Standard' ,
Required: False ,
}
string ,
}
,
offeringProperties:
{
Description: SKU price related properties. ,
Required: False ,
}
[
{
productCode:
{
Description: The product code (UPN) ,
Required: False ,
}
string ,
termId:
{
Description: The term id ,
Required: False ,
}
string ,
meterType:
{
Description: The meter type ,
Required: False ,
}
string ,
billingMeterId:
{
Description: The billing meter id ,
Required: False ,
}
string ,
offeringId:
{
Description: The offering id ,
Required: False ,
}
string ,
type:
{
Description: Entitlement, Consumption or Reservation ,
Required: False ,
}
string ,
}
,
]
,
hasConsumptionComponents:
{
Description: Indicates if this SKU has consumption components ,
Required: False ,
}
boolean ,
isEndUserEligible:
{
Description: Indicates if this SKU is available for end users ,
Required: False ,
}
boolean ,
isAdminEligible:
{
Description: Indicates if this SKU is available for admins ,
Required: False ,
}
boolean ,
entraIdVersion:
{
Description: The entra id version for products that come with entra id support ,
Required: False ,
}
string ,
technicalRequirements:
{
Description: Technical Requirements ,
Required: False ,
}
string ,
faqUri:
{
Description: The URI to the FAQ page ,
Required: False ,
}
string ,
fulfillmentData:
{
Description: Fulfillment instructions for this SKU ,
Required: False ,
}
{
fulfillmentType:
{
Description: Differentiates between fulfillment types ,
Required: False ,
}
string ,
attributes:
{
Description: Fulfillment attributes ,
Required: False ,
}
{
fulfillmentTiming:
{
Description: Timing configuration for product fulfillment ,
Required: False ,
}
string ,
fulfillmentDelayMitigation:
{
Description: Mitigation explanation for delayed fulfillment ,
Required: False ,
}
string ,
}
,
additionalProducts:
{
Description: Bundled products included defining additional product/SKU combinations ,
Required: False ,
}
[
{
productSkuId:
{
Description: Product and SKU ID for bundled products included with the license ,
Required: False ,
}
string ,
defaultKeyActivationCount:
{
Description: Quantity of the bundled product per license ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
benefits:
{
Description: Provides promotion data ,
Required: False ,
}
[
{
benefitType:
{
Description: Benefit type ,
Required: False ,
}
string ,
basePlanId:
{
Description: Base plan ID ,
Required: False ,
}
string ,
billingPlan:
{
Description: Billing plan ,
Required: False ,
}
string ,
termDuration:
{
Description: Term duration. Examples: 'P1M' (1 month), 'P30D' (30 days) ,
Required: False ,
}
string ,
}
,
]
,
constraintsData:
{
Description: Contains constraint product properties to determine eligibility ,
Required: False ,
}
{
seatConstraints:
{
Description: Seat constraint configurations defining minimum and maximum seat limits ,
Required: False ,
}
[
{
type:
{
Description: Constraint type ,
Required: False ,
}
string ,
minSeats:
{
Description: Minimum seats ,
Format: int32 ,
Required: False ,
}
integer ,
maxSeats:
{
Description: Maximum seats ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
assetOwnershipLimits:
{
Description: Asset ownership limits ,
Required: False ,
}
[
{
type:
{
Description: Limit type ,
Required: False ,
}
string ,
minAssets:
{
Description: Minimum number of assets ,
Format: int32 ,
Required: False ,
}
integer ,
maxAssets:
{
Description: Maximum number of assets ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
prerequisiteSkus:
{
Description: Lists eligible prerequisite SKUs ,
Required: False ,
}
{
mustHaveAll:
{
Description: Prerequisite sets where all specified SKUs must be owned ,
Required: False ,
}
[
{
productId:
{
Description: Product ID ,
Required: False ,
}
string ,
skuIds:
{
Description: SKU IDs ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
mustHaveAny:
{
Description: Prerequisite sets where any one of the specified SKUs must be owned ,
Required: False ,
}
[
{
productId:
{
Description: Product ID ,
Required: False ,
}
string ,
skuIds:
{
Description: SKU IDs ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
seatConstraints:
{
Description: Percentage-based seat constraints for prerequisite SKUs ,
Required: False ,
}
[
{
type:
{
Description: Constraint type ,
Required: False ,
}
string ,
minPercentSeats:
{
Description: Minimum percent seats ,
Format: double ,
Required: False ,
}
number ,
maxPercentSeats:
{
Description: Maximum percent seats ,
Format: double ,
Required: False ,
}
number ,
}
,
]
,
}
,
}
,
meterTypeDescriptions:
{
Description: Meter type descriptions ,
Required: False ,
}
[
{
key:
{
Description: Meter Type Description key ,
Required: False ,
}
string ,
value:
{
Description: Meter type description value ,
Required: False ,
}
{
meterType:
{
Description: The type of meter ,
Required: False ,
}
string ,
unitOfMeasure:
{
Description: The unit of measurement for the meter ,
Required: False ,
}
string ,
}
,
}
,
]
,
usageUnit:
{
Description: Usage unit ,
Required: False ,
}
string ,
skuName:
{
Description: Sku name ,
Required: False ,
}
string ,
}
,
]
,
hasAddOns:
{
Description: Indicates that the SKU has add-ons ,
Required: False ,
}
boolean ,
}

⚐ Response (default)

{
error:
{
Description: The error details object ,
Required: True ,
}
{
code:
{
Description: The HTTP error code ,
Required: True ,
}
string ,
message:
{
Description: The error message ,
Required: True ,
}
string ,
}
,
}
ProductGet_GetByTenant (updated)
Description :  Gets a single product by tenant.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProductGet_GetByTenant",
  "$responses": {
    "200": {
      "$properties": {
        "plans": {
          "$properties": {
            "availabilities": {
              "$properties": {
                "terms": {
                  "$properties": {
                    "@added_4f27dddb7b5743c5bb5117694a6e930b": {
                      "#name": "lifecyclePolicy",
                      "Description": "Defines the lifecycle management policy for the term",
                      "Required": false,
                      "Type": "object",
                      "$properties": [
                        {
                          "#name": "graceDuration",
                          "Description": "Grace period duration where customers retain access to their product. Examples: 'P1M' (1 month), 'P30D' (30 days), 'P0D' (0 days)",
                          "Required": false,
                          "Type": "string"
                        },
                        {
                          "#name": "inactiveDuration",
                          "Description": "Inactive period duration",
                          "Required": false,
                          "Type": "string"
                        },
                        {
                          "#name": "lockoutDuration",
                          "Description": "Lockout period duration",
                          "Required": false,
                          "Type": "string"
                        }
                      ]
                    },
                    "@added_df93196c81df41c78ff11ed5bf27d34a": {
                      "#name": "productCode",
                      "Description": "Product code for this term",
                      "Required": false,
                      "Type": "string"
                    },
                    "@added_fd551881885d4e22b82ec6477cc3d914": {
                      "#name": "state",
                      "Description": "Term state",
                      "Required": false,
                      "Type": "string"
                    },
                    "@added_b6129b618009424d918fb2f2d1331ba5": {
                      "#name": "actions",
                      "Description": "Term Actions",
                      "Required": false,
                      "Type": "array",
                      "$items": {
                        "Type": "string"
                      }
                    }
                  }
                }
              }
            },
            "@added_6dac080543f0495d9b79432ec15cf2b9": {
              "#name": "hasConsumptionComponents",
              "Description": "Indicates if this SKU has consumption components",
              "Required": false,
              "Type": "boolean"
            },
            "@added_4eea3f9673e84a87b1147aa4ed01d723": {
              "#name": "isEndUserEligible",
              "Description": "Indicates if this SKU is available for end users",
              "Required": false,
              "Type": "boolean"
            },
            "@added_259084fec6e44081b013ae940b75a009": {
              "#name": "isAdminEligible",
              "Description": "Indicates if this SKU is available for admins",
              "Required": false,
              "Type": "boolean"
            },
            "@added_5f3b11e901d149f895c7d28bf9b464f6": {
              "#name": "entraIdVersion",
              "Description": "The entra id version for products that come with entra id support",
              "Required": false,
              "Type": "string"
            },
            "@added_a6a040911e864da1847872c51ce9b227": {
              "#name": "technicalRequirements",
              "Description": "Technical Requirements",
              "Required": false,
              "Type": "string"
            },
            "@added_f524886b59e743999bd3589b5b7c0285": {
              "#name": "faqUri",
              "Description": "The URI to the FAQ page",
              "Required": false,
              "Type": "string"
            },
            "@added_54c5d6dd0294401c851df9225c0428b2": {
              "#name": "fulfillmentData",
              "Description": "Fulfillment instructions for this SKU",
              "Required": false,
              "Type": "object",
              "$properties": [
                {
                  "#name": "fulfillmentType",
                  "Description": "Differentiates between fulfillment types",
                  "Required": false,
                  "Type": "string"
                },
                {
                  "#name": "attributes",
                  "Description": "Fulfillment attributes",
                  "Required": false,
                  "Type": "object",
                  "$properties": [
                    {
                      "#name": "fulfillmentTiming",
                      "Description": "Timing configuration for product fulfillment",
                      "Required": false,
                      "Type": "string"
                    },
                    {
                      "#name": "fulfillmentDelayMitigation",
                      "Description": "Mitigation explanation for delayed fulfillment",
                      "Required": false,
                      "Type": "string"
                    }
                  ]
                },
                {
                  "#name": "additionalProducts",
                  "Description": "Bundled products included defining additional product/SKU combinations",
                  "Required": false,
                  "Type": "array",
                  "$items": {
                    "Description": "Configuration for additional products bundled with early access pass SKUs",
                    "Type": "object",
                    "$properties": [
                      {
                        "#name": "productSkuId",
                        "Description": "Product and SKU ID for bundled products included with the license",
                        "Required": false,
                        "Type": "string"
                      },
                      {
                        "#name": "defaultKeyActivationCount",
                        "Description": "Quantity of the bundled product per license ",
                        "Format": "int32",
                        "Required": false,
                        "Type": "integer"
                      }
                    ]
                  }
                }
              ]
            },
            "@added_a7017ab8572f401ca489f11dc923a75d": {
              "#name": "benefits",
              "Description": "Provides promotion data",
              "Required": false,
              "Type": "array",
              "$items": {
                "Description": "Benefit information for a plan",
                "Type": "object",
                "$properties": [
                  {
                    "#name": "benefitType",
                    "Description": "Benefit type",
                    "Required": false,
                    "Type": "string"
                  },
                  {
                    "#name": "basePlanId",
                    "Description": "Base plan ID",
                    "Required": false,
                    "Type": "string"
                  },
                  {
                    "#name": "billingPlan",
                    "Description": "Billing plan",
                    "Required": false,
                    "Type": "string"
                  },
                  {
                    "#name": "termDuration",
                    "Description": "Term duration. Examples: 'P1M' (1 month), 'P30D' (30 days)",
                    "Required": false,
                    "Type": "string"
                  }
                ]
              }
            },
            "@added_58a064d872094942b528461c7c6cd028": {
              "#name": "constraintsData",
              "Description": "Contains constraint product properties to determine eligibility",
              "Required": false,
              "Type": "object",
              "$properties": [
                {
                  "#name": "seatConstraints",
                  "Description": "Seat constraint configurations defining minimum and maximum seat limits",
                  "Required": false,
                  "Type": "array",
                  "$items": {
                    "Description": "Defines minimum and maximum seat limits for a specific constraint type",
                    "Type": "object",
                    "$properties": [
                      {
                        "#name": "type",
                        "Description": "Constraint type",
                        "Required": false,
                        "Type": "string"
                      },
                      {
                        "#name": "minSeats",
                        "Description": "Minimum seats",
                        "Format": "int32",
                        "Required": false,
                        "Type": "integer"
                      },
                      {
                        "#name": "maxSeats",
                        "Description": "Maximum seats",
                        "Format": "int32",
                        "Required": false,
                        "Type": "integer"
                      }
                    ]
                  }
                },
                {
                  "#name": "assetOwnershipLimits",
                  "Description": "Asset ownership limits",
                  "Required": false,
                  "Type": "array",
                  "$items": {
                    "Description": "Defines ownership restrictions and limits for SKU assets",
                    "Type": "object",
                    "$properties": [
                      {
                        "#name": "type",
                        "Description": "Limit type",
                        "Required": false,
                        "Type": "string"
                      },
                      {
                        "#name": "minAssets",
                        "Description": "Minimum number of assets",
                        "Format": "int32",
                        "Required": false,
                        "Type": "integer"
                      },
                      {
                        "#name": "maxAssets",
                        "Description": "Maximum number of assets",
                        "Format": "int32",
                        "Required": false,
                        "Type": "integer"
                      }
                    ]
                  }
                },
                {
                  "#name": "prerequisiteSkus",
                  "Description": "Lists eligible prerequisite SKUs",
                  "Required": false,
                  "Type": "object",
                  "$properties": [
                    {
                      "#name": "mustHaveAll",
                      "Description": "Prerequisite sets where all specified SKUs must be owned",
                      "Required": false,
                      "Type": "array",
                      "$items": {
                        "Description": "Prerequisite set",
                        "Type": "object",
                        "$properties": [
                          {
                            "#name": "productId",
                            "Description": "Product ID",
                            "Required": false,
                            "Type": "string"
                          },
                          {
                            "#name": "skuIds",
                            "Description": "SKU IDs",
                            "Required": false,
                            "Type": "array",
                            "$items": {
                              "Type": "string"
                            }
                          }
                        ]
                      }
                    },
                    {
                      "#name": "mustHaveAny",
                      "Description": "Prerequisite sets where any one of the specified SKUs must be owned",
                      "Required": false,
                      "Type": "array",
                      "$items": {
                        "Description": "Prerequisite set",
                        "Type": "object",
                        "$properties": [
                          {
                            "#name": "productId",
                            "Description": "Product ID",
                            "Required": false,
                            "Type": "string"
                          },
                          {
                            "#name": "skuIds",
                            "Description": "SKU IDs",
                            "Required": false,
                            "Type": "array",
                            "$items": {
                              "Type": "string"
                            }
                          }
                        ]
                      }
                    },
                    {
                      "#name": "seatConstraints",
                      "Description": "Percentage-based seat constraints for prerequisite SKUs",
                      "Required": false,
                      "Type": "array",
                      "$items": {
                        "Description": "Minimum and maximum percentage seats constraint",
                        "Type": "object",
                        "$properties": [
                          {
                            "#name": "type",
                            "Description": "Constraint type",
                            "Required": false,
                            "Type": "string"
                          },
                          {
                            "#name": "minPercentSeats",
                            "Description": "Minimum percent seats",
                            "Format": "double",
                            "Required": false,
                            "Type": "number"
                          },
                          {
                            "#name": "maxPercentSeats",
                            "Description": "Maximum percent seats",
                            "Format": "double",
                            "Required": false,
                            "Type": "number"
                          }
                        ]
                      }
                    }
                  ]
                }
              ]
            },
            "@added_d5d4919068a54cc0921c43adae1d338a": {
              "#name": "meterTypeDescriptions",
              "Description": "Meter type descriptions",
              "Required": false,
              "Type": "array",
              "$items": {
                "Description": "Meter type description",
                "Type": "object",
                "$properties": [
                  {
                    "#name": "key",
                    "Description": "Meter Type Description key",
                    "Required": false,
                    "Type": "string"
                  },
                  {
                    "#name": "value",
                    "Description": "Meter type description value",
                    "Required": false,
                    "Type": "object",
                    "$properties": [
                      {
                        "#name": "meterType",
                        "Description": "The type of meter",
                        "Required": false,
                        "Type": "string"
                      },
                      {
                        "#name": "unitOfMeasure",
                        "Description": "The unit of measurement for the meter",
                        "Required": false,
                        "Type": "string"
                      }
                    ]
                  }
                ]
              }
            },
            "@added_19b8f67157e74c4d924d2b78d6973dc6": {
              "#name": "usageUnit",
              "Description": "Usage unit",
              "Required": false,
              "Type": "string"
            },
            "@added_ea039963de594a9eb1c535a17277e70b": {
              "#name": "skuName",
              "Description": "Sku name",
              "Required": false,
              "Type": "string"
            }
          }
        },
        "@added_7ac879fb644c49f88485bdac054c95ff": {
          "#name": "hasAddOns",
          "Description": "Indicates that the SKU has add-ons",
          "Required": false,
          "Type": "boolean"
        }
      }
    }
  }
}

⚼ Request

GET:  /providers/Microsoft.Marketplace/products/{productId}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
productId:
{
Description: The ID of the product ,
Required: True ,
}
string ,
market:
{
Description: Product market value that will be used to fetch the product and affect the returning result.Possible values can be found at https://docs.microsoft.com/en-us/azure/marketplace/marketplace-geo-availability-currencies. Example: 'US' ,
Required: True ,
}
string ,
includeStopSoldPlans:
{
Description: Indicates whether to include plans that are no longer available for purchase in the response. By default, includeStopSoldPlans is set to FALSE. ,
Required: False ,
}
boolean ,
language:
{
Description: Language to search, ISO 639-1 two-letter code, possible values - 'en,cs,de,es,fr,hu,it,ja,ko,nl,pl,pt-br,pt-pt,ru,sv,tr,id,zh-hans,zh-hant'. Default is "en" ,
Required: False ,
}
string ,
pricingAudience:
{
Description: Direct-Commercial or Partner-Commercial. This value is used to determine the pricing audience for the product. If not specified, the default value is Direct-Commercial. ,
Required: False ,
}
string ,
includeHiddenPlans:
{
Description: Indicates whether to include hidden plans in the response. By default, includeHiddenPlans is set to FALSE. ,
Required: False ,
}
boolean ,
includeServiceInstructionTemplates:
{
Description: Indicates whether to include the product's service instruction templates in the response. By default, includeServiceInstructionTemplates is set to FALSE. ,
Required: False ,
}
boolean ,
planId:
{
Description: Optional to pass the plan id to filter to a specific plan within the product. If not specified, the response will include all plans of the product. ,
Required: False ,
}
string ,
skuId:
{
Description: Optional to pass the sku id to filter to a specific sku within the product. If not specified, the response will include all skus of the product. ,
Required: False ,
}
string ,
}

⚐ Response (200)

{
displayName:
{
Description: Product display name ,
Required: False ,
}
string ,
popularity:
{
Description: Popularity of the product ,
Format: double ,
Required: False ,
}
number ,
categoryIds:
{
Description: Array of product categories ,
Required: False ,
}
[
string ,
]
,
industryIds:
{
Description: List of industry IDs the item belongs to ,
Required: False ,
}
[
string ,
]
,
publisherId:
{
Description: Publisher id ,
Required: False ,
}
string ,
azureBenefit:
{
Description: Indicates whether product purchases count toward Azure consumption commitment benefits for enterprise customers. - `Eligible` - Product costs apply to Azure consumption commitment benefit calculations and credits - `NotEligible` - Product costs do not qualify for Azure consumption commitment benefit programs ,
Required: False ,
}
string ,
badges:
{
Description: Displays certification and qualification badges earned by the product for marketplace visibility. - `PreferredSolution` - Microsoft-recognized solution meeting specific quality and partnership criteria - `PowerBICertified` - Certified compatibility and integration with Microsoft Power BI platform - `AdditionalPurchaseRequirement` - Product requires additional purchases or subscriptions for full functionality ,
Required: False ,
}
[
string ,
]
,
publisherType:
{
Description: Identifies the publisher relationship to Microsoft for support and partnership classification. - `Microsoft` - First-party Microsoft product with direct Microsoft support and development - `ThirdParty` - Independent software vendor product with publisher-provided support and maintenance ,
Required: False ,
}
string ,
publishingStage:
{
Description: Indicates the product availability status and customer access level within Azure Marketplace. - `Preview` - Limited availability to selected customers for testing and early access evaluation - `Public` - General availability to all Azure Marketplace customers for production deployment ,
Required: False ,
}
string ,
uniqueProductId:
{
Description: Unique product identifier ,
Required: True ,
}
string ,
productType:
{
Description: Specifies the primary deployment model and hosting architecture for the marketplace product stored in the Marketplace Catalog. - `None` - Unspecified product type, typically used for products without a defined deployment model - `ManagedApplication` - Azure Managed Applications that deploy and manage resources in customer subscriptions - `VirtualMachine` - Pre-configured virtual machine images deployable to Azure compute infrastructure - `AzureApplication` - Native Azure applications leveraging platform services and APIs - `Container` - Containerized applications deployed through Azure Container Instances or similar services - `SaaS` - Software as a Service solutions hosted and managed by the publisher - `SolutionTemplate` - Azure Resource Manager templates that provision multiple Azure resources - `IotEdgeModules` - Modules designed for deployment to Azure IoT Edge runtime environments - `ManagedServices` - Fully managed services where the publisher handles infrastructure and operations - `ContainerApps` - Applications built for Azure Container Apps serverless container platform - `DynamicsOps` - Microsoft Dynamics 365 Finance and Operations applications and extensions - `DynamicsCE` - Microsoft Dynamics 365 Customer Engagement applications and customizations - `DynamicsBC` - Microsoft Dynamics 365 Business Central applications and add-ons - `PowerBI` - Microsoft Power BI reports, dashboards, and data visualization components - `ConsultingServices` - Professional services offerings including implementation and advisory services - `CosellOnly` - Products available exclusively through Microsoft co-sell partner programs - `CoreVirtualMachine` - Core virtual machine offerings with baseline Azure compute capabilities - `PowerBIVisuals` - Custom visualizations for Microsoft Power BI reporting platform - `Office365` - Microsoft 365 and Office 365 applications, add-ins, and integrations - `AADApps` - Azure Active Directory integrated applications supporting organizational identity - `AzureServices` - Native Azure platform services and resource providers - `AppService` - Web applications hosted on Azure App Service platform - `LogAnalytics` - Azure Monitor Log Analytics solutions and workspace configurations - `MicrosoftProduct` - First-party Microsoft products available through marketplace channels ,
Required: True ,
}
string ,
productSubType:
{
Description: Product sub type ,
Required: False ,
}
string ,
productFamily:
{
Description: Product Family ,
Required: False ,
}
string ,
operatingSystems:
{
Description: Operating system info for this product ,
Required: False ,
}
[
string ,
]
,
pricingTypes:
{
Description: Indicates the billing models and cost structures available for the plan. - `Free` - No charge for plan usage, typically for community editions or basic service tiers - `FreeTrial` - Time-limited free access period before transitioning to paid billing model - `Byol` - Bring Your Own License model where customers provide existing software licenses - `Payg` - Pay As You Go consumption-based billing calculated on actual resource usage - `Ri` - Reserved Instance billing with upfront commitment for discounted long-term pricing ,
Required: False ,
}
[
string ,
]
,
publisherDisplayName:
{
Description: Publisher display name ,
Required: False ,
}
string ,
longSummary:
{
Description: Product long summary ,
Required: False ,
}
string ,
summary:
{
Description: Product summary ,
Required: False ,
}
string ,
smallIconUri:
{
Description: URI to the small product icon ,
Required: False ,
}
string ,
description:
{
Description: The product description text ,
Required: False ,
}
string ,
cspLegalTermsUri:
{
Description: The legal terms of the product for the CSP ,
Required: False ,
}
string ,
privacyPolicyUri:
{
Description: The privacy policy of the product ,
Required: False ,
}
string ,
ratingBuckets:
{
Description: Categorizes products by customer rating thresholds for marketplace filtering and discovery. - `AboveOne` - Products with customer ratings exceeding 1.0 stars based on marketplace reviews - `AboveTwo` - Products with customer ratings exceeding 2.0 stars based on marketplace reviews - `AboveThree` - Products with customer ratings exceeding 3.0 stars based on marketplace reviews - `AboveFour` - Products with customer ratings exceeding 4.0 stars based on marketplace reviews ,
Required: False ,
}
[
string ,
]
,
ratingAverage:
{
Description: Average rating for the offer ,
Format: double ,
Required: False ,
}
number ,
ratingCount:
{
Description: Total number of ratings for the offer ,
Format: int32 ,
Required: False ,
}
integer ,
supportedProducts:
{
Description: Maps to the list of compatible products ,
Required: False ,
}
[
string ,
]
,
applicableProducts:
{
Description: Product categories the offer belongs to ,
Required: False ,
}
[
string ,
]
,
lastModifiedDateTime:
{
Description: Latest update date of the product ,
Required: False ,
}
string ,
locations:
{
Description: List of locations which are available on the SKUs ,
Required: False ,
}
[
string ,
]
,
serviceFamily:
{
Description: The service family of the product, such as 'Compute' ,
Required: False ,
}
string ,
service:
{
Description: The service name of the product, such as 'Virtual Machines' ,
Required: False ,
}
string ,
productId:
{
Description: The unique id of the product ,
Required: False ,
}
string ,
hasRiPlans:
{
Description: Indication whether the product has plans with reservations ,
Required: False ,
}
boolean ,
hasMarketplaceFootprint:
{
Description: Indication if product has a representation in the marketplace ,
Required: False ,
}
boolean ,
attributes:
{
Description: Set of products attributes ,
Required: False ,
}
[
{
key:
{
Description: The attribute key ,
Required: False ,
}
string ,
value:
{
Description: The attribute value ,
Required: False ,
}
string ,
}
,
]
,
videos:
{
Description: List of product videos ,
Required: False ,
}
[
{
caption:
{
Description: Video Caption ,
Required: False ,
}
string ,
uri:
{
Description: Video uri ,
Required: False ,
}
string ,
videoPurpose:
{
Description: Video purpose ,
Required: False ,
}
string ,
previewImage:
{
Description: Preview image ,
Required: False ,
}
{
caption:
{
Description: Image caption ,
Required: False ,
}
string ,
uri:
{
Description: Image uri ,
Required: False ,
}
string ,
imagePurpose:
{
Description: Purpose of the image ,
Required: False ,
}
string ,
}
,
}
,
]
,
images:
{
Description: List of Images ,
Required: False ,
}
[
{
context:
{
Description: Context of the image group ,
Required: False ,
}
string ,
items:
{
Description: List of images ,
Required: False ,
}
[
{
id:
{
Description: Image id ,
Required: False ,
}
string ,
uri:
{
Description: Image uri ,
Required: False ,
}
string ,
type:
{
Description: Image type ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
linkedAddIns:
{
Description: List of linked add ins provided for the item ,
Required: False ,
}
[
string ,
]
,
links:
{
Description: List of Links provided for the item ,
Required: False ,
}
[
{
id:
{
Description: Id of the link ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the link ,
Required: False ,
}
string ,
uri:
{
Description: Uri of the link ,
Required: False ,
}
string ,
}
,
]
,
language:
{
Description: The product language ,
Required: False ,
}
string ,
hasStandardContractAmendments:
{
Description: A value indicating whether standard contract amendments are present ,
Required: False ,
}
boolean ,
offerId:
{
Description: The offer id ,
Required: False ,
}
string ,
standardContractAmendmentsRevisionId:
{
Description: Standard contract amendments for the product ,
Required: False ,
}
string ,
universalAmendmentUrl:
{
Description: The universal amendment link for an enterprise contract ,
Required: False ,
}
string ,
isPrivate:
{
Description: Indicates if a product is private ,
Required: True ,
}
boolean ,
isStopSell:
{
Description: Indicates if a product is no longer available for sale ,
Required: True ,
}
boolean ,
legalTermsUri:
{
Description: Legal terms URI ,
Required: False ,
}
string ,
legalTermsType:
{
Description: Identifies the legal agreement framework governing product licensing and usage terms. - `None` - Standard marketplace terms apply without additional legal agreement requirements - `EA` - Microsoft Enterprise Agreement terms for volume licensing and enterprise customer deployments ,
Required: False ,
}
string ,
supportUri:
{
Description: Support uri of the product ,
Required: False ,
}
string ,
uiDefinitionUri:
{
Description: User interface definition uri ,
Required: False ,
}
string ,
screenshotUris:
{
Description: List of screenshot image URIs ,
Required: False ,
}
[
string ,
]
,
mediumIconUri:
{
Description: URI to the medium product icon ,
Required: False ,
}
string ,
largeIconUri:
{
Description: URI to the large product icon ,
Required: False ,
}
string ,
wideIconUri:
{
Description: URI to the wide product icon ,
Required: False ,
}
string ,
pricingDetailsUri:
{
Description: Pricing details uri of the product ,
Required: False ,
}
string ,
isReseller:
{
Description: A value indicating whether microsoft is acting as a reseller ,
Required: False ,
}
boolean ,
productOwnershipSellingMotion:
{
Description: Product ownership selling motion ,
Required: False ,
}
string ,
disableSendEmailOnPurchase:
{
Description: Indication to disable sending email on purchase ,
Required: False ,
}
boolean ,
isCoreVm:
{
Description: Indicates if VM was originally a Core Virtual Machine ,
Required: False ,
}
boolean ,
stopSellInfo:
{
Description: A StopSellInfo object providing stop sell related data ,
Required: False ,
}
{
startDate:
{
Description: A value indicating when the sale of this item is going to be stopped ,
Format: date-time ,
Required: False ,
}
string ,
reason:
{
Description: Specifies the business or technical justification for discontinuing product sales in the marketplace. - `EndOfSupport` - Product lifecycle has reached end-of-support status with no further updates or maintenance - `SecurityIssue` - Critical security vulnerability or compliance issue requiring immediate sales suspension - `Other` - Alternative business reason not covered by standard discontinuation categories ,
Required: False ,
}
string ,
alternativeOfferId:
{
Description: A value indicating an ID of an alternative offer provided by the same publisher ,
Required: False ,
}
string ,
alternativePlanId:
{
Description: A value indicating an ID of an alternative plan of the same offer ,
Required: False ,
}
string ,
}
,
marketingMaterial:
{
Description: Includes links to the learning and marketing materials as configured by the publisher ,
Required: False ,
}
{
path:
{
Description: Path to the marketing site ,
Required: False ,
}
string ,
learnUri:
{
Description: Path to the learn site ,
Required: False ,
}
string ,
}
,
artifacts:
{
Description: List of artifacts ,
Required: False ,
}
[
{
name:
{
Description: Artifact name ,
Required: False ,
}
string ,
uri:
{
Description: Artifact uri ,
Required: False ,
}
string ,
artifactType:
{
Description: Defines the artifact resource type and its role in the marketplace offering deployment process. - `Template` - Primary Azure Resource Manager template containing the main deployment configuration - `Fragment` - Nested Azure Resource Manager template referenced by the primary template for modular deployments - `Custom` - Publisher-defined artifact with specialized deployment or configuration requirements - `Metadata` - Supplementary information and configuration data supporting the deployment process ,
Required: True ,
}
string ,
}
,
]
,
plans:
{
Description: Full set of plan/SKU attributes ,
Required: False ,
}
[
{
planId:
{
Description: Plan identifier ,
Required: False ,
}
string ,
uniquePlanId:
{
Description: Unique plan identifier which is prefixed by combining uniqueProductId and PlanId with no separator in between ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the plan / sku ,
Required: False ,
}
string ,
vmArchitectureType:
{
Description: Specifies the virtual machine processor architecture and generation. Applies exclusively to Virtual Machine product types. - `X64Gen1` - x64 processor architecture with Generation 1 virtual machine firmware and BIOS support - `X64Gen2` - x64 processor architecture with Generation 2 virtual machine firmware and UEFI support - `Arm64` - ARM 64-bit processor architecture optimized for energy efficiency and cloud-native workloads ,
Required: False ,
}
string ,
cspState:
{
Description: Controls plan availability and partner access within the Microsoft Cloud Solution Provider (CSP) program. - `OptIn` - Enables all authorized Cloud Solution Provider partners to resell and deploy the product to customers - `OptOut` - Excluded from Cloud Solution Provider program, available only through direct channels - `SelectiveOptIn` - Available only to selected Cloud Solution Provider partners for resale and customer deployment ,
Required: False ,
}
string ,
metadata:
{
Description: Expanded plan/SKU metadata. ,
Required: False ,
}
{
generation:
{
Description: The VM image generation (applicable to Virtual Machine products only) ,
Required: False ,
}
string ,
altStackReference:
{
Description: Pointing to a planId which holds the alternative stack reference ,
Required: False ,
}
string ,
}
,
altStackReference:
{
Description: Alternative stack reference ,
Required: False ,
}
string ,
stackType:
{
Description: Stack type : Classic, Gen1, Gen2 ,
Required: False ,
}
string ,
altArchitectureReference:
{
Description: The alternative architecture reference ,
Required: False ,
}
string ,
categoryIds:
{
Description: Plan CategoryIds ,
Required: False ,
}
[
string ,
]
,
hasProtectedArtifacts:
{
Description: Set to true if plan has artifacts that are to be hidden for non authenticated users ,
Required: False ,
}
boolean ,
pricingTypes:
{
Description: Indicates the billing models and cost structures available for the plan. - `Free` - No charge for plan usage, typically for community editions or basic service tiers - `FreeTrial` - Time-limited free access period before transitioning to paid billing model - `Byol` - Bring Your Own License model where customers provide existing software licenses - `Payg` - Pay As You Go consumption-based billing calculated on actual resource usage - `Ri` - Reserved Instance billing with upfront commitment for discounted long-term pricing ,
Required: False ,
}
[
string ,
]
,
vmSecuritytypes:
{
Description: Defines the security enhancement level for virtual machine deployments. Applies exclusively to Virtual Machine product types. - `None` - Standard virtual machine security without additional protection features - `Trusted` - Trusted Launch security with secure boot and virtual Trusted Platform Module capabilities - `Confidential` - Confidential computing with memory encryption and attestation for sensitive workloads ,
Required: False ,
}
[
string ,
]
,
summary:
{
Description: The plan summary text ,
Required: False ,
}
string ,
description:
{
Description: Plan / sku description ,
Required: False ,
}
string ,
skuId:
{
Description: The SKU id ,
Required: False ,
}
string ,
planType:
{
Description: Specifies the primary deployment model and hosting architecture for the marketplace product. Currently supported values are: - `None` - Unspecified product type, typically used for products without a defined deployment model - `DevService` - Development-focused services and tools for software creation workflows - `ManagedApplication` - Azure Managed Applications that deploy and manage resources in customer subscriptions - `VirtualMachine` - Pre-configured virtual machine images deployable to Azure compute infrastructure - `AzureApplication` - Native Azure applications leveraging platform services and APIs - `Container` - Containerized applications deployed through Azure Container Instances or similar services - `SaaS` - Software as a Service solutions hosted and managed by the publisher - `SolutionTemplate` - Azure Resource Manager templates that provision multiple Azure resources - `IotEdgeModules` - Modules designed for deployment to Azure IoT Edge runtime environments - `ManagedServices` - Fully managed services where the publisher handles infrastructure and operations - `ContainerApps` - Applications built for Azure Container Apps serverless container platform - `VisualStudioExtension` - Extensions that integrate with Visual Studio IDE functionality - `DynamicsOps` - Microsoft Dynamics 365 Finance and Operations applications and extensions - `DynamicsCE` - Microsoft Dynamics 365 Customer Engagement applications and customizations - `DynamicsBC` - Microsoft Dynamics 365 Business Central applications and add-ons - `PowerBI` - Microsoft Power BI reports, dashboards, and data visualization components - `ConsultingServices` - Professional services offerings including implementation and advisory services - `CosellOnly` - Products available exclusively through Microsoft co-sell partner programs - `CoreVirtualMachine` - Core virtual machine offerings with baseline Azure compute capabilities - `PowerBIVisuals` - Custom visualizations for Microsoft Power BI reporting platform - `Office365` - Microsoft 365 and Office 365 applications, add-ins, and integrations - `AADApps` - Azure Active Directory integrated applications supporting organizational identity - `AzureServices` - Native Azure platform services and resource providers - `AppService` - Web applications hosted on Azure App Service platform - `LogAnalytics` - Azure Monitor Log Analytics solutions and workspace configurations - `MicrosoftProduct` - First-party Microsoft products available through marketplace channels ,
Required: True ,
}
string ,
displayRank:
{
Description: The order the plan is displayed in the 'Plans' table ,
Required: False ,
}
string ,
isPrivate:
{
Description: Indication that the plan is accessible to restricted audience only ,
Required: False ,
}
boolean ,
hasRi:
{
Description: Indication whether the SKU supports reservations ,
Required: False ,
}
boolean ,
id:
{
Description: The id ,
Required: False ,
}
string ,
availabilities:
{
Description: List of availabilities for this plan ,
Required: False ,
}
[
{
id:
{
Description: The document id ,
Required: False ,
}
string ,
actions:
{
Description: List of allowed actions ,
Required: False ,
}
[
string ,
]
,
meter:
{
Description: Applicable billing meter information ,
Required: False ,
}
{
meterId:
{
Description: Meter id ,
Required: False ,
}
string ,
partNumber:
{
Description: Compute part number ,
Required: False ,
}
string ,
consumptionResourceId:
{
Description: Consumption resource id ,
Required: False ,
}
string ,
price:
{
Description: Retail price with currency ,
Required: False ,
}
{
currencyCode:
{
Description: Currency code i.e. 'USD' ,
Required: False ,
}
string ,
isPiRequired:
{
Description: A value indicating whether a payment instrument is required ,
Required: True ,
}
boolean ,
listPrice:
{
Description: Retail price for the item ,
Format: float ,
Required: True ,
}
number ,
msrp:
{
Description: Manufacturer's suggested retail price for the item ,
Format: float ,
Required: True ,
}
number ,
}
,
type:
{
Description: Type of this meter ,
Required: False ,
}
string ,
includedQuantityProperties:
{
Description: Included quantity properties ,
Required: False ,
}
[
{
termId:
{
Description: Term id ,
Required: False ,
}
string ,
quantity:
{
Description: Included quantity ,
Required: False ,
}
string ,
}
,
]
,
}
,
pricingAudience:
{
Description: Specifies the distribution channel and customer segment for product pricing and availability. Possible values: - `Direct-Commercial` - Available through direct Azure Marketplace purchases for commercial customers without intermediaries like partners or resellers - `Partner-Commercial` - Available through Cloud Solution Provider partner channel for reseller distribution ,
Required: True ,
}
string ,
terms:
{
Description: List of applicable terms ,
Required: False ,
}
[
{
termDescriptionParameters:
{
Description: Term description parameters ,
Required: False ,
}
[
{
parameter:
{
Description: Description parameter ,
Required: False ,
}
string ,
value:
{
Description: Parameter's value ,
Required: False ,
}
string ,
}
,
]
,
termId:
{
Description: Term id ,
Required: False ,
}
string ,
termUnit:
{
Description: Term unit ,
Required: False ,
}
string ,
prorationPolicy:
{
Description: Defines the rules for calculating prorated charges or refunds for a subscription. ,
Required: False ,
}
{
minimumProratedUnits:
{
Description: Minimum prorated units ,
Required: False ,
}
string ,
}
,
termDescription:
{
Description: Term description ,
Required: False ,
}
string ,
price:
{
Description: Retail price with currency ,
Required: False ,
}
{
currencyCode:
{
Description: Currency code i.e. 'USD' ,
Required: False ,
}
string ,
isPiRequired:
{
Description: A value indicating whether a payment instrument is required ,
Required: True ,
}
boolean ,
listPrice:
{
Description: Retail price for the item ,
Format: float ,
Required: True ,
}
number ,
msrp:
{
Description: Manufacturer's suggested retail price for the item ,
Format: float ,
Required: True ,
}
number ,
}
,
renewTermId:
{
Description: Renew term id ,
Required: False ,
}
string ,
renewTermUnits:
{
Description: Renew term units ,
Required: False ,
}
string ,
billingPlan:
{
Description: Billing Plan ,
Required: False ,
}
{
billingPeriod:
{
Description: Billing period ,
Required: False ,
}
string ,
title:
{
Description: Title of the billing plan ,
Required: False ,
}
string ,
description:
{
Description: Description of the billing plan ,
Required: False ,
}
string ,
price:
{
Description: Retail price with currency ,
Required: False ,
}
{
currencyCode:
{
Description: Currency code i.e. 'USD' ,
Required: False ,
}
string ,
isPiRequired:
{
Description: A value indicating whether a payment instrument is required ,
Required: True ,
}
boolean ,
listPrice:
{
Description: Retail price for the item ,
Format: float ,
Required: True ,
}
number ,
msrp:
{
Description: Manufacturer's suggested retail price for the item ,
Format: float ,
Required: True ,
}
number ,
}
,
}
,
renewToTermBillingPlan:
{
Description: Renew Billing Plan ,
Required: False ,
}
string ,
isAutorenewable:
{
Description: Indicates if autorenew is enabled ,
Required: False ,
}
boolean ,
lifecyclePolicy:
{
Description: Defines the lifecycle management policy for the term ,
Required: False ,
}
{
graceDuration:
{
Description: Grace period duration where customers retain access to their product. Examples: 'P1M' (1 month), 'P30D' (30 days), 'P0D' (0 days) ,
Required: False ,
}
string ,
inactiveDuration:
{
Description: Inactive period duration ,
Required: False ,
}
string ,
lockoutDuration:
{
Description: Lockout period duration ,
Required: False ,
}
string ,
}
,
productCode:
{
Description: Product code for this term ,
Required: False ,
}
string ,
state:
{
Description: Term state ,
Required: False ,
}
string ,
actions:
{
Description: Term Actions ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
hasFreeTrials:
{
Description: A value indicating whether it has free trials ,
Required: True ,
}
boolean ,
consumptionUnitType:
{
Description: Consumption unit type ,
Required: False ,
}
string ,
displayRank:
{
Description: Display rank ,
Format: int32 ,
Required: True ,
}
integer ,
}
,
]
,
uiDefinitionUri:
{
Description: What blade to open when someone wants to create a marketplace item ,
Required: False ,
}
string ,
artifacts:
{
Description: Files related to the marketplace item ,
Required: False ,
}
[
{
name:
{
Description: Artifact name ,
Required: False ,
}
string ,
uri:
{
Description: Artifact uri ,
Required: False ,
}
string ,
artifactType:
{
Description: Defines the artifact resource type and its role in the marketplace offering deployment process. - `Template` - Primary Azure Resource Manager template containing the main deployment configuration - `Fragment` - Nested Azure Resource Manager template referenced by the primary template for modular deployments - `Custom` - Publisher-defined artifact with specialized deployment or configuration requirements - `Metadata` - Supplementary information and configuration data supporting the deployment process ,
Required: True ,
}
string ,
}
,
]
,
version:
{
Description: Version of the marketplace item ,
Required: False ,
}
string ,
isHidden:
{
Description: A value indicating whether the plan is hidden ,
Required: True ,
}
boolean ,
isStopSell:
{
Description: A value indicating whether plan has been stopped from selling ,
Required: True ,
}
boolean ,
stopSellInfo:
{
Description: A StopSellInfo object providing stop sell related data ,
Required: False ,
}
{
startDate:
{
Description: A value indicating when the sale of this item is going to be stopped ,
Format: date-time ,
Required: False ,
}
string ,
reason:
{
Description: Specifies the business or technical justification for discontinuing product sales in the marketplace. - `EndOfSupport` - Product lifecycle has reached end-of-support status with no further updates or maintenance - `SecurityIssue` - Critical security vulnerability or compliance issue requiring immediate sales suspension - `Other` - Alternative business reason not covered by standard discontinuation categories ,
Required: False ,
}
string ,
alternativeOfferId:
{
Description: A value indicating an ID of an alternative offer provided by the same publisher ,
Required: False ,
}
string ,
alternativePlanId:
{
Description: A value indicating an ID of an alternative plan of the same offer ,
Required: False ,
}
string ,
}
,
minQuantity:
{
Description: Min quantity ,
Format: int32 ,
Required: False ,
}
integer ,
maxQuantity:
{
Description: Max quantity ,
Format: int32 ,
Required: False ,
}
integer ,
isQuantifiable:
{
Description: A value indicating whether the plan is quantifiable ,
Required: True ,
}
boolean ,
billingComponents:
{
Description: Billing components ,
Required: False ,
}
[
{
billingTag:
{
Description: Billing Tag ,
Required: False ,
}
string ,
}
,
]
,
purchaseDurationDiscounts:
{
Description: List of purchase duration discounts ,
Required: False ,
}
[
{
duration:
{
Description: The duration ,
Required: False ,
}
string ,
discountPercentage:
{
Description: The discount percentage ,
Format: float ,
Required: True ,
}
number ,
}
,
]
,
isHiddenPrivateOffer:
{
Description: A value indicating whether the plan is used as hidden private offer requiring a quote ,
Required: False ,
}
boolean ,
certifications:
{
Description: List of certifications ,
Required: False ,
}
[
{
id:
{
Description: Id of the link ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the link ,
Required: False ,
}
string ,
uri:
{
Description: Uri of the link ,
Required: False ,
}
string ,
}
,
]
,
customerInstruction:
{
Description: Plan's customer instruction for purchasing ,
Required: False ,
}
string ,
planLabels:
{
Description: Plan labels ,
Required: False ,
}
[
string ,
]
,
skuType:
{
Description: SKU type ,
Required: False ,
}
string ,
skuTitle:
{
Description: Sku title localized ,
Required: False ,
}
string ,
location:
{
Description: SKU location ,
Required: False ,
}
string ,
armRegionName:
{
Description: The Arm region name ,
Required: False ,
}
string ,
cloud:
{
Description: Applicable cloud, such as 'Global' ,
Required: False ,
}
string ,
locationType:
{
Description: The location type, such as 'Region' ,
Required: False ,
}
string ,
region:
{
Description: The region ,
Required: False ,
}
string ,
skuGroupId:
{
Description: The sku group id ,
Required: False ,
}
string ,
zone:
{
Description: The zone, such as 'Zone 1' ,
Required: False ,
}
string ,
feature:
{
Description: The feature, such as 'Spot' ,
Required: False ,
}
string ,
serviceType:
{
Description: The service type ,
Required: False ,
}
string ,
skuAttributes:
{
Description: Set of SKU attributes (varies per sku type), where each attribute is represented by a pair of key (attribute name) and value(attribute value) ,
Required: False ,
}
[
{
key:
{
Description: The attribute key ,
Required: False ,
}
string ,
value:
{
Description: The attribute value ,
Required: False ,
}
string ,
}
,
]
,
skuProperties:
{
Description: The sku properties ,
Required: False ,
}
{
category:
{
Description: The sku category ,
Required: False ,
}
string ,
dataDiskType:
{
Description: The data disk type, such as 'Ssd' ,
Required: False ,
}
string ,
diskType:
{
Description: The disk type, such as 'Ssd' ,
Required: False ,
}
string ,
numberOfCores:
{
Description: The number of cores ,
Required: False ,
}
string ,
ram:
{
Description: The RAM ,
Required: False ,
}
string ,
vCpu:
{
Description: The number of virtual CPUs ,
Required: False ,
}
string ,
armSkuName:
{
Description: The ARM SKU name ,
Required: False ,
}
string ,
accessTier:
{
Description: The access tier, such as 'Standard' ,
Required: False ,
}
string ,
}
,
offeringProperties:
{
Description: SKU price related properties. ,
Required: False ,
}
[
{
productCode:
{
Description: The product code (UPN) ,
Required: False ,
}
string ,
termId:
{
Description: The term id ,
Required: False ,
}
string ,
meterType:
{
Description: The meter type ,
Required: False ,
}
string ,
billingMeterId:
{
Description: The billing meter id ,
Required: False ,
}
string ,
offeringId:
{
Description: The offering id ,
Required: False ,
}
string ,
type:
{
Description: Entitlement, Consumption or Reservation ,
Required: False ,
}
string ,
}
,
]
,
hasConsumptionComponents:
{
Description: Indicates if this SKU has consumption components ,
Required: False ,
}
boolean ,
isEndUserEligible:
{
Description: Indicates if this SKU is available for end users ,
Required: False ,
}
boolean ,
isAdminEligible:
{
Description: Indicates if this SKU is available for admins ,
Required: False ,
}
boolean ,
entraIdVersion:
{
Description: The entra id version for products that come with entra id support ,
Required: False ,
}
string ,
technicalRequirements:
{
Description: Technical Requirements ,
Required: False ,
}
string ,
faqUri:
{
Description: The URI to the FAQ page ,
Required: False ,
}
string ,
fulfillmentData:
{
Description: Fulfillment instructions for this SKU ,
Required: False ,
}
{
fulfillmentType:
{
Description: Differentiates between fulfillment types ,
Required: False ,
}
string ,
attributes:
{
Description: Fulfillment attributes ,
Required: False ,
}
{
fulfillmentTiming:
{
Description: Timing configuration for product fulfillment ,
Required: False ,
}
string ,
fulfillmentDelayMitigation:
{
Description: Mitigation explanation for delayed fulfillment ,
Required: False ,
}
string ,
}
,
additionalProducts:
{
Description: Bundled products included defining additional product/SKU combinations ,
Required: False ,
}
[
{
productSkuId:
{
Description: Product and SKU ID for bundled products included with the license ,
Required: False ,
}
string ,
defaultKeyActivationCount:
{
Description: Quantity of the bundled product per license ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
benefits:
{
Description: Provides promotion data ,
Required: False ,
}
[
{
benefitType:
{
Description: Benefit type ,
Required: False ,
}
string ,
basePlanId:
{
Description: Base plan ID ,
Required: False ,
}
string ,
billingPlan:
{
Description: Billing plan ,
Required: False ,
}
string ,
termDuration:
{
Description: Term duration. Examples: 'P1M' (1 month), 'P30D' (30 days) ,
Required: False ,
}
string ,
}
,
]
,
constraintsData:
{
Description: Contains constraint product properties to determine eligibility ,
Required: False ,
}
{
seatConstraints:
{
Description: Seat constraint configurations defining minimum and maximum seat limits ,
Required: False ,
}
[
{
type:
{
Description: Constraint type ,
Required: False ,
}
string ,
minSeats:
{
Description: Minimum seats ,
Format: int32 ,
Required: False ,
}
integer ,
maxSeats:
{
Description: Maximum seats ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
assetOwnershipLimits:
{
Description: Asset ownership limits ,
Required: False ,
}
[
{
type:
{
Description: Limit type ,
Required: False ,
}
string ,
minAssets:
{
Description: Minimum number of assets ,
Format: int32 ,
Required: False ,
}
integer ,
maxAssets:
{
Description: Maximum number of assets ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
prerequisiteSkus:
{
Description: Lists eligible prerequisite SKUs ,
Required: False ,
}
{
mustHaveAll:
{
Description: Prerequisite sets where all specified SKUs must be owned ,
Required: False ,
}
[
{
productId:
{
Description: Product ID ,
Required: False ,
}
string ,
skuIds:
{
Description: SKU IDs ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
mustHaveAny:
{
Description: Prerequisite sets where any one of the specified SKUs must be owned ,
Required: False ,
}
[
{
productId:
{
Description: Product ID ,
Required: False ,
}
string ,
skuIds:
{
Description: SKU IDs ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
seatConstraints:
{
Description: Percentage-based seat constraints for prerequisite SKUs ,
Required: False ,
}
[
{
type:
{
Description: Constraint type ,
Required: False ,
}
string ,
minPercentSeats:
{
Description: Minimum percent seats ,
Format: double ,
Required: False ,
}
number ,
maxPercentSeats:
{
Description: Maximum percent seats ,
Format: double ,
Required: False ,
}
number ,
}
,
]
,
}
,
}
,
meterTypeDescriptions:
{
Description: Meter type descriptions ,
Required: False ,
}
[
{
key:
{
Description: Meter Type Description key ,
Required: False ,
}
string ,
value:
{
Description: Meter type description value ,
Required: False ,
}
{
meterType:
{
Description: The type of meter ,
Required: False ,
}
string ,
unitOfMeasure:
{
Description: The unit of measurement for the meter ,
Required: False ,
}
string ,
}
,
}
,
]
,
usageUnit:
{
Description: Usage unit ,
Required: False ,
}
string ,
skuName:
{
Description: Sku name ,
Required: False ,
}
string ,
}
,
]
,
hasAddOns:
{
Description: Indicates that the SKU has add-ons ,
Required: False ,
}
boolean ,
}

⚐ Response (default)

{
error:
{
Description: The error details object ,
Required: True ,
}
{
code:
{
Description: The HTTP error code ,
Required: True ,
}
string ,
message:
{
Description: The error message ,
Required: True ,
}
string ,
}
,
}
ProductGet_GetBySubscription (updated)
Description :  Gets a single product by subscription.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProductGet_GetBySubscription",
  "$responses": {
    "200": {
      "$properties": {
        "plans": {
          "$properties": {
            "availabilities": {
              "$properties": {
                "terms": {
                  "$properties": {
                    "@added_4885382428f742bcace846151d80f8c3": {
                      "#name": "lifecyclePolicy",
                      "Description": "Defines the lifecycle management policy for the term",
                      "Required": false,
                      "Type": "object",
                      "$properties": [
                        {
                          "#name": "graceDuration",
                          "Description": "Grace period duration where customers retain access to their product. Examples: 'P1M' (1 month), 'P30D' (30 days), 'P0D' (0 days)",
                          "Required": false,
                          "Type": "string"
                        },
                        {
                          "#name": "inactiveDuration",
                          "Description": "Inactive period duration",
                          "Required": false,
                          "Type": "string"
                        },
                        {
                          "#name": "lockoutDuration",
                          "Description": "Lockout period duration",
                          "Required": false,
                          "Type": "string"
                        }
                      ]
                    },
                    "@added_c0e72f27240f4a339344f05d26a9b654": {
                      "#name": "productCode",
                      "Description": "Product code for this term",
                      "Required": false,
                      "Type": "string"
                    },
                    "@added_003e510aeb6b425ea475f2513741bd01": {
                      "#name": "state",
                      "Description": "Term state",
                      "Required": false,
                      "Type": "string"
                    },
                    "@added_2134fa2b44ee4ebdb50776105455ef8a": {
                      "#name": "actions",
                      "Description": "Term Actions",
                      "Required": false,
                      "Type": "array",
                      "$items": {
                        "Type": "string"
                      }
                    }
                  }
                }
              }
            },
            "@added_ad554fbee2ba4538a2e01f1ecf2a0f67": {
              "#name": "hasConsumptionComponents",
              "Description": "Indicates if this SKU has consumption components",
              "Required": false,
              "Type": "boolean"
            },
            "@added_8ba79da09f7b4f89aba2856b4713ee65": {
              "#name": "isEndUserEligible",
              "Description": "Indicates if this SKU is available for end users",
              "Required": false,
              "Type": "boolean"
            },
            "@added_4f771b4ef9bc48fa80975477f69f75d8": {
              "#name": "isAdminEligible",
              "Description": "Indicates if this SKU is available for admins",
              "Required": false,
              "Type": "boolean"
            },
            "@added_2bbb13ff092f4df7bf55d966476aef73": {
              "#name": "entraIdVersion",
              "Description": "The entra id version for products that come with entra id support",
              "Required": false,
              "Type": "string"
            },
            "@added_a1f737028e064a9f95e6ff59ddf07545": {
              "#name": "technicalRequirements",
              "Description": "Technical Requirements",
              "Required": false,
              "Type": "string"
            },
            "@added_b54e321ddc4d46a0a6e1d251ba98ca02": {
              "#name": "faqUri",
              "Description": "The URI to the FAQ page",
              "Required": false,
              "Type": "string"
            },
            "@added_9a602db0a61a46dbac954f412e9b90d0": {
              "#name": "fulfillmentData",
              "Description": "Fulfillment instructions for this SKU",
              "Required": false,
              "Type": "object",
              "$properties": [
                {
                  "#name": "fulfillmentType",
                  "Description": "Differentiates between fulfillment types",
                  "Required": false,
                  "Type": "string"
                },
                {
                  "#name": "attributes",
                  "Description": "Fulfillment attributes",
                  "Required": false,
                  "Type": "object",
                  "$properties": [
                    {
                      "#name": "fulfillmentTiming",
                      "Description": "Timing configuration for product fulfillment",
                      "Required": false,
                      "Type": "string"
                    },
                    {
                      "#name": "fulfillmentDelayMitigation",
                      "Description": "Mitigation explanation for delayed fulfillment",
                      "Required": false,
                      "Type": "string"
                    }
                  ]
                },
                {
                  "#name": "additionalProducts",
                  "Description": "Bundled products included defining additional product/SKU combinations",
                  "Required": false,
                  "Type": "array",
                  "$items": {
                    "Description": "Configuration for additional products bundled with early access pass SKUs",
                    "Type": "object",
                    "$properties": [
                      {
                        "#name": "productSkuId",
                        "Description": "Product and SKU ID for bundled products included with the license",
                        "Required": false,
                        "Type": "string"
                      },
                      {
                        "#name": "defaultKeyActivationCount",
                        "Description": "Quantity of the bundled product per license ",
                        "Format": "int32",
                        "Required": false,
                        "Type": "integer"
                      }
                    ]
                  }
                }
              ]
            },
            "@added_a19416dcbf5747ebb6bfb01af4b32697": {
              "#name": "benefits",
              "Description": "Provides promotion data",
              "Required": false,
              "Type": "array",
              "$items": {
                "Description": "Benefit information for a plan",
                "Type": "object",
                "$properties": [
                  {
                    "#name": "benefitType",
                    "Description": "Benefit type",
                    "Required": false,
                    "Type": "string"
                  },
                  {
                    "#name": "basePlanId",
                    "Description": "Base plan ID",
                    "Required": false,
                    "Type": "string"
                  },
                  {
                    "#name": "billingPlan",
                    "Description": "Billing plan",
                    "Required": false,
                    "Type": "string"
                  },
                  {
                    "#name": "termDuration",
                    "Description": "Term duration. Examples: 'P1M' (1 month), 'P30D' (30 days)",
                    "Required": false,
                    "Type": "string"
                  }
                ]
              }
            },
            "@added_ab10088006a04fb49d514fc418763353": {
              "#name": "constraintsData",
              "Description": "Contains constraint product properties to determine eligibility",
              "Required": false,
              "Type": "object",
              "$properties": [
                {
                  "#name": "seatConstraints",
                  "Description": "Seat constraint configurations defining minimum and maximum seat limits",
                  "Required": false,
                  "Type": "array",
                  "$items": {
                    "Description": "Defines minimum and maximum seat limits for a specific constraint type",
                    "Type": "object",
                    "$properties": [
                      {
                        "#name": "type",
                        "Description": "Constraint type",
                        "Required": false,
                        "Type": "string"
                      },
                      {
                        "#name": "minSeats",
                        "Description": "Minimum seats",
                        "Format": "int32",
                        "Required": false,
                        "Type": "integer"
                      },
                      {
                        "#name": "maxSeats",
                        "Description": "Maximum seats",
                        "Format": "int32",
                        "Required": false,
                        "Type": "integer"
                      }
                    ]
                  }
                },
                {
                  "#name": "assetOwnershipLimits",
                  "Description": "Asset ownership limits",
                  "Required": false,
                  "Type": "array",
                  "$items": {
                    "Description": "Defines ownership restrictions and limits for SKU assets",
                    "Type": "object",
                    "$properties": [
                      {
                        "#name": "type",
                        "Description": "Limit type",
                        "Required": false,
                        "Type": "string"
                      },
                      {
                        "#name": "minAssets",
                        "Description": "Minimum number of assets",
                        "Format": "int32",
                        "Required": false,
                        "Type": "integer"
                      },
                      {
                        "#name": "maxAssets",
                        "Description": "Maximum number of assets",
                        "Format": "int32",
                        "Required": false,
                        "Type": "integer"
                      }
                    ]
                  }
                },
                {
                  "#name": "prerequisiteSkus",
                  "Description": "Lists eligible prerequisite SKUs",
                  "Required": false,
                  "Type": "object",
                  "$properties": [
                    {
                      "#name": "mustHaveAll",
                      "Description": "Prerequisite sets where all specified SKUs must be owned",
                      "Required": false,
                      "Type": "array",
                      "$items": {
                        "Description": "Prerequisite set",
                        "Type": "object",
                        "$properties": [
                          {
                            "#name": "productId",
                            "Description": "Product ID",
                            "Required": false,
                            "Type": "string"
                          },
                          {
                            "#name": "skuIds",
                            "Description": "SKU IDs",
                            "Required": false,
                            "Type": "array",
                            "$items": {
                              "Type": "string"
                            }
                          }
                        ]
                      }
                    },
                    {
                      "#name": "mustHaveAny",
                      "Description": "Prerequisite sets where any one of the specified SKUs must be owned",
                      "Required": false,
                      "Type": "array",
                      "$items": {
                        "Description": "Prerequisite set",
                        "Type": "object",
                        "$properties": [
                          {
                            "#name": "productId",
                            "Description": "Product ID",
                            "Required": false,
                            "Type": "string"
                          },
                          {
                            "#name": "skuIds",
                            "Description": "SKU IDs",
                            "Required": false,
                            "Type": "array",
                            "$items": {
                              "Type": "string"
                            }
                          }
                        ]
                      }
                    },
                    {
                      "#name": "seatConstraints",
                      "Description": "Percentage-based seat constraints for prerequisite SKUs",
                      "Required": false,
                      "Type": "array",
                      "$items": {
                        "Description": "Minimum and maximum percentage seats constraint",
                        "Type": "object",
                        "$properties": [
                          {
                            "#name": "type",
                            "Description": "Constraint type",
                            "Required": false,
                            "Type": "string"
                          },
                          {
                            "#name": "minPercentSeats",
                            "Description": "Minimum percent seats",
                            "Format": "double",
                            "Required": false,
                            "Type": "number"
                          },
                          {
                            "#name": "maxPercentSeats",
                            "Description": "Maximum percent seats",
                            "Format": "double",
                            "Required": false,
                            "Type": "number"
                          }
                        ]
                      }
                    }
                  ]
                }
              ]
            },
            "@added_19af03fc523e400b803826719ae03937": {
              "#name": "meterTypeDescriptions",
              "Description": "Meter type descriptions",
              "Required": false,
              "Type": "array",
              "$items": {
                "Description": "Meter type description",
                "Type": "object",
                "$properties": [
                  {
                    "#name": "key",
                    "Description": "Meter Type Description key",
                    "Required": false,
                    "Type": "string"
                  },
                  {
                    "#name": "value",
                    "Description": "Meter type description value",
                    "Required": false,
                    "Type": "object",
                    "$properties": [
                      {
                        "#name": "meterType",
                        "Description": "The type of meter",
                        "Required": false,
                        "Type": "string"
                      },
                      {
                        "#name": "unitOfMeasure",
                        "Description": "The unit of measurement for the meter",
                        "Required": false,
                        "Type": "string"
                      }
                    ]
                  }
                ]
              }
            },
            "@added_cd3067e48c0e486ca95469f7143331e4": {
              "#name": "usageUnit",
              "Description": "Usage unit",
              "Required": false,
              "Type": "string"
            },
            "@added_f6788a9e07464fa7bb2730ffc593e82e": {
              "#name": "skuName",
              "Description": "Sku name",
              "Required": false,
              "Type": "string"
            }
          }
        },
        "@added_156961e36e944d51b956cce12ff63dde": {
          "#name": "hasAddOns",
          "Description": "Indicates that the SKU has add-ons",
          "Required": false,
          "Type": "boolean"
        }
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.Marketplace/products/{productId}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
productId:
{
Description: The ID of the product ,
Required: True ,
}
string ,
includeStopSoldPlans:
{
Description: Indicates whether to include plans that are no longer available for purchase in the response. By default, includeStopSoldPlans is set to FALSE. ,
Required: False ,
}
boolean ,
language:
{
Description: Language to search, ISO 639-1 two-letter code, possible values - 'en,cs,de,es,fr,hu,it,ja,ko,nl,pl,pt-br,pt-pt,ru,sv,tr,id,zh-hans,zh-hant'. Default is "en" ,
Required: False ,
}
string ,
includeHiddenPlans:
{
Description: Indicates whether to include hidden plans in the response. By default, includeHiddenPlans is set to FALSE. ,
Required: False ,
}
boolean ,
includeServiceInstructionTemplates:
{
Description: Indicates whether to include the product's service instruction templates in the response. By default, includeServiceInstructionTemplates is set to FALSE. ,
Required: False ,
}
boolean ,
planId:
{
Description: Optional to pass the plan id to filter to a specific plan within the product. If not specified, the response will include all plans of the product. ,
Required: False ,
}
string ,
skuId:
{
Description: Optional to pass the sku id to filter to a specific sku within the product. If not specified, the response will include all skus of the product. ,
Required: False ,
}
string ,
lookUpOfferInTenantLevel:
{
Description: Indicates whether to use the tenant in context to fetch the product. By default, lookUpOfferInTenantLevel is set to FALSE. ,
Required: False ,
}
boolean ,
}

⚐ Response (200)

{
displayName:
{
Description: Product display name ,
Required: False ,
}
string ,
popularity:
{
Description: Popularity of the product ,
Format: double ,
Required: False ,
}
number ,
categoryIds:
{
Description: Array of product categories ,
Required: False ,
}
[
string ,
]
,
industryIds:
{
Description: List of industry IDs the item belongs to ,
Required: False ,
}
[
string ,
]
,
publisherId:
{
Description: Publisher id ,
Required: False ,
}
string ,
azureBenefit:
{
Description: Indicates whether product purchases count toward Azure consumption commitment benefits for enterprise customers. - `Eligible` - Product costs apply to Azure consumption commitment benefit calculations and credits - `NotEligible` - Product costs do not qualify for Azure consumption commitment benefit programs ,
Required: False ,
}
string ,
badges:
{
Description: Displays certification and qualification badges earned by the product for marketplace visibility. - `PreferredSolution` - Microsoft-recognized solution meeting specific quality and partnership criteria - `PowerBICertified` - Certified compatibility and integration with Microsoft Power BI platform - `AdditionalPurchaseRequirement` - Product requires additional purchases or subscriptions for full functionality ,
Required: False ,
}
[
string ,
]
,
publisherType:
{
Description: Identifies the publisher relationship to Microsoft for support and partnership classification. - `Microsoft` - First-party Microsoft product with direct Microsoft support and development - `ThirdParty` - Independent software vendor product with publisher-provided support and maintenance ,
Required: False ,
}
string ,
publishingStage:
{
Description: Indicates the product availability status and customer access level within Azure Marketplace. - `Preview` - Limited availability to selected customers for testing and early access evaluation - `Public` - General availability to all Azure Marketplace customers for production deployment ,
Required: False ,
}
string ,
uniqueProductId:
{
Description: Unique product identifier ,
Required: True ,
}
string ,
productType:
{
Description: Specifies the primary deployment model and hosting architecture for the marketplace product stored in the Marketplace Catalog. - `None` - Unspecified product type, typically used for products without a defined deployment model - `ManagedApplication` - Azure Managed Applications that deploy and manage resources in customer subscriptions - `VirtualMachine` - Pre-configured virtual machine images deployable to Azure compute infrastructure - `AzureApplication` - Native Azure applications leveraging platform services and APIs - `Container` - Containerized applications deployed through Azure Container Instances or similar services - `SaaS` - Software as a Service solutions hosted and managed by the publisher - `SolutionTemplate` - Azure Resource Manager templates that provision multiple Azure resources - `IotEdgeModules` - Modules designed for deployment to Azure IoT Edge runtime environments - `ManagedServices` - Fully managed services where the publisher handles infrastructure and operations - `ContainerApps` - Applications built for Azure Container Apps serverless container platform - `DynamicsOps` - Microsoft Dynamics 365 Finance and Operations applications and extensions - `DynamicsCE` - Microsoft Dynamics 365 Customer Engagement applications and customizations - `DynamicsBC` - Microsoft Dynamics 365 Business Central applications and add-ons - `PowerBI` - Microsoft Power BI reports, dashboards, and data visualization components - `ConsultingServices` - Professional services offerings including implementation and advisory services - `CosellOnly` - Products available exclusively through Microsoft co-sell partner programs - `CoreVirtualMachine` - Core virtual machine offerings with baseline Azure compute capabilities - `PowerBIVisuals` - Custom visualizations for Microsoft Power BI reporting platform - `Office365` - Microsoft 365 and Office 365 applications, add-ins, and integrations - `AADApps` - Azure Active Directory integrated applications supporting organizational identity - `AzureServices` - Native Azure platform services and resource providers - `AppService` - Web applications hosted on Azure App Service platform - `LogAnalytics` - Azure Monitor Log Analytics solutions and workspace configurations - `MicrosoftProduct` - First-party Microsoft products available through marketplace channels ,
Required: True ,
}
string ,
productSubType:
{
Description: Product sub type ,
Required: False ,
}
string ,
productFamily:
{
Description: Product Family ,
Required: False ,
}
string ,
operatingSystems:
{
Description: Operating system info for this product ,
Required: False ,
}
[
string ,
]
,
pricingTypes:
{
Description: Indicates the billing models and cost structures available for the plan. - `Free` - No charge for plan usage, typically for community editions or basic service tiers - `FreeTrial` - Time-limited free access period before transitioning to paid billing model - `Byol` - Bring Your Own License model where customers provide existing software licenses - `Payg` - Pay As You Go consumption-based billing calculated on actual resource usage - `Ri` - Reserved Instance billing with upfront commitment for discounted long-term pricing ,
Required: False ,
}
[
string ,
]
,
publisherDisplayName:
{
Description: Publisher display name ,
Required: False ,
}
string ,
longSummary:
{
Description: Product long summary ,
Required: False ,
}
string ,
summary:
{
Description: Product summary ,
Required: False ,
}
string ,
smallIconUri:
{
Description: URI to the small product icon ,
Required: False ,
}
string ,
description:
{
Description: The product description text ,
Required: False ,
}
string ,
cspLegalTermsUri:
{
Description: The legal terms of the product for the CSP ,
Required: False ,
}
string ,
privacyPolicyUri:
{
Description: The privacy policy of the product ,
Required: False ,
}
string ,
ratingBuckets:
{
Description: Categorizes products by customer rating thresholds for marketplace filtering and discovery. - `AboveOne` - Products with customer ratings exceeding 1.0 stars based on marketplace reviews - `AboveTwo` - Products with customer ratings exceeding 2.0 stars based on marketplace reviews - `AboveThree` - Products with customer ratings exceeding 3.0 stars based on marketplace reviews - `AboveFour` - Products with customer ratings exceeding 4.0 stars based on marketplace reviews ,
Required: False ,
}
[
string ,
]
,
ratingAverage:
{
Description: Average rating for the offer ,
Format: double ,
Required: False ,
}
number ,
ratingCount:
{
Description: Total number of ratings for the offer ,
Format: int32 ,
Required: False ,
}
integer ,
supportedProducts:
{
Description: Maps to the list of compatible products ,
Required: False ,
}
[
string ,
]
,
applicableProducts:
{
Description: Product categories the offer belongs to ,
Required: False ,
}
[
string ,
]
,
lastModifiedDateTime:
{
Description: Latest update date of the product ,
Required: False ,
}
string ,
locations:
{
Description: List of locations which are available on the SKUs ,
Required: False ,
}
[
string ,
]
,
serviceFamily:
{
Description: The service family of the product, such as 'Compute' ,
Required: False ,
}
string ,
service:
{
Description: The service name of the product, such as 'Virtual Machines' ,
Required: False ,
}
string ,
productId:
{
Description: The unique id of the product ,
Required: False ,
}
string ,
hasRiPlans:
{
Description: Indication whether the product has plans with reservations ,
Required: False ,
}
boolean ,
hasMarketplaceFootprint:
{
Description: Indication if product has a representation in the marketplace ,
Required: False ,
}
boolean ,
attributes:
{
Description: Set of products attributes ,
Required: False ,
}
[
{
key:
{
Description: The attribute key ,
Required: False ,
}
string ,
value:
{
Description: The attribute value ,
Required: False ,
}
string ,
}
,
]
,
videos:
{
Description: List of product videos ,
Required: False ,
}
[
{
caption:
{
Description: Video Caption ,
Required: False ,
}
string ,
uri:
{
Description: Video uri ,
Required: False ,
}
string ,
videoPurpose:
{
Description: Video purpose ,
Required: False ,
}
string ,
previewImage:
{
Description: Preview image ,
Required: False ,
}
{
caption:
{
Description: Image caption ,
Required: False ,
}
string ,
uri:
{
Description: Image uri ,
Required: False ,
}
string ,
imagePurpose:
{
Description: Purpose of the image ,
Required: False ,
}
string ,
}
,
}
,
]
,
images:
{
Description: List of Images ,
Required: False ,
}
[
{
context:
{
Description: Context of the image group ,
Required: False ,
}
string ,
items:
{
Description: List of images ,
Required: False ,
}
[
{
id:
{
Description: Image id ,
Required: False ,
}
string ,
uri:
{
Description: Image uri ,
Required: False ,
}
string ,
type:
{
Description: Image type ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
linkedAddIns:
{
Description: List of linked add ins provided for the item ,
Required: False ,
}
[
string ,
]
,
links:
{
Description: List of Links provided for the item ,
Required: False ,
}
[
{
id:
{
Description: Id of the link ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the link ,
Required: False ,
}
string ,
uri:
{
Description: Uri of the link ,
Required: False ,
}
string ,
}
,
]
,
language:
{
Description: The product language ,
Required: False ,
}
string ,
hasStandardContractAmendments:
{
Description: A value indicating whether standard contract amendments are present ,
Required: False ,
}
boolean ,
offerId:
{
Description: The offer id ,
Required: False ,
}
string ,
standardContractAmendmentsRevisionId:
{
Description: Standard contract amendments for the product ,
Required: False ,
}
string ,
universalAmendmentUrl:
{
Description: The universal amendment link for an enterprise contract ,
Required: False ,
}
string ,
isPrivate:
{
Description: Indicates if a product is private ,
Required: True ,
}
boolean ,
isStopSell:
{
Description: Indicates if a product is no longer available for sale ,
Required: True ,
}
boolean ,
legalTermsUri:
{
Description: Legal terms URI ,
Required: False ,
}
string ,
legalTermsType:
{
Description: Identifies the legal agreement framework governing product licensing and usage terms. - `None` - Standard marketplace terms apply without additional legal agreement requirements - `EA` - Microsoft Enterprise Agreement terms for volume licensing and enterprise customer deployments ,
Required: False ,
}
string ,
supportUri:
{
Description: Support uri of the product ,
Required: False ,
}
string ,
uiDefinitionUri:
{
Description: User interface definition uri ,
Required: False ,
}
string ,
screenshotUris:
{
Description: List of screenshot image URIs ,
Required: False ,
}
[
string ,
]
,
mediumIconUri:
{
Description: URI to the medium product icon ,
Required: False ,
}
string ,
largeIconUri:
{
Description: URI to the large product icon ,
Required: False ,
}
string ,
wideIconUri:
{
Description: URI to the wide product icon ,
Required: False ,
}
string ,
pricingDetailsUri:
{
Description: Pricing details uri of the product ,
Required: False ,
}
string ,
isReseller:
{
Description: A value indicating whether microsoft is acting as a reseller ,
Required: False ,
}
boolean ,
productOwnershipSellingMotion:
{
Description: Product ownership selling motion ,
Required: False ,
}
string ,
disableSendEmailOnPurchase:
{
Description: Indication to disable sending email on purchase ,
Required: False ,
}
boolean ,
isCoreVm:
{
Description: Indicates if VM was originally a Core Virtual Machine ,
Required: False ,
}
boolean ,
stopSellInfo:
{
Description: A StopSellInfo object providing stop sell related data ,
Required: False ,
}
{
startDate:
{
Description: A value indicating when the sale of this item is going to be stopped ,
Format: date-time ,
Required: False ,
}
string ,
reason:
{
Description: Specifies the business or technical justification for discontinuing product sales in the marketplace. - `EndOfSupport` - Product lifecycle has reached end-of-support status with no further updates or maintenance - `SecurityIssue` - Critical security vulnerability or compliance issue requiring immediate sales suspension - `Other` - Alternative business reason not covered by standard discontinuation categories ,
Required: False ,
}
string ,
alternativeOfferId:
{
Description: A value indicating an ID of an alternative offer provided by the same publisher ,
Required: False ,
}
string ,
alternativePlanId:
{
Description: A value indicating an ID of an alternative plan of the same offer ,
Required: False ,
}
string ,
}
,
marketingMaterial:
{
Description: Includes links to the learning and marketing materials as configured by the publisher ,
Required: False ,
}
{
path:
{
Description: Path to the marketing site ,
Required: False ,
}
string ,
learnUri:
{
Description: Path to the learn site ,
Required: False ,
}
string ,
}
,
artifacts:
{
Description: List of artifacts ,
Required: False ,
}
[
{
name:
{
Description: Artifact name ,
Required: False ,
}
string ,
uri:
{
Description: Artifact uri ,
Required: False ,
}
string ,
artifactType:
{
Description: Defines the artifact resource type and its role in the marketplace offering deployment process. - `Template` - Primary Azure Resource Manager template containing the main deployment configuration - `Fragment` - Nested Azure Resource Manager template referenced by the primary template for modular deployments - `Custom` - Publisher-defined artifact with specialized deployment or configuration requirements - `Metadata` - Supplementary information and configuration data supporting the deployment process ,
Required: True ,
}
string ,
}
,
]
,
plans:
{
Description: Full set of plan/SKU attributes ,
Required: False ,
}
[
{
planId:
{
Description: Plan identifier ,
Required: False ,
}
string ,
uniquePlanId:
{
Description: Unique plan identifier which is prefixed by combining uniqueProductId and PlanId with no separator in between ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the plan / sku ,
Required: False ,
}
string ,
vmArchitectureType:
{
Description: Specifies the virtual machine processor architecture and generation. Applies exclusively to Virtual Machine product types. - `X64Gen1` - x64 processor architecture with Generation 1 virtual machine firmware and BIOS support - `X64Gen2` - x64 processor architecture with Generation 2 virtual machine firmware and UEFI support - `Arm64` - ARM 64-bit processor architecture optimized for energy efficiency and cloud-native workloads ,
Required: False ,
}
string ,
cspState:
{
Description: Controls plan availability and partner access within the Microsoft Cloud Solution Provider (CSP) program. - `OptIn` - Enables all authorized Cloud Solution Provider partners to resell and deploy the product to customers - `OptOut` - Excluded from Cloud Solution Provider program, available only through direct channels - `SelectiveOptIn` - Available only to selected Cloud Solution Provider partners for resale and customer deployment ,
Required: False ,
}
string ,
metadata:
{
Description: Expanded plan/SKU metadata. ,
Required: False ,
}
{
generation:
{
Description: The VM image generation (applicable to Virtual Machine products only) ,
Required: False ,
}
string ,
altStackReference:
{
Description: Pointing to a planId which holds the alternative stack reference ,
Required: False ,
}
string ,
}
,
altStackReference:
{
Description: Alternative stack reference ,
Required: False ,
}
string ,
stackType:
{
Description: Stack type : Classic, Gen1, Gen2 ,
Required: False ,
}
string ,
altArchitectureReference:
{
Description: The alternative architecture reference ,
Required: False ,
}
string ,
categoryIds:
{
Description: Plan CategoryIds ,
Required: False ,
}
[
string ,
]
,
hasProtectedArtifacts:
{
Description: Set to true if plan has artifacts that are to be hidden for non authenticated users ,
Required: False ,
}
boolean ,
pricingTypes:
{
Description: Indicates the billing models and cost structures available for the plan. - `Free` - No charge for plan usage, typically for community editions or basic service tiers - `FreeTrial` - Time-limited free access period before transitioning to paid billing model - `Byol` - Bring Your Own License model where customers provide existing software licenses - `Payg` - Pay As You Go consumption-based billing calculated on actual resource usage - `Ri` - Reserved Instance billing with upfront commitment for discounted long-term pricing ,
Required: False ,
}
[
string ,
]
,
vmSecuritytypes:
{
Description: Defines the security enhancement level for virtual machine deployments. Applies exclusively to Virtual Machine product types. - `None` - Standard virtual machine security without additional protection features - `Trusted` - Trusted Launch security with secure boot and virtual Trusted Platform Module capabilities - `Confidential` - Confidential computing with memory encryption and attestation for sensitive workloads ,
Required: False ,
}
[
string ,
]
,
summary:
{
Description: The plan summary text ,
Required: False ,
}
string ,
description:
{
Description: Plan / sku description ,
Required: False ,
}
string ,
skuId:
{
Description: The SKU id ,
Required: False ,
}
string ,
planType:
{
Description: Specifies the primary deployment model and hosting architecture for the marketplace product. Currently supported values are: - `None` - Unspecified product type, typically used for products without a defined deployment model - `DevService` - Development-focused services and tools for software creation workflows - `ManagedApplication` - Azure Managed Applications that deploy and manage resources in customer subscriptions - `VirtualMachine` - Pre-configured virtual machine images deployable to Azure compute infrastructure - `AzureApplication` - Native Azure applications leveraging platform services and APIs - `Container` - Containerized applications deployed through Azure Container Instances or similar services - `SaaS` - Software as a Service solutions hosted and managed by the publisher - `SolutionTemplate` - Azure Resource Manager templates that provision multiple Azure resources - `IotEdgeModules` - Modules designed for deployment to Azure IoT Edge runtime environments - `ManagedServices` - Fully managed services where the publisher handles infrastructure and operations - `ContainerApps` - Applications built for Azure Container Apps serverless container platform - `VisualStudioExtension` - Extensions that integrate with Visual Studio IDE functionality - `DynamicsOps` - Microsoft Dynamics 365 Finance and Operations applications and extensions - `DynamicsCE` - Microsoft Dynamics 365 Customer Engagement applications and customizations - `DynamicsBC` - Microsoft Dynamics 365 Business Central applications and add-ons - `PowerBI` - Microsoft Power BI reports, dashboards, and data visualization components - `ConsultingServices` - Professional services offerings including implementation and advisory services - `CosellOnly` - Products available exclusively through Microsoft co-sell partner programs - `CoreVirtualMachine` - Core virtual machine offerings with baseline Azure compute capabilities - `PowerBIVisuals` - Custom visualizations for Microsoft Power BI reporting platform - `Office365` - Microsoft 365 and Office 365 applications, add-ins, and integrations - `AADApps` - Azure Active Directory integrated applications supporting organizational identity - `AzureServices` - Native Azure platform services and resource providers - `AppService` - Web applications hosted on Azure App Service platform - `LogAnalytics` - Azure Monitor Log Analytics solutions and workspace configurations - `MicrosoftProduct` - First-party Microsoft products available through marketplace channels ,
Required: True ,
}
string ,
displayRank:
{
Description: The order the plan is displayed in the 'Plans' table ,
Required: False ,
}
string ,
isPrivate:
{
Description: Indication that the plan is accessible to restricted audience only ,
Required: False ,
}
boolean ,
hasRi:
{
Description: Indication whether the SKU supports reservations ,
Required: False ,
}
boolean ,
id:
{
Description: The id ,
Required: False ,
}
string ,
availabilities:
{
Description: List of availabilities for this plan ,
Required: False ,
}
[
{
id:
{
Description: The document id ,
Required: False ,
}
string ,
actions:
{
Description: List of allowed actions ,
Required: False ,
}
[
string ,
]
,
meter:
{
Description: Applicable billing meter information ,
Required: False ,
}
{
meterId:
{
Description: Meter id ,
Required: False ,
}
string ,
partNumber:
{
Description: Compute part number ,
Required: False ,
}
string ,
consumptionResourceId:
{
Description: Consumption resource id ,
Required: False ,
}
string ,
price:
{
Description: Retail price with currency ,
Required: False ,
}
{
currencyCode:
{
Description: Currency code i.e. 'USD' ,
Required: False ,
}
string ,
isPiRequired:
{
Description: A value indicating whether a payment instrument is required ,
Required: True ,
}
boolean ,
listPrice:
{
Description: Retail price for the item ,
Format: float ,
Required: True ,
}
number ,
msrp:
{
Description: Manufacturer's suggested retail price for the item ,
Format: float ,
Required: True ,
}
number ,
}
,
type:
{
Description: Type of this meter ,
Required: False ,
}
string ,
includedQuantityProperties:
{
Description: Included quantity properties ,
Required: False ,
}
[
{
termId:
{
Description: Term id ,
Required: False ,
}
string ,
quantity:
{
Description: Included quantity ,
Required: False ,
}
string ,
}
,
]
,
}
,
pricingAudience:
{
Description: Specifies the distribution channel and customer segment for product pricing and availability. Possible values: - `Direct-Commercial` - Available through direct Azure Marketplace purchases for commercial customers without intermediaries like partners or resellers - `Partner-Commercial` - Available through Cloud Solution Provider partner channel for reseller distribution ,
Required: True ,
}
string ,
terms:
{
Description: List of applicable terms ,
Required: False ,
}
[
{
termDescriptionParameters:
{
Description: Term description parameters ,
Required: False ,
}
[
{
parameter:
{
Description: Description parameter ,
Required: False ,
}
string ,
value:
{
Description: Parameter's value ,
Required: False ,
}
string ,
}
,
]
,
termId:
{
Description: Term id ,
Required: False ,
}
string ,
termUnit:
{
Description: Term unit ,
Required: False ,
}
string ,
prorationPolicy:
{
Description: Defines the rules for calculating prorated charges or refunds for a subscription. ,
Required: False ,
}
{
minimumProratedUnits:
{
Description: Minimum prorated units ,
Required: False ,
}
string ,
}
,
termDescription:
{
Description: Term description ,
Required: False ,
}
string ,
price:
{
Description: Retail price with currency ,
Required: False ,
}
{
currencyCode:
{
Description: Currency code i.e. 'USD' ,
Required: False ,
}
string ,
isPiRequired:
{
Description: A value indicating whether a payment instrument is required ,
Required: True ,
}
boolean ,
listPrice:
{
Description: Retail price for the item ,
Format: float ,
Required: True ,
}
number ,
msrp:
{
Description: Manufacturer's suggested retail price for the item ,
Format: float ,
Required: True ,
}
number ,
}
,
renewTermId:
{
Description: Renew term id ,
Required: False ,
}
string ,
renewTermUnits:
{
Description: Renew term units ,
Required: False ,
}
string ,
billingPlan:
{
Description: Billing Plan ,
Required: False ,
}
{
billingPeriod:
{
Description: Billing period ,
Required: False ,
}
string ,
title:
{
Description: Title of the billing plan ,
Required: False ,
}
string ,
description:
{
Description: Description of the billing plan ,
Required: False ,
}
string ,
price:
{
Description: Retail price with currency ,
Required: False ,
}
{
currencyCode:
{
Description: Currency code i.e. 'USD' ,
Required: False ,
}
string ,
isPiRequired:
{
Description: A value indicating whether a payment instrument is required ,
Required: True ,
}
boolean ,
listPrice:
{
Description: Retail price for the item ,
Format: float ,
Required: True ,
}
number ,
msrp:
{
Description: Manufacturer's suggested retail price for the item ,
Format: float ,
Required: True ,
}
number ,
}
,
}
,
renewToTermBillingPlan:
{
Description: Renew Billing Plan ,
Required: False ,
}
string ,
isAutorenewable:
{
Description: Indicates if autorenew is enabled ,
Required: False ,
}
boolean ,
lifecyclePolicy:
{
Description: Defines the lifecycle management policy for the term ,
Required: False ,
}
{
graceDuration:
{
Description: Grace period duration where customers retain access to their product. Examples: 'P1M' (1 month), 'P30D' (30 days), 'P0D' (0 days) ,
Required: False ,
}
string ,
inactiveDuration:
{
Description: Inactive period duration ,
Required: False ,
}
string ,
lockoutDuration:
{
Description: Lockout period duration ,
Required: False ,
}
string ,
}
,
productCode:
{
Description: Product code for this term ,
Required: False ,
}
string ,
state:
{
Description: Term state ,
Required: False ,
}
string ,
actions:
{
Description: Term Actions ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
hasFreeTrials:
{
Description: A value indicating whether it has free trials ,
Required: True ,
}
boolean ,
consumptionUnitType:
{
Description: Consumption unit type ,
Required: False ,
}
string ,
displayRank:
{
Description: Display rank ,
Format: int32 ,
Required: True ,
}
integer ,
}
,
]
,
uiDefinitionUri:
{
Description: What blade to open when someone wants to create a marketplace item ,
Required: False ,
}
string ,
artifacts:
{
Description: Files related to the marketplace item ,
Required: False ,
}
[
{
name:
{
Description: Artifact name ,
Required: False ,
}
string ,
uri:
{
Description: Artifact uri ,
Required: False ,
}
string ,
artifactType:
{
Description: Defines the artifact resource type and its role in the marketplace offering deployment process. - `Template` - Primary Azure Resource Manager template containing the main deployment configuration - `Fragment` - Nested Azure Resource Manager template referenced by the primary template for modular deployments - `Custom` - Publisher-defined artifact with specialized deployment or configuration requirements - `Metadata` - Supplementary information and configuration data supporting the deployment process ,
Required: True ,
}
string ,
}
,
]
,
version:
{
Description: Version of the marketplace item ,
Required: False ,
}
string ,
isHidden:
{
Description: A value indicating whether the plan is hidden ,
Required: True ,
}
boolean ,
isStopSell:
{
Description: A value indicating whether plan has been stopped from selling ,
Required: True ,
}
boolean ,
stopSellInfo:
{
Description: A StopSellInfo object providing stop sell related data ,
Required: False ,
}
{
startDate:
{
Description: A value indicating when the sale of this item is going to be stopped ,
Format: date-time ,
Required: False ,
}
string ,
reason:
{
Description: Specifies the business or technical justification for discontinuing product sales in the marketplace. - `EndOfSupport` - Product lifecycle has reached end-of-support status with no further updates or maintenance - `SecurityIssue` - Critical security vulnerability or compliance issue requiring immediate sales suspension - `Other` - Alternative business reason not covered by standard discontinuation categories ,
Required: False ,
}
string ,
alternativeOfferId:
{
Description: A value indicating an ID of an alternative offer provided by the same publisher ,
Required: False ,
}
string ,
alternativePlanId:
{
Description: A value indicating an ID of an alternative plan of the same offer ,
Required: False ,
}
string ,
}
,
minQuantity:
{
Description: Min quantity ,
Format: int32 ,
Required: False ,
}
integer ,
maxQuantity:
{
Description: Max quantity ,
Format: int32 ,
Required: False ,
}
integer ,
isQuantifiable:
{
Description: A value indicating whether the plan is quantifiable ,
Required: True ,
}
boolean ,
billingComponents:
{
Description: Billing components ,
Required: False ,
}
[
{
billingTag:
{
Description: Billing Tag ,
Required: False ,
}
string ,
}
,
]
,
purchaseDurationDiscounts:
{
Description: List of purchase duration discounts ,
Required: False ,
}
[
{
duration:
{
Description: The duration ,
Required: False ,
}
string ,
discountPercentage:
{
Description: The discount percentage ,
Format: float ,
Required: True ,
}
number ,
}
,
]
,
isHiddenPrivateOffer:
{
Description: A value indicating whether the plan is used as hidden private offer requiring a quote ,
Required: False ,
}
boolean ,
certifications:
{
Description: List of certifications ,
Required: False ,
}
[
{
id:
{
Description: Id of the link ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the link ,
Required: False ,
}
string ,
uri:
{
Description: Uri of the link ,
Required: False ,
}
string ,
}
,
]
,
customerInstruction:
{
Description: Plan's customer instruction for purchasing ,
Required: False ,
}
string ,
planLabels:
{
Description: Plan labels ,
Required: False ,
}
[
string ,
]
,
skuType:
{
Description: SKU type ,
Required: False ,
}
string ,
skuTitle:
{
Description: Sku title localized ,
Required: False ,
}
string ,
location:
{
Description: SKU location ,
Required: False ,
}
string ,
armRegionName:
{
Description: The Arm region name ,
Required: False ,
}
string ,
cloud:
{
Description: Applicable cloud, such as 'Global' ,
Required: False ,
}
string ,
locationType:
{
Description: The location type, such as 'Region' ,
Required: False ,
}
string ,
region:
{
Description: The region ,
Required: False ,
}
string ,
skuGroupId:
{
Description: The sku group id ,
Required: False ,
}
string ,
zone:
{
Description: The zone, such as 'Zone 1' ,
Required: False ,
}
string ,
feature:
{
Description: The feature, such as 'Spot' ,
Required: False ,
}
string ,
serviceType:
{
Description: The service type ,
Required: False ,
}
string ,
skuAttributes:
{
Description: Set of SKU attributes (varies per sku type), where each attribute is represented by a pair of key (attribute name) and value(attribute value) ,
Required: False ,
}
[
{
key:
{
Description: The attribute key ,
Required: False ,
}
string ,
value:
{
Description: The attribute value ,
Required: False ,
}
string ,
}
,
]
,
skuProperties:
{
Description: The sku properties ,
Required: False ,
}
{
category:
{
Description: The sku category ,
Required: False ,
}
string ,
dataDiskType:
{
Description: The data disk type, such as 'Ssd' ,
Required: False ,
}
string ,
diskType:
{
Description: The disk type, such as 'Ssd' ,
Required: False ,
}
string ,
numberOfCores:
{
Description: The number of cores ,
Required: False ,
}
string ,
ram:
{
Description: The RAM ,
Required: False ,
}
string ,
vCpu:
{
Description: The number of virtual CPUs ,
Required: False ,
}
string ,
armSkuName:
{
Description: The ARM SKU name ,
Required: False ,
}
string ,
accessTier:
{
Description: The access tier, such as 'Standard' ,
Required: False ,
}
string ,
}
,
offeringProperties:
{
Description: SKU price related properties. ,
Required: False ,
}
[
{
productCode:
{
Description: The product code (UPN) ,
Required: False ,
}
string ,
termId:
{
Description: The term id ,
Required: False ,
}
string ,
meterType:
{
Description: The meter type ,
Required: False ,
}
string ,
billingMeterId:
{
Description: The billing meter id ,
Required: False ,
}
string ,
offeringId:
{
Description: The offering id ,
Required: False ,
}
string ,
type:
{
Description: Entitlement, Consumption or Reservation ,
Required: False ,
}
string ,
}
,
]
,
hasConsumptionComponents:
{
Description: Indicates if this SKU has consumption components ,
Required: False ,
}
boolean ,
isEndUserEligible:
{
Description: Indicates if this SKU is available for end users ,
Required: False ,
}
boolean ,
isAdminEligible:
{
Description: Indicates if this SKU is available for admins ,
Required: False ,
}
boolean ,
entraIdVersion:
{
Description: The entra id version for products that come with entra id support ,
Required: False ,
}
string ,
technicalRequirements:
{
Description: Technical Requirements ,
Required: False ,
}
string ,
faqUri:
{
Description: The URI to the FAQ page ,
Required: False ,
}
string ,
fulfillmentData:
{
Description: Fulfillment instructions for this SKU ,
Required: False ,
}
{
fulfillmentType:
{
Description: Differentiates between fulfillment types ,
Required: False ,
}
string ,
attributes:
{
Description: Fulfillment attributes ,
Required: False ,
}
{
fulfillmentTiming:
{
Description: Timing configuration for product fulfillment ,
Required: False ,
}
string ,
fulfillmentDelayMitigation:
{
Description: Mitigation explanation for delayed fulfillment ,
Required: False ,
}
string ,
}
,
additionalProducts:
{
Description: Bundled products included defining additional product/SKU combinations ,
Required: False ,
}
[
{
productSkuId:
{
Description: Product and SKU ID for bundled products included with the license ,
Required: False ,
}
string ,
defaultKeyActivationCount:
{
Description: Quantity of the bundled product per license ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
benefits:
{
Description: Provides promotion data ,
Required: False ,
}
[
{
benefitType:
{
Description: Benefit type ,
Required: False ,
}
string ,
basePlanId:
{
Description: Base plan ID ,
Required: False ,
}
string ,
billingPlan:
{
Description: Billing plan ,
Required: False ,
}
string ,
termDuration:
{
Description: Term duration. Examples: 'P1M' (1 month), 'P30D' (30 days) ,
Required: False ,
}
string ,
}
,
]
,
constraintsData:
{
Description: Contains constraint product properties to determine eligibility ,
Required: False ,
}
{
seatConstraints:
{
Description: Seat constraint configurations defining minimum and maximum seat limits ,
Required: False ,
}
[
{
type:
{
Description: Constraint type ,
Required: False ,
}
string ,
minSeats:
{
Description: Minimum seats ,
Format: int32 ,
Required: False ,
}
integer ,
maxSeats:
{
Description: Maximum seats ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
assetOwnershipLimits:
{
Description: Asset ownership limits ,
Required: False ,
}
[
{
type:
{
Description: Limit type ,
Required: False ,
}
string ,
minAssets:
{
Description: Minimum number of assets ,
Format: int32 ,
Required: False ,
}
integer ,
maxAssets:
{
Description: Maximum number of assets ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
prerequisiteSkus:
{
Description: Lists eligible prerequisite SKUs ,
Required: False ,
}
{
mustHaveAll:
{
Description: Prerequisite sets where all specified SKUs must be owned ,
Required: False ,
}
[
{
productId:
{
Description: Product ID ,
Required: False ,
}
string ,
skuIds:
{
Description: SKU IDs ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
mustHaveAny:
{
Description: Prerequisite sets where any one of the specified SKUs must be owned ,
Required: False ,
}
[
{
productId:
{
Description: Product ID ,
Required: False ,
}
string ,
skuIds:
{
Description: SKU IDs ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
seatConstraints:
{
Description: Percentage-based seat constraints for prerequisite SKUs ,
Required: False ,
}
[
{
type:
{
Description: Constraint type ,
Required: False ,
}
string ,
minPercentSeats:
{
Description: Minimum percent seats ,
Format: double ,
Required: False ,
}
number ,
maxPercentSeats:
{
Description: Maximum percent seats ,
Format: double ,
Required: False ,
}
number ,
}
,
]
,
}
,
}
,
meterTypeDescriptions:
{
Description: Meter type descriptions ,
Required: False ,
}
[
{
key:
{
Description: Meter Type Description key ,
Required: False ,
}
string ,
value:
{
Description: Meter type description value ,
Required: False ,
}
{
meterType:
{
Description: The type of meter ,
Required: False ,
}
string ,
unitOfMeasure:
{
Description: The unit of measurement for the meter ,
Required: False ,
}
string ,
}
,
}
,
]
,
usageUnit:
{
Description: Usage unit ,
Required: False ,
}
string ,
skuName:
{
Description: Sku name ,
Required: False ,
}
string ,
}
,
]
,
hasAddOns:
{
Description: Indicates that the SKU has add-ons ,
Required: False ,
}
boolean ,
}

⚐ Response (default)

{
error:
{
Description: The error details object ,
Required: True ,
}
{
code:
{
Description: The HTTP error code ,
Required: True ,
}
string ,
message:
{
Description: The error message ,
Required: True ,
}
string ,
}
,
}