Customer feedback | az aks create (both Core & Extensino) |

[dbradish-microsoft]

Describe the bug

This GitHub issue is being moved from MicrosoftDocs/azure-docs-cli issue #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.
2. Service principals 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.
3. Consider providing a link to the Entra ID article Service principal object, and explaining that a system assigned managed identity 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

[yonzhan]

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