Skip to content

Commit 3d80d1e

Browse files
FaithOmbongiFaithOmbongi
committed
Merge branches 'main' and 'users/sitaolu/cloudPcDeviceImage_getSourceImages_doc_update' of https://github.com/microsoftgraph/microsoft-graph-docs into users/sitaolu/cloudPcDeviceImage_getSourceImages_doc_update
2 parents 4cefc8f + d05e3d3 commit 3d80d1e

66 files changed

Lines changed: 2269 additions & 74 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/channel-list-enabledapps.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,8 @@ Namespace: microsoft.graph
1616

1717
Get a list of the [enabled apps](../resources/teamsapp.md) in the specified [channel](../resources/channel.md) within a [team](../resources/team.md).
1818

19+
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
20+
1921
## Permissions
2022

2123
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).

‎api-reference/beta/api/exchangemessagetrace-getdetailsbyrecipient.md‎

Lines changed: 112 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,112 @@
1+
---
2+
title: "exchangeMessageTrace: getDetailsByRecipient"
3+
description: "Get a list of exchangeMessageTraceDetail objects filtered on the recipient."
4+
author: "Huajian-MSIT"
5+
ms.date: 12/04/2025
6+
ms.localizationpriority: medium
7+
ms.subservice: "outlook"
8+
doc_type: apiPageType
9+
---
10+
11+
# exchangeMessageTrace: getDetailsByRecipient
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Get a list of [exchangeMessageTraceDetail](../resources/exchangemessagetracedetail.md) objects filtered on the recipient.
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": "exchangemessagetrace_getdetailsbyrecipient" } -->
24+
[!INCLUDE [permissions-table](../includes/permissions/exchangemessagetrace-getdetailsbyrecipient-permissions.md)]
25+
26+
## HTTP request
27+
28+
<!-- {
29+
"blockType": "ignored"
30+
}
31+
-->
32+
``` http
33+
GET /admin/exchange/tracing/messageTraces/{exchangeMessageTraceId}/getDetailsByRecipient(recipientAddress='parameterValue')
34+
```
35+
36+
## Function parameters
37+
In the request URL, provide the following query parameters with values.
38+
39+
|Parameter|Type|Description|
40+
|:---|:---|:---|
41+
|recipientAddress|String|The SMTP email address of the user that the message was addressed to.|
42+
43+
44+
## Request headers
45+
46+
|Name|Description|
47+
|:---|:---|
48+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
49+
50+
## Request body
51+
52+
Don't supply a request body for this method.
53+
54+
## Response
55+
56+
If successful, this function returns a `200 OK` response code and a [exchangeMessageTraceDetail](../resources/exchangemessagetracedetail.md) collection in the response body.
57+
58+
## Examples
59+
60+
### Request
61+
62+
The following example shows a request.
63+
<!-- {
64+
"blockType": "request",
65+
"name": "exchangemessagetracethis.getdetailsbyrecipient"
66+
}
67+
-->
68+
``` http
69+
GET https://graph.microsoft.com/beta/admin/exchange/tracing/messageTraces/7e3b2b2e-1b5e-4b17-80cc-2af6c1d9a3b1/getDetailsByRecipient(recipientAddress='robert@contoso.com')
70+
```
71+
72+
73+
### Response
74+
75+
The following example shows the response.
76+
>**Note:** The response object shown here might be shortened for readability.
77+
<!-- {
78+
"blockType": "response",
79+
"truncated": true,
80+
"@odata.type": "Collection(microsoft.graph.exchangeMessageTraceDetail)"
81+
}
82+
-->
83+
``` http
84+
HTTP/1.1 200 OK
85+
Content-Type: application/json
86+
87+
{
88+
"value": [
89+
{
90+
"@odata.type": "#microsoft.graph.exchangeMessageTraceDetail",
91+
"id": "7e3b2b2e-1b5e-4b17-80cc-2af6c1d9a3b1",
92+
"messageId": "<d9683b4c-127b-413a-ae2e-fa7dfb32c69d@contoso.com>",
93+
"dateTime": "2025-06-13T10:30:05Z",
94+
"event": "Receive",
95+
"action": "",
96+
"description": "Message received by: MN2PR00MB0670.namprd00.prod.outlook.com",
97+
"data": "<root><MEP ... String=\"Message Body\" /></root>"
98+
},
99+
{
100+
"@odata.type": "#microsoft.graph.exchangeMessageTraceDetail",
101+
"id": "7e3b2b2e-1b5e-4b17-80cc-2af6c1d9a3b1",
102+
"messageId": "<d9683b4c-127b-413a-ae2e-fa7dfb32c69d@contoso.com>",
103+
"dateTime": "2025-06-13T10:30:10Z",
104+
"event": "Deliver",
105+
"action": "",
106+
"description": "The message was successfully delivered.",
107+
"data": "<root><MEP ... String=\"Message Body\" /></root>"
108+
}
109+
]
110+
}
111+
```
112+

‎api-reference/beta/api/messagetracingroot-list-messagetraces.md‎

Lines changed: 101 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,101 @@
1+
---
2+
title: "List messageTraces"
3+
description: "Get a list of exchangeMessageTrace objects."
4+
author: "Huajian-MSIT"
5+
ms.date: 12/04/2025
6+
ms.localizationpriority: medium
7+
ms.subservice: "outlook"
8+
doc_type: apiPageType
9+
---
10+
11+
# List messageTraces
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Get a list of [exchangeMessageTrace](../resources/exchangeMessageTrace.md) objects.
18+
19+
## Permissions
20+
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).
21+
22+
<!-- { "blockType": "permissions", "name": "messagetracingroot_list_messagetraces" } -->
23+
[!INCLUDE [permissions-table](../includes/permissions/messagetracingroot-list-messagetraces-permissions.md)]
24+
25+
## HTTP request
26+
27+
<!-- {
28+
"blockType": "ignored"
29+
}
30+
-->
31+
``` http
32+
GET /admin/exchange/tracing/messageTraces
33+
```
34+
35+
## Optional query parameters
36+
This method supports the `$filter`, `$top` and `$skipToken` OData query parameters of the [OData query parameters](/graph/query-parameters) to help customize the response.
37+
38+
The default page size for this API is 1000 **exchangeMessageTrace** objects. Use `$top` to customize the page size, within the range of 1 and 5000. To get the next page of message traces, simply apply the entire URL returned in `@odata.nextLink` to the next get-messagetraces request. This URL includes any query parameters you may have specified in the initial request. For more information, see [Paging Microsoft Graph data in your app](/graph/paging).
39+
40+
## Request headers
41+
42+
|Name|Description|
43+
|:---|:---|
44+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
45+
46+
## Request body
47+
48+
Don't supply a request body for this method.
49+
50+
## Response
51+
52+
If successful, this method returns a `200 OK` response code and a collection of [exchangeMessageTrace](../resources/exchangemessagetrace.md) objects in the response body.
53+
54+
## Examples
55+
56+
### Request
57+
58+
The following example shows a request.
59+
<!-- {
60+
"blockType": "request",
61+
"name": "list_exchangemessagetrace"
62+
}
63+
-->
64+
``` http
65+
GET https://graph.microsoft.com/beta/admin/exchange/tracing/messageTraces
66+
```
67+
68+
69+
### Response
70+
71+
The following example shows the response.
72+
>**Note:** The response object shown here might be shortened for readability.
73+
<!-- {
74+
"blockType": "response",
75+
"truncated": true,
76+
"@odata.type": "microsoft.graph.exchangeMessageTrace"
77+
}
78+
-->
79+
``` http
80+
HTTP/1.1 200 OK
81+
Content-Type: application/json
82+
83+
{
84+
"value": [
85+
{
86+
"@odata.type": "#microsoft.graph.exchangeMessageTrace",
87+
"id": "4451a062-48cb-e80d-e8c0-196330437ae6",
88+
"senderAddress": "sender@contoso.com",
89+
"recipientAddress": "recipient@contoso.com",
90+
"messageId": "<d9683b4c-127b-413a-ae2e-fa7dfb32c69d@contoso.com>",
91+
"receivedDateTime": "2025-06-13T10:30:00Z",
92+
"subject": "Quarterly Report",
93+
"size": 45678,
94+
"fromIP": "192.168.1.100",
95+
"toIP": "",
96+
"status": "Delivered"
97+
}
98+
]
99+
}
100+
```
101+

‎api-reference/beta/api/provisioningobjectsummary-list.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ Namespace: microsoft.graph
1616

1717
Get all provisioning events that occurred in your tenant, such as the deletion of a group in a target application or the creation of a user when provisioning user accounts from your HR system.
1818

19-
[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
19+
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
2020

2121
## Permissions
2222

‎api-reference/beta/api/security-environment-delete.md‎

Lines changed: 88 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,88 @@
1+
---
2+
title: "Delete environment"
3+
description: "Delete an environment from a zone by providing the environment ID. The environment ID should be URL-encoded."
4+
author: "Yarinle4"
5+
ms.date: 11/26/2025
6+
ms.localizationpriority: medium
7+
ms.subservice: "security"
8+
doc_type: apiPageType
9+
---
10+
11+
# Delete environment
12+
13+
Namespace: microsoft.graph.security
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Delete an [environment](../resources/security-environment.md) object from a [zone](../resources/security-zone.md) object by providing the environment ID. The environment ID should be URL-encoded.
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": "security-environment-delete-permissions"
26+
}
27+
-->
28+
[!INCLUDE [permissions-table](../includes/permissions/security-environment-delete-permissions.md)]
29+
30+
[!INCLUDE [rbac-security-zone-apis-write](../includes/rbac-for-apis/rbac-security-zone-apis-write.md)]
31+
32+
## HTTP request
33+
34+
<!-- {
35+
"blockType": "ignored"
36+
}
37+
-->
38+
``` http
39+
DELETE /security/zones/{zoneId}/environments/{environmentId}
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 to detach an Azure subscription environment from a zone.
61+
62+
The environment ID for Azure subscriptions uses the `/subscriptions/{subscription-id}` format and must be URL-encoded when used in the request URL.
63+
64+
| Format | Value |
65+
|:---|:---|
66+
| Original | `/subscriptions/d34fd44c-ebfa-4a9c-bceb-9eeafe72ac15` |
67+
| URL-encoded | `%2Fsubscriptions%2Fd34fd44c-ebfa-4a9c-bceb-9eeafe72ac15` |
68+
69+
<!-- {
70+
"blockType": "request",
71+
"name": "delete_environment"
72+
}
73+
-->
74+
``` http
75+
DELETE https://graph.microsoft.com/beta/security/zones/f6e190cba2f64bcba703694aedb81712/environments/%2Fsubscriptions%2Fd34fd44c-ebfa-4a9c-bceb-9eeafe72ac15
76+
```
77+
78+
### Response
79+
80+
The following example shows the response.
81+
<!-- {
82+
"blockType": "response",
83+
"truncated": true
84+
}
85+
-->
86+
``` http
87+
HTTP/1.1 204 No Content
88+
```

0 commit comments

Comments
 (0)