az postgres flexible-server maintenance-event list errors

[Voltstro]

Describe the bug

The use of az postgres flexible-server maintenance-event list always results in a "The command failed with an unexpected error." regardless of arguments used.

Related command

az postgres flexible-server maintenance-event list --resource-group xxx --server-name xxx
az postgres flexible-server maintenance-event list --ids /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/xxx/providers/Microsoft.DBforPostgreSQL/flexibleServers/xxx

Errors

The command failed with an unexpected error. Here is the traceback:
flexible_server_maintenance_event_list() got an unexpected keyword argument 'ids'
Traceback (most recent call last):
  File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\knack/cli.py", line 233, in invoke
  File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/__init__.py", line 677, in execute
  File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/__init__.py", line 820, in _run_jobs_serially
  File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/__init__.py", line 789, in _run_job
  File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/__init__.py", line 335, in __call__
  File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/command_operation.py", line 120, in handler
TypeError: flexible_server_maintenance_event_list() got an unexpected keyword argument 'ids'

Issue script & Debug output

cli.knack.cli: Command arguments: ['postgres', 'flexible-server', 'maintenance-event', 'list', '--resource-group', 'xxx', '--server-name', 'xxx', '--debug']
cli.knack.cli: __init__ debug log:
Enable color in terminal.
cli.knack.cli: Event: Cli.PreExecute []
cli.knack.cli: Event: CommandParser.OnGlobalArgumentsCreate [<function CLILogging.on_global_arguments at 0x0000014E0BD05A60>, <function OutputProducer.on_global_arguments at 0x0000014E0C2149E0>, <function CLIQuery.on_global_arguments at 0x0000014E0C23B060>]
cli.knack.cli: Event: CommandInvoker.OnPreCommandTableCreate []
cli.azure.cli.core: Using packaged command index for profile 'latest'.
cli.azure.cli.core: Modules found from index for 'postgres': ['azure.cli.command_modules.postgresql']
cli.azure.cli.core: Loading command modules...
cli.azure.cli.core: Name                  Load Time    Groups  Commands
cli.azure.cli.core: postgresql                0.458        19        82
cli.azure.cli.core: Loaded command modules:
cli.azure.cli.core: Total (1)                 0.459        19        82
cli.azure.cli.core: Loaded 19 groups, 82 commands.
cli.azure.cli.core: Found a match in the command table.
cli.azure.cli.core: Raw command  : postgres flexible-server maintenance-event list
cli.azure.cli.core: Command table: postgres flexible-server maintenance-event list
cli.knack.cli: Event: CommandInvoker.OnPreCommandTableTruncate [<function AzCliLogging.init_command_file_logging at 0x0000014E0C3EF7F0>]
cli.azure.cli.core.azlogging: metadata file logging enabled - writing logs to 'C:\Users\x\.azure\commands\2026-08-05.09-40-23.postgres_flexible-server_maintenance-event_list.22128.log'.
az_command_data_logger: command args: postgres flexible-server maintenance-event list --resource-group {} --server-name {} --debug
cli.knack.cli: Event: CommandInvoker.OnPreArgumentLoad [<function register_global_subscription_argument.<locals>.add_subscription_parameter at 0x0000014E0C30D9B0>]
cli.knack.cli: Event: CommandInvoker.OnPostArgumentLoad []
cli.knack.cli: Event: CommandInvoker.OnPostCommandTableCreate [<function register_ids_argument.<locals>.add_ids_arguments at 0x0000014E0C4212D0>, <function register_global_policy_argument.<locals>.add_global_policy_argument at 0x0000014E0C4403B0>, <function register_cache_arguments.<locals>.add_cache_arguments at 0x0000014E0C440460>, <function register_upcoming_breaking_change_info.<locals>.update_breaking_change_info at 0x0000014E0C440510>]
cli.knack.cli: Event: CommandInvoker.OnCommandTableLoaded []
cli.knack.cli: Event: CommandInvoker.OnPreParseArgs []
cli.knack.cli: Event: CommandInvoker.OnPostParseArgs [<function OutputProducer.handle_output_argument at 0x0000014E0C214A90>, <function CLIQuery.handle_query_parameter at 0x0000014E0C23B110>, <function register_ids_argument.<locals>.parse_ids_arguments at 0x0000014E0C440300>]
cli.azure.cli.core.commands.client_factory: Getting management service client client_type=PostgreSQLManagementClient
cli.azure.cli.core.auth.persistence: build_persistence: location='C:\\Users\\x\\.azure\\msal_token_cache.bin', encrypt=True
cli.azure.cli.core.auth.binary_cache: load: C:\Users\x\.azure\msal_http_cache.bin
urllib3.util.retry: Converted retries value: 1 -> Retry(total=1, connect=None, read=None, redirect=None, status=None)
msal.application: Broker enabled? True
cli.azure.cli.core.azclierror: Traceback (most recent call last):
  File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\knack/cli.py", line 233, in invoke
  File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/__init__.py", line 677, in execute
  File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/__init__.py", line 820, in _run_jobs_serially
  File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/__init__.py", line 789, in _run_job
  File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/__init__.py", line 335, in __call__
  File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/command_operation.py", line 120, in handler
TypeError: flexible_server_maintenance_event_list() got an unexpected keyword argument 'ids'

cli.azure.cli.core.azclierror: The command failed with an unexpected error. Here is the traceback:
az_command_data_logger: The command failed with an unexpected error. Here is the traceback:
cli.azure.cli.core.azclierror: flexible_server_maintenance_event_list() got an unexpected keyword argument 'ids'
Traceback (most recent call last):
  File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\knack/cli.py", line 233, in invoke
  File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/__init__.py", line 677, in execute
  File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/__init__.py", line 820, in _run_jobs_serially
  File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/__init__.py", line 789, in _run_job
  File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/__init__.py", line 335, in __call__
  File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/command_operation.py", line 120, in handler
TypeError: flexible_server_maintenance_event_list() got an unexpected keyword argument 'ids'
az_command_data_logger: flexible_server_maintenance_event_list() got an unexpected keyword argument 'ids'
Traceback (most recent call last):
  File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\knack/cli.py", line 233, in invoke
  File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/__init__.py", line 677, in execute
  File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/__init__.py", line 820, in _run_jobs_serially
  File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/__init__.py", line 789, in _run_job
  File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/__init__.py", line 335, in __call__
  File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/command_operation.py", line 120, in handler
TypeError: flexible_server_maintenance_event_list() got an unexpected keyword argument 'ids'
To check existing issues, please visit: https://github.com/Azure/azure-cli/issues
cli.knack.cli: Event: Cli.PostExecute [<function AzCliLogging.deinit_cmd_metadata_logging at 0x0000014E0C3EFAB0>]
az_command_data_logger: exit code: 1
cli.__main__: Command ran in 0.857 seconds (init: 0.143, invoke: 0.715)
telemetry.main: Begin splitting cli events and extra events, total events: 1
telemetry.main: Finish splitting cli events and extra events, cli events: 1
telemetry.save: Save telemetry record of length 8195 in cache file under C:\Users\x\.azure\telemetry\20260805094023982
telemetry.main: Begin creating telemetry upload process.
telemetry.process: Creating upload process: "C:\Program Files\Microsoft SDKs\Azure\CLI2\python.exe C:\Program Files\Microsoft SDKs\Azure\CLI2\Lib\site-packages\azure\cli\telemetry\__init__.pyc C:\Users\x\.azure C:\Users\x\.azure\telemetry\20260805094023982"
telemetry.process: Return from creating process 31980
telemetry.main: Finish creating telemetry upload process.

Expected behavior

For the command to return a list of maintenance events on the Postgres flexible server.

Environment Summary

azure-cli                         2.89.0

core                              2.89.0
telemetry                          1.1.0

Dependencies:
msal                              1.36.0
azure-mgmt-resource               24.0.0

Python location 'C:\Program Files\Microsoft SDKs\Azure\CLI2\python.exe'
Config directory 'C:\Users\x\.azure'
Extensions directory 'C:\Users\x\.azure\cliextensions'

Python (Windows) 3.14.6 (tags/v3.14.6:c63aec6, Jun 10 2026, 10:26:10) [MSC v.1944 64 bit (AMD64)]

Additional context

No response

[yonzhan]

Thank you for opening this issue, we will look into it.

[azure-client-tools-agent]

Bug Analysis

The az postgres flexible-server maintenance-event list command fails with:

TypeError: flexible_server_maintenance_event_list() got an unexpected keyword argument 'ids'

This happens both with plain --resource-group/--server-name arguments and with --ids. The traceback
shows the error originates in command_operation.py handler dispatch, i.e. the command's parameter/argument
registration passes an ids kwarg through to the underlying flexible_server_maintenance_event_list custom
command function, but that function's signature does not accept an ids parameter (it's likely missing from
the function signature or not being popped/consumed as the generic --ids argument is for other resource
commands).

Location to investigate: src/azure-cli/azure/cli/command_modules/postgresql (or wherever the
maintenance-event list command is registered) — check the command's #custom_command registration in
commands.py/_help.py/_params.py and the custom command function signature in custom.py for the
flexible_server_maintenance_event_list function. Compare against sibling MySQL/Postgres maintenance-event
commands or other resources that correctly support --ids to see how they filter/consume the ids kwarg
before calling the underlying operation function.

Expected behavior: The command should return a list of maintenance events for the given flexible server,
using either --resource-group/--server-name or --ids to identify the target resource, without raising
a TypeError.

Reported against azure-cli 2.89.0.

Use this EXACT PR title: [Postgresql] Fix #33846: az postgres flexible-server maintenance-event list: Fix TypeError when using --ids argument

PR title & description format (required)

This repo enforces a PR format (guide). Please author the PR exactly as follows or CI's Check the Format of Pull Request Title and Content will fail.

Use this EXACT PR title (copy verbatim, do not reword):

[Postgresql] Fix #33846: `az postgres flexible-server maintenance-event list`: Fix TypeError when using --ids argument

Keep the backticks around the command and the Fix #33846: prefix. You may only adjust the wording after the command (the final summary) if the fix changes; the [Postgresql] prefix, issue link, and backticked command must stay.

Description — follow the PR template and fill in:

• Link the issue — start the Description with a closing keyword so the PR auto-links and closes it: Fixes #33846.
• Related command — the az ... command this affects.
• Description (mandatory) — why the bug happens, what you changed, and the resulting behavior.
• Testing Guide — example command(s) showing the fix works.
• History Notes — leave the title to drive the history note, or add extra lines in the same format (component in brackets + the command in backticks), e.g. [Postgresql] `az <command>`: <note>.
• Keep the template checklist and tick the items you've satisfied.

---

Posted by agent-assist (autonomous bug-fix pipeline).