diff --git a/api-reference/beta/api/site-archive.md b/api-reference/beta/api/site-archive.md index 5343a7ef98f..082f356081b 100644 --- a/api-reference/beta/api/site-archive.md +++ b/api-reference/beta/api/site-archive.md @@ -29,12 +29,8 @@ Choose the permission or permissions marked as least privileged for this API. Us |Delegated (personal Microsoft account)|Not supported.|Not supported.| |Application|Sites.FullControl.All|Not available.| -In delegated scenarios, the signed-in user must also be assigned one of the following supported [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference) for this operation: - -* SharePoint Administrator -* Global Administrator - -*SharePoint Administrator* is the least privileged role for this operation. +> [!IMPORTANT] +> In delegated scenarios with work or school accounts, the signed-in user must be assigned a supported [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) or a custom role with a supported role permission. *SharePoint Administrator* is the least privileged role for this operation. ## HTTP request diff --git a/api-reference/beta/api/site-unarchive.md b/api-reference/beta/api/site-unarchive.md index 904b522807d..dbf5b34c3e0 100644 --- a/api-reference/beta/api/site-unarchive.md +++ b/api-reference/beta/api/site-unarchive.md @@ -29,12 +29,8 @@ Choose the permission or permissions marked as least privileged for this API. Us |Delegated (personal Microsoft account)|Not supported.|Not supported.| |Application|Sites.FullControl.All|Not available.| -In delegated scenarios, the signed-in user must also be assigned one of the following supported [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference) for this operation: - -* SharePoint Administrator -* Global Administrator - -*SharePoint Administrator* is the least privileged role for this operation. +> [!IMPORTANT] +> In delegated scenarios with work or school accounts, the signed-in user must be assigned a supported [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) or a custom role with a supported role permission. *SharePoint Administrator* is the least privileged role for this operation. ## HTTP request diff --git a/api-reference/beta/api/teamschannelplanner-list-plans.md b/api-reference/beta/api/teamschannelplanner-list-plans.md new file mode 100644 index 00000000000..618905138e8 --- /dev/null +++ b/api-reference/beta/api/teamschannelplanner-list-plans.md @@ -0,0 +1,116 @@ +--- +title: "List plans" +description: "Get a list of plannerPlan objects owned by a shared channel in Teams." +ms.localizationpriority: medium +author: "DanluCui" +ms.subservice: "planner" +doc_type: apiPageType +ms.date: 01/15/2025 +--- + +# List plans + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Get a list of [plannerPlan](../resources/plannerplan.md) objects owned by a shared [channel](../resources/channel.md) in Teams. + +[!INCLUDE [national-cloud-support](../../includes/global-us.md)] + +## Permissions +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). + + +[!INCLUDE [permissions-table](../includes/permissions/teamschannelplanner-list-plans-permissions.md)] + +## HTTP request + +```http +GET /teams/{team-id}/channels/{channel-id}/planner/plans +``` + +## Request headers +| Name |Description| +|:----------|:----------| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| + +## Request body +Don't supply a request body for this method. + +## Response + +If successful, this method returns a `200 OK` response code and a collection of [plannerPlan](../resources/plannerplan.md) objects in the response body. + +This method can return any of the [HTTP status codes](/graph/errors). The most common errors that apps should handle for this method are the `403` and `404` responses. For more information about these errors, see [Common Planner error conditions](../resources/planner-overview.md#common-planner-error-conditions). + +## Examples + +### Request + +The following example shows a request. + + +```http +GET https://graph.microsoft.com/beta/teams/a738af50-90f1-472c-b3c3-a468f88ceaba/channels/19:yVS-hfmJ8w61Vu4oehlAr-y9G0eeyY11D8elrrDSvCU1@thread.tacv2/planner/plans +``` + +### Response + +The following example shows the response. + +>**Note:** The response object shown here might be shortened for readability. + +```http +HTTP/1.1 200 OK +Content-type: application/json + +{ + "value": [ + { + "@odata.etag": "W/\"JzEtUGxhbiAgQEBAQEBAQEBAQEBAQEBARCc=\"", + "createdDateTime": "2025-01-14T18:03:25.8457422Z", + "isArchived": false, + "owner": "ba2b2488-cb8c-4dbc-882e-a9a8311bfee9", + "title": "travel plan", + "id": "TQZYwVBC4E6BUIg4nfSnfJUADdBY", + "createdBy": { + "application": { + "id": "de8bc8b5-d9f9-48b1-a8ad-b748da725064" + }, + "user": { + "id": "ba2b2488-cb8c-4dbc-882e-a9a8311bfee9" + } + }, + "container": { + "containerId": "a738af50-90f1-472c-b3c3-a468f88ceaba/channels/19:yVS-hfmJ8w61Vu4oehlAr-y9G0eeyY11D8elrrDSvCU1@thread.tacv2", + "type": "teamsChannel", + "url": "https://graph.microsoft.com/beta/teams/a738af50-90f1-472c-b3c3-a468f88ceaba/channels/19:yVS-hfmJ8w61Vu4oehlAr-y9G0eeyY11D8elrrDSvCU1@thread.tacv2" + } + } + ] +} +``` + + + + diff --git a/api-reference/beta/includes/permissions/teamschannelplanner-list-plans-permissions.md b/api-reference/beta/includes/permissions/teamschannelplanner-list-plans-permissions.md new file mode 100644 index 00000000000..e6f029cd184 --- /dev/null +++ b/api-reference/beta/includes/permissions/teamschannelplanner-list-plans-permissions.md @@ -0,0 +1,12 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +ms.topic: include +ms.localizationpriority: medium +--- + +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|Tasks.Read|Tasks.ReadWrite| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Tasks.Read.All|Tasks.ReadWrite.All| + diff --git a/api-reference/beta/resources/channel.md b/api-reference/beta/resources/channel.md index e0970aee154..606eeaad864 100644 --- a/api-reference/beta/resources/channel.md +++ b/api-reference/beta/resources/channel.md @@ -58,6 +58,8 @@ where files are shared, and where tabs are added. |[Unshare channel with team](../api/sharedwithchannelteaminfo-delete.md)|None|Unshare a channel with a team.| |[List allowed members](../api/sharedwithchannelteaminfo-list-allowedmembers.md)|[conversationMember](../resources/conversationmember.md) collection|Get the list of team members who have access to the shared channel.| |[Check user access](../api/channel-doesuserhaveaccess.md)|Boolean|Check whether a user has access to a shared channel or not.| +| **Planner** | | | +|[List plans](../api/teamschannelplanner-list-plans.md) |[plannerPlan](plannerplan.md) collection| Get a list of [plannerPlan](../resources/plannerplan.md) objects owned by a shared [channel](../resources/channel.md) in Teams.| ## Properties @@ -101,13 +103,14 @@ For a POST request example, see [Request (create channel in migration state)](/m | Relationship | Type |Description| |:---------------|:--------|:----------| -|messages|[chatMessage](chatmessage.md) collection|A collection of all the messages in the channel. A navigation property. Nullable.| -|tabs|[teamsTab](../resources/teamstab.md) collection|A collection of all the tabs in the channel. A navigation property.| -|members|[conversationMember](conversationmember.md) collection|A collection of membership records associated with the channel.| |allMembers|[conversationMember](conversationmember.md) collection |A collection of membership records associated with the channel. It includes both direct and indirect members of shared channels.| |[filesFolder](../api/channel-get-filesfolder.md)|[driveItem](driveitem.md)|Metadata for the location where the channel's files are stored.| +|members|[conversationMember](conversationmember.md) collection|A collection of membership records associated with the channel.| +|messages|[chatMessage](chatmessage.md) collection|A collection of all the messages in the channel. Nullable.| |operations|[teamsAsyncOperation](teamsasyncoperation.md) collection| The async operations that ran or are running on this team. | +|planner|[teamsChannelPlanner](teamschannelplanner.md) | Selective Planner services available to this channel. Currently, only shared channels are supported. Read-only. Nullable. | |sharedWithTeams|[sharedWithChannelTeamInfo](../resources/sharedwithchannelteaminfo.md) collection|A collection of teams with which a channel is shared.| +|tabs|[teamsTab](../resources/teamstab.md) collection| A collection of all the tabs in the channel.| ## JSON representation diff --git a/api-reference/beta/resources/cloudpcforensicstorageaccount.md b/api-reference/beta/resources/cloudpcforensicstorageaccount.md index ea820d3e25e..633341e1be1 100644 --- a/api-reference/beta/resources/cloudpcforensicstorageaccount.md +++ b/api-reference/beta/resources/cloudpcforensicstorageaccount.md @@ -1,6 +1,6 @@ --- title: "cloudPcForensicStorageAccount resource type" -description: "Represents a Cloud PC storage account for forensic analysis." +description: "Represents information about a Cloud PC storage account for forensic analysis." author: "xhan2077" ms.localizationpriority: medium ms.subservice: "cloud-pc" @@ -19,9 +19,20 @@ Represents the storage account information that can be used to store a snapshot ## Properties |Property|Type|Description| |:---|:---|:---| -|storageAccountId|String|The ID of the storage account.| -|storageAccountName|String|The name of the storage account.| +|accessTier|[cloudPcStorageAccountAccessTier](#cloudpcstorageaccountaccesstier-values)| The access tier of the storage account. Possible values are `hot`, `cool`, `premium`, `cold`, and `unknownFutureValue`. Default value is `hot`. Read-only.| |immutableStorage|Boolean|Indicates whether immutability policies are configured for the storage account. When `true`, the storage account only accepts `hot` as the snapshot access tier. When `false`, the storage account accepts all valid access tiers. Read-Only.| +|storageAccountId|String|The ID of the storage account. Read-only.| +|storageAccountName|String|The name of the storage account. Read-only.| + +### cloudPcStorageAccountAccessTier values + +|Member|Description| +|:---|:---| +|hot|The storage account access tier is "hot." This tier is optimized for storing data that is accessed or modified frequently.| +|cool|The storage account access tier is "cool." This tier is optimized for storing data that is infrequently accessed or modified.| +|premium|The storage account access tier is "premium." This tier is optimized with low and consistent latency.| +|cold|The storage account access tier is "cold." This tier is optimized for storing data that is rarely accessed or modified, but still requires fast retrieval.| +|unknownFutureValue|Evolvable enumeration sentinel value. Don't use.| ## Relationships None. @@ -41,6 +52,7 @@ The following JSON representation shows the resource type. "@odata.type": "#microsoft.graph.cloudPcForensicStorageAccount", "storageAccountId": "String", "storageAccountName": "String", - "immutableStorage": "Boolean" + "immutableStorage": "Boolean", + "accessTier": "String" } ``` diff --git a/api-reference/beta/resources/teamschannelplanner.md b/api-reference/beta/resources/teamschannelplanner.md new file mode 100644 index 00000000000..1e50717ab8a --- /dev/null +++ b/api-reference/beta/resources/teamschannelplanner.md @@ -0,0 +1,68 @@ +--- +title: "teamsChannelPlanner resource type" +description: "Provides access to Planner resources for a Teams shared channel." +ms.localizationpriority: medium +author: "DanluCui" +ms.subservice: "planner" +doc_type: resourcePageType +ms.date: 01/15/2025 +--- + +# teamsChannelPlanner resource type + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Provides access to Planner resources for a Teams shared [channel](channel.md). This resource doesn't contain any usable properties. + +Inherits from [entity](entity.md). + +## Methods +| Method | Return Type |Description| +|:---------------|:--------|:----------| +|[List plans](../api/teamschannelplanner-list-plans.md) |[plannerPlan](plannerplan.md) collection| Get a list of [plannerPlan](../resources/plannerplan.md) objects owned by a shared [channel](../resources/channel.md) in Teams.| + +## Properties +| Property | Type |Description| +|:---------------|:--------|:----------| +|id|String| The unique identifier for the **teamsChannelPlanner** object. Read-only. Inherited from [entity](entity.md).| + +## Relationships +| Relationship | Type |Description| +|:---------------|:--------|:----------| +|plans|[plannerPlan](plannerplan.md) collection| A collection of [plannerPlan](plannerplan.md) objects owned by the Teams channel. Currently, only shared channels are supported. Read-only. Nullable.| + +## JSON representation + +The following JSON representation shows the resource type. + + + +```json +{ + "id": "String (identifier)" +} +``` + + + + diff --git a/api-reference/beta/toc/tasks-and-plans/toc.yml b/api-reference/beta/toc/tasks-and-plans/toc.yml index 8f06cea940a..4a7c41985fd 100644 --- a/api-reference/beta/toc/tasks-and-plans/toc.yml +++ b/api-reference/beta/toc/tasks-and-plans/toc.yml @@ -110,6 +110,12 @@ items: href: ../../api/plannertaskdetails-get.md - name: Update task details href: ../../api/plannertaskdetails-update.md +- name: Teams channel planner + items: + - name: Teams channel planner + href: ../../resources/teamschannelplanner.md + - name: List plans + href: ../../api/teamschannelplanner-list-plans.md - name: Business scenarios (preview) items: - name: Overview diff --git a/api-reference/beta/toc/teamwork-and-communications/toc.yml b/api-reference/beta/toc/teamwork-and-communications/toc.yml index 0175ead1403..ba70bdd7204 100644 --- a/api-reference/beta/toc/teamwork-and-communications/toc.yml +++ b/api-reference/beta/toc/teamwork-and-communications/toc.yml @@ -819,6 +819,10 @@ items: href: ../../api/sharedwithchannelteaminfo-list-allowedmembers.md - name: Check user access href: ../../api/channel-doesuserhaveaccess.md + - name: Planner + items: + - name: List plans + href: ../../api/teamschannelplanner-list-plans.md - name: Chat items: - name: Chat diff --git a/api-reference/beta/toc/toc.mapping.json b/api-reference/beta/toc/toc.mapping.json index 5687040c660..207e50a940f 100644 --- a/api-reference/beta/toc/toc.mapping.json +++ b/api-reference/beta/toc/toc.mapping.json @@ -2772,7 +2772,8 @@ "plannerPlanDetails", "plannerRoster", "plannerUser", - "plannerTaskDetails" + "plannerTaskDetails", + "teamsChannelPlanner" ], "complexTypes": [ "businessScenarioGroupTarget", diff --git a/changelog/Microsoft.CloudManagedDesktop.json b/changelog/Microsoft.CloudManagedDesktop.json index b4326e64e52..44503de739f 100644 --- a/changelog/Microsoft.CloudManagedDesktop.json +++ b/changelog/Microsoft.CloudManagedDesktop.json @@ -1,30 +1,64 @@ { "changelog": [ - { - "ChangeList": [ - { - "Id": "d2fbdff0-4da3-4e94-829b-fcee62ccbb58", - "ApiChange": "Property", - "ChangedApiName": "userInitiatedDisasterRecoveryAllowed", - "ChangeType": "Addition", - "Description": "Added the **userInitiatedDisasterRecoveryAllowed** property to the [cloudPcCrossRegionDisasterRecoverySetting](https://learn.microsoft.com/en-us/graph/api/resources/cloudPcCrossRegionDisasterRecoverySetting?view=graph-rest-beta) resource.", - "Target": "cloudPcCrossRegionDisasterRecoverySetting" - }, - { - "Id": "d2fbdff0-4da3-4e94-829b-fcee62ccbb58", - "ApiChange": "Property", - "ChangedApiName": "crossRegionDisasterRecoveryEnabled", - "ChangeType": "Deprecation", - "Description": "Deprecated the **crossRegionDisasterRecoveryEnabled** property of the [cloudPcCrossRegionDisasterRecoverySetting](https://learn.microsoft.com/en-us/graph/api/resources/cloudPcCrossRegionDisasterRecoverySetting?view=graph-rest-beta) resource. The **crossRegionDisasterRecoveryEnabled** property is deprecated and will no longer be supported effective February 11, 2025. For scenarios where **crossRegionDisasterRecoveryEnabled** is `true`, set **disasterRecoveryType** to `crossRegion`. For scenarios where **crossRegionDisasterRecoveryEnabled** is `false`, set **disasterRecoveryType** to `notconfigured`.", - "Target": "cloudPcCrossRegionDisasterRecoverySetting" - } - ], - "Id": "d2fbdff0-4da3-4e94-829b-fcee62ccbb58", - "Cloud": "Prod", - "Version": "beta", - "CreatedDateTime": "2024-12-08T06:09:33.7283612Z", - "WorkloadArea": "Device and app management", - "SubArea": "Cloud PC" + { + "ChangeList": [ + { + "Id": "50cf0bff-857a-4f38-b021-a0095e5f502f", + "ApiChange": "Enumeration", + "ChangedApiName": "cloudPcStorageAccountAccessTier", + "ChangeType": "Addition", + "Description": "Added the **cloudPcStorageAccountAccessTier** enumeration type.", + "Target": "cloudPcStorageAccountAccessTier" + }, + { + "Id": "50cf0bff-857a-4f38-b021-a0095e5f502f", + "ApiChange": "Property", + "ChangedApiName": "accessTier", + "ChangeType": "Addition", + "Description": "Added the **accessTier** property to the [cloudPcForensicStorageAccount](https://learn.microsoft.com/en-us/graph/api/resources/cloudpcforensicstorageaccount?view=graph-rest-beta) resource.", + "Target": "cloudPcForensicStorageAccount" + }, + { + "Id": "50cf0bff-857a-4f38-b021-a0095e5f502f", + "ApiChange": "Property", + "ChangedApiName": "immutableStorage", + "ChangeType": "Addition", + "Description": "Added the **immutableStorage** property to the [cloudPcForensicStorageAccount](https://learn.microsoft.com/en-us/graph/api/resources/cloudpcforensicstorageaccount?view=graph-rest-beta) resource.", + "Target": "cloudPcForensicStorageAccount" + } + ], + "Id": "50cf0bff-857a-4f38-b021-a0095e5f502f", + "Cloud": "Prod", + "Version": "beta", + "CreatedDateTime": "2025-01-22T06:12:52.5040743Z", + "WorkloadArea": "Device and app management", + "SubArea": "Cloud PC" + }, + { + "ChangeList": [ + { + "Id": "d2fbdff0-4da3-4e94-829b-fcee62ccbb58", + "ApiChange": "Property", + "ChangedApiName": "userInitiatedDisasterRecoveryAllowed", + "ChangeType": "Addition", + "Description": "Added the **userInitiatedDisasterRecoveryAllowed** property to the [cloudPcCrossRegionDisasterRecoverySetting](https://learn.microsoft.com/en-us/graph/api/resources/cloudPcCrossRegionDisasterRecoverySetting?view=graph-rest-beta) resource.", + "Target": "cloudPcCrossRegionDisasterRecoverySetting" + }, + { + "Id": "d2fbdff0-4da3-4e94-829b-fcee62ccbb58", + "ApiChange": "Property", + "ChangedApiName": "crossRegionDisasterRecoveryEnabled", + "ChangeType": "Deprecation", + "Description": "Deprecated the **crossRegionDisasterRecoveryEnabled** property of the [cloudPcCrossRegionDisasterRecoverySetting](https://learn.microsoft.com/en-us/graph/api/resources/cloudPcCrossRegionDisasterRecoverySetting?view=graph-rest-beta) resource. The **crossRegionDisasterRecoveryEnabled** property is deprecated and will no longer be supported effective February 11, 2025. For scenarios where **crossRegionDisasterRecoveryEnabled** is `true`, set **disasterRecoveryType** to `crossRegion`. For scenarios where **crossRegionDisasterRecoveryEnabled** is `false`, set **disasterRecoveryType** to `notconfigured`.", + "Target": "cloudPcCrossRegionDisasterRecoverySetting" + } + ], + "Id": "d2fbdff0-4da3-4e94-829b-fcee62ccbb58", + "Cloud": "Prod", + "Version": "beta", + "CreatedDateTime": "2024-12-08T06:09:33.7283612Z", + "WorkloadArea": "Device and app management", + "SubArea": "Cloud PC" }, { "ChangeList": [ diff --git a/changelog/Microsoft.Tasks.json b/changelog/Microsoft.Tasks.json index ad04b384325..eb649c29eb8 100644 --- a/changelog/Microsoft.Tasks.json +++ b/changelog/Microsoft.Tasks.json @@ -1,5 +1,31 @@ { "changelog": [ + { + "ChangeList": [ + { + "Id": "3da1192e-9af9-47d4-b32c-1ba82ddabcd1", + "ApiChange": "Relationship", + "ChangedApiName": "planner", + "ChangeType": "Addition", + "Description": "Added the **planner** relationship to the [channel](https://learn.microsoft.com/en-us/graph/api/resources/channel?view=graph-rest-beta) resource.", + "Target": "channel" + }, + { + "Id": "3da1192e-9af9-47d4-b32c-1ba82ddabcd1", + "ApiChange": "Resource", + "ChangedApiName": "teamsChannelPlanner", + "ChangeType": "Addition", + "Description": "Added the [teamsChannelPlanner](https://learn.microsoft.com/en-us/graph/api/resources/teamsChannelPlanner?view=graph-rest-beta) resource and an associated method.", + "Target": "teamsChannelPlanner" + } + ], + "Id": "3da1192e-9af9-47d4-b32c-1ba82ddabcd1", + "Cloud": "Prod", + "Version": "beta", + "CreatedDateTime": "2025-01-22T22:58:43.1666848Z", + "WorkloadArea": "Tasks and plans", + "SubArea": "" + }, { "ChangeList": [ { diff --git a/concepts/sdks/national-clouds.md b/concepts/sdks/national-clouds.md index e0e71e03a2e..51e45b40745 100644 --- a/concepts/sdks/national-clouds.md +++ b/concepts/sdks/national-clouds.md @@ -66,6 +66,6 @@ Connect-MgGraph -Environment USGov -ClientId 'YOUR_CLIENT_ID' ` ### [TypeScript](#tab/typescript) -:::code language="csharp" source="./snippets/typescript/src/snippets/nationalClouds.ts" id="NationalCloudSnippet"::: +:::code language="typescript" source="./snippets/typescript/src/snippets/nationalClouds.ts" id="NationalCloudSnippet"::: --- diff --git a/concepts/whats-new-overview.md b/concepts/whats-new-overview.md index a6ef5ae0d99..f05cb47384c 100644 --- a/concepts/whats-new-overview.md +++ b/concepts/whats-new-overview.md @@ -67,7 +67,8 @@ Use the [start](/graph/api/industrydata-industrydatarun-start?view=graph-rest-be ### Tasks and plans -Use the [teamsChannel](/graph/api/resources/planner-overview?view=graph-rest-beta&preserve-view=true#container-type-teams-channel) container type to create plans in shared channels in Microsoft Teams. +- Use the [teamsChannel](/graph/api/resources/planner-overview?view=graph-rest-beta&preserve-view=true#container-type-teams-channel) container type to create plans in shared channels in Microsoft Teams. +- [List Planner plans](/graph/api/teamschannelplanner-list-plans?view=graph-rest-beta&preserve-view=true) owned by a shared channel in Teams. ## December 2024: New and generally available