Service Fabric Managed Clusters - API version 2025-07-01-preview

specification/servicefabricmanagedclusters/ServiceFabricManagedClusters.Management/ServiceResource.tsp

@@ -2,12 +2,14 @@ import "@azure-tools/typespec-azure-core";
 import "@azure-tools/typespec-azure-resource-manager";
 import "@typespec/openapi";
 import "@typespec/rest";
+import "@typespec/versioning";
 import "./models.tsp";
 import "./ApplicationResource.tsp";
 
 using TypeSpec.Rest;
 using Azure.ResourceManager;
 using TypeSpec.Http;
+using TypeSpec.Versioning;
 
 namespace Microsoft.ServiceFabric;
 /**
@@ -245,7 +247,15 @@ model StatelessServiceProperties extends ServiceResourceProperties {
   /**
    * MinInstancePercentage is the minimum percentage of InstanceCount that must be up to meet the EnsureAvailability safety check during operations like upgrade or deactivate node. The actual number that is used is max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ). Note, if InstanceCount is set to -1, during MinInstancePercentage computation, -1 is first converted into the number of nodes on which the instances are allowed to be placed according to the placement constraints on the service.
    */
-  minInstancePercentage?: int32;
+  @removed(Versions.v2025_07_01_preview)
+  @renamedFrom(Versions.v2025_07_01_preview, "minInstancePercentage")
+  formerMinInstancePercentage?: int32;
+
+  /**
+   * MinInstancePercentage is the minimum percentage of InstanceCount that must be up to meet the EnsureAvailability safety check during operations like upgrade or deactivate node. The actual number that is used is max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ). Note, if InstanceCount is set to -1, during MinInstancePercentage computation, -1 is first converted into the number of nodes on which the instances are allowed to be placed according to the placement constraints on the service.
+   */
+  @added(Versions.v2025_07_01_preview)
+  minInstancePercentage?: int32 = 50;
 
   /**
    * The kind of service (Stateless or Stateful).

specification/servicefabricmanagedclusters/ServiceFabricManagedClusters.Management/examples/2025-07-01-preview/ApplicationActionGetUpgrade_example.json

@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "api-version": "2025-07-01-preview",
+    "applicationName": "myApp",
+    "clusterName": "myCluster",
+    "resourceGroupName": "resRg",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000"
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "Azure-AsyncOperation": "http://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/managedClusterOperationStatus/1ca6e48d-70ca-4e43-b652-3b0522f64d67?api-version=2025-07-01-preview",
+        "Location": "http://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/managedClusterOperationResults/1ca6e48d-70ca-4e43-b652-3b0522f64d67?api-version=2025-07-01-preview"
+      }
+    }
+  },
+  "operationId": "Applications_ReadUpgrade",
+  "title": "Get an application upgrade"
+}

specification/servicefabricmanagedclusters/ServiceFabricManagedClusters.Management/examples/2025-07-01-preview/ApplicationActionResumeUpgrade_example.json

@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "api-version": "2025-07-01-preview",
+    "applicationName": "myApp",
+    "clusterName": "myCluster",
+    "parameters": {
+      "upgradeDomainName": "UD1"
+    },
+    "resourceGroupName": "resRg",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000"
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "Azure-AsyncOperation": "http://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/managedClusterOperationStatus/1ca6e48d-70ca-4e43-b652-3b0522f64d67?api-version=2025-07-01-preview",
+        "Location": "http://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/managedClusterOperationResults/1ca6e48d-70ca-4e43-b652-3b0522f64d67?api-version=2025-07-01-preview"
+      }
+    }
+  },
+  "operationId": "Applications_ResumeUpgrade",
+  "title": "Resume upgrade"
+}

specification/servicefabricmanagedclusters/ServiceFabricManagedClusters.Management/examples/2025-07-01-preview/ApplicationActionStartRollback_example.json

@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "api-version": "2025-07-01-preview",
+    "applicationName": "myApp",
+    "clusterName": "myCluster",
+    "resourceGroupName": "resRg",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000"
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "Azure-AsyncOperation": "http://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/managedClusterOperationStatus/1ca6e48d-70ca-4e43-b652-3b0522f64d67?api-version=2025-07-01-preview",
+        "Location": "http://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/managedClusterOperationResults/1ca6e48d-70ca-4e43-b652-3b0522f64d67?api-version=2025-07-01-preview"
+      }
+    }
+  },
+  "operationId": "Applications_StartRollback",
+  "title": "Start an application upgrade rollback"
+}

specification/servicefabricmanagedclusters/ServiceFabricManagedClusters.Management/examples/2025-07-01-preview/ApplicationDeleteOperation_example.json

@@ -0,0 +1,20 @@
+{
+  "parameters": {
+    "api-version": "2025-07-01-preview",
+    "applicationName": "myApp",
+    "clusterName": "myCluster",
+    "resourceGroupName": "resRg",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000"
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "Location": "http://10.91.140.224/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/operationResults/76053752-a423-4a80-b283-1dad1ba5f314?api-version=2025-07-01-preview",
+        "Retry-After": "10"
+      }
+    },
+    "204": {}
+  },
+  "operationId": "Applications_Delete",
+  "title": "Delete an application"
+}

specification/servicefabricmanagedclusters/ServiceFabricManagedClusters.Management/examples/2025-07-01-preview/ApplicationGetOperation_example.json

@@ -0,0 +1,61 @@
+{
+  "parameters": {
+    "api-version": "2025-07-01-preview",
+    "applicationName": "myApp",
+    "clusterName": "myCluster",
+    "resourceGroupName": "resRg",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "myApp",
+        "type": "Microsoft.ServiceFabric/managedClusters/applications",
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/managedclusters/myCluster/applications/myApp",
+        "location": "eastus",
+        "properties": {
+          "parameters": {
+            "param1": "value1"
+          },
+          "provisioningState": "Updating",
+          "upgradePolicy": {
+            "applicationHealthPolicy": {
+              "considerWarningAsError": true,
+              "defaultServiceTypeHealthPolicy": {
+                "maxPercentUnhealthyPartitionsPerService": 0,
+                "maxPercentUnhealthyReplicasPerPartition": 0,
+                "maxPercentUnhealthyServices": 0
+              },
+              "maxPercentUnhealthyDeployedApplications": 0,
+              "serviceTypeHealthPolicyMap": {
+                "service1": {
+                  "maxPercentUnhealthyPartitionsPerService": 30,
+                  "maxPercentUnhealthyReplicasPerPartition": 30,
+                  "maxPercentUnhealthyServices": 30
+                }
+              }
+            },
+            "forceRestart": false,
+            "instanceCloseDelayDuration": 600,
+            "recreateApplication": false,
+            "rollingUpgradeMonitoringPolicy": {
+              "failureAction": "Rollback",
+              "healthCheckRetryTimeout": "00:10:00",
+              "healthCheckStableDuration": "00:05:00",
+              "healthCheckWaitDuration": "00:02:00",
+              "upgradeDomainTimeout": "00:15:00",
+              "upgradeTimeout": "01:00:00"
+            },
+            "upgradeMode": "UnmonitoredAuto",
+            "upgradeReplicaSetCheckTimeout": 3600
+          },
+          "version": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/managedclusters/myCluster/applicationTypes/myAppType/versions/1.0"
+        },
+        "tags": {}
+      },
+      "headers": {}
+    }
+  },
+  "operationId": "Applications_Get",
+  "title": "Get an application"
+}

specification/servicefabricmanagedclusters/ServiceFabricManagedClusters.Management/examples/2025-07-01-preview/ApplicationListOperation_example.json

@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "api-version": "2025-07-01-preview",
+    "clusterName": "myCluster",
+    "resourceGroupName": "resRg",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "nextLink": "http://examplelink.com",
+        "value": [
+          {
+            "name": "myApp",
+            "type": "Microsoft.ServiceFabric/managedClusters/applications",
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/managedclusters/myCluster/applications/myApp",
+            "properties": {
+              "provisioningState": "Updating",
+              "version": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/managedclusters/myCluster/applicationTypes/myAppType/versions/1.0"
+            }
+          }
+        ]
+      },
+      "headers": {}
+    }
+  },
+  "operationId": "Applications_List",
+  "title": "Get a list of application resources"
+}

specification/servicefabricmanagedclusters/ServiceFabricManagedClusters.Management/examples/2025-07-01-preview/ApplicationPatchOperation_example.json

@@ -0,0 +1,68 @@
+{
+  "parameters": {
+    "api-version": "2025-07-01-preview",
+    "applicationName": "myApp",
+    "clusterName": "myCluster",
+    "parameters": {
+      "tags": {
+        "a": "b"
+      }
+    },
+    "resourceGroupName": "resRg",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "myApp",
+        "type": "Microsoft.ServiceFabric/managedClusters/applications",
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/managedclusters/myCluster/applications/myApp",
+        "location": "eastus",
+        "properties": {
+          "parameters": {
+            "param1": "value1"
+          },
+          "provisioningState": "Succeeded",
+          "upgradePolicy": {
+            "applicationHealthPolicy": {
+              "considerWarningAsError": true,
+              "defaultServiceTypeHealthPolicy": {
+                "maxPercentUnhealthyPartitionsPerService": 0,
+                "maxPercentUnhealthyReplicasPerPartition": 0,
+                "maxPercentUnhealthyServices": 0
+              },
+              "maxPercentUnhealthyDeployedApplications": 0,
+              "serviceTypeHealthPolicyMap": {
+                "service1": {
+                  "maxPercentUnhealthyPartitionsPerService": 30,
+                  "maxPercentUnhealthyReplicasPerPartition": 30,
+                  "maxPercentUnhealthyServices": 30
+                }
+              }
+            },
+            "forceRestart": false,
+            "instanceCloseDelayDuration": 600,
+            "recreateApplication": false,
+            "rollingUpgradeMonitoringPolicy": {
+              "failureAction": "Rollback",
+              "healthCheckRetryTimeout": "00:10:00",
+              "healthCheckStableDuration": "00:05:00",
+              "healthCheckWaitDuration": "00:02:00",
+              "upgradeDomainTimeout": "00:15:00",
+              "upgradeTimeout": "01:00:00"
+            },
+            "upgradeMode": "UnmonitoredAuto",
+            "upgradeReplicaSetCheckTimeout": 3600
+          },
+          "version": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/managedclusters/myCluster/applicationTypes/myAppType/versions/1.0"
+        },
+        "tags": {
+          "a": "b"
+        }
+      },
+      "headers": {}
+    }
+  },
+  "operationId": "Applications_Update",
+  "title": "Patch an application"
+}