@@ -9,27 +9,35 @@ ms.topic: overview
9
9
Azure Resource Graph is a service in Azure that is designed to extend Azure Resource Management by
10
10
providing efficient and performant resource exploration with the ability to query at scale across a
11
11
given set of subscriptions so that you can effectively govern your environment. These queries
12
- provide the following features :
12
+ provide the following abilities :
13
13
14
- - Ability to query resources with complex filtering, grouping, and sorting by resource properties.
15
- - Ability to iteratively explore resources based on governance requirements.
16
- - Ability to assess the impact of applying policies in a vast cloud environment.
17
- - Ability to [ query changes made to resource properties] ( ./how-to/get-resource-changes.md )
14
+ - Query resources with complex filtering, grouping, and sorting by resource properties.
15
+ - Explore resources iteratively based on governance requirements.
16
+ - Assess the impact of applying policies in a vast cloud environment.
17
+ - [ Query changes made to resource properties] ( ./how-to/get-resource-changes.md )
18
18
(preview).
19
19
20
20
In this documentation, you'll go over each feature in detail.
21
21
22
22
> [ !NOTE]
23
- > Azure Resource Graph powers Azure portal's search bar, the new browse ' All resources' experience,
23
+ > Azure Resource Graph powers Azure portal's search bar, the new browse ** All resources** experience,
24
24
> and Azure Policy's [ Change history] ( ../policy/how-to/determine-non-compliance.md#change-history )
25
25
> _ visual diff_ . It's designed to help customers manage large-scale environments.
26
26
27
27
[ !INCLUDE [ azure-lighthouse-supported-service] ( ../../../includes/azure-lighthouse-supported-service.md )]
28
28
29
29
## How does Resource Graph complement Azure Resource Manager
30
30
31
- Resource Manager currently supports queries over basic resource fields, specifically - Resource
32
- name, ID, Type, Resource Group, Subscription, and Location. Resource Manager also provides
31
+ Resource Manager currently supports queries over basic resource fields, specifically:
32
+
33
+ - Resource name
34
+ - ID
35
+ - Type
36
+ - Resource Group
37
+ - Subscription
38
+ - Location
39
+
40
+ Resource Manager also provides
33
41
facilities for calling individual resource providers for detailed properties one resource at a time.
34
42
35
43
With Azure Resource Graph, you can access these properties the resource providers return without
@@ -58,7 +66,7 @@ ensures that Resource Graph data is current if there are missed notifications or
58
66
updated outside of Resource Manager.
59
67
60
68
> [ !NOTE]
61
- > Resource Graph uses a ` GET ` to the latest non-preview API of each resource provider to gather
69
+ > Resource Graph uses a ` GET ` to the latest non-preview application programming interface ( API) of each resource provider to gather
62
70
> properties and values. As a result, the property expected may not be available. In some cases, the
63
71
> API version used has been overridden to provide more current or widely used properties in the
64
72
> results. See the [ Show API version for each resource type] ( ./samples/advanced.md#apiversion )
@@ -97,7 +105,7 @@ access to without any indication that the result may be partial. If there are no
97
105
the subscription list that the user has appropriate rights to, the response is a _ 403_ (Forbidden).
98
106
99
107
> [ !NOTE]
100
- > In the ** preview** REST API version ` 2020-04-01-preview ` , the subscription list may be ommitted .
108
+ > In the ** preview** REST API version ` 2020-04-01-preview ` , the subscription list may be omitted .
101
109
> When both the ` subscriptions ` and ` managementGroupId ` properties aren't defined in the request,
102
110
> the _ scope_ is set to the tenant. For more information, see
103
111
> [ Scope of the query] ( ./concepts/query-language.md#query-scope ) .
@@ -106,9 +114,9 @@ the subscription list that the user has appropriate rights to, the response is a
106
114
107
115
As a free service, queries to Resource Graph are throttled to provide the best experience and
108
116
response time for all customers. If your organization wants to use the Resource Graph API for
109
- large-scale and frequent queries, use portal ' Feedback' from the
117
+ large-scale and frequent queries, use portal ** Feedback** from the
110
118
[ Resource Graph portal page] ( https://portal.azure.com/#blade/Microsoft_Azure_Policy/PolicyMenuBlade/ResourceGraph ) .
111
- Provide your business case and select the ' Microsoft can email you about your feedback' checkbox in
119
+ Provide your business case and select the ** Microsoft can email you about your feedback** checkbox in
112
120
order for the team to contact you.
113
121
114
122
Resource Graph throttles queries at the user level. The service response contains the following HTTP
0 commit comments