Skip to content

Commit 3440652

Browse files
FaithOmbongiFaithOmbongi
committed
Merge branch 'main' of https://github.com/microsoftgraph/microsoft-graph-docs into goc/add-backupRetentionPeriodInDays-beta
2 parents 01bf656 + 986da74 commit 3440652

47 files changed

Lines changed: 2092 additions & 31 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎api-reference/beta/api/networkaccess-cloudfirewallpolicy-delete.md‎

Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
1+
---
2+
title: "Delete cloudFirewallPolicy"
3+
description: "Delete a cloudFirewallPolicy object."
4+
author: "shkhalid"
5+
ms.date: 01/26/2026
6+
ms.localizationpriority: medium
7+
ms.subservice: "entra-global-secure-access"
8+
doc_type: apiPageType
9+
---
10+
11+
# Delete cloudFirewallPolicy
12+
13+
Namespace: microsoft.graph.networkaccess
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Delete a [cloudFirewallPolicy](../resources/networkaccess-cloudfirewallpolicy.md) object.
18+
19+
## Permissions
20+
21+
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
22+
23+
<!-- {
24+
"blockType": "permissions",
25+
"name": "networkaccess-cloudfirewallpolicy-delete-permissions"
26+
}
27+
-->
28+
[!INCLUDE [permissions-table](../includes/permissions/networkaccess-cloudfirewallpolicy-delete-permissions.md)]
29+
30+
[!INCLUDE [rbac-global-secure-access-apis-write](../includes/rbac-for-apis/rbac-global-secure-access-apis-write.md)]
31+
32+
## HTTP request
33+
34+
<!-- {
35+
"blockType": "ignored"
36+
}
37+
-->
38+
``` http
39+
DELETE /networkAccess/cloudFirewallPolicies/{cloudFirewallPolicyId}
40+
```
41+
42+
## Request headers
43+
44+
|Name|Description|
45+
|:---|:---|
46+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
47+
48+
## Request body
49+
50+
Don't supply a request body for this method.
51+
52+
## Response
53+
54+
If successful, this method returns a `204 No Content` response code.
55+
56+
## Examples
57+
58+
### Request
59+
60+
The following example shows a request.
61+
62+
<!-- {
63+
"blockType": "request",
64+
"name": "delete_cloudfirewallpolicy"
65+
}
66+
-->
67+
``` http
68+
DELETE https://graph.microsoft.com/beta/networkAccess/cloudFirewallPolicies/80b58b7d-572f-4457-8944-c804fcf3b694
69+
```
70+
71+
### Response
72+
73+
The following example shows the response.
74+
75+
<!-- {
76+
"blockType": "response",
77+
"truncated": true
78+
}
79+
-->
80+
``` http
81+
HTTP/1.1 204 No Content
82+
```

‎api-reference/beta/api/networkaccess-cloudfirewallpolicy-get.md‎

Lines changed: 102 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,102 @@
1+
---
2+
title: "Get cloudFirewallPolicy"
3+
description: "Read the properties and relationships of a cloudFirewallPolicy object."
4+
author: "shkhalid"
5+
ms.date: 01/26/2026
6+
ms.localizationpriority: medium
7+
ms.subservice: "entra-global-secure-access"
8+
doc_type: apiPageType
9+
---
10+
11+
# Get cloudFirewallPolicy
12+
13+
Namespace: microsoft.graph.networkaccess
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Read the properties and relationships of a [cloudFirewallPolicy](../resources/networkaccess-cloudfirewallpolicy.md) object.
18+
19+
## Permissions
20+
21+
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
22+
23+
<!-- {
24+
"blockType": "permissions",
25+
"name": "networkaccess-cloudfirewallpolicy-get-permissions"
26+
}
27+
-->
28+
[!INCLUDE [permissions-table](../includes/permissions/networkaccess-cloudfirewallpolicy-get-permissions.md)]
29+
30+
[!INCLUDE [rbac-global-secure-access-apis-read](../includes/rbac-for-apis/rbac-global-secure-access-apis-read.md)]
31+
32+
## HTTP request
33+
34+
<!-- {
35+
"blockType": "ignored"
36+
}
37+
-->
38+
``` http
39+
GET /networkAccess/cloudFirewallPolicies/{cloudFirewallPolicyId}
40+
```
41+
42+
## Optional query parameters
43+
44+
This method supports the `$select` and `$expand` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
45+
46+
## Request headers
47+
48+
|Name|Description|
49+
|:---|:---|
50+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
51+
52+
## Request body
53+
54+
Don't supply a request body for this method.
55+
56+
## Response
57+
58+
If successful, this method returns a `200 OK` response code and a [cloudFirewallPolicy](../resources/networkaccess-cloudfirewallpolicy.md) object in the response body.
59+
60+
## Examples
61+
62+
### Request
63+
64+
The following example shows a request.
65+
66+
<!-- {
67+
"blockType": "request",
68+
"name": "get_cloudfirewallpolicy"
69+
}
70+
-->
71+
``` http
72+
GET https://graph.microsoft.com/beta/networkAccess/cloudFirewallPolicies/e3692831-a554-4507-8a60-681a8066eb39
73+
```
74+
75+
### Response
76+
77+
The following example shows the response.
78+
79+
>**Note:** The response object shown here might be shortened for readability.
80+
81+
<!-- {
82+
"blockType": "response",
83+
"truncated": true,
84+
"@odata.type": "microsoft.graph.networkaccess.cloudFirewallPolicy"
85+
}
86+
-->
87+
``` http
88+
HTTP/1.1 200 OK
89+
Content-Type: application/json
90+
91+
{
92+
"@odata.type": "#microsoft.graph.networkaccess.cloudFirewallPolicy",
93+
"id": "e3692831-a554-4507-8a60-681a8066eb39",
94+
"name": "Block unauthorized egress",
95+
"description": "Policy to block unauthorized outbound connections",
96+
"version": "1.0.0",
97+
"lastModifiedDateTime": "2025-02-11T16:11:41Z",
98+
"settings": {
99+
"defaultAction": "block"
100+
}
101+
}
102+
```

‎api-reference/beta/api/networkaccess-cloudfirewallpolicy-list-policyrules.md‎

Lines changed: 118 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,118 @@
1+
---
2+
title: "List policyRules for cloudFirewallPolicy"
3+
description: "Get a list of the cloudFirewallRule objects and their properties for a cloud firewall policy."
4+
author: "shkhalid"
5+
ms.date: 01/26/2026
6+
ms.localizationpriority: medium
7+
ms.subservice: "entra-global-secure-access"
8+
doc_type: apiPageType
9+
---
10+
11+
# List policyRules for cloudFirewallPolicy
12+
13+
Namespace: microsoft.graph.networkaccess
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Get a list of the [cloudFirewallRule](../resources/networkaccess-cloudfirewallrule.md) objects and their properties for a [cloudFirewallPolicy](../resources/networkaccess-cloudfirewallpolicy.md).
18+
19+
## Permissions
20+
21+
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
22+
23+
<!-- {
24+
"blockType": "permissions",
25+
"name": "networkaccess-cloudfirewallpolicy-list-policyrules-permissions"
26+
}
27+
-->
28+
[!INCLUDE [permissions-table](../includes/permissions/networkaccess-cloudfirewallpolicy-list-policyrules-permissions.md)]
29+
30+
[!INCLUDE [rbac-global-secure-access-apis-read](../includes/rbac-for-apis/rbac-global-secure-access-apis-read.md)]
31+
32+
## HTTP request
33+
34+
<!-- {
35+
"blockType": "ignored"
36+
}
37+
-->
38+
``` http
39+
GET /networkAccess/cloudFirewallPolicies/{cloudFirewallPolicyId}/policyRules
40+
```
41+
42+
## Optional query parameters
43+
44+
This method supports the `$select`, `$filter`, `$top`, `$skip`, and `$expand` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
45+
46+
## Request headers
47+
48+
|Name|Description|
49+
|:---|:---|
50+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
51+
52+
## Request body
53+
54+
Don't supply a request body for this method.
55+
56+
## Response
57+
58+
If successful, this method returns a `200 OK` response code and a collection of [cloudFirewallRule](../resources/networkaccess-cloudfirewallrule.md) objects in the response body.
59+
60+
## Examples
61+
62+
### Request
63+
64+
The following example shows a request.
65+
66+
<!-- {
67+
"blockType": "request",
68+
"name": "list_cloudfirewallrule"
69+
}
70+
-->
71+
``` http
72+
GET https://graph.microsoft.com/beta/networkAccess/cloudFirewallPolicies/80b58b7d-572f-4457-8944-c804fcf3b694/policyRules
73+
```
74+
75+
### Response
76+
77+
The following example shows the response.
78+
79+
>**Note:** The response object shown here might be shortened for readability.
80+
81+
<!-- {
82+
"blockType": "response",
83+
"truncated": true,
84+
"@odata.type": "Collection(microsoft.graph.networkaccess.cloudFirewallRule)"
85+
}
86+
-->
87+
``` http
88+
HTTP/1.1 200 OK
89+
Content-Type: application/json
90+
91+
{
92+
"value": [
93+
{
94+
"@odata.type": "#microsoft.graph.networkaccess.cloudFirewallRule",
95+
"id": "406ebb24-e229-4011-8240-e11bbaa4f49d",
96+
"name": "Block outbound SSH",
97+
"description": "Block SSH connections to external servers",
98+
"priority": 100,
99+
"action": "block",
100+
"settings": {
101+
"status": "enabled"
102+
},
103+
"matchingConditions": {
104+
"destinations": {
105+
"addresses": [
106+
{
107+
"@odata.type": "#microsoft.graph.networkaccess.cloudFirewallDestinationIpAddress",
108+
"values": ["10.0.0.1"]
109+
}
110+
],
111+
"ports": ["22"],
112+
"protocols": "tcp"
113+
}
114+
}
115+
}
116+
]
117+
}
118+
```

0 commit comments

Comments
 (0)