Add an extra field absolute-start-time to Scheduled Start Properties (#41996)

Author: JunyuQian

specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/Gates_Get_ScheduledStart.json

@@ -42,7 +42,8 @@
           "scheduledStartProperties": {
             "startDay": "Friday",
             "startTime": "18:00",
-            "utcOffset": "-05:00"
+            "utcOffset": "-05:00",
+            "absoluteStartTime": "2026-04-04T23:00:00Z"
           },
           "state": "Pending"
         }

specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/Gates_ListByFleet.json

@@ -68,7 +68,8 @@
               "scheduledStartProperties": {
                 "startDay": "Friday",
                 "startTime": "18:00",
-                "utcOffset": "-05:00"
+                "utcOffset": "-05:00",
+                "absoluteStartTime": "2026-04-04T23:00:00Z"
               },
               "state": "Pending"
             }

specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/gate.tsp

@@ -115,6 +115,10 @@ model ScheduledStartProperties {
   @visibility(Lifecycle.Create, Lifecycle.Read)
   @pattern("^[+-]((0[0-9]|1[0-3]):[0-5][0-9]|14:00)$")
   utcOffset: string;
+
+  @doc("The absolute UTC time when the gate will complete. Set when the gate is created.")
+  @visibility(Lifecycle.Read)
+  absoluteStartTime: utcDateTime;
 }
 
 @doc("The properties of the Update Run that the Gate is targeting.")

specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/examples/Gates_Get_ScheduledStart.json

@@ -42,7 +42,8 @@
           "scheduledStartProperties": {
             "startDay": "Friday",
             "startTime": "18:00",
-            "utcOffset": "-05:00"
+            "utcOffset": "-05:00",
+            "absoluteStartTime": "2026-04-04T23:00:00Z"
           },
           "state": "Pending"
         }

specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/examples/Gates_ListByFleet.json

@@ -68,7 +68,8 @@
               "scheduledStartProperties": {
                 "startDay": "Friday",
                 "startTime": "18:00",
-                "utcOffset": "-05:00"
+                "utcOffset": "-05:00",
+                "absoluteStartTime": "2026-04-04T23:00:00Z"
               },
               "state": "Pending"
             }

specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/fleets.json

@@ -5649,12 +5649,19 @@
             "read",
             "create"
           ]
+        },
+        "absoluteStartTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The absolute UTC time when the gate will complete. Set when the gate is created.",
+          "readOnly": true
         }
       },
       "required": [
         "startDay",
         "startTime",
-        "utcOffset"
+        "utcOffset",
+        "absoluteStartTime"
       ]
     },
     "SkipProperties": {