Customer feedback | az aks create (both Core & Extensino) |
- Dominant language
- Python
- Stars
- 4.6k
- Forks
- 3.5k
- Avg merge
- 3d 2h
- Merged PRs (30d)
- 60
Description
### Describe the bug
This GitHub issue is being moved from MicrosoftDocs/azure-docs-cli issue [#4659](https://github.com/MicrosoftDocs/azure-docs-cli/issues/4659) so the AKS service team can respond.
### Engineering request
1. Please update the `short-summary` description for `az aks create --service-principal` parameter and provide more information.
1. [Service principals](https://learn.microsoft.com/en-us/entra/identity-platform/app-objects-and-service-principals?tabs=browser#service-principal-object) can be `application` or `managed identity`. Don't assume the customer understands the difference and kindly state the type of SP this command is creating.
1. Consider providing a link to the Entra ID article [Service principal object](https://learn.microsoft.com/en-us/entra/identity-platform/app-objects-and-service-principals?tabs=browser#service-principal-object), and explaining that a [system assigned managed identity](https://learn.microsoft.com/en-us/entra/identity/managed-identities-azure-resources/overview#managed-identity-types) is a service principal of a special type.
*******************************
### Type of issue
Outdated article
### Feedback
regarding the parameter "--service-principal" the doc says that "If not specified, a new service principal is created and cached at $HOME/.azure/aksServicePrincipal.json to be used by subsequent az aks commands."
this is no longer the case if we create an aks cluster without specifying the parameter "--service-principal" it will use system managed identity instead of creating a SP and make cluster use it.

### Page URL
https://learn.microsoft.com/en-us/cli/azure/aks?view=azure-cli-latest
### Content source URL
https://github.com/MicrosoftDocs/azure-docs-cli/blob/main/latest/docs-ref-autogen/aks.yml
### Related command
az aks create
### Errors
n/a
### Issue script & Debug output
n/a
### Expected behavior
n/a
### Environment Summary
Azure CLI 2.65.0
### Additional context
_No response_
Contributor guide
Assessment
This issue has not been assessed yet.