Azure Local, SFF public preview May 2026 (#43203)

* new public preview

* add changes

* Readme changes

* Adding AddServer and RepairServer to Public Preview 2026-05-01-preview (#43209)

Co-authored-by: Prakhar Shukla <prakshukla@microsoft.com>

* Sync generated files with tsv

* suppress XMSSecretInResponse for gpgPubKey - GPG public key is not a secret

* Remove orphaned DevicePools examples and clarify gpgPubKey suppression reason

- Delete orphaned example files for non-existent AddDevices/RemoveDevices operations:
  DevicePools_AddDevices_MaximumSet_Gen.json
  DevicePools_AddDevices_MinimumSet_Gen.json
  DevicePools_RemoveDevices_MaximumSet_Gen.json
  DevicePools_RemoveDevices_MinimumSet_Gen.json
- Update XMSSecretInResponse suppression reason in readme.md to clarify
  gpgPubKey contains only public key material, not a secret

* remove local only working file

* Address PR review: WitnessType union and DevicePools example cleanup

- Add WitnessType extensible enum (Cloud, FileShare) with @added(v2026_05_01_preview)
- Update HciAddServerJobProperties.witnessType to use WitnessType union
- Fix DevicePools_CreateOrUpdate.json placeholder values:
  Remove extraneous resourceUri parameter
  Set type to Microsoft.AzureStackHCI/devicePools
  Set realistic name, location, createdBy, lastModifiedBy
  Add tags field to 200/201 response bodies
- Update gpgPubKey #suppress reasons in models.tsp to match readme.md

* Remove unnecessary provisioning-state suppress from EdgeMachineJobs

EdgeMachineJobProperties already includes provisioningState, so the
#suppress directive with an empty reason was unnecessary. Removed it.

* Add versioning policy doc to Versions enum and define VsrRing union for ChangeRingRequest and ClusterProperties.ring

* Remove unnecessary suppress from DevicePool and add reason strings to catalog resource suppresses

* re-compiled all tsp changes

* Fix sdnProperties doc comment typo and switch ClusterSdnProperties to composition

* clarify claimedBy descriptions

* Port EdgeMachines validate action to 2026-05-01-preview (#43217)

Add the validate long-running action on EdgeMachine resource for
public preview API version 2026-05-01-preview. Ported from private
preview 2026-03-15-preview.

Changes:
- EdgeMachine.tsp: Added validate operation (ArmResourceActionAsync)
- models.tsp: Added EdgeMachineValidateRequest and EdgeMachineValidateResponse
- examples: Added EdgeMachines_Validate.json

Co-authored-by: Prakhar Shukla <prakshukla@microsoft.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Edge machine lifecycle changes for 2026-05-01-preview (#43262)

* Edge machine lifecycle changes for 2026-05-01-preview

* Fix StackHCI 2026-05-01-preview generated files for TypeSpec validation

Agent-Logs-Url: https://github.com/Azure/azure-rest-api-specs/sessions/767e7675-b44d-468d-8553-f2cdea23bc0e

Co-authored-by: larikaS <127827858+larikaS@users.noreply.github.com>

---------

Co-authored-by: Larika Sehgal <larikasehgal@microsft.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>

* add updates resource (#43240)

Co-authored-by: Harsh Saroha <sarohaharsh@microsoft.com>

* Add gpu to 2026 05 01 (#43269)

* Add GPU models and examples

* Change api version

* Fix examples

* Compile after rebase

* recpmpile with pr merged

* Replace VsrRing enum with string type for cluster ring property

The ring property may support a broader range of values that are not
controlled by our system, so a fixed enum is too restrictive. Changed
ClusterProperties.ring and ChangeRingRequestProperties.targetRing to
plain string and removed the VsrRing union.

* Added workload inventory details to edge machine (#43482)

* Add error details to os job step (#43425)

* Add error details to os job step

* Add examples

* webpubsub: parameter reordering customization for Go/Python/JavaScript (#43474)

* webpubsub: Go-only parameter reordering for backward compatibility

Preserve the original swagger Go SDK parameter order (childName, resourceGroupName, resourceName, ...)
for Hubs, PrivateEndpointConnections, and WebPubSubSharedPrivateLinkResources operations.

Follows the @@OverRide pattern used in DataBoxEdge (#43159).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* webpubsub: extend parameter-order overrides to python and javascript

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* update

* update

---------

Co-authored-by: tadelesh <chenjieshi@microsoft.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Add python to clientName override for ChargeSummary.eTag (#43476)

* [DataBox] Preserve SDK parameter order (#43418)

* [DataBox] Preserve SDK parameter order

* tsp format

* Update client.tsp

* tsp format

* [servicebus] fix for Namespaces.update to be sync operation (#43478)

Co-authored-by: tadelesh <chenjieshi@microsoft.com>

* [JS] Enable compatibility-lro for billingbenefits (#43475)

* Mitigate Python SDK breaking changes for azure-mgmt-msi (#43479)

* Added examples for inventory

* compiled examples

* VMConnect 2026-05-01 changes  (#43391)

* vmconnect model changes

* adding example files

* compile

---------

Co-authored-by: abaranwal-ms <124332815+abaranwal-ms@users.noreply.github.com>
Co-authored-by: Abhijeet Baranwal <abaranwal@microsoft.com>

* Add EdgeMachine Fabric Management resources for 2026-05-01-preview (#43542)

* Add PEAP and TTLS to cspell allowed words

* Fix TypeSpec formatting to pass tsv validation

* fix formatting

* Add Fabric Management changes and update cspell (#43630)

* fix formatting, uncheckout protected file

* Added PEAP and TTLS to cspell

* Add solutionType (ProvisioningOsType) to EdgeMachineUpdate for 2026-05-01-preview (#43636)

---------

Co-authored-by: prakhar_shukla <78557330+shuklaprakhar415@users.noreply.github.com>
Co-authored-by: Prakhar Shukla <prakshukla@microsoft.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: larikaS <127827858+larikaS@users.noreply.github.com>
Co-authored-by: Larika Sehgal <larikasehgal@microsft.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: le-codeur <sarohah967@gmail.com>
Co-authored-by: Harsh Saroha <sarohaharsh@microsoft.com>
Co-authored-by: Shishira Iyar <106435637+shishiraiyar@users.noreply.github.com>
Co-authored-by: IndraneelPal <105407886+IndraneelPal@users.noreply.github.com>
Co-authored-by: Sushma Reddy <59618780+sush-101@users.noreply.github.com>
Co-authored-by: Chenjie Shi <tadelesh.shi@live.cn>
Co-authored-by: tadelesh <chenjieshi@microsoft.com>
Co-authored-by: Yuchao Yan <yuchaoyan@microsoft.com>
Co-authored-by: Xinni Tong <v-xinnitong@microsoft.com>
Co-authored-by: Jiao Di (MSFT) <80496810+v-jiaodi@users.noreply.github.com>
Co-authored-by: hvedati <43424696+hvedati@users.noreply.github.com>
Co-authored-by: pvsraviteja <67624658+pvsraviteja@users.noreply.github.com>
Co-authored-by: Ravi Teja PVS (from Dev Box) <rapvs@microsoft.com>
Co-authored-by: baheti1409 <naman.baheti14@gmail.com>

Author: 20 people

specification/azurestackhci/cspell.yaml

@@ -19,12 +19,15 @@ words:
   - igvm
   - imds
   - mitigations
+  - PEAP
   - rdma
   - sdkauto
   - stackhcivm
+  - TTLS
   - uefi
   - unattend
   - unpurposed
+  - vfat
   - vhds
   - vhdx
   - wdac

specification/azurestackhci/resource-manager/Microsoft.AzureStackHCI/StackHCI/Cluster.tsp

@@ -33,7 +33,7 @@ model Cluster is Azure.ResourceManager.TrackedResource<ClusterProperties> {
 }
 
 // here is the augment decorator for versioning
-@@added(Cluster.kind, Versions.v2026_04_01_preview);
+@@added(Cluster.kind, Versions.v2026_04_30);
 
 @armResourceOperations
 interface Clusters {
@@ -131,8 +131,7 @@ interface Clusters {
   /**
    * Changes ring of a cluster
    */
-  @added(Versions.v2026_04_01_preview)
-  @removed(Versions.v2026_04_30)
+  @added(Versions.v2026_05_01_preview)
   changeRing is ArmResourceActionAsync<Cluster, ChangeRingRequest, Cluster>;
 
   /**

specification/azurestackhci/resource-manager/Microsoft.AzureStackHCI/StackHCI/ClusterJobs.tsp

@@ -16,8 +16,7 @@ namespace Microsoft.AzureStackHCI;
 /**
  * Cluster Jobs resource
  */
-@added(Versions.v2026_04_01_preview)
-@removed(Versions.v2026_04_30)
+@added(Versions.v2026_05_01_preview)
 @parentResource(Cluster)
 model ClusterJob is Azure.ResourceManager.ProxyResource<ClusterJobProperties> {
   ...ResourceNameParameter<
@@ -31,8 +30,7 @@ model ClusterJob is Azure.ResourceManager.ProxyResource<ClusterJobProperties> {
 /**
  * ClusterJobs operations
  */
-@added(Versions.v2026_04_01_preview)
-@removed(Versions.v2026_04_30)
+@added(Versions.v2026_05_01_preview)
 @armResourceOperations
 interface ClusterJobs {
   /** Get a ClusterJob */

specification/azurestackhci/resource-manager/Microsoft.AzureStackHCI/StackHCI/DevicePool.tsp

@@ -14,9 +14,7 @@ namespace Microsoft.AzureStackHCI;
 /**
  * DevicePool details.
  */
-#suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-provisioning-state"
-@added(Versions.v2026_04_01_preview)
-@removed(Versions.v2026_04_30)
+@added(Versions.v2026_05_01_preview)
 model DevicePool
   is Azure.ResourceManager.TrackedResource<DevicePoolProperties> {
   ...ResourceNameParameter<
@@ -28,8 +26,7 @@ model DevicePool
   ...ManagedServiceIdentityProperty;
 }
 
-@added(Versions.v2026_04_01_preview)
-@removed(Versions.v2026_04_30)
+@added(Versions.v2026_05_01_preview)
 @armResourceOperations
 interface DevicePools {
   /**

specification/azurestackhci/resource-manager/Microsoft.AzureStackHCI/StackHCI/EdgeMachine.tsp

@@ -14,8 +14,7 @@ namespace Microsoft.AzureStackHCI;
 /**
  * EdgeMachine details.
  */
-@added(Versions.v2026_04_01_preview)
-@removed(Versions.v2026_04_30)
+@added(Versions.v2026_05_01_preview)
 model EdgeMachine
   is Azure.ResourceManager.TrackedResource<EdgeMachineProperties> {
   ...ResourceNameParameter<
@@ -27,8 +26,7 @@ model EdgeMachine
   ...ManagedServiceIdentityProperty;
 }
 
-@added(Versions.v2026_04_01_preview)
-@removed(Versions.v2026_04_30)
+@added(Versions.v2026_05_01_preview)
 @armResourceOperations
 interface EdgeMachines {
   /**
@@ -61,6 +59,16 @@ interface EdgeMachines {
    * List all edge machines in a subscription.
    */
   listBySubscription is ArmListBySubscription<EdgeMachine>;
+
+  /**
+   * A long-running resource action to validate the edge machine.
+   */
+  @added(Versions.v2026_05_01_preview)
+  validate is ArmResourceActionAsync<
+    EdgeMachine,
+    EdgeMachineValidateRequest,
+    EdgeMachineValidateResponse
+  >;
 }
 
 @@doc(EdgeMachine.name, "Name of Device");

specification/azurestackhci/resource-manager/Microsoft.AzureStackHCI/StackHCI/EdgeMachineGpu.tsp

@@ -0,0 +1,94 @@
+import "@azure-tools/typespec-azure-core";
+import "@azure-tools/typespec-azure-resource-manager";
+import "@azure-tools/typespec-client-generator-core";
+import "@typespec/openapi";
+import "@typespec/rest";
+import "./models.tsp";
+
+using TypeSpec.Rest;
+using TypeSpec.Versioning;
+using Azure.ResourceManager;
+
+namespace Microsoft.AzureStackHCI;
+
+/**
+ * Details of a particular GPU in an EdgeMachine.
+ */
+@added(Versions.v2026_05_01_preview)
+@parentResource(EdgeMachine)
+model EdgeMachineGpu
+  is Azure.ResourceManager.ProxyResource<EdgeMachineGpuProperties> {
+  ...ResourceNameParameter<
+    Resource = EdgeMachineGpu,
+    KeyName = "gpuName",
+    SegmentName = "gpus",
+    NamePattern = "^[a-zA-Z0-9-_]{3,85}$"
+  >;
+}
+
+/**
+ * CRUD + List operations for Edge Machine GPUs.
+ */
+@added(Versions.v2026_05_01_preview)
+@armResourceOperations
+interface EdgeMachineGpus {
+  /**
+   * Get a specific GPU on an Edge Machine.
+   */
+  get is ArmResourceRead<EdgeMachineGpu>;
+
+  /**
+   * List all GPUs on an Edge Machine.
+   */
+  list is ArmResourceListByParent<
+    EdgeMachineGpu,
+    Response = ArmResponse<GpuList>
+  >;
+
+  /**
+   * Create or update a GPU on an Edge Machine.
+   */
+  createOrUpdate is ArmResourceCreateOrUpdateAsync<EdgeMachineGpu>;
+
+  @doc("Delete a EdgeMachineGpu")
+  delete is ArmResourceDeleteWithoutOkAsync<EdgeMachineGpu>;
+}
+
+// ==================== GpuJobs Resource ====================
+
+/**
+ * Details of a GPU Job on an Edge Machine GPU.
+ */
+#suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-provisioning-state" ""
+@added(Versions.v2026_05_01_preview)
+@parentResource(EdgeMachineGpu)
+model EdgeMachineGpuJob
+  is Azure.ResourceManager.ProxyResource<EdgeMachineGpuJobProperties> {
+  ...ResourceNameParameter<
+    Resource = EdgeMachineGpuJob,
+    KeyName = "jobsName",
+    SegmentName = "jobs",
+    NamePattern = "^[a-zA-Z0-9-_]{3,512}$"
+  >;
+}
+
+/**
+ * CRUD + List operations for Edge Machine GPU Jobs.
+ */
+@added(Versions.v2026_05_01_preview)
+@armResourceOperations
+interface EdgeMachineGpuJobs {
+  /** Get a specific GPU Job on an Edge Machine GPU. */
+  get is ArmResourceRead<EdgeMachineGpuJob>;
+
+  /** Create or update a GPU Job on an Edge Machine GPU. */
+  createOrUpdate is ArmResourceCreateOrUpdateAsync<EdgeMachineGpuJob>;
+
+  /** Delete a specific GPU Job on an Edge Machine GPU. */
+  delete is ArmResourceDeleteWithoutOkAsync<EdgeMachineGpuJob>;
+
+  /** List EdgeMachineGpuJob resources by EdgeMachineGpu. */
+  list is ArmResourceListByParent<EdgeMachineGpuJob>;
+}
+
+@@doc(EdgeMachineGpuJob.name, "Name of EdgeMachineGpuJob");

specification/azurestackhci/resource-manager/Microsoft.AzureStackHCI/StackHCI/EdgeMachineJobs.tsp

@@ -12,9 +12,7 @@ namespace Microsoft.AzureStackHCI;
 /**
  * Cluster Jobs resource
  */
-#suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-provisioning-state" ""
-@added(Versions.v2026_04_01_preview)
-@removed(Versions.v2026_04_30)
+@added(Versions.v2026_05_01_preview)
 @parentResource(EdgeMachine)
 model EdgeMachineJob
   is Azure.ResourceManager.ProxyResource<EdgeMachineJobProperties> {
@@ -28,8 +26,7 @@ model EdgeMachineJob
 
 @@doc(EdgeMachineJob.name, "Name of EdgeMachineJob");
 
-@added(Versions.v2026_04_01_preview)
-@removed(Versions.v2026_04_30)
+@added(Versions.v2026_05_01_preview)
 @armResourceOperations
 interface EdgeMachineJobs {
   /**

specification/azurestackhci/resource-manager/Microsoft.AzureStackHCI/StackHCI/EdgeMachineNetworkAdapters.tsp

@@ -0,0 +1,82 @@
+import "@azure-tools/typespec-azure-core";
+import "@azure-tools/typespec-azure-resource-manager";
+import "@typespec/openapi";
+import "@typespec/rest";
+import "./models.tsp";
+import "./EdgeMachine.tsp";
+
+using TypeSpec.Rest;
+using TypeSpec.Versioning;
+using Azure.ResourceManager;
+using TypeSpec.Http;
+using TypeSpec.OpenAPI;
+using Azure.Core;
+
+namespace Microsoft.AzureStackHCI;
+
+// ==================== Network Adapter Resource ====================
+
+/**
+ * Edge Machine Network Adapter Resource.
+ */
+@added(Versions.v2026_05_01_preview)
+@parentResource(EdgeMachine)
+model EdgeMachineNetworkAdapter
+  is Azure.ResourceManager.ProxyResource<EdgeMachineNetworkAdapterProperties> {
+  ...ResourceNameParameter<
+    Resource = EdgeMachineNetworkAdapter,
+    KeyName = "networkAdapterName",
+    SegmentName = "networkAdapters",
+    NamePattern = "^[a-zA-Z0-9-_]{3,63}$"
+  >;
+}
+
+/**
+ * Operations for Edge Machine Network Adapters.
+ */
+@added(Versions.v2026_05_01_preview)
+@armResourceOperations
+interface EdgeMachineNetworkAdapters {
+  /** Get a specific network adapter on an Edge Machine. */
+  get is ArmResourceRead<EdgeMachineNetworkAdapter>;
+
+  /** List all network adapters on an Edge Machine. */
+  list is ArmResourceListByParent<EdgeMachineNetworkAdapter>;
+}
+
+// ==================== Network Adapter Jobs Resource ====================
+
+/**
+ * Job for an Edge Machine Network Adapter.
+ */
+#suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-provisioning-state" ""
+@added(Versions.v2026_05_01_preview)
+@parentResource(EdgeMachineNetworkAdapter)
+model EdgeMachineNetworkAdapterJob
+  is Azure.ResourceManager.ProxyResource<EdgeMachineNetworkAdapterJobProperties> {
+  ...ResourceNameParameter<
+    Resource = EdgeMachineNetworkAdapterJob,
+    KeyName = "jobName",
+    SegmentName = "jobs",
+    NamePattern = "^[a-zA-Z0-9-_]{3,63}$"
+  >;
+}
+
+/**
+ * Operations for Edge Machine Network Adapter Jobs.
+ */
+@added(Versions.v2026_05_01_preview)
+@armResourceOperations
+interface EdgeMachineNetworkAdapterJobs {
+  /** Get a specific network adapter job. */
+  get is ArmResourceRead<EdgeMachineNetworkAdapterJob>;
+
+  /** List all jobs for a network adapter. */
+  list is ArmResourceListByParent<EdgeMachineNetworkAdapterJob>;
+
+  /** Create or update a network adapter job. */
+  createOrUpdate is ArmResourceCreateOrUpdateAsync<EdgeMachineNetworkAdapterJob>;
+
+  /** Delete a network adapter job. */
+  delete is ArmResourceDeleteWithoutOkAsync<EdgeMachineNetworkAdapterJob>;
+}