Merge pull request #25986 from microsoftgraph/main

merge to publish
microsoftgraph · Dec 27, 2024 · 74c538a · 74c538a
2 parents 5ffa728 + 67f152a
commit 74c538a
Show file tree

Hide file tree

Showing 41 changed files with 337 additions and 141 deletions.
diff --git a/api-reference/beta/api/callrecording-get.md b/api-reference/beta/api/callrecording-get.md
@@ -14,14 +14,15 @@ Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
-Get a [callRecording](../resources/callrecording.md) object associated with a scheduled [onlineMeeting](../resources/onlinemeeting.md). This API doesn't support getting call recordings from channel meetings. 
+Get a [callRecording](../resources/callrecording.md) object associated with a scheduled [onlineMeeting](../resources/onlinemeeting.md). This API supports the retrieval of call recordings from private chat meetings and channel meetings.
 
 For a recording, this API returns the metadata of the single recording associated with the online meeting. For the content of a recording, this API returns the stream of bytes associated with the recording.
 
 > [!NOTE]
 >
 > * This is a metered API. For more information, see [payment models for meeting APIs](/graph/teams-licenses#payment-models-for-meeting-apis).
 > * This API doesn't support meetings created by using the [create onlineMeeting API](/graph/api/application-post-onlinemeetings) that are not associated with an event on the user's calendar.
+> * This API might not return a call recording if multiple meetings are scheduled under a single channel post thread.
 > * This API works differently in one or more national clouds. For details, see [Microsoft Teams API implementation differences in national clouds](/graph/teamwork-national-cloud-differences).
 
 [!INCLUDE [national-cloud-support](../../includes/global-only.md)]
@@ -40,12 +41,13 @@ Choose the permission or permissions marked as least privileged for this API. Us
 > **Notes:**
 >
 > * In delegated permission scenarios, [getting callRecording content](#example-2-get-callrecording-content)  is supported only for the meeting organizer. Meeting participants don't have permission to download meeting recordings. For more information, see [permissions or role-based access](/microsoftteams/tmr-meeting-recording-change). Tenant admins can unblock meeting participants to download meeting recordings. For more information, see [block the download of Teams meeting recording files](/MicrosoftTeams/block-download-meeting-recording).
-> * The application permission `OnlineMeetingRecording.Read.Chat` uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent).
+> * The application permission `OnlineMeetingRecording.Read.Chat` uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). This permission applies only to scheduled private chat meetings, not to channel meetings.
 
 To use application permissions for this API, tenant administrators must create an application access policy and grant it to a user. It authorizes the app configured in the policy to fetch online meetings or online meeting artifacts on behalf of that user (with the user ID specified in the request path). For more information, see [Allow applications to access online meetings on behalf of a user](/graph/cloud-communication-online-meeting-application-access-policy).
 
 > [!NOTE]
-> This API works only for a meeting that hasn't expired. For more information, see [Limits and specifications for Microsoft Teams](/microsoftteams/limits-specifications-teams#meeting-expiration).
+> * This API is available for a meeting that hasn't expired. For more information, see [Limits and specifications for Microsoft Teams](/microsoftteams/limits-specifications-teams#meeting-expiration).
+> * This API is also available to users who are part of the meeting calendar invite, which applies to both private chat meetings and channel meetings.
 
 ## HTTP request
 

diff --git a/api-reference/beta/api/calltranscript-get.md b/api-reference/beta/api/calltranscript-get.md
@@ -14,14 +14,15 @@ Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
-Retrieve a [callTranscript](../resources/calltranscript.md) object associated with a scheduled [onlineMeeting](../resources/onlinemeeting.md). This API doesn't support getting call transcripts from channel meetings.
+Retrieve a [callTranscript](../resources/calltranscript.md) object associated with a scheduled [onlineMeeting](../resources/onlinemeeting.md). This API supports the retrieval of call transcripts from private chat meetings and channel meetings.
 
 Retrieving the transcript returns the metadata of the single transcript associated with the online meeting. Retrieving the content of the transcript returns the stream of text associated with the transcript.
 
 > [!NOTE]
 >
 > * This is a metered API. For more information, see [payment models for meeting APIs](/graph/teams-licenses#payment-models-for-meeting-apis).
 > * This API doesn't support meetings created using the [create onlineMeeting API](/graph/api/application-post-onlinemeetings) that are not associated with an event on the user's calendar.
+> * This API might not return a call transcript if multiple meetings are scheduled under a single channel post thread.
 > * This API works differently in one or more national clouds. For details, see [Implementation differences in national clouds](/graph/teamwork-national-cloud-differences).
 > * If you want to retrieve meeting transcripts, use the [Create event](../api/user-post-events.md#example-5-create-and-enable-an-event-as-an-online-meeting) API instead.
 
@@ -38,12 +39,13 @@ Choose the permission or permissions marked as least privileged for this API. Us
 |Delegated (personal Microsoft account)|Not supported.|Not supported.|
 |Application|OnlineMeetingTranscript.Read.All, OnlineMeetingTranscript.Read.Chat|Not available.|
 
-> **Note:** The application permission `OnlineMeetingTranscript.Read.Chat` uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent).
+> **Note:** The application permission `OnlineMeetingTranscript.Read.Chat` uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). This permission applies only to scheduled private chat meetings, not to channel meetings.
 
 To use application permissions for this API, tenant administrators must create an application access policy and grant it to a user. It authorizes the app configured in the policy to fetch online meetings and/or online meeting artifacts on behalf of that user (with the user ID specified in the request path). For more information, see [Allow applications to access online meetings on behalf of a user](/graph/cloud-communication-online-meeting-application-access-policy).
 
 > [!NOTE]
-> This API works for a meeting only if the meeting has not expired. For more information, see [Limits and specifications for Microsoft Teams](/microsoftteams/limits-specifications-teams#meeting-expiration).
+> * This API is available for a meeting that hasn't expired. For more information, see [Limits and specifications for Microsoft Teams](/microsoftteams/limits-specifications-teams#meeting-expiration).
+> * This API is also available to users who are part of the meeting calendar invite, which applies to both private chat meetings and channel meetings.
 
 ## HTTP request
 

diff --git a/api-reference/beta/api/directoryaudit-list.md b/api-reference/beta/api/directoryaudit-list.md
@@ -52,9 +52,11 @@ Don't supply a request body for this method.
 
 If successful, this method returns a `200 OK` response code and a collection of [directoryAudit](../resources/directoryaudit.md) objects in the response body.
 
-## Example
+## Examples
 
-### Request
+### Example 1: Retrieve the list of audit logs
+
+#### Request
 
 The following example shows a request.
 
@@ -102,7 +104,7 @@ GET https://graph.microsoft.com/beta/auditLogs/directoryAudits
 
 ---
 
-### Response
+#### Response
 
 The following example shows the response.
 
@@ -175,6 +177,79 @@ Content-type: application/json
 }
 ```
 
+### Example 2: Retrieve the list of audit logs with a filter on initiatedBy/user
+
+#### Request
+
+The following example shows a request.
+
+<!-- {
+  "blockType": "request",
+  "name": "get_directoryaudits_filter_initiatedby"
+}-->
+
+```http
+GET https://graph.microsoft.com/beta/auditLogs/directoryAudits?$filter=initiatedBy/user/id eq '00000000-0000-0000-0000-000000000000'
+```
+
+#### Response
+
+The following example shows the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+  "blockType": "response",
+  "truncated": true,
+  "@odata.type": "microsoft.graph.directoryAudit",
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+    "@odata.context": "https://graph.microsoft.com/beta/$metadata#auditLogs/directoryAudits",
+    "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET auditLogs/directoryAudits?$select=activityDateTime,activityDisplayName",
+    "value": [
+        {
+            "id": "SSGM_b662f17a-4e4d-4e1c-9248-cdec180024b2_MCDC4_88453290",
+            "category": "GroupManagement",
+            "correlationId": "b662f17a-4e4d-4e1c-9248-cdec180024b2",
+            "result": "success",
+            "resultReason": "OK",
+            "activityDisplayName": "GroupLifecyclePolicies_Get",
+            "activityDateTime": "2024-12-27T10:01:19.5796748Z",
+            "loggedByService": "Self-service Group Management",
+            "operationType": "Update",
+            "userAgent": null,
+            "initiatedBy": {
+                "app": null,
+                "user": {
+                    "id": "00000000-0000-0000-0000-000000000000",
+                    "displayName": null,
+                    "userPrincipalName": null,
+                    "ipAddress": "10.0.0.0",
+                    "userType": null,
+                    "homeTenantId": null,
+                    "homeTenantName": null
+                }
+            },
+            "targetResources": [
+                {
+                    "id": "00000000-0000-0000-0000-000000000000",
+                    "displayName": null,
+                    "type": "N/A",
+                    "userPrincipalName": null,
+                    "groupType": null,
+                    "modifiedProperties": []
+                }
+            ],
+            "additionalDetails": []
+        }
+    ]
+}
+```
+
 <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
 2015-10-25 14:57:30 UTC -->
 <!-- {

diff --git a/api-reference/beta/api/grouplifecyclepolicy-addgroup.md b/api-reference/beta/api/grouplifecyclepolicy-addgroup.md
@@ -1,6 +1,6 @@
 ---
 title: "groupLifecyclePolicy: addGroup"
-description: "Adds a group to a lifecycle policy."
+description: "Add a group to a lifecycle policy."
 author: "yuhko-msft"
 ms.reviewer: "mbhargav, khotzteam, aadgroupssg"
 ms.localizationpriority: medium
@@ -15,7 +15,7 @@ Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
-Adds specific groups to a lifecycle policy. This action limits the group lifecycle policy to a set of groups only if the **managedGroupTypes** property of [groupLifecyclePolicy](../resources/grouplifecyclepolicy.md) is set to `Selected`.
+Add a group to a [groupLifecyclePolicy](../resources/grouplifecyclepolicy.md). This action is supported only if the **managedGroupTypes** property of the policy is set to `Selected`.
 
 [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
 
@@ -55,7 +55,7 @@ Only one group can be added per request.
 
 ## Response
 
-If successful, this method returns `200 OK` response code. If the group is added to the policy, a `true` value is returned in the response body. Otherwise, a `false` value is returned in the response body.
+If successful, this method returns `200 OK` response code. If the group is added to the policy, a `true` value is returned in the response body and the **expirationDateTime** property of the added group is set based on the policy's **groupLifetimeInDays** value. Otherwise, a `false` value is returned in the response body.
 
 ## Example
 
@@ -88,7 +88,8 @@ HTTP/1.1 200 OK
 Content-type: application/json
 
 {
-  "value": true
+    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Edm.Boolean",
+    "value": true
 }
 ```
 

diff --git a/api-reference/beta/api/grouplifecyclepolicy-post-grouplifecyclepolicies.md b/api-reference/beta/api/grouplifecyclepolicy-post-grouplifecyclepolicies.md
@@ -15,7 +15,7 @@ Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
-Creates a new [groupLifecyclePolicy](../resources/grouplifecyclepolicy.md).
+Creates a new [groupLifecyclePolicy](../resources/grouplifecyclepolicy.md). Only one policy exists in the tenant.
 
 [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
 
@@ -107,7 +107,7 @@ Content-type: application/json
 
 ### Response
 
-Note: The response object shown here might be shortened for readability.
+>**Note:** The response object shown here might be shortened for readability.
 
 <!-- {
   "blockType": "response",

diff --git a/api-reference/beta/api/grouplifecyclepolicy-renewgroup.md b/api-reference/beta/api/grouplifecyclepolicy-renewgroup.md
@@ -50,7 +50,7 @@ In the request body, provide a JSON object with the following parameters.
 
 | Parameter | Type | Description                   |
 | :-------- | :--- | :---------------------------- |
-| groupId   | Guid | The id of the group to renew. |
+| groupId   | Guid | The object ID of the group to renew. |
 
 ## Response
 

diff --git a/api-reference/beta/api/internaldomainfederation-update.md b/api-reference/beta/api/internaldomainfederation-update.md
@@ -84,7 +84,7 @@ PATCH /domains/{domainsId}/federationConfiguration/{internalDomainFederationId}
 
 ## Response
 
-If successful, this method returns a `200 OK` response code and an updated [internalDomainFederation](../resources/internaldomainfederation.md) object in the response body.
+If successful, this method returns a `204 No Content` response code.
 
 ## Examples
 
@@ -144,37 +144,12 @@ Content-Type: application/json
 ### Response
 >**Note:** The response object shown here might be shortened for readability.
 <!-- {
-  "blockType": "response",
-  "truncated": true,
-  "@odata.type": "microsoft.graph.internalDomainFederation"
+  "blockType": "response"
 }
 -->
 
 ``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
-  "@odata.type": "#microsoft.graph.internalDomainFederation",
-  "id": "6601d14b-d113-8f64-fda2-9b5ddda18ecc",
-   "displayName": "Contoso name change",
-   "issuerUri": "http://contoso.com/adfs/services/trust",
-   "metadataExchangeUri": "https://sts.contoso.com/adfs/services/trust/mex",
-   "signingCertificate": "MIIE3jCCAsagAwIBAgIQQcyDaZz3MI",
-   "passiveSignInUri": "https://sts.contoso.com/adfs/ls",
-   "preferredAuthenticationProtocol": "wsFed",
-   "activeSignInUri": "https://sts.contoso.com/adfs/services/trust/2005/usernamemixed",
-   "signOutUri": "https://sts.contoso.com/adfs/ls",
-   "promptLoginBehavior": "nativeSupport",
-   "isSignedAuthenticationRequestRequired": true,
-   "nextSigningCertificate": "MIIE3jCCAsagAwIBAgIQQcyDaZz3MI",
-   "signingCertificateUpdateStatus": {
-        "certificateUpdateResult": "Success",
-        "lastRunDateTime": "2021-08-25T07:44:46.2616778Z"
-    },
-   "federatedIdpMfaBehavior": "acceptIfMfaDoneByFederatedIdp",
-   "passwordResetUri": "https://sts.contoso.com/adfs/passwordReset"
-}
+HTTP/1.1 204 No Content
 ```
 
 <!--

diff --git a/api-reference/beta/api/onlinemeeting-list-recordings.md b/api-reference/beta/api/onlinemeeting-list-recordings.md
@@ -14,10 +14,11 @@ Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
-Get the list of [callRecording](../resources/callrecording.md) objects associated with a scheduled [onlineMeeting](../resources/onlinemeeting.md). This API doesn't support getting call recordings from channel meetings. 
+Get the list of [callRecording](../resources/callrecording.md) objects associated with a scheduled [onlineMeeting](../resources/onlinemeeting.md). This API supports the retrieval of call recordings from private chat meetings and channel meetings.
 
 > [!NOTE]
 > * This API doesn't support meetings created using the [create onlineMeeting API](/graph/api/application-post-onlinemeetings) that are not associated with an event on the user's calendar.
+> * This API might not return all results if multiple meetings are scheduled under a single channel post thread.
 > * This API works differently in one or more national clouds. For details, see [Microsoft Teams API implementation differences in national clouds](/graph/teamwork-national-cloud-differences).
 
 [!INCLUDE [national-cloud-support](../../includes/global-only.md)]
@@ -33,12 +34,13 @@ Choose the permission or permissions marked as least privileged for this API. Us
 |Delegated (personal Microsoft account)|Not supported.|Not supported.|
 |Application|OnlineMeetingRecording.Read.All, OnlineMeetingRecording.Read.Chat|Not available.|
 
-> **Note:** The application permission `OnlineMeetingRecording.Read.Chat` uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent).
+> **Note:** The application permission `OnlineMeetingRecording.Read.Chat` uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). This permission applies only to scheduled private chat meetings, not to channel meetings.
 
 To use application permission for this API, tenant administrators must create an application access policy and grant it to a user. It authorizes the app configured in the policy to fetch online meetings or online meeting artifacts on behalf of that user (with the user ID specified in the request path). For more information, see [Allow applications to access online meetings on behalf of a user](/graph/cloud-communication-online-meeting-application-access-policy).
 
 > [!NOTE]
-> This API works only for a meeting that hasn't expired. For more information, see [Limits and specifications for Microsoft Teams](/microsoftteams/limits-specifications-teams#meeting-expiration).
+> * This API is available for a meeting that hasn't expired. For more information, see [Limits and specifications for Microsoft Teams](/microsoftteams/limits-specifications-teams#meeting-expiration).
+> * This API is also available to users who are part of the meeting calendar invite, which applies to both private chat meetings and channel meetings.
 
 ## HTTP request