Merge pull request #25963 from microsoftgraph/main

Merge to publish

api-reference/beta/api/appcatalogs-list-teamsapps.md

@@ -19,14 +19,14 @@ List [apps](../resources/teamsapp.md) from the Microsoft Teams app catalog, incl
 > [!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.
 
-[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
-
 > [!IMPORTANT]
 > * Currently, this API is only supported in the user context and not in the admin view.
 > * The Teams apps that this API returns comply with the app management policies established by the admin.
 > * After the Teams apps are published, it typically takes 24-48 hours for the policies to be applied, so some apps might not appear in the API results immediately.
 > * For more information, see [App management policies](/microsoftteams/manage-apps#manage-org-wide-app-settings).
 
+[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

api-reference/beta/api/attendancerecord-list.md

@@ -366,7 +366,11 @@ Content-Type: application/json
           "leaveDateTime": "2021-10-05T04:43:49.7702391Z",
           "durationInSeconds": 322
         }
-      ]
+      ],
+      "externalRegistrationInformation": {
+        "referrer": "Facebook",
+        "registrationId": "myExternalRegistrationId"
+      },
     },
     {
       "emailAddress": "[email protected]",
@@ -384,7 +388,11 @@ Content-Type: application/json
           "leaveDateTime": "2021-10-04T23:18:57.5639338Z",
           "durationInSeconds": 314
         }
-      ]
+      ],
+      "externalRegistrationInformation": {
+        "referrer": "Facebook",
+        "registrationId": "anotherExternalRegistrationId"
+      },
     }
   ]
 }

api-reference/beta/api/authentication-delete-hardwareoathmethods.md

@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 Unassign a [hardware token](../resources/hardwareoathauthenticationmethod.md) from a user. The token remains in the directory and its details can be retrieved by [List hardwareOathDevices](authenticationmethoddevice-list-hardwareoathdevices.md) API.
 
+[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

api-reference/beta/api/authentication-list-hardwareoathmethods.md

@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 Get a list of the [hardware tokens](../resources/hardwareoathauthenticationmethod.md) assigned to a [user](../resources/user.md).
 
+[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

api-reference/beta/api/authentication-post-hardwareoathmethods.md

@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 Assign a [hardware token](../resources/hardwareoathauthenticationmethod.md) to a user without activation. To activate, use the [activation](hardwareoathauthenticationmethod-activate.md) API operation.
 
+[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

api-reference/beta/api/authenticationmethoddevice-delete-hardwareoathdevices.md

@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 Delete a Hardware OATH token. Token needs to be unassigned.
 
+[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

api-reference/beta/api/authenticationmethoddevice-list-hardwareoathdevices.md

@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 List all hardware OATH tokens in the directory.
 
+[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

api-reference/beta/api/authenticationmethoddevice-post-hardwareoathdevices.md

@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 Create a new hardwareOathTokenAuthenticationMethodDevice object. You can optionally create and assign to a user in the same request; Or assign to a user via the [assign](authentication-post-hardwareoathmethods.md) API.
 
+[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

api-reference/beta/api/certificateauthoritydetail-get.md

@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 Read the properties and relationships of a [certificateAuthorityDetail](../resources/certificateauthoritydetail.md) object.
 
+[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

api-reference/beta/api/certificateauthoritydetail-update.md

@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 Update the properties of a [certificateAuthorityDetail](../resources/certificateauthoritydetail.md) object.
 
+[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

api-reference/beta/api/certificatebasedauthpki-delete-certificateauthorities.md

@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 Delete a [certificateAuthorityDetail](../resources/certificateauthoritydetail.md) object.
 
+[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

api-reference/beta/api/certificatebasedauthpki-get.md

@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 Read the properties and relationships of a [certificateBasedAuthPki](../resources/certificatebasedauthpki.md) object.
 
+[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

api-reference/beta/api/certificatebasedauthpki-list-certificateauthorities.md

@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 Get a list of the [certificateAuthorityDetail](../resources/certificateauthoritydetail.md) objects and their properties.
 
+[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

api-reference/beta/api/certificatebasedauthpki-post-certificateauthorities.md

@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 Create a new [certificateAuthorityDetail](../resources/certificateauthoritydetail.md) object.
 
+[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

api-reference/beta/api/certificatebasedauthpki-update.md

@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 Update the properties of a [certificateBasedAuthPki](../resources/certificatebasedauthpki.md) object.
 
+[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

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

@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 Append additional certificate authority details to a [certificateBasedAuthPki](../resources/certificatebasedauthpki.md) resource. Only one operation can run at a time and this operation can take up to 30 minutes to complete. To know whether another upload is in progress, call the [Get certificateBasedAuthPki](../api/certificatebasedauthpki-get.md). The **status** property will have the value `running`.
 
+[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

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

@@ -0,0 +1,117 @@
+---
+title: "List allMembers"
+description: "List all members in a team channel."
+author: "sumitgupta"
+ms.localizationpriority: high
+ms.subservice: "teams"
+doc_type: apiPageType
+ms.date: 12/20/2024
+---
+
+# List allMembers
+
+Namespace: microsoft.graph
+
+[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
+
+Retrieve a list of [conversationMember](../resources/conversation member.md) objects from a team [channel](../resources/channel.md). It supports all types of channels. In the case of shared channels, it includes all cross-tenant and cross-team members in a channel.
+
+> [!NOTE]
+> The membership IDs returned by the server must be treated as opaque strings. The client should not try to parse or make any assumptions about these resource IDs.
+> In the future, membership results could be mapped to users from different tenants, as indicated in the response. The client should not assume that all members are from the current tenant.
+> [!NOTE] 
+> Currently, pagination is not supported, a maximum of 999 members can be returned in the response. If there are more than 999 members in a channel, the API only fetches the first 999 members.
+
+## 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      | Least privileged permissions       | Higher privileged permissions |
+|:--------------------|:---------------------------------------------------------|:---------------------------------------------------------|
+|Delegated (work or school account) | Group.Read.All | ChannelMember.ReadWrite.All, ChannelMember.Read.AllChannelMember.Read.All |
+|Delegated (personal Microsoft account) | Not supported | Not supported |
+|Application | ChannelMember.Read.All | ChannelMember.ReadWrite.All |
+
+## HTTP request
+
+<!-- { "blockType" : "ignored" } -->
+
+### Optional query parameters
+
+This method supports the `$filter` and `$select` [OData query parameters](/graph/query-parameters) to help customize the response.
+
+## Request headers
+
+| Header       | Value |
+|:---------------|:--------|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a list of [conversationMember](../resources/conversationmember.md) objects in the response body.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+
+<!-- {
+  "blockType": "request",
+  "name": "channel-list-allMembers",
+  "sampleKeys": ["2ab9c796-2902-45f8-b712-7c5a63cf41c4", "19%3A20bc1df46b1148e9b22539b83bc66809%40thread.skype"]
+} -->
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/teams/2ab9c796-2902-45f8-b712-7c5a63cf41c4/channels/19%3A20bc1df46b1148e9b22539b83bc66809%40thread.skype/allMembers
+```
+
+
+### 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.conversationMember"
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('2ab9c796-2902-45f8-b712-7c5a63cf41c4')/channels('19%3A20bc1df46b1148e9b22539b83bc66809%40thread.skype')/allMembers",
+"@odata.count": 2,
+    "value": [
+        {
+        "@odata.type": "#microsoft.graph.aadUserConversationMember",
+        "id": "MmFiOWM3OTYtMjkwMi00NWY4LWI3MTItN2M1YTYzY2Y0MWM0IyNlZWY5Y2IzNi0wNmRlLTQ2OWItODdjZC03MGY0Y2JlMzJkMTQ=",
+        "roles": [
+            "Member"
+        ],
+        "displayName": "Caleb Foster",
+        "userId": "eef9cb36-06de-469b-87cd-70f4cbe32d14",
+        "email": "[email protected]",
+        "tenantId": "ar8133445-c7e2-418a-8803-0e68d4b88607"
+        },
+        {
+        "@odata.type": "#microsoft.graph.aadUserConversationMember",
+        "id": "MmFiOWM3OTYtMjkwMi00NWY4LWI3MTItN2M1YTYzY2Y0MWM0IyNiMzI0NmY0NC1jMDkxLTQ2MjctOTZjNi0yNWIxOGZhMmM5MTA=",
+        "roles": [
+            "Owner"
+        ],
+        "displayName": "Eric Solomon",
+        "userId": "b3246f44-c091-4627-96c6-25b18fa2c910",
+        "email": "[email protected]",
+        "tenantId": "df81db53-c7e2-418a-8803-0e68d4b88607"
+        }
+    ]
+}
+
+```

api-reference/beta/api/cloudpc-retrievereviewstatus.md

@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 Get the [review status](..\resources\cloudpcreviewstatus.md) of a Cloud PC.
 
+[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

api-reference/beta/api/cloudpc-retrievesnapshots.md

@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 List all [cloudPcSnapshot](../resources/cloudpcsnapshot.md) resources for a Cloud PC.
 
+[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

api-reference/beta/api/cloudpc-setreviewstatus.md

@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 Set the review status of a specific Cloud PC device using the Cloud PC ID. Use this API to set the review status of a Cloud PC to in review if you consider a Cloud PC suspicious. After the review is completed, use this API again to set the Cloud PC back to a normal state.
 
+[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
+
 ## Permissions
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
 

api-reference/beta/api/cloudpcreports-getcloudpcperformancereport.md

@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 Get a report related to the performance of Cloud PCs.
 
+[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).