search

MicrosoftDocs / azure-docs

Open source documentation of Microsoft Azure
https://docs.microsoft.com/azure
Creative Commons Attribution 4.0 International
10.01k stars 21k forks source link

az afd origin create "--enabled-state" documentation issue #122125

Closed sanjaydebnath closed 1 week ago

sanjaydebnath commented 2 weeks ago

The documentation says against parameter "--enabled-state" as below

"Whether to enable health probes to be made against backends defined under backendPools. Health probes can only be disabled if there is a single enabled backend in single enabled backend pool."

This seems odd as this parameter value is meant to 'actually disable further requests to that origin itself', like AFD will stop forwarding requests if that origin is marked disabled.

Doc Link: https://learn.microsoft.com/en-us/cli/azure/afd/origin?view=azure-cli-latest#az-afd-origin-create

Document Details

⚠ Do not edit this section. It is required for learn.microsoft.com ➟ GitHub issue linking.

PesalaPavan commented 2 weeks ago

@sanjaydebnath Thanks for your feedback! I've assigned this issue to the author who will investigate and update as appropriate.

dbradish-microsoft commented 1 week ago

This GitHub issue is on reference content authored by the AFD engineering team. I've created a new issue https://github.com/Azure/azure-cli/issues/28893 in the source code repository for their review. I've also added comments requesting additional clarity in the parameter description with potential suggestions for improvement.

please-close