Skip to content

Commit be9e7b5

Browse files
DanielabomDanielabom
authored
Merge pull request #26234 from microsoftgraph/main
Merge to publish.
2 parents f6b2346 + 5a3e63e commit be9e7b5

File tree

57 files changed

+576
-123
lines changed

Some content is hidden

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

57 files changed

+576
-123
lines changed

‎api-reference/beta/api/authenticationeventlistener-update.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -218,4 +218,4 @@ Content-Type: application/json
218218
"@odata.context": "https://graph.microsoft.com/beta/$metadata#identity/authenticationEventListeners('0313cc37-d421-421d-857b-87804d61e33e')/conditions/applications/includeApplications/$entity",
219219
"appId": "63856651-13d9-4784-9abf-20758d509e19"
220220
}
221-
```
221+
```

‎api-reference/beta/api/certificatebasedauthpki-upload.md

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

1717
Append additional certificate authority details to a [certificateBasedAuthPki](../resources/certificatebasedauthpki.md) resource. Only one operation can run at a time and this operation can take up to 30 minutes to complete. To know whether another upload is in progress, call the [Get certificateBasedAuthPki](../api/certificatebasedauthpki-get.md). The **status** property will have the value `running`.
1818

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

2121
## Permissions
2222

‎api-reference/beta/api/channel-list-allmembers.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ Get a list of all [members](../resources/conversationmember.md) in a [channel](.
2525

2626
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).
2727

28-
<!-- { "blockType": "permissions", "name": "channel-list-allmembers" } -->
28+
<!-- { "blockType": "permissions", "name": "channel_list_allmembers" } -->
2929
[!INCLUDE [permissions-table](../includes/permissions/channel-list-allmembers-permissions.md)]
3030

3131
> [!NOTE]
@@ -163,4 +163,4 @@ Content-type: application/json
163163
"suppressions": [
164164
]
165165
}
166-
-->
166+
-->

‎api-reference/beta/api/cloudpcprovisioningpolicy-retrievepolicyapplyactionresult.md

Lines changed: 96 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,96 @@
1+
---
2+
title: "cloudpcprovisioningpolicy: retrievePolicyApplyActionResult"
3+
description: "Get the result of the latest apply operation of a provision policy. `Frontline shared` only. Administrators only."
4+
author: "zhuangzhuang131419"
5+
ms.localizationpriority: medium
6+
ms.subservice: "cloud-pc"
7+
doc_type: apiPageType
8+
ms.date: 01/07/2025
9+
---
10+
11+
# cloudpcprovisioningpolicy: retrievePolicyApplyActionResult
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Get the result of the latest apply operation of a provision policy. `Frontline shared` only. Administrators only.
18+
19+
[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
20+
21+
## Permissions
22+
23+
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).
24+
25+
<!-- { "blockType": "permissions", "name": "cloudpcprovisioningpolicy-retrievePolicyApplyActionResult" } -->
26+
[!INCLUDE [permissions-table](../includes/permissions/cloudpcprovisioningpolicy-retrievePolicyApplyActionResult-permissions.md)]
27+
28+
## HTTP request
29+
30+
<!-- {
31+
"blockType": "ignored"
32+
}
33+
-->
34+
35+
``` http
36+
GET /deviceManagement/virtualEndpoint/provisioningPolicies/{id}/retrievePolicyApplyActionResult
37+
```
38+
39+
## Request headers
40+
41+
|Name|Description|
42+
|:---|:---|
43+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
44+
|Content-Type|application/json. Required.|
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 status, startDateTime, and finishDateTime in the response body.
53+
54+
|Parameter|Type|Description|
55+
|:---|:---|:---|
56+
|status|string|The status of the applied operation. Possible values are, `succeeded`, `pending`, `failed` and `unknownFutureValue`.|
57+
|startDateTime|DateTime|The date and time when the operation was applied.|
58+
|finishDateTime|DateTime|The date and time when the operation finished.|
59+
60+
## Examples
61+
62+
### Request
63+
64+
The following example shows a request.
65+
66+
<!-- {
67+
"blockType": "request",
68+
"name": "cloudpcprovisioningpolicy-retrievePolicyApplyActionResult"
69+
}
70+
-->
71+
72+
``` http
73+
GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/provisioningPolicies/b0c2d35f-3385-46c8-a6f5-6c3dfad7708b/retrievePolicyApplyActionResult
74+
```
75+
76+
### Response
77+
78+
The following example shows the response.
79+
80+
<!-- {
81+
"blockType": "response",
82+
"truncated": true,
83+
"@odata.type": "microsoft.graph.cloudPcPolicyApplyActionResult"
84+
}
85+
-->
86+
87+
``` http
88+
HTTP/1.1 200 OK
89+
90+
{
91+
"@odata.type": "https://graph.microsoft.com/beta/$metadata#cloudPcPolicyApplyActionResult",
92+
"status": "succeeded",
93+
"startDateTime": "2024-10-10T00:00:00",
94+
"finishDateTime": "2024-10-11T00:00:00"
95+
}
96+
```

‎api-reference/beta/api/cloudpcprovisioningpolicy-retrievepolicyapplyschedule.md

Lines changed: 89 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,89 @@
1+
---
2+
title: "cloudpcprovisioningpolicy: retrievePolicyApplySchedule"
3+
description: "Get the scheduled apply rule set on the policy. `Frontline shared` only. Administrators only."
4+
author: "zhuangzhuang131419"
5+
ms.localizationpriority: medium
6+
ms.subservice: "cloud-pc"
7+
doc_type: apiPageType
8+
ms.date: 01/07/2025
9+
---
10+
11+
# cloudpcprovisioningpolicy: retrievePolicyApplySchedule
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Get the scheduled apply rule set on the policy. `Frontline shared` only. Administrators only.
18+
19+
[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
20+
21+
## Permissions
22+
23+
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).
24+
25+
<!-- { "blockType": "permissions", "name": "cloudpcprovisioningpolicy-retrievePolicyApplySchedule" } -->
26+
[!INCLUDE [permissions-table](../includes/permissions/cloudpcprovisioningpolicy-retrievePolicyApplySchedule-permissions.md)]
27+
28+
## HTTP request
29+
30+
<!-- {
31+
"blockType": "ignored"
32+
}
33+
-->
34+
35+
``` http
36+
GET /deviceManagement/virtualEndpoint/provisioningPolicies/{id}/retrievePolicyApplySchedule
37+
```
38+
39+
## Request headers
40+
41+
|Name|Description|
42+
|:---|:---|
43+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
44+
|Content-Type|application/json. Required.|
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 [cloudpcpolicyscheduledapplyactiondetail](../resources/cloudpcpolicyscheduledapplyactiondetail.md) in the response body.
53+
54+
## Examples
55+
56+
### Request
57+
58+
The following example shows a request.
59+
60+
<!-- {
61+
"blockType": "request",
62+
"name": "cloudpcprovisioningpolicy-retrievePolicyApplySchedule"
63+
}
64+
-->
65+
66+
``` http
67+
GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/provisioningPolicies/b0c2d35f-3385-46c8-a6f5-6c3dfad7708b/retrievePolicyApplySchedule
68+
```
69+
70+
### Response
71+
72+
The following example shows the response.
73+
74+
<!-- {
75+
"blockType": "response",
76+
"truncated": true,
77+
"@odata.type": "microsoft.graph.cloudPcPolicyScheduledApplyActionDetail"
78+
}
79+
-->
80+
81+
``` http
82+
HTTP/1.1 200 OK
83+
84+
{
85+
"@odata.type": "https://graph.microsoft.com/beta/$metadata#cloudPcPolicyScheduledApplyActionDetail",
86+
"reservePercentage": 50,
87+
"cronScheduleExpression": "0 0 0 20 * *"
88+
}
89+
```

‎api-reference/beta/api/cloudpcprovisioningpolicy-schedulepolicyapplytask.md

Lines changed: 95 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,95 @@
1+
---
2+
title: "cloudpcprovisioningpolicy: schedulePolicyApplyTask"
3+
description: "Set a scheduled auto-reprovision task to do automatic regular apply. `Frontline shared` only. Administrators only."
4+
author: "zhuangzhuang131419"
5+
ms.localizationpriority: medium
6+
ms.subservice: "cloud-pc"
7+
doc_type: apiPageType
8+
ms.date: 01/07/2025
9+
---
10+
11+
# cloudpcprovisioningpolicy: schedulePolicyApplyTask
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Set a scheduled auto-reprovision task to do automatic regular apply. `Frontline shared` only. Administrators only.
18+
19+
[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
20+
21+
## Permissions
22+
23+
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).
24+
25+
<!-- { "blockType": "permissions", "name": "cloudpcprovisioningpolicy-schedulePolicyApplyTask" } -->
26+
[!INCLUDE [permissions-table](../includes/permissions/cloudpcprovisioningpolicy-schedulePolicyApplyTask-permissions.md)]
27+
28+
## HTTP request
29+
30+
<!-- {
31+
"blockType": "ignored"
32+
}
33+
-->
34+
35+
``` http
36+
POST /deviceManagement/virtualEndpoint/provisioningPolicies/{id}/schedulePolicyApplyTask
37+
```
38+
39+
## Request headers
40+
41+
|Name|Description|
42+
|:---|:---|
43+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
44+
|Content-Type|application/json. Required.|
45+
46+
## Request body
47+
48+
In the request body, supply a JSON representation of the [cloudpcpolicyscheduledapplyactiondetail](../resources/cloudpcpolicyscheduledapplyactiondetail.md) object.
49+
50+
The following table shows the properties that can be supplied when you schedule a policy apply task.
51+
52+
|Parameter|Type|Description|
53+
|:---|:---|:---|
54+
|reservePercentage|Int32|For `Frontline shared` only. The percentage of Cloud PCs to keep available. Administrators can set this property to a value from 0 to 99. Cloud PCs are reprovisioned only when there are no active and connected Cloud PC users.|
55+
|cronScheduleExpression|String|Administrators can set a cron expression to define the scheduling rules for automatic regular apply. When auto provision is disabled, `cronScheduleExpression` is set to null, stopping the automatic task scheduling (ex. "0 0 0 20 * *" means schedules a job to run at midnight on the 20th of every month). Read-only.|
56+
57+
## Response
58+
59+
If successful, this method returns a `202 ACCEPTED` response code.
60+
61+
## Examples
62+
63+
### Request
64+
65+
The following example shows a request.
66+
67+
<!-- {
68+
"blockType": "request",
69+
"name": "cloudpcprovisioningpolicy-schedulePolicyApplyTask"
70+
}
71+
-->
72+
73+
``` http
74+
POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/provisioningPolicies/b0c2d35f-3385-46c8-a6f5-6c3dfad7708b/schedulePolicyApplyTask
75+
76+
{
77+
"reservePercentage": 50,
78+
"cronScheduleExpression": "0 0 0 20 * *"
79+
}
80+
81+
```
82+
83+
### Response
84+
85+
The following example shows the response.
86+
87+
<!-- {
88+
"blockType": "response",
89+
"truncated": true
90+
}
91+
-->
92+
93+
``` http
94+
HTTP/1.1 204 No Content
95+
```

‎api-reference/beta/api/cloudpcreports-getactionstatusreports.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 the remote action status reports, including data such as the Cloud PC ID, Cloud PC device display name, initiating user's principal name, device owner's user principal name, action taken, and action state.
1818

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

2121
## Permissions
2222

‎api-reference/beta/api/directory-list-recommendation.md

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

1616
Get a list of the [recommendation](../resources/recommendation.md) objects and their properties.
1717

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

2020
## Permissions
2121
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/filestoragecontainer-restore.md

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

1717
Restore a deleted [fileStorageContainer](../resources/filestoragecontainer.md) from the deleted container collection.
1818

19+
[!INCLUDE [national-cloud-support](../../includes/global-us.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/impactedresource-complete.md

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

1616
Complete an [impactedResource](../resources/impactedresource.md) object and update its **status** to `completedByUser`.
1717

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

2020
## Permissions
2121
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).

0 commit comments

Comments
 (0)