Bug: Environment.graph documentation (maybe runtime - haven't tested) shows incorrect base URI
- Dominant language
- Bicep
- Stars
- 3.6k
- Forks
- 830
- Avg merge
- 1d 21m
- Merged PRs (30d)
- 79
Description
**Bicep version**
0.13.1
**Describe the bug**
The documentation [here](https://learn.microsoft.com/en-us/azure/azure-resource-manager/templates/template-functions-deployment#environment) reflects an example of values that should be returned when calling the `environment()` function. Specifically, it indicates that the value for graph is 'https://graph.windows.net/', but if you look at the Graph [documentation](https://learn.microsoft.com/en-us/graph/call-api), it reads at the top:
> All Microsoft Graph API requests use the following basic URL pattern:
> https://graph.microsoft.com/{version}/{resource}?[query_parameters]
I don't know anything about the `graphAudience` and whether it's accurate or not, but it points to the same endpoint that `graph` does.
I have not yet run this in a deployment to see which value Bicep produces to indicate if this is a documentation or also a runtime error.
Contributor guide
Research direction
Start by deploying Bicep 0.13.1 and calling the environment() function, then compare the returned graph and graphAudience values with the documented example and Microsoft Graph's URL pattern. Done means determining whether the discrepancy is documentation-only or also affects runtime, and correcting the relevant documentation or reporting the runtime issue.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- azure
- Domain
- cloud, documentation
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100