[Container App] `az containerapp function`: Add list and show commands for container app functions by khushishah513 · Pull Request #9155 · Azure/azure-cli-extensions

khushishah513 · 2025-09-11T11:02:16Z

This checklist is used to make sure that common guidelines for a pull request are followed.

Related command

General Guidelines

Have you run azdev style <YOUR_EXT> locally? (pip install azdev required)
Have you run python scripts/ci/test_index.py -q locally? (pip install wheel==0.30.0 required)
My extension version conforms to the Extension version schema

For new extensions:

My extension description/summary conforms to the Extension Summary Guidelines.

About Extension Publish

There is a pipeline to automatically build, upload and publish extension wheels.
Once your pull request is merged into main branch, a new pull request will be created to update src/index.json automatically.
You only need to update the version information in file setup.py and historical information in file HISTORY.rst in your PR but do not modify src/index.json.

azure-client-tools-bot-prd · 2025-09-11T11:02:19Z

⚠️Azure CLI Extensions Breaking Change Test

⚠️containerapp

rule cmd_name rule_message suggest_message

⚠️ 1011 - SubgroupAdd containerapp function sub group containerapp function added

azure-client-tools-bot-prd · 2025-09-11T11:02:23Z

Hi @khushishah513,
Please write the description of changes which can be perceived by customers into HISTORY.rst.
If you want to release a new extension version, please update the version in setup.py as well.

yonzhan · 2025-09-11T11:02:28Z

Thank you for your contribution! We will review the pull request and get back to you soon.

github-actions · 2025-09-11T11:02:29Z

The git hooks are available for azure-cli and azure-cli-extensions repos. They could help you run required checks before creating the PR.

Please sync the latest code with latest dev branch (for azure-cli) or main branch (for azure-cli-extensions).
After that please run the following commands to enable git hooks:

pip install azdev --upgrade
azdev setup -c <your azure-cli repo path> -r <your azure-cli-extensions repo path>

github-actions · 2025-09-11T11:03:28Z

CodeGen Tools Feedback Collection

Thank you for using our CodeGen tool. We value your feedback, and we would like to know how we can improve our product. Please take a few minutes to fill our codegen survey

github-actions · 2025-09-11T11:06:03Z

Hi @khushishah513

Release Suggestions

Module: containerapp

Update VERSION to 1.2.0b4 in src/containerapp/setup.py

Notes

For more info about extension versioning, please refer to Extension version schema

src/containerapp/HISTORY.rst

src/containerapp/azext_containerapp/_help.py

src/containerapp/azext_containerapp/_params.py

src/containerapp/azext_containerapp/containerapp_functions_decorator.py

…ntainerapp functions

[Containerapp] `az containerapp function`: Add function key management commands

krishnajaju · 2025-09-16T07:13:23Z

src/containerapp/HISTORY.rst

 ===============
 upcoming
 ++++++
+* 'az containerapp function show/list': New command group to list and show functions in container apps.


please review command from Nitesh/Deep

krishnajaju · 2025-09-16T08:32:41Z

src/containerapp/azext_containerapp/_help.py


+helps['containerapp function'] = """
+    type: group
+    short-summary: Commands to view functions in a container app.


Suggested change

short-summary: Commands to view functions in a container app.

short-summary: Commands to view functions in an Azure Functions on Azure Container Apps.

Let's be explicit here, as this command is only applicable for Functions on ACA v2, and not for direct ACA customer using functions image without kind=functionapp.

krishnajaju · 2025-09-16T08:40:50Z

src/containerapp/azext_containerapp/_help.py

+
+helps['containerapp function list'] = """
+    type: command
+    short-summary: List all functions in a container app or a specific revision. (pass --revisionName parameter)


Suggested change

short-summary: List all functions in a container app or a specific revision. (pass --revisionName parameter)

short-summary: List all functions in an Azure Functions on Azure Container Apps.

Current summary seems to convey that the --revisionName parameter is mandatory, which is not true. Let's remove revision-specific help command, similar to other commands like az containerapp replica count.

krishnajaju · 2025-09-16T08:42:17Z

src/containerapp/azext_containerapp/_params.py

+    with self.argument_context('containerapp function list') as c:
+        c.argument('resource_group_name', arg_type=resource_group_name_type, id_part=None)
+        c.argument('name', options_list=['--name', '-n'], help="The name of the Container App.")
+        c.argument('revision_name', options_list=['--revision-name', '-r'], help="The name of the revision to list functions from. It is required if container app is running in multiple active revision mode.")


parameter should just be --revision, following convention from other commands

krishnajaju · 2025-09-16T08:44:27Z

src/containerapp/azext_containerapp/_help.py

+    type: command
+    short-summary: List all functions in a container app or a specific revision. (pass --revisionName parameter)
+    long-summary: |
+        revisionName is required only if Container App active Revision Mode is setup in Multiple Revision Mode. (Default: Single Revision Mode)


Suggested change

revisionName is required only if Container App active Revision Mode is setup in Multiple Revision Mode. (Default: Single Revision Mode)

--revision is required if the

Suggested change

revisionName is required only if Container App active Revision Mode is setup in Multiple Revision Mode. (Default: Single Revision Mode)

--revision is required only if the app is not in single revision mode.

We have multiple and labelled revision mode, so this statement will be simpler.

krishnajaju · 2025-09-16T08:49:26Z

src/containerapp/azext_containerapp/_help.py

+          az containerapp function list -n my-containerapp -g MyResourceGroup
+    - name: List all functions for a specific revision
+      text: |
+          az containerapp function list -n my-containerapp -g MyResourceGroup --revision-name MyRevision


Suggested change

az containerapp function list -n my-containerapp -g MyResourceGroup --revision-name MyRevision

az containerapp function list -n MyContainerApp -g MyResourceGroup --revision MyRevision

krishnajaju · 2025-09-16T08:51:44Z

src/containerapp/azext_containerapp/_help.py

+
+helps['containerapp function show'] = """
+    type: command
+    short-summary: Show details of a specific function in a container app or a specific revision within app. (pass --revisionName parameter)


Suggested change

short-summary: Show details of a specific function in a container app or a specific revision within app. (pass --revisionName parameter)

short-summary: Get details of a function in an Azure Functions on Azure Container Apps.

krishnajaju · 2025-09-16T08:52:10Z

src/containerapp/azext_containerapp/_help.py

+        revisionName is required only if Container App active Revision Mode is setup in Multiple Revision Mode. (Default: Single Revision Mode)
+        Run to check activerevisionmode: az containerapp show -n my-containerapp -g MyResourceGroup --query properties.configuration.activeRevisionsMode


same comment from list command

krishnajaju · 2025-09-16T09:03:08Z

src/containerapp/azext_containerapp/_params.py

+    with self.argument_context('containerapp function list') as c:
+        c.argument('resource_group_name', arg_type=resource_group_name_type, id_part=None)
+        c.argument('name', options_list=['--name', '-n'], help="The name of the Container App.")
+        c.argument('revision_name', options_list=['--revision-name', '-r'], help="The name of the revision to list functions from. It is required if container app is running in multiple active revision mode.")


multiple or labels revision mode
https://learn.microsoft.com/en-us/cli/azure/containerapp/revision?view=azure-cli-latest#az-containerapp-revision-set-mode(containerapp)

krishnajaju · 2025-09-16T09:04:02Z

src/containerapp/azext_containerapp/_params.py

+
+    with self.argument_context('containerapp function list') as c:
+        c.argument('resource_group_name', arg_type=resource_group_name_type, id_part=None)
+        c.argument('name', options_list=['--name', '-n'], help="The name of the Container App.")


Suggested change

c.argument('name', options_list=['--name', '-n'], help="The name of the Container App.")

c.argument('name', options_list=['--name', '-n'], help="The name of the Azure Functions on Azure Container Apps.")

krishnajaju · 2025-09-16T09:05:42Z

src/containerapp/azext_containerapp/_clients.py



+class ContainerAppFunctionsPreviewClient():
+    api_version = PREVIEW_API_VERSION


did we update PREVIEW_API_VERSION to the latest unreleased one? Add TODO for tracking, if not done.

adding az containerapp functions commands

4dc363f

azure-client-tools-bot-prd bot added this to the October 2025 (2025-10-07) milestone Sep 11, 2025

microsoft-github-policy-service bot requested review from Greedygre, JennyLawrance, Juliehzl, chinadragon0515, ebencarek, howang-ms, jijohn14, jsntcy, pagariyaalok, ruslany, sanchitmehta, torosent, vinisoto, vturecek, wangzelin007, yanzhudd, yonzhan and zhoxing-ms September 11, 2025 11:02

microsoft-github-policy-service bot added the Auto-Assign Auto assign by bot label Sep 11, 2025

microsoft-github-policy-service bot assigned zhoxing-ms Sep 11, 2025

microsoft-github-policy-service bot added the ContainerApp label Sep 11, 2025

modification to help descriptions

a9393d8

correcting params.py file

94cf376

BlackRider97 reviewed Sep 11, 2025

View reviewed changes

khushishah513 added 4 commits September 12, 2025 05:50

addressing comments

95e3345

modifying help description

e42a0f6

adding az containerapp function keys commands

88ab1f6

modifying the command to be az containerapp function instead of az co…

0986024

…ntainerapp functions

khushishah513 changed the title ~~[Container App] az containerapp functions: Add list and show commands for container app functions~~ [Container App] az containerapp function: Add list and show commands for container app functions Sep 13, 2025

khushishah513 added 2 commits September 15, 2025 05:21

updating function keys decorator

b9c8a4b

Merge pull request #1 from khushishah513/functionaca-keys

0cf0be6

[Containerapp] `az containerapp function`: Add function key management commands

krishnajaju reviewed Sep 16, 2025

View reviewed changes

Merge branch 'function-changes' into functionaca-getlist

771087c

krishnajaju reviewed Sep 16, 2025

View reviewed changes

khushishah513 closed this Sep 17, 2025

khushishah513 deleted the functionaca-getlist branch September 26, 2025 06:45

	short-summary: Commands to view functions in a container app.
	short-summary: Commands to view functions in an Azure Functions on Azure Container Apps.

	short-summary: List all functions in a container app or a specific revision. (pass --revisionName parameter)
	short-summary: List all functions in an Azure Functions on Azure Container Apps.

	revisionName is required only if Container App active Revision Mode is setup in Multiple Revision Mode. (Default: Single Revision Mode)
	--revision is required if the

	revisionName is required only if Container App active Revision Mode is setup in Multiple Revision Mode. (Default: Single Revision Mode)
	--revision is required only if the app is not in single revision mode.

	az containerapp function list -n my-containerapp -g MyResourceGroup --revision-name MyRevision
	az containerapp function list -n MyContainerApp -g MyResourceGroup --revision MyRevision

	short-summary: Show details of a specific function in a container app or a specific revision within app. (pass --revisionName parameter)
	short-summary: Get details of a function in an Azure Functions on Azure Container Apps.

		revisionName is required only if Container App active Revision Mode is setup in Multiple Revision Mode. (Default: Single Revision Mode)
		Run to check activerevisionmode: az containerapp show -n my-containerapp -g MyResourceGroup --query properties.configuration.activeRevisionsMode

	c.argument('name', options_list=['--name', '-n'], help="The name of the Container App.")
	c.argument('name', options_list=['--name', '-n'], help="The name of the Azure Functions on Azure Container Apps.")



		class ContainerAppFunctionsPreviewClient():
		api_version = PREVIEW_API_VERSION

Conversation

khushishah513 commented Sep 11, 2025

Related command

General Guidelines

About Extension Publish

Uh oh!

azure-client-tools-bot-prd bot commented Sep 11, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

azure-client-tools-bot-prd bot commented Sep 11, 2025

Uh oh!

yonzhan commented Sep 11, 2025

Uh oh!

github-actions bot commented Sep 11, 2025

Uh oh!

github-actions bot commented Sep 11, 2025

CodeGen Tools Feedback Collection

Uh oh!

github-actions bot commented Sep 11, 2025

Release Suggestions

Module: containerapp

Notes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

azure-client-tools-bot-prd bot commented Sep 11, 2025 •

edited

Loading