Add TypeSpec versioning decorators for ContainerApps 2026-01-01 stable

Nan Jiang · Copilot · Nan Jiang · commit 60acf2198fcb · 2026-04-21T16:54:21.000+08:00
- Add @added/@removed decorators to properly version-gate preview-only resources, operations, and properties - Add named scalar types (Parallelism, PollingInterval, ReplicaCompletionCount, WorkloadProfileName, WorkloadProfileType) to match existing swagger definitions - Add WorkflowFiles model - Remove @previewVersion from non-last version enum member Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
diff --git a/specification/app/resource-manager/Microsoft.App/ContainerApps/AppResiliency.tsp b/specification/app/resource-manager/Microsoft.App/ContainerApps/AppResiliency.tsp
@@ -8,11 +8,14 @@ using TypeSpec.Rest;
 using Azure.ResourceManager;
 using TypeSpec.Http;
 using TypeSpec.OpenAPI;
+using TypeSpec.Versioning;
 
 namespace Microsoft.App;
 /**
  * Configuration to setup App Resiliency
  */
+@added(Versions.v2025_10_02_preview)
+@removed(Versions.v2026_01_01)
 model AppResiliency
   is Azure.ResourceManager.ProxyResource<AppResiliencyProperties> {
   ...ResourceNameParameter<
@@ -48,6 +51,8 @@ alias AppResiliencyOps = Azure.ResourceManager.Legacy.LegacyOperations<
   ErrorType = DefaultErrorResponse
 >;
 
+@added(Versions.v2025_10_02_preview)
+@removed(Versions.v2026_01_01)
 @armResourceOperations
 @tag("AppResiliency")
 interface AppResiliencies {
diff --git a/specification/app/resource-manager/Microsoft.App/ContainerApps/Build.tsp b/specification/app/resource-manager/Microsoft.App/ContainerApps/Build.tsp
@@ -9,11 +9,14 @@ using TypeSpec.Rest;
 using Azure.ResourceManager;
 using TypeSpec.Http;
 using TypeSpec.OpenAPI;
+using TypeSpec.Versioning;
 
 namespace Microsoft.App;
 /**
  * Information pertaining to an individual build.
  */
+@added(Versions.v2025_10_02_preview)
+@removed(Versions.v2026_01_01)
 @parentResource(BuilderResource)
 model BuildResource is Azure.ResourceManager.ProxyResource<BuildProperties> {
   ...ResourceNameParameter<
@@ -24,6 +27,8 @@ model BuildResource is Azure.ResourceManager.ProxyResource<BuildProperties> {
   >;
 }
 
+@added(Versions.v2025_10_02_preview)
+@removed(Versions.v2026_01_01)
 @armResourceOperations
 interface Builds {
   /**
diff --git a/specification/app/resource-manager/Microsoft.App/ContainerApps/Builder.tsp b/specification/app/resource-manager/Microsoft.App/ContainerApps/Builder.tsp
@@ -8,11 +8,14 @@ using TypeSpec.Rest;
 using Azure.ResourceManager;
 using TypeSpec.Http;
 using TypeSpec.OpenAPI;
+using TypeSpec.Versioning;
 
 namespace Microsoft.App;
 /**
  * Information about the SourceToCloud builder resource.
  */
+@added(Versions.v2025_10_02_preview)
+@removed(Versions.v2026_01_01)
 model BuilderResource
   is Azure.ResourceManager.TrackedResource<BuilderProperties> {
   ...ResourceNameParameter<
@@ -24,6 +27,8 @@ model BuilderResource
   ...Azure.ResourceManager.ManagedServiceIdentityProperty;
 }
 
+@added(Versions.v2025_10_02_preview)
+@removed(Versions.v2026_01_01)
 @armResourceOperations
 interface Builders {
   /**
diff --git a/specification/app/resource-manager/Microsoft.App/ContainerApps/ContainerAppsBuild.tsp b/specification/app/resource-manager/Microsoft.App/ContainerApps/ContainerAppsBuild.tsp
@@ -9,11 +9,14 @@ using TypeSpec.Rest;
 using Azure.ResourceManager;
 using TypeSpec.Http;
 using TypeSpec.OpenAPI;
+using TypeSpec.Versioning;
 
 namespace Microsoft.App;
 /**
  * Information pertaining to an individual build.
  */
+@added(Versions.v2025_10_02_preview)
+@removed(Versions.v2026_01_01)
 @parentResource(ContainerApp)
 model ContainerAppsBuildResource
   is Azure.ResourceManager.ProxyResource<ContainerAppsBuildProperties> {
@@ -51,6 +54,8 @@ alias ContainerAppsBuildResourceOps = Azure.ResourceManager.Legacy.LegacyOperati
   }
 >;
 
+@added(Versions.v2025_10_02_preview)
+@removed(Versions.v2026_01_01)
 @armResourceOperations
 interface ContainerAppsBuilds {
   /**
diff --git a/specification/app/resource-manager/Microsoft.App/ContainerApps/ContainerAppsFunction.tsp b/specification/app/resource-manager/Microsoft.App/ContainerApps/ContainerAppsFunction.tsp
@@ -9,11 +9,14 @@ using TypeSpec.Rest;
 using Azure.ResourceManager;
 using TypeSpec.Http;
 using TypeSpec.OpenAPI;
+using TypeSpec.Versioning;
 
 namespace Microsoft.App;
 /**
  * Container App Function.
  */
+@added(Versions.v2025_10_02_preview)
+@removed(Versions.v2026_01_01)
 @parentResource(Revision)
 model ContainerAppsFunction
   is Azure.ResourceManager.ProxyResource<ContainerAppsFunctionProperties> {
@@ -82,6 +85,8 @@ alias ContainerAppsFunctionOperationGroupOps = Azure.ResourceManager.Legacy.Lega
   ErrorType = DefaultErrorResponse
 >;
 
+@added(Versions.v2025_10_02_preview)
+@removed(Versions.v2026_01_01)
 @armResourceOperations
 @tag("AzureFunctionsOnContainerApps")
 interface ContainerAppsFunctions {
diff --git a/specification/app/resource-manager/Microsoft.App/ContainerApps/ContainerAppsPatchResource.tsp b/specification/app/resource-manager/Microsoft.App/ContainerApps/ContainerAppsPatchResource.tsp
@@ -9,11 +9,14 @@ using TypeSpec.Rest;
 using Azure.ResourceManager;
 using TypeSpec.Http;
 using TypeSpec.OpenAPI;
+using TypeSpec.Versioning;
 
 namespace Microsoft.App;
 /**
  * Container App Patch
  */
+@added(Versions.v2025_10_02_preview)
+@removed(Versions.v2026_01_01)
 @parentResource(ContainerApp)
 model ContainerAppsPatchResource
   is Azure.ResourceManager.ProxyResource<PatchProperties> {
@@ -51,6 +54,8 @@ alias ContainerAppsPatchesOps = Azure.ResourceManager.Legacy.LegacyOperations<
   }
 >;
 
+@added(Versions.v2025_10_02_preview)
+@removed(Versions.v2026_01_01)
 @armResourceOperations
 interface ContainerAppsPatches {
   /**
diff --git a/specification/app/resource-manager/Microsoft.App/ContainerApps/ContainerAppsSessionPool.tsp b/specification/app/resource-manager/Microsoft.App/ContainerApps/ContainerAppsSessionPool.tsp
@@ -8,6 +8,7 @@ using TypeSpec.Rest;
 using Azure.ResourceManager;
 using TypeSpec.Http;
 using TypeSpec.OpenAPI;
+using TypeSpec.Versioning;
 
 namespace Microsoft.App;
 /**
@@ -79,6 +80,8 @@ interface ContainerAppsSessionPools {
    * Fetch the MCP server credentials of a session pool.
    */
   @summary("Fetch the MCP server credentials of a session pool.")
+  @added(Versions.v2025_10_02_preview)
+  @removed(Versions.v2026_01_01)
   fetchMcpServerCredentials is ArmResourceActionSync<
     SessionPool,
     void,
@@ -89,6 +92,8 @@ interface ContainerAppsSessionPools {
    * Rotate and fetch the rotated MCP server credentials of a session pool.
    */
   @summary("Rotate and fetch the rotated MCP server credentials of a session pool.")
+  @added(Versions.v2025_10_02_preview)
+  @removed(Versions.v2026_01_01)
   rotateMcpServerCredentials is ArmResourceActionSync<
     SessionPool,
     void,
diff --git a/specification/app/resource-manager/Microsoft.App/ContainerApps/DaprComponentResiliencyPolicy.tsp b/specification/app/resource-manager/Microsoft.App/ContainerApps/DaprComponentResiliencyPolicy.tsp
@@ -9,11 +9,14 @@ using TypeSpec.Rest;
 using Azure.ResourceManager;
 using TypeSpec.Http;
 using TypeSpec.OpenAPI;
+using TypeSpec.Versioning;
 
 namespace Microsoft.App;
 /**
  * Dapr Component Resiliency Policy.
  */
+@added(Versions.v2025_10_02_preview)
+@removed(Versions.v2026_01_01)
 @parentResource(DaprComponent)
 model DaprComponentResiliencyPolicy
   is Azure.ResourceManager.ProxyResource<DaprComponentResiliencyPolicyProperties> {
@@ -56,6 +59,8 @@ alias DaprComponentResiliencyPolicyOps = Azure.ResourceManager.Legacy.LegacyOper
   ErrorType = DefaultErrorResponse
 >;
 
+@added(Versions.v2025_10_02_preview)
+@removed(Versions.v2026_01_01)
 @armResourceOperations
 interface DaprComponentResiliencyPolicies {
   /**
diff --git a/specification/app/resource-manager/Microsoft.App/ContainerApps/DaprSubscription.tsp b/specification/app/resource-manager/Microsoft.App/ContainerApps/DaprSubscription.tsp
@@ -9,11 +9,14 @@ using TypeSpec.Rest;
 using Azure.ResourceManager;
 using TypeSpec.Http;
 using TypeSpec.OpenAPI;
+using TypeSpec.Versioning;
 
 namespace Microsoft.App;
 /**
  * Dapr PubSub Event Subscription.
  */
+@added(Versions.v2025_10_02_preview)
+@removed(Versions.v2026_01_01)
 @parentResource(ManagedEnvironment)
 model DaprSubscription
   is Azure.ResourceManager.ProxyResource<DaprSubscriptionProperties> {
@@ -49,6 +52,8 @@ alias DaprSubscriptionOps = Azure.ResourceManager.Legacy.LegacyOperations<
   ErrorType = DefaultErrorResponse
 >;
 
+@added(Versions.v2025_10_02_preview)
+@removed(Versions.v2026_01_01)
 @armResourceOperations
 interface DaprSubscriptions {
   /**
diff --git a/specification/app/resource-manager/Microsoft.App/ContainerApps/DotNetComponent.tsp b/specification/app/resource-manager/Microsoft.App/ContainerApps/DotNetComponent.tsp
@@ -8,11 +8,14 @@ using TypeSpec.Rest;
 using Azure.ResourceManager;
 using TypeSpec.Http;
 using TypeSpec.OpenAPI;
+using TypeSpec.Versioning;
 
 namespace Microsoft.App;
 /**
  * .NET Component.
  */
+@added(Versions.v2025_10_02_preview)
+@removed(Versions.v2026_01_01)
 @parentResource(ManagedEnvironment)
 model DotNetComponent
   is Azure.ResourceManager.ProxyResource<DotNetComponentProperties> {
@@ -48,6 +51,8 @@ alias DotNetComponentOps = Azure.ResourceManager.Legacy.LegacyOperations<
   }
 >;
 
+@added(Versions.v2025_10_02_preview)
+@removed(Versions.v2026_01_01)
 @armResourceOperations
 interface DotNetComponents {
   /**
diff --git a/specification/app/resource-manager/Microsoft.App/ContainerApps/Job.tsp b/specification/app/resource-manager/Microsoft.App/ContainerApps/Job.tsp
@@ -9,6 +9,7 @@ using Azure.ResourceManager;
 using Azure.ResourceManager.Foundations;
 using TypeSpec.Http;
 using TypeSpec.OpenAPI;
+using TypeSpec.Versioning;
 
 namespace Microsoft.App;
 /**
@@ -26,6 +27,8 @@ model Job is Azure.ResourceManager.TrackedResource<JobProperties> {
    * The complex type of the extended location.
    */
   #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @added(Versions.v2025_10_02_preview)
+  @removed(Versions.v2026_01_01)
   extendedLocation?: ExtendedLocation;
 
   ...Azure.ResourceManager.ManagedServiceIdentityProperty;
@@ -144,6 +147,8 @@ interface Jobs {
   @tag("Jobs")
   @summary("Resumes a suspended job")
   @Azure.Core.useFinalStateVia("azure-async-operation")
+  @added(Versions.v2025_10_02_preview)
+  @removed(Versions.v2026_01_01)
   resume is ArmResourceActionAsyncBase<
     Job,
     void,
@@ -159,6 +164,8 @@ interface Jobs {
   @tag("Jobs")
   @summary("Suspends a job")
   @Azure.Core.useFinalStateVia("azure-async-operation")
+  @added(Versions.v2025_10_02_preview)
+  @removed(Versions.v2026_01_01)
   suspend is ArmResourceActionAsyncBase<
     Job,
     void,
diff --git a/specification/app/resource-manager/Microsoft.App/ContainerApps/LabelHistory.tsp b/specification/app/resource-manager/Microsoft.App/ContainerApps/LabelHistory.tsp
@@ -9,11 +9,14 @@ using TypeSpec.Rest;
 using Azure.ResourceManager;
 using TypeSpec.Http;
 using TypeSpec.OpenAPI;
+using TypeSpec.Versioning;
 
 namespace Microsoft.App;
 /**
  * Container App Label History.
  */
+@added(Versions.v2025_10_02_preview)
+@removed(Versions.v2026_01_01)
 @parentResource(ContainerApp)
 model LabelHistory
   is Azure.ResourceManager.ProxyResource<LabelHistoryProperties> {
@@ -50,6 +53,8 @@ alias LabelHistoryOps = Azure.ResourceManager.Legacy.LegacyOperations<
   ErrorType = DefaultErrorResponse
 >;
 
+@added(Versions.v2025_10_02_preview)
+@removed(Versions.v2026_01_01)
 @armResourceOperations
 interface ContainerAppsLabelHistory {
   /**
diff --git a/specification/app/resource-manager/Microsoft.App/ContainerApps/LogicApp.tsp b/specification/app/resource-manager/Microsoft.App/ContainerApps/LogicApp.tsp
@@ -9,6 +9,7 @@ using TypeSpec.Rest;
 using Azure.ResourceManager;
 using TypeSpec.Http;
 using TypeSpec.OpenAPI;
+using TypeSpec.Versioning;
 
 namespace Microsoft.App;
 /**
@@ -69,6 +70,8 @@ interface LogicApps {
   /**
    * Creates or updates the artifacts for the logic app
    */
+  @added(Versions.v2025_10_02_preview)
+  @removed(Versions.v2026_01_01)
   deployWorkflowArtifacts is ArmResourceActionSync<
     LogicApp,
     WorkflowArtifacts,
@@ -94,6 +97,8 @@ interface LogicApps {
    * Proxies a the API call to the logic app backed by the container app.
    */
   @summary("Proxies a the API call to the logic app backed by the container app.")
+  @added(Versions.v2025_10_02_preview)
+  @removed(Versions.v2026_01_01)
   invoke is ArmResourceActionSync<
     LogicApp,
     void,
diff --git a/specification/app/resource-manager/Microsoft.App/ContainerApps/Revision.tsp b/specification/app/resource-manager/Microsoft.App/ContainerApps/Revision.tsp
@@ -9,6 +9,7 @@ using TypeSpec.Rest;
 using Azure.ResourceManager;
 using TypeSpec.Http;
 using TypeSpec.OpenAPI;
+using TypeSpec.Versioning;
 
 namespace Microsoft.App;
 /**
@@ -118,6 +119,8 @@ alias FunctionExtensionOps = Azure.ResourceManager.Legacy.LegacyOperations<
   ErrorType = DefaultErrorResponse
 >;
 
+@added(Versions.v2025_10_02_preview)
+@removed(Versions.v2026_01_01)
 @armResourceOperations
 interface FunctionsExtension {
   /**
diff --git a/specification/app/resource-manager/Microsoft.App/ContainerApps/main.tsp b/specification/app/resource-manager/Microsoft.App/ContainerApps/main.tsp
@@ -70,6 +70,11 @@ enum Versions {
    * The 2025-10-02-preview API version.
    */
   v2025_10_02_preview: "2025-10-02-preview",
+
+  /**
+   * The 2026-01-01 API version.
+   */
+  v2026_01_01: "2026-01-01",
 }
 
 interface Operations
diff --git a/specification/app/resource-manager/Microsoft.App/ContainerApps/models.tsp b/specification/app/resource-manager/Microsoft.App/ContainerApps/models.tsp
