Merge pull request #26000 from microsoftgraph/main

Merge to publish.

api-reference/beta/api/certificateauthoritypath-list-mutualtlsoauthconfigurations.md

@@ -0,0 +1,107 @@
+---
+title: "List mutualTlsOauthConfigurations"
+description: "Get a list of the available mutualTlsOauthConfiguration resources."
+author: "sofia-geislinger"
+ms.date: 12/31/2024
+ms.localizationpriority: medium
+ms.subservice: "entra-id"
+doc_type: apiPageType
+---
+
+# List mutualTlsOauthConfigurations
+
+Namespace: microsoft.graph
+
+[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
+
+Get a list of the available [mutualTlsOauthConfiguration](../resources/mutualtlsoauthconfiguration.md) resources.
+
+## 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).
+
+<!-- {
+  "blockType": "permissions",
+  "name": "certificateauthoritypath-list-mutualtlsoauthconfigurations-permissions"
+}
+-->
+[!INCLUDE [permissions-table](../includes/permissions/certificateauthoritypath-list-mutualtlsoauthconfigurations-permissions.md)]
+
+[!INCLUDE [rbac-mtlsoauthconfig-apis](../includes/rbac-for-apis/rbac-mtlsoauthconfig-apis.md)]
+
+## HTTP request
+
+<!-- {
+  "blockType": "ignored"
+}
+-->
+``` http
+GET /certificateAuthorities/mutualTlsOauthConfigurations
+```
+
+## Optional query parameters
+
+This method supports the `$count`, `$filter`, and `$select` 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. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [mutualTlsOauthConfiguration](../resources/mutualtlsoauthconfiguration.md) objects in the response body.
+
+For more information, see [Microsoft Graph error responses and resource types](/graph/errors).
+
+## Examples
+
+### Request
+
+The following example shows a request.
+<!-- {
+  "blockType": "request",
+  "name": "certificateauthoritypath-list-mutualtlsoauthconfigurations-permissions"
+}
+-->
+
+```http
+GET https://graph.microsoft.com/beta/directory/certificateAuthorities/mutualTlsOauthConfigurations
+```
+
+### Response
+
+The following example shows the response.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+  "blockType": "response",
+  "truncated": true,
+  "@odata.type": "Collection(microsoft.graph.mutualTlsOauthConfiguration)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+  "@odata.context": "https://graph.microsoft.com/beta/$metadata#directory/certificateAuthorities/mutualTlsOauthConfigurations",
+  "value": [
+    {
+      "id": "a7199212-950f-4a2d-ba1e-017c48da1d19",
+      "deletedDateTime": null,
+      "displayName": "Standard TLS cert config",
+      "tlsClientAuthParameter": "tls_client_auth_san_uri",
+      "certificateAuthorities": [
+        {
+          "@odata.type": "microsoft.graph.certificateAuthority"
+        }
+      ]
+    }
+  ]
+}
+```

api-reference/beta/api/certificateauthoritypath-post-mutualtlsoauthconfigurations.md

@@ -0,0 +1,116 @@
+---
+title: "Create mutualTlsOauthConfiguration"
+description: "Create a mutualTlsOauthConfiguration resource that contains a specified certificate authority object."
+author: "sofia-geislinger"
+ms.date: 12/31/2024
+ms.localizationpriority: medium
+ms.subservice: "entra-id"
+doc_type: apiPageType
+---
+
+# Create mutualTlsOauthConfiguration
+
+Namespace: microsoft.graph
+
+[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
+
+Create a [mutualTlsOauthConfiguration](../resources/mutualtlsoauthconfiguration.md) resource that contains a specified certificate authority object.
+
+## 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).
+
+<!-- { "blockType": "permissions", "name": "certificateauthoritypath_post_mutualtlsoauthconfigurations" } -->
+[!INCLUDE [permissions-table](../includes/permissions/certificateauthoritypath-post-mutualtlsoauthconfigurations-permissions.md)]
+
+[!INCLUDE [rbac-mtlsoauthconfig-apis](../includes/rbac-for-apis/rbac-mtlsoauthconfig-apis.md)]
+
+## HTTP request
+
+<!-- {
+  "blockType": "ignored"
+}
+-->
+
+``` http
+POST /directory/certificateAuthorities/mutualTlsOauthConfigurations
+```
+
+## Request headers
+
+|Name|Description|
+|:---|:---|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+|Content-Type|application/json. Required.|
+
+## Request body
+
+In the request body, supply a JSON representation of the [mutualTlsOauthConfiguration](../resources/mutualtlsoauthconfiguration.md) object.
+
+You can specify the following properties when you create a **mutualTlsOauthConfiguration**.
+
+|Property|Type|Description|
+|:---|:---|:---|
+|certificateAuthority|[certificateAuthority](../resources/certificateauthority.md) collection | Multi-value property that represents a list of trusted certificate authorities. Optional. |
+|displayName|String|Friendly name. Optional. |
+|tlsClientAuthParameter| tlsClientRegistrationMetadata | Specifies which field in the certificate contains the subject ID. The possible values are: `tls_client_auth_subject_dn`, `tls_client_auth_san_dns`, `tls_client_auth_san_uri`, `tls_client_auth_san_ip`, `tls_client_auth_san_email`, `unknownFutureValue`. Required. Read-only. |
+
+## Response
+
+If successful, this method returns a `201 Created` response code and a [mutualTlsOauthConfiguration](../resources/mutualtlsoauthconfiguration.md) object in the response body. If a validation failure occurs during the certificate validation steps, the method returns a `400 Bad Request` along with the error message, `Invalid value specified for property 'certificate' of resource 'CertificateAuthorityInformation'.`.
+
+For more information, see [Microsoft Graph error responses and resource types](/graph/errors).
+
+## Examples
+
+### Request
+
+The following example shows a request.
+<!-- {
+  "blockType": "request",
+  "name": "create_mutualtlsoauthconfiguration_from_"
+}
+-->
+
+```http
+POST https://graph.microsoft.com/beta/directory/certificateAuthorities/mutualTlsOauthConfigurations
+Content-Type: application/json
+
+{
+  "displayName": "DoorCamera_Model_X_TrustedCAs",
+  "tlsClientAuthParameter": "tls_client_auth_san_uri",
+  "certificateAuthorities": [
+    {
+      "@odata.type": "microsoft.graph.certificateAuthority"
+    }
+  ]
+}
+```
+
+
+### 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.mutualTlsOauthConfiguration"
+}
+-->
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+  "@odata.context": "https://graph.microsoft.com/beta/$metadata#directory/certificateAuthorities/mutualTlsOauthConfigurations/$entity",
+  "id":"eec5ba11-2fc0-4113-83a2-ed986ed13cdb",
+  "displayName": "DoorCamera_Model_X_TrustedCAs",
+  "tlsClientAuthParameter": "tls_client_auth_san_uri",
+  "certificateAuthorities": [
+    {
+      "@odata.type": "microsoft.graph.certificateAuthority"
+    }
+  ]
+}
+```

api-reference/beta/api/cloudpcbulkaction-retry.md

@@ -0,0 +1,95 @@
+---
+title: "cloudPcBulkAction: retry"
+description: "Retry a cloudPcBulkAction object with selected Cloud PCs."
+author: "AshleyYangSZ"
+ms.localizationpriority: medium
+ms.subservice: "cloud-pc"
+doc_type: apiPageType
+ms.date: 01/01/2025
+---
+
+# cloudPcBulkAction: retry
+
+Namespace: microsoft.graph
+
+[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
+
+Retry a [cloudPcBulkAction](../resources/cloudpcbulkaction.md) object with selected 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).
+
+<!-- { "blockType": "permissions", "name": "cloudpcbulkaction_retry" } -->
+[!INCLUDE [permissions-table](../includes/permissions/cloudpcbulkaction-retry-permissions.md)]
+
+## HTTP request
+
+<!-- {
+  "blockType": "ignored"
+}
+-->
+
+``` http
+POST /deviceManagement/virtualEndpoint/bulkAction/{id}/retry
+```
+
+## Request headers
+
+|Name|Description|
+|:---|:---|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+|Content-Type|application/json. Required.|
+
+## Request body
+
+In the request body, supply a JSON representation of the parameters.
+
+The following table shows the parameters that can be used with this method.
+
+|Property|Type|Description|
+|:---|:---|:---|
+|cloudPcIds|String collection|A list of IDs for the Cloud PC devices to be retried for the given bulk action. This is optional; if not provided, all failed devices are retried.|
+
+## Response
+
+If successful, this method returns a `202 Accepted` response code.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+
+<!-- {
+  "blockType": "request",
+  "name": "cloudpcbulkaction_retry"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/bulkAction/0d76d02b-e0a0-4f58-baff-d1718cc2d144/retry
+Content-Type: application/json
+
+{
+  "@odata.type": "#microsoft.graph.cloudPcBulkAction",
+  "cloudPcIds": [
+    "30d0e128-de93-41dc-89ec-33d84bb662a0",
+    "7c82a3e3-9459-44e4-94d9-b92f93bf78dd"
+  ]
+}
+```
+
+### Response
+
+The following example shows the response.
+
+<!-- {
+  "blockType": "response",
+  "truncated": true
+}
+-->
+``` http
+HTTP/1.1 202 Accepted
+```

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

@@ -78,7 +78,6 @@ GET https://graph.microsoft.com/beta/applications/{applicationObjectId}/onPremis
 
 ---
 
-
 ### Response
 
 The following example shows the response.

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

@@ -97,7 +97,6 @@ Content-Type: application/json
 
 ---
 
-
 ### Response
 
 The following example shows the response.

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

@@ -5,7 +5,7 @@ author: "sandeo-MSFT"
 ms.localizationpriority: medium
 ms.subservice: "entra-directory-management"
 doc_type: apiPageType
-ms.date: 10/25/2024
+ms.date: 12/31/2024
 ---
 
 # Update device
@@ -50,11 +50,12 @@ In the request body, supply the values for the [device](../resources/device.md)
 | Property       | Type    |Description|
 |:---------------|:--------|:----------|
 |accountEnabled|Boolean| `true` if the account is enabled; otherwise, `false`. Only callers with at least the *Cloud Device Administrator* role can update this property. |
-|operatingSystem|String|The type of operating system on the device.|
-|operatingSystemVersion|String|The version of the operating system on the device|
+|alternativeNames|String collection|List of alternative names for the device, for example, `resourceIds`.|
 |displayName|String|The display name for the device.|
 |isCompliant|Boolean|`true` if the device complies with Mobile Device Management (MDM) policies; otherwise, `false`. This can only be updated by Intune for any device OS type or by an [approved MDM app](/windows/client-management/mdm/azure-active-directory-integration-with-mdm) for Windows OS devices. |
 |isManaged|Boolean|`true` if the device is managed by a Mobile Device Management (MDM) app; otherwise, `false`. This can only be updated by Intune for any device OS type or by an [approved MDM app](/windows/client-management/mdm/azure-active-directory-integration-with-mdm) for Windows OS devices. |
+|operatingSystem|String|The type of operating system on the device.|
+|operatingSystemVersion|String|The version of the operating system on the device.|
 
 Since the **device** resource supports [extensions](/graph/extensibility-overview), you can use the `PATCH` operation to 
 add, update, or delete your own app-specific data in custom properties of an extension in an existing **device** instance.