diff --git a/api-reference/beta/api/appcatalogs-list-teamsapps.md b/api-reference/beta/api/appcatalogs-list-teamsapps.md index ee7baba3269..28f62589b26 100644 --- a/api-reference/beta/api/appcatalogs-list-teamsapps.md +++ b/api-reference/beta/api/appcatalogs-list-teamsapps.md @@ -14,7 +14,8 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] List [apps](../resources/teamsapp.md) from the Microsoft Teams app catalog. -It includes apps from the Microsoft Teams store, and apps from your organization's app catalog (the tenant app catalog). To get apps from your organization's app catalog only, specify `organization` as the **distributionMethod** in the request. + +This includes apps from the Microsoft Teams store and apps from your organization's app catalog (the tenant app catalog). To get apps from your organization's app catalog only, specify `organization` as the **distributionMethod** in the request. > [!NOTE] > In general, the **id** of a **teamsApp** resource is generated by the server. It is not the same as the **id** specified in a Teams app manifest, unless its **distributionMethod** is `store`. For other cases, the **id** provided by the developer as part of the Teams app manifest is stamped as the **externalId** in the **teamsApp** resource. @@ -28,8 +29,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/appcatalogs-list-teamsapps-permissions.md)] -> **Note**: -The Directory.Read.All and Directory.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission and avoid using these permissions going forward. +> [!NOTE] +> The Directory.Read.All and Directory.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission and avoid using these permissions going forward. ## HTTP request @@ -307,7 +308,7 @@ Content-Type: application/json ### Example 4: List applications with a given ID, and return the submission review state -The following example lists applications with a given ID, and expands **appDefinitions** to return the **publishingState**, which reflects the submission review state of the app. `Submitted` means the review is pending, `published` means the admin approved the app, and `rejected` means the the admin rejected the app. +The following example lists applications with a given ID, and expands **appDefinitions** to return the **publishingState**, which reflects the submission review state of the app. `Submitted` means the review is pending, `published` means the admin approved the app, and `rejected` means the admin rejected app. #### Request diff --git a/api-reference/beta/api/application-post-calls.md b/api-reference/beta/api/application-post-calls.md index c69e2e1954a..1ccf744bf18 100644 --- a/api-reference/beta/api/application-post-calls.md +++ b/api-reference/beta/api/application-post-calls.md @@ -26,10 +26,11 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/application-post-calls-permissions.md)] -> **Notes:** -> - For a call with app-hosted media, you need the Calls.AccessMedia.All permission in addition to one of the permissions listed in the previous table. -> - Cloud Video Interop solutions that are [Certified for Microsoft Teams](/MicrosoftTeams/cloud-video-interop) have permission to call this API to join meetings for which they have meeting join links, similar to external users joining through a browser. +> [!NOTE] > - The Calls.JoinGroupCalls.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> - For a call with app-hosted media, you need the Calls.AccessMedia.All permission in addition to one of the permissions listed in the previous table. + +Cloud Video Interop solutions that are [Certified for Microsoft Teams](/MicrosoftTeams/cloud-video-interop) have permission to call this API to join meetings for which they have meeting join links, similar to external users joining through a browser. ## HTTP request diff --git a/api-reference/beta/api/application-post-onlinemeetings.md b/api-reference/beta/api/application-post-onlinemeetings.md index 0598f15a78f..cfedad9c834 100644 --- a/api-reference/beta/api/application-post-onlinemeetings.md +++ b/api-reference/beta/api/application-post-onlinemeetings.md @@ -29,7 +29,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/application-post-onlinemeetings-permissions.md)] -To use the OnlineMeetings.ReadWrite.All application permission for this API, tenant administrators must create an [application access policy](/graph/cloud-communication-online-meeting-application-access-policy) and grant it to a user to authorize the app configured in the policy to create online meetings on behalf of that user (with user ID specified in the request path). +> [!NOTE] +> To use the OnlineMeetings.ReadWrite.All application permission for this API, tenant administrators must create an [application access policy](/graph/cloud-communication-online-meeting-application-access-policy) and grant it to a user to authorize the app configured in the policy to create online meetings on behalf of that user (with user ID specified in the request path). ## HTTP request @@ -41,7 +42,7 @@ POST /users/{userId}/onlineMeetings ``` > [!NOTE] ->- **userId** is the object ID of a user in [Microsoft Entra admin center > user management page](https://entra.microsoft.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade). For more details, see [Allow applications to access online meetings on behalf of a user](/graph/cloud-communication-online-meeting-application-access-policy). +>- **userId** is the object ID of a user in [Microsoft Entra admin center > user management page](https://entra.microsoft.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade). For more information, see [Allow applications to access online meetings on behalf of a user](/graph/cloud-communication-online-meeting-application-access-policy). ## Request headers diff --git a/api-reference/beta/api/attacksimulationroot-delete-trainingcampaigns.md b/api-reference/beta/api/attacksimulationroot-delete-trainingcampaigns.md index f2b70bc43e5..e9f12abd067 100644 --- a/api-reference/beta/api/attacksimulationroot-delete-trainingcampaigns.md +++ b/api-reference/beta/api/attacksimulationroot-delete-trainingcampaigns.md @@ -55,6 +55,7 @@ If successful, this method returns a `204 No Content` response code. ### Request The following example shows a request. +# [HTTP](#tab/http) +[!INCLUDE [permissions-table](../includes/permissions/channel-archive-permissions.md)] > **Note**: This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they are not a member of. @@ -69,6 +66,7 @@ The following example shows a request to archive a channel. #### Request +# [HTTP](#tab/http) [!INCLUDE [permissions-table](../includes/permissions/channel-post-messages-permissions.md)] -> **Note**: The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. - -> **Note**: Application permissions are *only* supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). -In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported. +> [!NOTE] +> - The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> - Application permissions are only supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported. diff --git a/api-reference/beta/api/channel-unarchive.md b/api-reference/beta/api/channel-unarchive.md index aaac43ff703..062ed22ca0a 100644 --- a/api-reference/beta/api/channel-unarchive.md +++ b/api-reference/beta/api/channel-unarchive.md @@ -21,13 +21,10 @@ Unarchiving is an asynchronous operation; a channel is unarchived when the async ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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). -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | ChannelSettings.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | ChannelSettings.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/channel-unarchive-permissions.md)] > **Note**: This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they are not a member of. @@ -59,6 +56,7 @@ The following example shows a request to unarchive a channel. #### Request +# [HTTP](#tab/http) [!INCLUDE [permissions-table](../includes/permissions/chat-delete-installedapps-permissions.md)] -> **Note**: The Chat.Manage.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The Chat.Manage.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request diff --git a/api-reference/beta/api/chat-delete-members.md b/api-reference/beta/api/chat-delete-members.md index 6b2d85e79a5..5abc33e2061 100644 --- a/api-reference/beta/api/chat-delete-members.md +++ b/api-reference/beta/api/chat-delete-members.md @@ -22,7 +22,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chat-delete-members-permissions.md)] -> **Note**: The Chat.Manage.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The Chat.Manage.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request diff --git a/api-reference/beta/api/chat-delete-tabs.md b/api-reference/beta/api/chat-delete-tabs.md index 10c5a45959b..065a5407ab0 100644 --- a/api-reference/beta/api/chat-delete-tabs.md +++ b/api-reference/beta/api/chat-delete-tabs.md @@ -25,7 +25,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chat-delete-tabs-permissions.md)] -> **Note**: The TeamsTab.Delete.Chat and TeamsTab.ReadWrite.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The TeamsTab.Delete.Chat and TeamsTab.ReadWrite.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request diff --git a/api-reference/beta/api/chat-get-installedapps.md b/api-reference/beta/api/chat-get-installedapps.md index 505ddb357c2..298e1dcfd4c 100644 --- a/api-reference/beta/api/chat-get-installedapps.md +++ b/api-reference/beta/api/chat-get-installedapps.md @@ -24,8 +24,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chat-get-installedapps-permissions.md)] -> **Note**: -The TeamsAppInstallation.Read.Chat and Chat.Manage.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The TeamsAppInstallation.Read.Chat and Chat.Manage.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request @@ -125,7 +125,7 @@ Content-type: application/json ``` ### Example 2: Get the set of resource-specific permissions consented for the app installed in the specified chat -The following example gets the list of any [resource-specific permissions that were granted to an app](../resources/teamsapppermissionset.md) as part of installation. A `$select` query parameterd is required to show the consented permission set. +The following example gets the list of any [resource-specific permissions that were granted to an app](../resources/teamsapppermissionset.md) as part of installation. A `$select` query parameter is required to show the consented permission set. #### Request diff --git a/api-reference/beta/api/chat-get-members.md b/api-reference/beta/api/chat-get-members.md index 87d2fefd333..0a9f359791f 100644 --- a/api-reference/beta/api/chat-get-members.md +++ b/api-reference/beta/api/chat-get-members.md @@ -29,7 +29,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chat-get-members-permissions.md)] -> **Note**: The TeamsAppInstallation.Read.Chat and Chat.Manage.Chat pPermissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The TeamsAppInstallation.Read.Chat and Chat.Manage.Chat pPermissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request @@ -40,7 +41,7 @@ GET /users/{user-id | user-principal-name}/chats/{chat-id}/members/{membership-i ## Optional query parameters -This operation does not support the [OData query parameters](/graph/query-parameters) to customize the response. +This operation doesn't support the [OData query parameters](/graph/query-parameters) to customize the response. ## Request headers diff --git a/api-reference/beta/api/chat-get-tabs.md b/api-reference/beta/api/chat-get-tabs.md index 3839e06f44f..369e2ba4249 100644 --- a/api-reference/beta/api/chat-get-tabs.md +++ b/api-reference/beta/api/chat-get-tabs.md @@ -23,7 +23,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chat-get-tabs-permissions.md)] -> **Note**: The TeamsTab.Read.Chat and TeamsTab.ReadWrite.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The TeamsTab.Read.Chat and TeamsTab.ReadWrite.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request diff --git a/api-reference/beta/api/chat-get.md b/api-reference/beta/api/chat-get.md index ae1fd8edfdf..5b6b8808adb 100644 --- a/api-reference/beta/api/chat-get.md +++ b/api-reference/beta/api/chat-get.md @@ -27,7 +27,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chat-get-permissions.md)] -> **Note**: The ChatSettings.Read.Chat, ChatSettings.ReadWrite.Chat, and Chat.Manage.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The ChatSettings.Read.Chat, ChatSettings.ReadWrite.Chat, and Chat.Manage.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request diff --git a/api-reference/beta/api/chat-list-installedapps.md b/api-reference/beta/api/chat-list-installedapps.md index cf4bf094d92..fdefaaabb5b 100644 --- a/api-reference/beta/api/chat-list-installedapps.md +++ b/api-reference/beta/api/chat-list-installedapps.md @@ -30,8 +30,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chat-list-installedapps-permissions.md)] -> **Note:** -The following permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent): +> [!NOTE] +> The following permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent): > - TeamsAppInstallation.ReadWriteAndConsentSelfForChat > - TeamsAppInstallation.ReadWriteAndConsentForChat > - TeamsAppInstallation.ReadWriteAndConsentSelfForChat.All diff --git a/api-reference/beta/api/chat-list-members.md b/api-reference/beta/api/chat-list-members.md index f523642ec59..b9085b18f9b 100644 --- a/api-reference/beta/api/chat-list-members.md +++ b/api-reference/beta/api/chat-list-members.md @@ -31,7 +31,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chat-list-members-permissions.md)] -> **Note**: The ChatMember.Read.Chat and Chat.Manage.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The ChatMember.Read.Chat and Chat.Manage.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request diff --git a/api-reference/beta/api/chat-list-messages.md b/api-reference/beta/api/chat-list-messages.md index c510c93e001..f7408f41806 100644 --- a/api-reference/beta/api/chat-list-messages.md +++ b/api-reference/beta/api/chat-list-messages.md @@ -30,7 +30,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chat-list-messages-permissions.md)] -> **Note:** The ChatMessage.Read.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The ChatMessage.Read.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request @@ -51,7 +52,7 @@ This method supports the following [OData query parameters](/graph/query-paramet | [$orderby](/graph/query-parameters#orderby-parameter) | Currently supports the **lastModifiedDateTime** (default) and **createdDateTime** properties in descending order. The ascending order is currently not supported.| | [$filter](/graph/query-parameters#filter-parameter) | Sets the date range filter for the **lastModifiedDateTime** and **createdDateTime** properties. The **lastModifiedDateTime** property supports the `gt` and `lt` operators. The **createdDateTime** property supports the `lt` operator. You can only filter results if the request URL contains the `$orderby` and `$filter` query parameters configured for the same property; otherwise, the `$filter` query option is ignored.| -The other [OData query parameters](/graph/query-parameters) are not currently supported. +The other [OData query parameters](/graph/query-parameters) aren't currently supported. ## Request headers diff --git a/api-reference/beta/api/chat-list-operations.md b/api-reference/beta/api/chat-list-operations.md index e92a28693d0..29f86e20d0e 100644 --- a/api-reference/beta/api/chat-list-operations.md +++ b/api-reference/beta/api/chat-list-operations.md @@ -22,7 +22,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chat-list-operations-permissions.md)] -> **Note:** The ChatSettings.Read.Chat and ChatSettings.ReadWrite.Chat, and Chat.Manage.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The ChatSettings.Read.Chat and ChatSettings.ReadWrite.Chat, and Chat.Manage.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/chat-list-permissiongrants-permissions.md)] -> **Note**: The TeamsAppInstallation.Read.Chat and Chat.Manage.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The TeamsAppInstallation.Read.Chat and Chat.Manage.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request diff --git a/api-reference/beta/api/chat-patch-tabs.md b/api-reference/beta/api/chat-patch-tabs.md index 83f7d880ab8..196fac3a387 100644 --- a/api-reference/beta/api/chat-patch-tabs.md +++ b/api-reference/beta/api/chat-patch-tabs.md @@ -27,7 +27,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chat-patch-tabs-permissions.md)] -> **Note:** The TeamsTab.ReadWrite.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The TeamsTab.ReadWrite.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request diff --git a/api-reference/beta/api/chat-patch.md b/api-reference/beta/api/chat-patch.md index 878a8742acd..987873bfaa3 100644 --- a/api-reference/beta/api/chat-patch.md +++ b/api-reference/beta/api/chat-patch.md @@ -24,7 +24,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chat-patch-permissions.md)] -> **Note:**S The ChatSettings.ReadWrite.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The ChatSettings.ReadWrite.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request diff --git a/api-reference/beta/api/chat-post-installedapps.md b/api-reference/beta/api/chat-post-installedapps.md index 73386903116..c231e373765 100644 --- a/api-reference/beta/api/chat-post-installedapps.md +++ b/api-reference/beta/api/chat-post-installedapps.md @@ -27,7 +27,7 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chat-post-installedapps-permissions.md)] -> **Notes:** +> [!NOTE] > - The TeamsAppInstallation.ReadWriteSelfForChat, TeamsAppInstallation.ReadWriteForChat, TeamsAppInstallation.ReadWriteSelfForChat.All, and TeamsAppInstallation.ReadWriteForChat.All permissions cannot be used to install apps that require consent to resource-specific permissions. > - The Chat.Manage.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/beta/api/chat-post-members.md b/api-reference/beta/api/chat-post-members.md index ca8fb3b35b4..93cd9200a79 100644 --- a/api-reference/beta/api/chat-post-members.md +++ b/api-reference/beta/api/chat-post-members.md @@ -24,7 +24,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chat-post-members-permissions.md)] -> **Note:** The Chat.Manage.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The Chat.Manage.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request diff --git a/api-reference/beta/api/chat-post-tabs.md b/api-reference/beta/api/chat-post-tabs.md index 8627d34c011..e0887ba65e8 100644 --- a/api-reference/beta/api/chat-post-tabs.md +++ b/api-reference/beta/api/chat-post-tabs.md @@ -26,7 +26,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chat-post-tabs-permissions.md)] -> **Note:** The TeamsTab.Create.Chat and TeamsTab.ReadWrite.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The TeamsTab.Create.Chat and TeamsTab.ReadWrite.Chat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request diff --git a/api-reference/beta/api/chat-sendactivitynotification.md b/api-reference/beta/api/chat-sendactivitynotification.md index c04030c5073..157ad0ff05a 100644 --- a/api-reference/beta/api/chat-sendactivitynotification.md +++ b/api-reference/beta/api/chat-sendactivitynotification.md @@ -22,7 +22,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chat-sendactivitynotification-permissions.md)] ->**Note:** The TeamsActivity.Send.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The TeamsActivity.Send.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request diff --git a/api-reference/beta/api/chat-teamsappinstallation-upgrade.md b/api-reference/beta/api/chat-teamsappinstallation-upgrade.md index cbfc5022e5b..f38c2a1cbae 100644 --- a/api-reference/beta/api/chat-teamsappinstallation-upgrade.md +++ b/api-reference/beta/api/chat-teamsappinstallation-upgrade.md @@ -27,7 +27,7 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chat-teamsappinstallation-upgrade-permissions.md)] -> **Notes:** +> [!NOTE] > - The TeamsAppInstallation.ReadWriteSelfForChat, TeamsAppInstallation.ReadWriteForChat, TeamsAppInstallation.ReadWriteSelfForChat.All, and TeamsAppInstallation.ReadWriteForChat.All permissions can't be used to install apps that require consent to resource-specific permissions. > - The Chat.Manage.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/beta/api/chatmessage-get.md b/api-reference/beta/api/chatmessage-get.md index 89ce3602813..5c106507911 100644 --- a/api-reference/beta/api/chatmessage-get.md +++ b/api-reference/beta/api/chatmessage-get.md @@ -39,7 +39,8 @@ One of the following permissions is required to call this API. To learn more, in |Delegated (personal Microsoft account)|Not supported.| |Application| ChatMessage.Read.Chat, Chat.Read.All, Chat.ReadWrite.All| -> **Note**: The _ChannelMessage.Read.Group_ and _ChatMessage.Read.Chat_ permissions use [resource-specific consent]( https://aka.ms/teams-rsc). +> [!NOTE] +> The ChannelMessage.Read.Group and ChatMessage.Read.Chat permissions use [resource-specific consent]( https://aka.ms/teams-rsc). ## HTTP request @@ -59,7 +60,7 @@ GET /me/chats/{chat-id}/messages/{message-id} ``` ## Optional query parameters -This method does not support the [OData query parameters](/graph/query-parameters) to customize the response. +This method doesn't support the [OData query parameters](/graph/query-parameters) to customize the response. ## Request headers | Header | Value | diff --git a/api-reference/beta/api/chatmessage-list-hostedcontents.md b/api-reference/beta/api/chatmessage-list-hostedcontents.md index ac5180d64ab..27336c728b5 100644 --- a/api-reference/beta/api/chatmessage-list-hostedcontents.md +++ b/api-reference/beta/api/chatmessage-list-hostedcontents.md @@ -13,7 +13,7 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Retrieve the list of [chatMessageHostedContent](../resources/chatmessagehostedcontent.md) objects from a message. This API only lists the hosted content objects. To get the content bytes, see [get chatmessage hosted content](chatmessagehostedcontent-get.md) +Retrieve the list of [chatMessageHostedContent](../resources/chatmessagehostedcontent.md) objects from a message. This API only lists the hosted content objects. To get the content bytes, see [get chatmessage hosted content](chatmessagehostedcontent-get.md).s [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] @@ -27,7 +27,8 @@ Retrieve the list of [chatMessageHostedContent](../resources/chatmessagehostedco |Delegated (personal Microsoft account)|Not supported.| |Application| ChannelMessage.Read.Group, ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All | -> **Note**: The Group.Read.All and Group.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> [!NOTE] +> The Group.Read.All and Group.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. ### Permissions for chat @@ -37,7 +38,8 @@ Retrieve the list of [chatMessageHostedContent](../resources/chatmessagehostedco |Delegated (personal Microsoft account)|Not supported.| |Application| ChatMessage.Read.Chat, Chat.Read.All, Chat.ReadWrite.All| -> **Note**: The _ChannelMessage.Read.Group_ and _ChatMessage.Read.Chat_ permissions use [resource-specific consent]( https://aka.ms/teams-rsc). +> [!NOTE] +> The ChannelMessage.Read.Group and ChatMessage.Read.Chat permissions use [resource-specific consent]( https://aka.ms/teams-rsc). ## HTTP request diff --git a/api-reference/beta/api/chatmessage-list-replies.md b/api-reference/beta/api/chatmessage-list-replies.md index 24274eeb26d..94cc55534c8 100644 --- a/api-reference/beta/api/chatmessage-list-replies.md +++ b/api-reference/beta/api/chatmessage-list-replies.md @@ -27,7 +27,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chatmessage-list-replies-permissions.md)] -> **Note:** The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request diff --git a/api-reference/beta/api/chatmessage-post-replies.md b/api-reference/beta/api/chatmessage-post-replies.md index 1048a18d973..6be70d0abf4 100644 --- a/api-reference/beta/api/chatmessage-post-replies.md +++ b/api-reference/beta/api/chatmessage-post-replies.md @@ -29,10 +29,9 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chatmessage-post-replies-permissions.md)] -> **Note**: The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. - -> **Note**: Application permissions are *only* supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). -In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported. +> [!NOTE] +> - The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> - Application permissions are only supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported. ## HTTP request diff --git a/api-reference/beta/api/chatmessage-post.md b/api-reference/beta/api/chatmessage-post.md index b1037222a94..f398a87689f 100644 --- a/api-reference/beta/api/chatmessage-post.md +++ b/api-reference/beta/api/chatmessage-post.md @@ -29,9 +29,9 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chatmessage-post-permissions.md)] -> **Note**: The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. - -> **Note**: Application permissions are *only* supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported. +> [!NOTE] +> - The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> - Application permissions are only supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported. ### Permissions for chat diff --git a/api-reference/beta/api/chatmessage-update.md b/api-reference/beta/api/chatmessage-update.md index 73e1356ccca..a9224da0c37 100644 --- a/api-reference/beta/api/chatmessage-update.md +++ b/api-reference/beta/api/chatmessage-update.md @@ -17,7 +17,7 @@ You can update all the properties of **chatMessage** in delegated permissions sc Updating works only for chats where conversation members are Microsoft Teams users. If one of the members is using Skype, the operation fails. -This method does not support federation. Only the user in the tenant who sent the message can perform data loss prevention (DLP) updates on the specified chat message. +This method doesn't support federation. Only the user in the tenant who sent the message can perform data loss prevention (DLP) updates on the specified chat message. [!INCLUDE [teams-model-A-only-disclaimer](../../includes/teams-model-A-only-disclaimer.md)] @@ -35,7 +35,8 @@ One of the following permissions is required to call this API. To learn more, in | Delegated (personal Microsoft account) | Not supported. | | Application | ChannelMessage.UpdatePolicyViolation.All, Group.ReadWrite.All** | -> **Note:** The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> [!NOTE] +> The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. ### Permissions for chat @@ -73,7 +74,7 @@ PATCH /teams/(team-id)/channels/{channel-id}/messages/{message-id}/replies/{repl PATCH /chats/{chatThread-id}/messages/{message-id}?model=A ``` -If no `model` is specified, [evaluation mode](/graph/teams-licenses#evaluation-mode-default-requirements) will be used. +If no `model` is specified, [evaluation mode](/graph/teams-licenses#evaluation-mode-default-requirements) is used. ## Request headers @@ -411,7 +412,6 @@ HTTP/1.1 204 NoContent The following example shows a request to update the attachments on a Microsoft Teams channel message by using delegated permissions. - # [HTTP](#tab/http) @@ -59,7 +60,7 @@ GET /users/{user-id | user-principal-name}/chats/{chat-id}/messages/{message-id} ## Optional query parameters -This operation does not support the [OData query parameters](/graph/query-parameters) to customize the response. +This operation doesn't support the [OData query parameters](/graph/query-parameters) to customize the response. ## Request headers diff --git a/api-reference/beta/api/cloudpcprovisioningpolicy-apply.md b/api-reference/beta/api/cloudpcprovisioningpolicy-apply.md index 7da1716a3a8..d99fe176903 100644 --- a/api-reference/beta/api/cloudpcprovisioningpolicy-apply.md +++ b/api-reference/beta/api/cloudpcprovisioningpolicy-apply.md @@ -60,6 +60,7 @@ If successful, this method returns a `204 No Content` response code. The following example shows a request. +# [HTTP](#tab/http) ```msgraph-interactive GET https://graph.microsoft.com/beta/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE/lists/22e03ef3-6ef4-424d-a1d3-92a337807c30/items/delta?token=latest ``` +# [C#](#tab/csharp) +[!INCLUDE [sample-code](../includes/snippets/csharp/get-delta-latest-datalink-tokenislatest-csharp-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [CLI](#tab/cli) +[!INCLUDE [sample-code](../includes/snippets/cli/get-delta-latest-datalink-tokenislatest-cli-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Go](#tab/go) +[!INCLUDE [sample-code](../includes/snippets/go/get-delta-latest-datalink-tokenislatest-go-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Java](#tab/java) +[!INCLUDE [sample-code](../includes/snippets/java/get-delta-latest-datalink-tokenislatest-java-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [JavaScript](#tab/javascript) +[!INCLUDE [sample-code](../includes/snippets/javascript/get-delta-latest-datalink-tokenislatest-javascript-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [PHP](#tab/php) +[!INCLUDE [sample-code](../includes/snippets/php/get-delta-latest-datalink-tokenislatest-php-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [PowerShell](#tab/powershell) +[!INCLUDE [sample-code](../includes/snippets/powershell/get-delta-latest-datalink-tokenislatest-powershell-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Python](#tab/python) +[!INCLUDE [sample-code](../includes/snippets/python/get-delta-latest-datalink-tokenislatest-python-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +--- + #### Response The following example shows the response. diff --git a/api-reference/beta/api/security-authoritytemplate-get.md b/api-reference/beta/api/security-authoritytemplate-get.md index b5d6edb182f..1e4efdfbd84 100644 --- a/api-reference/beta/api/security-authoritytemplate-get.md +++ b/api-reference/beta/api/security-authoritytemplate-get.md @@ -59,7 +59,7 @@ The following example shows a request. } --> ``` http -GET https://graph.microsoft.com/beta/security/labels/authorities/{authorityTemplateId} +GET https://graph.microsoft.com/beta/security/labels/authorities/6cf65e55-6baf-44ff-5dcc-08d8de97b1d5 ``` # [C#](#tab/csharp) @@ -97,7 +97,7 @@ GET https://graph.microsoft.com/beta/security/labels/authorities/{authorityTempl --- ### Response -The following example shows the response. +Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. ``` http -DELETE /security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate/subCategories/{subCategoryTemplateId}/$ref +DELETE /security/labels/categories/{categoryTemplateId}/subCategories/{subCategoryTemplateId}/$ref ``` ## Request headers @@ -53,7 +53,7 @@ The following example shows a request. } --> ``` http -DELETE https://graph.microsoft.com/beta/security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate/subCategories/{subCategoryTemplateId} +DELETE https://graph.microsoft.com/beta/security/labels/categories/6cf65e55-6baf-44ff-5dcc-08d8de97b1d5/subCategories/f44dkle55-6baf-44ff-5dcc-08d8de97b1d5 ``` # [JavaScript](#tab/javascript) @@ -63,7 +63,7 @@ DELETE https://graph.microsoft.com/beta/security/labels/retentionLabels/{retenti --- ### Response -The following example shows the response. +Here's an example of the response. > ``` http -GET https://graph.microsoft.com/beta/security/labels/categories/{categoryTemplateId} +GET https://graph.microsoft.com/beta/security/labels/categories/e2c79762-34a9-75ba-b6f0-a7c9a57978ef ``` # [C#](#tab/csharp) @@ -97,7 +97,7 @@ GET https://graph.microsoft.com/beta/security/labels/categories/{categoryTemplat --- ### Response -The following example shows the response. +Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. ``` http -GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate/subCategories +GET /security/labels/categories/{categoryTemplateId}/subCategories ``` ## Optional query parameters @@ -56,7 +56,7 @@ The following example shows a request. } --> ``` http -GET https://graph.microsoft.com/beta/security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate/subCategories +GET https://graph.microsoft.com/beta/security/labels/categories/{categoryTemplateId}/subCategories ``` # [JavaScript](#tab/javascript) @@ -83,11 +83,14 @@ Content-Type: application/json { "@odata.type": "#microsoft.graph.security.subCategoryTemplate", "id": "2ac39915-dbeb-e933-82e2-92b981835fa0", - "displayName": "String", + "displayName": "Vendor Invoice", "createdBy": { - "@odata.type": "microsoft.graph.identitySet" + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } }, - "createdDateTime": "String (timestamp)" + "createdDateTime": "2021-03-24T02:09:08Z" } ] } diff --git a/api-reference/beta/api/security-categorytemplate-post-subcategories.md b/api-reference/beta/api/security-categorytemplate-post-subcategories.md index 12105b4f039..99a0beb4436 100644 --- a/api-reference/beta/api/security-categorytemplate-post-subcategories.md +++ b/api-reference/beta/api/security-categorytemplate-post-subcategories.md @@ -27,7 +27,7 @@ Choose the permission or permissions marked as least privileged for this API. Us } --> ``` http -POST /security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate/subCategories +POST /security/labels/categories/{categoryTemplateId}/subCategories ``` ## Request headers @@ -43,13 +43,12 @@ You can specify the following properties when creating a **subCategoryTemplate** |Property|Type|Description| |:---|:---|:---| -|displayName|String| Unique string that defines a sub-category name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptor.md). Optional.| +|displayName|String| Unique string that defines a subcategory name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptor.md). Optional.| ## Response - If successful, this method returns a `201 Created` response code and a [microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md) object in the response body. ## Examples @@ -63,15 +62,12 @@ The following example shows a request. } --> ``` http -POST https://graph.microsoft.com/beta/security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate/subCategories +POST https://graph.microsoft.com/beta/security/labels/categories/{categoryTemplateId}/subCategories Content-Type: application/json { "@odata.type": "#microsoft.graph.security.subCategoryTemplate", - "displayName": "String", - "createdBy": { - "@odata.type": "microsoft.graph.identitySet" - } + "displayName": "Vendor Invoice", } ``` @@ -82,7 +78,7 @@ Content-Type: application/json --- ### Response -The following example shows the response. +Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. ``` http -GET https://graph.microsoft.com/beta/security/labels/citations/{citationTemplateId} +GET https://graph.microsoft.com/beta/security/labels/citations/c0475d01-d532-8a53-6e26-14ea58c640bf ``` # [C#](#tab/csharp) @@ -97,7 +97,7 @@ GET https://graph.microsoft.com/beta/security/labels/citations/{citationTemplate --- ### Response -The following example shows the response. +Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. ``` http -GET https://graph.microsoft.com/beta/security/labels/departments/{departmentTemplateId} +GET https://graph.microsoft.com/beta/security/labels/departments/11b44677-9f06-c85a-4a0b-766b66904bf8 ``` # [C#](#tab/csharp) @@ -97,7 +97,7 @@ GET https://graph.microsoft.com/beta/security/labels/departments/{departmentTemp --- ### Response -The following example shows the response. +Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. ``` http -GET https://graph.microsoft.com/beta/security/labels/filePlanReferences/{filePlanReferenceTemplateId} +GET https://graph.microsoft.com/beta/security/labels/filePlanReferences/b1f7b518-a44f-1d4b-c6f1-ab8771d3907c ``` # [C#](#tab/csharp) @@ -97,7 +97,7 @@ GET https://graph.microsoft.com/beta/security/labels/filePlanReferences/{filePla --- ### Response -The following example shows the response. +Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. ``` http -GET /security/identities/healthIssues?$filter=Status eq 'open'&$filter=healthIssueType eq 'global' -GET /security/identities/healthIssues?$filter=Status eq 'open'&$filter=healthIssueType eq 'sensor' +GET /security/identities/healthIssues?$filter=Status eq 'open' and healthIssueType eq 'global' +GET /security/identities/healthIssues?$filter=Status eq 'open' and healthIssueType eq 'sensor' ``` -See open health alerts based on severity. +### Get open health alerts based on severity ``` http -GET /security/identities/healthIssues?$filter=Status eq 'open'&$filter=severity eq 'medium' -GET /security/identities/healthIssues?$filter=Status eq 'open'&$filter=severity eq 'low' +GET /security/identities/healthIssues?$filter=Status eq 'open' and severity eq 'medium' +GET /security/identities/healthIssues?$filter=Status eq 'open' and severity eq 'low' ``` See open global health alerts that domain name \ sensor DNS name ends with spesific value (name=contoso.com) @@ -82,12 +82,10 @@ See open global health alerts that domain name \ sensor DNS name ends with spesi } --> ``` http -GET /security/identities/healthissues?$filter=Status eq 'open'&$filter=healthIssueType eq 'global'&$filter=domainNames/any(s:endswith(s,'contoso.com')) -GET /security/identities/healthissues?$filter=Status eq 'open'&$filter=healthIssueType eq 'global'&$filter=sensorDNSNames/any(s:endswith(s,'contoso.com')) +GET /security/identities/healthissues?$filter=Status eq 'open' and healthIssueType eq 'global' and domainNames/any(s:endswith(s,'contoso.com')) +GET /security/identities/healthissues?$filter=Status eq 'open' and healthIssueType eq 'global' and sensorDNSNames/any(s:endswith(s,'contoso.com')) ``` -For general information, see [OData query parameters](/graph/query-parameters). - ## Request headers |Name|Description| diff --git a/api-reference/beta/api/security-labelsroot-delete-authorities.md b/api-reference/beta/api/security-labelsroot-delete-authorities.md index 1f0d90b7e73..129398dd1e3 100644 --- a/api-reference/beta/api/security-labelsroot-delete-authorities.md +++ b/api-reference/beta/api/security-labelsroot-delete-authorities.md @@ -56,7 +56,7 @@ The following example shows a request. } --> ``` http -DELETE https://graph.microsoft.com/beta/security/labels/authorities/{authorityTemplateId} +DELETE https://graph.microsoft.com/beta/security/labels/authorities/f44dkle55-6baf-44ff-5dcc-08d8de97b1d5 ``` # [C#](#tab/csharp) @@ -94,7 +94,7 @@ DELETE https://graph.microsoft.com/beta/security/labels/authorities/{authorityTe --- ### Response -The following example shows the response. +Here's an example of the response. > ``` http -DELETE https://graph.microsoft.com/beta/security/labels/categories/{categoryTemplateId} +DELETE https://graph.microsoft.com/beta/security/labels/categories/f44dkle55-6baf-44ff-5dcc-08d8de97b1d5 ``` # [C#](#tab/csharp) @@ -94,7 +94,7 @@ DELETE https://graph.microsoft.com/beta/security/labels/categories/{categoryTemp --- ### Response -The following example shows the response. +Here's an example of the response. > ``` http -DELETE https://graph.microsoft.com/beta/security/labels/citations/{citationTemplateId} -``` +DELETE https://graph.microsoft.com/beta/security/labels/citations/f44dkle55-6baf-44ff-5dcc-08d8de97b1d5 # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/delete-citationtemplate-csharp-snippets.md)] @@ -94,7 +93,7 @@ DELETE https://graph.microsoft.com/beta/security/labels/citations/{citationTempl --- ### Response -The following example shows the response. +Here's an example of the response. > ``` http -DELETE https://graph.microsoft.com/beta/security/labels/departments/{departmentTemplateId} +DELETE https://graph.microsoft.com/beta/security/labels/departments/f44dkle55-6baf-44ff-5dcc-08d8de97b1d5 ``` # [C#](#tab/csharp) @@ -94,7 +94,7 @@ DELETE https://graph.microsoft.com/beta/security/labels/departments/{departmentT --- ### Response -The following example shows the response. +Here's an example of the response. > ``` http -DELETE https://graph.microsoft.com/beta/security/labels/filePlanReferences/{filePlanReferenceTemplateId} +DELETE https://graph.microsoft.com/beta/security/labels/filePlanReferences/f44dkle55-6baf-44ff-5dcc-08d8de97b1d5 ``` # [C#](#tab/csharp) @@ -94,7 +94,7 @@ DELETE https://graph.microsoft.com/beta/security/labels/filePlanReferences/{file --- ### Response -The following example shows the response. +Here's an example of the response. > ``` http -DELETE https://graph.microsoft.com/beta/security/labels/retentionLabels/{retentionLabelId} +DELETE https://graph.microsoft.com/beta/security/labels/retentionLabels/9563a605-e827-4324-a5a9-09efddff1e50 ``` # [C#](#tab/csharp) @@ -94,6 +95,8 @@ DELETE https://graph.microsoft.com/beta/security/labels/retentionLabels/{retenti --- ### Response +Here's an example of the response. + > ``` http -PATCH https://graph.microsoft.com/beta/security/labels/retentionLabels/{retentionLabelId} +PATCH https://graph.microsoft.com/beta/security/labels/retentionLabels/9563a605-e827-4324-a5a9-09efddff1e50 Content-Type: application/json Content-length: 555 { "@odata.type": "#microsoft.graph.security.retentionLabel", "retentionDuration": { - "@odata.type": "microsoft.graph.security.retentionDuration" + "@odata.type": "microsoft.graph.security.retentionDurationInDays", + "days": 2555 }, - "descriptionForAdmins": "String", - "descriptionForUsers": "String", - "labelToBeApplied": "String", - "defaultRecordBehavior": "String" } ``` @@ -122,27 +120,13 @@ Content-length: 555 --- ### Response ->**Note:** The response object shown here might be shortened for readability. +Here's an example of the response. + ``` http -HTTP/1.1 200 OK -Content-Type: application/json - -{ - "@odata.type": "#microsoft.graph.security.retentionLabel", - "id": "64a99fb4-07be-0481-8746-44c15c0eef1f", - "retentionDuration": { - "@odata.type": "microsoft.graph.security.retentionDuration" - }, - "descriptionForAdmins": "String", - "descriptionForUsers": "String", - "labelToBeApplied": "String", - "defaultRecordBehavior": "String" -} +HTTP/1.1 204 No Content ``` diff --git a/api-reference/beta/api/security-subcategorytemplate-get.md b/api-reference/beta/api/security-subcategorytemplate-get.md index f8a3f48bd24..6ee94553510 100644 --- a/api-reference/beta/api/security-subcategorytemplate-get.md +++ b/api-reference/beta/api/security-subcategorytemplate-get.md @@ -27,7 +27,7 @@ Choose the permission or permissions marked as least privileged for this API. Us } --> ``` http -GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate/subCategories/{subCategoryTemplateId} +GET /security/labels/categories/{categoryTemplateId}/subCategories/{subCategoryTemplateId} ``` ## Optional query parameters @@ -56,7 +56,7 @@ The following example shows a request. } --> ``` http -GET https://graph.microsoft.com/beta/security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate/subCategories/{subCategoryTemplateId} +GET https://graph.microsoft.com/beta/security/labels/categories/82d00422-1f60-46cd-9809-33ca0b4d2286/subCategories/2ac39915-dbeb-e933-82e2-92b981835fa0 ``` # [JavaScript](#tab/javascript) @@ -66,7 +66,7 @@ GET https://graph.microsoft.com/beta/security/labels/retentionLabels/{retentionL --- ### Response -The following example shows the response. +Here's an example of the response. >**Note:** The response object shown here might be shortened for readability. ``` json { - "@odata.type": "#microsoft.graph.security.eventQueries", + "@odata.type": "#microsoft.graph.security.eventQuery", "queryType": "String", "query": "String" } diff --git a/api-reference/beta/resources/security-fileplandescriptor.md b/api-reference/beta/resources/security-fileplandescriptor.md index d6e36dc9327..e226121e01d 100644 --- a/api-reference/beta/resources/security-fileplandescriptor.md +++ b/api-reference/beta/resources/security-fileplandescriptor.md @@ -1,6 +1,6 @@ --- title: "filePlanDescriptor resource type" -description: "Represents a group of columns associated with a particular retention label, to improve the manageability and organization of the content you need to label." +description: "Represents a set of optional descriptors to supplement a retention label and improve the manageability and organization of content in Microsoft 365 for an organization." author: "sseth" ms.localizationpriority: medium ms.subservice: "security" @@ -13,8 +13,13 @@ Namespace: microsoft.graph.security [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents a group of columns to improve the manageability and organization of the content you need to label. +Represents a _set_ of optional file plan descriptors to supplement a [retention label](security-retentionlabel.md) and improve the manageability and organization of Microsoft 365 content. +You can add a descriptor by using the POST operation of the corresponding file plan descriptor _template_, and specifying data for the descriptor. For example, to include a [citation](security-citation.md) descriptor, use the [create citationTemplate](../api/security-labelsroot-post-citations.md) operation. Similarly, you can use the GET or DELETE operations on the template resource for the descriptor. + +To list the descriptors that supplement a retention label, use the [GET](../api/security-retentionlabel-get.md) operation on that [retentionLabel](security-retentionlabel.md) resource and apply `$expand` on the **descriptors** relationship. + +For information on how retention labels and file plan descriptors work in the [Microsoft Purview compliance portal](https://compliance.microsoft.com/), see [Use file plan to create and manage retention labels](/purview/file-plan-manager). Inherits from [microsoft.graph.entity](../resources/entity.md). @@ -42,7 +47,7 @@ None. |filePlanReferenceTemplate|[microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md)|Specifies a unique alpha-numeric identifier for an organization’s retention schedule.| ## JSON representation -The following is a JSON representation of the resource. +Here's a JSON representation of the resource. [!INCLUDE [permissions-table](../includes/permissions/appcatalogs-list-teamsapps-permissions.md)] -> **Note**: -The Directory.Read.All and Directory.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission and avoid using these permissions going forward. +> [!NOTE] +> The Directory.Read.All and Directory.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission and avoid using these permissions going forward. ## HTTP request @@ -41,7 +41,7 @@ GET /appCatalogs/teamsApps This method supports the `$filter`, `$select`, and `$expand` [OData query parameters](/graph/query-parameters) to help customize the response. -Using `$expand=AppDefinitions` will return more information about the state of the app, such as the **publishingState**, which reflects the app submission review status and returns whether an app has been approved, rejected, or remains under review. +Using `$expand=AppDefinitions` returns more information about the state of the app, such as the **publishingState**, which reflects the app submission review status and returns whether an app is approved, rejected, or remains under review. > **Note:** You can filter on any of the fields of the [teamsApp](../resources/teamsapp.md) object to shorten the list of results. You can use any of the following filter operations: Equal, not-equal, and, or, and not. @@ -303,7 +303,7 @@ Content-Type: application/json ### Example 4: List applications with a given ID, and return the submission review state -The following example lists applications with a given ID, and expands **appDefinitions** to return the **publishingState**, which reflects the app's submission review state. `Submitted` means the review is pending, `published` means the app was approved by the admin, and `rejected` means the app was rejected by the admin. +The following example lists applications with a given ID, and expands **appDefinitions** to return the **publishingState**, which reflects the app's submission review state. `Submitted` means the review is pending, `published` means the admin approved the app, and `rejected` means the admin rejected the app. #### Request diff --git a/api-reference/v1.0/api/application-post-calls.md b/api-reference/v1.0/api/application-post-calls.md index 7c771b44a53..edf9ed33036 100644 --- a/api-reference/v1.0/api/application-post-calls.md +++ b/api-reference/v1.0/api/application-post-calls.md @@ -22,11 +22,12 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/application-post-calls-permissions.md)] -> **Notes:** +> [!NOTE] > - For a call with app-hosted media, you need the Calls.AccessMedia.All permission in addition to one of the permissions listed in the previous table. -> - Cloud Video Interop solutions that are [Certified for Microsoft Teams](/MicrosoftTeams/cloud-video-interop) have permission to call this API to join meetings for which they have meeting join links, similar to external users joining through a browser. > - The Calls.JoinGroupCalls.Chat permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +Cloud Video Interop solutions that are [Certified for Microsoft Teams](/MicrosoftTeams/cloud-video-interop) have permission to call this API to join meetings for which they have meeting join links, similar to external users joining through a browser. + ## HTTP request ```http diff --git a/api-reference/v1.0/api/channel-get-filesfolder.md b/api-reference/v1.0/api/channel-get-filesfolder.md index 052f13ae36e..4d4858abb90 100644 --- a/api-reference/v1.0/api/channel-get-filesfolder.md +++ b/api-reference/v1.0/api/channel-get-filesfolder.md @@ -24,7 +24,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/channel-get-filesfolder-permissions.md)] -> **Note**: The Group.Read.All and Group.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> [!NOTE] +> The Group.Read.All and Group.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. ## HTTP request diff --git a/api-reference/v1.0/api/channel-list-messages.md b/api-reference/v1.0/api/channel-list-messages.md index e0a8ab10fd9..ce1d461decf 100644 --- a/api-reference/v1.0/api/channel-list-messages.md +++ b/api-reference/v1.0/api/channel-list-messages.md @@ -28,7 +28,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/channel-list-messages-permissions.md)] -> **Note**: The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request diff --git a/api-reference/v1.0/api/channel-post-messages.md b/api-reference/v1.0/api/channel-post-messages.md index 2b8bde0e031..2a78004fcde 100644 --- a/api-reference/v1.0/api/channel-post-messages.md +++ b/api-reference/v1.0/api/channel-post-messages.md @@ -24,10 +24,9 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/channel-post-messages-permissions.md)] -> **Note**: The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. - -> **Note**: Application permissions are *only* supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). -In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported. +> [!NOTE] +> The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> - Application permissions are only supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported. @@ -51,7 +50,7 @@ POST /teams/{team-id}/channels/{channel-id}/messages ## Request body -In the request body, supply a JSON representation of a [chatMessage](../resources/chatmessage.md) object. Only the body property is mandatory. )ther properties are optional. +In the request body, supply a JSON representation of a [chatMessage](../resources/chatmessage.md) object. Only the body property is mandatory. All other properties are optional. ## Response diff --git a/api-reference/v1.0/api/channel-post.md b/api-reference/v1.0/api/channel-post.md index 813d4b779eb..2bd23359759 100644 --- a/api-reference/v1.0/api/channel-post.md +++ b/api-reference/v1.0/api/channel-post.md @@ -11,7 +11,7 @@ doc_type: apiPageType Namespace: microsoft.graph -Create a new [channel](../resources/channel.md) in a team, as specified in the request body. When you create a channel, the maximum length of the channel's `displayName` is 50 characters. This is the name that appears to the user in Microsoft Teams. +Create a new [channel](../resources/channel.md) in a team, as specified in the request body. When you create a channel, the maximum length of the channel's `displayName` is 50 characters. This is the name that appears to the user in Microsoft Teams. If you're creating a private channel, you can add a maximum of 200 members. @@ -25,19 +25,17 @@ If you're creating a private channel, you can add a maximum of 200 members. One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they are not a member of. + |Permission type | Permissions (from least to most privileged) | |:--------------------|:---------------------------------------------------------| |Delegated (work or school account) | Channel.Create, Group.ReadWrite.All, Directory.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. | -|Application | Channel.Create.Group*, Channel.Create, Teamwork.Migrate.All, Group.ReadWrite.All, Directory.ReadWrite.All | +|Application | Channel.Create.Group, Channel.Create, Teamwork.Migrate.All, Group.ReadWrite.All, Directory.ReadWrite.All | -> **Notes**: -> The Group.ReadWrite.All and Directory.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). -> -> This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they are not a member of. -> -> In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported -using Teamwork.Migrate.All and/or [migration APIs](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). +> [!NOTE] +> - The Group.ReadWrite.All and Directory.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> - The Channel.Create.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported using Teamwork.Migrate.All and/or [migration APIs](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). ## HTTP request @@ -330,7 +328,7 @@ Location: /teams('57fb72d0-d811-46f4-8947-305e6072eaa5')/channels('19:4b6bed8d24 #### Request -The following example shows a request to create a private channel and add a user as an team owner. +The following example shows a request to create a private channel and add a user as a team owner. # [HTTP](#tab/http) diff --git a/api-reference/v1.0/api/chat-get-installedapps.md b/api-reference/v1.0/api/chat-get-installedapps.md index 9d07099d9e9..b935ee04fd0 100644 --- a/api-reference/v1.0/api/chat-get-installedapps.md +++ b/api-reference/v1.0/api/chat-get-installedapps.md @@ -22,8 +22,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chat-get-installedapps-permissions.md)] -> **Note:** -The TeamsAppInstallation.ReadWriteAndConsentSelfForChat and TeamsAppInstallation.ReadWriteAndConsentForChat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The TeamsAppInstallation.ReadWriteAndConsentSelfForChat and TeamsAppInstallation.ReadWriteAndConsentForChat permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request @@ -123,7 +123,7 @@ Content-type: application/json ### Example 2: Get the set of resource-specific permissions consented for the app installed in the specified chat -The following example gets the list of any [resource-specific permissions that were granted to an app](../resources/teamsapppermissionset.md) as part of installation. A `$select` query parameterd is required to show the consented permission set. +The following example gets the list of any [resource-specific permissions that were granted to an app](../resources/teamsapppermissionset.md) as part of installation. A `$select` query parameter is required to show the consented permission set. #### Request diff --git a/api-reference/v1.0/api/chat-list-installedapps.md b/api-reference/v1.0/api/chat-list-installedapps.md index 96d2affa3aa..eb1236430ce 100644 --- a/api-reference/v1.0/api/chat-list-installedapps.md +++ b/api-reference/v1.0/api/chat-list-installedapps.md @@ -28,8 +28,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chat-list-installedapps-permissions.md)] -> **Note:** -The following permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent): +> [!NOTE] +> The following permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent): > - TeamsAppInstallation.ReadWriteAndConsentSelfForChat > - TeamsAppInstallation.ReadWriteAndConsentForChat > - TeamsAppInstallation.ReadWriteAndConsentSelfForChat.All diff --git a/api-reference/v1.0/api/chat-post-installedapps.md b/api-reference/v1.0/api/chat-post-installedapps.md index a6b6f666933..ca1f0a002a2 100644 --- a/api-reference/v1.0/api/chat-post-installedapps.md +++ b/api-reference/v1.0/api/chat-post-installedapps.md @@ -25,7 +25,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chat-post-installedapps-permissions.md)] -> **Note:** These TeamsAppInstallation.ReadWriteSelfForChat, TeamsAppInstallation.ReadWriteForChat, TeamsAppInstallation.ReadWriteSelfForChat.All, and TeamsAppInstallation.ReadWriteForChat.All permissions cannot be used to install apps that require consent to resource-specific permissions. +> [!NOTE] +> These TeamsAppInstallation.ReadWriteSelfForChat, TeamsAppInstallation.ReadWriteForChat, TeamsAppInstallation.ReadWriteSelfForChat.All, and TeamsAppInstallation.ReadWriteForChat.All permissions cannot be used to install apps that require consent to resource-specific permissions. ## HTTP request @@ -47,7 +48,7 @@ POST /chats/{chat-id}/installedApps ## Request body The request body should include the generated app ID of the catalog app. For more information, see [teamsApp properties](../resources/teamsapp.md#properties). -The following table lists additional parameters that can be used with the request body. +The following table lists other parameters that can be used with the request body. |Parameter|Type|Description| |:---|:---|:---| @@ -131,7 +132,7 @@ The following example shows the response. HTTP/1.1 201 Created ``` -### Example 2: Install app in a chat and and consent to the resource-specific permissions required by the app +### Example 2: Install app in a chat and consent to the resource-specific permissions required by the app To get the list of resource-specific permissions required by the app, get the app from **appCatalog**, as shown in [Example 7](../api/appcatalogs-list-teamsapps.md#example-7-list-applications-with-a-given-id-and-return-only-the-resource-specific-permissions-required-by-the-app). diff --git a/api-reference/v1.0/api/chat-teamsappinstallation-upgrade.md b/api-reference/v1.0/api/chat-teamsappinstallation-upgrade.md index e7eaa9d0eda..94462885080 100644 --- a/api-reference/v1.0/api/chat-teamsappinstallation-upgrade.md +++ b/api-reference/v1.0/api/chat-teamsappinstallation-upgrade.md @@ -25,7 +25,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chat-teamsappinstallation-upgrade-permissions.md)] -> **Note:** The TeamsAppInstallation.ReadWriteSelfForChat, TeamsAppInstallation.ReadWriteForChat, TeamsAppInstallation.ReadWriteSelfForChat.All, and TeamsAppInstallation.ReadWriteForChat.All permissions can't be used to install apps that require consent to resource-specific permissions. +> [!NOTE] +> The TeamsAppInstallation.ReadWriteSelfForChat, TeamsAppInstallation.ReadWriteForChat, TeamsAppInstallation.ReadWriteSelfForChat.All, and TeamsAppInstallation.ReadWriteForChat.All permissions can't be used to install apps that require consent to resource-specific permissions. ## HTTP request @@ -45,7 +46,7 @@ POST /chats/{chat-id}/installedApps/{app-installation-id}/upgrade In the request body, supply a JSON representation of the parameters. -The following table lists additional parameters that can be used with the upgrade action. +The following table lists other parameters that can be used with the upgrade action. |Parameter|Type|Description| |:---|:---|:---| diff --git a/api-reference/v1.0/api/chatmessage-delta.md b/api-reference/v1.0/api/chatmessage-delta.md index 93457e270b1..85c57cbdda0 100644 --- a/api-reference/v1.0/api/chatmessage-delta.md +++ b/api-reference/v1.0/api/chatmessage-delta.md @@ -37,7 +37,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chatmessage-delta-permissions.md)] -> **Note**: The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request diff --git a/api-reference/v1.0/api/chatmessage-get.md b/api-reference/v1.0/api/chatmessage-get.md index 4fc4771e1a4..05da0cc1ff3 100644 --- a/api-reference/v1.0/api/chatmessage-get.md +++ b/api-reference/v1.0/api/chatmessage-get.md @@ -37,7 +37,8 @@ One of the following permissions is required to call this API. To learn more, in |Delegated (personal Microsoft account)|Not supported.| |Application| Chat.Read.All, Chat.ReadWrite.All| -> **Note:** The _ChannelMessage.Read.Group_ and _ChatMessage.Read.Chat_ permissions use [resource-specific consent]( https://aka.ms/teams-rsc). +> [!NOTE] +> The ChannelMessage.Read.Group and ChatMessage.Read.Chat permissions use [resource-specific consent]( https://aka.ms/teams-rsc). ## HTTP request @@ -57,7 +58,7 @@ GET /me/chats/{chat-id}/messages/{message-id} ``` ## Optional query parameters -This method does not support the [OData query parameters](/graph/query-parameters) to customize the response. +This method doesn't support the [OData query parameters](/graph/query-parameters) to customize the response. ## Request headers | Header | Value | diff --git a/api-reference/v1.0/api/chatmessage-list-hostedcontents.md b/api-reference/v1.0/api/chatmessage-list-hostedcontents.md index dca2e02d60c..5ae344f1aab 100644 --- a/api-reference/v1.0/api/chatmessage-list-hostedcontents.md +++ b/api-reference/v1.0/api/chatmessage-list-hostedcontents.md @@ -11,7 +11,7 @@ doc_type: "apiPageType" Namespace: microsoft.graph -Retrieve the list of [chatMessageHostedContent](../resources/chatmessagehostedcontent.md) objects from a message. This API only lists the hosted content objects. To get the content bytes, see [get chatmessage hosted content](chatmessagehostedcontent-get.md) +Retrieve the list of [chatMessageHostedContent](../resources/chatmessagehostedcontent.md) objects from a message. This API only lists the hosted content objects. To get the content bytes, see [get chatmessage hosted content](chatmessagehostedcontent-get.md). [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] @@ -33,7 +33,8 @@ Retrieve the list of [chatMessageHostedContent](../resources/chatmessagehostedco |Delegated (personal Microsoft account)|Not supported.| |Application| Chat.Read.All, Chat.ReadWrite.All| -> **Note:** The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request diff --git a/api-reference/v1.0/api/chatmessage-list-replies.md b/api-reference/v1.0/api/chatmessage-list-replies.md index ff9473ee6c1..91544714809 100644 --- a/api-reference/v1.0/api/chatmessage-list-replies.md +++ b/api-reference/v1.0/api/chatmessage-list-replies.md @@ -25,7 +25,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chatmessage-list-replies-permissions.md)] -> **Note:** The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request diff --git a/api-reference/v1.0/api/chatmessage-post-replies.md b/api-reference/v1.0/api/chatmessage-post-replies.md index d10166e5ef3..4960197333c 100644 --- a/api-reference/v1.0/api/chatmessage-post-replies.md +++ b/api-reference/v1.0/api/chatmessage-post-replies.md @@ -27,10 +27,11 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chatmessage-post-replies-permissions.md)] -> **Note**: The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> [!NOTE] +> The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. -> **Note**: Application permissions are *only* supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). -In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported. +> [!NOTE] +> Application permissions are only supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported. ## HTTP request diff --git a/api-reference/v1.0/api/chatmessage-post.md b/api-reference/v1.0/api/chatmessage-post.md index 157068f464d..89e05e2ddc6 100644 --- a/api-reference/v1.0/api/chatmessage-post.md +++ b/api-reference/v1.0/api/chatmessage-post.md @@ -27,9 +27,9 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/chatmessage-post-permissions.md)] -> **Note**: The Group.ReadWrite.All permissino is supported only for backward compatibility. We recommend that you update your solutions to use the alternative permissions listed in the table. - -> **Note**: Application permissions are *only* supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). In the future, Microsoft might require you or your customers to pay additional fees based on the amount of data imported. +> [!NOTE] +> - The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use the alternative permissions listed in the table. +> - Application permissions are only supported for [migration](/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams). In the future, Microsoft might require you or your customers to pay additional fees based on the amount of data imported. ### Permissions for chat diff --git a/api-reference/v1.0/api/chatmessage-update.md b/api-reference/v1.0/api/chatmessage-update.md index a314b0e5f01..2b0d3961e3d 100644 --- a/api-reference/v1.0/api/chatmessage-update.md +++ b/api-reference/v1.0/api/chatmessage-update.md @@ -33,7 +33,8 @@ One of the following permissions is required to call this API. To learn more, in | Delegated (personal Microsoft account) | Not supported. | | Application | ChannelMessage.UpdatePolicyViolation.All, Group.ReadWrite.All** | -> **Note:** The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> [!NOTE] +> The Group.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. ### Permissions for chat diff --git a/api-reference/v1.0/api/chatmessagehostedcontent-get.md b/api-reference/v1.0/api/chatmessagehostedcontent-get.md index ae8da93819c..a4943d9d4e1 100644 --- a/api-reference/v1.0/api/chatmessagehostedcontent-get.md +++ b/api-reference/v1.0/api/chatmessagehostedcontent-get.md @@ -35,7 +35,8 @@ One of the following permissions is required to call this API. To learn more, in |Delegated (personal Microsoft account)|Not supported.| |Application| Chat.Read.All, Chat.ReadWrite.All| -> **Note:** The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request @@ -55,7 +56,7 @@ GET /users/{user-id | user-principal-name}/chats/{chat-id}/messages/{message-id} ## Optional query parameters -This operation does not support the [OData query parameters](/graph/query-parameters) to customize the response. +This operation doesn't support the [OData query parameters](/graph/query-parameters) to customize the response. ## Request headers diff --git a/api-reference/v1.0/api/conversationmember-get.md b/api-reference/v1.0/api/conversationmember-get.md index fd604e2c14d..65ac133ea02 100644 --- a/api-reference/v1.0/api/conversationmember-get.md +++ b/api-reference/v1.0/api/conversationmember-get.md @@ -25,7 +25,8 @@ One of the following permissions is required to call this API. To learn more, in |Delegated (personal Microsoft account)|Not supported.| |Application| For **user** or **chat** resource: Not supported.

For **channel** resource: TeamMember.Read.Group, ChannelMember.Read.All, ChannelMember.ReadWrite.All | -> **Note:** The TeamMember.Read.Group permmission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> [!NOTE] +> The TeamMember.Read.Group permmission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). ## HTTP request diff --git a/api-reference/v1.0/api/crosstenantaccesspolicyconfigurationdefault-get.md b/api-reference/v1.0/api/crosstenantaccesspolicyconfigurationdefault-get.md index ea32667eb1f..7c9db941f90 100644 --- a/api-reference/v1.0/api/crosstenantaccesspolicyconfigurationdefault-get.md +++ b/api-reference/v1.0/api/crosstenantaccesspolicyconfigurationdefault-get.md @@ -215,6 +215,15 @@ Content-Type: application/json } ] } + }, + "invitationRedemptionIdentityProviderConfiguration": + { + "primaryIdentityProviderPrecedenceOrder": [ + "externalFederation", + "azureActiveDirectory", + "socialIdentityProviders" + ], + "fallbackIdentityProvider": "defaultConfiguredIdp" } } ``` diff --git a/api-reference/v1.0/api/crosstenantaccesspolicyconfigurationdefault-update.md b/api-reference/v1.0/api/crosstenantaccesspolicyconfigurationdefault-update.md index eaa8d522a53..82d320ddd4d 100644 --- a/api-reference/v1.0/api/crosstenantaccesspolicyconfigurationdefault-update.md +++ b/api-reference/v1.0/api/crosstenantaccesspolicyconfigurationdefault-update.md @@ -58,16 +58,15 @@ If successful, this method returns a `204 No Content` response code. ## Examples -### Request +### Example 1: Block outbound B2B collaboration for a group of users +#### Request -# [HTTP](#tab/http) - ``` http PATCH https://graph.microsoft.com/v1.0/policies/crossTenantAccessPolicy/default Content-Type: application/json @@ -99,41 +98,81 @@ Content-Type: application/json } ``` -# [C#](#tab/csharp) -[!INCLUDE [sample-code](../includes/snippets/csharp/update-crosstenantaccesspolicyconfigurationdefault-csharp-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +#### Response -# [CLI](#tab/cli) -[!INCLUDE [sample-code](../includes/snippets/cli/update-crosstenantaccesspolicyconfigurationdefault-cli-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + -# [Go](#tab/go) -[!INCLUDE [sample-code](../includes/snippets/go/update-crosstenantaccesspolicyconfigurationdefault-go-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +``` http +HTTP/1.1 204 No Content +``` -# [Java](#tab/java) -[!INCLUDE [sample-code](../includes/snippets/java/update-crosstenantaccesspolicyconfigurationdefault-java-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +### Example 2: Update default invitation redemption configuration -# [JavaScript](#tab/javascript) -[!INCLUDE [sample-code](../includes/snippets/javascript/update-crosstenantaccesspolicyconfigurationdefault-javascript-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +#### Request -# [PHP](#tab/php) -[!INCLUDE [sample-code](../includes/snippets/php/update-crosstenantaccesspolicyconfigurationdefault-php-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +``` http +PATCH https://graph.microsoft.com/v1.0/policies/crossTenantAccessPolicy/default +Content-Type: application/json -# [PowerShell](#tab/powershell) -[!INCLUDE [sample-code](../includes/snippets/powershell/update-crosstenantaccesspolicyconfigurationdefault-powershell-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +{ + "invitationRedemptionIdentityProviderConfiguration": { + "primaryIdentityProviderPrecedenceOrder": [ + "externalFederation", + "azureActiveDirectory", + "socialIdentityProviders" + ], + "fallbackIdentityProvider": "defaultConfiguredIdp" + } +} +``` -# [Python](#tab/python) -[!INCLUDE [sample-code](../includes/snippets/python/update-crosstenantaccesspolicyconfigurationdefault-python-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +#### Response ---- + + +``` http +HTTP/1.1 204 No Content +``` + +### Example 3: Disallow Microsoft accounts as an option for redeeming B2B invitations + +#### Request + + +``` http +PATCH https://graph.microsoft.com/v1.0/policies/crossTenantAccessPolicy/default +Content-Type: application/json + +{ + "invitationRedemptionIdentityProviderConfiguration": { + "primaryIdentityProviderPrecedenceOrder": [ + "externalFederation", + "azureActiveDirectory", + "socialIdentityProviders" + ], + "fallbackIdentityProvider": "emailOneTimePasscode" + } +} +``` -### Response +#### Response ```msgraph-interactive GET https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE/lists/22e03ef3-6ef4-424d-a1d3-92a337807c30/items/delta ``` +# [C#](#tab/csharp) +[!INCLUDE [sample-code](../includes/snippets/csharp/get-listitem-delta-first-csharp-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [CLI](#tab/cli) +[!INCLUDE [sample-code](../includes/snippets/cli/get-listitem-delta-first-cli-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Go](#tab/go) +[!INCLUDE [sample-code](../includes/snippets/go/get-listitem-delta-first-go-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Java](#tab/java) +[!INCLUDE [sample-code](../includes/snippets/java/get-listitem-delta-first-java-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [JavaScript](#tab/javascript) +[!INCLUDE [sample-code](../includes/snippets/javascript/get-listitem-delta-first-javascript-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [PHP](#tab/php) +[!INCLUDE [sample-code](../includes/snippets/php/get-listitem-delta-first-php-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [PowerShell](#tab/powershell) +[!INCLUDE [sample-code](../includes/snippets/powershell/get-listitem-delta-first-powershell-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Python](#tab/python) +[!INCLUDE [sample-code](../includes/snippets/python/get-listitem-delta-first-python-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +--- + #### Response The following example shows the response that includes the first page of changes and the **@odata.nextLink** property that indicates that no more items are available in the current set of items. Your app should continue to request the URL value of **@odata.nextLink** until all pages of items have been retrieved. @@ -188,12 +223,47 @@ The following example shows a request that gets the last page in a set and how t The following example shows a request after the initial request. +# [HTTP](#tab/http) ```msgraph-interactive GET https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE/lists/22e03ef3-6ef4-424d-a1d3-92a337807c30/items/delta?token=1230919asd190410jlka ``` +# [C#](#tab/csharp) +[!INCLUDE [sample-code](../includes/snippets/csharp/get-listitem-delta-last-csharp-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [CLI](#tab/cli) +[!INCLUDE [sample-code](../includes/snippets/cli/get-listitem-delta-last-cli-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Go](#tab/go) +[!INCLUDE [sample-code](../includes/snippets/go/get-listitem-delta-last-go-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Java](#tab/java) +[!INCLUDE [sample-code](../includes/snippets/java/get-listitem-delta-last-java-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [JavaScript](#tab/javascript) +[!INCLUDE [sample-code](../includes/snippets/javascript/get-listitem-delta-last-javascript-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [PHP](#tab/php) +[!INCLUDE [sample-code](../includes/snippets/php/get-listitem-delta-last-php-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [PowerShell](#tab/powershell) +[!INCLUDE [sample-code](../includes/snippets/powershell/get-listitem-delta-last-powershell-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Python](#tab/python) +[!INCLUDE [sample-code](../includes/snippets/python/get-listitem-delta-last-python-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +--- + #### Response The following example shows the response that indicates that the item named `TestItemB.txt` was deleted and the item `TestFolder` was either added or modified between the initial request and this request to update the local state. @@ -259,12 +329,47 @@ To retrieve the latest `deltaLink`, call `delta` with the query string parameter The following example shows a request. +# [HTTP](#tab/http) ```msgraph-interactive GET https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE/lists/22e03ef3-6ef4-424d-a1d3-92a337807c30/items/delta?token=latest ``` +# [C#](#tab/csharp) +[!INCLUDE [sample-code](../includes/snippets/csharp/get-delta-latest-datalink-tokenislatest-csharp-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [CLI](#tab/cli) +[!INCLUDE [sample-code](../includes/snippets/cli/get-delta-latest-datalink-tokenislatest-cli-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Go](#tab/go) +[!INCLUDE [sample-code](../includes/snippets/go/get-delta-latest-datalink-tokenislatest-go-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Java](#tab/java) +[!INCLUDE [sample-code](../includes/snippets/java/get-delta-latest-datalink-tokenislatest-java-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [JavaScript](#tab/javascript) +[!INCLUDE [sample-code](../includes/snippets/javascript/get-delta-latest-datalink-tokenislatest-javascript-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [PHP](#tab/php) +[!INCLUDE [sample-code](../includes/snippets/php/get-delta-latest-datalink-tokenislatest-php-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [PowerShell](#tab/powershell) +[!INCLUDE [sample-code](../includes/snippets/powershell/get-delta-latest-datalink-tokenislatest-powershell-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Python](#tab/python) +[!INCLUDE [sample-code](../includes/snippets/python/get-delta-latest-datalink-tokenislatest-python-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +--- + #### Response The following example shows the response. diff --git a/api-reference/v1.0/api/reportroot-getrelyingpartydetailedsummary.md b/api-reference/v1.0/api/reportroot-getrelyingpartydetailedsummary.md index b705b4414de..418e318d30c 100644 --- a/api-reference/v1.0/api/reportroot-getrelyingpartydetailedsummary.md +++ b/api-reference/v1.0/api/reportroot-getrelyingpartydetailedsummary.md @@ -67,6 +67,7 @@ If successful, this function returns a `200 OK` response code and a [relyingPart ### Request The following example shows a request. +# [HTTP](#tab/http) +``` http +GET /security/labels/authorities/{authorityTemplateId} +GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/authorityTemplate +``` + +## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| + +## Request body +Don't supply a request body for this method. + +## Response + +If successful, this method returns a `200 OK` response code and a [microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md) object in the response body. + +## Examples + +### Request +Here's an example of a request. + + +``` http +GET https://graph.microsoft.com/v1.0/security/labels/authorities/a94af2e3-853b-6fcc-c898-d61d3a6d9efc +``` + + + +### Response +Here's an example of 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.type": "#microsoft.graph.security.authorityTemplate", + "id": "a94af2e3-853b-6fcc-c898-d61d3a6d9efc", + "displayName": "String", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z" +} +} +``` + diff --git a/api-reference/v1.0/api/security-categorytemplate-delete-subcategories.md b/api-reference/v1.0/api/security-categorytemplate-delete-subcategories.md new file mode 100644 index 00000000000..8b8619f2fea --- /dev/null +++ b/api-reference/v1.0/api/security-categorytemplate-delete-subcategories.md @@ -0,0 +1,71 @@ +--- +title: "Delete subCategoryTemplate" +description: "Delete a subCategoryTemplate object." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# Delete subCategoryTemplate +Namespace: microsoft.graph.security + +Delete a [subCategoryTemplate](../resources/security-subcategorytemplate.md) object. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|RecordsManagement.ReadWrite.All| + +## HTTP request + + +``` http +DELETE /security/labels/categories/{categoryTemplateId}/subCategories/{subCategoryTemplateId}/$ref +``` + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| + +## Request body +Don't supply a request body for this method. + +## Response + +If successful, this method returns a `204 No Content` response code. + +## Examples + +### Request +Here's an example of a request. + + +``` http +DELETE https://graph.microsoft.com/v1.0/security/labels/categories/f44dkle55-6baf-44ff-5dcc-08d8de97b1d5/subCategories/6cf65e55-6baf-44ff-5dcc-08d8de97b1d5 +``` + +### Response +Here's an example of the response. +> + +``` http +HTTP/1.1 204 No Content +``` + diff --git a/api-reference/v1.0/api/security-categorytemplate-get.md b/api-reference/v1.0/api/security-categorytemplate-get.md new file mode 100644 index 00000000000..e4e01a30a6a --- /dev/null +++ b/api-reference/v1.0/api/security-categorytemplate-get.md @@ -0,0 +1,92 @@ +--- +title: "Get categoryTemplate" +description: "Read the properties and relationships of a categoryTemplate object." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# Get categoryTemplate +Namespace: microsoft.graph.security + +Read the properties and relationships of a [categoryTemplate](../resources/security-categorytemplate.md) object. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| + +## HTTP request + + +``` http +GET /security/labels/categories/{categoryTemplateId} +GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate +``` + +## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For example, to retrieve the **subategories** property associated with this particular category, you can use the `expand` parameter:`$expand=subcategories`. For general information, see [OData query parameters](/graph/query-parameters). + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| + +## Request body +Don't supply a request body for this method. + +## Response + +If successful, this method returns a `200 OK` response code and a [microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) object in the response body. + +## Examples + +### Request +Here's an example of a request. + + +``` http +GET https://graph.microsoft.com/v1.0/security/labels/categories/e2c79762-34a9-75ba-b6f0-a7c9a57978ef +``` + +### Response +Here's an example of 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.type": "#microsoft.graph.security.categoryTemplate", + "id": "e2c79762-34a9-75ba-b6f0-a7c9a57978ef", + "displayName": "Accounts payable", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z" +} +} +``` + diff --git a/api-reference/v1.0/api/security-categorytemplate-list-subcategories.md b/api-reference/v1.0/api/security-categorytemplate-list-subcategories.md new file mode 100644 index 00000000000..005dd32fde1 --- /dev/null +++ b/api-reference/v1.0/api/security-categorytemplate-list-subcategories.md @@ -0,0 +1,95 @@ +--- +title: "List subCategories" +description: "Get the subCategoryTemplate resources from the subCategories navigation property." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# List subCategories +Namespace: microsoft.graph.security + +Get a list of subcategories [subCategoryTemplate](../resources/security-subcategorytemplate.md) associated with a category template. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| + +## HTTP request + + +``` http +GET /security/labels/categories/{categoryTemplateId}/subCategories +``` + +## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| + +## 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 [microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md) objects in the response body. + +## Examples + +### Request +Here's an example of a request. + + +``` http +GET https://graph.microsoft.com/v1.0/security/labels/categories/{categoryTemplateId}/subCategories +``` + + +### Response +Here's an example of 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.type": "#microsoft.graph.security.subCategoryTemplate", + "id": "2ac39915-dbeb-e933-82e2-92b981835fa0", + "displayName": "Vendor Invoice", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime": "2021-03-24T02:09:08Z" + } + ] +} +``` + diff --git a/api-reference/v1.0/api/security-categorytemplate-post-subcategories.md b/api-reference/v1.0/api/security-categorytemplate-post-subcategories.md new file mode 100644 index 00000000000..c6182f5782b --- /dev/null +++ b/api-reference/v1.0/api/security-categorytemplate-post-subcategories.md @@ -0,0 +1,104 @@ +--- +title: "Create subCategoryTemplate" +description: "Create a new subCategoryTemplate object." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# Create subCategoryTemplate +Namespace: microsoft.graph.security + +Create a new [subCategoryTemplate](../resources/security-subcategorytemplate.md) object. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|RecordsManagement.ReadWrite.All| + +## HTTP request + + +``` http +POST /security/labels/categories/{categoryTemplateId}/subCategories +``` + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| + +## Request body +In the request body, supply a JSON representation of the [microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md) object. + +You can specify the following properties when creating a **subCategoryTemplate**. + +|Property|Type|Description| +|:---|:---|:---| +|displayName|String| Unique string that defines a sub-category name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptor.md). Optional.| + + + + +## Response + +If successful, this method returns a `201 Created` response code and a [microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md) object in the response body. + +## Examples + +### Request +Here's an example of a request. + + +``` http +POST https://graph.microsoft.com/v1.0/security/labels/categories/{categoryTemplateId}/subCategories +Content-Type: application/json + +{ + "@odata.type": "#microsoft.graph.security.subCategoryTemplate", + "displayName": "Vendor Invoice", +} +``` + + + +### Response +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 201 Created +Content-Type: application/json + +{ + "@odata.type": "#microsoft.graph.security.subCategoryTemplate", + "id": "2ac39915-dbeb-e933-82e2-92b981835fa0", + "displayName": "Vendor Invoice", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime": "2021-03-24T02:09:08Z" + } +``` + diff --git a/api-reference/v1.0/api/security-citationtemplate-get.md b/api-reference/v1.0/api/security-citationtemplate-get.md new file mode 100644 index 00000000000..cb35b1df467 --- /dev/null +++ b/api-reference/v1.0/api/security-citationtemplate-get.md @@ -0,0 +1,95 @@ +--- +title: "Get citationTemplate" +description: "Read the properties and relationships of a citationTemplate object." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# Get citationTemplate +Namespace: microsoft.graph.security + +Read the properties and relationships of a [citationTemplate](../resources/security-citationtemplate.md) object. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| + +## HTTP request + + +``` http +GET /security/labels/citations/{citationTemplateId} +GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/citationTemplate +``` + +## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| + +## Request body +Don't supply a request body for this method. + +## Response + +If successful, this method returns a `200 OK` response code and a [microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md) object in the response body. + +## Examples + +### Request +Here's an example of a request. + + +``` http +GET https://graph.microsoft.com/v1.0/security/labels/citations/c0475d01-d532-8a53-6e26-14ea58c640bf +``` + + +### Response +Here's an example of 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.type": "#microsoft.graph.security.citationTemplate", + "id": "c0475d01-d532-8a53-6e26-14ea58c640bf", + "displayName": "Contoso Company Policy", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z", + "citationUrl": "www.citationUrl.com", + "citationJurisdiction": "Contoso" + } +} +``` + diff --git a/api-reference/v1.0/api/security-departmenttemplate-get.md b/api-reference/v1.0/api/security-departmenttemplate-get.md new file mode 100644 index 00000000000..49b440baa82 --- /dev/null +++ b/api-reference/v1.0/api/security-departmenttemplate-get.md @@ -0,0 +1,93 @@ +--- +title: "Get departmentTemplate" +description: "Read the properties and relationships of a departmentTemplate object." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# Get departmentTemplate +Namespace: microsoft.graph.security + +Read the properties and relationships of a [departmentTemplate](../resources/security-departmenttemplate.md) object. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| + +## HTTP request + + +``` http +GET /security/labels/departments/{departmentTemplateId} +GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/departmentTemplate +``` + +## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| + +## Request body +Don't supply a request body for this method. + +## Response + +If successful, this method returns a `200 OK` response code and a [microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md) object in the response body. + +## Examples + +### Request +Here's an example of a request. + + +``` http +GET https://graph.microsoft.com/v1.0/security/labels/departments/11b44677-9f06-c85a-4a0b-766b66904bf8 +``` + + +### Response +Here's an example of 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.type": "#microsoft.graph.security.departmentTemplate", + "id": "11b44677-9f06-c85a-4a0b-766b66904bf8", + "displayName": "Finance", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z" +} +} +``` + diff --git a/api-reference/v1.0/api/security-fileplanreferencetemplate-get.md b/api-reference/v1.0/api/security-fileplanreferencetemplate-get.md new file mode 100644 index 00000000000..df320be119d --- /dev/null +++ b/api-reference/v1.0/api/security-fileplanreferencetemplate-get.md @@ -0,0 +1,93 @@ +--- +title: "Get filePlanReferenceTemplate" +description: "Read the properties and relationships of a filePlanReferenceTemplate object." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# Get filePlanReferenceTemplate +Namespace: microsoft.graph.security + +Read the properties and relationships of a [filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) object. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| + +## HTTP request + + +``` http +GET /security/labels/filePlanReferences/{filePlanReferenceTemplateId} +GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/filePlanReferenceTemplate +``` + +## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| + +## Request body +Don't supply a request body for this method. + +## Response + +If successful, this method returns a `200 OK` response code and a [microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) object in the response body. + +## Examples + +### Request +Here's an example of a request. + + +``` http +GET https://graph.microsoft.com/v1.0/security/labels/filePlanReferences/b1f7b518-a44f-1d4b-c6f1-ab8771d3907c +``` + + +### Response +Here's an example of 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.type": "#microsoft.graph.security.filePlanReferenceTemplate", + "id": "b1f7b518-a44f-1d4b-c6f1-ab8771d3907c", + "displayName": "String", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z" +} +} +``` + diff --git a/api-reference/v1.0/api/security-labelsroot-delete-authorities.md b/api-reference/v1.0/api/security-labelsroot-delete-authorities.md new file mode 100644 index 00000000000..44d5ac1ad05 --- /dev/null +++ b/api-reference/v1.0/api/security-labelsroot-delete-authorities.md @@ -0,0 +1,73 @@ +--- +title: "Delete authorityTemplate" +description: "Delete an authorityTemplate object." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# Delete authorityTemplate +Namespace: microsoft.graph.security + +Delete a [authorityTemplate](../resources/security-authoritytemplate.md) object. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application| RecordsManagement.ReadWrite.All| + +## HTTP request + + +``` http +DELETE /security/labels/authorities/{authorityTemplateId}/$ref +DELETE /security/labels/retentionLabels/{retentionLabelId}/descriptors/authorityTemplate/$ref +``` + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| + +## Request body +Don't supply a request body for this method. + +## Response + +If successful, this method returns a `204 No Content` response code. + +## Examples + +### Request +Here's an example of a request. + + +``` http +DELETE https://graph.microsoft.com/v1.0/security/labels/authorities/6cf65e55-6baf-44ff-5dcc-08d8de97b1d5 +``` + + +### Response +Here's an example of the response. +> + +``` http +HTTP/1.1 204 No Content +``` + diff --git a/api-reference/v1.0/api/security-labelsroot-delete-categories.md b/api-reference/v1.0/api/security-labelsroot-delete-categories.md new file mode 100644 index 00000000000..dce766265d3 --- /dev/null +++ b/api-reference/v1.0/api/security-labelsroot-delete-categories.md @@ -0,0 +1,73 @@ +--- +title: "Delete categoryTemplate" +description: "Delete a categoryTemplate object." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# Delete categoryTemplate +Namespace: microsoft.graph.security + +Delete a [categoryTemplate](../resources/security-categorytemplate.md) object. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|RecordsManagement.ReadWrite.All| + +## HTTP request + + +``` http +DELETE /security/labels/categories/{categoryTemplateId}/$ref +DELETE /security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate/$ref +``` + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| + +## Request body +Don't supply a request body for this method. + +## Response + +If successful, this method returns a `204 No Content` response code. + +## Examples + +### Request +Here's an example of a request. + + +``` http +DELETE https://graph.microsoft.com/v1.0/security/labels/categories/6cf65e55-6baf-44ff-5dcc-08d8de97b1d5 +``` + + +### Response +Here's an example of the response. +> + +``` http +HTTP/1.1 204 No Content +``` + diff --git a/api-reference/v1.0/api/security-labelsroot-delete-citations.md b/api-reference/v1.0/api/security-labelsroot-delete-citations.md new file mode 100644 index 00000000000..414e02c1367 --- /dev/null +++ b/api-reference/v1.0/api/security-labelsroot-delete-citations.md @@ -0,0 +1,72 @@ +--- +title: "Delete citationTemplate" +description: "Delete a citationTemplate object." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# Delete citationTemplate +Namespace: microsoft.graph.security + +Delete a [citationTemplate](../resources/security-citationtemplate.md) object. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|RecordsManagement.ReadWrite.All| + +## HTTP request + + +``` http +DELETE /security/labels/citations/{citationTemplateId}/$ref +DELETE /security/labels/retentionLabels/{retentionLabelId}/descriptors/citationTemplate/$ref +``` + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| + +## Request body +Don't supply a request body for this method. + +## Response + +If successful, this method returns a `204 No Content` response code. + +## Examples + +### Request +Here's an example of a request. + + +``` http +DELETE https://graph.microsoft.com/v1.0/security/labels/citations/6cf65e55-6baf-44ff-5dcc-08d8de97b1d5 +``` + +### Response +Here's an example of the response. +> + +``` http +HTTP/1.1 204 No Content +``` + diff --git a/api-reference/v1.0/api/security-labelsroot-delete-departments.md b/api-reference/v1.0/api/security-labelsroot-delete-departments.md new file mode 100644 index 00000000000..f0e2b983f5d --- /dev/null +++ b/api-reference/v1.0/api/security-labelsroot-delete-departments.md @@ -0,0 +1,73 @@ +--- +title: "Delete departmentTemplate" +description: "Delete a departmentTemplate object." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# Delete departmentTemplate +Namespace: microsoft.graph.security + +Delete a [departmentTemplate](../resources/security-departmenttemplate.md) object. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|RecordsManagement.ReadWrite.All| + +## HTTP request + + +``` http +DELETE /security/labels/departments/{departmentTemplateId}/$ref +DELETE /security/labels/retentionLabels/{retentionLabelId}/descriptors/departmentTemplate/$ref +``` + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| + +## Request body +Don't supply a request body for this method. + +## Response + +If successful, this method returns a `204 No Content` response code. + +## Examples + +### Request +Here's an example of a request. + + +``` http +DELETE https://graph.microsoft.com/v1.0/security/labels/departments/6cf65e55-6baf-44ff-5dcc-08d8de97b1d5 +``` + + +### Response +Here's an example of the response. +> + +``` http +HTTP/1.1 204 No Content +``` + diff --git a/api-reference/v1.0/api/security-labelsroot-delete-fileplanreferences.md b/api-reference/v1.0/api/security-labelsroot-delete-fileplanreferences.md new file mode 100644 index 00000000000..8f5aea9f7c0 --- /dev/null +++ b/api-reference/v1.0/api/security-labelsroot-delete-fileplanreferences.md @@ -0,0 +1,73 @@ +--- +title: "Delete filePlanReferenceTemplate" +description: "Delete a filePlanReferenceTemplate object." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# Delete filePlanReferenceTemplate +Namespace: microsoft.graph.security + +Delete a [filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) object. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|RecordsManagement.ReadWrite.All| + +## HTTP request + + +``` http +DELETE /security/labels/filePlanReferences/{filePlanReferenceTemplateId}/$ref +DELETE /security/labels/retentionLabels/{retentionLabelId}/descriptors/filePlanReferenceTemplate/$ref +``` + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| + +## Request body +Don't supply a request body for this method. + +## Response + +If successful, this method returns a `204 No Content` response code. + +## Examples + +### Request +Here's an example of a request. + + +``` http +DELETE https://graph.microsoft.com/v1.0/security/labels/filePlanReferences/6cf65e55-6baf-44ff-5dcc-08d8de97b1d5 +``` + + +### Response +Here's an example of the response. +> + +``` http +HTTP/1.1 204 No Content +``` + diff --git a/api-reference/v1.0/api/security-labelsroot-list-authorities.md b/api-reference/v1.0/api/security-labelsroot-list-authorities.md new file mode 100644 index 00000000000..d95da52195b --- /dev/null +++ b/api-reference/v1.0/api/security-labelsroot-list-authorities.md @@ -0,0 +1,106 @@ +--- +title: "List authorityTemplates" +description: "Get a list of the authorityTemplate objects and their properties." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# List authorityTemplates +Namespace: microsoft.graph.security + + +Get a list of the [authorityTemplate](../resources/security-authoritytemplate.md) objects and their properties. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| + +## HTTP request + + +``` http +GET /security/labels/authorities +``` + +## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| + +## 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 [microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md) objects in the response body. + +## Examples + +### Request +Here's an example of a request. + + +``` http +GET https://graph.microsoft.com/v1.0/security/labels/authorities +``` + + +### Response +Here's an example of 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.type": "#microsoft.graph.security.authorityTemplate", + "id": "a94af2e3-853b-6fcc-c898-d61d3a6d9efc", + "displayName": "Business", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime": "2021-03-24T02:09:08Z" + }, + { + "@odata.type": "#microsoft.graph.security.authorityTemplate", + "id": "6cf65e55-6baf-44ff-5dcc-08d8de97b1d5", + "displayName": "Legal", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime": "2021-03-24T02:09:08Z" + } + ] +} +``` diff --git a/api-reference/v1.0/api/security-labelsroot-list-categories.md b/api-reference/v1.0/api/security-labelsroot-list-categories.md new file mode 100644 index 00000000000..577b1e01339 --- /dev/null +++ b/api-reference/v1.0/api/security-labelsroot-list-categories.md @@ -0,0 +1,105 @@ +--- +title: "List categoryTemplates" +description: "Get a list of the categoryTemplate objects and their properties." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# List categoryTemplates +Namespace: microsoft.graph.security + +Get a list of the [categoryTemplate](../resources/security-categorytemplate.md) objects and their properties. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| + +## HTTP request + + +``` http +GET /security/labels/categories +``` + +## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| + +## 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 [microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) objects in the response body. + +## Examples + +### Request +Here's an example of a request. + + +``` http +GET https://graph.microsoft.com/v1.0/security/labels/categories +``` + + +### Response +Here's an example of 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.type": "#microsoft.graph.security.categoryTemplate", + "id": "e2c79762-34a9-75ba-b6f0-a7c9a57978ef", + "displayName": "Accounts Payable", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime": "2021-03-24T02:09:08Z" + }, + { + "@odata.type": "#microsoft.graph.security.categoryTemplate", + "id": "6cf65e55-6baf-44ff-5dcc-08d8de97b1d5", + "displayName": "Accounts", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime": "2021-03-24T02:09:08Z" + } + ] +} +``` diff --git a/api-reference/v1.0/api/security-labelsroot-list-citations.md b/api-reference/v1.0/api/security-labelsroot-list-citations.md new file mode 100644 index 00000000000..a3855bb9d90 --- /dev/null +++ b/api-reference/v1.0/api/security-labelsroot-list-citations.md @@ -0,0 +1,96 @@ +--- +title: "List citationTemplates" +description: "Get a list of the citationTemplate objects and their properties." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# List citationTemplates +Namespace: microsoft.graph.security + +Get a list of the [citationTemplate](../resources/security-citationtemplate.md) objects and their properties. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| + +## HTTP request + + +``` http +GET /security/labels/citations +``` + +## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| + +## 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 [microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md) objects in the response body. + +## Examples + +### Request +Here's an example of a request. + + +``` http +GET https://graph.microsoft.com/v1.0/security/labels/citations +``` + + +### Response +Here's an example of 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.type": "#microsoft.graph.security.citationTemplate", + "id": "c0475d01-d532-8a53-6e26-14ea58c640bf", + "displayName": "Contoso Company Policy", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime": "2021-03-24T02:09:08Z", + "citationUrl": "www.citationUrl.com", + "citationJurisdiction": "Contoso" + } + ] +} +``` + diff --git a/api-reference/v1.0/api/security-labelsroot-list-departments.md b/api-reference/v1.0/api/security-labelsroot-list-departments.md new file mode 100644 index 00000000000..d9c04946d4c --- /dev/null +++ b/api-reference/v1.0/api/security-labelsroot-list-departments.md @@ -0,0 +1,93 @@ +--- +title: "List departmentTemplates" +description: "Get a list of the departmentTemplate objects and their properties." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# List departmentTemplates +Namespace: microsoft.graph.security + +Get a list of the [departmentTemplate](../resources/security-departmenttemplate.md) objects and their properties. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| + +## HTTP request + + +``` http +GET /security/labels/departments +``` + +## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| + +## 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 [microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md) objects in the response body. + +## Examples + +### Request +Here's an example of a request. + + +``` http +GET https://graph.microsoft.com/v1.0/security/labels/departments +``` + +### Response +Here's an example of 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.type": "#microsoft.graph.security.departmentTemplate", + "id": "11b44677-9f06-c85a-4a0b-766b66904bf8", + "displayName": "Finance", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime": "2021-03-24T02:09:08Z" + } + ] +} +``` + diff --git a/api-reference/v1.0/api/security-labelsroot-list-fileplanreferences.md b/api-reference/v1.0/api/security-labelsroot-list-fileplanreferences.md new file mode 100644 index 00000000000..ebdb7292f86 --- /dev/null +++ b/api-reference/v1.0/api/security-labelsroot-list-fileplanreferences.md @@ -0,0 +1,94 @@ +--- +title: "List filePlanReferenceTemplates" +description: "Get a list of the filePlanReferenceTemplate objects and their properties." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# List filePlanReferenceTemplates +Namespace: microsoft.graph.security + +Get a list of the [filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) objects and their properties. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| + +## HTTP request + + +``` http +GET /security/labels/filePlanReferences +``` + +## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| + +## 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 [microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) objects in the response body. + +## Examples + +### Request +Here's an example of a request. + + +``` http +GET https://graph.microsoft.com/v1.0/security/labels/filePlanReferences +``` + + +### Response +Here's an example of 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.type": "#microsoft.graph.security.filePlanReferenceTemplate", + "id": "b1f7b518-a44f-1d4b-c6f1-ab8771d3907c", + "displayName": "FIN 01-02-001", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime": "2021-03-24T02:09:08Z" + } + ] +} +``` + diff --git a/api-reference/v1.0/api/security-labelsroot-list-retentionlabel.md b/api-reference/v1.0/api/security-labelsroot-list-retentionlabel.md new file mode 100644 index 00000000000..5ecf9093851 --- /dev/null +++ b/api-reference/v1.0/api/security-labelsroot-list-retentionlabel.md @@ -0,0 +1,119 @@ +--- +title: "List retentionLabels" +description: "Get a list of the retentionLabel objects and their properties." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# List retentionLabels +Namespace: microsoft.graph.security + +Get a list of the [retentionLabel](../resources/security-retentionlabel.md) objects and their properties. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not Supported.| +|Application|Not supported.| + +## HTTP request + + +``` http +GET /security/labels/retentionLabels +``` + +## Optional query parameters +This method supports the `expand` OData query parameter to help customize the response. + +For example: +- To retrieve the **retentionEventType** property, use `$expand=retentionEventType`. +- To retrieve the **descriptors** property, use `$expand=descriptors`. + +For general information, see [OData query parameters](/graph/query-parameters). + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| + +## 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 [microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md) objects in the response body. + +## Examples + +### Request +Here's an example of a request. + +``` http +GET https://graph.microsoft.com/v1.0/security/labels/retentionLabels +``` + + +### Response +Here's an example of 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.type": "#microsoft.graph.security.retentionLabel", + "id": "64a99fb4-07be-0481-8746-44c15c0eef1f", + "displayName": "Retention Schedule 10004", + "behaviorDuringRetentionPeriod": "retain", + "actionAfterRetentionPeriod": "relabel", + "retentionTrigger": "dateCreated", + "retentionDuration": { + "@odata.type": "microsoft.graph.security.retentionDurationInDays", + "days": "730" + }, + "isInUse": true, + "descriptionForAdmins": "creation based retention label for schedule 10004", + "descriptionForUsers": "retains for 2 years then relabeled", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime": "2017-11-27T02:10:12Z", + "lastModifiedBy": { + "user": { + "id": "9563a605-e827-4324-a5a9-09efddff1e90", + "displayName": "Records Manager" + } + }, + "lastModifiedDateTime": "2020-08-28T22:13:09Z", + "labelToBeApplied": "Retention schedule 10005", + "defaultRecordBehavior": "startLocked" + } + ] +} +``` + + diff --git a/api-reference/v1.0/api/security-labelsroot-post-authorities.md b/api-reference/v1.0/api/security-labelsroot-post-authorities.md new file mode 100644 index 00000000000..93bba12ef73 --- /dev/null +++ b/api-reference/v1.0/api/security-labelsroot-post-authorities.md @@ -0,0 +1,103 @@ +--- +title: "Create authorityTemplate" +description: "Create a new authorityTemplate object." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# Create authorityTemplate +Namespace: microsoft.graph.security + +Create a new [authorityTemplate](../resources/security-authoritytemplate.md) object. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|RecordsManagement.ReadWrite.All| + +## HTTP request + + +``` http +POST /security/labels/authorities +``` + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| + +## Request body +In the request body, supply a JSON representation of the [microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md) object. + +You can specify the following properties when creating a **authorityTemplate**. + +|Property|Type|Description| +|:---|:---|:---| +|displayName|String|Unique string that defines an authority name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptor.md).| + + + + +## Response + +If successful, this method returns a `201 Created` response code and a [microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md) object in the response body. + +## Examples + +### Request +Here's an example of a request. + + +``` http +POST https://graph.microsoft.com/v1.0/security/labels/authorities +Content-Type: application/json + +{ + "@odata.type": "#microsoft.graph.security.authorityTemplate", + "displayName": "Business", +} +``` + + +### Response +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 201 Created +Content-Type: application/json + +{ + "@odata.type": "#microsoft.graph.security.authorityTemplate", + "id": "a94af2e3-853b-6fcc-c898-d61d3a6d9efc", + "displayName": "Business", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z" +} +``` + diff --git a/api-reference/v1.0/api/security-labelsroot-post-categories.md b/api-reference/v1.0/api/security-labelsroot-post-categories.md new file mode 100644 index 00000000000..b1fbd937e3b --- /dev/null +++ b/api-reference/v1.0/api/security-labelsroot-post-categories.md @@ -0,0 +1,102 @@ +--- +title: "Create categoryTemplate" +description: "Create a new categoryTemplate object." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# Create categoryTemplate +Namespace: microsoft.graph.security + +Create a new [categoryTemplate](../resources/security-categorytemplate.md) object. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|RecordsManagement.ReadWrite.All| + +## HTTP request + + +``` http +POST /security/labels/categories +``` + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| + +## Request body +In the request body, supply a JSON representation of the [microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) object. + +You can specify the following properties when creating a **categoryTemplate**. + +|Property|Type|Description| +|:---|:---|:---| +|displayName|String|Unique string that defines a category name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptor.md).| + + + + +## Response + +If successful, this method returns a `201 Created` response code and a [microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) object in the response body. + +## Examples + +### Request +Here's an example of a request. + + +``` http +POST https://graph.microsoft.com/v1.0/security/labels/categories +Content-Type: application/json + +{ + "@odata.type": "#microsoft.graph.security.categoryTemplate", + "displayName": "Accounts Payable", +} +``` + + +### Response +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 201 Created +Content-Type: application/json + +{ + "@odata.type": "#microsoft.graph.security.categoryTemplate", + "id": "e2c79762-34a9-75ba-b6f0-a7c9a57978ef", + "displayName": "Accounts Payable", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z" +} +``` diff --git a/api-reference/v1.0/api/security-labelsroot-post-citations.md b/api-reference/v1.0/api/security-labelsroot-post-citations.md new file mode 100644 index 00000000000..3028d018b3f --- /dev/null +++ b/api-reference/v1.0/api/security-labelsroot-post-citations.md @@ -0,0 +1,108 @@ +--- +title: "Create citationTemplate" +description: "Create a new citationTemplate object." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# Create citationTemplate +Namespace: microsoft.graph.security + +Create a new [citationTemplate](../resources/security-citationtemplate.md) object. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|RecordsManagement.ReadWrite.All| + +## HTTP request + + +``` http +POST /security/labels/citations +``` + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| + +## Request body +In the request body, supply a JSON representation of the [microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md) object. + +You can specify the following properties when creating a **citationTemplate**. + +|Property|Type|Description| +|:---|:---|:---| +|displayName|String|Unique string that defines a citation name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptor.md).| +|citationUrl|String|Represents the URL to the published citation. Optional.| +|citationJurisdiction|String|Represents the jurisdiction or agency that published the citation. Optional.| + + +## Response + +If successful, this method returns a `201 Created` response code and a [microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md) object in the response body. + +## Examples + +### Request +Here's an example of a request. + + +``` http +POST https://graph.microsoft.com/v1.0/security/labels/citations +Content-Type: application/json + +{ + "@odata.type": "#microsoft.graph.security.citationTemplate", + "displayName": "Contoso Company Policy", + "citationUrl": "www.citationUrl.com", + "citationJurisdiction": "Contoso" +} +``` + + +### Response +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 201 Created +Content-Type: application/json + +{ + "@odata.type": "#microsoft.graph.security.citationTemplate", + "id": "c0475d01-d532-8a53-6e26-14ea58c640bf", + "displayName": "Contoso Company Policy", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z", + "createdDateTime": "String (timestamp)", + "citationUrl": "www.citationUrl.com", + "citationJurisdiction": "String" +} +``` + diff --git a/api-reference/v1.0/api/security-labelsroot-post-departments.md b/api-reference/v1.0/api/security-labelsroot-post-departments.md new file mode 100644 index 00000000000..21a800ed1a2 --- /dev/null +++ b/api-reference/v1.0/api/security-labelsroot-post-departments.md @@ -0,0 +1,103 @@ +--- +title: "Create departmentTemplate" +description: "Create a new departmentTemplate object." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# Create departmentTemplate +Namespace: microsoft.graph.security + +Create a new [departmentTemplate](../resources/security-departmenttemplate.md) object. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|RecordsManagement.ReadWrite.All| + +## HTTP request + + +``` http +POST /security/labels/departments +``` + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| + +## Request body +In the request body, supply a JSON representation of the [microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md) object. + +You can specify the following properties when creating a **departmentTemplate**. + +|Property|Type|Description| +|:---|:---|:---| +|displayName|String|Unique string that defines a department name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptor.md).| + + + + +## Response + +If successful, this method returns a `201 Created` response code and a [microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md) object in the response body. + +## Examples + +### Request +Here's an example of a request. + + +``` http +POST https://graph.microsoft.com/v1.0/security/labels/departments +Content-Type: application/json + +{ + "@odata.type": "#microsoft.graph.security.departmentTemplate", + "displayName": "Finance", +} +``` + + +### Response +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 201 Created +Content-Type: application/json + +{ + "@odata.type": "#microsoft.graph.security.departmentTemplate", + "id": "11b44677-9f06-c85a-4a0b-766b66904bf8", + "displayName": "Finance", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z" +} +``` + diff --git a/api-reference/v1.0/api/security-labelsroot-post-fileplanreferences.md b/api-reference/v1.0/api/security-labelsroot-post-fileplanreferences.md new file mode 100644 index 00000000000..10434a2633e --- /dev/null +++ b/api-reference/v1.0/api/security-labelsroot-post-fileplanreferences.md @@ -0,0 +1,103 @@ +--- +title: "Create filePlanReferenceTemplate" +description: "Create a new filePlanReferenceTemplate object." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# Create filePlanReferenceTemplate +Namespace: microsoft.graph.security + +Create a new [filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) object. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|RecordsManagement.ReadWrite.All| + +## HTTP request + + +``` http +POST /security/labels/filePlanReferences +``` + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| + +## Request body +In the request body, supply a JSON representation of the [microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) object. + +You can specify the following properties when creating a **filePlanReferenceTemplate**. + +|Property|Type|Description| +|:---|:---|:---| +|displayName|String|Unique string that defines a file plan reference name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptor.md).| + + + + +## Response + +If successful, this method returns a `201 Created` response code and a [microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) object in the response body. + +## Examples + +### Request +Here's an example of a request. + + +``` http +POST https://graph.microsoft.com/v1.0/security/labels/filePlanReferences +Content-Type: application/json + +{ + "@odata.type": "#microsoft.graph.security.filePlanReferenceTemplate", + "displayName": "FIN 01-02-001", +} +``` + + +### Response +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 201 Created +Content-Type: application/json + +{ + "@odata.type": "#microsoft.graph.security.filePlanReferenceTemplate", + "id": "b1f7b518-a44f-1d4b-c6f1-ab8771d3907c", + "displayName": "FIN 01-02-001", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z" +} +``` + diff --git a/api-reference/v1.0/api/security-labelsroot-post-retentionlabel.md b/api-reference/v1.0/api/security-labelsroot-post-retentionlabel.md new file mode 100644 index 00000000000..42696e4cbfe --- /dev/null +++ b/api-reference/v1.0/api/security-labelsroot-post-retentionlabel.md @@ -0,0 +1,182 @@ +--- +title: "Create retentionLabel" +description: "Create a new retentionLabel object." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# Create retentionLabel +Namespace: microsoft.graph.security + +Create a new [retentionLabel](../resources/security-retentionlabel.md) object. + +To create a [disposition review stage](../resources/security-dispositionreviewstage.md), include the **actionAfterRetentionPeriod** property in the request body with one of the possible values specified. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|Not supported.| + +## HTTP request + + +``` http +POST /security/labels/retentionLabels +``` + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| + +## Request body +In the request body, supply a JSON representation of the [retentionLabel](../resources/security-retentionlabel.md) object. + +Specify the following properties when you create a **retentionLabel**. + +|Property|Type|Description| +|:---|:---|:---| +|actionAfterRetentionPeriod|microsoft.graph.security.actionAfterRetentionPeriod| Specifies the action to take on a document with this label applied during the retention period. The possible values are: `none`, `delete`, `startDispositionReview`, `unknownFutureValue`. | +|behaviorDuringRetentionPeriod|microsoft.graph.security.behaviorDuringRetentionPeriod|Specifies how the behavior of a document with this label should be during the retention period. The possible values are: `doNotRetain`, `retain`, `retainAsRecord`, `retainAsRegulatoryRecord`, `unknownFutureValue`. | +|descriptionForAdmins|String|Provides label information for the admin. Optional. | +|descriptionForUsers|String|Provides the label information for the user. Optional. | +|displayName|String|Unique string that defines a label name. | +|dispositionReviewStages|[microsoft.graph.security.dispositionReviewStage](../resources/security-dispositionreviewstage.md) collection|Review stages during which reviewers are notified to determine whether a document must be deleted or retained. | +|retentionDuration|[microsoft.graph.security.retentionDuration](../resources/security-retentionduration.md)|Specifies the number of days to retain the content. | +|retentionTrigger|microsoft.graph.security.retentionTrigger|Specifies whether the retention duration is calculated from the content creation date, labeled date, or last modification date. The possible values are: `dateLabeled`, `dateCreated`, `dateModified`, `dateOfEvent`, `unknownFutureValue`. | +|defaultRecordBehavior|microsoft.graph.security.defaultRecordBehavior|Specifies the locked or unlocked state of a record label when it's created. The possible values are: `startLocked`, `startUnlocked`, `unknownFutureValue`. | +|labelToBeApplied|String|Specifies the replacement label to be applied automatically after the retention period of the current label ends. | + + + +## Response + +If successful, this method returns a `201 Created` response code and a [microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md) object in the response body. + +## Examples + +### Request +Here's an example of a request. + + +``` http +POST https://graph.microsoft.com/v1.0/security/labels/retentionLabels +Content-Type: application/json +Content-length: 555 + +{ + "@odata.type": "#microsoft.graph.security.retentionLabel", + "displayName": "Retention Schedule 10005", + "behaviorDuringRetentionPeriod": "retain", + "actionAfterRetentionPeriod": "startDispositionReview", + "retentionTrigger": "dateOfEvent", + "retentionEventType@odata.bind": "https://graph.microsoft.com/beta/security/triggerTypes/retentionEventTypes('e095f4fc-b966-4c40-94de-fb8a383658e4')", + "retentionDuration": { + "@odata.type": "microsoft.graph.security.retentionDurationInDays", + "days": 2555 + }, + "dispositionReviewStages": [ + { + "stageNumber" : 1, + "name": "Stage1", + "reviewersEmailAddresses ": [ + "Admin@contoso.onmicrosoft.com" + ] + } + ], + "descriptionForAdmins": "retain for 7 years", + "descriptionForUsers": "retain for 7 years", + "descriptors": { + "authorityTemplate@odata.bind" : "https://graph.microsoft.com/beta/security/labels/authorities('fie3f4fc-b966-4c40-94de-fb8a383658e4')", + "categoryTemplate@odata.bind" : "https://graph.microsoft.com/beta/security/labels/categories('0bjk8-b966-4c40-94de-fb8a383658e4')", + "citationTemplate@odata.bind" : "https://graph.microsoft.com/beta/security/labels/citations('0e23f4fc-b966-4c40-94de-fb8a383658e4')", + "departmentTemplate@odata.bind" : "https://graph.microsoft.com/beta/security/labels/departments('p99ef4fc-b966-4c40-94de-fb8a383658e4')", + "filePlanReferenceTemplate@odata.bind" : "https://graph.microsoft.com/beta/security/labels/filePlanReferences('e095f4fc-b966-4c40-94de-fb8a383658e4')" + }, + "defaultRecordBehavior":"startLocked", +} +``` + + +### Response +Here's an example of the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 201 Created +Content-Type: application/json + +{ + "@odata.type": "#microsoft.graph.security.retentionLabel", + "id": "64a99fb4-07be-0481-8746-44c15c0eef1f", + "displayName": "Retention Schedule 10005", + "behaviorDuringRetentionPeriod": "retain", + "actionAfterRetentionPeriod": "startDispositionReview", + "retentionTrigger": "dateOfEvent", + "retentionDuration": { + "@odata.type": "microsoft.graph.security.retentionDurationInDays", + "days": 2555 + }, + "dispositionReviewStages": [ + { + "stageNumber" : 1, + "name": "Stage1", + "reviewersEmailAddresses ": [ + "Admin@contoso.onmicrosoft.com" + ] + } + ], + "isInUse": true, + "descriptionForAdmins": "retain for 7 years", + "descriptionForUsers": "retain for 7 years", + "defaultRecordBehavior":"startLocked", + "createdBy": { + "user": { + "id": "9563a605-e827-4324-a5a9-09efddff1e90", + "displayName": "Admin" + } + }, + "createdDateTime": "2021-08-23T16:43:55Z", + "labelToBeApplied": " ", + "defaultRecordBehavior": "startLocked", + "descriptors": { + "authority": { + "displayName": "Business" + }, + "category": { + "displayName": "Accounts Payable", + }, + "citation": { + "displayName" : "Contoso Company Policy", + "citationUrl": "www.citationUrl.com", + "citationJurisdiction": "Contoso" + }, + "department": { + "displayName" : "Finance" + }, + "filePlanReference": { + "displayName" : "FIN 01-02-001" + } + } +} +``` + diff --git a/api-reference/v1.0/api/security-retentionlabel-delete.md b/api-reference/v1.0/api/security-retentionlabel-delete.md new file mode 100644 index 00000000000..082e215bc80 --- /dev/null +++ b/api-reference/v1.0/api/security-retentionlabel-delete.md @@ -0,0 +1,73 @@ +--- +title: "Delete retentionLabel" +description: "Deletes a retentionLabel object." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# Delete retentionLabel +Namespace: microsoft.graph.security + +Delete a [retentionLabel](../resources/security-retentionlabel.md) object. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|Not supported.| + +## HTTP request + + +``` http +DELETE /security/labels/retentionLabels/{retentionLabelId} + +``` + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| + +## Request body +Don't supply a request body for this method. + +## Response + +If successful, this method returns a `204 No Content` response code. + +## Examples + +### Request +Here's an example of a request. + + +``` http +DELETE https://graph.microsoft.com/v1.0/security/labels/retentionLabels/9563a605-e827-4324-a5a9-09efddff1e50 +``` + + +### Response +Here's an example of the response. +> + +``` http +HTTP/1.1 204 No Content +``` + diff --git a/api-reference/v1.0/api/security-retentionlabel-get.md b/api-reference/v1.0/api/security-retentionlabel-get.md new file mode 100644 index 00000000000..b23408b0f89 --- /dev/null +++ b/api-reference/v1.0/api/security-retentionlabel-get.md @@ -0,0 +1,111 @@ +--- +title: "Get retentionLabel" +description: "Read the properties and relationships of a retentionLabel object." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# Get retentionLabel +Namespace: microsoft.graph.security + +Read the properties and relationships of a [retentionLabel](../resources/security-retentionlabel.md) object. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not Supported.| +|Application|Not supported.| + +## HTTP request + + +``` http +GET /security/labels/retentionLabels/{retentionLabelId} +GET /security/triggers/retentionEvents/{retentionEventId}/labels/{retentionLabelId} +``` + +## Optional query parameters +This method supports the expand OData query parameters to help customize the response. For example, to retrieve the **retentionEventType** property, you can use the `expand` parameter:`$expand=retentionEventType` or `$expand=descriptors`. For general information, see [OData query parameters](/graph/query-parameters). + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| + +## Request body +Don't supply a request body for this method. + +## Response + +If successful, this method returns a `200 OK` response code and a [microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md) object in the response body. + +## Examples + +### Request +Here's an example of a request. + + +``` http +GET https://graph.microsoft.com/v1.0/security/labels/retentionLabels/{retentionLabelId} +``` + +### Response +Here's an example of 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.type": "#microsoft.graph.security.retentionLabel", + "id": "64a99fb4-07be-0481-8746-44c15c0eef1f", + "displayName": "Retention Schedule 10004", + "behaviorDuringRetentionPeriod": "retain", + "actionAfterRetentionPeriod": "relabel", + "retentionTrigger": "dateCreated", + "retentionDuration": { + "@odata.type": "microsoft.graph.security.retentionDurationInDays", + "days": 730 + }, + "isInUse": true, + "descriptionForAdmins": "creation based retention label for schedule 10004", + "descriptionForUsers": "retains for 2 years then relabeled", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime": "2017-11-27T02:10:12Z", + "lastModifiedBy": { + "user": { + "id": "9563a605-e827-4324-a5a9-09efddff1e90", + "displayName": "Records Manager" + } + }, + "lastModifiedDateTime": "2020-08-28T22:13:09Z", + "labelToBeApplied": "Retention schedule 10005", + "defaultRecordBehavior": "startLocked" + } +} +``` + diff --git a/api-reference/v1.0/api/security-retentionlabel-update.md b/api-reference/v1.0/api/security-retentionlabel-update.md new file mode 100644 index 00000000000..896bc84393e --- /dev/null +++ b/api-reference/v1.0/api/security-retentionlabel-update.md @@ -0,0 +1,96 @@ +--- +title: "Update retentionLabel" +description: "Update the properties of a retentionLabel object." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# Update retentionLabel +Namespace: microsoft.graph.security + +Update the properties of a [retentionLabel](../resources/security-retentionlabel.md) object. + +To update a [disposition review stage](../resources/security-dispositionreviewstage.md), include the **actionAfterRetentionPeriod** property in the request body with one of the possible values specified. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|Not supported.| + +## HTTP request + + +``` http +PATCH /security/labels/retentionLabels/{retentionLabelId} + +``` + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| + +## Request body +[!INCLUDE [table-intro](../../includes/update-property-table-intro.md)] + + +|Property|Type|Description| +|:---|:---|:---| +|descriptionForAdmins|String|This is an optional property that provides the label information for the admin.| +|descriptionForUsers|String|This is an optional property that provides the label information for the user.| +|dispositionReviewStages|[microsoft.graph.security.dispositionReviewStage](../resources/security-dispositionreviewstage.md) collection|Review stages during which reviewers are notified to determine whether a document must be deleted or retained.| +|retentionDuration|[microsoft.graph.security.retentionDuration](../resources/security-retentionduration.md)|Specifies the number of days to retain the content.| +|defaultRecordBehavior|microsoft.graph.security.defaultRecordBehavior|Specifies the locked or unlocked state of a record label when it is created. The possible values are: `startLocked`, `startUnlocked`, `unknownFutureValue`.| +|labelToBeApplied|String|Specifies the replacement label to be applied automatically after the retention period of the current label ends. | + + + +## Response + +If successful, this method returns a `204 No Content` response code. + +## Examples + +### Request +Here's an example of a request. + + +``` http +PATCH https://graph.microsoft.com/beta/security/labels/retentionLabels/9563a605-e827-4324-a5a9-09efddff1e50 +Content-Type: application/json +Content-length: 555 + +{ + "@odata.type": "#microsoft.graph.security.retentionLabel", + "retentionDuration": { + "@odata.type": "microsoft.graph.security.retentionDurationInDays", + "days": 2555 + }, +} +``` + +### Response +Here's an example of the response. + + +``` http +HTTP/1.1 204 No Content +``` + diff --git a/api-reference/v1.0/api/security-subcategorytemplate-get.md b/api-reference/v1.0/api/security-subcategorytemplate-get.md new file mode 100644 index 00000000000..bd4109b5626 --- /dev/null +++ b/api-reference/v1.0/api/security-subcategorytemplate-get.md @@ -0,0 +1,92 @@ +--- +title: "Get subCategoryTemplate" +description: "Read the properties and relationships of a subCategoryTemplate object." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: apiPageType +--- + +# Get subCategoryTemplate +Namespace: microsoft.graph.security + +Read the properties and relationships of a [subCategoryTemplate](../resources/security-subcategorytemplate.md) object. + +## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + +|Permission type|Permissions (from least to most privileged)| +|:---|:---| +|Delegated (work or school account)|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| + +## HTTP request + + +``` http +GET /security/labels/categories/{categoryTemplateId}/subCategories/{subCategoryTemplateId} +``` + +## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| + +## Request body +Don't supply a request body for this method. + +## Response + +If successful, this method returns a `200 OK` response code and a [microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md) object in the response body. + +## Examples + +### Request +Here's an example of a request. + + +``` http +GET https://graph.microsoft.com/v1.0/security/labels/categories/82d00422-1f60-46cd-9809-33ca0b4d2286/subCategories/2ac39915-dbeb-e933-82e2-92b981835fa0 +``` + + +### Response +Here's an example of 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.type": "#microsoft.graph.security.subCategoryTemplate", + "id": "2ac39915-dbeb-e933-82e2-92b981835fa0", + "displayName": "Vendor Invoice", + "createdBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Admin" + } + }, + "createdDateTime" : "2021-03-24T02:09:08Z" +} +} +``` + diff --git a/api-reference/v1.0/config/link-validation-config.json b/api-reference/v1.0/config/link-validation-config.json index 532d3a2f5db..6788177838c 100644 --- a/api-reference/v1.0/config/link-validation-config.json +++ b/api-reference/v1.0/config/link-validation-config.json @@ -27,7 +27,7 @@ "/partner-center", "/powershell", "/previous-versions", - "/purview", + "/purview", "/rest", "/security", "/skypeforbusiness", diff --git a/includes/snippets/cli/v1/tutorial-riskdetection-get-riskdetections-filter-cli-snippets.md b/api-reference/v1.0/includes/snippets/cli/get-delta-latest-datalink-tokenislatest-cli-snippets.md similarity index 57% rename from includes/snippets/cli/v1/tutorial-riskdetection-get-riskdetections-filter-cli-snippets.md rename to api-reference/v1.0/includes/snippets/cli/get-delta-latest-datalink-tokenislatest-cli-snippets.md index 5fb61f769b1..22cbf3f69cc 100644 --- a/includes/snippets/cli/v1/tutorial-riskdetection-get-riskdetections-filter-cli-snippets.md +++ b/api-reference/v1.0/includes/snippets/cli/get-delta-latest-datalink-tokenislatest-cli-snippets.md @@ -5,6 +5,6 @@ description: "Automatically generated file. DO NOT MODIFY" ```bash // THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY -mgc identity-protection risk-detections list --filter "userDisplayName eq 'MyTestUser1'" +mgc sites lists items get --site-id {site-id} --list-id {list-id} --list-item-id {listItem-id} ``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/cli/get-listitem-delta-first-cli-snippets.md b/api-reference/v1.0/includes/snippets/cli/get-listitem-delta-first-cli-snippets.md new file mode 100644 index 00000000000..22cbf3f69cc --- /dev/null +++ b/api-reference/v1.0/includes/snippets/cli/get-listitem-delta-first-cli-snippets.md @@ -0,0 +1,10 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```bash + +// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY +mgc sites lists items get --site-id {site-id} --list-id {list-id} --list-item-id {listItem-id} + +``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/cli/get-listitem-delta-last-cli-snippets.md b/api-reference/v1.0/includes/snippets/cli/get-listitem-delta-last-cli-snippets.md new file mode 100644 index 00000000000..22cbf3f69cc --- /dev/null +++ b/api-reference/v1.0/includes/snippets/cli/get-listitem-delta-last-cli-snippets.md @@ -0,0 +1,10 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```bash + +// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY +mgc sites lists items get --site-id {site-id} --list-id {list-id} --list-item-id {listItem-id} + +``` \ No newline at end of file diff --git a/includes/snippets/cli/v1/tutorial-entitlementmanagement-delete-group-cli-snippets.md b/api-reference/v1.0/includes/snippets/cli/reportrootthisgetrelyingpartydetailedsummary-cli-snippets.md similarity index 60% rename from includes/snippets/cli/v1/tutorial-entitlementmanagement-delete-group-cli-snippets.md rename to api-reference/v1.0/includes/snippets/cli/reportrootthisgetrelyingpartydetailedsummary-cli-snippets.md index 86665e2a1b9..5aafcb9e842 100644 --- a/includes/snippets/cli/v1/tutorial-entitlementmanagement-delete-group-cli-snippets.md +++ b/api-reference/v1.0/includes/snippets/cli/reportrootthisgetrelyingpartydetailedsummary-cli-snippets.md @@ -5,6 +5,6 @@ description: "Automatically generated file. DO NOT MODIFY" ```bash // THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY -mgc groups delete --group-id {group-id} +mgc reports get-relying-party-detailed-summary-with-period get --period {period-id} ``` \ No newline at end of file diff --git a/includes/snippets/csharp/v1/tutorial-riskdetection-riskyuserslist-csharp-snippets.md b/api-reference/v1.0/includes/snippets/csharp/get-delta-latest-datalink-tokenislatest-csharp-snippets.md similarity index 61% rename from includes/snippets/csharp/v1/tutorial-riskdetection-riskyuserslist-csharp-snippets.md rename to api-reference/v1.0/includes/snippets/csharp/get-delta-latest-datalink-tokenislatest-csharp-snippets.md index 2e8f501dacf..191bba1347b 100644 --- a/includes/snippets/csharp/v1/tutorial-riskdetection-riskyuserslist-csharp-snippets.md +++ b/api-reference/v1.0/includes/snippets/csharp/get-delta-latest-datalink-tokenislatest-csharp-snippets.md @@ -7,9 +7,9 @@ description: "Automatically generated file. DO NOT MODIFY" // Code snippets are only available for the latest version. Current version is 5.x // To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp -var result = await graphClient.IdentityProtection.RiskyUsers.GetAsync((requestConfiguration) => +var result = await graphClient.Sites["{site-id}"].Lists["{list-id}"].Items["{listItem-id}"].GetAsync((requestConfiguration) => { - requestConfiguration.QueryParameters.Filter = "userDisplayName eq 'MyTestUser1'"; + requestConfiguration.QueryParameters.Token = "latest"; }); diff --git a/api-reference/v1.0/includes/snippets/csharp/get-listitem-delta-first-csharp-snippets.md b/api-reference/v1.0/includes/snippets/csharp/get-listitem-delta-first-csharp-snippets.md new file mode 100644 index 00000000000..b5a6f71842d --- /dev/null +++ b/api-reference/v1.0/includes/snippets/csharp/get-listitem-delta-first-csharp-snippets.md @@ -0,0 +1,13 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```csharp + +// Code snippets are only available for the latest version. Current version is 5.x + +// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp +var result = await graphClient.Sites["{site-id}"].Lists["{list-id}"].Items["{listItem-id}"].GetAsync(); + + +``` \ No newline at end of file diff --git a/includes/snippets/csharp/v1/tutorial-riskdetection-get-riskdetections-filter-csharp-snippets.md b/api-reference/v1.0/includes/snippets/csharp/get-listitem-delta-last-csharp-snippets.md similarity index 60% rename from includes/snippets/csharp/v1/tutorial-riskdetection-get-riskdetections-filter-csharp-snippets.md rename to api-reference/v1.0/includes/snippets/csharp/get-listitem-delta-last-csharp-snippets.md index e7ca9ea70ba..6df03dee0d3 100644 --- a/includes/snippets/csharp/v1/tutorial-riskdetection-get-riskdetections-filter-csharp-snippets.md +++ b/api-reference/v1.0/includes/snippets/csharp/get-listitem-delta-last-csharp-snippets.md @@ -7,9 +7,9 @@ description: "Automatically generated file. DO NOT MODIFY" // Code snippets are only available for the latest version. Current version is 5.x // To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp -var result = await graphClient.IdentityProtection.RiskDetections.GetAsync((requestConfiguration) => +var result = await graphClient.Sites["{site-id}"].Lists["{list-id}"].Items["{listItem-id}"].GetAsync((requestConfiguration) => { - requestConfiguration.QueryParameters.Filter = "userDisplayName eq 'MyTestUser1'"; + requestConfiguration.QueryParameters.Token = "1230919asd190410jlka"; }); diff --git a/api-reference/v1.0/includes/snippets/csharp/reportrootthisgetrelyingpartydetailedsummary-csharp-snippets.md b/api-reference/v1.0/includes/snippets/csharp/reportrootthisgetrelyingpartydetailedsummary-csharp-snippets.md new file mode 100644 index 00000000000..2ecf28929e9 --- /dev/null +++ b/api-reference/v1.0/includes/snippets/csharp/reportrootthisgetrelyingpartydetailedsummary-csharp-snippets.md @@ -0,0 +1,13 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```csharp + +// Code snippets are only available for the latest version. Current version is 5.x + +// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp +var result = await graphClient.Reports.GetRelyingPartyDetailedSummaryWithPeriod("{period}").GetAsGetRelyingPartyDetailedSummaryWithPeriodGetResponseAsync(); + + +``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/go/get-delta-latest-datalink-tokenislatest-go-snippets.md b/api-reference/v1.0/includes/snippets/go/get-delta-latest-datalink-tokenislatest-go-snippets.md new file mode 100644 index 00000000000..ba3d5f90ae7 --- /dev/null +++ b/api-reference/v1.0/includes/snippets/go/get-delta-latest-datalink-tokenislatest-go-snippets.md @@ -0,0 +1,31 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```go + + +import ( + "context" + msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go" + graphsites "github.com/microsoftgraph/msgraph-sdk-go/sites" + //other-imports +) + +graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) + + + +requestToken := "latest" + +requestParameters := &graphsites.SiteItemListItemItemItemRequestBuilderGetQueryParameters{ + Token: &requestToken, +} +configuration := &graphsites.SiteItemListItemItemItemRequestBuilderGetRequestConfiguration{ + QueryParameters: requestParameters, +} + +items, err := graphClient.Sites().BySiteId("site-id").Lists().ByListId("list-id").Items().ByListItemId("listItem-id").Get(context.Background(), configuration) + + +``` \ No newline at end of file diff --git a/includes/snippets/go/v1/tutorial-entitlementmanagement-delete-group-go-snippets.md b/api-reference/v1.0/includes/snippets/go/get-listitem-delta-first-go-snippets.md similarity index 63% rename from includes/snippets/go/v1/tutorial-entitlementmanagement-delete-group-go-snippets.md rename to api-reference/v1.0/includes/snippets/go/get-listitem-delta-first-go-snippets.md index 15659d1e1ff..5d61d73b151 100644 --- a/includes/snippets/go/v1/tutorial-entitlementmanagement-delete-group-go-snippets.md +++ b/api-reference/v1.0/includes/snippets/go/get-listitem-delta-first-go-snippets.md @@ -15,7 +15,7 @@ graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) -graphClient.Groups().ByGroupId("group-id").Delete(context.Background(), nil) +items, err := graphClient.Sites().BySiteId("site-id").Lists().ByListId("list-id").Items().ByListItemId("listItem-id").Get(context.Background(), nil) ``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/go/get-listitem-delta-last-go-snippets.md b/api-reference/v1.0/includes/snippets/go/get-listitem-delta-last-go-snippets.md new file mode 100644 index 00000000000..67381162ca0 --- /dev/null +++ b/api-reference/v1.0/includes/snippets/go/get-listitem-delta-last-go-snippets.md @@ -0,0 +1,31 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```go + + +import ( + "context" + msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go" + graphsites "github.com/microsoftgraph/msgraph-sdk-go/sites" + //other-imports +) + +graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) + + + +requestToken := "1230919asd190410jlka" + +requestParameters := &graphsites.SiteItemListItemItemItemRequestBuilderGetQueryParameters{ + Token: &requestToken, +} +configuration := &graphsites.SiteItemListItemItemItemRequestBuilderGetRequestConfiguration{ + QueryParameters: requestParameters, +} + +items, err := graphClient.Sites().BySiteId("site-id").Lists().ByListId("list-id").Items().ByListItemId("listItem-id").Get(context.Background(), configuration) + + +``` \ No newline at end of file diff --git a/includes/snippets/go/v1/tutorial-riskdetection-delete-user-go-snippets.md b/api-reference/v1.0/includes/snippets/go/reportrootthisgetrelyingpartydetailedsummary-go-snippets.md similarity index 54% rename from includes/snippets/go/v1/tutorial-riskdetection-delete-user-go-snippets.md rename to api-reference/v1.0/includes/snippets/go/reportrootthisgetrelyingpartydetailedsummary-go-snippets.md index cc22d45e63d..13967dfa657 100644 --- a/includes/snippets/go/v1/tutorial-riskdetection-delete-user-go-snippets.md +++ b/api-reference/v1.0/includes/snippets/go/reportrootthisgetrelyingpartydetailedsummary-go-snippets.md @@ -15,7 +15,8 @@ graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) -graphClient.Users().ByUserId("user-id").Delete(context.Background(), nil) +period := "{period}" +getRelyingPartyDetailedSummary, err := graphClient.Reports().GetRelyingPartyDetailedSummaryWithPeriod(&period).GetAsGetRelyingPartyDetailedSummaryWithPeriodGetResponse(context.Background(), nil) ``` \ No newline at end of file diff --git a/includes/snippets/java/v1/tutorial-riskdetection-get-riskdetections-filter-java-snippets.md b/api-reference/v1.0/includes/snippets/java/get-delta-latest-datalink-tokenislatest-java-snippets.md similarity index 53% rename from includes/snippets/java/v1/tutorial-riskdetection-get-riskdetections-filter-java-snippets.md rename to api-reference/v1.0/includes/snippets/java/get-delta-latest-datalink-tokenislatest-java-snippets.md index 0625b6eccef..a71c4b533d6 100644 --- a/includes/snippets/java/v1/tutorial-riskdetection-get-riskdetections-filter-java-snippets.md +++ b/api-reference/v1.0/includes/snippets/java/get-delta-latest-datalink-tokenislatest-java-snippets.md @@ -8,8 +8,8 @@ description: "Automatically generated file. DO NOT MODIFY" GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); -RiskDetectionCollectionResponse result = graphClient.identityProtection().riskDetections().get(requestConfiguration -> { - requestConfiguration.queryParameters.filter = "userDisplayName eq 'MyTestUser1'"; +ListItem result = graphClient.sites().bySiteId("{site-id}").lists().byListId("{list-id}").items().byListItemId("{listItem-id}").get(requestConfiguration -> { + requestConfiguration.queryParameters.token = "latest"; }); diff --git a/api-reference/v1.0/includes/snippets/java/get-listitem-delta-first-java-snippets.md b/api-reference/v1.0/includes/snippets/java/get-listitem-delta-first-java-snippets.md new file mode 100644 index 00000000000..b60f1e8884d --- /dev/null +++ b/api-reference/v1.0/includes/snippets/java/get-listitem-delta-first-java-snippets.md @@ -0,0 +1,14 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```java + +// Code snippets are only available for the latest version. Current version is 6.x + +GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); + +ListItem result = graphClient.sites().bySiteId("{site-id}").lists().byListId("{list-id}").items().byListItemId("{listItem-id}").get(); + + +``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/java/get-listitem-delta-last-java-snippets.md b/api-reference/v1.0/includes/snippets/java/get-listitem-delta-last-java-snippets.md new file mode 100644 index 00000000000..00ab7f010dd --- /dev/null +++ b/api-reference/v1.0/includes/snippets/java/get-listitem-delta-last-java-snippets.md @@ -0,0 +1,16 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```java + +// Code snippets are only available for the latest version. Current version is 6.x + +GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); + +ListItem result = graphClient.sites().bySiteId("{site-id}").lists().byListId("{list-id}").items().byListItemId("{listItem-id}").get(requestConfiguration -> { + requestConfiguration.queryParameters.token = "1230919asd190410jlka"; +}); + + +``` \ No newline at end of file diff --git a/includes/snippets/java/v1/tutorial-riskdetection-delete-user-java-snippets.md b/api-reference/v1.0/includes/snippets/java/reportrootthisgetrelyingpartydetailedsummary-java-snippets.md similarity index 71% rename from includes/snippets/java/v1/tutorial-riskdetection-delete-user-java-snippets.md rename to api-reference/v1.0/includes/snippets/java/reportrootthisgetrelyingpartydetailedsummary-java-snippets.md index 3dd793ecc06..f281e2412ba 100644 --- a/includes/snippets/java/v1/tutorial-riskdetection-delete-user-java-snippets.md +++ b/api-reference/v1.0/includes/snippets/java/reportrootthisgetrelyingpartydetailedsummary-java-snippets.md @@ -8,7 +8,7 @@ description: "Automatically generated file. DO NOT MODIFY" GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); -graphClient.users().byUserId("{user-id}").delete(); +var result = graphClient.reports().getRelyingPartyDetailedSummaryWithPeriod("{period}").get(); ``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/javascript/get-delta-latest-datalink-tokenislatest-javascript-snippets.md b/api-reference/v1.0/includes/snippets/javascript/get-delta-latest-datalink-tokenislatest-javascript-snippets.md new file mode 100644 index 00000000000..73eb057db70 --- /dev/null +++ b/api-reference/v1.0/includes/snippets/javascript/get-delta-latest-datalink-tokenislatest-javascript-snippets.md @@ -0,0 +1,16 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```javascript + +const options = { + authProvider, +}; + +const client = Client.init(options); + +let listItem = await client.api('/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE/lists/22e03ef3-6ef4-424d-a1d3-92a337807c30/items/delta?token=latest') + .get(); + +``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/javascript/get-listitem-delta-first-javascript-snippets.md b/api-reference/v1.0/includes/snippets/javascript/get-listitem-delta-first-javascript-snippets.md new file mode 100644 index 00000000000..5091cbf9c73 --- /dev/null +++ b/api-reference/v1.0/includes/snippets/javascript/get-listitem-delta-first-javascript-snippets.md @@ -0,0 +1,16 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```javascript + +const options = { + authProvider, +}; + +const client = Client.init(options); + +let listItem = await client.api('/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE/lists/22e03ef3-6ef4-424d-a1d3-92a337807c30/items/delta') + .get(); + +``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/javascript/get-listitem-delta-last-javascript-snippets.md b/api-reference/v1.0/includes/snippets/javascript/get-listitem-delta-last-javascript-snippets.md new file mode 100644 index 00000000000..925966b5221 --- /dev/null +++ b/api-reference/v1.0/includes/snippets/javascript/get-listitem-delta-last-javascript-snippets.md @@ -0,0 +1,16 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```javascript + +const options = { + authProvider, +}; + +const client = Client.init(options); + +let listItem = await client.api('/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE/lists/22e03ef3-6ef4-424d-a1d3-92a337807c30/items/delta?token=1230919asd190410jlka') + .get(); + +``` \ No newline at end of file diff --git a/includes/snippets/javascript/v1/tutorial-riskdetection-get-riskdetections-filter-javascript-snippets.md b/api-reference/v1.0/includes/snippets/javascript/reportrootthisgetrelyingpartydetailedsummary-javascript-snippets.md similarity index 58% rename from includes/snippets/javascript/v1/tutorial-riskdetection-get-riskdetections-filter-javascript-snippets.md rename to api-reference/v1.0/includes/snippets/javascript/reportrootthisgetrelyingpartydetailedsummary-javascript-snippets.md index 613cce98df9..a1b9b8400d1 100644 --- a/includes/snippets/javascript/v1/tutorial-riskdetection-get-riskdetections-filter-javascript-snippets.md +++ b/api-reference/v1.0/includes/snippets/javascript/reportrootthisgetrelyingpartydetailedsummary-javascript-snippets.md @@ -10,8 +10,7 @@ const options = { const client = Client.init(options); -let riskDetections = await client.api('/identityProtection/riskDetections') - .filter('userDisplayName eq \'MyTestUser1\'') +let getRelyingPartyDetailedSummary = await client.api('/reports/getRelyingPartyDetailedSummary(period='D7')') .get(); ``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/php/get-delta-latest-datalink-tokenislatest-php-snippets.md b/api-reference/v1.0/includes/snippets/php/get-delta-latest-datalink-tokenislatest-php-snippets.md new file mode 100644 index 00000000000..96b80547fe3 --- /dev/null +++ b/api-reference/v1.0/includes/snippets/php/get-delta-latest-datalink-tokenislatest-php-snippets.md @@ -0,0 +1,20 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```php + +token = "latest"; +$requestConfiguration->queryParameters = $queryParameters; + + +$result = $graphServiceClient->sites()->bySiteId('site-id')->lists()->byListId('list-id')->items()->byListItemId('listItem-id')->get($requestConfiguration)->wait(); + +``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/php/get-listitem-delta-first-php-snippets.md b/api-reference/v1.0/includes/snippets/php/get-listitem-delta-first-php-snippets.md new file mode 100644 index 00000000000..53f4b944c1d --- /dev/null +++ b/api-reference/v1.0/includes/snippets/php/get-listitem-delta-first-php-snippets.md @@ -0,0 +1,15 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```php + +sites()->bySiteId('site-id')->lists()->byListId('list-id')->items()->byListItemId('listItem-id')->get()->wait(); + +``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/php/get-listitem-delta-last-php-snippets.md b/api-reference/v1.0/includes/snippets/php/get-listitem-delta-last-php-snippets.md new file mode 100644 index 00000000000..f743f77f3ff --- /dev/null +++ b/api-reference/v1.0/includes/snippets/php/get-listitem-delta-last-php-snippets.md @@ -0,0 +1,20 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```php + +token = "1230919asd190410jlka"; +$requestConfiguration->queryParameters = $queryParameters; + + +$result = $graphServiceClient->sites()->bySiteId('site-id')->lists()->byListId('list-id')->items()->byListItemId('listItem-id')->get($requestConfiguration)->wait(); + +``` \ No newline at end of file diff --git a/includes/snippets/php/v1/tutorial-entitlementmanagement-delete-group-php-snippets.md b/api-reference/v1.0/includes/snippets/php/reportrootthisgetrelyingpartydetailedsummary-php-snippets.md similarity index 59% rename from includes/snippets/php/v1/tutorial-entitlementmanagement-delete-group-php-snippets.md rename to api-reference/v1.0/includes/snippets/php/reportrootthisgetrelyingpartydetailedsummary-php-snippets.md index d0f22039a34..bd6f6af7416 100644 --- a/includes/snippets/php/v1/tutorial-entitlementmanagement-delete-group-php-snippets.md +++ b/api-reference/v1.0/includes/snippets/php/reportrootthisgetrelyingpartydetailedsummary-php-snippets.md @@ -10,6 +10,6 @@ description: "Automatically generated file. DO NOT MODIFY" $graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes); -$graphServiceClient->groups()->byGroupId('group-id')->delete()->wait(); +$result = $graphServiceClient->reports()->getRelyingPartyDetailedSummaryWithPeriod('{period}', )->get()->wait(); ``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/powershell/get-delta-latest-datalink-tokenislatest-powershell-snippets.md b/api-reference/v1.0/includes/snippets/powershell/get-delta-latest-datalink-tokenislatest-powershell-snippets.md new file mode 100644 index 00000000000..8a37709aa44 --- /dev/null +++ b/api-reference/v1.0/includes/snippets/powershell/get-delta-latest-datalink-tokenislatest-powershell-snippets.md @@ -0,0 +1,11 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```powershell + +Import-Module Microsoft.Graph.Sites + +Get-MgSiteListItem -SiteId $siteId -ListId $listId -ListItemId $listItemId -Token "latest" + +``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/powershell/get-listitem-delta-first-powershell-snippets.md b/api-reference/v1.0/includes/snippets/powershell/get-listitem-delta-first-powershell-snippets.md new file mode 100644 index 00000000000..a179a8ac2e5 --- /dev/null +++ b/api-reference/v1.0/includes/snippets/powershell/get-listitem-delta-first-powershell-snippets.md @@ -0,0 +1,11 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```powershell + +Import-Module Microsoft.Graph.Sites + +Get-MgSiteListItem -SiteId $siteId -ListId $listId -ListItemId $listItemId + +``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/powershell/get-listitem-delta-last-powershell-snippets.md b/api-reference/v1.0/includes/snippets/powershell/get-listitem-delta-last-powershell-snippets.md new file mode 100644 index 00000000000..63990d816f1 --- /dev/null +++ b/api-reference/v1.0/includes/snippets/powershell/get-listitem-delta-last-powershell-snippets.md @@ -0,0 +1,11 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```powershell + +Import-Module Microsoft.Graph.Sites + +Get-MgSiteListItem -SiteId $siteId -ListId $listId -ListItemId $listItemId -Token "1230919asd190410jlka" + +``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/powershell/reportrootthisgetrelyingpartydetailedsummary-powershell-snippets.md b/api-reference/v1.0/includes/snippets/powershell/reportrootthisgetrelyingpartydetailedsummary-powershell-snippets.md new file mode 100644 index 00000000000..08a94b60481 --- /dev/null +++ b/api-reference/v1.0/includes/snippets/powershell/reportrootthisgetrelyingpartydetailedsummary-powershell-snippets.md @@ -0,0 +1,11 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```powershell + +Import-Module Microsoft.Graph.Reports + +Get-MgReportRelyingPartyDetailedSummary -Period $periodId + +``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/python/get-delta-latest-datalink-tokenislatest-python-snippets.md b/api-reference/v1.0/includes/snippets/python/get-delta-latest-datalink-tokenislatest-python-snippets.md new file mode 100644 index 00000000000..74a4d0c9c7a --- /dev/null +++ b/api-reference/v1.0/includes/snippets/python/get-delta-latest-datalink-tokenislatest-python-snippets.md @@ -0,0 +1,23 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```python + +from msgraph import GraphServiceClient +from msgraph.generated.sites.item.lists.item.items.item.list_item_item_request_builder import ListItemItemRequestBuilder + +graph_client = GraphServiceClient(credentials, scopes) + +query_params = ListItemItemRequestBuilder.ListItemItemRequestBuilderGetQueryParameters( + token = "latest", +) + +request_configuration = ListItemItemRequestBuilder.ListItemItemRequestBuilderGetRequestConfiguration( +query_parameters = query_params, +) + +result = await graph_client.sites.by_site_id('site-id').lists.by_list_id('list-id').items.by_list_item_id('listItem-id').get(request_configuration = request_configuration) + + +``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/python/get-listitem-delta-first-python-snippets.md b/api-reference/v1.0/includes/snippets/python/get-listitem-delta-first-python-snippets.md new file mode 100644 index 00000000000..81d140e8527 --- /dev/null +++ b/api-reference/v1.0/includes/snippets/python/get-listitem-delta-first-python-snippets.md @@ -0,0 +1,15 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```python + +from msgraph import GraphServiceClient + +graph_client = GraphServiceClient(credentials, scopes) + + +result = await graph_client.sites.by_site_id('site-id').lists.by_list_id('list-id').items.by_list_item_id('listItem-id').get() + + +``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/python/get-listitem-delta-last-python-snippets.md b/api-reference/v1.0/includes/snippets/python/get-listitem-delta-last-python-snippets.md new file mode 100644 index 00000000000..73ce968ac40 --- /dev/null +++ b/api-reference/v1.0/includes/snippets/python/get-listitem-delta-last-python-snippets.md @@ -0,0 +1,23 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```python + +from msgraph import GraphServiceClient +from msgraph.generated.sites.item.lists.item.items.item.list_item_item_request_builder import ListItemItemRequestBuilder + +graph_client = GraphServiceClient(credentials, scopes) + +query_params = ListItemItemRequestBuilder.ListItemItemRequestBuilderGetQueryParameters( + token = "1230919asd190410jlka", +) + +request_configuration = ListItemItemRequestBuilder.ListItemItemRequestBuilderGetRequestConfiguration( +query_parameters = query_params, +) + +result = await graph_client.sites.by_site_id('site-id').lists.by_list_id('list-id').items.by_list_item_id('listItem-id').get(request_configuration = request_configuration) + + +``` \ No newline at end of file diff --git a/includes/snippets/python/v1/tutorial-riskdetection-delete-user-python-snippets.md b/api-reference/v1.0/includes/snippets/python/reportrootthisgetrelyingpartydetailedsummary-python-snippets.md similarity index 64% rename from includes/snippets/python/v1/tutorial-riskdetection-delete-user-python-snippets.md rename to api-reference/v1.0/includes/snippets/python/reportrootthisgetrelyingpartydetailedsummary-python-snippets.md index 1c50815a7ac..e438a2e7a96 100644 --- a/includes/snippets/python/v1/tutorial-riskdetection-delete-user-python-snippets.md +++ b/api-reference/v1.0/includes/snippets/python/reportrootthisgetrelyingpartydetailedsummary-python-snippets.md @@ -9,7 +9,7 @@ from msgraph import GraphServiceClient graph_client = GraphServiceClient(credentials, scopes) -await graph_client.users.by_user_id('user-id').delete() +result = await graph_client.reports.get_relying_party_detailed_summary_with_period("{period}").get() ``` \ No newline at end of file diff --git a/api-reference/v1.0/resources/crosstenantaccesspolicy-overview.md b/api-reference/v1.0/resources/crosstenantaccesspolicy-overview.md index 44bd5bded51..7f98e1b8051 100644 --- a/api-reference/v1.0/resources/crosstenantaccesspolicy-overview.md +++ b/api-reference/v1.0/resources/crosstenantaccesspolicy-overview.md @@ -342,6 +342,27 @@ The cross-tenant access settings API can be used to set up multiple configuratio Users in group 'g1' are blocked from accessing application 'a1' only. All users, including users in group 'g1' are able to access any other application. + + + Prioritize using an external federation over Entra ID during guest user invitation redemption + + + +``` json +"invitationRedemptionIdentityProviderConfiguration": { + "primaryIdentityProviderPrecedenceOrder": [ + "externalFederation", + "azureActiveDirectory", + "socialIdentityProviders" + ], + "fallbackIdentityProvider": "defaultConfiguredIdp" +} +``` + + +Check if the guest user is from an externally federated partner before trying Entra ID for authentication. + + ## Cross-tenant access settings vs tenant restrictions diff --git a/api-reference/v1.0/resources/crosstenantaccesspolicyconfigurationdefault.md b/api-reference/v1.0/resources/crosstenantaccesspolicyconfigurationdefault.md index 24ea0d72331..78cc147b195 100644 --- a/api-reference/v1.0/resources/crosstenantaccesspolicyconfigurationdefault.md +++ b/api-reference/v1.0/resources/crosstenantaccesspolicyconfigurationdefault.md @@ -25,13 +25,14 @@ The default configuration defined for inbound and outbound settings of Microsoft |Property|Type|Description| |:---|:---|:---| -| automaticUserConsentSettings | [inboundOutboundPolicyConfiguration](../resources/inboundoutboundpolicyconfiguration.md) | Determines the default configuration for automatic user consent settings. The **inboundAllowed** and **outboundAllowed** properties are always `false` and cannot be updated in the default configuration. Read-only. | +| automaticUserConsentSettings | [inboundOutboundPolicyConfiguration](../resources/inboundoutboundpolicyconfiguration.md) | Determines the default configuration for automatic user consent settings. The **inboundAllowed** and **outboundAllowed** properties are always `false` and can't be updated in the default configuration. Read-only. | | b2bCollaborationInbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) |Defines your default configuration for users from other organizations accessing your resources via Microsoft Entra B2B collaboration. | | b2bCollaborationOutbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) |Defines your default configuration for users in your organization going outbound to access resources in another organization via Microsoft Entra B2B collaboration. | | b2bDirectConnectInbound |[crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your default configuration for users from other organizations accessing your resources via Microsoft Entra B2B direct connect. | | b2bDirectConnectOutbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) |Defines your default configuration for users in your organization going outbound to access resources in another organization via Microsoft Entra B2B direct connect. | | inboundTrust | [crossTenantAccessPolicyInboundTrust](../resources/crosstenantaccesspolicyinboundtrust.md) | Determines the default configuration for trusting other Conditional Access claims from external Microsoft Entra organizations. | -| isServiceDefault | Boolean | If `true`, the default configuration is set to the system default configuration. If `false`, the default settings have been customized. | +| invitationRedemptionIdentityProviderConfiguration | [defaultInvitationRedemptionIdentityProviderConfiguration](../resources/defaultInvitationRedemptionIdentityProviderConfiguration.md) | Defines the priority order based on which an identity provider is selected during invitation redemption for a guest user. | +| isServiceDefault | Boolean | If `true`, the default configuration is set to the system default configuration. If `false`, the default settings are customized. | ## Relationships @@ -39,7 +40,7 @@ None. ## JSON representation -The following is a JSON representation of the resource. +The following JSON representation shows the resource type. + +``` json +{ + "primaryIdentityProviderPrecedenceOrder": ["String"], + "fallbackIdentityProvider": "String" +} +``` diff --git a/api-reference/v1.0/resources/enums-security.md b/api-reference/v1.0/resources/enums-security.md index 8aa91bf1a8b..e4279c4c0a4 100644 --- a/api-reference/v1.0/resources/enums-security.md +++ b/api-reference/v1.0/resources/enums-security.md @@ -11,6 +11,15 @@ author: "BenAlfasi" Namespace: microsoft.graph.security +### actionAfterRetentionPeriod values + +| Member | +| :--------------------- | +| none | +| delete | +| startDispositionReview | +| unknownFutureValue | + ### behaviorDuringRetentionPeriod values | Member | @@ -30,6 +39,14 @@ Namespace: microsoft.graph.security | markdown | | unknownFutureValue | +### defaultRecordBehavior values + +| Member | +| :----------------- | +| startLocked | +| startUnlocked | +| unknownFutureValue | + ### detectionStatus values | Member @@ -121,6 +138,16 @@ Namespace: microsoft.graph.security | messages | | unknownFutureValue | +### retentionTrigger values + +| Member | +| :----------------- | +| dateLabeled | +| dateCreated | +| dateModified | +| dateOfEvent | +| unknownFutureValue | + ### vulnerabilitySeverity values | Member | diff --git a/api-reference/v1.0/resources/enums.md b/api-reference/v1.0/resources/enums.md index 08f8d086f49..61e83829695 100644 --- a/api-reference/v1.0/resources/enums.md +++ b/api-reference/v1.0/resources/enums.md @@ -3228,3 +3228,15 @@ Possible values for user account types (group membership), per Windows definitio | assigned | | unknownFutureValue | | inactive | + +### b2bIdentityProvidersType values + +|Member| +|:-----| +|azureActiveDirectory| +|externalFederation| +|socialIdentityProviders| +|emailOneTimePasscode| +|microsoftAccount| +|defaultConfiguredIdp| +|unknownFutureValue| \ No newline at end of file diff --git a/api-reference/v1.0/resources/invitationredemptionidentityproviderconfiguration.md b/api-reference/v1.0/resources/invitationredemptionidentityproviderconfiguration.md new file mode 100644 index 00000000000..e04007733d3 --- /dev/null +++ b/api-reference/v1.0/resources/invitationredemptionidentityproviderconfiguration.md @@ -0,0 +1,57 @@ +--- +title: "invitationRedemptionIdentityProviderConfiguration resource type" +description: "Defines the invitation redemption provider configuration base type to set redemption flow settings for Microsoft Entra ID B2B collaboration." +author: "jkdouglas" +ms.localizationpriority: medium +ms.subservice: "entra-sign-in" +doc_type: resourcePageType +--- + +# invitationRedemptionIdentityProviderConfiguration resource type + +Namespace: microsoft.graph + +Defines the invitation redemption provider configuration base type to set redemption flow settings for Microsoft Entra ID B2B collaboration. + +Two types of identity providers are in the precedence order: primary identity providers and fallback identity providers. Fallback identity providers are used when no primary identity provider is available and must always be specified. + +The primary identity providers are: + +- azureActiveDirectory: Any user located in another Microsoft Entra ID tenant. +- externalFederation: Any user located in an identity provider associated with a SAML or WS-Federation relationship. +- socialIdentityProviders: Any user using a gmail.com account when Google Federation is configured. + +The fallback identity providers are: + +- defaultConfiguredIdp: Check for an existing Microsoft account, then use a one-time email passcode (if enabled), and finally, create a new Microsoft account if no primary identity providers are available for the user. +- emailOneTimePasscode: Always use one-time email passcode if no primary identity providers are available for the user. +- microsoftAccount: Always use an existing Microsoft account or create a new Microsoft account if no primary identity providers are available for the user. + +## Properties + +|Property|Type|Description| +|:---|:---|:---| +| primaryIdentityProviderPrecedenceOrder | b2bIdentityProvidersType collection | Collection of identity providers in priority order of preference to be used for guest invitation redemption. Possible values are: `azureActiveDirectory`, `externalFederation`, or `socialIdentityProviders`. | +| fallbackIdentityProvider | b2bIdentityProvidersType | The fallback identity provider to be used in case no primary identity provider can be used for guest invitation redemption. Possible values are: `defaultConfiguredIdp`, `emailOneTimePasscode`, or `microsoftAccount`. | + +## Relationships + +None. + +## JSON representation + +The following JSON representation shows the resource type. + +``` json +{ + "@odata.type": "#microsoft.graph.invitationRedemptionIdentityProviderConfiguration", + "primaryIdentityProviderPrecedenceOrder": [ + "String" + ], + "fallbackIdentityProvider": "String" +} +``` diff --git a/api-reference/v1.0/resources/security-api-overview.md b/api-reference/v1.0/resources/security-api-overview.md index 20519aae49d..8886f6082c8 100644 --- a/api-reference/v1.0/resources/security-api-overview.md +++ b/api-reference/v1.0/resources/security-api-overview.md @@ -116,6 +116,12 @@ The  [incident](security-incident.md) resource and its APIs allow you to sort The Microsoft Graph threat assessment API helps organizations to assess the threat received by any user in a tenant. This empowers customers to report spam emails, phishing URLs or malware attachments they receive to Microsoft. The policy check result and rescan result can help tenant administrators understand the threat scanning verdict and adjust their organizational policy. + +## Records management + +Most organizations need to manage data to proactively comply with industry regulations and internal policies, reduce risk in the event of litigation or a security breach, and let people effectively and agiley share knowledge that is current and relevant to them. You can use the [records management APIs](../resources/security-recordsmanagement-overview.md) to systematically apply [retention labels](security-retentionlabel.md) to different types of content that require different retention settings. For example, you can configure the start of retention period from when the content was created, last modified, labeled or when an event occurs for a particular event type. Further, you can use [file plan descriptors](security-fileplandescriptor.md) to improve the manageability of these retention labels. + + ## Secure Score [Microsoft Secure Score](https://techcommunity.microsoft.com/t5/Security-Privacy-and-Compliance/A-new-home-and-an-all-new-look-for-Microsoft-Secure-Score/ba-p/529641) is a security analytics solution that gives you visibility into your security portfolio and how to improve it. With a single score, you can better understand what you did to reduce your risk in Microsoft solutions. You can also compare your score with other organizations and see how your score has been trending over time. The Microsoft Graph security [secureScore](securescore.md) and [secureScoreControlProfile](securescorecontrolprofile.md) entities help you balance your organization's security and productivity needs while enabling the appropriate mix of security features. You can also project what your score would be after you adopt security features. diff --git a/api-reference/v1.0/resources/security-appliedcategory.md b/api-reference/v1.0/resources/security-appliedcategory.md new file mode 100644 index 00000000000..b94de87a70e --- /dev/null +++ b/api-reference/v1.0/resources/security-appliedcategory.md @@ -0,0 +1,47 @@ +--- +title: "appliedCategory resource type" +description: "Represents the file plan descriptor of type category applied to a particular retention label." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: resourcePageType +--- + +# appliedCategory resource type + +Namespace: microsoft.graph.security + +Represents a file plan descriptor that specifies a group of similar types of content in a department. Used to supplement a [retention label](security-retentionlabel.md) for [record management purposes](security-recordsmanagement-overview.md). + +To create, get, or delete an **appliedCategory** descriptor, use the [categoryTemplate](security-categorytemplate.md) resource. + +This resource is one of a set of file plan descriptors that an administrator can choose to supplement a retention label. To find out more about these optional descriptors, and how to get the descriptors that have been chosen for a retention label, see [file plan descriptor](security-fileplandescriptor.md). + +Inherits from [microsoft.graph.security.filePlanDescriptorBase](../resources/security-fileplandescriptorBase.md). + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|displayName|String|Unique string that defines a category name applied to the label. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| +|subCategory|[microsoft.graph.security.subCategory](../resources/security-subcategory.md)|Represents the file plan descriptor for a subcategory under a specific category, which has been assigned to a particular retention label.| + +## Relationships +None. + +## JSON representation +Here's a JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.security.appliedCategory", + "displayName": "String", + "subCategory": { + "@odata.type": "microsoft.graph.security.subCategory" + } +} +``` + diff --git a/api-reference/v1.0/resources/security-authority.md b/api-reference/v1.0/resources/security-authority.md new file mode 100644 index 00000000000..eb5c98707bb --- /dev/null +++ b/api-reference/v1.0/resources/security-authority.md @@ -0,0 +1,43 @@ +--- +title: "authority resource type" +description: "Represents the file plan descriptor of type authority applied to a particular retention label." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: resourcePageType +--- + +# authority resource type + +Namespace: microsoft.graph.security + +Represents a file plan descriptor that specifies the type of the underlying authority which determines the content to be retained and its retention schedule. Used to supplement a [retention label](security-retentionlabel.md) for [record management purposes](security-recordsmanagement-overview.md). + +To create, get, or delete an **authority** descriptor, use the [authorityTemplate](security-authoritytemplate.md) resource. + +This resource is one of a set of file plan descriptors that an administrator can choose to supplement a retention label. To find out more about these optional descriptors, and how to get the descriptors that have been chosen for a retention label, see [file plan descriptor](security-fileplandescriptor.md). + +Inherits from [microsoft.graph.security.filePlanDescriptorBase](../resources/security-fileplandescriptorBase.md). + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|displayName|String|Unique string that defines an authority name. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| + +## Relationships +None. + +## JSON representation +Here's a JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.security.authority", + "displayName": "String" +} +``` + diff --git a/api-reference/v1.0/resources/security-authoritytemplate.md b/api-reference/v1.0/resources/security-authoritytemplate.md new file mode 100644 index 00000000000..432dab6b81a --- /dev/null +++ b/api-reference/v1.0/resources/security-authoritytemplate.md @@ -0,0 +1,58 @@ +--- +title: "authorityTemplate resource type" +description: "Specifies the underlying authority that describes the type of content to be retained and its retention schedule." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: resourcePageType +--- + +# authorityTemplate resource type + +Namespace: microsoft.graph.security + +Supports CRUD operations to apply and manage the [authority](security-authority.md) descriptor for a [retentionLabel](security-retentionlabel.md). The **authority** file plan descriptor supplements a retention label to improve the manageability and organization of Microsoft 365 content. + +Inherits from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). + +## Methods +|Method|Return type|Description| +|:---|:---|:---| +|[List authorities](../api/security-labelsroot-list-authorities.md)|[microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md) collection|Get a list of the [microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md) objects and their properties.| +|[Create authorities](../api/security-labelsroot-post-authorities.md)|[microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md)|Create a new [microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md) object.| +|[Get authorities](../api/security-authoritytemplate-get.md)|[microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md)|Read the properties and relationships of a [microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md) object.| +|[Delete authorities](../api/security-labelsroot-delete-authorities.md)|None|Delete a [microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md) object.| + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the authority descriptor. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|createdDateTime|DateTimeOffset|Represents the date and time in which the authority descriptor is created. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|displayName|String|Unique string that defines an authority name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md).| +|id|String|Unique ID of the authority. Inherited from [microsoft.graph.entity](../resources/entity.md). Read-only.| + +## Relationships +None. + +## JSON representation +Here's a JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.security.authorityTemplate", + "id": "String (identifier)", + "displayName": "String", + "createdBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "createdDateTime": "String (timestamp)" +} +``` + diff --git a/api-reference/v1.0/resources/security-categorytemplate.md b/api-reference/v1.0/resources/security-categorytemplate.md new file mode 100644 index 00000000000..de8bd5c841e --- /dev/null +++ b/api-reference/v1.0/resources/security-categorytemplate.md @@ -0,0 +1,62 @@ +--- +title: "categoryTemplate resource type" +description: "Specifies a group of similar types of content in a particular department." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: resourcePageType +--- + +# categoryTemplate resource type + +Namespace: microsoft.graph.security + +Supports CRUD operations to apply and manage the [appliedCategory](security-appliedcategory.md) descriptor, and any [subCategory](security-subcategory.md) descriptor for a [retentionLabel](security-retentionlabel.md). These file plan descriptors supplement a retention label to improve the manageability and organization of Microsoft 365 content. + +Inherits from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). + +## Methods +|Method|Return type|Description| +|:---|:---|:---| +|[List categories](../api/security-labelsroot-list-categories.md)|[microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) collection|Get a list of the [microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) objects and their properties.| +|[Create categories](../api/security-labelsroot-post-categories.md)|[microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md)|Create a new [microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) object.| +|[Get categories](../api/security-categorytemplate-get.md)|[microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md)|Read the properties and relationships of a [microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) object.| +|[Delete categories](../api/security-labelsroot-delete-categories.md)|None|Delete a [microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) object.| +|[List subCategories](../api/security-categorytemplate-list-subcategories.md)|[microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md) collection|Get the subCategoryTemplate resources from the subCategories navigation property.| +|[Create subCategories](../api/security-categorytemplate-post-subcategories.md)|[microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md)|Create a new subCategoryTemplate object.| + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the category descriptor. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|createdDateTime|DateTimeOffset|Represents the date and time in which the category descriptor is created. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|displayName|String|Unique string that defines a category name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md).| +|id|String|Unique ID of the category. Inherited from [microsoft.graph.entity](../resources/entity.md). Read-only.| + +## Relationships +|Relationship|Type|Description| +|:---|:---|:---| +|subCategories|[microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md) collection|Represents all subcategories under a particular category.| + +## JSON representation +Here's a JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.security.categoryTemplate", + "id": "String (identifier)", + "displayName": "String", + "createdBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "createdDateTime": "String (timestamp)" +} +``` + diff --git a/api-reference/v1.0/resources/security-citation.md b/api-reference/v1.0/resources/security-citation.md new file mode 100644 index 00000000000..13c4cd53a21 --- /dev/null +++ b/api-reference/v1.0/resources/security-citation.md @@ -0,0 +1,47 @@ +--- +title: "citation resource type" +description: "Represents the file plan descriptor of type citation applied to a particular retention label." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: resourcePageType +--- + +# citation resource type + +Namespace: microsoft.graph.security + +Represents a file plan descriptor that specifies a rule or regulation created by a jurisdiction to determine whether certain content should be retained or deleted. Used to supplement a [retention label](security-retentionlabel.md) for [record management purposes](security-recordsmanagement-overview.md). + +To create, get, or delete a **citation** descriptor, use the [citationTemplate](security-citationtemplate.md) resource. + +This resource is one of a set of file plan descriptors that an administrator can choose to supplement a retention label. To find out more about these optional descriptors, and how to get the descriptors that have been chosen for a retention label, see [file plan descriptor](security-fileplandescriptor.md). + +Inherits from [microsoft.graph.security.filePlanDescriptorBase](../resources/security-fileplandescriptorBase.md). + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|citationJurisdiction|String|Represents the jurisdiction or agency that published the citation.| +|citationUrl|String|Represents the URL to the published citation.| +|displayName|String|Unique string that defines a citation name. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| + +## Relationships +None. + +## JSON representation +Here's a JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.security.citation", + "displayName": "String", + "citationUrl": "String", + "citationJurisdiction": "String" +} +``` + diff --git a/api-reference/v1.0/resources/security-citationtemplate.md b/api-reference/v1.0/resources/security-citationtemplate.md new file mode 100644 index 00000000000..eeeaaa290d9 --- /dev/null +++ b/api-reference/v1.0/resources/security-citationtemplate.md @@ -0,0 +1,62 @@ +--- +title: "citationTemplate resource type" +description: "The specific rule or regulation created by a jurisdiction used to determine whether certain labels and content should be retained or deleted." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: resourcePageType +--- + +# citationTemplate resource type + +Namespace: microsoft.graph.security + +Supports CRUD operations to apply and manage the [citation](security-citation.md) descriptor for a [retentionLabel](security-retentionlabel.md). The **citation** file plan descriptor supplements a retention label to improve the manageability and organization of Microsoft 365 content. + +Inherits from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). + +## Methods +|Method|Return type|Description| +|:---|:---|:---| +|[List citations](../api/security-labelsroot-list-citations.md)|[microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md) collection|Get a list of the [microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md) objects and their properties.| +|[Create citations](../api/security-labelsroot-post-citations.md)|[microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md)|Create a new [microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md) object.| +|[Get citations](../api/security-citationtemplate-get.md)|[microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md)|Read the properties and relationships of a [microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md) object.| +|[Delete citations](../api/security-labelsroot-delete-citations.md)|None|Delete a [microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md) object.| + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|citationJurisdiction|String|Represents the jurisdiction or agency that published the citation.| +|citationUrl|String|Represents the URL to the published citation.| +|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the citation descriptor. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|createdDateTime|DateTimeOffset|Represents the date and time in which the citation descriptor is created. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|displayName|String|Unique string that defines a citation name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md).| +|id|String|Unique ID of the citation. Inherited from [microsoft.graph.entity](../resources/entity.md). Read-only.| + +## Relationships +None. + +## JSON representation +Here's a JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.security.citationTemplate", + "id": "String (identifier)", + "displayName": "String", + "createdBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "createdDateTime": "String (timestamp)", + "citationUrl": "String", + "citationJurisdiction": "String" +} +``` + diff --git a/api-reference/v1.0/resources/security-department.md b/api-reference/v1.0/resources/security-department.md new file mode 100644 index 00000000000..08e1eaf7abb --- /dev/null +++ b/api-reference/v1.0/resources/security-department.md @@ -0,0 +1,43 @@ +--- +title: "department resource type" +description: "Represents the file plan descriptor of type department applied to a particular retention label." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: resourcePageType +--- + +# department resource type + +Namespace: microsoft.graph.security + +Represents a file plan descriptor that specifies the department or business unit of an organization to which a [retention label](security-retentionlabel.md) applies. Used to supplement a retention label for [record management purposes](security-recordsmanagement-overview.md). + +To create, get, or delete a **department** descriptor, use the [departmentTemplate](security-departmenttemplate.md) resource. + +This resource is one of a set of file plan descriptors that an administrator can choose to supplement a retention label. To find out more about these optional descriptors, and how to get the descriptors that have been chosen for a retention label, see [file plan descriptor](security-fileplandescriptor.md). + +Inherits from [microsoft.graph.security.filePlanDescriptorBase](../resources/security-fileplandescriptorBase.md). + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|displayName|String|Unique string that defines a department name. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| + +## Relationships +None. + +## JSON representation +Here's a JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.security.department", + "displayName": "String" +} +``` + diff --git a/api-reference/v1.0/resources/security-departmenttemplate.md b/api-reference/v1.0/resources/security-departmenttemplate.md new file mode 100644 index 00000000000..b70fb99a1d2 --- /dev/null +++ b/api-reference/v1.0/resources/security-departmenttemplate.md @@ -0,0 +1,58 @@ +--- +title: "departmentTemplate resource type" +description: "Specifies the department or business unit of an organization to which a label belongs." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: resourcePageType +--- + +# departmentTemplate resource type + +Namespace: microsoft.graph.security + +Supports CRUD operations to apply and manage the [department](security-department.md) descriptor for a [retentionLabel](security-retentionlabel.md). The **department** file plan descriptor supplements a retention label to improve the manageability and organization of Microsoft 365 content. + +Inherits from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). + +## Methods +|Method|Return type|Description| +|:---|:---|:---| +|[List departments](../api/security-labelsroot-list-departments.md)|[microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md) collection|Get a list of the [microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md) objects and their properties.| +|[Create departments](../api/security-labelsroot-post-departments.md)|[microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md)|Create a new [microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md) object.| +|[Get departments](../api/security-departmenttemplate-get.md)|[microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md)|Read the properties and relationships of a [microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md) object.| +|[Delete departments](../api/security-labelsroot-delete-departments.md)|None|Delete a [microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md) object.| + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the department descriptor. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|createdDateTime|DateTimeOffset|Represents the date and time in which the department descriptor is created. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|displayName|String|Unique string that defines a department name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md).| +|id|String|Unique ID of the department. Inherited from [microsoft.graph.entity](../resources/entity.md). Read-only.| + +## Relationships +None. + +## JSON representation +Here's a JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.security.departmentTemplate", + "id": "String (identifier)", + "displayName": "String", + "createdBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "createdDateTime": "String (timestamp)" +} +``` + diff --git a/api-reference/v1.0/resources/security-dispositionreviewstage.md b/api-reference/v1.0/resources/security-dispositionreviewstage.md new file mode 100644 index 00000000000..e2d95660ba7 --- /dev/null +++ b/api-reference/v1.0/resources/security-dispositionreviewstage.md @@ -0,0 +1,56 @@ +--- +title: "dispositionReviewStage resource type" +description: "Represents a multi-level review process where the reviewers indicate at each stage of the disposition whether to delete or further retain the content item.." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "compliance" +doc_type: resourcePageType +--- + +# dispositionReviewStage resource type + +Namespace: microsoft.graph.security + +Represents a multi-level review process where the reviewers indicate at each stage of the disposition whether to delete or further retain the content item. +For details, see [Disposition of content](/microsoft-365/compliance/disposition). + +## Methods +|Method|Return type|Description| +|:---|:---|:---| +|[Create retentionLabel](../api/security-labelsroot-post-retentionlabel.md)|[microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md)|Create a new [retentionLabel](../resources/security-retentionlabel.md) object. | +|[Update retentionLabel](../api/security-retentionlabel-update.md)|[microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md)|Update the [retentionLabel](../resources/security-retentionlabel.md) object. | + + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|id|String|Unique ID for each stage. | +|name|String|Name representing each stage within a collection. | +|reviewersEmailAddresses|String collection|A collection of reviewers at each stage. | +|stageNumber|Int32|The sequence number for each stage of the disposition review. | + + +## Relationships +None. + +## JSON representation +Here's a JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.security.dispositionReviewStage", + "id": "String (identifier)", + "stageNumber": "Integer", + "name": "String", + "reviewersEmailAddresses": [ + "String" + ] +} +``` diff --git a/api-reference/v1.0/resources/security-fileplandescriptor.md b/api-reference/v1.0/resources/security-fileplandescriptor.md new file mode 100644 index 00000000000..cdf8d13eb4a --- /dev/null +++ b/api-reference/v1.0/resources/security-fileplandescriptor.md @@ -0,0 +1,78 @@ +--- +title: "filePlanDescriptor resource type" +description: "Represents a set of optional descriptors to supplement a retention label and improve the manageability and organization of content in Microsoft 365 for an organization." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: resourcePageType +--- + +# filePlanDescriptor resource type + +Namespace: microsoft.graph.security + +Represents a _set_ of optional descriptors to supplement a [retention label](security-retentionlabel.md) and improve the manageability and organization of Microsoft 365 content. + +You can add a descriptor by using the POST operation of the corresponding file plan descriptor _template_, and specifying data for the descriptor. For example, to include a [citation](security-citation.md) descriptor, use the [create citationTemplate](../api/security-labelsroot-post-citations.md) operation. Similarly, you can use the GET or DELETE operations on the template resource for the descriptor. + +To list the descriptors that supplement a retention label, use the [GET](../api/security-retentionlabel-get.md) operation on that [retentionLabel](security-retentionlabel.md) resource and apply `$expand` on the **descriptors** relationship. + +For information on how retention labels and file plan descriptors work in the [Microsoft Purview compliance portal](https://compliance.microsoft.com/), see [Use file plan to create and manage retention labels](/purview/file-plan-manager). + +Inherits from [microsoft.graph.entity](../resources/entity.md). + +## Methods +None. + + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|authority|[microsoft.graph.security.authority](../resources/security-authority.md)|Represents the file plan descriptor of type authority applied to a particular retention label.| +|appliedcategory|[microsoft.graph.security.appliedCategory](../resources/security-appliedcategory.md)|Represents the file plan descriptor of type category applied to a particular retention label.| +|citation|[microsoft.graph.security.citation](../resources/security-citation.md)|Represents the file plan descriptor of type citation applied to a particular retention label.| +|department|[microsoft.graph.security.department](../resources/security-department.md)|Represents the file plan descriptor of type department applied to a particular retention label.| +|filePlanReference|[microsoft.graph.security.filePlanReference](../resources/security-fileplanreference.md)|Represents the file plan descriptor of type filePlanReference applied to a particular retention label.  | + + +## Relationships +|Relationship|Type|Description| +|:---|:---|:---| +|authorityTemplate|[microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md)| Specifies the underlying authority that describes the type of content to be retained and its retention schedule.| +|categoryTemplate|[microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md)|Specifies a group of similar types of content in a particular department.| +|citationTemplate|[microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md)|The specific rule or regulation created by a jurisdiction used to determine whether certain labels and content should be retained or deleted. | +|departmentTemplate|[microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md)|Specifies the department or business unit of an organization to which a label belongs.| +|filePlanReferenceTemplate|[microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md)|Specifies a unique alpha-numeric identifier for an organization’s retention schedule.| + +## JSON representation +Here's a JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.security.filePlanDescriptor", + "id": "String (identifier)", + "authority": { + "@odata.type": "microsoft.graph.security.authority" + }, + "category": { + "@odata.type": "microsoft.graph.security.appliedCategory" + }, + "citation": { + "@odata.type": "microsoft.graph.security.citation" + }, + "department": { + "@odata.type": "microsoft.graph.security.department" + }, + "filePlanReference": { + "@odata.type": "microsoft.graph.security.filePlanReference" + } +} +``` + diff --git a/api-reference/v1.0/resources/security-fileplandescriptorbase.md b/api-reference/v1.0/resources/security-fileplandescriptorbase.md new file mode 100644 index 00000000000..8c19938f292 --- /dev/null +++ b/api-reference/v1.0/resources/security-fileplandescriptorbase.md @@ -0,0 +1,37 @@ +--- +title: "filePlanDescriptorBase resource type" +description: "Specifies properties common to file plan descriptor resources." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: resourcePageType +--- + +# filePlanDescriptorBase resource type + +Namespace: microsoft.graph.security + +Specifies properties common to file plan descriptor resources. Base type for each of the descriptors: [appliedCategory](security-appliedcategory.md), [authority](security-authority.md), [citation](security-citation.md), [department](security-department.md), [filePlanReference](security-fileplanreference.md), and [subCategory](security-subcategory.md). + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|displayName|String|Unique string that defines the name for the file plan descriptor associated with a particular retention label.| + +## Relationships +None. + +## JSON representation +Here's a JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.security.filePlanDescriptorBase", + "displayName": "String" +} +``` + diff --git a/api-reference/v1.0/resources/security-fileplandescriptortemplate.md b/api-reference/v1.0/resources/security-fileplandescriptortemplate.md new file mode 100644 index 00000000000..4c4f543c10c --- /dev/null +++ b/api-reference/v1.0/resources/security-fileplandescriptortemplate.md @@ -0,0 +1,53 @@ +--- +title: "filePlanDescriptorTemplate resource type" +description: "Specifies the properties common to the template resources for file plan descriptors." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: resourcePageType +--- + +# filePlanDescriptorTemplate resource type + +Namespace: microsoft.graph.security + +Specifies the properties common to the template resources for file plan descriptors. Base type for each of the template resources: [authorityTemplate](security-authoritytemplate.md), [categoryTemplate](security-categorytemplate.md), [citationTemplate](security-citationtemplate.md), [departmentTemplate](security-departmenttemplate.md), [filePlanReferenceTemplate](security-fileplanreferencetemplate.md), and [subCategoryTemplate](security-subcategorytemplate.md). + +Inherits from [microsoft.graph.entity](../resources/entity.md). + +## Methods +None. + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the filePlanDescriptorTemplate column.| +|createdDateTime|DateTimeOffset|Represents the date and time in which the filePlanDescriptorTemplate is created.| +|displayName|String|Unique string that defines a filePlanDescriptorTemplate name.| +|id|String|Unique ID of the filePlanDecriptorTemplate column. Inherited from [microsoft.graph.entity](../resources/entity.md).| + +## Relationships +None. + +## JSON representation +Here's a JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.security.filePlanDescriptorTemplate", + "id": "String (identifier)", + "displayName": "String", + "createdBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "createdDateTime": "String (timestamp)" +} +``` + diff --git a/api-reference/v1.0/resources/security-fileplanreference.md b/api-reference/v1.0/resources/security-fileplanreference.md new file mode 100644 index 00000000000..d61e743ae2f --- /dev/null +++ b/api-reference/v1.0/resources/security-fileplanreference.md @@ -0,0 +1,43 @@ +--- +title: "filePlanReference resource type" +description: "Represents the file plan descriptor of a reference ID, supplementing a specified retention label." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: resourcePageType +--- + +# filePlanReference resource type + +Namespace: microsoft.graph.security + +Represents a file plan descriptor that specifies a unique alpha-numeric identifier for an organization’s retention schedule. Used to supplement a [retention label](security-retentionlabel.md) for [record management purposes](security-recordsmanagement-overview.md). + +To create, get, or delete a **filePlanReference** descriptor, use the [filePlanReferenceTemplate](security-fileplanreferencetemplate.md) resource. + +This resource is one of a set of file plan descriptors that an administrator can choose to supplement a retention label. To find out more about these optional descriptors, and how to get the descriptors that have been chosen for a retention label, see [file plan descriptor](security-fileplandescriptor.md). + +Inherits from [microsoft.graph.security.filePlanDescriptorBase](../resources/security-fileplandescriptorBase.md). + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|displayName|String|Unique string that defines a reference ID. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| + +## Relationships +None. + +## JSON representation +Here's a JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.security.filePlanReference", + "displayName": "String" +} +``` + diff --git a/api-reference/v1.0/resources/security-fileplanreferencetemplate.md b/api-reference/v1.0/resources/security-fileplanreferencetemplate.md new file mode 100644 index 00000000000..877718712d5 --- /dev/null +++ b/api-reference/v1.0/resources/security-fileplanreferencetemplate.md @@ -0,0 +1,58 @@ +--- +title: "filePlanReferenceTemplate resource type" +description: "Specifies a unique alpha-numeric identifier for an organization’s retention schedule." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: resourcePageType +--- + +# filePlanReferenceTemplate resource type + +Namespace: microsoft.graph.security + +Supports CRUD operations to apply and manage the [filePlanReference](security-fileplanreference.md) descriptor for a [retentionLabel](security-retentionlabel.md). The **filePlanReference** descriptor supplements a retention label to improve the manageability and organization of Microsoft 365 content. + +Inherits from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). + +## Methods +|Method|Return type|Description| +|:---|:---|:---| +|[List filePlanReferences](../api/security-labelsroot-list-fileplanreferences.md)|[microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) collection|Get a list of the [microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) objects and their properties.| +|[Create filePlanReferences](../api/security-labelsroot-post-fileplanreferences.md)|[microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md)|Create a new [microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) object.| +|[Get filePlanReferences](../api/security-fileplanreferencetemplate-get.md)|[microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md)|Read the properties and relationships of a [microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) object.| +|[Delete filePlanReferences](../api/security-labelsroot-delete-fileplanreferences.md)|None|Delete a [microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) object.| + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the file plan reference descriptor. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|createdDateTime|DateTimeOffset|Represents the date and time in which the filePlanReference descriptor is created. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|displayName|String|Unique string that defines a filePlanReference name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md).| +|id|String|Unique ID of the filePlanReference. Inherited from [microsoft.graph.entity](../resources/entity.md). Read-only.| + +## Relationships +None. + +## JSON representation +Here's a JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.security.filePlanReferenceTemplate", + "id": "String (identifier)", + "displayName": "String", + "createdBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "createdDateTime": "String (timestamp)" +} +``` + diff --git a/api-reference/v1.0/resources/security-labelsroot.md b/api-reference/v1.0/resources/security-labelsroot.md new file mode 100644 index 00000000000..278a0457704 --- /dev/null +++ b/api-reference/v1.0/resources/security-labelsroot.md @@ -0,0 +1,68 @@ +--- +title: "labelsRoot resource type" +description: "A root resource for capabilities that support records management for Microsoft 365 data in an organization." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: resourcePageType +--- + +# labelsRoot resource type + +Namespace: microsoft.graph.security + +A root resource for capabilities that support records management for Microsoft 365 data in an organization. + +Those capabilities include using a [retention label](security-retentionlabel.md) to configure retention and deletion settings for a type of content in the Microsoft 365 data, and using one or more [file plan descriptors](security-fileplandescriptor.md) to supplement the retention label and provide additional options to better manage and organize the content. + +Inherits from [microsoft.graph.entity](../resources/entity.md). + +## Methods +|Method|Return type|Description| +|:---|:---|:---| +|[List retentionLabels](../api/security-labelsroot-list-retentionlabel.md)|[microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md) collection |Get a list of the [retentionLabel](../resources/security-retentionlabel.md) objects and their properties.| +|[Create retentionLabel](../api/security-labelsroot-post-retentionlabel.md)|[microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md)|Create a new [retentionLabel](../resources/security-retentionlabel.md) object.| +|[List authorities](../api/security-labelsroot-list-authorities.md)|[microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md) collection|Get the authorityTemplate resources from the authorities navigation property.| +|[Create authorities](../api/security-labelsroot-post-authorities.md)|[microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md)|Create a new authorityTemplate object.| +|[List categories](../api/security-labelsroot-list-categories.md)|[microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) collection|Get the categoryTemplate resources from the categories navigation property.| +|[Create categories](../api/security-labelsroot-post-categories.md)|[microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md)|Create a new categoryTemplate object.| +|[List citations](../api/security-labelsroot-list-citations.md)|[microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md) collection|Get the citationTemplate resources from the citations navigation property.| +|[Create citations](../api/security-labelsroot-post-citations.md)|[microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md)|Create a new citationTemplate object.| +|[List departments](../api/security-labelsroot-list-departments.md)|[microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md) collection|Get the departmentTemplate resources from the departments navigation property.| +|[Create departments](../api/security-labelsroot-post-departments.md)|[microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md)|Create a new departmentTemplate object.| +|[List filePlanReferences](../api/security-labelsroot-list-fileplanreferences.md)|[microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) collection|Get the filePlanReferenceTemplate resources from the filePlanReferences navigation property.| +|[Create filePlanReferences](../api/security-labelsroot-post-fileplanreferences.md)|[microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md)|Create a new filePlanReferenceTemplate object.| + +## Properties +None. + + + +## Relationships +|Relationship|Type|Description| +|:---|:---|:---| +|authorities|[microsoft.graph.security.authorityTemplate](../resources/security-authoritytemplate.md) collection|Specifies the underlying authority that describes the type of content to be retained and its retention schedule.| +|categories|[microsoft.graph.security.categoryTemplate](../resources/security-categorytemplate.md) collection|Specifies a group of similar types of content in a particular department.| +|citations|[microsoft.graph.security.citationTemplate](../resources/security-citationtemplate.md) collection|The specific rule or regulation created by a jurisdiction used to determine whether certain labels and content should be retained or deleted.| +|departments|[microsoft.graph.security.departmentTemplate](../resources/security-departmenttemplate.md) collection|Specifies the department or business unit of an organization to which a label belongs.| +|filePlanReferences|[microsoft.graph.security.filePlanReferenceTemplate](../resources/security-fileplanreferencetemplate.md) collection|Specifies a unique alpha-numeric identifier for an organization’s retention schedule.| +|retentionLabels|[microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md) collection|Represents how customers can manage their data, whether and for how long to retain or delete it.| + + +## JSON representation +Here's a JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.security.labelsRoot", + "id": "String (identifier)" +} +``` + diff --git a/api-reference/v1.0/resources/security-recordsmanagement-overview.md b/api-reference/v1.0/resources/security-recordsmanagement-overview.md index 1c84b6baf66..94be1a91d34 100644 --- a/api-reference/v1.0/resources/security-recordsmanagement-overview.md +++ b/api-reference/v1.0/resources/security-recordsmanagement-overview.md @@ -9,23 +9,35 @@ doc_type: conceptualPageType # Use the Microsoft Graph records management APIs -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] +The Microsoft Purview records management APIs help organizations manage retention and deletion of data to meet their legal obligations and compliance regulations, and increases efficiency by enabling the regular disposition of items that no longer have to be retained. -The Microsoft Purview Records Management APIs help organizations manage retention and deletion of data to meet their legal obligations and compliance regulations. The APIs increase efficiency by enabling the regular disposition of items that no longer have to be retained. +## Manage retention labels +Many organizations need to manage their data to comply with industry regulations and internal policies, reduce risks of litigation or security breach, and let their employees effectively and agiley share knowledge that is current and relevant to them. Managing data commonly involves appropriately retaining or deleting different types of content. -The records management solution is a part of the Microsoft Purview compliance portal. +You can use [retention labels](security-retentionlabel.md) to configure retention and deletion settings for Microsoft 365 content. For example, you can set retention periods from when the content was labeled and you can set disposition review as the action at the end of the retention period. + +In addition, you can use [file plan descriptors](security-fileplandescriptor.md) to supplement a retention label and improve the manageability and organization of Microsoft 365 content. Examples of file plan descriptors include [authority](security-authority.md), [citation](security-citation.md), and [department](security-department.md). ## Trigger events for an existing label -When an employee leaves a company, information is updated in the HR management system. From the leave date, confidential documents need to be retained for a period for seven years. These documents have the label `Employee_departure` applied. +Some scenarios require starting a retention period for certain documents upon a specific event, such as an employee leaving an organization, a contract expiring, or the fiscal year ending. + +You can use the [retentionLabel](security-retentionlabel.md) resource to support event-based retention, by setting the **retentionTrigger** property as `dateOfEvent` and associating the label with a [retentionEventType](security-retentioneventtype.md) resource. A [retentionEvent](security-retentionevent.md) is associated with a **retentionEventType** as well. When a triggering event happens, only content with that retention label applied is retained for the specified retention period. -Developers and compliance administrators can use records management APIs to read the label `Employee_departure` and look up the associated event type `Event-employee_departure`. +As an example: in an organization, when an employee leaves, employment records must be retained for 5 years. Use the **retentionLabel** and **retentionEvent** APIs to do the following for each employee record when the employee starts: +1. Apply a **retentionLabel** configured as follows: + - A display name of "Personnel information" + - A **retentionDuration** of 1827 days (5 years) + - Listening to the **retentionEventType** named "Employee departure" +2. Define a **retentionEvent** with the same **retentionEventType** named "Employee departure", and as part of its [eventQuery](security-eventquery.md) collection, an `Asset ID` with an employee ID value as the ID information associated with the event. -Compliance admins can use records management APIs to create an event for the associated event type. The retention period for the confidential documents starts after the creation of this event. +When an employee with an ID of 1234 leaves Contoso, the information is updated in the HR management system. The employee departure can trigger a new instance of **retentionEvent** with the "Employee departure" event type, and as part of its **eventQueries** property, an [eventQuery](security-eventquery.md) with a query string of 'AssetID:1234'. This way, employee record items using the "Personnel information" retention label and associated with the employee ID of 1234 get their 5 year retention period started from the date of the employee departure event. ## Entities The records management API includes the following key entities. | Name | Type | Use case | |:-|:-|:-| +| Label | [microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md) | Contains retention settings and actions that can be applied to an item at the end of a period. | +| File plan descriptors |[microsoft.graph.securty.fileplandescriptor](../resources/security-fileplandescriptor.md) | Represents a set of optional descriptors to supplement a retention label and improve their manageability for an organization. | | Retention event | [microsoft.graph.security.retentionEvent](../resources/security-retentionevent.md) | Represents a trigger for event-based retention, where a retention period starts after the event occurs. | | Retention event type | [microsoft.graph.security.retentionEventType](../resources/security-retentioneventtype.md) | Represents a single group for the same type of retention events. | diff --git a/api-reference/v1.0/resources/security-retentionduration.md b/api-reference/v1.0/resources/security-retentionduration.md new file mode 100644 index 00000000000..40d39133a3b --- /dev/null +++ b/api-reference/v1.0/resources/security-retentionduration.md @@ -0,0 +1,38 @@ +--- +title: "retentionDuration resource type" +description: "An abstract type that represents how long an item will be retained before it can be deleted." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: resourcePageType +--- + +# retentionDuration resource type + +Namespace: microsoft.graph.security + +An abstract type that represents how long an item will be retained before it can be deleted. + +Base type of +[retentionDurationForever](../resources/security-retentiondurationforever.md) and [retentionDurationInDays](../resources/security-retentiondurationindays.md). + +## Properties +None. + +## Relationships +None. + +## JSON representation for retentionDuration +Here's a JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.security.retentionDuration" +} +``` + + diff --git a/api-reference/v1.0/resources/security-retentiondurationforever.md b/api-reference/v1.0/resources/security-retentiondurationforever.md new file mode 100644 index 00000000000..e1fcbad2f3a --- /dev/null +++ b/api-reference/v1.0/resources/security-retentiondurationforever.md @@ -0,0 +1,36 @@ +--- +title: "retentionDurationForever resource type" +description: "Represents that content will be retained permanently and will not be deleted." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: resourcePageType +--- + +# retentionDurationForever resource type + +Namespace: microsoft.graph.security + +Indicates that content will be retained permanently and will not be deleted. + + +Inherits from [retentionDuration](../resources/security-retentionduration.md). + +## Properties +None. + +## Relationships +None. + +## JSON representation +Here's a JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.security.retentionDurationForever" +} +``` diff --git a/api-reference/v1.0/resources/security-retentiondurationindays.md b/api-reference/v1.0/resources/security-retentiondurationindays.md new file mode 100644 index 00000000000..95f76fdd25b --- /dev/null +++ b/api-reference/v1.0/resources/security-retentiondurationindays.md @@ -0,0 +1,39 @@ +--- +title: "retentionDurationInDays resource type" +description: "Represents the number of days an item will be retained before it can be deleted" +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: resourcePageType +--- + +# retentionDurationInDays resource type + +Namespace: microsoft.graph.security + +Represents the number of days an item will be retained before it can be deleted. + + +Inherits from [retentionDuration](../resources/security-retentionduration.md). + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|days|Int32|Specifies the time period in days for which an item with the applied retention label will be retained for.| + +## Relationships +None. + +## JSON representation +Here's a JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.security.retentionDurationInDays", + "days": "Integer" +} +``` diff --git a/api-reference/v1.0/resources/security-retentionlabel.md b/api-reference/v1.0/resources/security-retentionlabel.md new file mode 100644 index 00000000000..390c5e8e82d --- /dev/null +++ b/api-reference/v1.0/resources/security-retentionlabel.md @@ -0,0 +1,98 @@ +--- +title: "retentionLabel resource type" +description: "Represents how customers can manage their data at an item level (email or document), including whether and for how long to retain or delete the item." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: resourcePageType +--- + +# retentionLabel resource type + +Namespace: microsoft.graph.security + +Represents how organizations, for compliance and governance purposes, can manage their data at an item level (email or document), including whether and for how long to retain or delete the item. + +Organizations can use retention labels for different types of content that require different retention settings. For example, they can apply a retention label to tax forms and supporting documents to retain them for the period required by law. + +Organizations can configure retention labels with the retention periods and actions based on factors such as the date last modified or created. They can also start different retention periods by specifying an [event that can trigger retention](security-retentionevent.md) when the event occurs. + +For more information on how retention labels work, when to use them, and how Microsoft Purview supports retention labels to let you configure retention and deletion settings, see [Learn about retention policies and retention labels](/purview/retention). + +## Methods +|Method|Return type|Description| +|:---|:---|:---| +|[List retentionLabels](../api/security-labelsroot-list-retentionlabel.md)|[microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md) collection|Get a list of the [retentionLabel](../resources/security-retentionlabel.md) objects and their properties.| +|[Create retentionLabel](../api/security-labelsroot-post-retentionlabel.md)|[microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md)|Create a new [retentionLabel](../resources/security-retentionlabel.md) object.| +|[Get retentionLabel](../api/security-retentionlabel-get.md)|[microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md)|Read the properties and relationships of a [retentionLabel](../resources/security-retentionlabel.md) object.| +|[Update retentionLabel](../api/security-retentionlabel-update.md)|[microsoft.graph.security.retentionLabel](../resources/security-retentionlabel.md)|Update the properties of a [retentionLabel](../resources/security-retentionlabel.md) object.| +|[Delete retentionLabel](../api/security-retentionlabel-delete.md)|None|Delete a [retentionLabel](../resources/security-retentionlabel.md) object.| +|[List retentionEventType](../api/security-retentioneventtype-list.md)|[microsoft.graph.security.retentionEventType](../resources/security-retentioneventtype.md) collection|Get the retentionEventType resources from the exapnd eventType navigation property.| +|[Add retentionEventType](../api/security-retentioneventtype-post.md)|[microsoft.graph.security.retentionEventType](../resources/security-retentioneventtype.md)|Add eventType by adding the relevant odata property when creating a label.| + + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|actionAfterRetentionPeriod|microsoft.graph.security.actionAfterRetentionPeriod| Specifies the action to take on the labeled document after the period specified by the retentionDuration property expires. The possible values are: `none`, `delete`, `startDispositionReview`, `unknownFutureValue`.| +|behaviorDuringRetentionPeriod|microsoft.graph.security.behaviorDuringRetentionPeriod|Specifies how the behavior of a document with this label should be during the retention period. The possible values are: `doNotRetain`, `retain`, `retainAsRecord`, `retainAsRegulatoryRecord`, `unknownFutureValue`.| +|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the retentionLabel.| +|createdDateTime|DateTimeOffset|Represents the date and time in which the retentionLabel is created.| +|descriptionForAdmins|String|Provides label information for the admin. Optional.| +|descriptionForUsers|String|Provides the label information for the user. Optional.| +|displayName|String|Unique string that defines a label name.| +|id|String|Unique ID of the retentionLabel. [entity](/graph/api/resources/entity).| +|isInUse|Boolean|Specifies whether the label is currently being used.| +|lastModifiedBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|The user who last modified the retentionLabel.| +|lastModifiedDateTime|DateTimeOffset|The latest date time when the retentionLabel was modified.| +|retentionDuration|[microsoft.graph.security.retentionDuration](../resources/security-retentionduration.md)|Specifies the number of days to retain the content.| +|retentionTrigger|microsoft.graph.security.retentionTrigger|Specifies whether the retention duration is calculated from the content creation date, labeled date, or last modification date. The possible values are: `dateLabeled`, `dateCreated`, `dateModified`, `dateOfEvent`, `unknownFutureValue`.| +|defaultRecordBehavior|microsoft.graph.security.defaultRecordBehavior|Specifies the locked or unlocked state of a record label when it is created.The possible values are: `startLocked`, `startUnlocked`, `unknownFutureValue`.| +|labelToBeApplied|String|Specifies the replacement label to be applied automatically after the retention period of the current label ends. | + + +## Relationships +|Relationship|Type|Description| +|:---|:---|:---| +|dispositionReviewStages|[microsoft.graph.security.dispositionReviewStage](../resources/security-dispositionreviewstage.md) collection|When action at the end of retention is chosen as 'dispositionReview', dispositionReviewStages specifies a sequential set of stages with at least one reviewer in each stage.| +|retentionEventType|[microsoft.graph.security.retentionEventType](../resources/security-retentioneventtype.md)|Represents the type associated with a retention event.| +|descriptors|[microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md)|Represents out-of-the-box values that provide more options to improve the manageability and organization of the content you need to label.| + + + +## JSON representation +Here's a JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.security.retentionLabel", + "id": "String (identifier)", + "displayName": "String", + "behaviorDuringRetentionPeriod": "String", + "actionAfterRetentionPeriod": "String", + "retentionTrigger": "String", + "retentionDuration": { + "@odata.type": "microsoft.graph.security.retentionDuration" + }, + "isInUse": "Boolean", + "descriptionForAdmins": "String", + "descriptionForUsers": "String", + "createdBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "createdDateTime": "String (timestamp)", + "lastModifiedBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "lastModifiedDateTime": "String (timestamp)", + "labelToBeApplied": "String", + "defaultRecordBehavior": "String" +} +``` diff --git a/api-reference/v1.0/resources/security-subcategory.md b/api-reference/v1.0/resources/security-subcategory.md new file mode 100644 index 00000000000..714f1136dc9 --- /dev/null +++ b/api-reference/v1.0/resources/security-subcategory.md @@ -0,0 +1,43 @@ +--- +title: "subCategory resource type" +description: "Represents a unique subcategory applied to a retention label." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: resourcePageType +--- + +# subCategory resource type + +Namespace: microsoft.graph.security + +Represents a unique subcategory applied to a [retention label](security-retentionlabel.md). Used to supplement a retention label for [record management purposes](security-recordsmanagement-overview.md). + +To create, get, or delete a **subCategory** descriptor, use the [subCategoryTemplate](security-subcategorytemplate.md) resource. + +This resource is one of a set of file plan descriptors that an administrator can choose to supplement a retention label. To find out more about these optional descriptors, and how to get the descriptors that have been chosen for a retention label, see [file plan descriptor](security-fileplandescriptor.md). + +Inherits from [microsoft.graph.security.filePlanDescriptorBase](../resources/security-fileplandescriptorBase.md). + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|displayName|String|Unique string that defines a subcategory name. Inherited from [microsoft.graph.security.filePlanDescriptor](../resources/security-fileplandescriptor.md).| + +## Relationships +None. + +## JSON representation +Here's a JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.security.subCategory", + "displayName": "String" +} +``` + diff --git a/api-reference/v1.0/resources/security-subcategorytemplate.md b/api-reference/v1.0/resources/security-subcategorytemplate.md new file mode 100644 index 00000000000..e92a47f0dc1 --- /dev/null +++ b/api-reference/v1.0/resources/security-subcategorytemplate.md @@ -0,0 +1,58 @@ +--- +title: "subCategoryTemplate resource type" +description: "Represents the file plan descriptor of type subcategory for retention labels." +author: "sseth" +ms.localizationpriority: medium +ms.prod: "security" +doc_type: resourcePageType +--- + +# subCategoryTemplate resource type + +Namespace: microsoft.graph.security + +Supports CRUD operations to apply and manage the [subCategory](security-subcategory.md) descriptor for a [retentionLabel](security-retentionlabel.md). The **subCategory** file plan descriptor supplements a retention label to improve the manageability and organization of Microsoft 365 content. + +Inherits from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). + +## Methods +|Method|Return type|Description| +|:---|:---|:---| +|[List subCategories](../api/security-categorytemplate-list-subcategories.md)|[microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md) collection|Get a list of the [microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md) objects and their properties.| +|[Create subCategories](../api/security-categorytemplate-post-subcategories.md)|[microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md)|Create a new [microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md) object.| +|[Get subCategories](../api/security-subcategorytemplate-get.md)|[microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md)|Read the properties and relationships of a [microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md) object.| +|[Delete subCategories](../api/security-categorytemplate-delete-subcategories.md)|None|Delete a [microsoft.graph.security.subCategoryTemplate](../resources/security-subcategorytemplate.md) object.| + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|createdBy|[microsoft.graph.identitySet](/graph/api/resources/identityset)|Represents the user who created the subcategory descriptor. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|createdDateTime|DateTimeOffset|Represents the date and time in which the subcategory descriptor is created. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md). Read-only.| +|displayName|String|Unique string that defines a subcategory name. Inherited from [microsoft.graph.security.filePlanDescriptorTemplate](../resources/security-fileplandescriptorTemplate.md).| +|id|String|Unique ID of the subcategory. Inherited from [microsoft.graph.entity](../resources/entity.md). Read-only.| + +## Relationships +None. + +## JSON representation +Here's JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.security.subCategoryTemplate", + "id": "String (identifier)", + "displayName": "String", + "createdBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "createdDateTime": "String (timestamp)" +} +``` + diff --git a/api-reference/v1.0/toc.yml b/api-reference/v1.0/toc.yml index b1ece5ed08b..02d9c61e6c7 100644 --- a/api-reference/v1.0/toc.yml +++ b/api-reference/v1.0/toc.yml @@ -8192,32 +8192,137 @@ items: href: api/alert-update.md - name: Records management items: - - name: Overview - href: resources/security-recordsManagement-overview.md - - name: Retention event - href: resources/security-retentionevent.md - items: + - name: Overview + href: resources/security-recordsmanagement-overview.md + - name: Retention label + href: resources/security-retentionlabel.md + items: + - name: List + href: api/security-labelsroot-list-retentionlabel.md + - name: Create + href: api/security-labelsroot-post-retentionlabel.md + - name: Get + href: api/security-retentionlabel-get.md + - name: Update + href: api/security-retentionlabel-update.md + - name: Delete + href: api/security-retentionlabel-delete.md + - name: File plan descriptors + items: + - name: File plan descriptors + items: + - name: File plan descriptor set + href: resources/security-fileplandescriptor.md + - name: Applied category + href: resources/security-appliedcategory.md + - name: Authority + href: resources/security-authority.md + - name: Citation + href: resources/security-citation.md + - name: Department + href: resources/security-department.md + - name: File plan reference + href: resources/security-fileplanreference.md + - name: Subcategory + href: resources/security-subcategory.md + - name: File plan descriptor templates + items: + - name: Applied category template + items: + - name: Category template + href: resources/security-categorytemplate.md - name: List - href: api/security-retentionevent-list.md + href: api/security-labelsroot-list-categories.md - name: Create - href: api/security-retentionevent-post.md + href: api/security-labelsroot-post-categories.md - name: Get - href: api/security-retentionevent-get.md + href: api/security-categorytemplate-get.md - name: Delete - href: api/security-retentionevent-delete.md - - name: Retention event type - href: resources/security-retentioneventtype.md - items: + href: api/security-labelsroot-delete-categories.md + - name: Authority template + items: + - name: Authority template + href: resources/security-authoritytemplate.md - name: List - href: api/security-retentioneventtype-list.md + href: api/security-labelsroot-list-authorities.md - name: Create - href: api/security-retentioneventtype-post.md + href: api/security-labelsroot-post-authorities.md - name: Get - href: api/security-retentioneventtype-get.md - - name: Update - href: api/security-retentioneventtype-update.md + href: api/security-authoritytemplate-get.md + - name: Delete + href: api/security-labelsroot-delete-authorities.md + - name: Citation template + items: + - name: Citation template + href: resources/security-citationtemplate.md + - name: List + href: api/security-labelsroot-list-citations.md + - name: Create + href: api/security-labelsroot-post-citations.md + - name: Get + href: api/security-citationtemplate-get.md + - name: Delete + href: api/security-labelsroot-delete-citations.md + - name: Department template + items: + - name: Department template + href: resources/security-departmenttemplate.md + - name: List + href: api/security-labelsroot-list-departments.md + - name: Create + href: api/security-labelsroot-post-departments.md + - name: Get + href: api/security-departmenttemplate-get.md + - name: Delete + href: api/security-labelsroot-delete-departments.md + - name: File plan reference template + items: + - name: File plan reference template + href: resources/security-fileplanreferencetemplate.md + - name: List + href: api/security-labelsroot-list-fileplanreferences.md + - name: Create + href: api/security-labelsroot-post-fileplanreferences.md + - name: Get + href: api/security-fileplanreferencetemplate-get.md + - name: Delete + href: api/security-labelsroot-delete-fileplanreferences.md + - name: Subcategory template + items: + - name: Subcategory template + href: resources/security-subcategorytemplate.md + - name: List + href: api/security-categorytemplate-list-subcategories.md + - name: Create + href: api/security-categorytemplate-post-subcategories.md + - name: Get + href: api/security-subcategorytemplate-get.md - name: Delete - href: api/security-retentioneventtype-delete.md + href: api/security-categorytemplate-delete-subcategories.md + - name: Retention event + href: resources/security-retentionevent.md + items: + - name: List + href: api/security-retentionevent-list.md + - name: Create + href: api/security-retentionevent-post.md + - name: Get + href: api/security-retentionevent-get.md + - name: Delete + href: api/security-retentionevent-delete.md + - name: Retention event type + href: resources/security-retentioneventtype.md + items: + - name: List + href: api/security-retentioneventtype-list.md + - name: Create + href: api/security-retentioneventtype-post.md + - name: Get + href: api/security-retentioneventtype-get.md + - name: Update + href: api/security-retentioneventtype-update.md + - name: Delete + href: api/security-retentioneventtype-delete.md - name: Secure score href: resources/securescore.md items: diff --git a/changelog/Microsoft.DirectoryServices.json b/changelog/Microsoft.DirectoryServices.json index 3db9e478fd8..375a3c3e61a 100644 --- a/changelog/Microsoft.DirectoryServices.json +++ b/changelog/Microsoft.DirectoryServices.json @@ -1,5 +1,47 @@ { "changelog": [ + { + "ChangeList": [ + { + "Id": "77c6af58-c093-4350-8664-d2ee116fb949", + "ApiChange": "Enumeration", + "ChangedApiName": "b2bIdentityProvidersType", + "ChangeType": "Addition", + "Description": "Added the **b2bIdentityProvidersType** enumeration type.", + "Target": "b2bIdentityProvidersType" + }, + { + "Id": "77c6af58-c093-4350-8664-d2ee116fb949", + "ApiChange": "Resource", + "ChangedApiName": "defaultInvitationRedemptionIdentityProviderConfiguration", + "ChangeType": "Addition", + "Description": "Added the [defaultInvitationRedemptionIdentityProviderConfiguration](https://learn.microsoft.com/en-us/graph/api/resources/defaultInvitationRedemptionIdentityProviderConfiguration?view=graph-rest-1.0) resource type.", + "Target": "defaultInvitationRedemptionIdentityProviderConfiguration" + }, + { + "Id": "77c6af58-c093-4350-8664-d2ee116fb949", + "ApiChange": "Resource", + "ChangedApiName": "invitationRedemptionIdentityProviderConfiguration", + "ChangeType": "Addition", + "Description": "Added the [invitationRedemptionIdentityProviderConfiguration](https://learn.microsoft.com/en-us/graph/api/resources/invitationRedemptionIdentityProviderConfiguration?view=graph-rest-1.0) resource type.", + "Target": "invitationRedemptionIdentityProviderConfiguration" + }, + { + "Id": "77c6af58-c093-4350-8664-d2ee116fb949", + "ApiChange": "Property", + "ChangedApiName": "invitationRedemptionIdentityProviderConfiguration", + "ChangeType": "Addition", + "Description": "Added the `invitationRedemptionIdentityProviderConfiguration` property to the [crossTenantAccessPolicyConfigurationDefault](https://learn.microsoft.com/en-us/graph/api/resources/crossTenantAccessPolicyConfigurationDefault?view=graph-rest-1.0) resource.", + "Target": "crossTenantAccessPolicyConfigurationDefault" + } + ], + "Id": "77c6af58-c093-4350-8664-d2ee116fb949", + "Cloud": "Prod", + "Version": "v1.0", + "CreatedDateTime": "2024-04-02T16:45:20.304139Z", + "WorkloadArea": "Identity and access", + "SubArea": "Identity and sign-in" + }, { "ChangeList": [ { diff --git a/changelog/Microsoft.Security.RecordsManagement.json b/changelog/Microsoft.Security.RecordsManagement.json index 6829d1f00eb..18c153b4413 100644 --- a/changelog/Microsoft.Security.RecordsManagement.json +++ b/changelog/Microsoft.Security.RecordsManagement.json @@ -10,14 +10,6 @@ "Description": "Added the **actionAfterRetentionPeriod** enumeration type.", "Target": "actionAfterRetentionPeriod" }, - { - "Id": "a8aa5b98-5fb3-4aba-acec-5e85209a4026", - "ApiChange": "EnumType", - "ChangedApiName": "behaviorDuringRetentionPeriod", - "ChangeType": "Addition", - "Description": "Added the **behaviorDuringRetentionPeriod** enumeration type.", - "Target": "behaviorDuringRetentionPeriod" - }, { "Id": "a8aa5b98-5fb3-4aba-acec-5e85209a4026", "ApiChange": "EnumType", @@ -385,59 +377,235 @@ "ChangeList": [ { "Id": "a8aa5b98-5fb3-4aba-acec-5e85209a4026", - "ApiChange": "Permission", - "ChangedApiName": "RecordsManagement.Read.All", + "ApiChange": "Resource", + "ChangedApiName": "retentionLabel", "ChangeType": "Addition", - "Description": "Added support for the application permission `RecordsManagement.Read.All` to the read operations of the [retentionLabel](https://learn.microsoft.com/en-us/graph/api/resources/security-retentionlabel?view=graph-rest-beta) resource.", + "Description": "Added the [retentionLabel](https://learn.microsoft.com/en-us/graph/api/resources/security-retentionLabel?view=graph-rest-v1.0) resource", "Target": "retentionLabel" }, { "Id": "a8aa5b98-5fb3-4aba-acec-5e85209a4026", - "ApiChange": "Permission", - "ChangedApiName": "RecordsManagement.ReadWrite.All", + "ApiChange": "EnumType", + "ChangedApiName": "actionAfterRetentionPeriod", "ChangeType": "Addition", - "Description": "Added support for the application permission `RecordsManagement.ReadWrite.All` to the read operations of the [retentionLabel](https://learn.microsoft.com/en-us/graph/api/resources/security-retentionlabel?view=graph-rest-beta) resource.", - "Target": "retentionLabel" + "Description": "Added the **actionAfterRetentionPeriod** enumeration type.", + "Target": "actionAfterRetentionPeriod" }, { "Id": "a8aa5b98-5fb3-4aba-acec-5e85209a4026", - "ApiChange": "Permission", - "ChangedApiName": "RecordsManagement.Read.All", + "ApiChange": "EnumType", + "ChangedApiName": "behaviorDuringRetentionPeriod", "ChangeType": "Addition", - "Description": "Added support for the application permission `RecordsManagement.Read.All` to the read operations of the [retentionEventType](https://learn.microsoft.com/en-us/graph/api/resources/security-retentioneventtype?view=graph-rest-beta) resource.", - "Target": "retentionEventType" + "Description": "Added the **behaviorDuringRetentionPeriod** enumeration type.", + "Target": "behaviorDuringRetentionPeriod" }, { "Id": "a8aa5b98-5fb3-4aba-acec-5e85209a4026", - "ApiChange": "Permission", - "ChangedApiName": "RecordsManagement.ReadWrite.All", + "ApiChange": "EnumType", + "ChangedApiName": "defaultRecordBehavior", "ChangeType": "Addition", - "Description": "Added support for the application permission `RecordsManagement.ReadWrite.All` to the read operations of the [retentionEventType](https://learn.microsoft.com/en-us/graph/api/resources/security-retentioneventtype?view=graph-rest-beta) resource.", - "Target": "retentionEventType" + "Description": "Added the **defaultRecordBehavior** enumeration type.", + "Target": "defaultRecordBehavior" }, { "Id": "a8aa5b98-5fb3-4aba-acec-5e85209a4026", - "ApiChange": "Permission", - "ChangedApiName": "RecordsManagement.Read.All", + "ApiChange": "EnumType", + "ChangedApiName": "retentionTrigger", "ChangeType": "Addition", - "Description": "Added support for the application permission `RecordsManagement.Read.All` to the read operations of the [retentionEvent](https://learn.microsoft.com/en-us/graph/api/resources/security-retentionevent?view=graph-rest-beta) resource.", - "Target": "retentionEvent" + "Description": "Added the **retentionTrigger** enumeration type.", + "Target": "retentionTrigger" }, { "Id": "a8aa5b98-5fb3-4aba-acec-5e85209a4026", - "ApiChange": "Permission", - "ChangedApiName": "RecordsManagement.ReadWrite.All", + "ApiChange": "Resource", + "ChangedApiName": "retentionDuration", "ChangeType": "Addition", - "Description": "Added support for the application permission `RecordsManagement.ReadWrite.All` to the read operations of the [retentionEvent](https://learn.microsoft.com/en-us/graph/api/resources/security-retentionevent?view=graph-rest-beta) resource.", - "Target": "retentionEvent" - } + "Description": "Added the [retentionDuration](https://learn.microsoft.com/en-us/graph/api/resources/security-retentionDuration?view=graph-rest-v1.0) resource type.", + "Target": "retentionDuration" + }, + { + "Id": "a8aa5b98-5fb3-4aba-acec-5e85209a4026", + "ApiChange": "Resource", + "ChangedApiName": "retentionDurationForever", + "ChangeType": "Addition", + "Description": "Added the [retentionDurationForever](https://learn.microsoft.com/en-us/graph/api/resources/security-retentionDurationForever?view=graph-rest-v1.0) resource type.", + "Target": "retentionDurationForever" + }, + { + "Id": "a8aa5b98-5fb3-4aba-acec-5e85209a4026", + "ApiChange": "Resource", + "ChangedApiName": "retentionDurationInDays", + "ChangeType": "Addition", + "Description": "Added the [retentionDurationInDays](https://learn.microsoft.com/en-us/graph/api/resources/security-retentionDurationInDays?view=graph-rest-v1.0) resource type.", + "Target": "retentionDurationInDays" + }, + { + "Id": "a8aa5b98-5fb3-4aba-acec-5e85209a4026", + "ApiChange": "Resource", + "ChangedApiName": "dispositionReviewStage", + "ChangeType": "Addition", + "Description": "Added the [dispositionReviewStage](https://learn.microsoft.com/en-us/graph/api/resources/security-dispositionReviewStage?view=graph-rest-v1.0) resource", + "Target": "dispositionReviewStage" + }, + { + "Id": "523c6227-aa1d-473f-8c16-50fd37ca12c6", + "ApiChange": "Resource", + "ChangedApiName": "appliedCategory", + "ChangeType": "Addition", + "Description": "Added the [appliedCategory](https://learn.microsoft.com/en-us/graph/api/resources/security-appliedCategory?view=graph-rest-v1.0) resource type.", + "Target": "appliedCategory" + }, + { + "Id": "523c6227-aa1d-473f-8c16-50fd37ca12c6", + "ApiChange": "Resource", + "ChangedApiName": "authority", + "ChangeType": "Addition", + "Description": "Added the [authority](https://learn.microsoft.com/en-us/graph/api/resources/security-authority?view=graph-rest-v1.0) resource type.", + "Target": "authority" + }, + { + "Id": "523c6227-aa1d-473f-8c16-50fd37ca12c6", + "ApiChange": "Resource", + "ChangedApiName": "citation", + "ChangeType": "Addition", + "Description": "Added the [citation](https://learn.microsoft.com/en-us/graph/api/resources/security-citation?view=graph-rest-v1.0) resource type.", + "Target": "citation" + }, + { + "Id": "523c6227-aa1d-473f-8c16-50fd37ca12c6", + "ApiChange": "Resource", + "ChangedApiName": "department", + "ChangeType": "Addition", + "Description": "Added the [department](https://learn.microsoft.com/en-us/graph/api/resources/security-department?view=graph-rest-v1.0) resource type.", + "Target": "department" + }, + { + "Id": "523c6227-aa1d-473f-8c16-50fd37ca12c6", + "ApiChange": "Resource", + "ChangedApiName": "filePlanReference", + "ChangeType": "Addition", + "Description": "Added the [filePlanReference](https://learn.microsoft.com/en-us/graph/api/resources/security-filePlanReference?view=graph-rest-v1.0) resource type.", + "Target": "filePlanReference" + }, + { + "Id": "523c6227-aa1d-473f-8c16-50fd37ca12c6", + "ApiChange": "Resource", + "ChangedApiName": "subCategory", + "ChangeType": "Addition", + "Description": "Added the [subCategory](https://learn.microsoft.com/en-us/graph/api/resources/security-subCategory?view=graph-rest-v1.0) resource type.", + "Target": "subCategory" + }, + { + "Id": "523c6227-aa1d-473f-8c16-50fd37ca12c6", + "ApiChange": "Resource", + "ChangedApiName": "authorityTemplate", + "ChangeType": "Addition", + "Description": "Added the [authorityTemplate](https://learn.microsoft.com/en-us/graph/api/resources/security-authorityTemplate?view=graph-rest-v1.0) resource", + "Target": "authorityTemplate" + }, + { + "Id": "523c6227-aa1d-473f-8c16-50fd37ca12c6", + "ApiChange": "Resource", + "ChangedApiName": "categoryTemplate", + "ChangeType": "Addition", + "Description": "Added the [categoryTemplate](https://learn.microsoft.com/en-us/graph/api/resources/security-categoryTemplate?view=graph-rest-v1.0) resource", + "Target": "categoryTemplate" + }, + { + "Id": "523c6227-aa1d-473f-8c16-50fd37ca12c6", + "ApiChange": "Resource", + "ChangedApiName": "citationTemplate", + "ChangeType": "Addition", + "Description": "Added the [citationTemplate](https://learn.microsoft.com/en-us/graph/api/resources/security-citationTemplate?view=graph-rest-v1.0) resource", + "Target": "citationTemplate" + }, + { + "Id": "523c6227-aa1d-473f-8c16-50fd37ca12c6", + "ApiChange": "Resource", + "ChangedApiName": "departmentTemplate", + "ChangeType": "Addition", + "Description": "Added the [departmentTemplate](https://learn.microsoft.com/en-us/graph/api/resources/security-departmentTemplate?view=graph-rest-v1.0) resource", + "Target": "departmentTemplate" + }, + { + "Id": "523c6227-aa1d-473f-8c16-50fd37ca12c6", + "ApiChange": "Resource", + "ChangedApiName": "filePlanDescriptor", + "ChangeType": "Addition", + "Description": "Added the [filePlanDescriptor](https://learn.microsoft.com/en-us/graph/api/resources/security-filePlanDescriptor?view=graph-rest-v1.0) resource", + "Target": "filePlanDescriptor" + }, + { + "Id": "523c6227-aa1d-473f-8c16-50fd37ca12c6", + "ApiChange": "Resource", + "ChangedApiName": "filePlanDescriptorBase", + "ChangeType": "Addition", + "Description": "Added the [filePlanDescriptorBase](https://learn.microsoft.com/en-us/graph/api/resources/security-filePlanDescriptorBase?view=graph-rest-v1.0) resource type", + "Target": "filePlanDescriptorBaser" + }, + { + "Id": "523c6227-aa1d-473f-8c16-50fd37ca12c6", + "ApiChange": "Resource", + "ChangedApiName": "filePlanDescriptorTemplate", + "ChangeType": "Addition", + "Description": "Added the [filePlanDescriptorTemplate](https://learn.microsoft.com/en-us/graph/api/resources/security-filePlanDescriptorTemplate?view=graph-rest-v1.0) resource", + "Target": "filePlanDescriptorTemplate" + }, + { + "Id": "523c6227-aa1d-473f-8c16-50fd37ca12c6", + "ApiChange": "Resource", + "ChangedApiName": "filePlanReferenceTemplate", + "ChangeType": "Addition", + "Description": "Added the [filePlanReferenceTemplate](https://learn.microsoft.com/en-us/graph/api/resources/security-filePlanReferenceTemplate?view=graph-rest-v1.0) resource", + "Target": "filePlanReferenceTemplate" + }, + { + "Id": "523c6227-aa1d-473f-8c16-50fd37ca12c6", + "ApiChange": "Relationship", + "ChangedApiName": "descriptors", + "ChangeType": "Addition", + "Description": "Added the **descriptors** relationship to the [retentionLabel](https://learn.microsoft.com/en-us/graph/api/resources/security-retentionLabel?view=graph-rest-v1.0) resource.", + "Target": "retentionLabel" + }, + { + "Id": "523c6227-aa1d-473f-8c16-50fd37ca12c6", + "ApiChange": "Resource", + "ChangedApiName": "subCategoryTemplate", + "ChangeType": "Addition", + "Description": "Added the [subCategoryTemplate](https://learn.microsoft.com/en-us/graph/api/resources/security-subCategoryTemplate?view=graph-rest-v1.0) resource", + "Target": "subCategoryTemplate" + }, + { + "Id": "523c6227-aa1d-473f-8c16-50fd37ca12c6", + "ApiChange": "Resource", + "ChangedApiName": "labelsRoot", + "ChangeType": "Addition", + "Description": "Added the [labelsRoot](https://learn.microsoft.com/en-us/graph/api/resources/security-labelsRoot?view=graph-rest-v1.0) resource", + "Target": "labelsRoot" + }, + { + "Id": "523c6227-aa1d-473f-8c16-50fd37ca12c6", + "ApiChange": "GET", + "ChangedApiName": "retentionLabel", + "ChangeType": "Addition", + "Description": "Added the [list](https://learn.microsoft.com/en-us/graph/api/security-labelsroot-list-retentionlabel?view=graph-rest-v1.0) operation to [retentionLabel](https://learn.microsoft.com/en-us/graph/api/resources/security-retentionLabel?view=graph-rest-beta) resource", + "Target": "subCategoryTemplate" + }, + { + "Id": "523c6227-aa1d-473f-8c16-50fd37ca12c6", + "ApiChange": "POST", + "ChangedApiName": "retentionLabel", + "ChangeType": "Addition", + "Description": "Added the [create](https://learn.microsoft.com/en-us/graph/api/security-labelsroot-post-retentionlabel?view=graph-rest-v1.0) operation to [retentionLabel](https://learn.microsoft.com/en-us/graph/api/resources/security-retentionLabel?view=graph-rest-beta) resource", + "Target": "subCategoryTemplate" + } ], - "Id": "a8aa5b98-5fb3-4aba-acec-5e85209a4026", - "Cloud": "Prod", - "Version": "beta", - "CreatedDateTime": "2023-09-26T20:00:41.5572363Z", - "WorkloadArea": "Security", - "SubArea": "Records management" - } + "Id": "523c6227-aa1d-473f-8c16-50fd37ca12c6", + "Cloud": "Prod", + "Version": "v1.0", + "CreatedDateTime": "2023-07-24T14:01:24.5697379Z", + "WorkloadArea": "Security", + "SubArea": "Records management" + } ] } diff --git a/concepts/cloudpc-concept-overview.md b/concepts/cloudpc-concept-overview.md index e46ee10b427..0f490a55f00 100644 --- a/concepts/cloudpc-concept-overview.md +++ b/concepts/cloudpc-concept-overview.md @@ -26,9 +26,9 @@ Create [provisioning policies](/graph/api/resources/cloudpcprovisioningpolicy) a Upload and manage operating system [images](/graph/api/resources/cloudpcdeviceimage) for Cloud PCs to determine which version of Windows with what apps and other image details should be used for Cloud PCs when provisioned. -### View end users’ Cloud PCs and their properties +### View end users' Cloud PCs and their properties -Once provisioned, list and view end users’ [Cloud PCs](/graph/api/resources/cloudpc) and all associated properties. This Cloud PC visibility allows for hands-on management and ease of troubleshooting when needed. +Once provisioned, list and view end users' [Cloud PCs](/graph/api/resources/cloudpc) and all associated properties. This Cloud PC visibility allows for hands-on management and ease of troubleshooting when needed. ## API reference @@ -39,4 +39,5 @@ Looking for the API reference for the service? ## Next step -- Try out the Windows 365 Cloud PC APIs by using [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer). +> [!div class="nextstepaction"] +> [Try the Windows 365 Cloud PC APIs by using [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer) \ No newline at end of file diff --git a/concepts/connecting-external-content-connectors-api-overview.md b/concepts/connecting-external-content-connectors-api-overview.md index 19210be7f04..f610068b966 100644 --- a/concepts/connecting-external-content-connectors-api-overview.md +++ b/concepts/connecting-external-content-connectors-api-overview.md @@ -48,4 +48,5 @@ To learn more, see [Use external groups to manage permissions to Microsoft Graph ## Next step -- [Build a custom connector](/graph/connecting-external-content-build-quickstart) +> [!div class="nextstepaction"] +> [Build a custom connector](/graph/connecting-external-content-build-quickstart) diff --git a/concepts/custom-connector-sdk-sample-overview.md b/concepts/custom-connector-sdk-sample-overview.md index e720669b35a..3ca4ba5dd76 100644 --- a/concepts/custom-connector-sdk-sample-overview.md +++ b/concepts/custom-connector-sdk-sample-overview.md @@ -22,6 +22,7 @@ The sample code included in the [Develop your connector](/graph/custom-connector ![A diagram of the architecture of an SDK-based connector](images/connectors-sdk/architecture.png) -## Next steps +## Next step -* [Develop your connector](/graph/custom-connector-sdk-sample-create) +> [!div class="nextstepaction"] +> [Develop your connector](/graph/custom-connector-sdk-sample-create) diff --git a/concepts/education-concept-overview.md b/concepts/education-concept-overview.md index b96adafbcde..1857efada7f 100644 --- a/concepts/education-concept-overview.md +++ b/concepts/education-concept-overview.md @@ -62,15 +62,13 @@ Looking for the API reference for this service? - [Education API in Microsoft Graph v1.0](/graph/api/resources/education-overview?view=graph-rest-1.0&preserve-view=true) - [Education API in Microsoft Graph beta](/graph/api/resources/education-overview?view=graph-rest-beta&preserve-view=true) -## Next steps +## Related content To start using the education APIs, see: - [Use the roster APIs](/graph/api/resources/education-overview) - [Use the assignment APIs](/graph/api/resources/educationassignment) - [Use the SDS management APIs](/graph/api/resources/educationsynchronizationprofile) -Try the education APIs in [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer) - Explore the following education-related samples: - [.NET sample for SSO & Rostering](https://github.com/OfficeDev/O365-EDU-AspNetMVC-Samples) - [Sample for profile management APIs](https://github.com/OfficeDev/O365-EDU-SDS-AspNetMVC-Samples) diff --git a/concepts/excel-concept-overview.md b/concepts/excel-concept-overview.md index c6fdf3393f6..ef3aa95d8f2 100644 --- a/concepts/excel-concept-overview.md +++ b/concepts/excel-concept-overview.md @@ -51,10 +51,10 @@ Looking for the API reference for this service? - [Excel API in Microsoft Graph v1.0](/graph/api/resources/excel?view=graph-rest-1.0&preserve-view=true) - [Excel API in Microsoft Graph beta](/graph/api/resources/excel?view=graph-rest-beta&preserve-view=true) -## Next steps +## Related content - [Manage sessions in Excel with Microsoft Graph](excel-manage-sessions.md) - [Write to an Excel workbook using Microsoft Graph](excel-write-to-workbook.md) - [Use workbook functions in Excel with Microsoft Graph](excel-use-functions.md) -- [Update a range’s format in Excel with Microsoft Graph](excel-update-range-format.md) +- [Update a range format in Excel with Microsoft Graph](excel-update-range-format.md) - [Display a chart image in Excel with Microsoft Graph](excel-display-chart-image.md) diff --git a/concepts/intune-concept-overview.md b/concepts/intune-concept-overview.md index a0fc2e684f5..bd6185ddfff 100644 --- a/concepts/intune-concept-overview.md +++ b/concepts/intune-concept-overview.md @@ -50,10 +50,8 @@ Looking for the API reference for this service? - [Intune API in Microsoft Graph v1.0](/graph/api/resources/intune-graph-overview?view=graph-rest-1.0&preserve-view=true) - [Intune API in Microsoft Graph beta](/graph/api/resources/intune-graph-overview?view=graph-rest-beta&preserve-view=true) -## Next steps +## Related content - [Use Azure AD to access the Intune API](/intune/intune-graph-apis). - See how to perform common tasks by using the [PowerShell Intune samples](https://github.com/microsoftgraph/powershell-intune-samples). -- Find out how to [use the Intune REST API](/graph/api/resources/intune-graph-overview). -- See the [Changelog](changelog.md) for information about what's new in the Intune API. -- Explore [resources](https://developer.microsoft.com/graph/gallery/) for more ideas about how to use Microsoft Graph. +- Find out how to [use the Intune REST API](/graph/api/resources/intune-graph-overview). \ No newline at end of file diff --git a/concepts/managedtenants-concept-overview.md b/concepts/managedtenants-concept-overview.md index 79b72ba9833..d50388e29c9 100644 --- a/concepts/managedtenants-concept-overview.md +++ b/concepts/managedtenants-concept-overview.md @@ -50,7 +50,7 @@ See [Microsoft 365 Lighthouse API in Microsoft Graph (preview)](/graph/api/resou > The Microsoft 365 Lighthouse API is defined in the OData subnamespace, `microsoft.graph.managedTenants`. -## Next steps +## Related content - Learn more about the [Microsoft 365 Lighthouse](/microsoft-365/lighthouse/m365-lighthouse-overview?view=o365-worldwide&preserve-view=true) portal. - Find out about the [latest new features and updates](/graph/whats-new-overview) for the Lighthouse API. diff --git a/concepts/microsoft365-groups-concept-overview.md b/concepts/microsoft365-groups-concept-overview.md index a62cc99c60d..ffb1d121b6d 100644 --- a/concepts/microsoft365-groups-concept-overview.md +++ b/concepts/microsoft365-groups-concept-overview.md @@ -69,7 +69,7 @@ Looking for the API reference for this service? - [Groups API in Microsoft Graph v1.0](/graph/api/resources/groups-overview?view=graph-rest-1.0&preserve-view=true) - [Groups API in Microsoft Graph beta](/graph/api/resources/groups-overview?view=graph-rest-beta&preserve-view=true) -## Next steps +## Next step -- Try out some sample API requests in [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer). -- Learn more about how to [use the groups API](/graph/api/resources/groups-overview) in Microsoft Graph. +> [!div class="nextstepaction"] +> [Try API requests in Graph Explorer](https://developer.microsoft.com/graph/graph-explorer) diff --git a/concepts/msgraph-onboarding-graphexplorer.md b/concepts/msgraph-onboarding-graphexplorer.md index 957e1b32b99..ccd4d865f5b 100644 --- a/concepts/msgraph-onboarding-graphexplorer.md +++ b/concepts/msgraph-onboarding-graphexplorer.md @@ -61,6 +61,7 @@ Use the following steps to try education API calls in Graph Explorer: 12. Try more queries. For more examples, see the [education API reference content](/graph/api/resources/education-overview). -## Next steps +## Next step -- [Working with education APIs in Microsoft Graph](/graph/api/resources/education-overview) +> [!div class="nextstepaction"] +> [Working with education APIs in Microsoft Graph](/graph/api/resources/education-overview) \ No newline at end of file diff --git a/concepts/msgraph-onboarding-mpn.md b/concepts/msgraph-onboarding-mpn.md index 153ba431af3..aa6c49a5f63 100644 --- a/concepts/msgraph-onboarding-mpn.md +++ b/concepts/msgraph-onboarding-mpn.md @@ -33,7 +33,7 @@ Use the following steps to join Microsoft Partner Network: You can now access [Partner Center](https://partner.microsoft.com/) with your Microsoft Partner Network account. -## Next steps +## Set up your development environment Set up your development environment. You can create two types of EDU tenants: diff --git a/concepts/msgraph-onboarding-msteams.md b/concepts/msgraph-onboarding-msteams.md index cf885793916..57257f03711 100644 --- a/concepts/msgraph-onboarding-msteams.md +++ b/concepts/msgraph-onboarding-msteams.md @@ -35,6 +35,7 @@ To create a team: You have successfully created your team. -## Next steps +## Next step -[Use Graph Explorer](/graph/msgraph-onboarding-graphexplorer) to test Microsoft Graph calls. +> [!div class="nextstepaction"] +> [Use Graph Explorer to test Microsoft Graph API calls](/graph/msgraph-onboarding-graphexplorer) diff --git a/concepts/msgraph-onboarding-sds.md b/concepts/msgraph-onboarding-sds.md index 8c9f0798a32..b0abfe534e3 100644 --- a/concepts/msgraph-onboarding-sds.md +++ b/concepts/msgraph-onboarding-sds.md @@ -44,6 +44,7 @@ To access the School Data Sync admin portal, launch a private web browser, go to ![Screenshot of the profile page](./images/msgraph-onboarding/sds10-settingup.png) -## Next steps +## Next step -- [Set up Microsoft Teams](/graph/msgraph-onboarding-msteams) to set up classes (optional). +> [!div class="nextstepaction"] +> [Set up Microsoft Teams to set up classes](/graph/msgraph-onboarding-msteams) diff --git a/concepts/outlook-calendar-concept-overview.md b/concepts/outlook-calendar-concept-overview.md index 3ba0c3b47de..bfb6a86d626 100644 --- a/concepts/outlook-calendar-concept-overview.md +++ b/concepts/outlook-calendar-concept-overview.md @@ -103,7 +103,7 @@ Looking for the API reference for this service? - [Finding possible meeting times on the Outlook calendar](findmeetingtimes-example.md) - [Getting the free/busy schedule for users and resources](outlook-get-free-busy-schedule.md) -- [Propose meeting times in an Outlook calendar (preview)](outlook-calendar-meeting-proposals.md) +- [Propose meeting times in an Outlook calendar](outlook-calendar-meeting-proposals.md) - [Create or set an event as an online meeting in an Outlook calendar](outlook-calendar-online-meetings.md) - [Scheduling repeating appointments as recurring events in Outlook](outlook-schedule-recurring-events.md) - [Getting shared events](outlook-get-shared-events-calendars.md) diff --git a/concepts/outlook-create-event-in-shared-delegated-calendar.md b/concepts/outlook-create-event-in-shared-delegated-calendar.md index cb440376330..6fce536db9c 100644 --- a/concepts/outlook-create-event-in-shared-delegated-calendar.md +++ b/concepts/outlook-create-event-in-shared-delegated-calendar.md @@ -776,11 +776,7 @@ Content-type: application/json ``` -## Next steps - -Find out more about: +## Related content - [Get Outlook events in a shared or delegated calendar](outlook-get-shared-events-calendars.md) - [Share or delegate a calendar in Outlook (preview)](outlook-share-or-delegate-calendar.md) -- [Why integrate with Outlook calendar](outlook-calendar-concept-overview.md) -- The [calendar API](/graph/api/resources/calendar) in Microsoft Graph v1.0. diff --git a/concepts/outlook-get-shared-events-calendars.md b/concepts/outlook-get-shared-events-calendars.md index 954c4f089e3..7b09465a56a 100644 --- a/concepts/outlook-get-shared-events-calendars.md +++ b/concepts/outlook-get-shared-events-calendars.md @@ -136,11 +136,7 @@ If Alex has shared a _custom_ calendar (as an example, a calendar named "Kids pa On successful completion, you get HTTP 200 OK and the requested event, events, or calendar that Alex has shared with Adele. -## Next steps - -Find out more about: +## Related content - [Create Outlook events in a shared or delegated calendar](outlook-create-event-in-shared-delegated-calendar.md) - [Share or delegate a calendar in Outlook (preview)](outlook-share-or-delegate-calendar.md) -- [Why integrate with Outlook calendar](outlook-calendar-concept-overview.md) -- The [calendar API](/graph/api/resources/calendar?view=graph-rest-1.0&preserve-view=true) in Microsoft Graph v1.0. diff --git a/concepts/outlook-schedule-recurring-events.md b/concepts/outlook-schedule-recurring-events.md index 780af9b7d07..c57148ce812 100644 --- a/concepts/outlook-schedule-recurring-events.md +++ b/concepts/outlook-schedule-recurring-events.md @@ -353,7 +353,7 @@ To create a recurrence rule, you must specify both a pattern and a range. Any pa Because the value of **startDate** is after the first Thursday in August, the first occurrence of this series will be in September. -## Next steps +## Related content - Find out more about [integrating with Outlook calendar](outlook-calendar-concept-overview.md). - See other recurring event examples in the calendar API reference: diff --git a/concepts/outlook-share-or-delegate-calendar.md b/concepts/outlook-share-or-delegate-calendar.md index 9b771478de4..35d7ecfb60f 100644 --- a/concepts/outlook-share-or-delegate-calendar.md +++ b/concepts/outlook-share-or-delegate-calendar.md @@ -744,18 +744,13 @@ HTTP/1.1 204 No Content ``` -## Next steps +## Related content -Find out more about: - -- How the Outlook clients support sharing and delegating calendars: - - [Share an Outlook calendar with other people](https://support.office.com/article/share-an-outlook-calendar-with-other-people-353ed2c1-3ec5-449d-8c73-6931a0adab88 +- [Share an Outlook calendar with other people](https://support.office.com/article/share-an-outlook-calendar-with-other-people-353ed2c1-3ec5-449d-8c73-6931a0adab88 ) - - [Allow someone else to manage your mail and calendar as a delegate](https://support.office.com/article/allow-someone-else-to-manage-your-mail-and-calendar-41c40c04-3bd1-4d22-963a-28eafec25926) - - [Share your calendar in Outlook on the web](https://support.office.com/article/share-your-calendar-in-outlook-on-the-web-7ecef8ae-139c-40d9-bae2-a23977ee58d5) - - [Calendar delegation in Outlook on the web](https://support.office.com/article/calendar-delegation-in-outlook-on-the-web-532e6410-ee80-42b5-9b1b-a09345ccef1b +- [Allow someone else to manage your mail and calendar as a delegate](https://support.office.com/article/allow-someone-else-to-manage-your-mail-and-calendar-41c40c04-3bd1-4d22-963a-28eafec25926) +- [Share your calendar in Outlook on the web](https://support.office.com/article/share-your-calendar-in-outlook-on-the-web-7ecef8ae-139c-40d9-bae2-a23977ee58d5) +- [Calendar delegation in Outlook on the web](https://support.office.com/article/calendar-delegation-in-outlook-on-the-web-532e6410-ee80-42b5-9b1b-a09345ccef1b ) - [Get Outlook events in a shared or delegated calendar](outlook-get-shared-events-calendars.md) - [Create Outlook events in a shared or delegated calendar](outlook-create-event-in-shared-delegated-calendar.md) -- [Why integrate with Outlook calendar](outlook-calendar-concept-overview.md) -- The [calendar API](/graph/api/resources/calendar) in Microsoft Graph beta. diff --git a/concepts/service-communications-concept-overview.md b/concepts/service-communications-concept-overview.md index 0a854112d70..fa246729f03 100644 --- a/concepts/service-communications-concept-overview.md +++ b/concepts/service-communications-concept-overview.md @@ -54,8 +54,5 @@ From the **Message center** dashboard, you can view upcoming changes, including ## Next steps - Try service communications sample queries in [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer/?request=admin%2FserviceAnnouncement%2FhealthOverviews&version=v1.0). - -- Learn more about the [service communications API in v1.0](/graph/api/resources/service-communications-api-overview?view=graph-rest-1.0&preserve-view=true). - -- Learn more about the [service communications API in beta](/graph/api/resources/service-communications-api-overview?view=graph-rest-beta&preserve-view=true). +- Learn more about the [service communications API in v1.0](/graph/api/resources/service-communications-api-overview?view=graph-rest-1.0&preserve-view=true) and the [service communications API in beta](/graph/api/resources/service-communications-api-overview?view=graph-rest-beta&preserve-view=true). diff --git a/concepts/tutorial-access-package-api.md b/concepts/tutorial-access-package-api.md index 0ff79a17864..05f2308d1f5 100644 --- a/concepts/tutorial-access-package-api.md +++ b/concepts/tutorial-access-package-api.md @@ -59,35 +59,35 @@ GET https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/ca ``` # [C#](#tab/csharp) -[!INCLUDE [sample-code](../includes/snippets/csharp/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-csharp-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/csharp/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-csharp-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [CLI](#tab/cli) -[!INCLUDE [sample-code](../includes/snippets/cli/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-cli-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/cli/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-cli-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) -[!INCLUDE [sample-code](../includes/snippets/go/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-go-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/go/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) -[!INCLUDE [sample-code](../includes/snippets/java/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-java-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/java/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-java-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) -[!INCLUDE [sample-code](../includes/snippets/javascript/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-javascript-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/javascript/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) -[!INCLUDE [sample-code](../includes/snippets/php/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-php-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/php/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) -[!INCLUDE [sample-code](../includes/snippets/powershell/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-powershell-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/powershell/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Python](#tab/python) -[!INCLUDE [sample-code](../includes/snippets/python/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-python-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/python/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- @@ -152,35 +152,35 @@ Content-type: application/json ``` # [C#](#tab/csharp) -[!INCLUDE [sample-code](../includes/snippets/csharp/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-csharp-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/csharp/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-csharp-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [CLI](#tab/cli) -[!INCLUDE [sample-code](../includes/snippets/cli/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-cli-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/cli/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-cli-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) -[!INCLUDE [sample-code](../includes/snippets/go/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-go-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/go/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) -[!INCLUDE [sample-code](../includes/snippets/java/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-java-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/java/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-java-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) -[!INCLUDE [sample-code](../includes/snippets/javascript/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-javascript-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/javascript/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) -[!INCLUDE [sample-code](../includes/snippets/php/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-php-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/php/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) -[!INCLUDE [sample-code](../includes/snippets/powershell/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-powershell-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/powershell/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Python](#tab/python) -[!INCLUDE [sample-code](../includes/snippets/python/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-python-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/python/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- @@ -220,40 +220,40 @@ In this step, you retrieve the details of the resources that match the ID of the "blockType": "request", "name": "tutorial_entitlementmanagement_get_accesspackageresources" }--> -```http +```msgraph-interactive GET https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/catalogs/cec5d6ab-c75d-47c0-9c1c-92e89f66e384/resources?$filter=originId eq 'e93e24d1-2b65-4a6c-a1dd-654a12225487' ``` # [C#](#tab/csharp) -[!INCLUDE [sample-code](../includes/snippets/csharp/beta/tutorial-entitlementmanagement-get-accesspackageresources-csharp-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/csharp/v1/tutorial-entitlementmanagement-get-accesspackageresources-csharp-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [CLI](#tab/cli) -[!INCLUDE [sample-code](../includes/snippets/cli/beta/tutorial-entitlementmanagement-get-accesspackageresources-cli-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/cli/v1/tutorial-entitlementmanagement-get-accesspackageresources-cli-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) -[!INCLUDE [sample-code](../includes/snippets/go/beta/tutorial-entitlementmanagement-get-accesspackageresources-go-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/go/v1/tutorial-entitlementmanagement-get-accesspackageresources-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) -[!INCLUDE [sample-code](../includes/snippets/java/beta/tutorial-entitlementmanagement-get-accesspackageresources-java-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/java/v1/tutorial-entitlementmanagement-get-accesspackageresources-java-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) -[!INCLUDE [sample-code](../includes/snippets/javascript/beta/tutorial-entitlementmanagement-get-accesspackageresources-javascript-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/javascript/v1/tutorial-entitlementmanagement-get-accesspackageresources-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) -[!INCLUDE [sample-code](../includes/snippets/php/beta/tutorial-entitlementmanagement-get-accesspackageresources-php-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/php/v1/tutorial-entitlementmanagement-get-accesspackageresources-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) -[!INCLUDE [sample-code](../includes/snippets/powershell/beta/tutorial-entitlementmanagement-get-accesspackageresources-powershell-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/powershell/v1/tutorial-entitlementmanagement-get-accesspackageresources-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Python](#tab/python) -[!INCLUDE [sample-code](../includes/snippets/python/beta/tutorial-entitlementmanagement-get-accesspackageresources-python-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/python/v1/tutorial-entitlementmanagement-get-accesspackageresources-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- @@ -297,40 +297,40 @@ In the request, use the **id** of the catalog and the **id** of the group resour "blockType": "request", "name": "tutorial_entitlementmanagement_get_accesspackageresourceroles" }--> -```http +```msgraph-interactive GET https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/catalogs/ede67938-cda7-4127-a9ca-7c7bf86a19b7/resourceRoles?$filter=(originSystem eq 'AadGroup' and displayName eq 'Member' and resource/id eq '274a1e21c5-8a76-4578-acb1-641160e076e')&$expand=resource ``` # [C#](#tab/csharp) -[!INCLUDE [sample-code](../includes/snippets/csharp/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-csharp-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/csharp/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-csharp-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [CLI](#tab/cli) -[!INCLUDE [sample-code](../includes/snippets/cli/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-cli-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/cli/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-cli-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) -[!INCLUDE [sample-code](../includes/snippets/go/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-go-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/go/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) -[!INCLUDE [sample-code](../includes/snippets/java/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-java-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/java/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-java-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) -[!INCLUDE [sample-code](../includes/snippets/javascript/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-javascript-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/javascript/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) -[!INCLUDE [sample-code](../includes/snippets/php/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-php-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/php/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) -[!INCLUDE [sample-code](../includes/snippets/powershell/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-powershell-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/powershell/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Python](#tab/python) -[!INCLUDE [sample-code](../includes/snippets/python/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-python-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/python/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- @@ -394,35 +394,35 @@ Content-type: application/json ``` # [C#](#tab/csharp) -[!INCLUDE [sample-code](../includes/snippets/csharp/beta/tutorial-entitlementmanagement-create-accesspackage-csharp-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/csharp/v1/tutorial-entitlementmanagement-create-accesspackage-csharp-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [CLI](#tab/cli) -[!INCLUDE [sample-code](../includes/snippets/cli/beta/tutorial-entitlementmanagement-create-accesspackage-cli-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/cli/v1/tutorial-entitlementmanagement-create-accesspackage-cli-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) -[!INCLUDE [sample-code](../includes/snippets/go/beta/tutorial-entitlementmanagement-create-accesspackage-go-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/go/v1/tutorial-entitlementmanagement-create-accesspackage-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) -[!INCLUDE [sample-code](../includes/snippets/java/beta/tutorial-entitlementmanagement-create-accesspackage-java-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/java/v1/tutorial-entitlementmanagement-create-accesspackage-java-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) -[!INCLUDE [sample-code](../includes/snippets/javascript/beta/tutorial-entitlementmanagement-create-accesspackage-javascript-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/javascript/v1/tutorial-entitlementmanagement-create-accesspackage-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) -[!INCLUDE [sample-code](../includes/snippets/php/beta/tutorial-entitlementmanagement-create-accesspackage-php-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/php/v1/tutorial-entitlementmanagement-create-accesspackage-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) -[!INCLUDE [sample-code](../includes/snippets/powershell/beta/tutorial-entitlementmanagement-create-accesspackage-powershell-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/powershell/v1/tutorial-entitlementmanagement-create-accesspackage-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Python](#tab/python) -[!INCLUDE [sample-code](../includes/snippets/python/beta/tutorial-entitlementmanagement-create-accesspackage-python-snippets.md)] +[!INCLUDE [sample-code](../includes/snippets/python/v1/tutorial-entitlementmanagement-create-accesspackage-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --- @@ -453,7 +453,6 @@ Content-type: application/json #### Request -# [HTTP](#tab/http) -```http +```msgraph-interactive GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageAssignmentRequests/a6bb6942-3ae1-4259-9908-0133aaee9377 ``` @@ -831,7 +796,7 @@ You can also use the **id** of the access package policy that you created to see "blockType": "request", "name": "tutorial_entitlementmanagement_get_accesspackageassignment" }--> -```http +```msgraph-interactive GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageAssignments?$filter=accessPackageAssignmentPolicy/Id eq 'db440482-1210-4a60-9b55-3ac7a72f63ba'&$expand=target,accessPackageAssignmentResourceRoles ``` @@ -916,7 +881,7 @@ After the request has been granted, you can use the **id** that you recorded for "blockType": "request", "name": "tutorial_entitlementmanagement_get_group_members" }--> -```http +```msgraph-interactive GET https://graph.microsoft.com/v1.0/groups/f4892fac-e81c-4712-bdf2-a4450008a4b0/members ``` diff --git a/concepts/tutorial-riskdetection-api.md b/concepts/tutorial-riskdetection-api.md index 8748c34a0bd..503f6f2e04b 100644 --- a/concepts/tutorial-riskdetection-api.md +++ b/concepts/tutorial-riskdetection-api.md @@ -465,7 +465,7 @@ Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/python/v1/tutorial-riskdetection-riskyusersdismiss-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] ---- +--- After dismissing the risk user, you can rerun the request in Step 2 and will notice that the **MyTestUser1** user account now has a risk level of `none` and a riskState of `dismissed`. diff --git a/includes/outlook-mailbox-type-support.md b/includes/outlook-mailbox-type-support.md index d5b406d4cfd..e17908a2b72 100644 --- a/includes/outlook-mailbox-type-support.md +++ b/includes/outlook-mailbox-type-support.md @@ -7,6 +7,6 @@ ms.topic: include -The Microsoft Graph API supports accessing data in users' _primary_ mailboxes and in [shared mailboxes](https://support.office.com/article/open-and-use-a-shared-mailbox-in-outlook-d94a8e9e-21f1-4240-808b-de9c9c088afd). The data can be calendar, mail, or personal contacts stored in a mailbox in the cloud on Exchange Online as part of Microsoft 365, or on Exchange on-premises in a [hybrid deployment](/graph/hybrid-rest-support). +The Microsoft Graph API supports accessing data in users' _primary_ mailboxes and in [shared mailboxes](https://support.office.com/article/open-and-use-a-shared-mailbox-in-outlook-d94a8e9e-21f1-4240-808b-de9c9c088afd). The data can be calendar, mail, or personal contacts stored in a mailbox in the cloud on Exchange Online as part of Microsoft 365. The API does _not_ support accessing in-place archive mailboxes, not [on Exchange Online](/office365/servicedescriptions/exchange-online-archiving-service-description/exchange-online-archiving-service-description#feature-availability-across-exchange-online-archiving-plans) nor [on Exchange Server](/exchange/policy-and-compliance/in-place-archiving/in-place-archiving). diff --git a/includes/snippets/cli/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-cli-snippets.md b/includes/snippets/cli/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-cli-snippets.md deleted file mode 100644 index 66ebdc2e7c8..00000000000 --- a/includes/snippets/cli/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-cli-snippets.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```bash - -// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY -mgc-beta identity-governance entitlement-management access-package-catalogs list --filter "(displayName eq 'General')" - -``` \ No newline at end of file diff --git a/includes/snippets/cli/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-cli-snippets.md b/includes/snippets/cli/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-cli-snippets.md deleted file mode 100644 index b0ec9817084..00000000000 --- a/includes/snippets/cli/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-cli-snippets.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```bash - -// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY -mgc-beta identity-governance entitlement-management access-package-catalogs access-package-resource-roles list --access-package-catalog-id {accessPackageCatalog-id} --filter "(originSystem eq 'AadGroup' and accessPackageResource/id eq '4a1e21c5-8a76-4578-acb1-641160e076e8' and displayName eq 'Member')" --expand "accessPackageResource" - -``` \ No newline at end of file diff --git a/includes/snippets/cli/beta/tutorial-entitlementmanagement-get-accesspackageresourcerolescope-cli-snippets.md b/includes/snippets/cli/beta/tutorial-entitlementmanagement-get-accesspackageresourcerolescope-cli-snippets.md deleted file mode 100644 index 6c43b80f063..00000000000 --- a/includes/snippets/cli/beta/tutorial-entitlementmanagement-get-accesspackageresourcerolescope-cli-snippets.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```bash - -// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY -mgc-beta identity-governance entitlement-management access-packages access-package-resource-role-scopes create --access-package-id {accessPackage-id} --body '{ \ - "accessPackageResourceRole": { \ - "originId":"Member_e93e24d1-2b65-4a6c-a1dd-654a12225487", \ - "displayName":"Member", \ - "originSystem":"AadGroup", \ - "accessPackageResource": { \ - "id":"4a1e21c5-8a76-4578-acb1-641160e076e8","resourceType":"Security Group", \ - "originId":"e93e24d1-2b65-4a6c-a1dd-654a12225487","originSystem":"AadGroup" \ - } \ - }, \ - "accessPackageResourceScope": { \ - "originId":"e93e24d1-2b65-4a6c-a1dd-654a12225487","originSystem":"AadGroup" \ - } \ -} \ -' - -``` \ No newline at end of file diff --git a/includes/snippets/cli/beta/tutorial-entitlementmanagement-get-accesspackageresources-cli-snippets.md b/includes/snippets/cli/beta/tutorial-entitlementmanagement-get-accesspackageresources-cli-snippets.md deleted file mode 100644 index 27752730a75..00000000000 --- a/includes/snippets/cli/beta/tutorial-entitlementmanagement-get-accesspackageresources-cli-snippets.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```bash - -// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY -mgc-beta identity-governance entitlement-management access-package-catalogs access-package-resources list --access-package-catalog-id {accessPackageCatalog-id} --filter "(displayName eq 'Marketing resources')" - -``` \ No newline at end of file diff --git a/includes/snippets/cli/beta/tutorial-entitlementmanagement-create-accesspackage-cli-snippets.md b/includes/snippets/cli/v1/tutorial-entitlementmanagement-create-accesspackage-cli-snippets.md similarity index 77% rename from includes/snippets/cli/beta/tutorial-entitlementmanagement-create-accesspackage-cli-snippets.md rename to includes/snippets/cli/v1/tutorial-entitlementmanagement-create-accesspackage-cli-snippets.md index 99d97432a3b..487f00ff5f8 100644 --- a/includes/snippets/cli/beta/tutorial-entitlementmanagement-create-accesspackage-cli-snippets.md +++ b/includes/snippets/cli/v1/tutorial-entitlementmanagement-create-accesspackage-cli-snippets.md @@ -5,7 +5,7 @@ description: "Automatically generated file. DO NOT MODIFY" ```bash // THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY -mgc-beta identity-governance entitlement-management access-packages create --body '{ \ +mgc identity-governance entitlement-management access-packages create --body '{ \ "catalogId": "cec5d6ab-c75d-47c0-9c1c-92e89f66e384", \ "displayName": "Marketing Campaign", \ "description": "Access to resources for the campaign" \ diff --git a/includes/snippets/cli/v1/tutorial-entitlementmanagement-create-group-cli-snippets.md b/includes/snippets/cli/v1/tutorial-entitlementmanagement-create-group-cli-snippets.md deleted file mode 100644 index 74521e258c3..00000000000 --- a/includes/snippets/cli/v1/tutorial-entitlementmanagement-create-group-cli-snippets.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```bash - -// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY -mgc groups create --body '{ \ - "description":"Marketing group", \ - "displayName":"Marketing resources", \ - "mailEnabled":false, \ - "mailNickname":"markres", \ - "securityEnabled":true \ -} \ -' - -``` \ No newline at end of file diff --git a/includes/snippets/cli/v1/tutorial-entitlementmanagement-create-user-cli-snippets.md b/includes/snippets/cli/v1/tutorial-entitlementmanagement-create-user-cli-snippets.md deleted file mode 100644 index 7821c5a802b..00000000000 --- a/includes/snippets/cli/v1/tutorial-entitlementmanagement-create-user-cli-snippets.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```bash - -// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY -mgc users create --body '{ \ - "accountEnabled":true, \ - "displayName":"Requestor1", \ - "mailNickname":"Requestor1", \ - "userPrincipalName":"Requestor1@contoso.com", \ - "passwordProfile": { \ - "forceChangePasswordNextSignIn":true, \ - "password":"Contoso1234" \ - } \ -} \ -' - -``` \ No newline at end of file diff --git a/includes/snippets/cli/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-cli-snippets.md b/includes/snippets/cli/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-cli-snippets.md new file mode 100644 index 00000000000..e93362d559b --- /dev/null +++ b/includes/snippets/cli/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-cli-snippets.md @@ -0,0 +1,10 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```bash + +// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY +mgc identity-governance entitlement-management catalogs list --filter "(displayName eq 'General')" + +``` \ No newline at end of file diff --git a/includes/snippets/cli/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-cli-snippets.md b/includes/snippets/cli/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-cli-snippets.md similarity index 68% rename from includes/snippets/cli/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-cli-snippets.md rename to includes/snippets/cli/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-cli-snippets.md index c2d33fc2547..ed3afa05653 100644 --- a/includes/snippets/cli/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-cli-snippets.md +++ b/includes/snippets/cli/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-cli-snippets.md @@ -5,13 +5,11 @@ description: "Automatically generated file. DO NOT MODIFY" ```bash // THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY -mgc-beta identity-governance entitlement-management access-package-resource-requests create --body '{ \ +mgc identity-governance entitlement-management resource-requests create --body '{ \ "catalogId":"cec5d6ab-c75d-47c0-9c1c-92e89f66e384", \ "requestType": "AdminAdd", \ "justification": "", \ "accessPackageResource": { \ - "displayName": "Marketing resources", \ - "description": "Marketing group", \ "resourceType": "AadGroup", \ "originId": "e93e24d1-2b65-4a6c-a1dd-654a12225487", \ "originSystem": "AadGroup" \ diff --git a/includes/snippets/cli/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-cli-snippets.md b/includes/snippets/cli/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-cli-snippets.md new file mode 100644 index 00000000000..feefde172c1 --- /dev/null +++ b/includes/snippets/cli/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-cli-snippets.md @@ -0,0 +1,10 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```bash + +// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY +mgc identity-governance entitlement-management catalogs resource-roles list --access-package-catalog-id {accessPackageCatalog-id} --filter "(originSystem eq 'AadGroup' and displayName eq 'Member' and resource/id eq '274a1e21c5-8a76-4578-acb1-641160e076e')" --expand "resource" + +``` \ No newline at end of file diff --git a/includes/snippets/cli/v1/tutorial-entitlementmanagement-get-accesspackageresources-cli-snippets.md b/includes/snippets/cli/v1/tutorial-entitlementmanagement-get-accesspackageresources-cli-snippets.md new file mode 100644 index 00000000000..7d4f3634ce9 --- /dev/null +++ b/includes/snippets/cli/v1/tutorial-entitlementmanagement-get-accesspackageresources-cli-snippets.md @@ -0,0 +1,10 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```bash + +// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY +mgc identity-governance entitlement-management catalogs resources list --access-package-catalog-id {accessPackageCatalog-id} --filter "originId eq 'e93e24d1-2b65-4a6c-a1dd-654a12225487'" + +``` \ No newline at end of file diff --git a/includes/snippets/cli/v1/tutorial-riskdetection-create-user-cli-snippets.md b/includes/snippets/cli/v1/tutorial-riskdetection-create-user-cli-snippets.md deleted file mode 100644 index ff8af66d585..00000000000 --- a/includes/snippets/cli/v1/tutorial-riskdetection-create-user-cli-snippets.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```bash - -// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY -mgc users create --body '{ \ - "accountEnabled":true, \ - "displayName":"MyTestUser1", \ - "mailNickname":"MyTestUser1", \ - "userPrincipalName":"MyTestUser1@contoso.com", \ - "passwordProfile": { \ - "forceChangePasswordNextSignIn":true, \ - "password":"Contoso1234" \ - } \ -} \ -' - -``` \ No newline at end of file diff --git a/includes/snippets/cli/v1/tutorial-riskdetection-delete-group-cli-snippets.md b/includes/snippets/cli/v1/tutorial-riskdetection-delete-group-cli-snippets.md index 86665e2a1b9..f581b48ca27 100644 --- a/includes/snippets/cli/v1/tutorial-riskdetection-delete-group-cli-snippets.md +++ b/includes/snippets/cli/v1/tutorial-riskdetection-delete-group-cli-snippets.md @@ -5,6 +5,6 @@ description: "Automatically generated file. DO NOT MODIFY" ```bash // THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY -mgc groups delete --group-id {group-id} +mgc identity conditional-access policies delete --conditional-access-policy-id {conditionalAccessPolicy-id} ``` \ No newline at end of file diff --git a/includes/snippets/csharp/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-csharp-snippets.md b/includes/snippets/csharp/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-csharp-snippets.md deleted file mode 100644 index 25b64d5e752..00000000000 --- a/includes/snippets/csharp/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-csharp-snippets.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```csharp - -// Code snippets are only available for the latest version. Current version is 5.x - -// Dependencies -using Microsoft.Graph.Beta.Models; - -var requestBody = new AccessPackageResourceRequest -{ - CatalogId = "cec5d6ab-c75d-47c0-9c1c-92e89f66e384", - RequestType = "AdminAdd", - Justification = "", - AccessPackageResource = new AccessPackageResource - { - DisplayName = "Marketing resources", - Description = "Marketing group", - ResourceType = "AadGroup", - OriginId = "e93e24d1-2b65-4a6c-a1dd-654a12225487", - OriginSystem = "AadGroup", - }, -}; - -// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp -var result = await graphClient.IdentityGovernance.EntitlementManagement.AccessPackageResourceRequests.PostAsync(requestBody); - - -``` \ No newline at end of file diff --git a/includes/snippets/csharp/beta/tutorial-entitlementmanagement-get-accesspackageresourcerolescope-csharp-snippets.md b/includes/snippets/csharp/beta/tutorial-entitlementmanagement-get-accesspackageresourcerolescope-csharp-snippets.md deleted file mode 100644 index 3c36b49b648..00000000000 --- a/includes/snippets/csharp/beta/tutorial-entitlementmanagement-get-accesspackageresourcerolescope-csharp-snippets.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```csharp - -// Code snippets are only available for the latest version. Current version is 5.x - -// Dependencies -using Microsoft.Graph.Beta.Models; - -var requestBody = new AccessPackageResourceRoleScope -{ - AccessPackageResourceRole = new AccessPackageResourceRole - { - OriginId = "Member_e93e24d1-2b65-4a6c-a1dd-654a12225487", - DisplayName = "Member", - OriginSystem = "AadGroup", - AccessPackageResource = new AccessPackageResource - { - Id = "4a1e21c5-8a76-4578-acb1-641160e076e8", - ResourceType = "Security Group", - OriginId = "e93e24d1-2b65-4a6c-a1dd-654a12225487", - OriginSystem = "AadGroup", - }, - }, - AccessPackageResourceScope = new AccessPackageResourceScope - { - OriginId = "e93e24d1-2b65-4a6c-a1dd-654a12225487", - OriginSystem = "AadGroup", - }, -}; - -// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp -var result = await graphClient.IdentityGovernance.EntitlementManagement.AccessPackages["{accessPackage-id}"].AccessPackageResourceRoleScopes.PostAsync(requestBody); - - -``` \ No newline at end of file diff --git a/includes/snippets/csharp/beta/tutorial-entitlementmanagement-create-accesspackage-csharp-snippets.md b/includes/snippets/csharp/v1/tutorial-entitlementmanagement-create-accesspackage-csharp-snippets.md similarity index 78% rename from includes/snippets/csharp/beta/tutorial-entitlementmanagement-create-accesspackage-csharp-snippets.md rename to includes/snippets/csharp/v1/tutorial-entitlementmanagement-create-accesspackage-csharp-snippets.md index 8014ef209af..877c1373bc2 100644 --- a/includes/snippets/csharp/beta/tutorial-entitlementmanagement-create-accesspackage-csharp-snippets.md +++ b/includes/snippets/csharp/v1/tutorial-entitlementmanagement-create-accesspackage-csharp-snippets.md @@ -7,13 +7,18 @@ description: "Automatically generated file. DO NOT MODIFY" // Code snippets are only available for the latest version. Current version is 5.x // Dependencies -using Microsoft.Graph.Beta.Models; +using Microsoft.Graph.Models; var requestBody = new AccessPackage { - CatalogId = "cec5d6ab-c75d-47c0-9c1c-92e89f66e384", DisplayName = "Marketing Campaign", Description = "Access to resources for the campaign", + AdditionalData = new Dictionary + { + { + "catalogId" , "cec5d6ab-c75d-47c0-9c1c-92e89f66e384" + }, + }, }; // To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp diff --git a/includes/snippets/csharp/v1/tutorial-entitlementmanagement-create-group-csharp-snippets.md b/includes/snippets/csharp/v1/tutorial-entitlementmanagement-create-group-csharp-snippets.md deleted file mode 100644 index caedcd9b106..00000000000 --- a/includes/snippets/csharp/v1/tutorial-entitlementmanagement-create-group-csharp-snippets.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```csharp - -// Code snippets are only available for the latest version. Current version is 5.x - -// Dependencies -using Microsoft.Graph.Models; - -var requestBody = new Group -{ - Description = "Marketing group", - DisplayName = "Marketing resources", - MailEnabled = false, - MailNickname = "markres", - SecurityEnabled = true, -}; - -// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp -var result = await graphClient.Groups.PostAsync(requestBody); - - -``` \ No newline at end of file diff --git a/includes/snippets/csharp/v1/tutorial-entitlementmanagement-create-user-csharp-snippets.md b/includes/snippets/csharp/v1/tutorial-entitlementmanagement-create-user-csharp-snippets.md deleted file mode 100644 index 2293ea68829..00000000000 --- a/includes/snippets/csharp/v1/tutorial-entitlementmanagement-create-user-csharp-snippets.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```csharp - -// Code snippets are only available for the latest version. Current version is 5.x - -// Dependencies -using Microsoft.Graph.Models; - -var requestBody = new User -{ - AccountEnabled = true, - DisplayName = "Requestor1", - MailNickname = "Requestor1", - UserPrincipalName = "Requestor1@contoso.com", - PasswordProfile = new PasswordProfile - { - ForceChangePasswordNextSignIn = true, - Password = "Contoso1234", - }, -}; - -// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp -var result = await graphClient.Users.PostAsync(requestBody); - - -``` \ No newline at end of file diff --git a/includes/snippets/csharp/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-csharp-snippets.md b/includes/snippets/csharp/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-csharp-snippets.md similarity index 87% rename from includes/snippets/csharp/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-csharp-snippets.md rename to includes/snippets/csharp/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-csharp-snippets.md index 5200dd6d534..75b7891ab2a 100644 --- a/includes/snippets/csharp/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-csharp-snippets.md +++ b/includes/snippets/csharp/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-csharp-snippets.md @@ -7,7 +7,7 @@ description: "Automatically generated file. DO NOT MODIFY" // Code snippets are only available for the latest version. Current version is 5.x // To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp -var result = await graphClient.IdentityGovernance.EntitlementManagement.AccessPackageCatalogs.GetAsync((requestConfiguration) => +var result = await graphClient.IdentityGovernance.EntitlementManagement.Catalogs.GetAsync((requestConfiguration) => { requestConfiguration.QueryParameters.Filter = "(displayName eq 'General')"; }); diff --git a/includes/snippets/csharp/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-csharp-snippets.md b/includes/snippets/csharp/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-csharp-snippets.md new file mode 100644 index 00000000000..e7a58e8a6de --- /dev/null +++ b/includes/snippets/csharp/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-csharp-snippets.md @@ -0,0 +1,38 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```csharp + +// Code snippets are only available for the latest version. Current version is 5.x + +// Dependencies +using Microsoft.Graph.Models; + +var requestBody = new AccessPackageResourceRequest +{ + RequestType = AccessPackageRequestType.AdminAdd, + AdditionalData = new Dictionary + { + { + "catalogId" , "cec5d6ab-c75d-47c0-9c1c-92e89f66e384" + }, + { + "justification" , "" + }, + { + "accessPackageResource" , new + { + ResourceType = "AadGroup", + OriginId = "e93e24d1-2b65-4a6c-a1dd-654a12225487", + OriginSystem = "AadGroup", + } + }, + }, +}; + +// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp +var result = await graphClient.IdentityGovernance.EntitlementManagement.ResourceRequests.PostAsync(requestBody); + + +``` \ No newline at end of file diff --git a/includes/snippets/csharp/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-csharp-snippets.md b/includes/snippets/csharp/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-csharp-snippets.md similarity index 56% rename from includes/snippets/csharp/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-csharp-snippets.md rename to includes/snippets/csharp/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-csharp-snippets.md index a00ad76a36f..bbc3121ae18 100644 --- a/includes/snippets/csharp/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-csharp-snippets.md +++ b/includes/snippets/csharp/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-csharp-snippets.md @@ -7,10 +7,10 @@ description: "Automatically generated file. DO NOT MODIFY" // Code snippets are only available for the latest version. Current version is 5.x // To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp -var result = await graphClient.IdentityGovernance.EntitlementManagement.AccessPackageCatalogs["{accessPackageCatalog-id}"].AccessPackageResourceRoles.GetAsync((requestConfiguration) => +var result = await graphClient.IdentityGovernance.EntitlementManagement.Catalogs["{accessPackageCatalog-id}"].ResourceRoles.GetAsync((requestConfiguration) => { - requestConfiguration.QueryParameters.Filter = "(originSystem eq 'AadGroup' and accessPackageResource/id eq '4a1e21c5-8a76-4578-acb1-641160e076e8' and displayName eq 'Member')"; - requestConfiguration.QueryParameters.Expand = new string []{ "accessPackageResource" }; + requestConfiguration.QueryParameters.Filter = "(originSystem eq 'AadGroup' and displayName eq 'Member' and resource/id eq '274a1e21c5-8a76-4578-acb1-641160e076e')"; + requestConfiguration.QueryParameters.Expand = new string []{ "resource" }; }); diff --git a/includes/snippets/csharp/beta/tutorial-entitlementmanagement-get-accesspackageresources-csharp-snippets.md b/includes/snippets/csharp/v1/tutorial-entitlementmanagement-get-accesspackageresources-csharp-snippets.md similarity index 63% rename from includes/snippets/csharp/beta/tutorial-entitlementmanagement-get-accesspackageresources-csharp-snippets.md rename to includes/snippets/csharp/v1/tutorial-entitlementmanagement-get-accesspackageresources-csharp-snippets.md index 57bb2a994c9..f283f659ea6 100644 --- a/includes/snippets/csharp/beta/tutorial-entitlementmanagement-get-accesspackageresources-csharp-snippets.md +++ b/includes/snippets/csharp/v1/tutorial-entitlementmanagement-get-accesspackageresources-csharp-snippets.md @@ -7,9 +7,9 @@ description: "Automatically generated file. DO NOT MODIFY" // Code snippets are only available for the latest version. Current version is 5.x // To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp -var result = await graphClient.IdentityGovernance.EntitlementManagement.AccessPackageCatalogs["{accessPackageCatalog-id}"].AccessPackageResources.GetAsync((requestConfiguration) => +var result = await graphClient.IdentityGovernance.EntitlementManagement.Catalogs["{accessPackageCatalog-id}"].Resources.GetAsync((requestConfiguration) => { - requestConfiguration.QueryParameters.Filter = "(displayName eq 'Marketing resources')"; + requestConfiguration.QueryParameters.Filter = "originId eq 'e93e24d1-2b65-4a6c-a1dd-654a12225487'"; }); diff --git a/includes/snippets/csharp/v1/tutorial-riskdetection-create-user-csharp-snippets.md b/includes/snippets/csharp/v1/tutorial-riskdetection-create-user-csharp-snippets.md deleted file mode 100644 index 9772c9b583d..00000000000 --- a/includes/snippets/csharp/v1/tutorial-riskdetection-create-user-csharp-snippets.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```csharp - -// Code snippets are only available for the latest version. Current version is 5.x - -// Dependencies -using Microsoft.Graph.Models; - -var requestBody = new User -{ - AccountEnabled = true, - DisplayName = "MyTestUser1", - MailNickname = "MyTestUser1", - UserPrincipalName = "MyTestUser1@contoso.com", - PasswordProfile = new PasswordProfile - { - ForceChangePasswordNextSignIn = true, - Password = "Contoso1234", - }, -}; - -// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp -var result = await graphClient.Users.PostAsync(requestBody); - - -``` \ No newline at end of file diff --git a/includes/snippets/csharp/v1/tutorial-riskdetection-delete-group-csharp-snippets.md b/includes/snippets/csharp/v1/tutorial-riskdetection-delete-group-csharp-snippets.md index 9ed66e60b40..e6feb6cbe90 100644 --- a/includes/snippets/csharp/v1/tutorial-riskdetection-delete-group-csharp-snippets.md +++ b/includes/snippets/csharp/v1/tutorial-riskdetection-delete-group-csharp-snippets.md @@ -7,7 +7,7 @@ description: "Automatically generated file. DO NOT MODIFY" // Code snippets are only available for the latest version. Current version is 5.x // To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp -await graphClient.Groups["{group-id}"].DeleteAsync(); +await graphClient.Identity.ConditionalAccess.Policies["{conditionalAccessPolicy-id}"].DeleteAsync(); ``` \ No newline at end of file diff --git a/includes/snippets/go/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-go-snippets.md b/includes/snippets/go/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-go-snippets.md deleted file mode 100644 index 1229a589024..00000000000 --- a/includes/snippets/go/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-go-snippets.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```go - - -import ( - "context" - msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go" - graphidentitygovernance "github.com/microsoftgraph/msgraph-beta-sdk-go/identitygovernance" - //other-imports -) - -graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) - - - -requestFilter := "(displayName eq 'General')" - -requestParameters := &graphidentitygovernance.IdentityGovernanceEntitlementManagementAccessPackageCatalogsRequestBuilderGetQueryParameters{ - Filter: &requestFilter, -} -configuration := &graphidentitygovernance.IdentityGovernanceEntitlementManagementAccessPackageCatalogsRequestBuilderGetRequestConfiguration{ - QueryParameters: requestParameters, -} - -accessPackageCatalogs, err := graphClient.IdentityGovernance().EntitlementManagement().AccessPackageCatalogs().Get(context.Background(), configuration) - - -``` \ No newline at end of file diff --git a/includes/snippets/go/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-go-snippets.md b/includes/snippets/go/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-go-snippets.md deleted file mode 100644 index aba459c2ea9..00000000000 --- a/includes/snippets/go/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-go-snippets.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```go - - -import ( - "context" - msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go" - graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models" - //other-imports -) - -graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) - - -requestBody := graphmodels.NewAccessPackageResourceRequest() -catalogId := "cec5d6ab-c75d-47c0-9c1c-92e89f66e384" -requestBody.SetCatalogId(&catalogId) -requestType := "AdminAdd" -requestBody.SetRequestType(&requestType) -justification := "" -requestBody.SetJustification(&justification) -accessPackageResource := graphmodels.NewAccessPackageResource() -displayName := "Marketing resources" -accessPackageResource.SetDisplayName(&displayName) -description := "Marketing group" -accessPackageResource.SetDescription(&description) -resourceType := "AadGroup" -accessPackageResource.SetResourceType(&resourceType) -originId := "e93e24d1-2b65-4a6c-a1dd-654a12225487" -accessPackageResource.SetOriginId(&originId) -originSystem := "AadGroup" -accessPackageResource.SetOriginSystem(&originSystem) -requestBody.SetAccessPackageResource(accessPackageResource) - -accessPackageResourceRequests, err := graphClient.IdentityGovernance().EntitlementManagement().AccessPackageResourceRequests().Post(context.Background(), requestBody, nil) - - -``` \ No newline at end of file diff --git a/includes/snippets/go/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-go-snippets.md b/includes/snippets/go/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-go-snippets.md deleted file mode 100644 index c479c902086..00000000000 --- a/includes/snippets/go/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-go-snippets.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```go - - -import ( - "context" - msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go" - graphidentitygovernance "github.com/microsoftgraph/msgraph-beta-sdk-go/identitygovernance" - //other-imports -) - -graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) - - - -requestFilter := "(originSystem eq 'AadGroup' and accessPackageResource/id eq '4a1e21c5-8a76-4578-acb1-641160e076e8' and displayName eq 'Member')" - -requestParameters := &graphidentitygovernance.IdentityGovernanceEntitlementManagementAccessPackageCatalogItemAccessPackageResourceRolesRequestBuilderGetQueryParameters{ - Filter: &requestFilter, - Expand: [] string {"accessPackageResource"}, -} -configuration := &graphidentitygovernance.IdentityGovernanceEntitlementManagementAccessPackageCatalogItemAccessPackageResourceRolesRequestBuilderGetRequestConfiguration{ - QueryParameters: requestParameters, -} - -accessPackageResourceRoles, err := graphClient.IdentityGovernance().EntitlementManagement().AccessPackageCatalogs().ByAccessPackageCatalogId("accessPackageCatalog-id").AccessPackageResourceRoles().Get(context.Background(), configuration) - - -``` \ No newline at end of file diff --git a/includes/snippets/go/beta/tutorial-entitlementmanagement-get-accesspackageresourcerolescope-go-snippets.md b/includes/snippets/go/beta/tutorial-entitlementmanagement-get-accesspackageresourcerolescope-go-snippets.md deleted file mode 100644 index e12742602a7..00000000000 --- a/includes/snippets/go/beta/tutorial-entitlementmanagement-get-accesspackageresourcerolescope-go-snippets.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```go - - -import ( - "context" - msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go" - graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models" - //other-imports -) - -graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) - - -requestBody := graphmodels.NewAccessPackageResourceRoleScope() -accessPackageResourceRole := graphmodels.NewAccessPackageResourceRole() -originId := "Member_e93e24d1-2b65-4a6c-a1dd-654a12225487" -accessPackageResourceRole.SetOriginId(&originId) -displayName := "Member" -accessPackageResourceRole.SetDisplayName(&displayName) -originSystem := "AadGroup" -accessPackageResourceRole.SetOriginSystem(&originSystem) -accessPackageResource := graphmodels.NewAccessPackageResource() -id := "4a1e21c5-8a76-4578-acb1-641160e076e8" -accessPackageResource.SetId(&id) -resourceType := "Security Group" -accessPackageResource.SetResourceType(&resourceType) -originId := "e93e24d1-2b65-4a6c-a1dd-654a12225487" -accessPackageResource.SetOriginId(&originId) -originSystem := "AadGroup" -accessPackageResource.SetOriginSystem(&originSystem) -accessPackageResourceRole.SetAccessPackageResource(accessPackageResource) -requestBody.SetAccessPackageResourceRole(accessPackageResourceRole) -accessPackageResourceScope := graphmodels.NewAccessPackageResourceScope() -originId := "e93e24d1-2b65-4a6c-a1dd-654a12225487" -accessPackageResourceScope.SetOriginId(&originId) -originSystem := "AadGroup" -accessPackageResourceScope.SetOriginSystem(&originSystem) -requestBody.SetAccessPackageResourceScope(accessPackageResourceScope) - -accessPackageResourceRoleScopes, err := graphClient.IdentityGovernance().EntitlementManagement().AccessPackages().ByAccessPackageId("accessPackage-id").AccessPackageResourceRoleScopes().Post(context.Background(), requestBody, nil) - - -``` \ No newline at end of file diff --git a/includes/snippets/go/beta/tutorial-entitlementmanagement-get-accesspackageresources-go-snippets.md b/includes/snippets/go/beta/tutorial-entitlementmanagement-get-accesspackageresources-go-snippets.md deleted file mode 100644 index c7f239da5a2..00000000000 --- a/includes/snippets/go/beta/tutorial-entitlementmanagement-get-accesspackageresources-go-snippets.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```go - - -import ( - "context" - msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go" - graphidentitygovernance "github.com/microsoftgraph/msgraph-beta-sdk-go/identitygovernance" - //other-imports -) - -graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) - - - -requestFilter := "(displayName eq 'Marketing resources')" - -requestParameters := &graphidentitygovernance.IdentityGovernanceEntitlementManagementAccessPackageCatalogItemAccessPackageResourcesRequestBuilderGetQueryParameters{ - Filter: &requestFilter, -} -configuration := &graphidentitygovernance.IdentityGovernanceEntitlementManagementAccessPackageCatalogItemAccessPackageResourcesRequestBuilderGetRequestConfiguration{ - QueryParameters: requestParameters, -} - -accessPackageResources, err := graphClient.IdentityGovernance().EntitlementManagement().AccessPackageCatalogs().ByAccessPackageCatalogId("accessPackageCatalog-id").AccessPackageResources().Get(context.Background(), configuration) - - -``` \ No newline at end of file diff --git a/includes/snippets/go/beta/tutorial-entitlementmanagement-create-accesspackage-go-snippets.md b/includes/snippets/go/v1/tutorial-entitlementmanagement-create-accesspackage-go-snippets.md similarity index 67% rename from includes/snippets/go/beta/tutorial-entitlementmanagement-create-accesspackage-go-snippets.md rename to includes/snippets/go/v1/tutorial-entitlementmanagement-create-accesspackage-go-snippets.md index c2183259566..1ead796e701 100644 --- a/includes/snippets/go/beta/tutorial-entitlementmanagement-create-accesspackage-go-snippets.md +++ b/includes/snippets/go/v1/tutorial-entitlementmanagement-create-accesspackage-go-snippets.md @@ -7,8 +7,8 @@ description: "Automatically generated file. DO NOT MODIFY" import ( "context" - msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go" - graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models" + msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go" + graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models" //other-imports ) @@ -16,12 +16,14 @@ graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) requestBody := graphmodels.NewAccessPackage() -catalogId := "cec5d6ab-c75d-47c0-9c1c-92e89f66e384" -requestBody.SetCatalogId(&catalogId) displayName := "Marketing Campaign" requestBody.SetDisplayName(&displayName) description := "Access to resources for the campaign" requestBody.SetDescription(&description) +additionalData := map[string]interface{}{ + "catalogId" : "cec5d6ab-c75d-47c0-9c1c-92e89f66e384", +} +requestBody.SetAdditionalData(additionalData) accessPackages, err := graphClient.IdentityGovernance().EntitlementManagement().AccessPackages().Post(context.Background(), requestBody, nil) diff --git a/includes/snippets/go/v1/tutorial-entitlementmanagement-create-group-go-snippets.md b/includes/snippets/go/v1/tutorial-entitlementmanagement-create-group-go-snippets.md deleted file mode 100644 index 44f19c11c05..00000000000 --- a/includes/snippets/go/v1/tutorial-entitlementmanagement-create-group-go-snippets.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```go - - -import ( - "context" - msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go" - graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models" - //other-imports -) - -graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) - - -requestBody := graphmodels.NewGroup() -description := "Marketing group" -requestBody.SetDescription(&description) -displayName := "Marketing resources" -requestBody.SetDisplayName(&displayName) -mailEnabled := false -requestBody.SetMailEnabled(&mailEnabled) -mailNickname := "markres" -requestBody.SetMailNickname(&mailNickname) -securityEnabled := true -requestBody.SetSecurityEnabled(&securityEnabled) - -groups, err := graphClient.Groups().Post(context.Background(), requestBody, nil) - - -``` \ No newline at end of file diff --git a/includes/snippets/go/v1/tutorial-entitlementmanagement-create-user-go-snippets.md b/includes/snippets/go/v1/tutorial-entitlementmanagement-create-user-go-snippets.md deleted file mode 100644 index 88d1327a5eb..00000000000 --- a/includes/snippets/go/v1/tutorial-entitlementmanagement-create-user-go-snippets.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```go - - -import ( - "context" - msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go" - graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models" - //other-imports -) - -graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) - - -requestBody := graphmodels.NewUser() -accountEnabled := true -requestBody.SetAccountEnabled(&accountEnabled) -displayName := "Requestor1" -requestBody.SetDisplayName(&displayName) -mailNickname := "Requestor1" -requestBody.SetMailNickname(&mailNickname) -userPrincipalName := "Requestor1@contoso.com" -requestBody.SetUserPrincipalName(&userPrincipalName) -passwordProfile := graphmodels.NewPasswordProfile() -forceChangePasswordNextSignIn := true -passwordProfile.SetForceChangePasswordNextSignIn(&forceChangePasswordNextSignIn) -password := "Contoso1234" -passwordProfile.SetPassword(&password) -requestBody.SetPasswordProfile(passwordProfile) - -users, err := graphClient.Users().Post(context.Background(), requestBody, nil) - - -``` \ No newline at end of file diff --git a/includes/snippets/go/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-go-snippets.md b/includes/snippets/go/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-go-snippets.md new file mode 100644 index 00000000000..aeb41a560f9 --- /dev/null +++ b/includes/snippets/go/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-go-snippets.md @@ -0,0 +1,31 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```go + + +import ( + "context" + msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go" + graphidentitygovernance "github.com/microsoftgraph/msgraph-sdk-go/identitygovernance" + //other-imports +) + +graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) + + + +requestFilter := "(displayName eq 'General')" + +requestParameters := &graphidentitygovernance.IdentityGovernanceEntitlementManagementCatalogsRequestBuilderGetQueryParameters{ + Filter: &requestFilter, +} +configuration := &graphidentitygovernance.IdentityGovernanceEntitlementManagementCatalogsRequestBuilderGetRequestConfiguration{ + QueryParameters: requestParameters, +} + +catalogs, err := graphClient.IdentityGovernance().EntitlementManagement().Catalogs().Get(context.Background(), configuration) + + +``` \ No newline at end of file diff --git a/includes/snippets/go/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-go-snippets.md b/includes/snippets/go/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-go-snippets.md new file mode 100644 index 00000000000..3c5bf8599f2 --- /dev/null +++ b/includes/snippets/go/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-go-snippets.md @@ -0,0 +1,38 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```go + + +import ( + "context" + msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go" + graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models" + //other-imports +) + +graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) + + +requestBody := graphmodels.NewAccessPackageResourceRequest() +requestType := graphmodels.ADMINADD_ACCESSPACKAGEREQUESTTYPE +requestBody.SetRequestType(&requestType) +additionalData := map[string]interface{}{ + "catalogId" : "cec5d6ab-c75d-47c0-9c1c-92e89f66e384", + "justification" : "", +accessPackageResource := graphmodels.New() +resourceType := "AadGroup" +accessPackageResource.SetResourceType(&resourceType) +originId := "e93e24d1-2b65-4a6c-a1dd-654a12225487" +accessPackageResource.SetOriginId(&originId) +originSystem := "AadGroup" +accessPackageResource.SetOriginSystem(&originSystem) + requestBody.SetAccessPackageResource(accessPackageResource) +} +requestBody.SetAdditionalData(additionalData) + +resourceRequests, err := graphClient.IdentityGovernance().EntitlementManagement().ResourceRequests().Post(context.Background(), requestBody, nil) + + +``` \ No newline at end of file diff --git a/includes/snippets/go/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-go-snippets.md b/includes/snippets/go/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-go-snippets.md new file mode 100644 index 00000000000..d7815717ba1 --- /dev/null +++ b/includes/snippets/go/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-go-snippets.md @@ -0,0 +1,32 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```go + + +import ( + "context" + msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go" + graphidentitygovernance "github.com/microsoftgraph/msgraph-sdk-go/identitygovernance" + //other-imports +) + +graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) + + + +requestFilter := "(originSystem eq 'AadGroup' and displayName eq 'Member' and resource/id eq '274a1e21c5-8a76-4578-acb1-641160e076e')" + +requestParameters := &graphidentitygovernance.IdentityGovernanceEntitlementManagementCatalogItemResourceRolesRequestBuilderGetQueryParameters{ + Filter: &requestFilter, + Expand: [] string {"resource"}, +} +configuration := &graphidentitygovernance.IdentityGovernanceEntitlementManagementCatalogItemResourceRolesRequestBuilderGetRequestConfiguration{ + QueryParameters: requestParameters, +} + +resourceRoles, err := graphClient.IdentityGovernance().EntitlementManagement().Catalogs().ByAccessPackageCatalogId("accessPackageCatalog-id").ResourceRoles().Get(context.Background(), configuration) + + +``` \ No newline at end of file diff --git a/includes/snippets/go/v1/tutorial-entitlementmanagement-get-accesspackageresources-go-snippets.md b/includes/snippets/go/v1/tutorial-entitlementmanagement-get-accesspackageresources-go-snippets.md new file mode 100644 index 00000000000..534d81abc43 --- /dev/null +++ b/includes/snippets/go/v1/tutorial-entitlementmanagement-get-accesspackageresources-go-snippets.md @@ -0,0 +1,31 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```go + + +import ( + "context" + msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go" + graphidentitygovernance "github.com/microsoftgraph/msgraph-sdk-go/identitygovernance" + //other-imports +) + +graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) + + + +requestFilter := "originId eq 'e93e24d1-2b65-4a6c-a1dd-654a12225487'" + +requestParameters := &graphidentitygovernance.IdentityGovernanceEntitlementManagementCatalogItemResourcesRequestBuilderGetQueryParameters{ + Filter: &requestFilter, +} +configuration := &graphidentitygovernance.IdentityGovernanceEntitlementManagementCatalogItemResourcesRequestBuilderGetRequestConfiguration{ + QueryParameters: requestParameters, +} + +resources, err := graphClient.IdentityGovernance().EntitlementManagement().Catalogs().ByAccessPackageCatalogId("accessPackageCatalog-id").Resources().Get(context.Background(), configuration) + + +``` \ No newline at end of file diff --git a/includes/snippets/go/v1/tutorial-riskdetection-create-user-go-snippets.md b/includes/snippets/go/v1/tutorial-riskdetection-create-user-go-snippets.md deleted file mode 100644 index a91eeba78b9..00000000000 --- a/includes/snippets/go/v1/tutorial-riskdetection-create-user-go-snippets.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```go - - -import ( - "context" - msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go" - graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models" - //other-imports -) - -graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) - - -requestBody := graphmodels.NewUser() -accountEnabled := true -requestBody.SetAccountEnabled(&accountEnabled) -displayName := "MyTestUser1" -requestBody.SetDisplayName(&displayName) -mailNickname := "MyTestUser1" -requestBody.SetMailNickname(&mailNickname) -userPrincipalName := "MyTestUser1@contoso.com" -requestBody.SetUserPrincipalName(&userPrincipalName) -passwordProfile := graphmodels.NewPasswordProfile() -forceChangePasswordNextSignIn := true -passwordProfile.SetForceChangePasswordNextSignIn(&forceChangePasswordNextSignIn) -password := "Contoso1234" -passwordProfile.SetPassword(&password) -requestBody.SetPasswordProfile(passwordProfile) - -users, err := graphClient.Users().Post(context.Background(), requestBody, nil) - - -``` \ No newline at end of file diff --git a/includes/snippets/go/v1/tutorial-riskdetection-delete-group-go-snippets.md b/includes/snippets/go/v1/tutorial-riskdetection-delete-group-go-snippets.md index 15659d1e1ff..06afae8a4f1 100644 --- a/includes/snippets/go/v1/tutorial-riskdetection-delete-group-go-snippets.md +++ b/includes/snippets/go/v1/tutorial-riskdetection-delete-group-go-snippets.md @@ -15,7 +15,7 @@ graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) -graphClient.Groups().ByGroupId("group-id").Delete(context.Background(), nil) +graphClient.Identity().ConditionalAccess().Policies().ByConditionalAccessPolicyId("conditionalAccessPolicy-id").Delete(context.Background(), nil) ``` \ No newline at end of file diff --git a/includes/snippets/go/v1/tutorial-riskdetection-get-riskdetections-filter-go-snippets.md b/includes/snippets/go/v1/tutorial-riskdetection-get-riskdetections-filter-go-snippets.md deleted file mode 100644 index 796a2e7dc56..00000000000 --- a/includes/snippets/go/v1/tutorial-riskdetection-get-riskdetections-filter-go-snippets.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```go - - -import ( - "context" - msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go" - graphidentityprotection "github.com/microsoftgraph/msgraph-sdk-go/identityprotection" - //other-imports -) - -graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) - - - -requestFilter := "userDisplayName eq 'MyTestUser1'" - -requestParameters := &graphidentityprotection.IdentityProtectionRiskDetectionsRequestBuilderGetQueryParameters{ - Filter: &requestFilter, -} -configuration := &graphidentityprotection.IdentityProtectionRiskDetectionsRequestBuilderGetRequestConfiguration{ - QueryParameters: requestParameters, -} - -riskDetections, err := graphClient.IdentityProtection().RiskDetections().Get(context.Background(), configuration) - - -``` \ No newline at end of file diff --git a/includes/snippets/go/v1/tutorial-riskdetection-riskyuserslist-go-snippets.md b/includes/snippets/go/v1/tutorial-riskdetection-riskyuserslist-go-snippets.md deleted file mode 100644 index b5ab73c447c..00000000000 --- a/includes/snippets/go/v1/tutorial-riskdetection-riskyuserslist-go-snippets.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```go - - -import ( - "context" - msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go" - graphidentityprotection "github.com/microsoftgraph/msgraph-sdk-go/identityprotection" - //other-imports -) - -graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) - - - -requestFilter := "userDisplayName eq 'MyTestUser1'" - -requestParameters := &graphidentityprotection.IdentityProtectionRiskyUsersRequestBuilderGetQueryParameters{ - Filter: &requestFilter, -} -configuration := &graphidentityprotection.IdentityProtectionRiskyUsersRequestBuilderGetRequestConfiguration{ - QueryParameters: requestParameters, -} - -riskyUsers, err := graphClient.IdentityProtection().RiskyUsers().Get(context.Background(), configuration) - - -``` \ No newline at end of file diff --git a/includes/snippets/java/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-java-snippets.md b/includes/snippets/java/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-java-snippets.md deleted file mode 100644 index f2b1823c72b..00000000000 --- a/includes/snippets/java/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-java-snippets.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```java - -// Code snippets are only available for the latest version. Current version is 6.x - -GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); - -AccessPackageResourceRoleCollectionResponse result = graphClient.identityGovernance().entitlementManagement().accessPackageCatalogs().byAccessPackageCatalogId("{accessPackageCatalog-id}").accessPackageResourceRoles().get(requestConfiguration -> { - requestConfiguration.queryParameters.filter = "(originSystem eq 'AadGroup' and accessPackageResource/id eq '4a1e21c5-8a76-4578-acb1-641160e076e8' and displayName eq 'Member')"; - requestConfiguration.queryParameters.expand = new String []{"accessPackageResource"}; -}); - - -``` \ No newline at end of file diff --git a/includes/snippets/java/beta/tutorial-entitlementmanagement-get-accesspackageresourcerolescope-java-snippets.md b/includes/snippets/java/beta/tutorial-entitlementmanagement-get-accesspackageresourcerolescope-java-snippets.md deleted file mode 100644 index 96e4ad1fa31..00000000000 --- a/includes/snippets/java/beta/tutorial-entitlementmanagement-get-accesspackageresourcerolescope-java-snippets.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```java - -// Code snippets are only available for the latest version. Current version is 6.x - -GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); - -AccessPackageResourceRoleScope accessPackageResourceRoleScope = new AccessPackageResourceRoleScope(); -AccessPackageResourceRole accessPackageResourceRole = new AccessPackageResourceRole(); -accessPackageResourceRole.setOriginId("Member_e93e24d1-2b65-4a6c-a1dd-654a12225487"); -accessPackageResourceRole.setDisplayName("Member"); -accessPackageResourceRole.setOriginSystem("AadGroup"); -AccessPackageResource accessPackageResource = new AccessPackageResource(); -accessPackageResource.setId("4a1e21c5-8a76-4578-acb1-641160e076e8"); -accessPackageResource.setResourceType("Security Group"); -accessPackageResource.setOriginId("e93e24d1-2b65-4a6c-a1dd-654a12225487"); -accessPackageResource.setOriginSystem("AadGroup"); -accessPackageResourceRole.setAccessPackageResource(accessPackageResource); -accessPackageResourceRoleScope.setAccessPackageResourceRole(accessPackageResourceRole); -AccessPackageResourceScope accessPackageResourceScope = new AccessPackageResourceScope(); -accessPackageResourceScope.setOriginId("e93e24d1-2b65-4a6c-a1dd-654a12225487"); -accessPackageResourceScope.setOriginSystem("AadGroup"); -accessPackageResourceRoleScope.setAccessPackageResourceScope(accessPackageResourceScope); -AccessPackageResourceRoleScope result = graphClient.identityGovernance().entitlementManagement().accessPackages().byAccessPackageId("{accessPackage-id}").accessPackageResourceRoleScopes().post(accessPackageResourceRoleScope); - - -``` \ No newline at end of file diff --git a/includes/snippets/java/beta/tutorial-entitlementmanagement-create-accesspackage-java-snippets.md b/includes/snippets/java/v1/tutorial-entitlementmanagement-create-accesspackage-java-snippets.md similarity index 73% rename from includes/snippets/java/beta/tutorial-entitlementmanagement-create-accesspackage-java-snippets.md rename to includes/snippets/java/v1/tutorial-entitlementmanagement-create-accesspackage-java-snippets.md index f7fbbaa1e5b..f5ca4d526a1 100644 --- a/includes/snippets/java/beta/tutorial-entitlementmanagement-create-accesspackage-java-snippets.md +++ b/includes/snippets/java/v1/tutorial-entitlementmanagement-create-accesspackage-java-snippets.md @@ -9,9 +9,11 @@ description: "Automatically generated file. DO NOT MODIFY" GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); AccessPackage accessPackage = new AccessPackage(); -accessPackage.setCatalogId("cec5d6ab-c75d-47c0-9c1c-92e89f66e384"); accessPackage.setDisplayName("Marketing Campaign"); accessPackage.setDescription("Access to resources for the campaign"); +HashMap additionalData = new HashMap(); +additionalData.put("catalogId", "cec5d6ab-c75d-47c0-9c1c-92e89f66e384"); +accessPackage.setAdditionalData(additionalData); AccessPackage result = graphClient.identityGovernance().entitlementManagement().accessPackages().post(accessPackage); diff --git a/includes/snippets/java/v1/tutorial-entitlementmanagement-create-group-java-snippets.md b/includes/snippets/java/v1/tutorial-entitlementmanagement-create-group-java-snippets.md deleted file mode 100644 index a437c950673..00000000000 --- a/includes/snippets/java/v1/tutorial-entitlementmanagement-create-group-java-snippets.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```java - -// Code snippets are only available for the latest version. Current version is 6.x - -GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); - -Group group = new Group(); -group.setDescription("Marketing group"); -group.setDisplayName("Marketing resources"); -group.setMailEnabled(false); -group.setMailNickname("markres"); -group.setSecurityEnabled(true); -Group result = graphClient.groups().post(group); - - -``` \ No newline at end of file diff --git a/includes/snippets/java/v1/tutorial-entitlementmanagement-create-user-java-snippets.md b/includes/snippets/java/v1/tutorial-entitlementmanagement-create-user-java-snippets.md deleted file mode 100644 index a6da997a518..00000000000 --- a/includes/snippets/java/v1/tutorial-entitlementmanagement-create-user-java-snippets.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```java - -// Code snippets are only available for the latest version. Current version is 6.x - -GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); - -User user = new User(); -user.setAccountEnabled(true); -user.setDisplayName("Requestor1"); -user.setMailNickname("Requestor1"); -user.setUserPrincipalName("Requestor1@contoso.com"); -PasswordProfile passwordProfile = new PasswordProfile(); -passwordProfile.setForceChangePasswordNextSignIn(true); -passwordProfile.setPassword("Contoso1234"); -user.setPasswordProfile(passwordProfile); -User result = graphClient.users().post(user); - - -``` \ No newline at end of file diff --git a/includes/snippets/java/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-java-snippets.md b/includes/snippets/java/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-java-snippets.md similarity index 80% rename from includes/snippets/java/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-java-snippets.md rename to includes/snippets/java/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-java-snippets.md index 85778f2afcf..f63e7764254 100644 --- a/includes/snippets/java/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-java-snippets.md +++ b/includes/snippets/java/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-java-snippets.md @@ -8,7 +8,7 @@ description: "Automatically generated file. DO NOT MODIFY" GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); -AccessPackageCatalogCollectionResponse result = graphClient.identityGovernance().entitlementManagement().accessPackageCatalogs().get(requestConfiguration -> { +AccessPackageCatalogCollectionResponse result = graphClient.identityGovernance().entitlementManagement().catalogs().get(requestConfiguration -> { requestConfiguration.queryParameters.filter = "(displayName eq 'General')"; }); diff --git a/includes/snippets/java/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-java-snippets.md b/includes/snippets/java/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-java-snippets.md similarity index 50% rename from includes/snippets/java/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-java-snippets.md rename to includes/snippets/java/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-java-snippets.md index 20963174fbb..1791d003126 100644 --- a/includes/snippets/java/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-java-snippets.md +++ b/includes/snippets/java/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-java-snippets.md @@ -9,17 +9,17 @@ description: "Automatically generated file. DO NOT MODIFY" GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); AccessPackageResourceRequest accessPackageResourceRequest = new AccessPackageResourceRequest(); -accessPackageResourceRequest.setCatalogId("cec5d6ab-c75d-47c0-9c1c-92e89f66e384"); -accessPackageResourceRequest.setRequestType("AdminAdd"); -accessPackageResourceRequest.setJustification(""); -AccessPackageResource accessPackageResource = new AccessPackageResource(); -accessPackageResource.setDisplayName("Marketing resources"); -accessPackageResource.setDescription("Marketing group"); +accessPackageResourceRequest.setRequestType(AccessPackageRequestType.AdminAdd); +HashMap additionalData = new HashMap(); +additionalData.put("catalogId", "cec5d6ab-c75d-47c0-9c1c-92e89f66e384"); +additionalData.put("justification", ""); + accessPackageResource = new (); accessPackageResource.setResourceType("AadGroup"); accessPackageResource.setOriginId("e93e24d1-2b65-4a6c-a1dd-654a12225487"); accessPackageResource.setOriginSystem("AadGroup"); -accessPackageResourceRequest.setAccessPackageResource(accessPackageResource); -AccessPackageResourceRequest result = graphClient.identityGovernance().entitlementManagement().accessPackageResourceRequests().post(accessPackageResourceRequest); +additionalData.put("accessPackageResource", accessPackageResource); +accessPackageResourceRequest.setAdditionalData(additionalData); +AccessPackageResourceRequest result = graphClient.identityGovernance().entitlementManagement().resourceRequests().post(accessPackageResourceRequest); ``` \ No newline at end of file diff --git a/includes/snippets/java/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-java-snippets.md b/includes/snippets/java/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-java-snippets.md new file mode 100644 index 00000000000..0137f149526 --- /dev/null +++ b/includes/snippets/java/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-java-snippets.md @@ -0,0 +1,17 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```java + +// Code snippets are only available for the latest version. Current version is 6.x + +GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); + +AccessPackageResourceRoleCollectionResponse result = graphClient.identityGovernance().entitlementManagement().catalogs().byAccessPackageCatalogId("{accessPackageCatalog-id}").resourceRoles().get(requestConfiguration -> { + requestConfiguration.queryParameters.filter = "(originSystem eq 'AadGroup' and displayName eq 'Member' and resource/id eq '274a1e21c5-8a76-4578-acb1-641160e076e')"; + requestConfiguration.queryParameters.expand = new String []{"resource"}; +}); + + +``` \ No newline at end of file diff --git a/includes/snippets/java/beta/tutorial-entitlementmanagement-get-accesspackageresources-java-snippets.md b/includes/snippets/java/v1/tutorial-entitlementmanagement-get-accesspackageresources-java-snippets.md similarity index 53% rename from includes/snippets/java/beta/tutorial-entitlementmanagement-get-accesspackageresources-java-snippets.md rename to includes/snippets/java/v1/tutorial-entitlementmanagement-get-accesspackageresources-java-snippets.md index 5bc752bce5a..634a59baf59 100644 --- a/includes/snippets/java/beta/tutorial-entitlementmanagement-get-accesspackageresources-java-snippets.md +++ b/includes/snippets/java/v1/tutorial-entitlementmanagement-get-accesspackageresources-java-snippets.md @@ -8,8 +8,8 @@ description: "Automatically generated file. DO NOT MODIFY" GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); -AccessPackageResourceCollectionResponse result = graphClient.identityGovernance().entitlementManagement().accessPackageCatalogs().byAccessPackageCatalogId("{accessPackageCatalog-id}").accessPackageResources().get(requestConfiguration -> { - requestConfiguration.queryParameters.filter = "(displayName eq 'Marketing resources')"; +AccessPackageResourceCollectionResponse result = graphClient.identityGovernance().entitlementManagement().catalogs().byAccessPackageCatalogId("{accessPackageCatalog-id}").resources().get(requestConfiguration -> { + requestConfiguration.queryParameters.filter = "originId eq 'e93e24d1-2b65-4a6c-a1dd-654a12225487'"; }); diff --git a/includes/snippets/java/v1/tutorial-riskdetection-create-user-java-snippets.md b/includes/snippets/java/v1/tutorial-riskdetection-create-user-java-snippets.md deleted file mode 100644 index 79bdd8824ce..00000000000 --- a/includes/snippets/java/v1/tutorial-riskdetection-create-user-java-snippets.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```java - -// Code snippets are only available for the latest version. Current version is 6.x - -GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); - -User user = new User(); -user.setAccountEnabled(true); -user.setDisplayName("MyTestUser1"); -user.setMailNickname("MyTestUser1"); -user.setUserPrincipalName("MyTestUser1@contoso.com"); -PasswordProfile passwordProfile = new PasswordProfile(); -passwordProfile.setForceChangePasswordNextSignIn(true); -passwordProfile.setPassword("Contoso1234"); -user.setPasswordProfile(passwordProfile); -User result = graphClient.users().post(user); - - -``` \ No newline at end of file diff --git a/includes/snippets/java/v1/tutorial-riskdetection-delete-group-java-snippets.md b/includes/snippets/java/v1/tutorial-riskdetection-delete-group-java-snippets.md index 92cdd269a65..adb169d9aa7 100644 --- a/includes/snippets/java/v1/tutorial-riskdetection-delete-group-java-snippets.md +++ b/includes/snippets/java/v1/tutorial-riskdetection-delete-group-java-snippets.md @@ -8,7 +8,7 @@ description: "Automatically generated file. DO NOT MODIFY" GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); -graphClient.groups().byGroupId("{group-id}").delete(); +graphClient.identity().conditionalAccess().policies().byConditionalAccessPolicyId("{conditionalAccessPolicy-id}").delete(); ``` \ No newline at end of file diff --git a/includes/snippets/javascript/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-javascript-snippets.md b/includes/snippets/javascript/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-javascript-snippets.md deleted file mode 100644 index b5c70b00c30..00000000000 --- a/includes/snippets/javascript/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-javascript-snippets.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```javascript - -const options = { - authProvider, -}; - -const client = Client.init(options); - -let accessPackageResourceRoles = await client.api('/identityGovernance/entitlementManagement/accessPackageCatalogs/cec5d6ab-c75d-47c0-9c1c-92e89f66e384/accessPackageResourceRoles') - .version('beta') - .filter('(originSystem eq \'AadGroup\' and accessPackageResource/id eq \'4a1e21c5-8a76-4578-acb1-641160e076e8\' and displayName eq \'Member\')') - .expand('accessPackageResource/id eq \'4a1e21c5-8a76-4578-acb1-641160e076e8\' and displayName eq \'Member\')') - .get(); - -``` \ No newline at end of file diff --git a/includes/snippets/javascript/beta/tutorial-entitlementmanagement-get-accesspackageresourcerolescope-javascript-snippets.md b/includes/snippets/javascript/beta/tutorial-entitlementmanagement-get-accesspackageresourcerolescope-javascript-snippets.md deleted file mode 100644 index 7ff101ecdd3..00000000000 --- a/includes/snippets/javascript/beta/tutorial-entitlementmanagement-get-accesspackageresourcerolescope-javascript-snippets.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```javascript - -const options = { - authProvider, -}; - -const client = Client.init(options); - -const accessPackageResourceRoleScope = { - accessPackageResourceRole: { - originId: 'Member_e93e24d1-2b65-4a6c-a1dd-654a12225487', - displayName: 'Member', - originSystem: 'AadGroup', - accessPackageResource: { - id: '4a1e21c5-8a76-4578-acb1-641160e076e8',resourceType: 'Security Group', - originId: 'e93e24d1-2b65-4a6c-a1dd-654a12225487',originSystem: 'AadGroup' - } - }, - accessPackageResourceScope: { - originId: 'e93e24d1-2b65-4a6c-a1dd-654a12225487',originSystem: 'AadGroup' - } -}; - -await client.api('/identityGovernance/entitlementManagement/accessPackages/88203d16-0e31-41d4-87b2-dd402f1435e9/accessPackageResourceRoleScopes') - .version('beta') - .post(accessPackageResourceRoleScope); - -``` \ No newline at end of file diff --git a/includes/snippets/javascript/beta/tutorial-entitlementmanagement-get-accesspackageresources-javascript-snippets.md b/includes/snippets/javascript/beta/tutorial-entitlementmanagement-get-accesspackageresources-javascript-snippets.md deleted file mode 100644 index b934f7be957..00000000000 --- a/includes/snippets/javascript/beta/tutorial-entitlementmanagement-get-accesspackageresources-javascript-snippets.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```javascript - -const options = { - authProvider, -}; - -const client = Client.init(options); - -let accessPackageResources = await client.api('/identityGovernance/entitlementManagement/accessPackageCatalogs/cec5d6ab-c75d-47c0-9c1c-92e89f66e384/accessPackageResources') - .version('beta') - .filter('(displayName eq \'Marketing resources\')') - .get(); - -``` \ No newline at end of file diff --git a/includes/snippets/javascript/beta/tutorial-entitlementmanagement-create-accesspackage-javascript-snippets.md b/includes/snippets/javascript/v1/tutorial-entitlementmanagement-create-accesspackage-javascript-snippets.md similarity index 96% rename from includes/snippets/javascript/beta/tutorial-entitlementmanagement-create-accesspackage-javascript-snippets.md rename to includes/snippets/javascript/v1/tutorial-entitlementmanagement-create-accesspackage-javascript-snippets.md index 2db66d6736b..6385590c632 100644 --- a/includes/snippets/javascript/beta/tutorial-entitlementmanagement-create-accesspackage-javascript-snippets.md +++ b/includes/snippets/javascript/v1/tutorial-entitlementmanagement-create-accesspackage-javascript-snippets.md @@ -17,7 +17,6 @@ const accessPackage = { }; await client.api('/identityGovernance/entitlementManagement/accessPackages') - .version('beta') .post(accessPackage); ``` \ No newline at end of file diff --git a/includes/snippets/javascript/v1/tutorial-entitlementmanagement-create-group-javascript-snippets.md b/includes/snippets/javascript/v1/tutorial-entitlementmanagement-create-group-javascript-snippets.md deleted file mode 100644 index cf6e94bd882..00000000000 --- a/includes/snippets/javascript/v1/tutorial-entitlementmanagement-create-group-javascript-snippets.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```javascript - -const options = { - authProvider, -}; - -const client = Client.init(options); - -const group = { - description: 'Marketing group', - displayName: 'Marketing resources', - mailEnabled: false, - mailNickname: 'markres', - securityEnabled: true -}; - -await client.api('/groups') - .post(group); - -``` \ No newline at end of file diff --git a/includes/snippets/javascript/v1/tutorial-entitlementmanagement-create-user-javascript-snippets.md b/includes/snippets/javascript/v1/tutorial-entitlementmanagement-create-user-javascript-snippets.md deleted file mode 100644 index d73dc5a7e02..00000000000 --- a/includes/snippets/javascript/v1/tutorial-entitlementmanagement-create-user-javascript-snippets.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```javascript - -const options = { - authProvider, -}; - -const client = Client.init(options); - -const user = { - accountEnabled: true, - displayName: 'Requestor1', - mailNickname: 'Requestor1', - userPrincipalName: 'Requestor1@contoso.com', - passwordProfile: { - forceChangePasswordNextSignIn: true, - password: 'Contoso1234' - } -}; - -await client.api('/users') - .post(user); - -``` \ No newline at end of file diff --git a/includes/snippets/javascript/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-javascript-snippets.md b/includes/snippets/javascript/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-javascript-snippets.md similarity index 61% rename from includes/snippets/javascript/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-javascript-snippets.md rename to includes/snippets/javascript/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-javascript-snippets.md index 280e41e9b2e..10329004e18 100644 --- a/includes/snippets/javascript/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-javascript-snippets.md +++ b/includes/snippets/javascript/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-javascript-snippets.md @@ -10,8 +10,7 @@ const options = { const client = Client.init(options); -let accessPackageCatalogs = await client.api('/identityGovernance/entitlementManagement/accessPackageCatalogs') - .version('beta') +let catalogs = await client.api('/identityGovernance/entitlementManagement/catalogs') .filter('(displayName eq \'General\')') .get(); diff --git a/includes/snippets/javascript/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-javascript-snippets.md b/includes/snippets/javascript/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-javascript-snippets.md similarity index 72% rename from includes/snippets/javascript/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-javascript-snippets.md rename to includes/snippets/javascript/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-javascript-snippets.md index de9b30772ff..b210af01c93 100644 --- a/includes/snippets/javascript/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-javascript-snippets.md +++ b/includes/snippets/javascript/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-javascript-snippets.md @@ -15,16 +15,13 @@ const accessPackageResourceRequest = { requestType: 'AdminAdd', justification: '', accessPackageResource: { - displayName: 'Marketing resources', - description: 'Marketing group', resourceType: 'AadGroup', originId: 'e93e24d1-2b65-4a6c-a1dd-654a12225487', originSystem: 'AadGroup' } }; -await client.api('/identityGovernance/entitlementManagement/accessPackageResourceRequests') - .version('beta') +await client.api('/identityGovernance/entitlementManagement/resourceRequests') .post(accessPackageResourceRequest); ``` \ No newline at end of file diff --git a/includes/snippets/javascript/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-javascript-snippets.md b/includes/snippets/javascript/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-javascript-snippets.md new file mode 100644 index 00000000000..8f595d080ad --- /dev/null +++ b/includes/snippets/javascript/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-javascript-snippets.md @@ -0,0 +1,18 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```javascript + +const options = { + authProvider, +}; + +const client = Client.init(options); + +let resourceRoles = await client.api('/identityGovernance/entitlementManagement/catalogs/ede67938-cda7-4127-a9ca-7c7bf86a19b7/resourceRoles') + .filter('(originSystem eq \'AadGroup\' and displayName eq \'Member\' and resource/id eq \'274a1e21c5-8a76-4578-acb1-641160e076e\')') + .expand('resource/id eq \'274a1e21c5-8a76-4578-acb1-641160e076e\')') + .get(); + +``` \ No newline at end of file diff --git a/includes/snippets/javascript/v1/tutorial-entitlementmanagement-get-accesspackageresources-javascript-snippets.md b/includes/snippets/javascript/v1/tutorial-entitlementmanagement-get-accesspackageresources-javascript-snippets.md new file mode 100644 index 00000000000..47432aa7add --- /dev/null +++ b/includes/snippets/javascript/v1/tutorial-entitlementmanagement-get-accesspackageresources-javascript-snippets.md @@ -0,0 +1,17 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```javascript + +const options = { + authProvider, +}; + +const client = Client.init(options); + +let resources = await client.api('/identityGovernance/entitlementManagement/catalogs/cec5d6ab-c75d-47c0-9c1c-92e89f66e384/resources') + .filter('originId eq \'e93e24d1-2b65-4a6c-a1dd-654a12225487\'') + .get(); + +``` \ No newline at end of file diff --git a/includes/snippets/javascript/v1/tutorial-entitlementmanagement-get-group-members-javascript-snippets.md b/includes/snippets/javascript/v1/tutorial-entitlementmanagement-get-group-members-javascript-snippets.md index 902d7586c47..4a4189db1fa 100644 --- a/includes/snippets/javascript/v1/tutorial-entitlementmanagement-get-group-members-javascript-snippets.md +++ b/includes/snippets/javascript/v1/tutorial-entitlementmanagement-get-group-members-javascript-snippets.md @@ -10,7 +10,7 @@ const options = { const client = Client.init(options); -let members = await client.api('/groups/e93e24d1-2b65-4a6c-a1dd-654a12225487/members') +let members = await client.api('/groups/f4892fac-e81c-4712-bdf2-a4450008a4b0/members') .get(); ``` \ No newline at end of file diff --git a/includes/snippets/javascript/v1/tutorial-riskdetection-create-user-javascript-snippets.md b/includes/snippets/javascript/v1/tutorial-riskdetection-create-user-javascript-snippets.md deleted file mode 100644 index 78a37e258d1..00000000000 --- a/includes/snippets/javascript/v1/tutorial-riskdetection-create-user-javascript-snippets.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```javascript - -const options = { - authProvider, -}; - -const client = Client.init(options); - -const user = { - accountEnabled: true, - displayName: 'MyTestUser1', - mailNickname: 'MyTestUser1', - userPrincipalName: 'MyTestUser1@contoso.com', - passwordProfile: { - forceChangePasswordNextSignIn: true, - password: 'Contoso1234' - } -}; - -await client.api('/users') - .post(user); - -``` \ No newline at end of file diff --git a/includes/snippets/javascript/v1/tutorial-riskdetection-delete-group-javascript-snippets.md b/includes/snippets/javascript/v1/tutorial-riskdetection-delete-group-javascript-snippets.md index 1b74a31b970..4100084d946 100644 --- a/includes/snippets/javascript/v1/tutorial-riskdetection-delete-group-javascript-snippets.md +++ b/includes/snippets/javascript/v1/tutorial-riskdetection-delete-group-javascript-snippets.md @@ -10,7 +10,7 @@ const options = { const client = Client.init(options); -await client.api('/groups/9ad78153-b1f8-4714-adc1-1445727678a8') +await client.api('/identity/conditionalAccess/policies/9ad78153-b1f8-4714-adc1-1445727678a8') .delete(); ``` \ No newline at end of file diff --git a/includes/snippets/php/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-php-snippets.md b/includes/snippets/php/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-php-snippets.md deleted file mode 100644 index 4a892ddc94b..00000000000 --- a/includes/snippets/php/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-php-snippets.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```php - -setCatalogId('cec5d6ab-c75d-47c0-9c1c-92e89f66e384'); -$requestBody->setRequestType('AdminAdd'); -$requestBody->setJustification(''); -$accessPackageResource = new AccessPackageResource(); -$accessPackageResource->setDisplayName('Marketing resources'); -$accessPackageResource->setDescription('Marketing group'); -$accessPackageResource->setResourceType('AadGroup'); -$accessPackageResource->setOriginId('e93e24d1-2b65-4a6c-a1dd-654a12225487'); -$accessPackageResource->setOriginSystem('AadGroup'); -$requestBody->setAccessPackageResource($accessPackageResource); - -$result = $graphServiceClient->identityGovernance()->entitlementManagement()->accessPackageResourceRequests()->post($requestBody)->wait(); - -``` \ No newline at end of file diff --git a/includes/snippets/php/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-php-snippets.md b/includes/snippets/php/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-php-snippets.md deleted file mode 100644 index 318804d5c29..00000000000 --- a/includes/snippets/php/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-php-snippets.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```php - -filter = "(originSystem eq 'AadGroup' and accessPackageResource/id eq '4a1e21c5-8a76-4578-acb1-641160e076e8' and displayName eq 'Member')"; -$queryParameters->expand = ["accessPackageResource"]; -$requestConfiguration->queryParameters = $queryParameters; - - -$result = $graphServiceClient->identityGovernance()->entitlementManagement()->accessPackageCatalogs()->byAccessPackageCatalogId('accessPackageCatalog-id')->accessPackageResourceRoles()->get($requestConfiguration)->wait(); - -``` \ No newline at end of file diff --git a/includes/snippets/php/beta/tutorial-entitlementmanagement-get-accesspackageresourcerolescope-php-snippets.md b/includes/snippets/php/beta/tutorial-entitlementmanagement-get-accesspackageresourcerolescope-php-snippets.md deleted file mode 100644 index 04ca84c7591..00000000000 --- a/includes/snippets/php/beta/tutorial-entitlementmanagement-get-accesspackageresourcerolescope-php-snippets.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```php - -setOriginId('Member_e93e24d1-2b65-4a6c-a1dd-654a12225487'); -$accessPackageResourceRole->setDisplayName('Member'); -$accessPackageResourceRole->setOriginSystem('AadGroup'); -$accessPackageResourceRoleAccessPackageResource = new AccessPackageResource(); -$accessPackageResourceRoleAccessPackageResource->setId('4a1e21c5-8a76-4578-acb1-641160e076e8'); -$accessPackageResourceRoleAccessPackageResource->setResourceType('Security Group'); -$accessPackageResourceRoleAccessPackageResource->setOriginId('e93e24d1-2b65-4a6c-a1dd-654a12225487'); -$accessPackageResourceRoleAccessPackageResource->setOriginSystem('AadGroup'); -$accessPackageResourceRole->setAccessPackageResource($accessPackageResourceRoleAccessPackageResource); -$requestBody->setAccessPackageResourceRole($accessPackageResourceRole); -$accessPackageResourceScope = new AccessPackageResourceScope(); -$accessPackageResourceScope->setOriginId('e93e24d1-2b65-4a6c-a1dd-654a12225487'); -$accessPackageResourceScope->setOriginSystem('AadGroup'); -$requestBody->setAccessPackageResourceScope($accessPackageResourceScope); - -$result = $graphServiceClient->identityGovernance()->entitlementManagement()->accessPackages()->byAccessPackageId('accessPackage-id')->accessPackageResourceRoleScopes()->post($requestBody)->wait(); - -``` \ No newline at end of file diff --git a/includes/snippets/php/beta/tutorial-entitlementmanagement-get-accesspackageresources-php-snippets.md b/includes/snippets/php/beta/tutorial-entitlementmanagement-get-accesspackageresources-php-snippets.md deleted file mode 100644 index f4f12ca1cb6..00000000000 --- a/includes/snippets/php/beta/tutorial-entitlementmanagement-get-accesspackageresources-php-snippets.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```php - -filter = "(displayName eq 'Marketing resources')"; -$requestConfiguration->queryParameters = $queryParameters; - - -$result = $graphServiceClient->identityGovernance()->entitlementManagement()->accessPackageCatalogs()->byAccessPackageCatalogId('accessPackageCatalog-id')->accessPackageResources()->get($requestConfiguration)->wait(); - -``` \ No newline at end of file diff --git a/includes/snippets/php/beta/tutorial-entitlementmanagement-create-accesspackage-php-snippets.md b/includes/snippets/php/v1/tutorial-entitlementmanagement-create-accesspackage-php-snippets.md similarity index 77% rename from includes/snippets/php/beta/tutorial-entitlementmanagement-create-accesspackage-php-snippets.md rename to includes/snippets/php/v1/tutorial-entitlementmanagement-create-accesspackage-php-snippets.md index a337b79e482..97e9afe8a28 100644 --- a/includes/snippets/php/beta/tutorial-entitlementmanagement-create-accesspackage-php-snippets.md +++ b/includes/snippets/php/v1/tutorial-entitlementmanagement-create-accesspackage-php-snippets.md @@ -10,9 +10,12 @@ description: "Automatically generated file. DO NOT MODIFY" $graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes); $requestBody = new AccessPackage(); -$requestBody->setCatalogId('cec5d6ab-c75d-47c0-9c1c-92e89f66e384'); $requestBody->setDisplayName('Marketing Campaign'); $requestBody->setDescription('Access to resources for the campaign'); +$additionalData = [ + 'catalogId' => 'cec5d6ab-c75d-47c0-9c1c-92e89f66e384', +]; +$requestBody->setAdditionalData($additionalData); $result = $graphServiceClient->identityGovernance()->entitlementManagement()->accessPackages()->post($requestBody)->wait(); diff --git a/includes/snippets/php/v1/tutorial-entitlementmanagement-create-group-php-snippets.md b/includes/snippets/php/v1/tutorial-entitlementmanagement-create-group-php-snippets.md deleted file mode 100644 index 19f8b3af9a3..00000000000 --- a/includes/snippets/php/v1/tutorial-entitlementmanagement-create-group-php-snippets.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```php - -setDescription('Marketing group'); -$requestBody->setDisplayName('Marketing resources'); -$requestBody->setMailEnabled(false); -$requestBody->setMailNickname('markres'); -$requestBody->setSecurityEnabled(true); - -$result = $graphServiceClient->groups()->post($requestBody)->wait(); - -``` \ No newline at end of file diff --git a/includes/snippets/php/v1/tutorial-entitlementmanagement-create-user-php-snippets.md b/includes/snippets/php/v1/tutorial-entitlementmanagement-create-user-php-snippets.md deleted file mode 100644 index a352785a1a0..00000000000 --- a/includes/snippets/php/v1/tutorial-entitlementmanagement-create-user-php-snippets.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```php - -setAccountEnabled(true); -$requestBody->setDisplayName('Requestor1'); -$requestBody->setMailNickname('Requestor1'); -$requestBody->setUserPrincipalName('Requestor1@contoso.com'); -$passwordProfile = new PasswordProfile(); -$passwordProfile->setForceChangePasswordNextSignIn(true); -$passwordProfile->setPassword('Contoso1234'); -$requestBody->setPasswordProfile($passwordProfile); - -$result = $graphServiceClient->users()->post($requestBody)->wait(); - -``` \ No newline at end of file diff --git a/includes/snippets/php/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-php-snippets.md b/includes/snippets/php/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-php-snippets.md similarity index 56% rename from includes/snippets/php/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-php-snippets.md rename to includes/snippets/php/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-php-snippets.md index e9fe0258a1e..d001b145a0d 100644 --- a/includes/snippets/php/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-php-snippets.md +++ b/includes/snippets/php/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-php-snippets.md @@ -9,12 +9,12 @@ description: "Automatically generated file. DO NOT MODIFY" $graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes); -$requestConfiguration = new AccessPackageCatalogsRequestBuilderGetRequestConfiguration(); -$queryParameters = AccessPackageCatalogsRequestBuilderGetRequestConfiguration::createQueryParameters(); +$requestConfiguration = new CatalogsRequestBuilderGetRequestConfiguration(); +$queryParameters = CatalogsRequestBuilderGetRequestConfiguration::createQueryParameters(); $queryParameters->filter = "(displayName eq 'General')"; $requestConfiguration->queryParameters = $queryParameters; -$result = $graphServiceClient->identityGovernance()->entitlementManagement()->accessPackageCatalogs()->get($requestConfiguration)->wait(); +$result = $graphServiceClient->identityGovernance()->entitlementManagement()->catalogs()->get($requestConfiguration)->wait(); ``` \ No newline at end of file diff --git a/includes/snippets/php/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-php-snippets.md b/includes/snippets/php/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-php-snippets.md new file mode 100644 index 00000000000..0f9619176b7 --- /dev/null +++ b/includes/snippets/php/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-php-snippets.md @@ -0,0 +1,27 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```php + +setRequestType(new AccessPackageRequestType('adminAdd')); +$additionalData = [ + 'catalogId' => 'cec5d6ab-c75d-47c0-9c1c-92e89f66e384', + 'justification' => '', + 'accessPackageResource' => [ + 'resourceType' => 'AadGroup', + 'originId' => 'e93e24d1-2b65-4a6c-a1dd-654a12225487', + 'originSystem' => 'AadGroup', + ], +]; +$requestBody->setAdditionalData($additionalData); + +$result = $graphServiceClient->identityGovernance()->entitlementManagement()->resourceRequests()->post($requestBody)->wait(); + +``` \ No newline at end of file diff --git a/includes/snippets/php/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-php-snippets.md b/includes/snippets/php/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-php-snippets.md new file mode 100644 index 00000000000..941b62adfd6 --- /dev/null +++ b/includes/snippets/php/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-php-snippets.md @@ -0,0 +1,21 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```php + +filter = "(originSystem eq 'AadGroup' and displayName eq 'Member' and resource/id eq '274a1e21c5-8a76-4578-acb1-641160e076e')"; +$queryParameters->expand = ["resource"]; +$requestConfiguration->queryParameters = $queryParameters; + + +$result = $graphServiceClient->identityGovernance()->entitlementManagement()->catalogs()->byAccessPackageCatalogId('accessPackageCatalog-id')->resourceRoles()->get($requestConfiguration)->wait(); + +``` \ No newline at end of file diff --git a/includes/snippets/php/v1/tutorial-entitlementmanagement-get-accesspackageresources-php-snippets.md b/includes/snippets/php/v1/tutorial-entitlementmanagement-get-accesspackageresources-php-snippets.md new file mode 100644 index 00000000000..1cc3fa90518 --- /dev/null +++ b/includes/snippets/php/v1/tutorial-entitlementmanagement-get-accesspackageresources-php-snippets.md @@ -0,0 +1,20 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```php + +filter = "originId eq 'e93e24d1-2b65-4a6c-a1dd-654a12225487'"; +$requestConfiguration->queryParameters = $queryParameters; + + +$result = $graphServiceClient->identityGovernance()->entitlementManagement()->catalogs()->byAccessPackageCatalogId('accessPackageCatalog-id')->resources()->get($requestConfiguration)->wait(); + +``` \ No newline at end of file diff --git a/includes/snippets/php/v1/tutorial-riskdetection-create-user-php-snippets.md b/includes/snippets/php/v1/tutorial-riskdetection-create-user-php-snippets.md deleted file mode 100644 index c76e0f2bc26..00000000000 --- a/includes/snippets/php/v1/tutorial-riskdetection-create-user-php-snippets.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```php - -setAccountEnabled(true); -$requestBody->setDisplayName('MyTestUser1'); -$requestBody->setMailNickname('MyTestUser1'); -$requestBody->setUserPrincipalName('MyTestUser1@contoso.com'); -$passwordProfile = new PasswordProfile(); -$passwordProfile->setForceChangePasswordNextSignIn(true); -$passwordProfile->setPassword('Contoso1234'); -$requestBody->setPasswordProfile($passwordProfile); - -$result = $graphServiceClient->users()->post($requestBody)->wait(); - -``` \ No newline at end of file diff --git a/includes/snippets/php/v1/tutorial-riskdetection-delete-group-php-snippets.md b/includes/snippets/php/v1/tutorial-riskdetection-delete-group-php-snippets.md index d0f22039a34..9049e7869ff 100644 --- a/includes/snippets/php/v1/tutorial-riskdetection-delete-group-php-snippets.md +++ b/includes/snippets/php/v1/tutorial-riskdetection-delete-group-php-snippets.md @@ -10,6 +10,6 @@ description: "Automatically generated file. DO NOT MODIFY" $graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes); -$graphServiceClient->groups()->byGroupId('group-id')->delete()->wait(); +$graphServiceClient->identity()->conditionalAccess()->policies()->byConditionalAccessPolicyId('conditionalAccessPolicy-id')->delete()->wait(); ``` \ No newline at end of file diff --git a/includes/snippets/php/v1/tutorial-riskdetection-get-riskdetections-filter-php-snippets.md b/includes/snippets/php/v1/tutorial-riskdetection-get-riskdetections-filter-php-snippets.md deleted file mode 100644 index 7f769019a0d..00000000000 --- a/includes/snippets/php/v1/tutorial-riskdetection-get-riskdetections-filter-php-snippets.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```php - -filter = "userDisplayName eq 'MyTestUser1'"; -$requestConfiguration->queryParameters = $queryParameters; - - -$result = $graphServiceClient->identityProtection()->riskDetections()->get($requestConfiguration)->wait(); - -``` \ No newline at end of file diff --git a/includes/snippets/php/v1/tutorial-riskdetection-riskyuserslist-php-snippets.md b/includes/snippets/php/v1/tutorial-riskdetection-riskyuserslist-php-snippets.md deleted file mode 100644 index bb0cc91a17f..00000000000 --- a/includes/snippets/php/v1/tutorial-riskdetection-riskyuserslist-php-snippets.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```php - -filter = "userDisplayName eq 'MyTestUser1'"; -$requestConfiguration->queryParameters = $queryParameters; - - -$result = $graphServiceClient->identityProtection()->riskyUsers()->get($requestConfiguration)->wait(); - -``` \ No newline at end of file diff --git a/includes/snippets/powershell/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-powershell-snippets.md b/includes/snippets/powershell/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-powershell-snippets.md deleted file mode 100644 index 9868e589258..00000000000 --- a/includes/snippets/powershell/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-powershell-snippets.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```powershell - -Import-Module Microsoft.Graph.Beta.Identity.Governance - -Get-MgBetaEntitlementManagementAccessPackageCatalog -Filter "(displayName eq 'General')" - -``` \ No newline at end of file diff --git a/includes/snippets/powershell/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-powershell-snippets.md b/includes/snippets/powershell/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-powershell-snippets.md deleted file mode 100644 index 3b45fe90080..00000000000 --- a/includes/snippets/powershell/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-powershell-snippets.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```powershell - -Import-Module Microsoft.Graph.Beta.Identity.Governance - -Get-MgBetaEntitlementManagementAccessPackageCatalogAccessPackageResourceRole -AccessPackageCatalogId $accessPackageCatalogId -Filter "(originSystem eq 'AadGroup' and accessPackageResource/id eq '4a1e21c5-8a76-4578-acb1-641160e076e8' and displayName eq 'Member')" -ExpandProperty "accessPackageResource" - -``` \ No newline at end of file diff --git a/includes/snippets/powershell/beta/tutorial-entitlementmanagement-get-accesspackageresourcerolescope-powershell-snippets.md b/includes/snippets/powershell/beta/tutorial-entitlementmanagement-get-accesspackageresourcerolescope-powershell-snippets.md deleted file mode 100644 index fdb51d4eb61..00000000000 --- a/includes/snippets/powershell/beta/tutorial-entitlementmanagement-get-accesspackageresourcerolescope-powershell-snippets.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```powershell - -Import-Module Microsoft.Graph.Beta.Identity.Governance - -$params = @{ - accessPackageResourceRole = @{ - originId = "Member_e93e24d1-2b65-4a6c-a1dd-654a12225487" - displayName = "Member" - originSystem = "AadGroup" - accessPackageResource = @{ - id = "4a1e21c5-8a76-4578-acb1-641160e076e8" - resourceType = "Security Group" - originId = "e93e24d1-2b65-4a6c-a1dd-654a12225487" - originSystem = "AadGroup" - } - } - accessPackageResourceScope = @{ - originId = "e93e24d1-2b65-4a6c-a1dd-654a12225487" - originSystem = "AadGroup" - } -} - -New-MgBetaEntitlementManagementAccessPackageResourceRoleScope -AccessPackageId $accessPackageId -BodyParameter $params - -``` \ No newline at end of file diff --git a/includes/snippets/powershell/beta/tutorial-entitlementmanagement-get-accesspackageresources-powershell-snippets.md b/includes/snippets/powershell/beta/tutorial-entitlementmanagement-get-accesspackageresources-powershell-snippets.md deleted file mode 100644 index 9abf2f14338..00000000000 --- a/includes/snippets/powershell/beta/tutorial-entitlementmanagement-get-accesspackageresources-powershell-snippets.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```powershell - -Import-Module Microsoft.Graph.Beta.Identity.Governance - -Get-MgBetaEntitlementManagementAccessPackageCatalogAccessPackageResource -AccessPackageCatalogId $accessPackageCatalogId -Filter "(displayName eq 'Marketing resources')" - -``` \ No newline at end of file diff --git a/includes/snippets/powershell/beta/tutorial-entitlementmanagement-create-accesspackage-powershell-snippets.md b/includes/snippets/powershell/v1/tutorial-entitlementmanagement-create-accesspackage-powershell-snippets.md similarity index 66% rename from includes/snippets/powershell/beta/tutorial-entitlementmanagement-create-accesspackage-powershell-snippets.md rename to includes/snippets/powershell/v1/tutorial-entitlementmanagement-create-accesspackage-powershell-snippets.md index a35991c4bce..510911b1938 100644 --- a/includes/snippets/powershell/beta/tutorial-entitlementmanagement-create-accesspackage-powershell-snippets.md +++ b/includes/snippets/powershell/v1/tutorial-entitlementmanagement-create-accesspackage-powershell-snippets.md @@ -4,7 +4,7 @@ description: "Automatically generated file. DO NOT MODIFY" ```powershell -Import-Module Microsoft.Graph.Beta.Identity.Governance +Import-Module Microsoft.Graph.Identity.Governance $params = @{ catalogId = "cec5d6ab-c75d-47c0-9c1c-92e89f66e384" @@ -12,6 +12,6 @@ $params = @{ description = "Access to resources for the campaign" } -New-MgBetaEntitlementManagementAccessPackage -BodyParameter $params +New-MgEntitlementManagementAccessPackage -BodyParameter $params ``` \ No newline at end of file diff --git a/includes/snippets/powershell/v1/tutorial-entitlementmanagement-create-group-powershell-snippets.md b/includes/snippets/powershell/v1/tutorial-entitlementmanagement-create-group-powershell-snippets.md deleted file mode 100644 index 66212be713c..00000000000 --- a/includes/snippets/powershell/v1/tutorial-entitlementmanagement-create-group-powershell-snippets.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```powershell - -Import-Module Microsoft.Graph.Groups - -$params = @{ - description = "Marketing group" - displayName = "Marketing resources" - mailEnabled = $false - mailNickname = "markres" - securityEnabled = $true -} - -New-MgGroup -BodyParameter $params - -``` \ No newline at end of file diff --git a/includes/snippets/powershell/v1/tutorial-entitlementmanagement-create-user-powershell-snippets.md b/includes/snippets/powershell/v1/tutorial-entitlementmanagement-create-user-powershell-snippets.md deleted file mode 100644 index 9d42e1b07bd..00000000000 --- a/includes/snippets/powershell/v1/tutorial-entitlementmanagement-create-user-powershell-snippets.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```powershell - -Import-Module Microsoft.Graph.Users - -$params = @{ - accountEnabled = $true - displayName = "Requestor1" - mailNickname = "Requestor1" - userPrincipalName = "Requestor1@contoso.com" - passwordProfile = @{ - forceChangePasswordNextSignIn = $true - password = "Contoso1234" - } -} - -New-MgUser -BodyParameter $params - -``` \ No newline at end of file diff --git a/includes/snippets/powershell/v1/tutorial-entitlementmanagement-delete-group-powershell-snippets.md b/includes/snippets/powershell/v1/tutorial-entitlementmanagement-delete-group-powershell-snippets.md deleted file mode 100644 index b5a0412ce58..00000000000 --- a/includes/snippets/powershell/v1/tutorial-entitlementmanagement-delete-group-powershell-snippets.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```powershell - -Import-Module Microsoft.Graph.Groups - -Remove-MgGroup -GroupId $groupId - -``` \ No newline at end of file diff --git a/includes/snippets/powershell/v1/tutorial-entitlementmanagement-delete-user-powershell-snippets.md b/includes/snippets/powershell/v1/tutorial-entitlementmanagement-delete-user-powershell-snippets.md deleted file mode 100644 index 3120ab7e643..00000000000 --- a/includes/snippets/powershell/v1/tutorial-entitlementmanagement-delete-user-powershell-snippets.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```powershell - -Import-Module Microsoft.Graph.Users - -Remove-MgUser -UserId $userId - -``` \ No newline at end of file diff --git a/includes/snippets/powershell/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-powershell-snippets.md b/includes/snippets/powershell/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-powershell-snippets.md new file mode 100644 index 00000000000..38e0431b81c --- /dev/null +++ b/includes/snippets/powershell/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-powershell-snippets.md @@ -0,0 +1,11 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```powershell + +Import-Module Microsoft.Graph.Identity.Governance + +Get-MgEntitlementManagementCatalog -Filter "(displayName eq 'General')" + +``` \ No newline at end of file diff --git a/includes/snippets/powershell/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-powershell-snippets.md b/includes/snippets/powershell/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-powershell-snippets.md similarity index 61% rename from includes/snippets/powershell/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-powershell-snippets.md rename to includes/snippets/powershell/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-powershell-snippets.md index af657840ccf..979d5d2d84a 100644 --- a/includes/snippets/powershell/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-powershell-snippets.md +++ b/includes/snippets/powershell/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-powershell-snippets.md @@ -4,21 +4,19 @@ description: "Automatically generated file. DO NOT MODIFY" ```powershell -Import-Module Microsoft.Graph.Beta.Identity.Governance +Import-Module Microsoft.Graph.Identity.Governance $params = @{ catalogId = "cec5d6ab-c75d-47c0-9c1c-92e89f66e384" requestType = "AdminAdd" justification = "" accessPackageResource = @{ - displayName = "Marketing resources" - description = "Marketing group" resourceType = "AadGroup" originId = "e93e24d1-2b65-4a6c-a1dd-654a12225487" originSystem = "AadGroup" } } -New-MgBetaEntitlementManagementAccessPackageResourceRequest -BodyParameter $params +New-MgEntitlementManagementResourceRequest -BodyParameter $params ``` \ No newline at end of file diff --git a/includes/snippets/powershell/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-powershell-snippets.md b/includes/snippets/powershell/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-powershell-snippets.md new file mode 100644 index 00000000000..669bab7925a --- /dev/null +++ b/includes/snippets/powershell/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-powershell-snippets.md @@ -0,0 +1,11 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```powershell + +Import-Module Microsoft.Graph.Identity.Governance + +Get-MgEntitlementManagementCatalogResourceRole -AccessPackageCatalogId $accessPackageCatalogId -Filter "(originSystem eq 'AadGroup' and displayName eq 'Member' and resource/id eq '274a1e21c5-8a76-4578-acb1-641160e076e')" -ExpandProperty "resource" + +``` \ No newline at end of file diff --git a/includes/snippets/powershell/v1/tutorial-entitlementmanagement-get-accesspackageresources-powershell-snippets.md b/includes/snippets/powershell/v1/tutorial-entitlementmanagement-get-accesspackageresources-powershell-snippets.md new file mode 100644 index 00000000000..6ff4547f135 --- /dev/null +++ b/includes/snippets/powershell/v1/tutorial-entitlementmanagement-get-accesspackageresources-powershell-snippets.md @@ -0,0 +1,11 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```powershell + +Import-Module Microsoft.Graph.Identity.Governance + +Get-MgEntitlementManagementCatalogResource -AccessPackageCatalogId $accessPackageCatalogId -Filter "originId eq 'e93e24d1-2b65-4a6c-a1dd-654a12225487'" + +``` \ No newline at end of file diff --git a/includes/snippets/powershell/v1/tutorial-riskdetection-create-user-powershell-snippets.md b/includes/snippets/powershell/v1/tutorial-riskdetection-create-user-powershell-snippets.md deleted file mode 100644 index 77844a16d57..00000000000 --- a/includes/snippets/powershell/v1/tutorial-riskdetection-create-user-powershell-snippets.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```powershell - -Import-Module Microsoft.Graph.Users - -$params = @{ - accountEnabled = $true - displayName = "MyTestUser1" - mailNickname = "MyTestUser1" - userPrincipalName = "MyTestUser1@contoso.com" - passwordProfile = @{ - forceChangePasswordNextSignIn = $true - password = "Contoso1234" - } -} - -New-MgUser -BodyParameter $params - -``` \ No newline at end of file diff --git a/includes/snippets/powershell/v1/tutorial-riskdetection-delete-group-powershell-snippets.md b/includes/snippets/powershell/v1/tutorial-riskdetection-delete-group-powershell-snippets.md index b5a0412ce58..3fe5f9173e8 100644 --- a/includes/snippets/powershell/v1/tutorial-riskdetection-delete-group-powershell-snippets.md +++ b/includes/snippets/powershell/v1/tutorial-riskdetection-delete-group-powershell-snippets.md @@ -4,8 +4,8 @@ description: "Automatically generated file. DO NOT MODIFY" ```powershell -Import-Module Microsoft.Graph.Groups +Import-Module Microsoft.Graph.Identity.SignIns -Remove-MgGroup -GroupId $groupId +Remove-MgIdentityConditionalAccessPolicy -ConditionalAccessPolicyId $conditionalAccessPolicyId ``` \ No newline at end of file diff --git a/includes/snippets/powershell/v1/tutorial-riskdetection-delete-user-powershell-snippets.md b/includes/snippets/powershell/v1/tutorial-riskdetection-delete-user-powershell-snippets.md deleted file mode 100644 index 3120ab7e643..00000000000 --- a/includes/snippets/powershell/v1/tutorial-riskdetection-delete-user-powershell-snippets.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```powershell - -Import-Module Microsoft.Graph.Users - -Remove-MgUser -UserId $userId - -``` \ No newline at end of file diff --git a/includes/snippets/powershell/v1/tutorial-riskdetection-get-riskdetections-filter-powershell-snippets.md b/includes/snippets/powershell/v1/tutorial-riskdetection-get-riskdetections-filter-powershell-snippets.md deleted file mode 100644 index 697be4e8fc7..00000000000 --- a/includes/snippets/powershell/v1/tutorial-riskdetection-get-riskdetections-filter-powershell-snippets.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```powershell - -Import-Module Microsoft.Graph.Identity.SignIns - -Get-MgRiskDetection -Filter "userDisplayName eq 'MyTestUser1'" - -``` \ No newline at end of file diff --git a/includes/snippets/powershell/v1/tutorial-riskdetection-riskyuserslist-powershell-snippets.md b/includes/snippets/powershell/v1/tutorial-riskdetection-riskyuserslist-powershell-snippets.md deleted file mode 100644 index 155ae5373b7..00000000000 --- a/includes/snippets/powershell/v1/tutorial-riskdetection-riskyuserslist-powershell-snippets.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```powershell - -Import-Module Microsoft.Graph.Identity.SignIns - -Get-MgRiskyUser -Filter "userDisplayName eq 'MyTestUser1'" - -``` \ No newline at end of file diff --git a/includes/snippets/python/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-python-snippets.md b/includes/snippets/python/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-python-snippets.md deleted file mode 100644 index 1eeed21f3ce..00000000000 --- a/includes/snippets/python/beta/tutorial-entitlementmanagement-get-accesspackagecatalog-python-snippets.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```python - -from msgraph import GraphServiceClient -from msgraph.generated.identityGovernance.entitlementManagement.accessPackageCatalogs.access_package_catalogs_request_builder import AccessPackageCatalogsRequestBuilder - -graph_client = GraphServiceClient(credentials, scopes) - -query_params = AccessPackageCatalogsRequestBuilder.AccessPackageCatalogsRequestBuilderGetQueryParameters( - filter = "(displayName eq 'General')", -) - -request_configuration = AccessPackageCatalogsRequestBuilder.AccessPackageCatalogsRequestBuilderGetRequestConfiguration( -query_parameters = query_params, -) - -result = await graph_client.identity_governance.entitlement_management.access_package_catalogs.get(request_configuration = request_configuration) - - -``` \ No newline at end of file diff --git a/includes/snippets/python/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-python-snippets.md b/includes/snippets/python/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-python-snippets.md deleted file mode 100644 index 07400ed49d7..00000000000 --- a/includes/snippets/python/beta/tutorial-entitlementmanagement-get-accesspackageresourcerequest-python-snippets.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```python - -from msgraph import GraphServiceClient -from msgraph.generated.models.access_package_resource_request import AccessPackageResourceRequest -from msgraph.generated.models.access_package_resource import AccessPackageResource - -graph_client = GraphServiceClient(credentials, scopes) - -request_body = AccessPackageResourceRequest( - catalog_id = "cec5d6ab-c75d-47c0-9c1c-92e89f66e384", - request_type = "AdminAdd", - justification = "", - access_package_resource = AccessPackageResource( - display_name = "Marketing resources", - description = "Marketing group", - resource_type = "AadGroup", - origin_id = "e93e24d1-2b65-4a6c-a1dd-654a12225487", - origin_system = "AadGroup", - ), -) - -result = await graph_client.identity_governance.entitlement_management.access_package_resource_requests.post(request_body) - - -``` \ No newline at end of file diff --git a/includes/snippets/python/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-python-snippets.md b/includes/snippets/python/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-python-snippets.md deleted file mode 100644 index ea5e6e31562..00000000000 --- a/includes/snippets/python/beta/tutorial-entitlementmanagement-get-accesspackageresourceroles-python-snippets.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```python - -from msgraph import GraphServiceClient -from msgraph.generated.identityGovernance.entitlementManagement.accessPackageCatalogs.item.accessPackageResourceRoles.access_package_resource_roles_request_builder import AccessPackageResourceRolesRequestBuilder - -graph_client = GraphServiceClient(credentials, scopes) - -query_params = AccessPackageResourceRolesRequestBuilder.AccessPackageResourceRolesRequestBuilderGetQueryParameters( - filter = "(originSystem eq 'AadGroup' and accessPackageResource/id eq '4a1e21c5-8a76-4578-acb1-641160e076e8' and displayName eq 'Member')", - expand = ["accessPackageResource"], -) - -request_configuration = AccessPackageResourceRolesRequestBuilder.AccessPackageResourceRolesRequestBuilderGetRequestConfiguration( -query_parameters = query_params, -) - -result = await graph_client.identity_governance.entitlement_management.access_package_catalogs.by_access_package_catalog_id('accessPackageCatalog-id').access_package_resource_roles.get(request_configuration = request_configuration) - - -``` \ No newline at end of file diff --git a/includes/snippets/python/beta/tutorial-entitlementmanagement-get-accesspackageresourcerolescope-python-snippets.md b/includes/snippets/python/beta/tutorial-entitlementmanagement-get-accesspackageresourcerolescope-python-snippets.md deleted file mode 100644 index 7de0e40989e..00000000000 --- a/includes/snippets/python/beta/tutorial-entitlementmanagement-get-accesspackageresourcerolescope-python-snippets.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```python - -from msgraph import GraphServiceClient -from msgraph.generated.models.access_package_resource_role_scope import AccessPackageResourceRoleScope -from msgraph.generated.models.access_package_resource_role import AccessPackageResourceRole -from msgraph.generated.models.access_package_resource import AccessPackageResource -from msgraph.generated.models.access_package_resource_scope import AccessPackageResourceScope - -graph_client = GraphServiceClient(credentials, scopes) - -request_body = AccessPackageResourceRoleScope( - access_package_resource_role = AccessPackageResourceRole( - origin_id = "Member_e93e24d1-2b65-4a6c-a1dd-654a12225487", - display_name = "Member", - origin_system = "AadGroup", - access_package_resource = AccessPackageResource( - id = "4a1e21c5-8a76-4578-acb1-641160e076e8", - resource_type = "Security Group", - origin_id = "e93e24d1-2b65-4a6c-a1dd-654a12225487", - origin_system = "AadGroup", - ), - ), - access_package_resource_scope = AccessPackageResourceScope( - origin_id = "e93e24d1-2b65-4a6c-a1dd-654a12225487", - origin_system = "AadGroup", - ), -) - -result = await graph_client.identity_governance.entitlement_management.access_packages.by_access_package_id('accessPackage-id').access_package_resource_role_scopes.post(request_body) - - -``` \ No newline at end of file diff --git a/includes/snippets/python/beta/tutorial-entitlementmanagement-get-accesspackageresources-python-snippets.md b/includes/snippets/python/beta/tutorial-entitlementmanagement-get-accesspackageresources-python-snippets.md deleted file mode 100644 index 6ab7c1b0c65..00000000000 --- a/includes/snippets/python/beta/tutorial-entitlementmanagement-get-accesspackageresources-python-snippets.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```python - -from msgraph import GraphServiceClient -from msgraph.generated.identityGovernance.entitlementManagement.accessPackageCatalogs.item.accessPackageResources.access_package_resources_request_builder import AccessPackageResourcesRequestBuilder - -graph_client = GraphServiceClient(credentials, scopes) - -query_params = AccessPackageResourcesRequestBuilder.AccessPackageResourcesRequestBuilderGetQueryParameters( - filter = "(displayName eq 'Marketing resources')", -) - -request_configuration = AccessPackageResourcesRequestBuilder.AccessPackageResourcesRequestBuilderGetRequestConfiguration( -query_parameters = query_params, -) - -result = await graph_client.identity_governance.entitlement_management.access_package_catalogs.by_access_package_catalog_id('accessPackageCatalog-id').access_package_resources.get(request_configuration = request_configuration) - - -``` \ No newline at end of file diff --git a/includes/snippets/python/beta/tutorial-entitlementmanagement-create-accesspackage-python-snippets.md b/includes/snippets/python/v1/tutorial-entitlementmanagement-create-accesspackage-python-snippets.md similarity index 85% rename from includes/snippets/python/beta/tutorial-entitlementmanagement-create-accesspackage-python-snippets.md rename to includes/snippets/python/v1/tutorial-entitlementmanagement-create-accesspackage-python-snippets.md index 8116c0fe867..009dd641915 100644 --- a/includes/snippets/python/beta/tutorial-entitlementmanagement-create-accesspackage-python-snippets.md +++ b/includes/snippets/python/v1/tutorial-entitlementmanagement-create-accesspackage-python-snippets.md @@ -10,9 +10,11 @@ from msgraph.generated.models.access_package import AccessPackage graph_client = GraphServiceClient(credentials, scopes) request_body = AccessPackage( - catalog_id = "cec5d6ab-c75d-47c0-9c1c-92e89f66e384", display_name = "Marketing Campaign", description = "Access to resources for the campaign", + additional_data = { + "catalog_id" : "cec5d6ab-c75d-47c0-9c1c-92e89f66e384", + } ) result = await graph_client.identity_governance.entitlement_management.access_packages.post(request_body) diff --git a/includes/snippets/python/v1/tutorial-entitlementmanagement-create-group-python-snippets.md b/includes/snippets/python/v1/tutorial-entitlementmanagement-create-group-python-snippets.md deleted file mode 100644 index a6c6d870dad..00000000000 --- a/includes/snippets/python/v1/tutorial-entitlementmanagement-create-group-python-snippets.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```python - -from msgraph import GraphServiceClient -from msgraph.generated.models.group import Group - -graph_client = GraphServiceClient(credentials, scopes) - -request_body = Group( - description = "Marketing group", - display_name = "Marketing resources", - mail_enabled = False, - mail_nickname = "markres", - security_enabled = True, -) - -result = await graph_client.groups.post(request_body) - - -``` \ No newline at end of file diff --git a/includes/snippets/python/v1/tutorial-entitlementmanagement-create-user-python-snippets.md b/includes/snippets/python/v1/tutorial-entitlementmanagement-create-user-python-snippets.md deleted file mode 100644 index 9149c89a313..00000000000 --- a/includes/snippets/python/v1/tutorial-entitlementmanagement-create-user-python-snippets.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```python - -from msgraph import GraphServiceClient -from msgraph.generated.models.user import User -from msgraph.generated.models.password_profile import PasswordProfile - -graph_client = GraphServiceClient(credentials, scopes) - -request_body = User( - account_enabled = True, - display_name = "Requestor1", - mail_nickname = "Requestor1", - user_principal_name = "Requestor1@contoso.com", - password_profile = PasswordProfile( - force_change_password_next_sign_in = True, - password = "Contoso1234", - ), -) - -result = await graph_client.users.post(request_body) - - -``` \ No newline at end of file diff --git a/includes/snippets/python/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-python-snippets.md b/includes/snippets/python/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-python-snippets.md new file mode 100644 index 00000000000..f4bd1d63314 --- /dev/null +++ b/includes/snippets/python/v1/tutorial-entitlementmanagement-get-accesspackagecatalog-python-snippets.md @@ -0,0 +1,23 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```python + +from msgraph import GraphServiceClient +from msgraph.generated.identityGovernance.entitlementManagement.catalogs.catalogs_request_builder import CatalogsRequestBuilder + +graph_client = GraphServiceClient(credentials, scopes) + +query_params = CatalogsRequestBuilder.CatalogsRequestBuilderGetQueryParameters( + filter = "(displayName eq 'General')", +) + +request_configuration = CatalogsRequestBuilder.CatalogsRequestBuilderGetRequestConfiguration( +query_parameters = query_params, +) + +result = await graph_client.identity_governance.entitlement_management.catalogs.get(request_configuration = request_configuration) + + +``` \ No newline at end of file diff --git a/includes/snippets/python/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-python-snippets.md b/includes/snippets/python/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-python-snippets.md new file mode 100644 index 00000000000..b5bf08bf58f --- /dev/null +++ b/includes/snippets/python/v1/tutorial-entitlementmanagement-get-accesspackageresourcerequest-python-snippets.md @@ -0,0 +1,28 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```python + +from msgraph import GraphServiceClient +from msgraph.generated.models.access_package_resource_request import AccessPackageResourceRequest + +graph_client = GraphServiceClient(credentials, scopes) + +request_body = AccessPackageResourceRequest( + request_type = AccessPackageRequestType.AdminAdd, + additional_data = { + "catalog_id" : "cec5d6ab-c75d-47c0-9c1c-92e89f66e384", + "justification" : "", + "access_package_resource" : { + "resource_type" : "AadGroup", + "origin_id" : "e93e24d1-2b65-4a6c-a1dd-654a12225487", + "origin_system" : "AadGroup", + }, + } +) + +result = await graph_client.identity_governance.entitlement_management.resource_requests.post(request_body) + + +``` \ No newline at end of file diff --git a/includes/snippets/python/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-python-snippets.md b/includes/snippets/python/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-python-snippets.md new file mode 100644 index 00000000000..2e99ce02671 --- /dev/null +++ b/includes/snippets/python/v1/tutorial-entitlementmanagement-get-accesspackageresourceroles-python-snippets.md @@ -0,0 +1,24 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```python + +from msgraph import GraphServiceClient +from msgraph.generated.identityGovernance.entitlementManagement.catalogs.item.resourceRoles.resource_roles_request_builder import ResourceRolesRequestBuilder + +graph_client = GraphServiceClient(credentials, scopes) + +query_params = ResourceRolesRequestBuilder.ResourceRolesRequestBuilderGetQueryParameters( + filter = "(originSystem eq 'AadGroup' and displayName eq 'Member' and resource/id eq '274a1e21c5-8a76-4578-acb1-641160e076e')", + expand = ["resource"], +) + +request_configuration = ResourceRolesRequestBuilder.ResourceRolesRequestBuilderGetRequestConfiguration( +query_parameters = query_params, +) + +result = await graph_client.identity_governance.entitlement_management.catalogs.by_access_package_catalog_id('accessPackageCatalog-id').resource_roles.get(request_configuration = request_configuration) + + +``` \ No newline at end of file diff --git a/includes/snippets/python/v1/tutorial-entitlementmanagement-get-accesspackageresources-python-snippets.md b/includes/snippets/python/v1/tutorial-entitlementmanagement-get-accesspackageresources-python-snippets.md new file mode 100644 index 00000000000..52dcfd39aed --- /dev/null +++ b/includes/snippets/python/v1/tutorial-entitlementmanagement-get-accesspackageresources-python-snippets.md @@ -0,0 +1,23 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```python + +from msgraph import GraphServiceClient +from msgraph.generated.identityGovernance.entitlementManagement.catalogs.item.resources.resources_request_builder import ResourcesRequestBuilder + +graph_client = GraphServiceClient(credentials, scopes) + +query_params = ResourcesRequestBuilder.ResourcesRequestBuilderGetQueryParameters( + filter = "originId eq 'e93e24d1-2b65-4a6c-a1dd-654a12225487'", +) + +request_configuration = ResourcesRequestBuilder.ResourcesRequestBuilderGetRequestConfiguration( +query_parameters = query_params, +) + +result = await graph_client.identity_governance.entitlement_management.catalogs.by_access_package_catalog_id('accessPackageCatalog-id').resources.get(request_configuration = request_configuration) + + +``` \ No newline at end of file diff --git a/includes/snippets/python/v1/tutorial-riskdetection-create-user-python-snippets.md b/includes/snippets/python/v1/tutorial-riskdetection-create-user-python-snippets.md deleted file mode 100644 index 1dff78c42f1..00000000000 --- a/includes/snippets/python/v1/tutorial-riskdetection-create-user-python-snippets.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```python - -from msgraph import GraphServiceClient -from msgraph.generated.models.user import User -from msgraph.generated.models.password_profile import PasswordProfile - -graph_client = GraphServiceClient(credentials, scopes) - -request_body = User( - account_enabled = True, - display_name = "MyTestUser1", - mail_nickname = "MyTestUser1", - user_principal_name = "MyTestUser1@contoso.com", - password_profile = PasswordProfile( - force_change_password_next_sign_in = True, - password = "Contoso1234", - ), -) - -result = await graph_client.users.post(request_body) - - -``` \ No newline at end of file diff --git a/includes/snippets/python/v1/tutorial-riskdetection-delete-group-python-snippets.md b/includes/snippets/python/v1/tutorial-riskdetection-delete-group-python-snippets.md index f62b6aedac3..e541fc972fa 100644 --- a/includes/snippets/python/v1/tutorial-riskdetection-delete-group-python-snippets.md +++ b/includes/snippets/python/v1/tutorial-riskdetection-delete-group-python-snippets.md @@ -9,7 +9,7 @@ from msgraph import GraphServiceClient graph_client = GraphServiceClient(credentials, scopes) -await graph_client.groups.by_group_id('group-id').delete() +await graph_client.identity.conditional_access.policies.by_conditional_access_policy_id('conditionalAccessPolicy-id').delete() ``` \ No newline at end of file diff --git a/includes/snippets/python/v1/tutorial-riskdetection-get-riskdetections-filter-python-snippets.md b/includes/snippets/python/v1/tutorial-riskdetection-get-riskdetections-filter-python-snippets.md deleted file mode 100644 index 2f6e4f1b1d1..00000000000 --- a/includes/snippets/python/v1/tutorial-riskdetection-get-riskdetections-filter-python-snippets.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```python - -from msgraph import GraphServiceClient -from msgraph.generated.identityProtection.riskDetections.risk_detections_request_builder import RiskDetectionsRequestBuilder - -graph_client = GraphServiceClient(credentials, scopes) - -query_params = RiskDetectionsRequestBuilder.RiskDetectionsRequestBuilderGetQueryParameters( - filter = "userDisplayName eq 'MyTestUser1'", -) - -request_configuration = RiskDetectionsRequestBuilder.RiskDetectionsRequestBuilderGetRequestConfiguration( -query_parameters = query_params, -) - -result = await graph_client.identity_protection.risk_detections.get(request_configuration = request_configuration) - - -``` \ No newline at end of file diff --git a/includes/snippets/python/v1/tutorial-riskdetection-riskyuserslist-python-snippets.md b/includes/snippets/python/v1/tutorial-riskdetection-riskyuserslist-python-snippets.md deleted file mode 100644 index f9e182d2574..00000000000 --- a/includes/snippets/python/v1/tutorial-riskdetection-riskyuserslist-python-snippets.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```python - -from msgraph import GraphServiceClient -from msgraph.generated.identityProtection.riskyUsers.risky_users_request_builder import RiskyUsersRequestBuilder - -graph_client = GraphServiceClient(credentials, scopes) - -query_params = RiskyUsersRequestBuilder.RiskyUsersRequestBuilderGetQueryParameters( - filter = "userDisplayName eq 'MyTestUser1'", -) - -request_configuration = RiskyUsersRequestBuilder.RiskyUsersRequestBuilderGetRequestConfiguration( -query_parameters = query_params, -) - -result = await graph_client.identity_protection.risky_users.get(request_configuration = request_configuration) - - -``` \ No newline at end of file