[servicefabricmanagedclusters] 2025-10-01-preview (Azure#37886)

2025-10-01-preview for servicefabricmanagedclusters

Author: iliu816

specification/servicefabricmanagedclusters/resource-manager/Microsoft.ServiceFabric/ServiceFabricManagedClusters/ApplicationResource.tsp

@@ -2,11 +2,13 @@ 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";
 
 using TypeSpec.Rest;
 using Azure.ResourceManager;
 using TypeSpec.Http;
+using TypeSpec.Versioning;
 
 namespace Microsoft.ServiceFabric;
 /**
@@ -58,12 +60,17 @@ interface Applications {
   >;
 
   /**
-   * Updates the tags of an application resource of a given managed cluster.
+   * Updates an application resource of a given managed cluster.
    */
+  #suppress "@azure-tools/typespec-azure-resource-manager/no-response-body" "Day 0 Property"
   @patch(#{ implicitOptionality: false })
-  update is ArmCustomPatchSync<
+  update is ArmCustomPatchAsync<
     ApplicationResource,
-    PatchModel = ApplicationUpdateParameters
+    PatchModel = ApplicationUpdateParameters,
+    Response = ArmResourceUpdatedResponse<ApplicationResource> | (ArmAcceptedLroResponse<LroHeaders = ArmCombinedLroHeaders<FinalResult = ApplicationResource>> & {
+      @bodyRoot
+      _: ApplicationResource;
+    })
   >;
 
   /**
@@ -122,6 +129,28 @@ interface Applications {
     never,
     LroHeaders = ArmCombinedLroHeaders
   >;
+
+  /**
+   * Get the status of the deployed application health. It will query the cluster to find the health of the deployed application.
+   */
+  @added(Versions.v2025_10_01_preview)
+  fetchHealth is ArmResourceActionAsync<
+    ApplicationResource,
+    ApplicationFetchHealthRequest,
+    never,
+    LroHeaders = ArmCombinedLroHeaders
+  >;
+
+  /**
+   * Restart a code package instance of a service replica or instance. This is a potentially destabilizing operation that should be used with immense care.
+   */
+  @added(Versions.v2025_10_01_preview)
+  restartDeployedCodePackage is ArmResourceActionAsync<
+    ApplicationResource,
+    RestartDeployedCodePackageRequest,
+    never,
+    LroHeaders = ArmCombinedLroHeaders
+  >;
 }
 
 @@doc(ApplicationResource.name, "The name of the application resource.");
@@ -138,6 +167,12 @@ interface Applications {
 @@doc(Applications.updateUpgrade::parameters.body,
   "The parameters for updating an application upgrade."
 );
+@@doc(Applications.fetchHealth::parameters.body,
+  "The parameters for fetching the health of a deployed application."
+);
+@@doc(Applications.restartDeployedCodePackage::parameters.body,
+  "The parameters for restarting a deployed code package."
+);
 
 /**
  * The application resource properties.
@@ -312,6 +347,18 @@ model ApplicationUserAssignedIdentity {
   principalId: string;
 }
 
+/**
+ * Properties for application update request.
+ */
+@added(Versions.v2025_10_01_preview)
+model ApplicationUpdateParametersProperties {
+  /**
+   * List of application parameters with overridden values from their default values specified in the application manifest.
+   */
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-no-record" "Patch operation expects same format as create or update, used to pass string to string dictionary"
+  parameters?: Record<string>;
+}
+
 /**
  * Application update request.
  */
@@ -322,6 +369,12 @@ model ApplicationUpdateParameters {
    */
   #suppress "@azure-tools/typespec-azure-resource-manager/arm-no-record" "Day 0 property, used to pass string to string dictionary"
   tags?: Record<string>;
+
+  /**
+   * Application update parameters properties.
+   */
+  @added(Versions.v2025_10_01_preview)
+  properties?: ApplicationUpdateParametersProperties;
 }
 
 /**
@@ -618,3 +671,103 @@ model RuntimeUpdateApplicationUpgradeParameters {
    */
   updateDescription?: RuntimeRollingUpgradeUpdateMonitoringPolicy;
 }
+
+/**
+ * Enum for filtering health events.
+ */
+@added(Versions.v2025_10_01_preview)
+union HealthFilter {
+  string,
+
+  /**
+   * Default value. Matches any health state.
+   */
+  Default: "Default",
+
+  /**
+   * Filter that doesn't match any health state. Used to return no results on a given collection of health entities.
+   */
+  None: "None",
+
+  /**
+   * Filter for health state Ok.
+   */
+  Ok: "Ok",
+
+  /**
+   * Filter for health state Warning.
+   */
+  Warning: "Warning",
+
+  /**
+   * Filter for health state Error.
+   */
+  Error: "Error",
+
+  /**
+   * Filter that matches input with any health state.
+   */
+  All: "All",
+}
+
+/**
+ * Parameters for fetching the health of an application.
+ */
+@added(Versions.v2025_10_01_preview)
+model ApplicationFetchHealthRequest {
+  /**
+   * Allows filtering of the health events returned in the response based on health state.
+   */
+  eventsHealthStateFilter?: HealthFilter;
+
+  /**
+   * Allows filtering of the deployed applications health state objects returned in the result of application health query based on their health state.
+   */
+  deployedApplicationsHealthStateFilter?: HealthFilter;
+
+  /**
+   * Allows filtering of the services health state objects returned in the result of services health query based on their health state.
+   */
+  servicesHealthStateFilter?: HealthFilter;
+
+  /**
+   * Indicates whether the health statistics should be returned as part of the query result. False by default. The statistics show the number of children entities in health state Ok, Warning, and Error.
+   */
+  excludeHealthStatistics?: boolean = false;
+
+  /**
+   * Request timeout for the health query in seconds. The default value is 60 seconds.
+   */
+  timeout?: int64 = 60;
+}
+
+/**
+ * Parameters for restarting a deployed code package.
+ */
+@added(Versions.v2025_10_01_preview)
+model RestartDeployedCodePackageRequest {
+  /**
+   * The name of the node where the code package needs to be restarted. Use '*' to restart on all nodes where the code package is running.
+   */
+  nodeName: string;
+
+  /**
+   * The name of the service manifest as specified in the code package.
+   */
+  serviceManifestName: string;
+
+  /**
+   * The name of the code package as specified in the service manifest.
+   */
+  codePackageName: string;
+
+  /**
+   * The instance ID for currently running entry point. For a code package setup entry point (if specified) runs first and after it finishes main entry point is started. Each time entry point executable is run, its instance ID will change. If 0 is passed in as the code package instance ID, the API will restart the code package with whatever instance ID it is currently running. If an instance ID other than 0 is passed in, the API will restart the code package only if the current Instance ID matches the passed in instance ID. Note, passing in the exact instance ID (not 0) in the API is safer, because if ensures at most one restart of the code package.
+   */
+  codePackageInstanceId: string;
+
+  /**
+   * The activation id of a deployed service package. If ServicePackageActivationMode specified at the time of creating the service is 'SharedProcess' (or if it is not specified, in which case it defaults to 'SharedProcess'), then value of ServicePackageActivationId is always an empty string.
+   */
+  servicePackageActivationId?: string;
+}

specification/servicefabricmanagedclusters/resource-manager/Microsoft.ServiceFabric/ServiceFabricManagedClusters/ManagedCluster.tsp

@@ -64,10 +64,15 @@ interface ManagedClusters {
   /**
    * Update the tags of of a Service Fabric managed cluster resource with the specified name.
    */
+  #suppress "@azure-tools/typespec-azure-resource-manager/no-response-body" "Day 0 Property"
   @patch(#{ implicitOptionality: false })
-  update is ArmCustomPatchSync<
+  update is ArmCustomPatchAsync<
     ManagedCluster,
-    PatchModel = ManagedClusterUpdateParameters
+    PatchModel = ManagedClusterUpdateParameters,
+    Response = ArmResourceUpdatedResponse<ManagedCluster> | (ArmAcceptedLroResponse<LroHeaders = ArmCombinedLroHeaders<FinalResult = ManagedCluster>> & {
+      @bodyRoot
+      _: ManagedCluster;
+    })
   >;
 
   /**

specification/servicefabricmanagedclusters/resource-manager/Microsoft.ServiceFabric/ServiceFabricManagedClusters/NodeType.tsp

@@ -54,7 +54,7 @@ interface NodeTypes {
   >;
 
   /**
-   * Update the configuration of a node type of a given managed cluster, only updating tags.
+   * Update the configuration of a node type of a given managed cluster, only updating tags or capacity.
    */
   @patch(#{ implicitOptionality: false })
   update is ArmCustomPatchAsync<

specification/servicefabricmanagedclusters/resource-manager/Microsoft.ServiceFabric/ServiceFabricManagedClusters/ServiceResource.tsp

@@ -78,6 +78,14 @@ interface Services {
     ServiceResource,
     Response = ArmResponse<ServiceResourceList>
   >;
+
+  @added(Versions.v2025_10_01_preview)
+  restartReplica is ArmResourceActionAsync<
+    ServiceResource,
+    RestartReplicaRequest,
+    never,
+    LroHeaders = ArmCombinedLroHeaders
+  >;
 }
 
 @@doc(ServiceResource.name,
@@ -88,6 +96,9 @@ interface Services {
 @@doc(Services.update::parameters.properties,
   "The service resource updated tags."
 );
+@@doc(Services.restartReplica::parameters.body,
+  "The parameters for restarting replicas."
+);
 
 /**
  * The service resource properties.
@@ -806,3 +817,47 @@ union MoveCost {
    */
   High: "High",
 }
+
+/**
+ * Request to restart a replica.
+ */
+@added(Versions.v2025_10_01_preview)
+model RestartReplicaRequest {
+  /**
+   * The ID of the partition.
+   */
+  partitionId: string;
+
+  /**
+   * The IDs of the replicas to be restarted.
+   */
+  replicaIds: int64[];
+
+  /**
+   *  The kind of restart to perform.
+   */
+  restartKind: RestartKind;
+
+  /**
+   * If true, the restart operation will be forced. Use this option with care, as it may cause data loss.
+   */
+  forceRestart?: boolean;
+
+  /**
+   * The server timeout for performing the operation in seconds. This timeout specifies the time duration that the client is willing to wait for the requested operation to complete. The default value for this parameter is 60 seconds.
+   */
+  timeout?: int64;
+}
+
+/**
+ *  The kind of restart to perform.
+ */
+@added(Versions.v2025_10_01_preview)
+union RestartKind {
+  string,
+
+  /**
+   * Restart all listed replicas at the same time.
+   */
+  Simultaneous: "Simultaneous",
+}

specification/servicefabricmanagedclusters/resource-manager/Microsoft.ServiceFabric/ServiceFabricManagedClusters/client.tsp

@@ -45,12 +45,17 @@ using Microsoft.ServiceFabric;
 @@clientName(Applications.update::parameters.properties, "parameters");
 @@clientName(Applications.resumeUpgrade::parameters.body, "parameters");
 @@clientName(Applications.updateUpgrade::parameters.body, "parameters");
+@@clientName(Applications.fetchHealth::parameters.body, "parameters");
+@@clientName(Applications.restartDeployedCodePackage::parameters.body,
+  "parameters"
+);
 #suppress "@azure-tools/typespec-azure-core/no-legacy-usage" "@Azure.ClientGenerator.Core.Legacy.flattenProperty decorator for backwards compatibility with existing spec"
 @@Azure.ClientGenerator.Core.Legacy.flattenProperty(ApplicationResource.properties
 );
 
 @@clientName(Services.createOrUpdate::parameters.resource, "parameters");
 @@clientName(Services.update::parameters.properties, "parameters");
+@@clientName(Services.restartReplica::parameters.body, "parameters");
 
 @@clientName(ManagedClusters.createOrUpdate::parameters.resource, "parameters");
 @@clientName(ManagedClusters.update::parameters.properties, "parameters");

specification/servicefabricmanagedclusters/resource-manager/Microsoft.ServiceFabric/ServiceFabricManagedClusters/examples/2024-11-01-preview/ApplicationDeleteOperation_example.json

@@ -9,8 +9,8 @@
   "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=2024-11-01-preview",
-        "Retry-After": "10"
+        "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=2024-11-01-preview",
+        "Location": "http://10.91.140.224/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/operationResults/9c2ce367-47ea-43de-b69e-c5a423da4557?api-version=2024-11-01-preview"
       }
     },
     "204": {}