Add Microsoft.Commerce/OfferCatalog TypeSpec (2026-04-24-preview)

specification/commerce/cspell.yaml

@@ -0,0 +1,11 @@
+# This file configures spell checking. Items in "words" were initially populated
+# with words that might be spelling errors. Review these words and take
+# appropriate action. For more information, see: https://aka.ms/ci-fix#spell-check
+
+# Spell checking is not case sensitive
+# Keep word lists in alphabetical order so the file is easier to manage
+version: '0.2'
+import:
+  - ../../cspell.yaml
+words:
+  - upns

specification/commerce/resource-manager/Microsoft.Commerce/OfferCatalog/examples/2026-04-24-preview/Operations_List.json

@@ -0,0 +1,35 @@
+{
+  "parameters": {
+    "api-version": "2026-04-24-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "Microsoft.Commerce/upns/read",
+            "display": {
+              "provider": "Microsoft.Commerce",
+              "resource": "upns",
+              "operation": "Get UPN",
+              "description": "Returns a single UPN (Unified Product Node) resource by its GUID identifier."
+            },
+            "isDataAction": false
+          },
+          {
+            "name": "Microsoft.Commerce/upns/list/action",
+            "display": {
+              "provider": "Microsoft.Commerce",
+              "resource": "upns",
+              "operation": "List UPNs",
+              "description": "Lists UPN (Unified Product Node) resources at tenant/provider scope."
+            },
+            "isDataAction": false
+          }
+        ]
+      }
+    }
+  },
+  "operationId": "Operations_List",
+  "title": "List all operations supported by Microsoft.Commerce/OfferCatalog"
+}

specification/commerce/resource-manager/Microsoft.Commerce/OfferCatalog/examples/2026-04-24-preview/Upns_Get.json

@@ -0,0 +1,48 @@
+{
+  "title": "Get a UPN by its GUID identifier.",
+  "operationId": "Upns_Get",
+  "parameters": {
+    "api-version": "2026-04-24-preview",
+    "upnGuid": "5ac17b8c-6ac2-432a-b1a9-baa1774c70c5",
+    "fragments": "pricing,display"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/providers/Microsoft.Commerce/upns/5ac17b8c-6ac2-432a-b1a9-baa1774c70c5",
+        "name": "5ac17b8c-6ac2-432a-b1a9-baa1774c70c5",
+        "type": "Microsoft.Commerce/upns",
+        "systemData": {
+          "lastModifiedAt": "2026-04-15T12:00:00Z"
+        },
+        "properties": {
+          "valueExchange": {
+            "id": "5ac17b8c-6ac2-432a-b1a9-baa1774c70c5",
+            "unit": {
+              "hint": "vCPU Duration - 1 Hour"
+            },
+            "dimensions": {
+              "location": "westus2",
+              "feature": "linux"
+            }
+          },
+          "product": {
+            "id": "DZH318Z0BQV6",
+            "friendlyName": "Container Instances",
+            "template": "offer-template/az-generic",
+            "tags": {
+              "service": "compute"
+            },
+            "ownership": "1PP"
+          },
+          "sku": {
+            "id": "DZH318TNL8K4",
+            "friendlyName": "Standard",
+            "type": "consumption"
+          },
+          "template": "offer-template/az-generic"
+        }
+      }
+    }
+  }
+}

specification/commerce/resource-manager/Microsoft.Commerce/OfferCatalog/examples/2026-04-24-preview/Upns_ListByTenant.json

@@ -0,0 +1,86 @@
+{
+  "title": "List UPNs at tenant/provider scope.",
+  "operationId": "Upns_ListByTenant",
+  "parameters": {
+    "api-version": "2026-04-24-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/providers/Microsoft.Commerce/upns/5ac17b8c-6ac2-432a-b1a9-baa1774c70c5",
+            "name": "5ac17b8c-6ac2-432a-b1a9-baa1774c70c5",
+            "type": "Microsoft.Commerce/upns",
+            "systemData": {
+              "lastModifiedAt": "2026-04-15T12:00:00Z"
+            },
+            "properties": {
+              "valueExchange": {
+                "id": "5ac17b8c-6ac2-432a-b1a9-baa1774c70c5",
+                "unit": {
+                  "hint": "vCPU Duration - 1 Hour"
+                },
+                "dimensions": {
+                  "location": "westus2",
+                  "feature": "linux"
+                }
+              },
+              "product": {
+                "id": "DZH318Z0BQV6",
+                "friendlyName": "Container Instances",
+                "template": "offer-template/az-generic",
+                "tags": {
+                  "service": "compute"
+                },
+                "ownership": "1PP"
+              },
+              "sku": {
+                "id": "DZH318TNL8K4",
+                "friendlyName": "Standard",
+                "type": "consumption"
+              },
+              "template": "offer-template/az-generic"
+            }
+          },
+          {
+            "id": "/providers/Microsoft.Commerce/upns/7b2f9a1c-1234-4567-89ab-cdef01234567",
+            "name": "7b2f9a1c-1234-4567-89ab-cdef01234567",
+            "type": "Microsoft.Commerce/upns",
+            "systemData": {
+              "lastModifiedAt": "2026-04-14T09:30:00Z"
+            },
+            "properties": {
+              "valueExchange": {
+                "id": "7b2f9a1c-1234-4567-89ab-cdef01234567",
+                "unit": {
+                  "hint": "Subscription - 1 Month"
+                },
+                "dimensions": {
+                  "location": "global",
+                  "feature": "premium"
+                }
+              },
+              "product": {
+                "id": "DZH318Z0BPWH",
+                "friendlyName": "Virtual Machines Ev3 Windows",
+                "template": "offer-template/az-vm",
+                "tags": {
+                  "service": "compute"
+                },
+                "ownership": "1PP"
+              },
+              "sku": {
+                "id": "DZH318Z0BPWH-E16",
+                "friendlyName": "Standard E16s v3",
+                "type": "consumption"
+              },
+              "template": "offer-template/az-vm"
+            }
+          }
+        ],
+        "nextLink": "https://management.azure.com/providers/Microsoft.Commerce/upns?api-version=2026-04-24-preview&$skipToken=abc123"
+      }
+    }
+  }
+}

specification/commerce/resource-manager/Microsoft.Commerce/OfferCatalog/main.tsp

@@ -0,0 +1,30 @@
+import "@typespec/http";
+import "@typespec/rest";
+import "@typespec/versioning";
+import "@azure-tools/typespec-azure-core";
+import "@azure-tools/typespec-azure-resource-manager";
+import "./models.tsp";
+import "./upns.tsp";
+
+using TypeSpec.Http;
+using TypeSpec.Rest;
+using TypeSpec.Versioning;
+using Azure.Core;
+using Azure.ResourceManager;
+
+/** Microsoft.Commerce OfferCatalog Resource Provider management API. */
+@armProviderNamespace("Microsoft.Commerce")
+@service(#{ title: "Microsoft Commerce Offer Catalog" })
+@versioned(Microsoft.Commerce.Versions)
+namespace Microsoft.Commerce;
+
+/** The available API versions for the Offer Catalog service. */
+enum Versions {
+  /** The 2026-04-24-preview API version. */
+  @armCommonTypesVersion(Azure.ResourceManager.CommonTypes.Versions.v6)
+  @previewVersion
+  v2026_04_24_preview: "2026-04-24-preview",
+}
+
+/** The operations supported by the Microsoft.Commerce resource provider for the Offer Catalog service. */
+interface Operations extends Azure.ResourceManager.Operations {}