Azure / Azure/bicep

Bug: Environment.graph documentation (maybe runtime - haven't tested) shows incorrect base URI

Open
#9,470 1 comment 0 reactions 0 assignees View on GitHub
documentation Needs: Upvote
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.