Skip to content

Commit 957ef51

Browse files
DanipocketDanipocket
authored
Merge pull request #27808 from microsoftgraph/main
2 parents 2f37b7c + d93052a commit 957ef51

15 files changed

+591
-12
lines changed

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

Lines changed: 121 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,121 @@
1+
---
2+
title: "Get deployment objects"
3+
description: "Retrieve a single deployment log by ID that includes the status of deployment performed through the Global Secure Access services."
4+
author: cagautham
5+
ms.date: 10/14/2025
6+
ms.localizationpriority: medium
7+
ms.subservice: entra-global-secure-access
8+
doc_type: apiPageType
9+
---
10+
11+
# Get deployment objects
12+
13+
Namespace: microsoft.graph.networkaccess
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Retrieve a [deployment](../resources/networkaccess-deployment.md) log by ID that includes the status of deployment performed through the Global Secure Access services.
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+
<!-- { "blockType": "permissions", "name": "networkaccess_deployment_logs_list" } -->
24+
[!INCLUDE [permissions-table](../includes/permissions/networkaccess-deployment-logs-permissions.md)]
25+
26+
[!INCLUDE [rbac-global-secure-access-apis-read](../includes/rbac-for-apis/rbac-global-secure-access-apis-read.md)]
27+
28+
## HTTP request
29+
30+
<!-- {
31+
"blockType": "ignored"
32+
}
33+
-->
34+
``` http
35+
GET /networkAccess/deployments('id')
36+
```
37+
38+
## Request headers
39+
40+
|Name|Description|
41+
|:---|:---|
42+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
43+
44+
## Request body
45+
46+
Don't supply a request body for this method.
47+
48+
## Response
49+
50+
If successful, this method returns a `200 OK` response code and a [deployment](../resources/networkaccess-deployment.md) object in the response body.
51+
52+
## Examples
53+
54+
### Request
55+
56+
The following example shows a request.
57+
<!-- {
58+
"blockType": "request",
59+
"name": "get_deploymentLog"
60+
}
61+
-->
62+
``` http
63+
GET https://graph.microsoft.com/beta/networkAccess/deployments('61addd7c-33ca-4737-93cc-2a3adc933562')
64+
```
65+
66+
67+
### Response
68+
The following example shows the response.
69+
<!-- {
70+
"blockType": "response",
71+
"truncated": true,
72+
"@odata.type": "microsoft.graph.networkaccess.deployment"
73+
}
74+
-->
75+
``` http
76+
HTTP/1.1 200 OK
77+
Content-Type: application/json
78+
79+
{
80+
"@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/deployments",
81+
"requestId": "61addd7c-33ca-4737-93cc-2a3adc933562",
82+
"lastModifiedDateTime": "2025-01-19T21:26:35.0829571Z",
83+
"initiatedBy": "GSA Service account",
84+
"deploymentEndDateTime": "2025-01-19T21:29:39Z",
85+
"status": {
86+
"deploymentStage": "succeeded",
87+
"message": null
88+
},
89+
"configuration": {
90+
"@odata.type": "#microsoft.graph.networkaccess.deploymentConfiguration",
91+
"operationName": "Redistribute Forwarding Profile",
92+
"changeType": "forwardingProfile",
93+
"current": {
94+
"id": "e1d060bc-9ddc-4966-a31b-ca469039b589",
95+
"name": "Test profile"
96+
}
97+
}
98+
}
99+
```
100+
<!--
101+
{
102+
"type": "#page.annotation",
103+
"description": "Get deployment logs",
104+
"keywords": "",
105+
"section": "documentation",
106+
"tocPath": "",
107+
"suppressions": [
108+
"Error: get_deploymentLog:
109+
Malformed function params '{var}'. Expected key-value params e.g. /function1(key=value). Remove parentheses if no params are expected."
110+
]
111+
}
112+
-->
113+
114+
115+
116+
117+
118+
119+
120+
121+

‎api-reference/beta/api/networkaccess-deployments-list.md‎

Lines changed: 121 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,121 @@
1+
---
2+
title: "List deployment logs"
3+
description: "Retrieve a list of logs that include the status of deployments performed through the Global Secure Access services."
4+
author: cagautham
5+
ms.date: 08/14/2025
6+
ms.localizationpriority: medium
7+
ms.subservice: entra-global-secure-access
8+
doc_type: apiPageType
9+
---
10+
11+
# List deployment logs
12+
13+
Namespace: microsoft.graph.networkaccess
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Retrieve a list of logs that includes the status of [deployments](../resources/networkaccess-deployment.md) performed through the Global Secure Access services.
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+
<!-- { "blockType": "permissions", "name": "networkaccess_deployment_logs_list" } -->
24+
[!INCLUDE [permissions-table](../includes/permissions/networkaccess-deployment-logs-permissions.md)]
25+
26+
[!INCLUDE [rbac-global-secure-access-apis-read](../includes/rbac-for-apis/rbac-global-secure-access-apis-read.md)]
27+
28+
## HTTP request
29+
30+
<!-- {
31+
"blockType": "ignored"
32+
}
33+
-->
34+
``` http
35+
GET /networkAccess/deployments
36+
```
37+
38+
## Optional query parameters
39+
40+
This method supports OData query parameters to help customize the response. You can use the following parameters:
41+
42+
|Parameter|Description|
43+
|:---|:---|
44+
| $filter |Filter items by property values (e.g., `status/deploymentStage eq 'succeeded'`).|
45+
| $top |Show only the first n items.|
46+
| $skip |Skip the first n items.|
47+
| $orderby |Order items by property values.|
48+
49+
For more information, see [OData query parameters](/graph/query-parameters).
50+
## Request headers
51+
52+
|Name|Description|
53+
|:---|:---|
54+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
55+
56+
## Request body
57+
58+
Don't supply a request body for this method.
59+
60+
## Response
61+
62+
If successful, this method returns a `200 OK` response code and a collection of [deployment](../resources/networkaccess-deployment.md) objects in the response body.
63+
64+
## Examples
65+
66+
### Request
67+
68+
The following example shows a request.
69+
<!-- {
70+
"blockType": "request",
71+
"name": "list_deploymentLogs"
72+
}
73+
-->
74+
``` http
75+
GET https://graph.microsoft.com/beta/networkAccess/deployments
76+
```
77+
78+
79+
### Response
80+
The following example shows the response.
81+
>**Note:** The response object shown here might be shortened for readability.
82+
<!-- {
83+
"blockType": "response",
84+
"truncated": true,
85+
"@odata.type": "microsoft.graph.networkaccess.deployment"
86+
}
87+
-->
88+
``` http
89+
HTTP/1.1 200 OK
90+
Content-Type: application/json
91+
92+
{
93+
"@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/deployments",
94+
"value": [
95+
{
96+
"requestId": "61addd7c-33ca-4737-93cc-2a3adc933562",
97+
"lastModifiedDateTime": "2025-01-19T21:26:35.0829571Z",
98+
"initiatedBy": "GSA Service account",
99+
"deploymentEndDateTime": "2025-01-19T21:29:39Z",
100+
"status": {
101+
"deploymentStage": "succeeded",
102+
"message": null
103+
},
104+
"configuration": {
105+
"@odata.type": "#microsoft.graph.networkaccess.deploymentConfiguration",
106+
"operationName": "Redistribute Forwarding Profile",
107+
"changeType": "forwardingProfile"
108+
}
109+
}
110+
]
111+
}
112+
```
113+
114+
115+
116+
117+
118+
119+
120+
121+

‎api-reference/beta/includes/permissions/networkaccess-deployment-logs-permissions.md‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
---
2+
description: "Automatically generated file. DO NOT MODIFY"
3+
ms.topic: include
4+
ms.localizationpriority: medium
5+
---
6+
7+
|Permission type|Least privileged permissions|Higher privileged permissions|
8+
|:---|:---|:---|
9+
|Delegated (work or school account)|NetworkAccess-Reports.Read.All|NetworkAccess.ReadWrite.All|
10+
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
11+
|Application|NetworkAccess-Reports.Read.All|NetworkAccess.ReadWrite.All|

‎api-reference/beta/resources/baseentity.md‎

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
---
2+
title: "baseEntity resource type"
3+
description: "Represents a base entity."
4+
author: abhijeetsinha
5+
ms.localizationpriority: medium
6+
ms.subservice: entra-global-secure-access
7+
doc_type: resourcePageType
8+
ms.date: 11/05/2025
9+
---
10+
11+
# baseEntity resource type
12+
13+
Namespace: microsoft.graph.networkaccess
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Represents a base entity.
18+
19+
Inherits from [microsoft.graph.entity](../resources/entity.md).
20+
21+
## Properties
22+
|Property|Type|Description|
23+
|:---|:---|:---|
24+
|id|String|Identifier for the entity. Inherited from [microsoft.graph.entity](../resources/entity.md).|
25+
|name|String|Name of the entity|
26+
27+
## Relationships
28+
29+
None.
30+
31+
## JSON representation
32+
The following JSON representation shows the resource type.
33+
<!-- {
34+
"blockType": "resource",
35+
"keyProperty": "id",
36+
"baseType": "microsoft.graph.entity",
37+
"@odata.type": "microsoft.graph.networkaccess.baseEntity"
38+
}
39+
-->
40+
``` json
41+
{"@odata.type": "#microsoft.graph.networkaccess.baseEntity",
42+
"id": "String (identifier)",
43+
"name": "String"
44+
}
45+
```

‎api-reference/beta/resources/enums-networkaccess.md‎

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -578,6 +578,64 @@ Namespace: microsoft.graph.networkaccess
578578
|reportOnly|
579579
|unknownFutureValue|
580580

581+
### deploymentStage values
582+
583+
|Member|
584+
|:---|
585+
|inProgress|
586+
|pending|
587+
|failed|
588+
|succeeded|
589+
|unknownFutureValue|
590+
591+
### cloudApplicationCategory values
592+
593+
|Member|
594+
|:---|
595+
|hostingServices|
596+
|itServices|
597+
|accountingAndFinance|
598+
|businessManagement|
599+
|productivity|
600+
|eCommerce|
601+
|education|
602+
|marketing|
603+
|humanResourceManagement|
604+
|health|
605+
|security|
606+
|generativeAi|
607+
|newsAndEntertainment|
608+
|operationsManagement|
609+
|contentManagement|
610+
|developmentTools|
611+
|collaboration|
612+
|crm|
613+
|communications|
614+
|dataAnalytics|
615+
|advertising|
616+
|supplyChainAndLogistics|
617+
|projectManagement|
618+
|transportationAndTravel|
619+
|cloudComputingPlatform|
620+
|businessIntelligence|
621+
|cloudStorage|
622+
|propertyManagement|
623+
|contentSharing|
624+
|customerSupport|
625+
|sales|
626+
|productDesign|
627+
|socialNetwork|
628+
|onlineMeetings|
629+
|webmail|
630+
|internetOfThings|
631+
|forums|
632+
|webAnalytics|
633+
|websiteMonitoring|
634+
|vendorManagementSystem|
635+
|personalInstantMessaging|
636+
|codeHosting|
637+
|unknownFutureValue|
638+
581639
<!--
582640
{
583641
"type": "#page.annotation",

0 commit comments

Comments
 (0)