Azure / Azure/azure-cli

Customer feedback | az containerapp hostname bind | Optional parameters, that are actually conditional, are not explained

Open
#30,112 2 comments 0 reactions 0 assignees View on GitHub
act-observability-squad Auto-Assign bug ContainerApp Service Attention
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 created from azDO UUF [#301974](https://dev.azure.com/msft-skilling/Content/_workitems/edit/301974).
***************************

### Engineering request
1. Clarify if this example "looks for OR creates" or "looks for AND creates if not found"
![Image](https://github.com/user-attachments/assets/f188bce5-db7b-43d6-8e6a-01016d1a2339)
2. Both the `--certificate` and `--environment` parameters are listed as optional, yet according to the customer error, one is required if the other is not supplied. Please expand the `short-summary` description of both parameters and include a "required if..." statement. Example: `Name or resource id of the certificate. REQUIRED if the "environment" parameter is not used`.

### Related command
az containerapp hostname

### Customer feedback

Title:
az containerapp hostname | Microsoft Learn

Verbatim:
No, the documentation is not correct for az containerapp hostname bind, it does not create a managed certificate but gives error: Please specify at least one of parameters: --certificate and --environment

Verbatim Id:
8c355eb4-8962-ef11-bfe3-0022480bc06c

Live URL:
https://learn.microsoft.com/en-us/cli/azure/containerapp/hostname

GitHub URL:
https://github.com/MicrosoftDocs/azure-docs-cli/blob/live/2020-09-01-hybrid/docs-ref-autogen/containerapp/hostname.yml

### Related command

az containerapp hostname bind

### Errors

.

### Issue script & Debug output

.

### Expected behavior

.

### Environment Summary

Azuer CLI 2.65.0

### Additional context

_No response_

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.