[Safeguards] Fix verb tense in help text and add pre-existence check

[ShantingLiu]

Changes Made

• Change help text examples to use first-person imperative verbs
• 'Creates' -> 'Create', 'Deletes' -> 'Delete', 'Gets' -> 'Get'
• Add pre-existence check to az aks safeguards create to prevent duplicate resource creation
• Block duplicate creates with helpful error message guiding users to use update or delete commands
• Fix duplicate 19.0.0b16 headers in HISTORY.rst
• Update version to 19.0.0b17
• Add changelog entries

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

Related command

az aks safeguards create, az aks safeguards delete, az aks safeguards show

Description

This PR addresses two improvements to the safeguards commands:

1. Help text verb tense fix: Updated examples in _create.py, _delete.py, and _show.py to use first-person imperative verbs per Azure CLI guidelines (e.g., "Create" instead of "Creates").

2. Pre-existence validation: Added a check in az aks safeguards create to prevent duplicate resource creation. The command now:

   • Checks if a Deployment Safeguards resource already exists before attempting to create
   • Returns a clear error message directing users to az aks safeguards update or az aks safeguards delete
   • Supports both -g/-n and --managed-cluster URI syntax

Testing

• Tested create when resource doesn't exist (succeeds)
• Tested create when resource exists (blocks with helpful error)
• Tested with both -g/-n and --managed-cluster URI syntax
• Verified error message guides users to correct commands

General Guidelines

• Have you run azdev style <YOUR_EXT> locally? (pip install azdev required)
• Unable to run: azdev requires a full Azure CLI development environment with both azure-cli and azure-cli-extensions repos configured via azdev setup. This PR contains help text changes in AAZ-generated files and validation logic. The CI pipeline will validate this automatically.
• 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.

Addresses feedback from PR #897

[azure-client-tools-bot-prd]

️✔️Azure CLI Extensions Breaking Change Test

️✔️Non Breaking Changes

[yonzhan]

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

[github-actions]

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]

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]

Hi @ShantingLiu

Release Suggestions

Module: aks-preview

• Update VERSION to 19.0.0b21 in src/aks-preview/setup.py

Notes

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

[Copilot]

Pull Request Overview

This PR fixes verb tense in safeguards help text to align with Azure CLI documentation guidelines by changing from third-person present tense (e.g., "Creates", "Deletes", "Gets") to first-person imperative verbs (e.g., "Create", "Delete", "Get"). The version is also bumped to 19.0.0b17 with a corresponding changelog entry.

• Updated help text examples in _show.py, _delete.py, and _create.py to use imperative verb forms
• Incremented version from 19.0.0b16 to 19.0.0b17 in setup.py
• Added changelog entry documenting the help text fix

Reviewed Changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
src/aks-preview/setup.py	Version bump from 19.0.0b16 to 19.0.0b17
src/aks-preview/azext_aks_preview/aaz/latest/aks/safeguards/_show.py	Changed "Gets" to "Get" in example descriptions
src/aks-preview/azext_aks_preview/aaz/latest/aks/safeguards/_delete.py	Changed "Deletes" to "Delete" in example descriptions
src/aks-preview/azext_aks_preview/aaz/latest/aks/safeguards/_create.py	Changed "Creates" to "Create" in example descriptions
src/aks-preview/HISTORY.rst	Added changelog entry for version 19.0.0b17

[FumingZhang]

please fix failed CI checks

[FumingZhang]

lgtm

Queued live test to validate the change, test passed!

[yanzhudd]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 2 pipeline(s).

[FumingZhang]

Hi @ShantingLiu, since you've updated the argument value in the test case, please make sure to update the value in the recording files as well so the CI checks can pass.

https://dev.azure.com/azclitools/public/public%20Team/_build/results?buildId=293481&view=logs&j=ff866e8d-4875-52ff-9fd3-f181f728432c&t=64f04c5b-80b8-53a1-8045-e38ac626841b&l=4876

[FumingZhang]

The current recordings are still not passing the CI checks. I have re-queued the live test for the safeguard-related tests. If the live test passes, you can download the new recording files from the pipeline artifact, and they should pass the CI.