500 error when trying to generate CLI for metric alerts

[violetVo]

Hi,
I am trying to generate CLI for:
https://github.com/Azure/azure-rest-api-specs/blob/main/specification/monitor/resource-manager/Microsoft.Insights/preview/2024-03-01-preview/metricAlert_API.json

using the tool, but I get 500. This is the error log, Can you advise how to resolve this?

[2025-11-18 15:24:28,571] ERROR in app: Exception on /CLI/Az/Main/Modules/monitor [PUT]
Traceback (most recent call last):
  File "C:\aaz\venv\Lib\site-packages\flask\app.py", line 1473, in wsgi_app
    response = self.full_dispatch_request()
  File "C:\aaz\venv\Lib\site-packages\flask\app.py", line 882, in full_dispatch_request
    rv = self.handle_user_exception(e)
  File "C:\aaz\venv\Lib\site-packages\flask\app.py", line 880, in full_dispatch_request
    rv = self.dispatch_request()
  File "C:\aaz\venv\Lib\site-packages\flask\app.py", line 865, in dispatch_request
    return self.ensure_sync(self.view_functions[rule.endpoint])(**view_args)  # type: ignore[no-any-return]
           ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\api\az.py", line 59, in az_main_module
    module = manager.update_module(module_name, module.profiles)
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\controller\az_module_manager.py", line 79, in update_module
    generator.generate()
    ~~~~~~~~~~~~~~~~~~^^
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\controller\az_profile_generator.py", line 47, in generate
    self._generate_by_command_group(
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^
        profile_folder_name=self.profile_folder_name,
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        command_group=command_group
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^
    )
    ^
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\controller\az_profile_generator.py", line 84, in _generate_by_command_group
    self._generate_by_command_group(profile_folder_name=profile_folder_name, command_group=sub_group)
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\controller\az_profile_generator.py", line 84, in _generate_by_command_group
    self._generate_by_command_group(profile_folder_name=profile_folder_name, command_group=sub_group)
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\controller\az_profile_generator.py", line 84, in _generate_by_command_group
    self._generate_by_command_group(profile_folder_name=profile_folder_name, command_group=sub_group)
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\controller\az_profile_generator.py", line 104, in _generate_by_command_group
    self._generate_by_command(profile_folder_name, command)
    ~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\controller\az_profile_generator.py", line 144, in _generate_by_command
    data = tmpl.render(
        leaf=AzCommandGenerator(command, client, is_wait=is_wait)
    )
  File "C:\aaz\venv\Lib\site-packages\jinja2\environment.py", line 1295, in render
    self.environment.handle_exception()
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^
  File "C:\aaz\venv\Lib\site-packages\jinja2\environment.py", line 942, in handle_exception
    raise rewrite_traceback_stack(source=source)
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\templates\aaz\command\_cmd.py.j2", line 1, in top-level template code
    {% extends "python.j2" %}
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\templates\python.j2", line 10, in top-level template code
    {%- block code %}{% endblock %}
    ^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\templates\aaz\command\_cmd.py.j2", line 834, in block 'code'
    {%- for scope, scope_define, props in resp_cls.iter_scopes() %}
    ^^^^^^^^^^^^^^^^^
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\controller\az_operation_generator.py", line 641, in iter_scopes
    for scopes in _iter_response_scopes_by_schema_base(self.schema, to_snake_case(self.name), self.schema_name, self._cmd_ctx):
                  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\controller\az_operation_generator.py", line 919, in _iter_response_scopes_by_schema_base
    for scopes in _iter_response_scopes_by_schema_base(s, s_name, s_scope_define, cmd_ctx):
                  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\controller\az_operation_generator.py", line 919, in _iter_response_scopes_by_schema_base
    for scopes in _iter_response_scopes_by_schema_base(s, s_name, s_scope_define, cmd_ctx):
                  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\controller\az_operation_generator.py", line 856, in _iter_response_scopes_by_schema_base
    raise NotImplementedError()
NotImplementedError
ERROR:aaz_dev.app.app:Exception on /CLI/Az/Main/Modules/monitor [PUT]
Traceback (most recent call last):
  File "C:\aaz\venv\Lib\site-packages\flask\app.py", line 1473, in wsgi_app
    response = self.full_dispatch_request()
  File "C:\aaz\venv\Lib\site-packages\flask\app.py", line 882, in full_dispatch_request
    rv = self.handle_user_exception(e)
  File "C:\aaz\venv\Lib\site-packages\flask\app.py", line 880, in full_dispatch_request
    rv = self.dispatch_request()
  File "C:\aaz\venv\Lib\site-packages\flask\app.py", line 865, in dispatch_request
    return self.ensure_sync(self.view_functions[rule.endpoint])(**view_args)  # type: ignore[no-any-return]
           ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\api\az.py", line 59, in az_main_module
    module = manager.update_module(module_name, module.profiles)
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\controller\az_module_manager.py", line 79, in update_module
    generator.generate()
    ~~~~~~~~~~~~~~~~~~^^
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\controller\az_profile_generator.py", line 47, in generate
    self._generate_by_command_group(
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^
        profile_folder_name=self.profile_folder_name,
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        command_group=command_group
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^
    )
    ^
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\controller\az_profile_generator.py", line 84, in _generate_by_command_group
    self._generate_by_command_group(profile_folder_name=profile_folder_name, command_group=sub_group)
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\controller\az_profile_generator.py", line 84, in _generate_by_command_group
    self._generate_by_command_group(profile_folder_name=profile_folder_name, command_group=sub_group)
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\controller\az_profile_generator.py", line 84, in _generate_by_command_group
    self._generate_by_command_group(profile_folder_name=profile_folder_name, command_group=sub_group)
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\controller\az_profile_generator.py", line 104, in _generate_by_command_group
    self._generate_by_command(profile_folder_name, command)
    ~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\controller\az_profile_generator.py", line 144, in _generate_by_command
    data = tmpl.render(
        leaf=AzCommandGenerator(command, client, is_wait=is_wait)
    )
  File "C:\aaz\venv\Lib\site-packages\jinja2\environment.py", line 1295, in render
    self.environment.handle_exception()
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^
  File "C:\aaz\venv\Lib\site-packages\jinja2\environment.py", line 942, in handle_exception
    raise rewrite_traceback_stack(source=source)
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\templates\aaz\command\_cmd.py.j2", line 1, in top-level template code
    {% extends "python.j2" %}
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\templates\python.j2", line 10, in top-level template code
    {%- block code %}{% endblock %}
    ^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\templates\aaz\command\_cmd.py.j2", line 834, in block 'code'
    {%- for scope, scope_define, props in resp_cls.iter_scopes() %}
    ^^^^^^^^^^^^^^^^^
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\controller\az_operation_generator.py", line 641, in iter_scopes
    for scopes in _iter_response_scopes_by_schema_base(self.schema, to_snake_case(self.name), self.schema_name, self._cmd_ctx):
                  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\controller\az_operation_generator.py", line 919, in _iter_response_scopes_by_schema_base
    for scopes in _iter_response_scopes_by_schema_base(s, s_name, s_scope_define, cmd_ctx):
                  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\controller\az_operation_generator.py", line 919, in _iter_response_scopes_by_schema_base
    for scopes in _iter_response_scopes_by_schema_base(s, s_name, s_scope_define, cmd_ctx):
                  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\aaz\venv\Lib\site-packages\aaz_dev\cli\controller\az_operation_generator.py", line 856, in _iter_response_scopes_by_schema_base
    raise NotImplementedError()
NotImplementedError
INFO:werkzeug:127.0.0.1 - - [18/Nov/2025 15:24:28] "PUT /CLI/Az/Main/Modules/monitor HTTP/1.1" 500 -

Thanks,
Violet

[necusjz]

@violetVo currently, we don't support discriminator + additionalProperties, cauz,

• polymorphic validation becomes ambiguous.
• code generator may treat the model as a free-form object rather than a polymorphic one.

reommend to remove https://github.com/Azure/azure-rest-api-specs/blob/main/specification/monitor/resource-manager/Microsoft.Insights/preview/2024-03-01-preview/metricAlert_API.json#L819-L821 and https://github.com/Azure/azure-rest-api-specs/blob/main/specification/monitor/resource-manager/Microsoft.Insights/preview/2024-03-01-preview/metricAlert_API.json#L981-L983 in the spec locally.

then, try to reload the spec https://azure.github.io/aaz-dev-tools/pages/usage/workspace-editor/#reload-from-swagger.