Update CLI to rename changeRecords for 2026-01-01-repview

Author: Henry Dai

src/azure-changesafety/README.md

@@ -19,15 +19,14 @@ az changesafety changerecord show    # Display details for a ChangeRecord resour
 Run `az changesafety changerecord -h` to see full parameter details and examples.
 
 ## Examples
-Create a ChangeRecord for a manual touch operation (e.g., VM maintenance):
+Create a ChangeRecord for a manual touch operation (e.g., Deletes a traffic manager profile):
 ```bash
 az changesafety changerecord create \
   -g MyResourceGroup \
   -n changerecord-vm-maintenance \
   --change-type ManualTouch \
   --rollout-type Normal \
-  --targets "resourceId=/subscriptions/<subId>/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVm,operation=PATCH" \
-  --stagemap-name myStageMap
+  --targets "subscriptionId=<subId>,operation=DELETES" \
 ```
 
 Create a ChangeRecord for an app deployment with a StageMap reference:

…/aaz/latest/change_safety/__cmd_group.py …y/aaz/latest/changesafety/__cmd_group.pysrc/azure-changesafety/azext_changesafety/aaz/latest/change_safety/__cmd_group.py renamed to src/azure-changesafety/azext_changesafety/aaz/latest/changesafety/__cmd_group.py src/azure-changesafety/azext_changesafety/aaz/latest/change_safety/__cmd_group.py renamed to src/azure-changesafety/azext_changesafety/aaz/latest/changesafety/__cmd_group.py

@@ -15,7 +15,7 @@
     "changesafety",
 )
 class __CMDGroup(AAZCommandGroup):
-    """Manage Change Safety
+    """Manage Changesafety
     """
     pass
 

…ety/aaz/latest/change_safety/__init__.py …fety/aaz/latest/changesafety/__init__.pysrc/azure-changesafety/azext_changesafety/aaz/latest/change_safety/__init__.py renamed to src/azure-changesafety/azext_changesafety/aaz/latest/changesafety/__init__.py src/azure-changesafety/azext_changesafety/aaz/latest/change_safety/__init__.py renamed to src/azure-changesafety/azext_changesafety/aaz/latest/changesafety/__init__.py

@@ -12,10 +12,10 @@
 
 
 @register_command_group(
-    "changesafety changestate",
+    "changesafety changerecord",
 )
 class __CMDGroup(AAZCommandGroup):
-    """Manage Change State
+    """Manage Change Record
     """
     pass
 

…hange_safety/change_state/__cmd_group.py …changesafety/changerecord/__cmd_group.pysrc/azure-changesafety/azext_changesafety/aaz/latest/change_safety/change_state/__cmd_group.py renamed to src/azure-changesafety/azext_changesafety/aaz/latest/changesafety/changerecord/__cmd_group.py src/azure-changesafety/azext_changesafety/aaz/latest/change_safety/change_state/__cmd_group.py renamed to src/azure-changesafety/azext_changesafety/aaz/latest/changesafety/changerecord/__cmd_group.py

@@ -11,5 +11,6 @@
 from .__cmd_group import *
 from ._create import *
 from ._delete import *
+from ._list import *
 from ._show import *
 from ._update import *

…nge_safety/stage_progression/__init__.py …st/changesafety/changerecord/__init__.pysrc/azure-changesafety/azext_changesafety/aaz/latest/change_safety/stage_progression/__init__.py renamed to src/azure-changesafety/azext_changesafety/aaz/latest/changesafety/changerecord/__init__.py src/azure-changesafety/azext_changesafety/aaz/latest/change_safety/stage_progression/__init__.py renamed to src/azure-changesafety/azext_changesafety/aaz/latest/changesafety/changerecord/__init__.py

@@ -12,17 +12,17 @@
 
 
 @register_command(
-    "changesafety changestate create",
+    "changesafety changerecord create",
 )
 class Create(AAZCommand):
     """Create a ChangeRecord
     """
 
     _aaz_info = {
-        "version": "2025-09-01-preview",
+        "version": "2026-01-01-preview",
         "resources": [
-            ["mgmt-plane", "/subscriptions/{}/providers/Microsoft.ChangeSafety/changestates/{}", "2025-09-01-preview"],
-            ["mgmt-plane", "/subscriptions/{}/resourcegroups/{}/providers/Microsoft.ChangeSafety/changestates/{}", "2025-09-01-preview"],
+            ["mgmt-plane", "/subscriptions/{}/providers/microsoft.changesafety/changerecords/{}", "2026-01-01-preview"],
+            ["mgmt-plane", "/subscriptions/{}/resourcegroups/{}/providers/microsoft.changesafety/changerecords/{}", "2026-01-01-preview"],
         ]
     }
 
@@ -42,7 +42,7 @@ def _build_arguments_schema(cls, *args, **kwargs):
         # define Arg Group ""
 
         _args_schema = cls._args_schema
-        _args_schema.change_state_name = AAZStrArg(
+        _args_schema.change_record_name = AAZStrArg(
             options=["-n", "--name", "--change-record-name"],
             help="The name of the ChangeRecord resource.",
             required=True,
@@ -79,6 +79,11 @@ def _build_arguments_schema(cls, *args, **kwargs):
                 protocol="iso",
             ),
         )
+        _args_schema.change_definition = AAZObjectArg(
+            options=["--change-definition"],
+            arg_group="Properties",
+            help="Change request body and/or resource selection criteria used to identify the targeted resources.",
+        )
         _args_schema.change_type = AAZStrArg(
             options=["--change-type"],
             arg_group="Properties",
@@ -133,6 +138,25 @@ def _build_arguments_schema(cls, *args, **kwargs):
             help="Reference to the StageMap, defining progression.",
         )
 
+        change_definition = cls._args_schema.change_definition
+        change_definition.details = AAZObjectArg(
+            options=["details"],
+            help="Free form object containing additional details for the change definition.",
+            required=True,
+            blank={},
+        )
+        change_definition.kind = AAZStrArg(
+            options=["kind"],
+            help="Kind of the change definition.",
+            required=True,
+            enum={"ApiOperations": "ApiOperations", "Targets": "Targets"},
+        )
+        change_definition.name = AAZStrArg(
+            options=["name"],
+            help="Name of the change definition.",
+            required=True,
+        )
+
         links = cls._args_schema.links
         links.Element = AAZObjectArg()
 
@@ -254,12 +278,12 @@ def _build_arguments_schema(cls, *args, **kwargs):
 
     def _execute_operations(self):
         self.pre_operations()
-        condition_0 = has_value(self.ctx.args.change_state_name) and has_value(self.ctx.subscription_id) and has_value(self.ctx.args.resource_group) is not True
-        condition_1 = has_value(self.ctx.args.change_state_name) and has_value(self.ctx.args.resource_group) and has_value(self.ctx.subscription_id)
+        condition_0 = has_value(self.ctx.args.change_record_name) and has_value(self.ctx.subscription_id) and has_value(self.ctx.args.resource_group) is not True
+        condition_1 = has_value(self.ctx.args.change_record_name) and has_value(self.ctx.args.resource_group) and has_value(self.ctx.subscription_id)
         if condition_0:
-            self.ChangeStatesCreateOrUpdateAtSubscriptionLevel(ctx=self.ctx)()
+            self.ChangeRecordsCreateOrUpdateAtSubscriptionLevel(ctx=self.ctx)()
         if condition_1:
-            self.ChangeStatesCreateOrUpdate(ctx=self.ctx)()
+            self.ChangeRecordsCreateOrUpdate(ctx=self.ctx)()
         self.post_operations()
 
     @register_callback
@@ -274,7 +298,7 @@ def _output(self, *args, **kwargs):
         result = self.deserialize_output(self.ctx.vars.instance, client_flatten=True)
         return result
 
-    class ChangeStatesCreateOrUpdateAtSubscriptionLevel(AAZHttpOperation):
+    class ChangeRecordsCreateOrUpdateAtSubscriptionLevel(AAZHttpOperation):
         CLIENT_TYPE = "MgmtClient"
 
         def __call__(self, *args, **kwargs):
@@ -288,7 +312,7 @@ def __call__(self, *args, **kwargs):
         @property
         def url(self):
             return self.client.format_url(
-                "/subscriptions/{subscriptionId}/providers/Microsoft.ChangeSafety/changeStates/{changeStateName}",
+                "/subscriptions/{subscriptionId}/providers/Microsoft.ChangeSafety/changeRecords/{changeRecordName}",
                 **self.url_parameters
             )
 
@@ -304,7 +328,7 @@ def error_format(self):
         def url_parameters(self):
             parameters = {
                 **self.serialize_url_param(
-                    "changeStateName", self.ctx.args.change_state_name,
+                    "changeRecordName", self.ctx.args.change_record_name,
                     required=True,
                 ),
                 **self.serialize_url_param(
@@ -318,7 +342,7 @@ def url_parameters(self):
         def query_parameters(self):
             parameters = {
                 **self.serialize_query_param(
-                    "api-version", "2025-09-01-preview",
+                    "api-version", "2026-01-01-preview",
                     required=True,
                 ),
             }
@@ -350,6 +374,7 @@ def content(self):
                 properties.set_prop("additionalData", AAZObjectType, ".additional_data")
                 properties.set_prop("anticipatedEndTime", AAZStrType, ".anticipated_end_time", typ_kwargs={"flags": {"required": True}})
                 properties.set_prop("anticipatedStartTime", AAZStrType, ".anticipated_start_time", typ_kwargs={"flags": {"required": True}})
+                properties.set_prop("changeDefinition", AAZObjectType, ".change_definition", typ_kwargs={"flags": {"required": True}})
                 properties.set_prop("changeType", AAZStrType, ".change_type", typ_kwargs={"flags": {"required": True}})
                 properties.set_prop("comments", AAZStrType, ".comments")
                 properties.set_prop("description", AAZStrType, ".description")
@@ -360,6 +385,12 @@ def content(self):
                 properties.set_prop("rolloutType", AAZStrType, ".rollout_type", typ_kwargs={"flags": {"required": True}})
                 properties.set_prop("stageMap", AAZObjectType, ".stage_map")
 
+            change_definition = _builder.get(".properties.changeDefinition")
+            if change_definition is not None:
+                change_definition.set_prop("details", AAZObjectType, ".details", typ_kwargs={"flags": {"required": True}})
+                change_definition.set_prop("kind", AAZStrType, ".kind", typ_kwargs={"flags": {"required": True}})
+                change_definition.set_prop("name", AAZStrType, ".name", typ_kwargs={"flags": {"required": True}})
+
             links = _builder.get(".properties.links")
             if links is not None:
                 links.set_elements(AAZObjectType, ".")
@@ -646,7 +677,7 @@ def _build_schema_on_200_201(cls):
 
             return cls._schema_on_200_201
 
-    class ChangeStatesCreateOrUpdate(AAZHttpOperation):
+    class ChangeRecordsCreateOrUpdate(AAZHttpOperation):
         CLIENT_TYPE = "MgmtClient"
 
         def __call__(self, *args, **kwargs):
@@ -660,7 +691,7 @@ def __call__(self, *args, **kwargs):
         @property
         def url(self):
             return self.client.format_url(
-                "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ChangeSafety/changeStates/{changeStateName}",
+                "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ChangeSafety/changeRecords/{changeRecordName}",
                 **self.url_parameters
             )
 
@@ -676,7 +707,7 @@ def error_format(self):
         def url_parameters(self):
             parameters = {
                 **self.serialize_url_param(
-                    "changeStateName", self.ctx.args.change_state_name,
+                    "changeRecordName", self.ctx.args.change_record_name,
                     required=True,
                 ),
                 **self.serialize_url_param(
@@ -694,7 +725,7 @@ def url_parameters(self):
         def query_parameters(self):
             parameters = {
                 **self.serialize_query_param(
-                    "api-version", "2025-09-01-preview",
+                    "api-version", "2026-01-01-preview",
                     required=True,
                 ),
             }
@@ -726,6 +757,7 @@ def content(self):
                 properties.set_prop("additionalData", AAZObjectType, ".additional_data")
                 properties.set_prop("anticipatedEndTime", AAZStrType, ".anticipated_end_time", typ_kwargs={"flags": {"required": True}})
                 properties.set_prop("anticipatedStartTime", AAZStrType, ".anticipated_start_time", typ_kwargs={"flags": {"required": True}})
+                properties.set_prop("changeDefinition", AAZObjectType, ".change_definition", typ_kwargs={"flags": {"required": True}})
                 properties.set_prop("changeType", AAZStrType, ".change_type", typ_kwargs={"flags": {"required": True}})
                 properties.set_prop("comments", AAZStrType, ".comments")
                 properties.set_prop("description", AAZStrType, ".description")
@@ -736,6 +768,12 @@ def content(self):
                 properties.set_prop("rolloutType", AAZStrType, ".rollout_type", typ_kwargs={"flags": {"required": True}})
                 properties.set_prop("stageMap", AAZObjectType, ".stage_map")
 
+            change_definition = _builder.get(".properties.changeDefinition")
+            if change_definition is not None:
+                change_definition.set_prop("details", AAZObjectType, ".details", typ_kwargs={"flags": {"required": True}})
+                change_definition.set_prop("kind", AAZStrType, ".kind", typ_kwargs={"flags": {"required": True}})
+                change_definition.set_prop("name", AAZStrType, ".name", typ_kwargs={"flags": {"required": True}})
+
             links = _builder.get(".properties.links")
             if links is not None:
                 links.set_elements(AAZObjectType, ".")

…st/change_safety/change_state/_create.py …est/changesafety/changerecord/_create.pysrc/azure-changesafety/azext_changesafety/aaz/latest/change_safety/change_state/_create.py renamed to src/azure-changesafety/azext_changesafety/aaz/latest/changesafety/changerecord/_create.py src/azure-changesafety/azext_changesafety/aaz/latest/change_safety/change_state/_create.py renamed to src/azure-changesafety/azext_changesafety/aaz/latest/changesafety/changerecord/_create.py

@@ -12,18 +12,18 @@
 
 
 @register_command(
-    "changesafety changestate delete",
+    "changesafety changerecord delete",
     confirmation="Are you sure you want to perform this operation?",
 )
 class Delete(AAZCommand):
     """Delete a ChangeRecord
     """
 
     _aaz_info = {
-        "version": "2025-09-01-preview",
+        "version": "2026-01-01-preview",
         "resources": [
-            ["mgmt-plane", "/subscriptions/{}/providers/Microsoft.ChangeSafety/changestates/{}", "2025-09-01-preview"],
-            ["mgmt-plane", "/subscriptions/{}/resourcegroups/{}/providers/Microsoft.ChangeSafety/changestates/{}", "2025-09-01-preview"],
+            ["mgmt-plane", "/subscriptions/{}/providers/microsoft.changesafety/changerecords/{}", "2026-01-01-preview"],
+            ["mgmt-plane", "/subscriptions/{}/resourcegroups/{}/providers/microsoft.changesafety/changerecords/{}", "2026-01-01-preview"],
         ]
     }
 
@@ -42,7 +42,7 @@ def _build_arguments_schema(cls, *args, **kwargs):
         # define Arg Group ""
 
         _args_schema = cls._args_schema
-        _args_schema.change_state_name = AAZStrArg(
+        _args_schema.change_record_name = AAZStrArg(
             options=["-n", "--name", "--change-record-name"],
             help="The name of the ChangeRecord resource.",
             required=True,
@@ -58,12 +58,12 @@ def _build_arguments_schema(cls, *args, **kwargs):
 
     def _execute_operations(self):
         self.pre_operations()
-        condition_0 = has_value(self.ctx.args.change_state_name) and has_value(self.ctx.subscription_id) and has_value(self.ctx.args.resource_group) is not True
-        condition_1 = has_value(self.ctx.args.change_state_name) and has_value(self.ctx.args.resource_group) and has_value(self.ctx.subscription_id)
+        condition_0 = has_value(self.ctx.args.change_record_name) and has_value(self.ctx.subscription_id) and has_value(self.ctx.args.resource_group) is not True
+        condition_1 = has_value(self.ctx.args.change_record_name) and has_value(self.ctx.args.resource_group) and has_value(self.ctx.subscription_id)
         if condition_0:
-            yield self.ChangeStatesDeleteAtSubscriptionLevel(ctx=self.ctx)()
+            yield self.ChangeRecordsDeleteAtSubscriptionLevel(ctx=self.ctx)()
         if condition_1:
-            yield self.ChangeStatesDelete(ctx=self.ctx)()
+            yield self.ChangeRecordsDelete(ctx=self.ctx)()
         self.post_operations()
 
     @register_callback
@@ -74,7 +74,7 @@ def pre_operations(self):
     def post_operations(self):
         pass
 
-    class ChangeStatesDeleteAtSubscriptionLevel(AAZHttpOperation):
+    class ChangeRecordsDeleteAtSubscriptionLevel(AAZHttpOperation):
         CLIENT_TYPE = "MgmtClient"
 
         def __call__(self, *args, **kwargs):
@@ -113,7 +113,7 @@ def __call__(self, *args, **kwargs):
         @property
         def url(self):
             return self.client.format_url(
-                "/subscriptions/{subscriptionId}/providers/Microsoft.ChangeSafety/changeStates/{changeStateName}",
+                "/subscriptions/{subscriptionId}/providers/Microsoft.ChangeSafety/changeRecords/{changeRecordName}",
                 **self.url_parameters
             )
 
@@ -129,7 +129,7 @@ def error_format(self):
         def url_parameters(self):
             parameters = {
                 **self.serialize_url_param(
-                    "changeStateName", self.ctx.args.change_state_name,
+                    "changeRecordName", self.ctx.args.change_record_name,
                     required=True,
                 ),
                 **self.serialize_url_param(
@@ -143,7 +143,7 @@ def url_parameters(self):
         def query_parameters(self):
             parameters = {
                 **self.serialize_query_param(
-                    "api-version", "2025-09-01-preview",
+                    "api-version", "2026-01-01-preview",
                     required=True,
                 ),
             }
@@ -155,7 +155,7 @@ def on_204(self, session):
         def on_200_201(self, session):
             pass
 
-    class ChangeStatesDelete(AAZHttpOperation):
+    class ChangeRecordsDelete(AAZHttpOperation):
         CLIENT_TYPE = "MgmtClient"
 
         def __call__(self, *args, **kwargs):
@@ -194,7 +194,7 @@ def __call__(self, *args, **kwargs):
         @property
         def url(self):
             return self.client.format_url(
-                "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ChangeSafety/changeStates/{changeStateName}",
+                "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ChangeSafety/changeRecords/{changeRecordName}",
                 **self.url_parameters
             )
 
@@ -210,7 +210,7 @@ def error_format(self):
         def url_parameters(self):
             parameters = {
                 **self.serialize_url_param(
-                    "changeStateName", self.ctx.args.change_state_name,
+                    "changeRecordName", self.ctx.args.change_record_name,
                     required=True,
                 ),
                 **self.serialize_url_param(
@@ -228,7 +228,7 @@ def url_parameters(self):
         def query_parameters(self):
             parameters = {
                 **self.serialize_query_param(
-                    "api-version", "2025-09-01-preview",
+                    "api-version", "2026-01-01-preview",
                     required=True,
                 ),
             }