From dea21ce8d92c5f564d46e1036de0d98e6b2408ea Mon Sep 17 00:00:00 2001 From: jingqiang Date: Mon, 26 Aug 2024 14:34:30 +0800 Subject: [PATCH 001/308] new change --- .../api/cloudpcprovisioningpolicy-apply.md | 4 +++- changelog/Microsoft.CloudManagedDesktop.json | 18 ++++++++++++++++++ 2 files changed, 21 insertions(+), 1 deletion(-) diff --git a/api-reference/beta/api/cloudpcprovisioningpolicy-apply.md b/api-reference/beta/api/cloudpcprovisioningpolicy-apply.md index f9d71e31634..ed2796e6f84 100644 --- a/api-reference/beta/api/cloudpcprovisioningpolicy-apply.md +++ b/api-reference/beta/api/cloudpcprovisioningpolicy-apply.md @@ -51,6 +51,7 @@ The following table shows the parameter that you can use with this method. |Parameter|Type|Description| |:---|:---|:---| |policySettings|cloudPcPolicySettingType|The target property of this apply action. Possible values are: `region`, `singleSignOn`, `unknownFutureValue`. The default value is `region`. This action applies `region` as a value if this parameter is `null`.| +|reservePercentage|Int32|For `Frontline shared` only. Administrators can set a value (0-99) to keep a percentage of Cloud PCs available. Cloud PCs are reprovisioned only when there are no active and connected Cloud PC users.| ## Response @@ -74,7 +75,8 @@ POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/provision Content-Type: application/json { - "policySettings": "region" + "policySettings": "region", + "reservePercentage": 80, } ``` diff --git a/changelog/Microsoft.CloudManagedDesktop.json b/changelog/Microsoft.CloudManagedDesktop.json index 33126007e87..35d3355cf8c 100644 --- a/changelog/Microsoft.CloudManagedDesktop.json +++ b/changelog/Microsoft.CloudManagedDesktop.json @@ -1,5 +1,23 @@ { "changelog": [ + { + "ChangeList": [ + { + "Id": "8efd6ed8-dce5-4fb2-b59d-06a05d851029", + "ApiChange": "Method", + "ChangedApiName": "apply", + "ChangeType": "Addition", + "Description": "Added the **reservePercentage** to the [apply](https://learn.microsoft.com/en-us/graph/api/cloudpcprovisioningpolicy-apply?view=graph-rest-beta) method.", + "Target": "cloudPcProvisioningPolicy" + } + ], + "Id": "8efd6ed8-dce5-4fb2-b59d-06a05d851029", + "Cloud": "Prod", + "Version": "beta", + "CreatedDateTime": "2024-09-15T10:25:21.3434973Z", + "WorkloadArea": "Device and app management", + "SubArea": "Cloud PC" + }, { "ChangeList": [ { From a3fc922ebaf38ff02607e6e3e5b9cdca3789cb54 Mon Sep 17 00:00:00 2001 From: "Matthew M." <30242289+mcm223@users.noreply.github.com> Date: Wed, 4 Sep 2024 14:28:56 -0700 Subject: [PATCH 002/308] Add callRecord administrativeUnitInfos documentation for v1.0 --- .../callrecords-administrativeunitinfo.md | 42 ++++++++++++++++++ .../v1.0/resources/callrecords-organizer.md | 7 ++- .../v1.0/resources/callrecords-participant.md | 7 ++- .../resources/callrecords-participantbase.md | 7 ++- changelog/Microsoft.IC3.DataPlatform.json | 44 ++++++++++++++++++- 5 files changed, 100 insertions(+), 7 deletions(-) create mode 100644 api-reference/v1.0/resources/callrecords-administrativeunitinfo.md diff --git a/api-reference/v1.0/resources/callrecords-administrativeunitinfo.md b/api-reference/v1.0/resources/callrecords-administrativeunitinfo.md new file mode 100644 index 00000000000..f25d5d78fb9 --- /dev/null +++ b/api-reference/v1.0/resources/callrecords-administrativeunitinfo.md @@ -0,0 +1,42 @@ +--- +title: "administrativeUnitInfo resource type" +description: "Represents an object that exposes information about the administrative units associated with a call participant." +author: "mcm223" +ms.localizationpriority: medium +ms.subservice: "cloud-communications" +doc_type: resourcePageType +--- + +# administrativeUnitInfo resource type + +Namespace: microsoft.graph.callRecords + +Represents an object that exposes information about the administrative units associated with a [participant](callrecords-participantbase.md). + +## Properties + +| Property | Type | Description | +|:---------|:-------|------------------------------------------------| +| id | String | Unique identifier for the administrative unit. | + +## JSON representation + +The following JSON representation shows the resource type. + + +```json +{ + "id": "String (identifier)" +} +``` + +## See also + +For more information on administrative units, see [administrativeUnit](administrativeUnit.md). diff --git a/api-reference/v1.0/resources/callrecords-organizer.md b/api-reference/v1.0/resources/callrecords-organizer.md index e48e067bbf7..b5ca6e95ef2 100644 --- a/api-reference/v1.0/resources/callrecords-organizer.md +++ b/api-reference/v1.0/resources/callrecords-organizer.md @@ -21,6 +21,7 @@ Inherits from [participantBase](callrecords-participantbase.md). |:---------|:------------------------------|:--------------------------------------------------------| | id | String | Unique identifier for the call organizer. Inherited from [participantBase](callrecords-participantbase.md). | | identity | [microsoft.graph.communicationsIdentitySet](communicationsidentityset.md) | The identity of the call organizer. Inherited from [participantBase](callrecords-participantbase.md). | +| administrativeUnitInfos | [microsoft.graph.callRecords.administrativeUnitInfo](callrecords-administrativeunitinfo.md) collection | List of [administrativeUnitInfo](callrecords-administrativeunitinfo.md) of the call participant. Inherited from [participantBase](callrecords-participantbase.md). | ## JSON representation @@ -31,14 +32,16 @@ The following JSON representation shows the resource type. "@odata.type": "microsoft.graph.callRecords.organizer", "optionalProperties": [ "id", - "identity" + "identity", + "administrativeUnitInfos" ], "openType": true } --> ```json { "id": "String (identity)", - "identity": {"@odata.type": "microsoft.graph.communicationsIdentitySet"} + "identity": {"@odata.type": "microsoft.graph.communicationsIdentitySet"}, + "administrativeUnitInfos": [{"@odata.type": "microsoft.graph.callRecords.administrativeUnitInfo"}] } ``` diff --git a/api-reference/v1.0/resources/callrecords-participant.md b/api-reference/v1.0/resources/callrecords-participant.md index 254da661ba2..e3e448eb6f5 100644 --- a/api-reference/v1.0/resources/callrecords-participant.md +++ b/api-reference/v1.0/resources/callrecords-participant.md @@ -27,6 +27,7 @@ Inherits from [participantBase](callrecords-participantbase.md). |:---------|:------------------------------|:--------------------------------------------------------| | id | String | Unique identifier for the call participant. Inherited from [participantBase](callrecords-participantbase.md). | | identity | [microsoft.graph.communicationsIdentitySet](communicationsidentityset.md) | The identity of the call participant. Inherited from [participantBase](callrecords-participantbase.md). | +| administrativeUnitInfos | [microsoft.graph.callRecords.administrativeUnitInfo](callrecords-administrativeunitinfo.md) collection | List of [administrativeUnitInfo](callrecords-administrativeunitinfo.md) of the call participant. Inherited from [participantBase](callrecords-participantbase.md). | ## JSON representation @@ -37,14 +38,16 @@ The following JSON representation shows the resource type. "@odata.type": "microsoft.graph.callRecords.participant", "optionalProperties": [ "id", - "identity" + "identity", + "administrativeUnitInfos" ], "openType": true } --> ```json { "id": "String (identifier)", - "identity": {"@odata.type": "microsoft.graph.communicationsIdentitySet"} + "identity": {"@odata.type": "microsoft.graph.communicationsIdentitySet"}, + "administrativeUnitInfos": [{"@odata.type": "microsoft.graph.callRecords.administrativeUnitInfo"}] } ``` diff --git a/api-reference/v1.0/resources/callrecords-participantbase.md b/api-reference/v1.0/resources/callrecords-participantbase.md index 138b026e0a4..d5aec6b8aed 100644 --- a/api-reference/v1.0/resources/callrecords-participantbase.md +++ b/api-reference/v1.0/resources/callrecords-participantbase.md @@ -22,6 +22,7 @@ Base type of [organizer](callrecords-organizer.md) and [participant](callrecords |:------------|:------------------------------|:------------------------------------------------| | id | String | Unique identifier for the call participant. | | identity | [microsoft.graph.communicationsIdentitySet](communicationsidentityset.md) | The identity of the call participant. | +| administrativeUnitInfos | [microsoft.graph.callRecords.administrativeUnitInfo](callrecords-administrativeunitinfo.md) collection | List of [administrativeUnitInfo](callrecords-administrativeunitinfo.md) of the call participant. | ## JSON representation @@ -32,14 +33,16 @@ The following JSON representation shows the resource type. "@odata.type": "microsoft.graph.callRecords.participantBase", "optionalProperties": [ "id", - "identity" + "identity", + "administrativeUnitInfos" ], "openType": true } --> ```json { "id": "String (identifier)", - "identity": {"@odata.type": "microsoft.graph.communicationsIdentitySet"} + "identity": {"@odata.type": "microsoft.graph.communicationsIdentitySet"}, + "administrativeUnitInfos": [{"@odata.type": "microsoft.graph.callRecords.administrativeUnitInfo"}] } ``` diff --git a/changelog/Microsoft.IC3.DataPlatform.json b/changelog/Microsoft.IC3.DataPlatform.json index 6c807111f9d..1f617009167 100644 --- a/changelog/Microsoft.IC3.DataPlatform.json +++ b/changelog/Microsoft.IC3.DataPlatform.json @@ -993,6 +993,48 @@ "CreatedDateTime": "2024-02-29T13:49:01.0804836Z", "WorkloadArea": "Teamwork and communications", "SubArea": "Calls and online meetings" - } + }, + { + "ChangeList": [ + { + "Id": "bb8eae43-f5ac-47a1-94b9-16492af7e7b1", + "ApiChange": "Resource", + "ChangedApiName": "administrativeUnitInfo", + "ChangeType": "Addition", + "Description": "Added the [administrativeUnitInfo](https://learn.microsoft.com/en-us/graph/api/resources/callRecords-administrativeUnitInfo?view=graph-rest-1.0) resource.", + "Target": "administrativeUnitInfo" + }, + { + "Id": "bb8eae43-f5ac-47a1-94b9-16492af7e7b1", + "ApiChange": "Property", + "ChangedApiName": "administrativeUnitInfos", + "ChangeType": "Addition", + "Description": "Added the **administrativeUnitInfos** property to the [participantBase](https://learn.microsoft.com/en-us/graph/api/resources/callRecords-participantBase?view=graph-rest-1.0) resource.", + "Target": "participantBase" + }, + { + "Id": "bb8eae43-f5ac-47a1-94b9-16492af7e7b1", + "ApiChange": "Property", + "ChangedApiName": "administrativeUnitInfos", + "ChangeType": "Addition", + "Description": "Added the **administrativeUnitInfos** property to the [participant](https://learn.microsoft.com/en-us/graph/api/resources/callRecords-participant?view=graph-rest-1.0) resource.", + "Target": "participant" + }, + { + "Id": "bb8eae43-f5ac-47a1-94b9-16492af7e7b1", + "ApiChange": "Property", + "ChangedApiName": "administrativeUnitInfos", + "ChangeType": "Addition", + "Description": "Added the **administrativeUnitInfos** property to the [organizer](https://learn.microsoft.com/en-us/graph/api/resources/callRecords-organizer?view=graph-rest-1.0) resource.", + "Target": "organizer" + } + ], + "Id": "bb8eae43-f5ac-47a1-94b9-16492af7e7b1", + "Cloud": "Prod", + "Version": "v1.0", + "CreatedDateTime": "2024-09-04T14:22:24.0228479Z", + "WorkloadArea": "Teamwork and communications", + "SubArea": "Calls and online meetings" + } ] } From 7084863c278385b6953e6a69ff7a7629752c31d4 Mon Sep 17 00:00:00 2001 From: "Matthew M." <30242289+mcm223@users.noreply.github.com> Date: Mon, 9 Sep 2024 12:57:19 -0700 Subject: [PATCH 003/308] Capitalization fix --- api-reference/v1.0/resources/callrecords-organizer.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/resources/callrecords-organizer.md b/api-reference/v1.0/resources/callrecords-organizer.md index b5ca6e95ef2..f510dea6b16 100644 --- a/api-reference/v1.0/resources/callrecords-organizer.md +++ b/api-reference/v1.0/resources/callrecords-organizer.md @@ -1,7 +1,7 @@ --- author: "mcm223" description: "Represents the identity of a call or meeting organizer in a callRecord." -title: "organizer resource type" +title: "Organizer resource type" ms.localizationpriority: medium doc_type: resourcePageType ms.subservice: "cloud-communications" From 81856eab3f4650f073fe8b0d68c3136734b7dca6 Mon Sep 17 00:00:00 2001 From: moti-ba <131643892+moti-ba@users.noreply.github.com> Date: Tue, 17 Sep 2024 11:03:50 +0300 Subject: [PATCH 004/308] Fix Filtering Rule API --- .../api/networkaccess-filteringrule-post.md | 33 +++++----- .../resources/networkaccess-filteringrule.md | 3 +- .../networkaccess-fqdnfilteringrule.md | 62 ++++++++++++++++++ .../networkaccess-webcategoryfilteringrule.md | 63 +++++++++++++++++++ .../beta/toc/identity-and-access/toc.yml | 6 +- 5 files changed, 149 insertions(+), 18 deletions(-) create mode 100644 api-reference/beta/resources/networkaccess-fqdnfilteringrule.md create mode 100644 api-reference/beta/resources/networkaccess-webcategoryfilteringrule.md diff --git a/api-reference/beta/api/networkaccess-filteringrule-post.md b/api-reference/beta/api/networkaccess-filteringrule-post.md index 42b47754dc5..70eec61cef6 100644 --- a/api-reference/beta/api/networkaccess-filteringrule-post.md +++ b/api-reference/beta/api/networkaccess-filteringrule-post.md @@ -42,7 +42,8 @@ POST /networkaccess/filteringPolicies/{filteringPoliciesId}/policyRules |Content-Type|application/json. Required.| ## Request body -Don't supply a request body for this method. +In the request body, supply a JSON representation of [fqdnFilteringRule](networkaccess-fqdnFilteringRule.md) or [webCategoryFilteringRule](networkaccess-webCategoryFilteringRule.md) resource type. + ## Response @@ -63,15 +64,15 @@ POST https://graph.microsoft.com/beta/networkaccess/filteringPolicies/ac253559-3 Content-Type: application/json { - "@odata.type": "#microsoft.graph.networkaccess.webCategoryFilteringRule", - "name": "Block Alcohol", - "ruleType": "webCategory", - "destinations": [ - { - "@odata.type": "#microsoft.graph.networkaccess.webCategory", - "name": "AlcoholAndTobacco" - } - ] + "@odata.type": "#microsoft.graph.networkaccess.webCategoryFilteringRule", + "name": "Block Gambling Sites", + "ruleType": "webCategory", + "destinations": [ + { + "@odata.type": "#microsoft.graph.networkaccess.webCategory", + "name": "Gambling" + } + ] } ``` @@ -123,17 +124,17 @@ HTTP/1.1 201 Created Content-Type: application/json { - "@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/filteringPolicies('ac253559-37a0-4f72-b666-103420b94e38')/policyRules/$entity", + "@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/filteringPolicies('49159c8f-3e5c-4a10-a2b8-ef7a734a586d')/policyRules/$entity", "@odata.type": "#microsoft.graph.networkaccess.webCategoryFilteringRule", - "id": "0d7ce7af-fbed-4751-8fed-8c184b751d0b", - "name": "BlockStreaming", + "id": "47024899-7304-453e-9421-0febf7b57ad8", + "name": "Block Gambling Sites", "ruleType": "webCategory", "destinations": [ { "@odata.type": "#microsoft.graph.networkaccess.webCategory", - "name": "StreamingMediaAndDownloads", - "displayName": "Streaming Media + Music and Streaming Audio", - "group": "HighBandwidth" + "name": "Gambling", + "displayName": "Gambling", + "group": "Liability" } ] } diff --git a/api-reference/beta/resources/networkaccess-filteringrule.md b/api-reference/beta/resources/networkaccess-filteringrule.md index 28d55614799..665536b1e89 100644 --- a/api-reference/beta/resources/networkaccess-filteringrule.md +++ b/api-reference/beta/resources/networkaccess-filteringrule.md @@ -13,9 +13,10 @@ Namespace: microsoft.graph.networkaccess [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -A rule that is used to filter traffic in Global Secure Access. +This is an abstract type from which the [fqdnFilteringRule](networkaccess-fqdnFilteringRule.md) and [webCategoryFilteringRule](networkaccess-webCategoryFilteringRule.md) resource types are derived. Inherits from [microsoft.graph.networkaccess.policyRule](../resources/networkaccess-policyrule.md). + ## Methods |Method|Return type|Description| |:---|:---|:---| diff --git a/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md b/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md new file mode 100644 index 00000000000..1cd487a7ac1 --- /dev/null +++ b/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md @@ -0,0 +1,62 @@ +--- +title: "fqdnFilteringRule resource type" +description: "Defines a network filtering rule specifically for fully qualified domain names (FQDNs), allowing administrators to control access to specified domains." +author: "Moti-ba" +ms.localizationpriority: medium +ms.subservice: entra-global-secure-access +doc_type: resourcePageType +--- + +# fqdnFilteringRule resource type + +Namespace: microsoft.graph.networkaccess + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Defines a network filtering rule specifically for fully qualified domain names (FQDNs), allowing administrators to control access to specified domains. + +Inherits from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md). + +## Methods +|Method|Return type|Description| +|:---|:---|:---| +|[List](../api/networkaccess-filteringrule-list.md)|[microsoft.graph.networkaccess.fqdnFilteringRule](../resources/networkaccess-fqdnfilteringrule.md) collection|Get a list of the [microsoft.graph.networkaccess.fqdnFilteringRule](../resources/networkaccess-fqdnfilteringrule.md) objects and their properties.| +|[Get](../api/networkaccess-filteringrule-get.md)|[microsoft.graph.networkaccess.fqdnFilteringRule](../resources/networkaccess-fqdnfilteringrule.md)|Read the properties and relationships of a [microsoft.graph.networkaccess.fqdnFilteringRule](../resources/networkaccess-fqdnfilteringrule.md) object.| +|[Update](../api/networkaccess-filteringrule-update.md)|[microsoft.graph.networkaccess.fqdnFilteringRule](../resources/networkaccess-fqdnfilteringrule.md)|Update the properties of a [microsoft.graph.networkaccess.fqdnFilteringRule](../resources/networkaccess-fqdnfilteringrule.md) object.| +|[Delete](../api/networkaccess-filteringrule-delete.md)|None|Delete a [microsoft.graph.networkaccess.fqdnFilteringRule](../resources/networkaccess-fqdnfilteringrule.md) object.| + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|destinations|[microsoft.graph.networkaccess.ruleDestination](../resources/networkaccess-ruledestination.md) collection|Destinations maintain a list of potential destinations and destination types that the user may access within the context of a network filtering policy. This includes FQDNs and web categories. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| +|id|String|Identifier. Inherited from [microsoft.graph.networkaccess.policyRule](../resources/networkaccess-policyrule.md).| +|name|String|Display Name. Inherited from [microsoft.graph.networkaccess.policyRule](../resources/networkaccess-policyrule.md).| +|ruleType|microsoft.graph.networkaccess.networkDestinationType|The network destination type used by a filtering rule. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).The possible values are: `fqdn`, `webCategory`, `unknownFutureValue`.| + +## Relationships +None. + +## JSON representation +The following JSON representation shows the resource type. + +``` json +{ + "@odata.type": "#microsoft.graph.networkaccess.fqdnFilteringRule", + "name": "BlockContoso", + "ruleType": "fqdn", + "destinations": [ + { + "@odata.type": "#microsoft.graph.networkaccess.fqdn", + "value": "Contoso.com" + } + ] +} +``` + diff --git a/api-reference/beta/resources/networkaccess-webcategoryfilteringrule.md b/api-reference/beta/resources/networkaccess-webcategoryfilteringrule.md new file mode 100644 index 00000000000..9ce0363b6c3 --- /dev/null +++ b/api-reference/beta/resources/networkaccess-webcategoryfilteringrule.md @@ -0,0 +1,63 @@ +--- +title: "webCategoryFilteringRule resource type" +description: "Defines a network filtering rule for web categories, enabling administrators to manage access to specific categories of websites." +author: "Moti-ba" +ms.localizationpriority: medium +ms.subservice: entra-global-secure-access +doc_type: resourcePageType +--- + +# webCategoryFilteringRule resource type + +Namespace: microsoft.graph.networkaccess + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Defines a network filtering rule for web categories, enabling administrators to manage access to specific categories of websites. + +Inherits from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md). + +## Methods +|Method|Return type|Description| +|:---|:---|:---| +|[Create](../api/networkaccess-filteringrule-post.md)|[microsoft.graph.networkaccess.webCategoryFilteringRule](../resources/networkaccess-webcategoryfilteringrule.md) collection|Create a [microsoft.graph.networkaccess.webCategoryFilteringRule](../resources/networkaccess-webcategoryfilteringrule.md) objects and their properties.| +|[List](../api/networkaccess-filteringrule-list.md)|[microsoft.graph.networkaccess.webCategoryFilteringRule](../resources/networkaccess-webcategoryfilteringrule.md) collection|Get a list of the [microsoft.graph.networkaccess.webCategoryFilteringRule](../resources/networkaccess-webcategoryfilteringrule.md) objects and their properties.| +|[Get](../api/networkaccess-filteringrule-get.md)|[microsoft.graph.networkaccess.webCategoryFilteringRule](../resources/networkaccess-webcategoryfilteringrule.md)|Read the properties and relationships of a [microsoft.graph.networkaccess.webCategoryFilteringRule](../resources/networkaccess-webcategoryfilteringrule.md) object.| +|[Update](../api/networkaccess-filteringrule-update.md)|[microsoft.graph.networkaccess.webCategoryFilteringRule](../resources/networkaccess-webcategoryfilteringrule.md)|Update the properties of a [microsoft.graph.networkaccess.webCategoryFilteringRule](../resources/networkaccess-webcategoryfilteringrule.md) object.| +|[Delete](../api/networkaccess-filteringrule-delete.md)|None|Delete a [microsoft.graph.networkaccess.webCategoryFilteringRule](../resources/networkaccess-webcategoryfilteringrule.md) object.| + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|destinations|[microsoft.graph.networkaccess.ruleDestination](../resources/networkaccess-ruledestination.md) collection|Destinations maintain a list of potential destinations and destination types that the user may access within the context of a network filtering policy. This includes FQDNs and web categories. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| +|id|String|Identifier. Inherited from [microsoft.graph.networkaccess.policyRule](../resources/networkaccess-policyrule.md).| +|name|String|Display Name. Inherited from [microsoft.graph.networkaccess.policyRule](../resources/networkaccess-policyrule.md).| +|ruleType|microsoft.graph.networkaccess.networkDestinationType|The network destination type used by a filtering rule. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).The possible values are: `fqdn`, `webCategory`, `unknownFutureValue`.| + +## Relationships +None. + +## JSON representation +The following JSON representation shows the resource type. + +``` json +{ +"@odata.type": "#microsoft.graph.networkaccess.webCategoryFilteringRule", + "name": "Block Gambling Sites", + "ruleType": "webCategory", + "destinations": [ + { + "@odata.type": "#microsoft.graph.networkaccess.webCategory", + "name": "Gambling" + } + ] +} +``` + diff --git a/api-reference/beta/toc/identity-and-access/toc.yml b/api-reference/beta/toc/identity-and-access/toc.yml index e08b4c8709d..595efac32fe 100644 --- a/api-reference/beta/toc/identity-and-access/toc.yml +++ b/api-reference/beta/toc/identity-and-access/toc.yml @@ -3939,7 +3939,7 @@ items: - name: Get href: ../../api/securitytoolawsserverlessfunctionadministratorfinding-get.md - name: Network access (preview) - displayName: ZTNA, Global Secure Access, Microsoft Entra Internet Access, Microsoft Entra Private Access + displayName: Global Secure Access, Microsoft Entra Internet Access, Microsoft Entra Private Access items: - name: Overview href: ../../resources/networkaccess-global-secure-access-api-overview.md @@ -4193,6 +4193,10 @@ items: items: - name: Filtering rule href: ../../resources/networkaccess-filteringrule.md + - name: FQDN Filtering rule + href: ../../resources/networkaccess-fqdnfilteringrule.md + - name: Web Category Filtering rule + href: ../../resources/webcategoryfilteringrule.md - name: List href: ../../api/networkaccess-filteringrule-list.md - name: Create From bec91e20f10c6970be8903244e729d9cb4d0fb46 Mon Sep 17 00:00:00 2001 From: moti-ba <131643892+moti-ba@users.noreply.github.com> Date: Tue, 17 Sep 2024 11:19:18 +0300 Subject: [PATCH 005/308] fix paths --- api-reference/beta/api/networkaccess-filteringrule-post.md | 2 +- api-reference/beta/toc/identity-and-access/toc.yml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/api/networkaccess-filteringrule-post.md b/api-reference/beta/api/networkaccess-filteringrule-post.md index 70eec61cef6..885f414f32f 100644 --- a/api-reference/beta/api/networkaccess-filteringrule-post.md +++ b/api-reference/beta/api/networkaccess-filteringrule-post.md @@ -42,7 +42,7 @@ POST /networkaccess/filteringPolicies/{filteringPoliciesId}/policyRules |Content-Type|application/json. Required.| ## Request body -In the request body, supply a JSON representation of [fqdnFilteringRule](networkaccess-fqdnFilteringRule.md) or [webCategoryFilteringRule](networkaccess-webCategoryFilteringRule.md) resource type. +In the request body, supply a JSON representation of [fqdnFilteringRule](../resources/networkaccess-fqdnFilteringRule.md) or [webCategoryFilteringRule](../resources/networkaccess-webCategoryFilteringRule.md) resource type. ## Response diff --git a/api-reference/beta/toc/identity-and-access/toc.yml b/api-reference/beta/toc/identity-and-access/toc.yml index 595efac32fe..8a6c0799e78 100644 --- a/api-reference/beta/toc/identity-and-access/toc.yml +++ b/api-reference/beta/toc/identity-and-access/toc.yml @@ -4196,7 +4196,7 @@ items: - name: FQDN Filtering rule href: ../../resources/networkaccess-fqdnfilteringrule.md - name: Web Category Filtering rule - href: ../../resources/webcategoryfilteringrule.md + href: ../../resources/networkaccess-webcategoryfilteringrule.md - name: List href: ../../api/networkaccess-filteringrule-list.md - name: Create From 1cae3066412c9906bdf93d921035bb0ba65f9719 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Tue, 17 Sep 2024 21:33:31 +0200 Subject: [PATCH 006/308] Update networkaccess-filteringrule-post.md --- .../api/networkaccess-filteringrule-post.md | 59 ++++--------------- 1 file changed, 12 insertions(+), 47 deletions(-) diff --git a/api-reference/beta/api/networkaccess-filteringrule-post.md b/api-reference/beta/api/networkaccess-filteringrule-post.md index 885f414f32f..f0a9b250f4d 100644 --- a/api-reference/beta/api/networkaccess-filteringrule-post.md +++ b/api-reference/beta/api/networkaccess-filteringrule-post.md @@ -14,7 +14,6 @@ Namespace: microsoft.graph.networkaccess Create a new [filteringRule](../resources/networkaccess-filteringrule.md). - [!INCLUDE [national-cloud-support](../../includes/global-only.md)] ## Permissions @@ -42,18 +41,18 @@ POST /networkaccess/filteringPolicies/{filteringPoliciesId}/policyRules |Content-Type|application/json. Required.| ## Request body -In the request body, supply a JSON representation of [fqdnFilteringRule](../resources/networkaccess-fqdnFilteringRule.md) or [webCategoryFilteringRule](../resources/networkaccess-webCategoryFilteringRule.md) resource type. +In the request body, supply a JSON representation of the [fqdnFilteringRule](../resources/networkaccess-fqdnfilteringrule.md) or [webCategoryFilteringRule](../resources/networkaccess-webcategoryfilteringrule.md) resource type. ## Response -If successful, this method returns a `201 Created` response code and a [filteringRule](../resources/networkaccess-filteringrule.md) object in the response body. +If successful, this method returns a `201 Created` response code and a [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md) object in the response body. ## Examples ### Request The following example shows a request. -# [HTTP](#tab/http) + ``` json { - "@odata.type": "#microsoft.graph.networkaccess.fqdnFilteringRule", - "name": "BlockContoso", - "ruleType": "fqdn", - "destinations": [ - { - "@odata.type": "#microsoft.graph.networkaccess.fqdn", - "value": "Contoso.com" - } - ] + "@odata.type": "#microsoft.graph.networkaccess.filteringRule", + "destinations": [{"@odata.type": "microsoft.graph.networkaccess.ruleDestination"}], + "id": "String (identifier)", + "name": "String", + "ruleType": "String" } ``` - From 1eed7542f9caa32f1e57cfd6a6b5f187f346c5d0 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Tue, 17 Sep 2024 22:11:09 +0200 Subject: [PATCH 011/308] Update networkaccess-fqdnfilteringrule.md --- api-reference/beta/resources/networkaccess-fqdnfilteringrule.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md b/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md index 717aa829918..b3d91aba1a4 100644 --- a/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md +++ b/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md @@ -48,7 +48,7 @@ The following JSON representation shows the resource type. --> ``` json { - "@odata.type": "#microsoft.graph.networkaccess.filteringRule", + "@odata.type": "#microsoft.graph.networkaccess.fqdnFilteringRule", "destinations": [{"@odata.type": "microsoft.graph.networkaccess.ruleDestination"}], "id": "String (identifier)", "name": "String", From fb014e71e715dd21e1c9c672442c3cb505359981 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Tue, 17 Sep 2024 22:12:30 +0200 Subject: [PATCH 012/308] Update networkaccess-webcategoryfilteringrule.md --- .../networkaccess-webcategoryfilteringrule.md | 26 ++++++++----------- 1 file changed, 11 insertions(+), 15 deletions(-) diff --git a/api-reference/beta/resources/networkaccess-webcategoryfilteringrule.md b/api-reference/beta/resources/networkaccess-webcategoryfilteringrule.md index 9ce0363b6c3..932efddb306 100644 --- a/api-reference/beta/resources/networkaccess-webcategoryfilteringrule.md +++ b/api-reference/beta/resources/networkaccess-webcategoryfilteringrule.md @@ -3,7 +3,7 @@ title: "webCategoryFilteringRule resource type" description: "Defines a network filtering rule for web categories, enabling administrators to manage access to specific categories of websites." author: "Moti-ba" ms.localizationpriority: medium -ms.subservice: entra-global-secure-access +ms.subservice: "entra-global-secure-access" doc_type: resourcePageType --- @@ -15,7 +15,7 @@ Namespace: microsoft.graph.networkaccess Defines a network filtering rule for web categories, enabling administrators to manage access to specific categories of websites. -Inherits from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md). +Inherits from [filteringRule](../resources/networkaccess-filteringrule.md). ## Methods |Method|Return type|Description| @@ -29,10 +29,10 @@ Inherits from [microsoft.graph.networkaccess.filteringRule](../resources/network ## Properties |Property|Type|Description| |:---|:---|:---| -|destinations|[microsoft.graph.networkaccess.ruleDestination](../resources/networkaccess-ruledestination.md) collection|Destinations maintain a list of potential destinations and destination types that the user may access within the context of a network filtering policy. This includes FQDNs and web categories. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| -|id|String|Identifier. Inherited from [microsoft.graph.networkaccess.policyRule](../resources/networkaccess-policyrule.md).| -|name|String|Display Name. Inherited from [microsoft.graph.networkaccess.policyRule](../resources/networkaccess-policyrule.md).| -|ruleType|microsoft.graph.networkaccess.networkDestinationType|The network destination type used by a filtering rule. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).The possible values are: `fqdn`, `webCategory`, `unknownFutureValue`.| +|destinations|[microsoft.graph.networkaccess.ruleDestination](../resources/networkaccess-ruledestination.md) collection|The list of potential destinations and destination types that the user may access within the context of a network filtering policy. This includes FQDNs and web categories. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| +|id|String|The unique identifier for the **webCategoryFilteringRule**. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| +|name|String|Display name. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| +|ruleType|microsoft.graph.networkaccess.networkDestinationType|The network destination type used by a filtering rule. Suppports a subset of the values for **networkDestinationType**. The possible values are: `fqdn`, `webCategory`, `unknownFutureValue`. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md). | ## Relationships None. @@ -49,15 +49,11 @@ The following JSON representation shows the resource type. --> ``` json { -"@odata.type": "#microsoft.graph.networkaccess.webCategoryFilteringRule", - "name": "Block Gambling Sites", - "ruleType": "webCategory", - "destinations": [ - { - "@odata.type": "#microsoft.graph.networkaccess.webCategory", - "name": "Gambling" - } - ] + "@odata.type": "#microsoft.graph.networkaccess.webCategoryFilteringRule", + "destinations": [{"@odata.type": "microsoft.graph.networkaccess.ruleDestination"}], + "id": "String (identifier)", + "name": "String", + "ruleType": "String" } ``` From 7003b1d6c185f8b4a8497921df56d972c96f8798 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Fri, 20 Sep 2024 05:40:04 +0200 Subject: [PATCH 013/308] Update networkaccess-fqdnfilteringrule.md --- .../beta/resources/networkaccess-fqdnfilteringrule.md | 9 +++------ 1 file changed, 3 insertions(+), 6 deletions(-) diff --git a/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md b/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md index b3d91aba1a4..6544e9baff3 100644 --- a/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md +++ b/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md @@ -18,12 +18,9 @@ Defines a network filtering rule specifically for fully qualified domain names ( Inherits from [filteringRule](../resources/networkaccess-filteringrule.md). ## Methods -|Method|Return type|Description| -|:---|:---|:---| -|[List](../api/networkaccess-filteringrule-list.md)|[microsoft.graph.networkaccess.fqdnFilteringRule](../resources/networkaccess-fqdnfilteringrule.md) collection|Get a list of the [microsoft.graph.networkaccess.fqdnFilteringRule](../resources/networkaccess-fqdnfilteringrule.md) objects and their properties.| -|[Get](../api/networkaccess-filteringrule-get.md)|[microsoft.graph.networkaccess.fqdnFilteringRule](../resources/networkaccess-fqdnfilteringrule.md)|Read the properties and relationships of a [microsoft.graph.networkaccess.fqdnFilteringRule](../resources/networkaccess-fqdnfilteringrule.md) object.| -|[Update](../api/networkaccess-filteringrule-update.md)|[microsoft.graph.networkaccess.fqdnFilteringRule](../resources/networkaccess-fqdnfilteringrule.md)|Update the properties of a [microsoft.graph.networkaccess.fqdnFilteringRule](../resources/networkaccess-fqdnfilteringrule.md) object.| -|[Delete](../api/networkaccess-filteringrule-delete.md)|None|Delete a [microsoft.graph.networkaccess.fqdnFilteringRule](../resources/networkaccess-fqdnfilteringrule.md) object.| +None. + +For the list of API operations for managing this resource type, see [filteringRule](../resources/networkaccess-filteringrule.md). ## Properties |Property|Type|Description| From 8c78364c784b54630f2a9e8c84aa5612b2bb77a2 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Fri, 20 Sep 2024 05:40:18 +0200 Subject: [PATCH 014/308] Update networkaccess-webcategoryfilteringrule.md --- .../networkaccess-webcategoryfilteringrule.md | 10 +++------- 1 file changed, 3 insertions(+), 7 deletions(-) diff --git a/api-reference/beta/resources/networkaccess-webcategoryfilteringrule.md b/api-reference/beta/resources/networkaccess-webcategoryfilteringrule.md index 932efddb306..b38db5c65c9 100644 --- a/api-reference/beta/resources/networkaccess-webcategoryfilteringrule.md +++ b/api-reference/beta/resources/networkaccess-webcategoryfilteringrule.md @@ -18,13 +18,9 @@ Defines a network filtering rule for web categories, enabling administrators to Inherits from [filteringRule](../resources/networkaccess-filteringrule.md). ## Methods -|Method|Return type|Description| -|:---|:---|:---| -|[Create](../api/networkaccess-filteringrule-post.md)|[microsoft.graph.networkaccess.webCategoryFilteringRule](../resources/networkaccess-webcategoryfilteringrule.md) collection|Create a [microsoft.graph.networkaccess.webCategoryFilteringRule](../resources/networkaccess-webcategoryfilteringrule.md) objects and their properties.| -|[List](../api/networkaccess-filteringrule-list.md)|[microsoft.graph.networkaccess.webCategoryFilteringRule](../resources/networkaccess-webcategoryfilteringrule.md) collection|Get a list of the [microsoft.graph.networkaccess.webCategoryFilteringRule](../resources/networkaccess-webcategoryfilteringrule.md) objects and their properties.| -|[Get](../api/networkaccess-filteringrule-get.md)|[microsoft.graph.networkaccess.webCategoryFilteringRule](../resources/networkaccess-webcategoryfilteringrule.md)|Read the properties and relationships of a [microsoft.graph.networkaccess.webCategoryFilteringRule](../resources/networkaccess-webcategoryfilteringrule.md) object.| -|[Update](../api/networkaccess-filteringrule-update.md)|[microsoft.graph.networkaccess.webCategoryFilteringRule](../resources/networkaccess-webcategoryfilteringrule.md)|Update the properties of a [microsoft.graph.networkaccess.webCategoryFilteringRule](../resources/networkaccess-webcategoryfilteringrule.md) object.| -|[Delete](../api/networkaccess-filteringrule-delete.md)|None|Delete a [microsoft.graph.networkaccess.webCategoryFilteringRule](../resources/networkaccess-webcategoryfilteringrule.md) object.| +None. + +For the list of API operations for managing this resource type, see [filteringRule](../resources/networkaccess-filteringrule.md). ## Properties |Property|Type|Description| From e7d6ecda4c9144f79b96e22e2af497549693506a Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Fri, 20 Sep 2024 05:45:02 +0200 Subject: [PATCH 015/308] Update toc.mapping.json --- api-reference/beta/toc/toc.mapping.json | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/api-reference/beta/toc/toc.mapping.json b/api-reference/beta/toc/toc.mapping.json index cfb413897db..03fa33b3f86 100644 --- a/api-reference/beta/toc/toc.mapping.json +++ b/api-reference/beta/toc/toc.mapping.json @@ -1859,7 +1859,9 @@ "microsoft.graph.networkaccess.filteringProfile", "microsoft.graph.networkaccess.filteringPolicy", "microsoft.graph.networkaccess.filteringPolicyLink", - "microsoft.graph.networkaccess.filteringRule" + "microsoft.graph.networkaccess.filteringRule", + "microsoft.graph.networkaccess.fqdnFilteringRule", + "microsoft.graph.networkaccess.webCategoryFilteringRule" ] }, { From af05a7a7eabbe336d0f06c2d6df1fb3bfc4b1ddc Mon Sep 17 00:00:00 2001 From: Microsoft Graph DevX Tooling Date: Fri, 20 Sep 2024 03:46:34 +0000 Subject: [PATCH 016/308] Update reference TOC --- api-reference/beta/toc/identity-and-access/toc.yml | 10 +++++----- api-reference/beta/toc/security/toc.yml | 4 ---- 2 files changed, 5 insertions(+), 9 deletions(-) diff --git a/api-reference/beta/toc/identity-and-access/toc.yml b/api-reference/beta/toc/identity-and-access/toc.yml index 8a6c0799e78..1d92f45837f 100644 --- a/api-reference/beta/toc/identity-and-access/toc.yml +++ b/api-reference/beta/toc/identity-and-access/toc.yml @@ -3939,7 +3939,7 @@ items: - name: Get href: ../../api/securitytoolawsserverlessfunctionadministratorfinding-get.md - name: Network access (preview) - displayName: Global Secure Access, Microsoft Entra Internet Access, Microsoft Entra Private Access + displayName: ZTNA, Global Secure Access, Microsoft Entra Internet Access, Microsoft Entra Private Access items: - name: Overview href: ../../resources/networkaccess-global-secure-access-api-overview.md @@ -4193,10 +4193,6 @@ items: items: - name: Filtering rule href: ../../resources/networkaccess-filteringrule.md - - name: FQDN Filtering rule - href: ../../resources/networkaccess-fqdnfilteringrule.md - - name: Web Category Filtering rule - href: ../../resources/networkaccess-webcategoryfilteringrule.md - name: List href: ../../api/networkaccess-filteringrule-list.md - name: Create @@ -4207,6 +4203,10 @@ items: href: ../../api/networkaccess-filteringrule-update.md - name: Delete href: ../../api/networkaccess-filteringrule-delete.md + - name: Fqdn filtering rule + href: ../../resources/networkaccess-fqdnfilteringrule.md + - name: Web category filtering rule + href: ../../resources/networkaccess-webcategoryfilteringrule.md - name: Partner customer administration items: - name: Partner security alert diff --git a/api-reference/beta/toc/security/toc.yml b/api-reference/beta/toc/security/toc.yml index 44022d107a9..cf4d6633f90 100644 --- a/api-reference/beta/toc/security/toc.yml +++ b/api-reference/beta/toc/security/toc.yml @@ -492,10 +492,6 @@ items: href: ../../api/security-sensor-getdeploymentaccesskey.md - name: Regenerate deployment access key href: ../../api/security-sensor-regeneratedeploymentaccesskey.md - - name: Complex types - items: - - name: Identity container - href: ../../resources/security-identitycontainer.md - name: Information protection items: - name: Information protection label From d847361b70a05be78a9ea1a95f3d175912cb78d9 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Fri, 20 Sep 2024 05:52:51 +0200 Subject: [PATCH 017/308] Update networkaccess-fqdnfilteringrule.md --- api-reference/beta/resources/networkaccess-fqdnfilteringrule.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md b/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md index 6544e9baff3..467fa50b9f1 100644 --- a/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md +++ b/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md @@ -28,7 +28,7 @@ For the list of API operations for managing this resource type, see [filteringRu |destinations|[microsoft.graph.networkaccess.ruleDestination](../resources/networkaccess-ruledestination.md) collection|The list of potential destinations and destination types that the user may access within the context of a network filtering policy. This includes FQDNs and web categories. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| |id|String|The unique identifier for the **fqdnFilteringRule**. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| |name|String|Display name. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| -|ruleType|microsoft.graph.networkaccess.networkDestinationType|The network destination type used by a filtering rule. Suppports a subset of the values for **networkDestinationType**. The possible values are: `fqdn`, `webCategory`, `unknownFutureValue`. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md). | +|ruleType|microsoft.graph.networkaccess.networkDestinationType|The network destination type used by a filtering rule. Supports a subset of the values for **networkDestinationType**. The possible values are: `fqdn`, `webCategory`, `unknownFutureValue`. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md). | ## Relationships None. From 5f2bd5a2431e87bec6cbfed5e415c8a854af7253 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Fri, 20 Sep 2024 05:54:50 +0200 Subject: [PATCH 018/308] Update networkaccess-webcategoryfilteringrule.md --- .../beta/resources/networkaccess-webcategoryfilteringrule.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/networkaccess-webcategoryfilteringrule.md b/api-reference/beta/resources/networkaccess-webcategoryfilteringrule.md index b38db5c65c9..f55ec47a0ac 100644 --- a/api-reference/beta/resources/networkaccess-webcategoryfilteringrule.md +++ b/api-reference/beta/resources/networkaccess-webcategoryfilteringrule.md @@ -28,7 +28,7 @@ For the list of API operations for managing this resource type, see [filteringRu |destinations|[microsoft.graph.networkaccess.ruleDestination](../resources/networkaccess-ruledestination.md) collection|The list of potential destinations and destination types that the user may access within the context of a network filtering policy. This includes FQDNs and web categories. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| |id|String|The unique identifier for the **webCategoryFilteringRule**. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| |name|String|Display name. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| -|ruleType|microsoft.graph.networkaccess.networkDestinationType|The network destination type used by a filtering rule. Suppports a subset of the values for **networkDestinationType**. The possible values are: `fqdn`, `webCategory`, `unknownFutureValue`. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md). | +|ruleType|microsoft.graph.networkaccess.networkDestinationType|The network destination type used by a filtering rule. Supports a subset of the values for **networkDestinationType**. The possible values are: `fqdn`, `webCategory`, `unknownFutureValue`. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md). | ## Relationships None. From 69dbff10c88086db93b9025680b66a3a60ad1d4d Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Fri, 20 Sep 2024 05:56:15 +0200 Subject: [PATCH 019/308] Update networkaccess-fqdnfilteringrule.md --- api-reference/beta/resources/networkaccess-fqdnfilteringrule.md | 1 + 1 file changed, 1 insertion(+) diff --git a/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md b/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md index 467fa50b9f1..4d310a71f6b 100644 --- a/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md +++ b/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md @@ -5,6 +5,7 @@ author: "Moti-ba" ms.localizationpriority: medium ms.subservice: "entra-global-secure-access" doc_type: resourcePageType +toc.title: "FQDN filtering rule" --- # fqdnFilteringRule resource type From bfe8f8ae53f732ae7952ec3c2b35037799201743 Mon Sep 17 00:00:00 2001 From: Microsoft Graph DevX Tooling Date: Fri, 20 Sep 2024 03:57:39 +0000 Subject: [PATCH 020/308] Update reference TOC --- api-reference/beta/toc/identity-and-access/toc.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/toc/identity-and-access/toc.yml b/api-reference/beta/toc/identity-and-access/toc.yml index 1d92f45837f..10308c7cf7e 100644 --- a/api-reference/beta/toc/identity-and-access/toc.yml +++ b/api-reference/beta/toc/identity-and-access/toc.yml @@ -4203,7 +4203,7 @@ items: href: ../../api/networkaccess-filteringrule-update.md - name: Delete href: ../../api/networkaccess-filteringrule-delete.md - - name: Fqdn filtering rule + - name: FQDN filtering rule href: ../../resources/networkaccess-fqdnfilteringrule.md - name: Web category filtering rule href: ../../resources/networkaccess-webcategoryfilteringrule.md From c3e558ddb1d4ec471b79ca90ec9d42f6c0ff9a8f Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Fri, 20 Sep 2024 06:03:27 +0200 Subject: [PATCH 021/308] Update networkaccess-filteringrule-list.md --- api-reference/beta/api/networkaccess-filteringrule-list.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/api/networkaccess-filteringrule-list.md b/api-reference/beta/api/networkaccess-filteringrule-list.md index b7cdb0bc5c7..01db49491ec 100644 --- a/api-reference/beta/api/networkaccess-filteringrule-list.md +++ b/api-reference/beta/api/networkaccess-filteringrule-list.md @@ -12,7 +12,10 @@ Namespace: microsoft.graph.networkaccess [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Get a list of the [filteringRule](../resources/networkaccess-filteringrule.md) objects and their properties. +Get a list of the [filteringRule](../resources/networkaccess-filteringrule.md) objects and their properties. The following derived types are supported: + +- [fqdnFilteringRule](networkaccess-fqdnfilteringrule.md) +- [webCategoryFilteringRule](networkaccess-webcategoryfilteringrule.md) [!INCLUDE [national-cloud-support](../../includes/global-only.md)] @@ -47,7 +50,7 @@ Don't supply a request body for this method. ## Response -If successful, this method returns a `200 OK` response code and a collection of [filteringRule](../resources/networkaccess-filteringrule.md) objects in the response body. +If successful, this method returns a `200 OK` response code and a collection of [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md) objects in the response body. The **@odata.type** property in the response object indicates the type of the **filteringRule** object. ## Examples From cb22f388f03a5bc76852ab79ae62f43ee4534f3c Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Fri, 20 Sep 2024 06:05:32 +0200 Subject: [PATCH 022/308] Update networkaccess-filteringrule-post.md --- api-reference/beta/api/networkaccess-filteringrule-post.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/api/networkaccess-filteringrule-post.md b/api-reference/beta/api/networkaccess-filteringrule-post.md index f0a9b250f4d..e39bc5d753b 100644 --- a/api-reference/beta/api/networkaccess-filteringrule-post.md +++ b/api-reference/beta/api/networkaccess-filteringrule-post.md @@ -12,7 +12,10 @@ Namespace: microsoft.graph.networkaccess [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Create a new [filteringRule](../resources/networkaccess-filteringrule.md). +Create a new [filteringRule](../resources/networkaccess-filteringrule.md). The following derived types are supported: + +- [fqdnFilteringRule](networkaccess-fqdnfilteringrule.md) +- [webCategoryFilteringRule](networkaccess-webcategoryfilteringrule.md) [!INCLUDE [national-cloud-support](../../includes/global-only.md)] @@ -46,7 +49,7 @@ In the request body, supply a JSON representation of the [fqdnFilteringRule](../ ## Response -If successful, this method returns a `201 Created` response code and a [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md) object in the response body. +If successful, this method returns a `201 Created` response code and a [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md) object in the response body. The **@odata.type** property specifies the type of the created object. ## Examples From 7811d167f0303d8f22c5cc2c1e5ea4b3137029aa Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Fri, 20 Sep 2024 06:07:27 +0200 Subject: [PATCH 023/308] Update networkaccess-filteringrule-get.md --- .../api/networkaccess-filteringrule-get.md | 21 +++++++++++-------- 1 file changed, 12 insertions(+), 9 deletions(-) diff --git a/api-reference/beta/api/networkaccess-filteringrule-get.md b/api-reference/beta/api/networkaccess-filteringrule-get.md index c4b8952d4c4..3e771fa6d87 100644 --- a/api-reference/beta/api/networkaccess-filteringrule-get.md +++ b/api-reference/beta/api/networkaccess-filteringrule-get.md @@ -12,7 +12,10 @@ Namespace: microsoft.graph.networkaccess [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Get a [filteringRule](../resources/networkaccess-filteringrule.md) object. +Get a [filteringRule](../resources/networkaccess-filteringrule.md) object. The following derived types are supported: + +- [fqdnFilteringRule](networkaccess-fqdnfilteringrule.md) +- [webCategoryFilteringRule](networkaccess-webcategoryfilteringrule.md) [!INCLUDE [national-cloud-support](../../includes/global-only.md)] @@ -35,7 +38,7 @@ GET /networkaccess/filteringPolicies/{filteringPoliciesId}/policyRules/{policyRu ``` ## Optional query parameters -This method does not supports OData query parameters. +This method doesn't support OData query parameters. ## Request headers |Name|Description| @@ -47,7 +50,7 @@ Don't supply a request body for this method. ## Response -If successful, this method returns a `200 OK` response code and a [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md) object in the response body. +If successful, this method returns a `200 OK` response code and a [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md) object in the response body. The **@odata.type** property in the response object indicates the type of the **filteringRule** object. ## Examples @@ -115,12 +118,12 @@ Content-Type: application/json "id": "f76a8f4d-7e9f-4aa0-ae1a-e88330c5634c", "name": "Contoso", "ruleType": "fqdn", - "destinations": [ - { - "@odata.type": "#microsoft.graph.networkaccess.fqdn", - "value": "www.contoso.com" - } - ] + "destinations": [ + { + "@odata.type": "#microsoft.graph.networkaccess.fqdn", + "value": "www.contoso.com" + } + ] } ``` From 656cf945176476a1a14d61882bcf18bf8d0fa8e2 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Fri, 20 Sep 2024 06:10:18 +0200 Subject: [PATCH 024/308] Update networkaccess-filteringrule-update.md --- .../beta/api/networkaccess-filteringrule-update.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/api/networkaccess-filteringrule-update.md b/api-reference/beta/api/networkaccess-filteringrule-update.md index e18313b8e70..f5d8af62f8a 100644 --- a/api-reference/beta/api/networkaccess-filteringrule-update.md +++ b/api-reference/beta/api/networkaccess-filteringrule-update.md @@ -12,7 +12,10 @@ Namespace: microsoft.graph.networkaccess [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Update the properties of a [filteringRule](../resources/networkaccess-filteringrule.md) object. +Update the properties of a [filteringRule](../resources/networkaccess-filteringrule.md) object. The following derived types are supported: + +- [fqdnFilteringRule](networkaccess-fqdnfilteringrule.md) +- [webCategoryFilteringRule](networkaccess-webcategoryfilteringrule.md) [!INCLUDE [national-cloud-support](../../includes/global-only.md)] @@ -43,10 +46,11 @@ PATCH /networkaccess/filteringPolicies/{filteringPolicyId}/policyRules/{filterin ## Request body [!INCLUDE [table-intro](../../includes/update-property-table-intro.md)] +You must specify the **@odata.type** property and the value of the **filteringRule** object type to update. For example, `"@odata.type": "#microsoft.graph.networkaccess.webCategoryFilteringRule"`. |Property|Type|Description| |:---|:---|:---| -|name|String|The dissplay name. Inherited from [microsoft.graph.networkaccess.policyRule](../resources/networkaccess-policyrule.md). Required.| +|name|String|The display name. Inherited from [microsoft.graph.networkaccess.policyRule](../resources/networkaccess-policyrule.md). Required.| |ruleType|microsoft.graph.networkaccess.networkDestinationType|The destination rule type. The possible values are `fqdn` and `webCategory`. Required.| |destinations|[microsoft.graph.networkaccess.ruleDestination](../resources/networkaccess-ruledestination.md) collection|A collection of destinations to update. Optional.| From aa40ae39bfeaf07f95bbc37ad13604f013030917 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Fri, 20 Sep 2024 06:11:25 +0200 Subject: [PATCH 025/308] Update networkaccess-filteringrule-delete.md --- .../beta/api/networkaccess-filteringrule-delete.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/api-reference/beta/api/networkaccess-filteringrule-delete.md b/api-reference/beta/api/networkaccess-filteringrule-delete.md index e4927e457e1..ecc73dc2623 100644 --- a/api-reference/beta/api/networkaccess-filteringrule-delete.md +++ b/api-reference/beta/api/networkaccess-filteringrule-delete.md @@ -12,7 +12,10 @@ Namespace: microsoft.graph.networkaccess [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Delete a [filteringRule](../resources/networkaccess-filteringrule.md) object. +Delete a [filteringRule](../resources/networkaccess-filteringrule.md) object. The following derived types are supported: + +- [fqdnFilteringRule](networkaccess-fqdnfilteringrule.md) +- [webCategoryFilteringRule](networkaccess-webcategoryfilteringrule.md) [!INCLUDE [national-cloud-support](../../includes/global-only.md)] @@ -32,7 +35,6 @@ Choose the permission or permissions marked as least privileged for this API. Us --> ``` http DELETE /networkaccess/filteringPolicies/{filteringPolicyId}/policyRules/{filteringRuleId} - ``` ## Request headers @@ -59,7 +61,6 @@ The following example shows a request. --> ``` http DELETE https://graph.microsoft.com/beta/networkaccess/filteringPolicies/bb1d249e-0691-477c-aae4-adfca179746a/policyRules/67f2edf8-1dc0-4a4f-87ea-9117541646de - ``` # [C#](#tab/csharp) From 1e684be4eb3869cb18b569de9d23fd9d12efb7e9 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Fri, 20 Sep 2024 06:15:21 +0200 Subject: [PATCH 026/308] Update Microsoft.ZTNA.json --- changelog/Microsoft.ZTNA.json | 28 +++++++++++++++++++++++++++- 1 file changed, 27 insertions(+), 1 deletion(-) diff --git a/changelog/Microsoft.ZTNA.json b/changelog/Microsoft.ZTNA.json index fe15e484dcd..b1f3b6402e7 100644 --- a/changelog/Microsoft.ZTNA.json +++ b/changelog/Microsoft.ZTNA.json @@ -691,6 +691,32 @@ "CreatedDateTime": "2024-04-10T00:00:00.8805486Z", "WorkloadArea": "Identity and access", "SubArea": "Network access" + }, + { + "ChangeList": [ + { + "Id": "2f78a000-b6f6-425e-be85-84ec0e6941ed", + "ApiChange": "Resource", + "ChangedApiName": "fqdnFilteringRule", + "ChangeType": "Addition", + "Description": "Added the [fqdnFilteringRule](https://learn.microsoft.com/en-us/graph/api/resources/networkaccess-fqdnfilteringrule?view=graph-rest-beta) resource type.", + "Target": "fqdnFilteringRule" + }, + { + "Id": "2f78a000-b6f6-425e-be85-84ec0e6941ed", + "ApiChange": "Resource", + "ChangedApiName": "webCategoryFilteringRule", + "ChangeType": "Addition", + "Description": "Added the [webCategoryFilteringRule](https://learn.microsoft.com/en-us/graph/api/resources/networkaccess-webcategoryfilteringrule?view=graph-rest-beta) resource type.", + "Target": "webCategoryFilteringRule" + } + ], + "Id": "2f78a000-b6f6-425e-be85-84ec0e6941ed", + "Cloud": "Prod", + "Version": "beta", + "CreatedDateTime": "2024-09-20T00:00:00.8805486Z", + "WorkloadArea": "Identity and access", + "SubArea": "Network access" } ] -} \ No newline at end of file +} From d695d363c73600a67076ccbd7de3b9552a1c4e53 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Fri, 20 Sep 2024 06:20:39 +0200 Subject: [PATCH 027/308] Update whats-new-overview.md --- concepts/whats-new-overview.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/concepts/whats-new-overview.md b/concepts/whats-new-overview.md index 1a1ab7bd537..4c4e5c226b4 100644 --- a/concepts/whats-new-overview.md +++ b/concepts/whats-new-overview.md @@ -32,6 +32,10 @@ Added the ability to [get](/graph/api/security-healthissue-get), [list](/graph/a Removed the **getShiftWorkCloudPcAccessState** method from the [cloudPC](/graph/api/resources/cloudpc?view=graph-rest-beta&preserve-view=true) resource. Going forward, use the [getFrontlineCloudPcAccessState](/graph/api/cloudpc-getfrontlinecloudpcaccessstate?view=graph-rest-beta&preserve-view=true) API. +### Identity and access | Network access + +List, create, get, update, and delete [fqdnFilteringRule](/graph/api/resources/networkaccess-fqdnfilteringrule?view=graph-rest-beta&preserve-view=true) and [webCategoryFilteringRule](/graph/api/resources/networkaccess-webcategoryfilteringrule?view=graph-rest-beta&preserve-view=true) resources that are derived types of [filteringRule](/graph/api/resources/networkaccess-filteringRule?view=graph-rest-beta&preserve-view=true). + ### Teamwork and communications | Calls and online meetings Use the **isDeltaRosterEnabled** property on [incomingCallOptions](/graph/api/resources/incomingcalloptions?view=graph-rest-beta&preserve-view=true) and [outgoingCallOptions](/graph/api/resources/outgoingcalloptions?view=graph-rest-beta&preserve-view=true) to indicate whether delta roster is enabled for a call. From 0422f4359d6cae588b483a65667bf95012517a65 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Fri, 20 Sep 2024 06:21:09 +0200 Subject: [PATCH 028/308] Update whats-new-overview.md --- concepts/whats-new-overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/concepts/whats-new-overview.md b/concepts/whats-new-overview.md index 4c4e5c226b4..487e157f45e 100644 --- a/concepts/whats-new-overview.md +++ b/concepts/whats-new-overview.md @@ -34,7 +34,7 @@ Removed the **getShiftWorkCloudPcAccessState** method from the [cloudPC](/graph/ ### Identity and access | Network access -List, create, get, update, and delete [fqdnFilteringRule](/graph/api/resources/networkaccess-fqdnfilteringrule?view=graph-rest-beta&preserve-view=true) and [webCategoryFilteringRule](/graph/api/resources/networkaccess-webcategoryfilteringrule?view=graph-rest-beta&preserve-view=true) resources that are derived types of [filteringRule](/graph/api/resources/networkaccess-filteringRule?view=graph-rest-beta&preserve-view=true). +List, create, get, update, and delete [fqdnFilteringRule](/graph/api/resources/networkaccess-fqdnfilteringrule?view=graph-rest-beta&preserve-view=true) and [webCategoryFilteringRule](/graph/api/resources/networkaccess-webcategoryfilteringrule?view=graph-rest-beta&preserve-view=true) resources that are derived types of [filteringRule](/graph/api/resources/networkaccess-filteringrule?view=graph-rest-beta&preserve-view=true). ### Teamwork and communications | Calls and online meetings From c24a6f4f5431aec9ec37233a679007b98f8fd957 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Fri, 20 Sep 2024 06:24:46 +0200 Subject: [PATCH 029/308] Update networkaccess-filteringrule.md --- .../beta/resources/networkaccess-filteringrule.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/api-reference/beta/resources/networkaccess-filteringrule.md b/api-reference/beta/resources/networkaccess-filteringrule.md index 3c5ebb8a322..6b336035d21 100644 --- a/api-reference/beta/resources/networkaccess-filteringrule.md +++ b/api-reference/beta/resources/networkaccess-filteringrule.md @@ -22,11 +22,11 @@ Inherits from [policyRule](../resources/networkaccess-policyrule.md). ## Methods |Method|Return type|Description| |:---|:---|:---| -|[List](../api/networkaccess-filteringrule-list.md)|[microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md) collection|Get a list of the [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md) objects and their properties.| -|[Create](../api/networkaccess-filteringrule-post.md)|[microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md)|Create a new [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md) object.| -|[Get](../api/networkaccess-filteringrule-get.md)|[microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md)|Get a [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md) object.| -|[Update](../api/networkaccess-filteringrule-update.md)|[microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md)|Update the properties of a [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md) object.| -|[Delete](../api/networkaccess-filteringrule-delete.md)|None|Delete a [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md) object.| +|[List](../api/networkaccess-filteringrule-list.md)|[microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md) collection|Get a list of the object types that are derived from **filteringRule**.| +|[Create](../api/networkaccess-filteringrule-post.md)|[microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md)|Create a new object type that is derived from **filteringRule**.| +|[Get](../api/networkaccess-filteringrule-get.md)|[microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md)|Get the properties and relationships of an object type that is derived from **filteringRule**.| +|[Update](../api/networkaccess-filteringrule-update.md)|[microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md)|Update the properties of an object type that is derived from **filteringRule**.| +|[Delete](../api/networkaccess-filteringrule-delete.md)|None|Delete an object type that is derived from **filteringRule**.| ## Properties |Property|Type|Description| From f903ffe6a7b0ed0dcf416ebc99b6ff31345a1a1f Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Fri, 20 Sep 2024 06:25:40 +0200 Subject: [PATCH 030/308] Update networkaccess-fqdnfilteringrule.md --- api-reference/beta/resources/networkaccess-fqdnfilteringrule.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md b/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md index 4d310a71f6b..d5e3c7d2453 100644 --- a/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md +++ b/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md @@ -1,6 +1,6 @@ --- title: "fqdnFilteringRule resource type" -description: "Defines a network filtering rule specifically for fully qualified domain names (FQDNs), allowing administrators to control access to specified domains." +description: "Defines a network filtering rule specifically for fully qualified domain names (FQDNs)that allows administrators to control access to specified domains." author: "Moti-ba" ms.localizationpriority: medium ms.subservice: "entra-global-secure-access" From 7dd41bdf1d5ed93bcb7904a0c614a34f8c118cd8 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Fri, 20 Sep 2024 06:30:34 +0200 Subject: [PATCH 031/308] Update networkaccess-filteringrule-delete.md --- api-reference/beta/api/networkaccess-filteringrule-delete.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/api/networkaccess-filteringrule-delete.md b/api-reference/beta/api/networkaccess-filteringrule-delete.md index ecc73dc2623..cf49a1be4fe 100644 --- a/api-reference/beta/api/networkaccess-filteringrule-delete.md +++ b/api-reference/beta/api/networkaccess-filteringrule-delete.md @@ -14,8 +14,8 @@ Namespace: microsoft.graph.networkaccess Delete a [filteringRule](../resources/networkaccess-filteringrule.md) object. The following derived types are supported: -- [fqdnFilteringRule](networkaccess-fqdnfilteringrule.md) -- [webCategoryFilteringRule](networkaccess-webcategoryfilteringrule.md) +- [fqdnFilteringRule](../resources/networkaccess-fqdnfilteringrule.md) +- [webCategoryFilteringRule](../resources/networkaccess-webcategoryfilteringrule.md) [!INCLUDE [national-cloud-support](../../includes/global-only.md)] From 50af37e0d9bb5410822f711f562566f468213a7b Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Fri, 20 Sep 2024 06:30:48 +0200 Subject: [PATCH 032/308] Update networkaccess-filteringrule-get.md --- api-reference/beta/api/networkaccess-filteringrule-get.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/api/networkaccess-filteringrule-get.md b/api-reference/beta/api/networkaccess-filteringrule-get.md index 3e771fa6d87..336f0806bfe 100644 --- a/api-reference/beta/api/networkaccess-filteringrule-get.md +++ b/api-reference/beta/api/networkaccess-filteringrule-get.md @@ -14,8 +14,8 @@ Namespace: microsoft.graph.networkaccess Get a [filteringRule](../resources/networkaccess-filteringrule.md) object. The following derived types are supported: -- [fqdnFilteringRule](networkaccess-fqdnfilteringrule.md) -- [webCategoryFilteringRule](networkaccess-webcategoryfilteringrule.md) +- [fqdnFilteringRule](../resources/networkaccess-fqdnfilteringrule.md) +- [webCategoryFilteringRule](../resources/networkaccess-webcategoryfilteringrule.md) [!INCLUDE [national-cloud-support](../../includes/global-only.md)] From b3d1587642f3dada5d8b506966a83b764c664ab1 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Fri, 20 Sep 2024 06:31:01 +0200 Subject: [PATCH 033/308] Update networkaccess-filteringrule-list.md --- api-reference/beta/api/networkaccess-filteringrule-list.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/api/networkaccess-filteringrule-list.md b/api-reference/beta/api/networkaccess-filteringrule-list.md index 01db49491ec..231342e12ad 100644 --- a/api-reference/beta/api/networkaccess-filteringrule-list.md +++ b/api-reference/beta/api/networkaccess-filteringrule-list.md @@ -14,8 +14,8 @@ Namespace: microsoft.graph.networkaccess Get a list of the [filteringRule](../resources/networkaccess-filteringrule.md) objects and their properties. The following derived types are supported: -- [fqdnFilteringRule](networkaccess-fqdnfilteringrule.md) -- [webCategoryFilteringRule](networkaccess-webcategoryfilteringrule.md) +- [fqdnFilteringRule](../resources/networkaccess-fqdnfilteringrule.md) +- [webCategoryFilteringRule](../resources/networkaccess-webcategoryfilteringrule.md) [!INCLUDE [national-cloud-support](../../includes/global-only.md)] From deb3e76925ea3f78fc0263ea5c96436640bed74f Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Fri, 20 Sep 2024 06:31:15 +0200 Subject: [PATCH 034/308] Update networkaccess-filteringrule-post.md --- api-reference/beta/api/networkaccess-filteringrule-post.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/api/networkaccess-filteringrule-post.md b/api-reference/beta/api/networkaccess-filteringrule-post.md index e39bc5d753b..deb1a25a9d0 100644 --- a/api-reference/beta/api/networkaccess-filteringrule-post.md +++ b/api-reference/beta/api/networkaccess-filteringrule-post.md @@ -14,8 +14,8 @@ Namespace: microsoft.graph.networkaccess Create a new [filteringRule](../resources/networkaccess-filteringrule.md). The following derived types are supported: -- [fqdnFilteringRule](networkaccess-fqdnfilteringrule.md) -- [webCategoryFilteringRule](networkaccess-webcategoryfilteringrule.md) +- [fqdnFilteringRule](../resources/networkaccess-fqdnfilteringrule.md) +- [webCategoryFilteringRule](../resources/networkaccess-webcategoryfilteringrule.md) [!INCLUDE [national-cloud-support](../../includes/global-only.md)] From 86e33e25f0907fe0c37fca12b03115313e421328 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Fri, 20 Sep 2024 06:31:30 +0200 Subject: [PATCH 035/308] Update networkaccess-filteringrule-update.md --- api-reference/beta/api/networkaccess-filteringrule-update.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/api/networkaccess-filteringrule-update.md b/api-reference/beta/api/networkaccess-filteringrule-update.md index f5d8af62f8a..08abb19bca3 100644 --- a/api-reference/beta/api/networkaccess-filteringrule-update.md +++ b/api-reference/beta/api/networkaccess-filteringrule-update.md @@ -14,8 +14,8 @@ Namespace: microsoft.graph.networkaccess Update the properties of a [filteringRule](../resources/networkaccess-filteringrule.md) object. The following derived types are supported: -- [fqdnFilteringRule](networkaccess-fqdnfilteringrule.md) -- [webCategoryFilteringRule](networkaccess-webcategoryfilteringrule.md) +- [fqdnFilteringRule](../resources/networkaccess-fqdnfilteringrule.md) +- [webCategoryFilteringRule](../resources/networkaccess-webcategoryfilteringrule.md) [!INCLUDE [national-cloud-support](../../includes/global-only.md)] From b49087efe9aa768daa44bf2a20eba8ee44961144 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Fri, 20 Sep 2024 06:32:09 +0200 Subject: [PATCH 036/308] Update networkaccess-fqdnfilteringrule.md --- api-reference/beta/resources/networkaccess-fqdnfilteringrule.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md b/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md index d5e3c7d2453..7e97dca82d8 100644 --- a/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md +++ b/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md @@ -1,6 +1,6 @@ --- title: "fqdnFilteringRule resource type" -description: "Defines a network filtering rule specifically for fully qualified domain names (FQDNs)that allows administrators to control access to specified domains." +description: "Defines a network filtering rule specifically for fully qualified domain names (FQDNs) that allows administrators to control access to specified domains." author: "Moti-ba" ms.localizationpriority: medium ms.subservice: "entra-global-secure-access" From 66008155fe95ee160c068ad9b6587c0b1ade568e Mon Sep 17 00:00:00 2001 From: moti-ba <131643892+moti-ba@users.noreply.github.com> Date: Sun, 22 Sep 2024 09:36:59 +0300 Subject: [PATCH 037/308] Update networkaccess-fqdnfilteringrule.md --- api-reference/beta/resources/networkaccess-fqdnfilteringrule.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md b/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md index 7e97dca82d8..e13985993cf 100644 --- a/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md +++ b/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md @@ -26,7 +26,7 @@ For the list of API operations for managing this resource type, see [filteringRu ## Properties |Property|Type|Description| |:---|:---|:---| -|destinations|[microsoft.graph.networkaccess.ruleDestination](../resources/networkaccess-ruledestination.md) collection|The list of potential destinations and destination types that the user may access within the context of a network filtering policy. This includes FQDNs and web categories. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| +|destinations|[microsoft.graph.networkaccess.ruleDestination](../resources/networkaccess-ruledestination.md) collection|The list of potential destinations and destination types that the user may access includes both FQDNs and web categories within the context of a network filtering policy.. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| |id|String|The unique identifier for the **fqdnFilteringRule**. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| |name|String|Display name. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| |ruleType|microsoft.graph.networkaccess.networkDestinationType|The network destination type used by a filtering rule. Supports a subset of the values for **networkDestinationType**. The possible values are: `fqdn`, `webCategory`, `unknownFutureValue`. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md). | From d161e413073477d91e31db86c67688f5af70b856 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Sun, 22 Sep 2024 22:07:11 +0200 Subject: [PATCH 038/308] Update networkaccess-fqdnfilteringrule.md --- api-reference/beta/resources/networkaccess-fqdnfilteringrule.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md b/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md index e13985993cf..79db20bb726 100644 --- a/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md +++ b/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md @@ -26,7 +26,7 @@ For the list of API operations for managing this resource type, see [filteringRu ## Properties |Property|Type|Description| |:---|:---|:---| -|destinations|[microsoft.graph.networkaccess.ruleDestination](../resources/networkaccess-ruledestination.md) collection|The list of potential destinations and destination types that the user may access includes both FQDNs and web categories within the context of a network filtering policy.. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| +|destinations|[microsoft.graph.networkaccess.ruleDestination](../resources/networkaccess-ruledestination.md) collection|The list of potential destinations and destination types that the user may access includes both FQDNs and web categories within the context of a network filtering policy. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| |id|String|The unique identifier for the **fqdnFilteringRule**. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| |name|String|Display name. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| |ruleType|microsoft.graph.networkaccess.networkDestinationType|The network destination type used by a filtering rule. Supports a subset of the values for **networkDestinationType**. The possible values are: `fqdn`, `webCategory`, `unknownFutureValue`. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md). | From 89ab9810b4de0f51ee466f5e34845262a34bb6c8 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Sun, 22 Sep 2024 22:10:06 +0200 Subject: [PATCH 039/308] Update networkaccess-webcategoryfilteringrule.md --- .../beta/resources/networkaccess-webcategoryfilteringrule.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/networkaccess-webcategoryfilteringrule.md b/api-reference/beta/resources/networkaccess-webcategoryfilteringrule.md index f55ec47a0ac..df6b2045b6f 100644 --- a/api-reference/beta/resources/networkaccess-webcategoryfilteringrule.md +++ b/api-reference/beta/resources/networkaccess-webcategoryfilteringrule.md @@ -25,7 +25,7 @@ For the list of API operations for managing this resource type, see [filteringRu ## Properties |Property|Type|Description| |:---|:---|:---| -|destinations|[microsoft.graph.networkaccess.ruleDestination](../resources/networkaccess-ruledestination.md) collection|The list of potential destinations and destination types that the user may access within the context of a network filtering policy. This includes FQDNs and web categories. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| +|destinations|[microsoft.graph.networkaccess.ruleDestination](../resources/networkaccess-ruledestination.md) collection|The list of potential destinations and destination types that the user may access, including fully qualified domain names (FQDNs) and web categories, within the context of a network filtering policy. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| |id|String|The unique identifier for the **webCategoryFilteringRule**. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| |name|String|Display name. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| |ruleType|microsoft.graph.networkaccess.networkDestinationType|The network destination type used by a filtering rule. Supports a subset of the values for **networkDestinationType**. The possible values are: `fqdn`, `webCategory`, `unknownFutureValue`. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md). | From f7d712ea55865e1dd5f19b712bb9a0d5f3e07602 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Sun, 22 Sep 2024 22:10:57 +0200 Subject: [PATCH 040/308] Update networkaccess-fqdnfilteringrule.md --- api-reference/beta/resources/networkaccess-fqdnfilteringrule.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md b/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md index 79db20bb726..bea86dec3b5 100644 --- a/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md +++ b/api-reference/beta/resources/networkaccess-fqdnfilteringrule.md @@ -26,7 +26,7 @@ For the list of API operations for managing this resource type, see [filteringRu ## Properties |Property|Type|Description| |:---|:---|:---| -|destinations|[microsoft.graph.networkaccess.ruleDestination](../resources/networkaccess-ruledestination.md) collection|The list of potential destinations and destination types that the user may access includes both FQDNs and web categories within the context of a network filtering policy. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| +|destinations|[microsoft.graph.networkaccess.ruleDestination](../resources/networkaccess-ruledestination.md) collection|The list of potential destinations and destination types that the user may access, including FQDNs and web categories, within the context of a network filtering policy. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| |id|String|The unique identifier for the **fqdnFilteringRule**. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| |name|String|Display name. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md).| |ruleType|microsoft.graph.networkaccess.networkDestinationType|The network destination type used by a filtering rule. Supports a subset of the values for **networkDestinationType**. The possible values are: `fqdn`, `webCategory`, `unknownFutureValue`. Inherited from [microsoft.graph.networkaccess.filteringRule](../resources/networkaccess-filteringrule.md). | From 760bfebb9bdb1b90db76e1433542b7c517f5569e Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Sun, 22 Sep 2024 22:11:52 +0200 Subject: [PATCH 041/308] Update networkaccess-filteringrule.md --- .../beta/resources/networkaccess-filteringrule.md | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/api-reference/beta/resources/networkaccess-filteringrule.md b/api-reference/beta/resources/networkaccess-filteringrule.md index 6b336035d21..f9decb55b29 100644 --- a/api-reference/beta/resources/networkaccess-filteringrule.md +++ b/api-reference/beta/resources/networkaccess-filteringrule.md @@ -52,14 +52,10 @@ The following JSON representation shows the resource type. ``` json { "@odata.type": "#microsoft.graph.networkaccess.filteringRule", + "destinations": [{"@odata.type": "microsoft.graph.networkaccess.webCategory"}], "id": "String (identifier)", "name": "String", - "ruleType": "String", - "destinations": [ - { - "@odata.type": "microsoft.graph.networkaccess.webCategory" - } - ] + "ruleType": "String" } ``` From 0b5ae81b9af47e707ac0e474da239e70ed2ff242 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Sun, 22 Sep 2024 22:16:32 +0200 Subject: [PATCH 042/308] Update networkaccess-filteringrule-list.md --- api-reference/beta/api/networkaccess-filteringrule-list.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/api/networkaccess-filteringrule-list.md b/api-reference/beta/api/networkaccess-filteringrule-list.md index 231342e12ad..31f21ab4cd7 100644 --- a/api-reference/beta/api/networkaccess-filteringrule-list.md +++ b/api-reference/beta/api/networkaccess-filteringrule-list.md @@ -38,7 +38,7 @@ GET /networkaccess/filteringPolicies/{filteringPolicyId}?$expand=policyRules ``` ## Optional query parameters -This method does not support OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). +This method doesn't support OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ## Request headers |Name|Description| From 8ed5743d7a8275263b4b428e0c5fd1700957941e Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Fri, 18 Oct 2024 10:27:23 -0500 Subject: [PATCH 043/308] create filestoragecontainer unlock file for v1 Create filestoragecontainer unlock file for v1. Update author and v1.0 file path. remove beta disclaimer --- .../beta/api/filestorage-list-containers.md | 2 +- .../v1.0/api/filestoragecontainer-unlock.md | 61 +++++++++++++++++++ 2 files changed, 62 insertions(+), 1 deletion(-) create mode 100644 api-reference/v1.0/api/filestoragecontainer-unlock.md diff --git a/api-reference/beta/api/filestorage-list-containers.md b/api-reference/beta/api/filestorage-list-containers.md index c6b720e3737..e7d5fea79cb 100644 --- a/api-reference/beta/api/filestorage-list-containers.md +++ b/api-reference/beta/api/filestorage-list-containers.md @@ -68,7 +68,7 @@ The following example enumerates all containers of a given container type. } --> ``` http -GET https://graph.microsoft.com/beta/storage/fileStorage/containers?$filter=containerTypeId eq {containerTypeId} +GET https://graph.microsoft.com/beta/storage/fileStorage/containers?$filter=containerTypeId eq e2756c4d-fa33-4452-9c36-2325686e1082 ``` # [C#](#tab/csharp) diff --git a/api-reference/v1.0/api/filestoragecontainer-unlock.md b/api-reference/v1.0/api/filestoragecontainer-unlock.md new file mode 100644 index 00000000000..57b18cc4606 --- /dev/null +++ b/api-reference/v1.0/api/filestoragecontainer-unlock.md @@ -0,0 +1,61 @@ +--- +title: "fileStorageContainer: unlock" +description: "Unlock a fileStorageContainer." +author: "harmoneddie" +ms.localizationpriority: medium +ms.subservice: "onedrive" +doc_type: apiPageType +--- + +# fileStorageContainer: unlock + +Namespace: microsoft.graph + +Unlock a [fileStorageContainer](../resources/filestoragecontainer.md) to allow users to add, update, or delete content. + +This action updates the value of the **lockState** property. + +## 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). + +When delegated permissions are used, only members in the `owner` role can call this method. + + +[!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-unlock-permissions.md)] + +## HTTP request + +``` http +POST /storage/fileStorage/containers/{containerId}/unlock +``` + +## 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 `204 No Content` response code. + +## Examples + +### Request +The following example shows how to unlock a **fileStorageContainer**. + +``` http +POST https://graph.microsoft.com/v1.0/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/unlock +``` + +### Response +The following example shows the response. + +``` http +HTTP/1.1 204 No Content +``` + From 50afa79fbf0bdbe0a95b4a37e1644a6bf4c5762a Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Fri, 18 Oct 2024 10:36:37 -0500 Subject: [PATCH 044/308] Create filestoragecontainer-lock.md Create filestoragecontainer lock file for v1. Update author and v1.0 file path. remove beta disclaimer --- .../v1.0/api/filestoragecontainer-lock.md | 71 +++++++++++++++++++ 1 file changed, 71 insertions(+) create mode 100644 api-reference/v1.0/api/filestoragecontainer-lock.md diff --git a/api-reference/v1.0/api/filestoragecontainer-lock.md b/api-reference/v1.0/api/filestoragecontainer-lock.md new file mode 100644 index 00000000000..bbff7ac509f --- /dev/null +++ b/api-reference/v1.0/api/filestoragecontainer-lock.md @@ -0,0 +1,71 @@ +--- +title: "fileStorageContainer: lock" +description: "Lock a fileStorageContainer." +author: "harmoneddie" +ms.localizationpriority: medium +ms.subservice: "onedrive" +doc_type: apiPageType +--- + +# fileStorageContainer: lock + +Namespace: microsoft.graph + +Lock a [fileStorageContainer](../resources/filestoragecontainer.md) to prevent users from adding, updating, or deleting content. + +This action updates the [lockState](../resources/enums.md#sitelockstate-values). + +## Permissions + +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). + + +[!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-lock-permissions.md)] + +> [!NOTE] +> When delegated permissions are used, only members who are assigned the `owner` role can call this method. + +## HTTP request + +``` http +POST /storage/fileStorage/containers/{containerId}/lock +``` + +## Request body +In the request body, you can optionally include a JSON representation of the **lockState** property. + +```json +{ + "lockState": "lockedReadOnly" +} +``` + +## Request headers +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| + +## Response + +If successful, this method returns a `204 No Content` response code. + +## Examples + +### Request +The following example shows how to lock a fileStorageContainer. + +``` http +POST https://graph.microsoft.com/v1.0/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/lock + +{ + "lockState": "lockedReadOnly" +} +``` + +### Response +The following example shows the response. + +``` http +HTTP/1.1 204 No Content +``` + From 2c2d27aeec6d9d09052c072334039e92abd2efd6 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Fri, 18 Oct 2024 10:55:48 -0500 Subject: [PATCH 045/308] Create filestoragecontainer-restore-recyclebin-items.md Create filestoragecontainer restore recycleBin items file for v1. Update author and v1.0 file path. remove beta disclaimer --- ...oragecontainer-restore-recyclebin-items.md | 110 ++++++++++++++++++ 1 file changed, 110 insertions(+) create mode 100644 api-reference/v1.0/api/filestoragecontainer-restore-recyclebin-items.md diff --git a/api-reference/v1.0/api/filestoragecontainer-restore-recyclebin-items.md b/api-reference/v1.0/api/filestoragecontainer-restore-recyclebin-items.md new file mode 100644 index 00000000000..444353f9603 --- /dev/null +++ b/api-reference/v1.0/api/filestoragecontainer-restore-recyclebin-items.md @@ -0,0 +1,110 @@ +--- +title: "Restore recycleBin items" +description: "Restore recycleBin items to a fileStorageContainer." +author: "harmoneddie" +ms.localizationpriority: medium +ms.subservice: "onedrive" +doc_type: apiPageType +--- + +# Restore recycle bin items + +Namespace: microsoft.graph + +Restore [recycleBinItem](../resources/recyclebinitem.md) objects from the [recycleBin](../resources/recyclebin.md) of a [fileStorageContainer](../resources/filestoragecontainer.md). + +## Permissions + +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). + + +[!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-restore-recyclebin-items-permissions.md)] + +## HTTP request + + + +``` http +POST /storage/fileStorage/containers/{containerId}/recycleBin/items/restore +``` + +## 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 [recycleBinItem](../resources/recyclebinitem.md) objects to restore. + +## Response + +If successful, this method returns a `207 Multi-Status` response code and the set of restored [recycleBinItem](../resources/recyclebinitem.md) objects in the response body. + +## Examples + +### Request + +The following example shows a request. + +# [HTTP](#tab/http) + + +``` http +POST https://graph.microsoft.com/v1.0/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/recycleBin/items/restore +Content-Type: application/json + +{ + "ids": ["5d625d33-338c-4a77-a98a-3e287116440c", "73133853-48f2-4956-bc4a-03f8d1675042"] +} +``` + +# [JavaScript](#tab/javascript) +[!INCLUDE [sample-code](../includes/snippets/javascript/restore-filestoragecontainer-recyclebin-items-javascript-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +--- + +### Response + +The following example shows the response. + +>**Note:** The response object shown here might be shortened for readability. + + + +``` http +HTTP/1.1 207 Multi-Status +Content-Type: application/json + +{ + "value": [ + { + "id": "5d625d33-338c-4a77-a98a-3e287116440c" + }, + { + "id": "73133853-48f2-4956-bc4a-03f8d1675042" + } + ] +} +``` + From 5a3209d4dadb3d5497e192f4c6a0c60bb4f70df1 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Fri, 18 Oct 2024 11:08:11 -0500 Subject: [PATCH 046/308] Create filestoragecontainer-delete-recyclebin-items.md Create filestoragecontainer delete recycleBin items file for v1. Update author and v1.0 file path. remove beta disclaimer --- ...toragecontainer-delete-recyclebin-items.md | 92 +++++++++++++++++++ 1 file changed, 92 insertions(+) create mode 100644 api-reference/v1.0/api/filestoragecontainer-delete-recyclebin-items.md diff --git a/api-reference/v1.0/api/filestoragecontainer-delete-recyclebin-items.md b/api-reference/v1.0/api/filestoragecontainer-delete-recyclebin-items.md new file mode 100644 index 00000000000..67d07c4d65c --- /dev/null +++ b/api-reference/v1.0/api/filestoragecontainer-delete-recyclebin-items.md @@ -0,0 +1,92 @@ +--- +title: "Delete recycleBin items" +description: "Delete items from fileStorageContainer recycleBin." +author: "harmoneddie" +ms.localizationpriority: medium +ms.subservice: "onedrive" +doc_type: apiPageType +--- + +# Delete recycle bin items + +Namespace: microsoft.graph + +Permanently delete [recycleBinItem](../resources/recyclebinitem.md) objects from the [recycleBin](../resources/recyclebin.md) of a [fileStorageContainer](../resources/filestoragecontainer.md). Items deleted by this method can't be restored. + +## Permissions + +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). + + +[!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-delete-recyclebin-items-permissions.md)] + +## HTTP request + + +``` http +POST /storage/fileStorage/containers/{containerId}/recycleBin/items/delete +``` + +## 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 [recycleBinItem](../resources/recyclebinitem.md) objects to delete. + + +## Response + +If successful, this method returns a `204 No Content` response code. + +## Examples + +### Request + +The following example shows a request. +# [HTTP](#tab/http) + +``` http +POST https://graph.microsoft.com/v1.0/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/recycleBin/items/delete +Content-Type: application/json + +{ + "ids": ["5d625d33-338c-4a77-a98a-3e287116440c", "73133853-48f2-4956-bc4a-03f8d1675042"] +} +``` + +# [JavaScript](#tab/javascript) +[!INCLUDE [sample-code](../includes/snippets/javascript/delete-filestoragecontainer-recyclebin-items-javascript-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +--- + +### Response + +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 204 No Content +``` + From 7963f9d696b56d97f7cd5ccf7bbd4ced0cb72365 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Fri, 18 Oct 2024 12:25:27 -0500 Subject: [PATCH 047/308] Create filestoragecontainer-restore.md Create filestoragecontainer restore file for v1. Update author and v1.0 file path. remove beta disclaimer --- .../v1.0/api/filestoragecontainer-restore.md | 92 +++++++++++++++++++ 1 file changed, 92 insertions(+) create mode 100644 api-reference/v1.0/api/filestoragecontainer-restore.md diff --git a/api-reference/v1.0/api/filestoragecontainer-restore.md b/api-reference/v1.0/api/filestoragecontainer-restore.md new file mode 100644 index 00000000000..f3cf9238e37 --- /dev/null +++ b/api-reference/v1.0/api/filestoragecontainer-restore.md @@ -0,0 +1,92 @@ +--- +title: "Restore deleted fileStorageContainer" +description: "Restore deleted fileStorageContainer from the deleted container collection." +author: "harmoneddie" +ms.localizationpriority: medium +ms.subservice: "onedrive" +doc_type: apiPageType +--- + +# fileStorageContainer: restore + +Namespace: microsoft.graph + +Restore a deleted [fileStorageContainer](../resources/filestoragecontainer.md) from the deleted container collection. + +## Permissions + +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). + + +[!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-restore-permissions.md)] + +## HTTP request + + +``` http +POST /deletedStorageContainers/{containerId}/restore +``` + +## 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 action returns a `200 OK` response code and a [fileStorageContainer](../resources/filestoragecontainer.md) in the response body. + +## Examples + +### Request + +The following example shows a request. + + +``` http +POST https://graph.microsoft.com/v1.0/deletedStorageContainers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/restore +``` + + +### Response + +The following example shows the response. + +> **Note:** The response object shown here might be shortened for readability. + + +``` http +HTTP/1.1 200 OK +Content-Type: application/json + +{ + "@odata.type": "microsoft.graph.fileStorageContainer", + "id": "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z", + "displayName": "My Application Storage Container", + "containerTypeId": "91710488-5756-407f-9046-fbe5f0b4de73", + "createdDateTime": "2021-11-24T15:41:52.347Z", + "deletedDateTime": "2022-08-11T12:35:16.300Z" +} +``` + From 4571fe0e83c6f1c9c25f8fe22e824648d43d2914 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Fri, 18 Oct 2024 12:40:35 -0500 Subject: [PATCH 048/308] Create filestoragecontainer-update-column.md Create filestoragecontainer update column file for v1. Update author and v1.0 file path. remove beta disclaimer --- .../api/filestoragecontainer-update-column.md | 138 ++++++++++++++++++ 1 file changed, 138 insertions(+) create mode 100644 api-reference/v1.0/api/filestoragecontainer-update-column.md diff --git a/api-reference/v1.0/api/filestoragecontainer-update-column.md b/api-reference/v1.0/api/filestoragecontainer-update-column.md new file mode 100644 index 00000000000..52dce2bfa6d --- /dev/null +++ b/api-reference/v1.0/api/filestoragecontainer-update-column.md @@ -0,0 +1,138 @@ +--- +title: "Update column" +description: "Update a columnDefinition in a fileStorageContainer." +author: "harmoneddie" +ms.localizationpriority: medium +ms.subservice: "onedrive" +doc_type: apiPageType +--- + +# Update column + +Namespace: microsoft.graph + +Update an existing column represented as a [columnDefinition](../resources/columndefinition.md) in a [fileStorageContainer](../resources/filestoragecontainer.md). + +## Permissions + +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). + + +[!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-update-columns-permissions.md)] + +## HTTP request + + +``` http +PATCH /storage/fileStorage/containers/{containerId}/columns/{column-id} +``` + +## 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 [columnDefinition](../resources/columndefinition.md) object with the properties to update. The `id` property can't be changed. Existing properties not included in the request body maintain their previous values. To optimize performance, don't include existing values that didn't change. + +## Response + +If successful, this method returns a `200 OK` response code and a [columnDefinition](../resources/columndefinition.md) object in the response body. + +## Examples + +### Request + +The following example shows a request. + +# [HTTP](#tab/http) + +``` http +PATCH https://graph.microsoft.com/v1.0/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/columns/11dfef35-e2f7-4f17-82b0-6fba34445103 +Content-Type: application/json + +{ + "required": true, + "hidden": false +} +``` + +# [C#](#tab/csharp) +[!INCLUDE [sample-code](../includes/snippets/csharp/update-columndefinition-for-filestoragecontainer-csharp-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [CLI](#tab/cli) +[!INCLUDE [sample-code](../includes/snippets/cli/update-columndefinition-for-filestoragecontainer-cli-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Go](#tab/go) +[!INCLUDE [sample-code](../includes/snippets/go/update-columndefinition-for-filestoragecontainer-go-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Java](#tab/java) +[!INCLUDE [sample-code](../includes/snippets/java/update-columndefinition-for-filestoragecontainer-java-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [JavaScript](#tab/javascript) +[!INCLUDE [sample-code](../includes/snippets/javascript/update-columndefinition-for-filestoragecontainer-javascript-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [PHP](#tab/php) +[!INCLUDE [sample-code](../includes/snippets/php/update-columndefinition-for-filestoragecontainer-php-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Python](#tab/python) +[!INCLUDE [sample-code](../includes/snippets/python/update-columndefinition-for-filestoragecontainer-python-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +--- + +### Response + +The following example shows the response. + +> **Note:** The response object shown here might be shortened for readability. + + +``` http +HTTP/1.1 200 OK +Content-type: application/json + +{ + "description": "", + "displayName": "Custom Column", + "enforceUniqueValues": false, + "hidden": false, + "id": "11dfef35-e2f7-4f17-82b0-6fba34445103", + "indexed": false, + "name": "Custom Column", + "readOnly": false, + "required": true, + "text": { + "allowMultipleLines": false, + "appendChangesToExistingText": false, + "linesForEditing": 0, + "maxLength": 255 + } +} +``` + From 6ab414e59c9d3a63216ca4674f3cd4efdddcfbbe Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Fri, 18 Oct 2024 12:47:01 -0500 Subject: [PATCH 049/308] Create filestoragecontainer-delete-column.md Create filestoragecontainer unlock file for v1. Update author and remove beta disclaimer --- .../api/filestoragecontainer-delete-column.md | 97 +++++++++++++++++++ 1 file changed, 97 insertions(+) create mode 100644 api-reference/v1.0/api/filestoragecontainer-delete-column.md diff --git a/api-reference/v1.0/api/filestoragecontainer-delete-column.md b/api-reference/v1.0/api/filestoragecontainer-delete-column.md new file mode 100644 index 00000000000..2ff1348023c --- /dev/null +++ b/api-reference/v1.0/api/filestoragecontainer-delete-column.md @@ -0,0 +1,97 @@ +--- +title: "Delete column" +description: "Delete a columnDefinition from a fileStorageContainer." +author: "harmoneddie" +ms.localizationpriority: medium +ms.subservice: "onedrive" +doc_type: apiPageType +--- + +# Delete column + +Namespace: microsoft.graph + +Delete a [columnDefinition](../resources/columndefinition.md) from a [fileStorageContainer](../resources/filestoragecontainer.md). + +## Permissions + +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). + + + +[!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-delete-columns-permissions.md)] + +## HTTP request + + +``` http +DELETE /storageContainers/{containerId}/columns/{column-id} +``` + +## 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 `204 No Content` response code. + +## Examples + +### Request + +The following example shows a request. + + +``` http +DELETE https://graph.microsoft.com/bet/storageContainers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/columns/99ddcf45-e2f7-4f17-82b0-6fba34445103 +Content-Type: application/json + +{ + "description": "test", + "enforceUniqueValues": false, + "hidden": false, + "indexed": false, + "name": "Title", + "text": { + "allowMultipleLines": false, + "appendChangesToExistingText": false, + "linesForEditing": 0, + "maxLength": 255 + } +} +``` + + +### Response + +The following example shows the response. + +>**Note:** The response object shown here might be shortened for readability. + + +``` http +HTTP/1.1 204 No Content +``` + From 6d64cec8fdabf312829e760982bef0fd70c2ad73 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 21 Oct 2024 21:46:55 -0500 Subject: [PATCH 050/308] Create filestoragecontainer-list-columns.md Create filestoragecontainer list columns file for v1. Update author and v1.0 file path. remove beta disclaimer --- .../api/filestoragecontainer-list-columns.md | 150 ++++++++++++++++++ 1 file changed, 150 insertions(+) create mode 100644 api-reference/v1.0/api/filestoragecontainer-list-columns.md diff --git a/api-reference/v1.0/api/filestoragecontainer-list-columns.md b/api-reference/v1.0/api/filestoragecontainer-list-columns.md new file mode 100644 index 00000000000..3f29d884826 --- /dev/null +++ b/api-reference/v1.0/api/filestoragecontainer-list-columns.md @@ -0,0 +1,150 @@ +--- +title: "List columns" +description: "List columns in a fileStorageContainer." +author: "harmoneddie" +ms.localizationpriority: medium +ms.subservice: "onedrive" +doc_type: apiPageType +--- + +# List columns + +Namespace: microsoft.graph + +Get the collection of columns represented as [columnDefinition](../resources/columndefinition.md) resources in a [fileStorageContainer](../resources/filestoragecontainer.md). + +## Permissions + +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). + + +[!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-list-columns-permissions.md)] + +## HTTP request + + + +``` http +GET /storage/fileStorage/containers/{containerId}/columns +``` + +## 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 [columnDefinition](../resources/columndefinition.md) objects in the response body. + +## Examples + +### Request + +The following example shows a request. +# [HTTP](#tab/http) + + +``` http +GET https://graph.microsoft.com/v1.0/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/columns +``` + +# [C#](#tab/csharp) +[!INCLUDE [sample-code](../includes/snippets/csharp/list-columndefinition-csharp-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [CLI](#tab/cli) +[!INCLUDE [sample-code](../includes/snippets/cli/list-columndefinition-cli-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Go](#tab/go) +[!INCLUDE [sample-code](../includes/snippets/go/list-columndefinition-go-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Java](#tab/java) +[!INCLUDE [sample-code](../includes/snippets/java/list-columndefinition-java-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [JavaScript](#tab/javascript) +[!INCLUDE [sample-code](../includes/snippets/javascript/list-columndefinition-javascript-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [PHP](#tab/php) +[!INCLUDE [sample-code](../includes/snippets/php/list-columndefinition-php-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Python](#tab/python) +[!INCLUDE [sample-code](../includes/snippets/python/list-columndefinition-python-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +--- + +### Response + +The following example shows the response. + +>**Note:** The response object shown here might be shortened for readability. + + +``` http +HTTP/1.1 200 OK +Content-Type: application/json + +{ + "value": [ + { + "description": "", + "displayName": "Title", + "hidden": false, + "id": "99ddcf45-e2f7-4f17-82b0-6fba34445103", + "indexed": false, + "name": "Title", + "readOnly": false, + "required": false, + "text": { + "allowMultipleLines": false, + "appendChangesToExistingText": false, + "linesForEditing": 0, + "maxLength": 255 + } + }, + { + "description": "", + "displayName": "Address", + "id": "11dfef35-e2f7-4f17-82b0-6fba34445103", + "indexed": false, + "name": "Address", + "readOnly": false, + "required": false, + "text": { + "allowMultipleLines": false, + "appendChangesToExistingText": false, + "linesForEditing": 0, + "maxLength": 255 + } + } + ] +} +``` + From 26c9073eba1016e5ea2aed656fbbcc291ff07c73 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 21 Oct 2024 22:02:52 -0500 Subject: [PATCH 051/308] Create filestoragecontainer-get-column.md Create filestoragecontainer get column file for v1. Update author and v1.0 file path. remove beta disclaimer --- .../api/filestoragecontainer-get-column.md | 97 +++++++++++++++++++ 1 file changed, 97 insertions(+) create mode 100644 api-reference/v1.0/api/filestoragecontainer-get-column.md diff --git a/api-reference/v1.0/api/filestoragecontainer-get-column.md b/api-reference/v1.0/api/filestoragecontainer-get-column.md new file mode 100644 index 00000000000..03d3e1c1ed5 --- /dev/null +++ b/api-reference/v1.0/api/filestoragecontainer-get-column.md @@ -0,0 +1,97 @@ +--- +title: "Get column" +description: "Get a column from a fileStorageContainer." +author: "harmoneddie" +ms.localizationpriority: medium +ms.subservice: "onedrive" +doc_type: apiPageType +--- + +# Get column + +Namespace: microsoft.graph + +Get the properties of a column represented as a [columnDefinition](../resources/columndefinition.md) in a [fileStorageContainer](../resources/filestoragecontainer.md). + +## Permissions + +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). + + +[!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-get-columns-permissions.md)] + +## HTTP request + + +``` http +GET /storageContainers/{containerId}/columns/{column-id} +``` + +## 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 [columnDefinition](../resources/columndefinition.md) object in the response body. + +## Examples + +### Request + +The following example shows a request. + +``` http +GET https://graph.microsoft.com/v1.0/storageContainers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/columns/99ddcf45-e2f7-4f17-82b0-6fba34445103 +``` + + +### Response + +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 200 OK +Content-Type: application/json + +{ + "description": "test", + "displayName": "Title", + "enforceUniqueValues": false, + "hidden": false, + "id": "99ddcf45-e2f7-4f17-82b0-6fba34445103", + "indexed": false, + "name": "Title", + "text": { + "allowMultipleLines": false, + "appendChangesToExistingText": false, + "linesForEditing": 0, + "maxLength": 255 + } +} +``` + From 2ac6df272c3dff6747e7c1230da2ae8ddaa813dc Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 21 Oct 2024 22:07:49 -0500 Subject: [PATCH 052/308] Create filestoragecontainer-list-recyclebin-items.md Create filestoragecontainer list recyclebin items file for v1. Update author and v1.0 file path. remove beta disclaimer --- ...estoragecontainer-list-recyclebin-items.md | 135 ++++++++++++++++++ 1 file changed, 135 insertions(+) create mode 100644 api-reference/v1.0/api/filestoragecontainer-list-recyclebin-items.md diff --git a/api-reference/v1.0/api/filestoragecontainer-list-recyclebin-items.md b/api-reference/v1.0/api/filestoragecontainer-list-recyclebin-items.md new file mode 100644 index 00000000000..30213543c80 --- /dev/null +++ b/api-reference/v1.0/api/filestoragecontainer-list-recyclebin-items.md @@ -0,0 +1,135 @@ +--- +title: "List recycleBin items" +description: "Get a list of recycle bin items from a fileStorageContainer recycleBin." +author: "harmoneddie" +ms.localizationpriority: medium +ms.subservice: "onedrive" +doc_type: apiPageType +--- + +# List recycleBin items + +Namespace: microsoft.graph + +Get a list of [recycleBinItem](../resources/recyclebinitem.md) objects from the [recycleBin](../resources/recyclebin.md) of a [fileStorageContainer](../resources/filestoragecontainer.md). + +## Permissions + +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). + + +[!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-list-recyclebin-items-permissions.md)] + +## HTTP request + + + +``` http +GET /storage/fileStorage/containers/{containerId}/recycleBin/items +``` + +## 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 [recycleBinItem](../resources/recyclebinitem.md) objects in the response body. + +## Examples + +### Request + +The following example shows a request. + +# [HTTP](#tab/http) + + +``` http +GET https://graph.microsoft.com/v1.0/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/recycleBin/items +``` + +# [C#](#tab/csharp) +[!INCLUDE [sample-code](../includes/snippets/csharp/list-recyclebin-items-csharp-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [CLI](#tab/cli) +[!INCLUDE [sample-code](../includes/snippets/cli/list-recyclebin-items-cli-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Go](#tab/go) +[!INCLUDE [sample-code](../includes/snippets/go/list-recyclebin-items-go-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Java](#tab/java) +[!INCLUDE [sample-code](../includes/snippets/java/list-recyclebin-items-java-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [JavaScript](#tab/javascript) +[!INCLUDE [sample-code](../includes/snippets/javascript/list-recyclebin-items-javascript-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [PHP](#tab/php) +[!INCLUDE [sample-code](../includes/snippets/php/list-recyclebin-items-php-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Python](#tab/python) +[!INCLUDE [sample-code](../includes/snippets/python/list-recyclebin-items-python-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +--- + +### Response + +The following example shows the response. + +>**Note:** The response object shown here might be shortened for readability. + + + +``` http +HTTP/1.1 200 OK +Content-Type: application/json + +{ + "value": [ + { + "id": "5d625d33-338c-4a77-a98a-3e287116440c", + "name": "document.docx", + "size": 1024, + "deletedDateTime": "2022-04-25T20:11:51Z", + "title": "my document", + "deletedBy": { + "user": { + "displayName": "Tenant Admin User", + "id": "EBA7DBE0-B42F-4BC8-AEF6-97B66EFC77D0", + "userPrincipalName": "jhan@contoso.com" + } + } + } + ] +} +``` + From 9147192969f3998c2efa1fcfd188c7c7bbb77f2b Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Tue, 22 Oct 2024 16:11:49 -0500 Subject: [PATCH 053/308] Update filestorage-list-containers.md Correct typos in list containers beta file. --- api-reference/beta/api/filestorage-list-containers.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/api/filestorage-list-containers.md b/api-reference/beta/api/filestorage-list-containers.md index e7d5fea79cb..6debe61c821 100644 --- a/api-reference/beta/api/filestorage-list-containers.md +++ b/api-reference/beta/api/filestorage-list-containers.md @@ -38,7 +38,7 @@ GET /storage/fileStorage/containers?$filter=containerTypeId eq {containerTypeId} ## Query parameters -This method required the `containerTypeId` parameter. It supports the `$expand` OData query parameter except for on the for **drive**, **permissions**, and **customProperties** properties. For general information, see [OData query parameters](/graph/query-parameters). +This method required the `containerTypeId` parameter. It supports the `$expand` OData query parameter, except for the **drive**, **permissions**, and **customProperties** properties. For more information, see [OData query parameters](/graph/query-parameters). ## Request headers From 886cd8d0b61564e2dc46c42a30a562b52822aa27 Mon Sep 17 00:00:00 2001 From: "Matthew M." <30242289+mcm223@users.noreply.github.com> Date: Wed, 23 Oct 2024 15:36:03 -0700 Subject: [PATCH 054/308] Update changelog date for AU release --- changelog/Microsoft.IC3.DataPlatform.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/changelog/Microsoft.IC3.DataPlatform.json b/changelog/Microsoft.IC3.DataPlatform.json index 1f617009167..19e34cf9888 100644 --- a/changelog/Microsoft.IC3.DataPlatform.json +++ b/changelog/Microsoft.IC3.DataPlatform.json @@ -1032,7 +1032,7 @@ "Id": "bb8eae43-f5ac-47a1-94b9-16492af7e7b1", "Cloud": "Prod", "Version": "v1.0", - "CreatedDateTime": "2024-09-04T14:22:24.0228479Z", + "CreatedDateTime": "2024-10-28T14:22:24.0228479Z", "WorkloadArea": "Teamwork and communications", "SubArea": "Calls and online meetings" } From 4a99c929614de749ab12c8a0af580b513781e3e7 Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero Date: Thu, 24 Oct 2024 16:03:32 -0600 Subject: [PATCH 055/308] Updated nav properties --- api-reference/v1.0/resources/filestoragecontainer.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/api-reference/v1.0/resources/filestoragecontainer.md b/api-reference/v1.0/resources/filestoragecontainer.md index 4a5e389cadb..0ad6cb35a6a 100644 --- a/api-reference/v1.0/resources/filestoragecontainer.md +++ b/api-reference/v1.0/resources/filestoragecontainer.md @@ -51,9 +51,10 @@ Represents a location where multiple users or a group of users can store files a |Relationship|Type|Description| |:---|:---|:---| +|columns|[columnDefinition](../resources/columndefinition.md) collection|The set of custom structured metadata supported by the **fileStorageContainer**. Read-write.| |drive|[drive](../resources/drive.md)|The drive of the resource **fileStorageContainer**. Read-only.| |permissions|[permission](../resources/permission.md) collection|The set of permissions for users in the **fileStorageContainer**. Permission for each user is set by the **roles** property. The possible values are: `reader`, `writer`, `manager`, and `owner`. Read-write.| -|settings|[fileStorageContainerSettings](../resources/filestoragecontainersettings.md)|Settings associated with a **fileStorageContainer**. Read-write. +|recycleBin|[recycleBin](../resources/recyclebin.md)|Recycle bin of the **fileStorageContainer**. Read-only.| ### roles property values From ea62dd6e5fd97eee1ae4b8b67d898194b109a72b Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero Date: Thu, 24 Oct 2024 16:12:50 -0600 Subject: [PATCH 056/308] Added the recycledbin resource to v1. --- api-reference/v1.0/resources/recyclebin.md | 54 ++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 api-reference/v1.0/resources/recyclebin.md diff --git a/api-reference/v1.0/resources/recyclebin.md b/api-reference/v1.0/resources/recyclebin.md new file mode 100644 index 00000000000..6e0cf04359b --- /dev/null +++ b/api-reference/v1.0/resources/recyclebin.md @@ -0,0 +1,54 @@ +--- +author: "vanshisingh" +title: "recycleBin resource type" +description: "Provides a list of recycleBinItems." +ms.localizationpriority: "medium" +doc_type: resourcePageType +ms.subservice: "sharepoint" +--- + +# recycleBin resource type + +Namespace: microsoft.graph + +Represents a container for a collection of [recycleBinItem](recyclebinitem.md) resources in a SharePoint [site](site.md) or a SharePoint Embedded [fileStorageContainer](filestoragecontainer.md). + +Inherits from [baseItem](baseitem.md). + +## Properties + +| Property | Type | Description | +|:---------|:-------|:-------------------------------------------------------------------------------------------------------------------------| +|id| String | The unique identifier for the **recycleBin** object. Returned only on `$select`. Inherited from [baseItem](baseitem.md). | +|settings|[recycleBinSettings](./recyclebinsettings.md)|Settings of the recycleBin.| + +## Relationships + +| Relationship | Type | Description | +|:-------------|:-----------------------------------------------|:---------------------------------------------------| +| items | [recycleBinItem](recyclebinitem.md) collection | List of the **recycleBinItems** deleted by a user. | + +## JSON Representation + +The following JSON representation shows the resource type. + + + +```json +{ + "id": "String (identifier)", + "settings": { "@odata.type": "microsoft.graph.recycleBinSettings" } +} +``` + + From 554b0d4d0ce5cd3e33053f26bf9a0ff0293c177b Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Thu, 24 Oct 2024 18:17:15 -0400 Subject: [PATCH 057/308] Create filestoragecontainer-delete-columns-permissions.md Add the permissions file that was missing for filestoragecontainer delete columns --- ...ilestoragecontainer-delete-columns-permissions.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 api-reference/v1.0/includes/permissions/filestoragecontainer-delete-columns-permissions.md diff --git a/api-reference/v1.0/includes/permissions/filestoragecontainer-delete-columns-permissions.md b/api-reference/v1.0/includes/permissions/filestoragecontainer-delete-columns-permissions.md new file mode 100644 index 00000000000..03353dba0b0 --- /dev/null +++ b/api-reference/v1.0/includes/permissions/filestoragecontainer-delete-columns-permissions.md @@ -0,0 +1,12 @@ +--- +description: Automatically generated file. DO NOT MODIFY +ms.topic: include +ms.localizationpriority: medium +--- + +|Permission type|Least privileged permission|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|FileStorageContainer.Selected|Not supported.| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|FileStorageContainer.Selected|Not supported.| + From 4adf11fece0cc6f65df040ff9ffda75188f3667c Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Thu, 24 Oct 2024 18:23:34 -0400 Subject: [PATCH 058/308] Create filestoragecontainer-delete-recyclebin-items-permissions.md Create missing permissions file in v1.0 for filestoragecontainer delete recyclebin items --- ...econtainer-delete-recyclebin-items-permissions.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 api-reference/v1.0/includes/permissions/filestoragecontainer-delete-recyclebin-items-permissions.md diff --git a/api-reference/v1.0/includes/permissions/filestoragecontainer-delete-recyclebin-items-permissions.md b/api-reference/v1.0/includes/permissions/filestoragecontainer-delete-recyclebin-items-permissions.md new file mode 100644 index 00000000000..03353dba0b0 --- /dev/null +++ b/api-reference/v1.0/includes/permissions/filestoragecontainer-delete-recyclebin-items-permissions.md @@ -0,0 +1,12 @@ +--- +description: Automatically generated file. DO NOT MODIFY +ms.topic: include +ms.localizationpriority: medium +--- + +|Permission type|Least privileged permission|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|FileStorageContainer.Selected|Not supported.| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|FileStorageContainer.Selected|Not supported.| + From 2bd6b5123d419c8d01ce88debdf4729851bda377 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Thu, 24 Oct 2024 18:28:22 -0400 Subject: [PATCH 059/308] Create filestoragecontainer-get-columns-permissions.md Create missing permissions file in v1.0 for filestoragecontainer get columns permissions --- .../filestoragecontainer-get-columns-permissions.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 api-reference/v1.0/includes/permissions/filestoragecontainer-get-columns-permissions.md diff --git a/api-reference/v1.0/includes/permissions/filestoragecontainer-get-columns-permissions.md b/api-reference/v1.0/includes/permissions/filestoragecontainer-get-columns-permissions.md new file mode 100644 index 00000000000..03353dba0b0 --- /dev/null +++ b/api-reference/v1.0/includes/permissions/filestoragecontainer-get-columns-permissions.md @@ -0,0 +1,12 @@ +--- +description: Automatically generated file. DO NOT MODIFY +ms.topic: include +ms.localizationpriority: medium +--- + +|Permission type|Least privileged permission|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|FileStorageContainer.Selected|Not supported.| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|FileStorageContainer.Selected|Not supported.| + From 93ba47fd60a59bc9973261b35fe05b81521828dc Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Thu, 24 Oct 2024 18:31:34 -0400 Subject: [PATCH 060/308] Create filestoragecontainer-list-columns-permissions.md Create missing permissions file in v1.0 for filestoragecontainer list columns permissions --- .../filestoragecontainer-list-columns-permissions.md | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 api-reference/v1.0/includes/permissions/filestoragecontainer-list-columns-permissions.md diff --git a/api-reference/v1.0/includes/permissions/filestoragecontainer-list-columns-permissions.md b/api-reference/v1.0/includes/permissions/filestoragecontainer-list-columns-permissions.md new file mode 100644 index 00000000000..8a0d20b128e --- /dev/null +++ b/api-reference/v1.0/includes/permissions/filestoragecontainer-list-columns-permissions.md @@ -0,0 +1,11 @@ +--- +description: Automatically generated file. DO NOT MODIFY +ms.topic: include +ms.localizationpriority: medium +--- + +|Permission type|Least privileged permission|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|FileStorageContainer.Selected|Not supported.| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|FileStorageContainer.Selected|Not supported.| From f329bf078118307a02f59aad9e81be6519b66545 Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero Date: Thu, 24 Oct 2024 16:38:25 -0600 Subject: [PATCH 061/308] Added recycledbinitem in v1. --- .../v1.0/resources/recyclebinitem.md | 64 +++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 api-reference/v1.0/resources/recyclebinitem.md diff --git a/api-reference/v1.0/resources/recyclebinitem.md b/api-reference/v1.0/resources/recyclebinitem.md new file mode 100644 index 00000000000..8256431fec9 --- /dev/null +++ b/api-reference/v1.0/resources/recyclebinitem.md @@ -0,0 +1,64 @@ +--- +author: "vanshisingh" +title: "recycleBinItem resource type" +description: "Represents information about a deleted item in a recycleBin of a SharePoint site." +ms.localizationpriority: "medium" +doc_type: resourcePageType +ms.subservice: "sharepoint" +--- + +# recycleBinItem resource type + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Represents information about a deleted item in a [recycleBin](recyclebin.md) of a SharePoint [site](site.md). + +Inherits from [baseItem](baseitem.md). + +## Methods + +| Method | Return Type | Description | +|:--------------------------------------------------------|:------------------------------------------------------------|:-----------------------------------------------------------------------------------------| +| [List](../api/recyclebin-list-items.md) | [recycleBinItem](../resources/recyclebinitem.md) collection |Get a collection of [recycleBinItem](../resources/recyclebinitem.md) resources in the [recycleBin](../resources/recyclebin.md) of the specified SharePoint [site](../resources/site.md). | + +## Properties + +| Property | Type | Description | +|:--------------------|:---------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| deletedDateTime | DateTimeOffset | Date and time when the item was deleted. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. | +| deletedFromLocation | String | Relative URL of the list or folder that originally contained the item. | +| id | String | Unique identifier of the delete transaction. Inherited from [baseItem](baseitem.md). | +| name | String | Name of the item. Inherited from [baseItem](baseitem.md). | +| size | Int64 | Size of the item in bytes. | + +## JSON Representation + +The following JSON representation shows the resource type. + + + +```json +{ + "deletedDateTime": "String (timestamp)", + "deletedFromLocation": "String", + "id": "String (identifier)", + "name": "String", + "size": "Int64" +} +``` + + From cab815383293f37090708f4deba815edab0be7a9 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Thu, 24 Oct 2024 18:39:42 -0400 Subject: [PATCH 062/308] Create filestoragecontainer-list-recyclebin-items-permissions.md Create missing permissions file in v1.0 for filestoragecontainer list recyclebin items --- ...agecontainer-list-recyclebin-items-permissions.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 api-reference/v1.0/includes/permissions/filestoragecontainer-list-recyclebin-items-permissions.md diff --git a/api-reference/v1.0/includes/permissions/filestoragecontainer-list-recyclebin-items-permissions.md b/api-reference/v1.0/includes/permissions/filestoragecontainer-list-recyclebin-items-permissions.md new file mode 100644 index 00000000000..03353dba0b0 --- /dev/null +++ b/api-reference/v1.0/includes/permissions/filestoragecontainer-list-recyclebin-items-permissions.md @@ -0,0 +1,12 @@ +--- +description: Automatically generated file. DO NOT MODIFY +ms.topic: include +ms.localizationpriority: medium +--- + +|Permission type|Least privileged permission|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|FileStorageContainer.Selected|Not supported.| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|FileStorageContainer.Selected|Not supported.| + From 734f25b89a465f92fbd4660ec31d383f30b0dfe4 Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero Date: Thu, 24 Oct 2024 18:16:36 -0600 Subject: [PATCH 063/308] Added the resource recyclebinsettings resource in v1. --- .../v1.0/resources/recyclebinsettings.md | 38 +++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 api-reference/v1.0/resources/recyclebinsettings.md diff --git a/api-reference/v1.0/resources/recyclebinsettings.md b/api-reference/v1.0/resources/recyclebinsettings.md new file mode 100644 index 00000000000..fee6e5c6a69 --- /dev/null +++ b/api-reference/v1.0/resources/recyclebinsettings.md @@ -0,0 +1,38 @@ +--- +title: "recycleBinSettings resource type" +description: "Settings for the recycle bin resource type." +author: "harmoneddie" +ms.localizationpriority: medium +ms.subservice: "sharepoint" +doc_type: resourcePageType +--- + +# recycleBinSettings resource type + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Represents settings for the [recycleBin](recyclebin.md) resource type. + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|retentionPeriodOverrideDays|Int32|Recycle bin retention period override in days for deleted content. The default value is `93`; the value range is `93` to `180`. The setting applies to newly deleted content only. Setting this property to `null` reverts to its default value. Read-write.| + +## Relationships +None. + +## JSON representation +The following JSON representation shows the resource type. + +``` json +{ + "@odata.type": "#microsoft.graph.recycleBinSettings", + "retentionPeriodOverrideDays": "int32" +} +``` From dc310a0170a66218de417946845997aff70d6fd4 Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Thu, 24 Oct 2024 18:50:57 -0600 Subject: [PATCH 064/308] Update enums.md --- api-reference/v1.0/resources/enums.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/api-reference/v1.0/resources/enums.md b/api-reference/v1.0/resources/enums.md index 8be102c0632..9af047dbf62 100644 --- a/api-reference/v1.0/resources/enums.md +++ b/api-reference/v1.0/resources/enums.md @@ -44,6 +44,13 @@ Namespace: microsoft.graph | active | | unknownfuturevalue | +### siteLockState values + +| Member | +| --------------- | +| unlocked | +| lockedReadOnly | + ### binaryOperator values | Member | From 9c9858b9703987de83a2c4d911a3ad179b3cf8da Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero Date: Thu, 24 Oct 2024 19:32:54 -0600 Subject: [PATCH 065/308] added the method missing for the recyclebin resource. --- .../v1.0/api/recyclebin-list-items.md | 127 ++++++++++++++++++ 1 file changed, 127 insertions(+) create mode 100644 api-reference/v1.0/api/recyclebin-list-items.md diff --git a/api-reference/v1.0/api/recyclebin-list-items.md b/api-reference/v1.0/api/recyclebin-list-items.md new file mode 100644 index 00000000000..fbdd67a0a41 --- /dev/null +++ b/api-reference/v1.0/api/recyclebin-list-items.md @@ -0,0 +1,127 @@ +--- +author: "vanshisingh" +title: "List items" +description: "Get a collection of recycleBinItem resources in the recycleBin of the specified SharePoint site." +ms.localizationpriority: "medium" +ms.subservice: "sharepoint" +doc_type: apiPageType +--- + +# List items + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Get a collection of [recycleBinItem](../resources/recyclebinitem.md) resources in the [recycleBin](../resources/recyclebin.md) of the specified SharePoint [site](../resources/site.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). + + +[!INCLUDE [permissions-table](../includes/permissions/recyclebin-list-items-permissions.md)] + +## HTTP request + + +``` http +GET /sites/{siteId}/recycleBin/items +``` + +## Optional query parameters + +This method supports the `$select` and `$top` OData query parameters to 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 [recycleBinItem](../resources/recyclebinitem.md) objects in the response body. + +## Examples + +### Request + +The following example shows a request to list all **recycleBinItem** resources under a specific site. + +# [HTTP](#tab/http) + +``` http +GET https://graph.microsoft.com/beta/sites/contoso.sharepoint.com,48f1898f-77d9-4a1b-bddc-1f49bb6dc134,7206fc09-e4af-48b3-8730-ed7321396d7a/recycleBin/items +``` + +# [C#](#tab/csharp) +[!INCLUDE [sample-code](../includes/snippets/csharp/list-recyclebinitems-csharp-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [CLI](#tab/cli) +[!INCLUDE [sample-code](../includes/snippets/cli/list-recyclebinitems-cli-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Go](#tab/go) +[!INCLUDE [sample-code](../includes/snippets/go/list-recyclebinitems-go-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Java](#tab/java) +[!INCLUDE [sample-code](../includes/snippets/java/list-recyclebinitems-java-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [JavaScript](#tab/javascript) +[!INCLUDE [sample-code](../includes/snippets/javascript/list-recyclebinitems-javascript-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [PHP](#tab/php) +[!INCLUDE [sample-code](../includes/snippets/php/list-recyclebinitems-php-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Python](#tab/python) +[!INCLUDE [sample-code](../includes/snippets/python/list-recyclebinitems-python-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +--- + +### Response + +The following example shows the response. + + +``` http +HTTP/1.1 200 OK +Content-Type: application/json + +{ + "value": [ + { + "id": "825e764f-c118-438f-b5c4-b8fbe60ab569", + "name": "file1.txt", + "size": 469, + "deletedDateTime": "2023-03-27T12:06:59Z", + "deletedFromLocation": "Shared Documents/folder1" + } + ] +} +``` + + From c48f11e6b0a5444e69d5fb2f88f656d9fee6ca53 Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Thu, 24 Oct 2024 20:06:38 -0600 Subject: [PATCH 066/308] Update filestoragecontainer-delete-recyclebin-items.md --- ...ilestoragecontainer-delete-recyclebin-items.md | 15 ++++----------- 1 file changed, 4 insertions(+), 11 deletions(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-delete-recyclebin-items.md b/api-reference/v1.0/api/filestoragecontainer-delete-recyclebin-items.md index 67d07c4d65c..79c2f9f5d25 100644 --- a/api-reference/v1.0/api/filestoragecontainer-delete-recyclebin-items.md +++ b/api-reference/v1.0/api/filestoragecontainer-delete-recyclebin-items.md @@ -1,13 +1,13 @@ --- -title: "Delete recycleBin items" -description: "Delete items from fileStorageContainer recycleBin." +title: "Delete recycleBinItems" +description: "Delete items from the fileStorageContainer recycleBin." author: "harmoneddie" ms.localizationpriority: medium ms.subservice: "onedrive" doc_type: apiPageType --- -# Delete recycle bin items +# Delete recycleBinItems Namespace: microsoft.graph @@ -55,7 +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/filestorage-delete-deletedcontainers-permissions.md)] + +## HTTP request + + +``` http +DELETE /storage/fileStorage/deletedContainers/{containerId} +``` + +## 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 `204 No Content` response code. + +## Examples + +### Request + +The following example shows a request. +# [HTTP](#tab/http) + +``` http +DELETE https://graph.microsoft.com/v1.0/storage/fileStorage/deletedContainers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z +``` + +# [C#](#tab/csharp) +[!INCLUDE [sample-code](../includes/snippets/csharp/remove-deleted-filestoragecontainer-csharp-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [CLI](#tab/cli) +[!INCLUDE [sample-code](../includes/snippets/cli/remove-deleted-filestoragecontainer-cli-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Go](#tab/go) +[!INCLUDE [sample-code](../includes/snippets/go/remove-deleted-filestoragecontainer-go-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Java](#tab/java) +[!INCLUDE [sample-code](../includes/snippets/java/remove-deleted-filestoragecontainer-java-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [JavaScript](#tab/javascript) +[!INCLUDE [sample-code](../includes/snippets/javascript/remove-deleted-filestoragecontainer-javascript-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [PHP](#tab/php) +[!INCLUDE [sample-code](../includes/snippets/php/remove-deleted-filestoragecontainer-php-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Python](#tab/python) +[!INCLUDE [sample-code](../includes/snippets/python/remove-deleted-filestoragecontainer-python-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +--- + + +### Response + +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 204 No Content +``` + From b4a5cee02799fc20c399f151e97311708d497054 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 28 Oct 2024 12:49:12 -0400 Subject: [PATCH 084/308] Create filestoragecontainer-post-columns.md Create missing file in v1.0 for filestoragecontainer post columns --- .../api/filestoragecontainer-post-columns.md | 162 ++++++++++++++++++ 1 file changed, 162 insertions(+) create mode 100644 api-reference/v1.0/api/filestoragecontainer-post-columns.md diff --git a/api-reference/v1.0/api/filestoragecontainer-post-columns.md b/api-reference/v1.0/api/filestoragecontainer-post-columns.md new file mode 100644 index 00000000000..02a1b1e9731 --- /dev/null +++ b/api-reference/v1.0/api/filestoragecontainer-post-columns.md @@ -0,0 +1,162 @@ +--- +title: "Create column" +description: "Create a columnDefinition in a fileStorageContainer." +author: "harmoneddie" +ms.localizationpriority: medium +ms.subservice: "onedrive" +doc_type: apiPageType +--- + +# Create column + +Namespace: microsoft.graph + +Create a column for a [fileStorageContainer](../resources/filestoragecontainer.md) that specifies a [columnDefinition](../resources/columndefinition.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). + + +[!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-post-columns-permissions.md)] + +## HTTP request + + +``` http +POST /storage/fileStorage/containers/{containerId}/columns +``` + +## 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 [columnDefinition](../resources/columndefinition.md) object. + +Only the following type-related properties are supported and they're mutually exclusive; a column can only have one of them specified at a time. + +|Property|Type|Description| +|:---|:---|:---| +|Boolean|[booleanColumn](../resources/booleancolumn.md)|This column stores Boolean values.| +|choice|[choiceColumn](../resources/choicecolumn.md)|This column stores data from a list of choices.| +|currency|[currencyColumn](../resources/currencycolumn.md)|This column stores currency values.| +|dateTime|[dateTimeColumn](../resources/datetimecolumn.md)|This column stores DateTime values.| +|hyperlinkOrPicture|[hyperlinkOrPictureColumn](../resources/hyperlinkorpicturecolumn.md)|This column stores hyperlink or picture values.| +|number|[numberColumn](../resources/numbercolumn.md)|This column stores number values.| +|personOrGroup|[personOrGroupColumn](../resources/personorgroupcolumn.md)|This column stores Person or Group values.| +|text|[textColumn](../resources/textcolumn.md)|This column stores text values.| + +## Response + +If successful, this method returns a `201 Created` response code and a [columnDefinition](../resources/columndefinition.md) object in the response body. + +## Examples + +### Request + +The following example shows a request. + +# [HTTP](#tab/http) + + +``` http +POST https://graph.microsoft.com/v1.0/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/columns +Content-Type: application/json + +{ + "description": "test", + "enforceUniqueValues": false, + "hidden": false, + "indexed": false, + "name": "Title", + "text": { + "allowMultipleLines": false, + "appendChangesToExistingText": false, + "linesForEditing": 0, + "maxLength": 255 + } +} +``` + +# [C#](#tab/csharp) +[!INCLUDE [sample-code](../includes/snippets/csharp/create-columndefinition-for-filestoragecontainer-csharp-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [CLI](#tab/cli) +[!INCLUDE [sample-code](../includes/snippets/cli/create-columndefinition-for-filestoragecontainer-cli-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Go](#tab/go) +[!INCLUDE [sample-code](../includes/snippets/go/create-columndefinition-for-filestoragecontainer-go-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Java](#tab/java) +[!INCLUDE [sample-code](../includes/snippets/java/create-columndefinition-for-filestoragecontainer-java-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [JavaScript](#tab/javascript) +[!INCLUDE [sample-code](../includes/snippets/javascript/create-columndefinition-for-filestoragecontainer-javascript-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [PHP](#tab/php) +[!INCLUDE [sample-code](../includes/snippets/php/create-columndefinition-for-filestoragecontainer-php-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Python](#tab/python) +[!INCLUDE [sample-code](../includes/snippets/python/create-columndefinition-for-filestoragecontainer-python-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +--- + +### Response + +The following example shows the response. + +>**Note:** The response object shown here might be shortened for readability. + + + +``` http +HTTP/1.1 201 Created +Content-Type: application/json + +{ + "description": "test", + "displayName": "Title", + "enforceUniqueValues": false, + "hidden": false, + "id": "99ddcf45-e2f7-4f17-82b0-6fba34445103", + "indexed": false, + "name": "Title", + "text": { + "allowMultipleLines": false, + "appendChangesToExistingText": false, + "linesForEditing": 0, + "maxLength": 255 + } +} +``` + From 3a9283df3c61d83dbbbaaf682ee862e45de09e9e Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 28 Oct 2024 12:53:17 -0400 Subject: [PATCH 085/308] Create filestoragecontainer-update-recyclebinsettings.md Create missing file in v1.0 for filestoragecontainer update recyclebin settings --- ...ragecontainer-update-recyclebinsettings.md | 84 +++++++++++++++++++ 1 file changed, 84 insertions(+) create mode 100644 api-reference/v1.0/api/filestoragecontainer-update-recyclebinsettings.md diff --git a/api-reference/v1.0/api/filestoragecontainer-update-recyclebinsettings.md b/api-reference/v1.0/api/filestoragecontainer-update-recyclebinsettings.md new file mode 100644 index 00000000000..09bb460f294 --- /dev/null +++ b/api-reference/v1.0/api/filestoragecontainer-update-recyclebinsettings.md @@ -0,0 +1,84 @@ +--- +title: "Update recycleBinSettings" +description: "Update recycleBin settings for a fileStorageContainer." +author: "harmoneddie" +ms.localizationpriority: medium +ms.subservice: "onedrive" +doc_type: apiPageType +--- + +# Update recycleBinSettings + + +Namespace: microsoft.graph + +Update the setting on the recycleBin for a [fileStorageContainer](../resources/filestoragecontainer.md) by making a PATCH request on the [recycleBinSettings](../resources/recyclebinsettings.md) resource. + +[!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). + + +[!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-update-recyclebinsettings-permissions.md)] + +## HTTP request + + +``` http +PATCH /storage/fileStorage/containers/{containerId}/recycleBin/settings +``` + +## 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 the new values for the **recycleBinSettings** properties. Existing properties that aren't included in the request body maintain their previous values. To optimize performance, don't include existing values that didn't change. + +## Response + +If successful, this method returns a `200 OK` response code. + +## Examples + +### Request +The following example shows a request. +# [HTTP](#tab/http) + +``` http +PATCH https://graph.microsoft.com/v1.0/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/recycleBin/settings +Content-Type: application/json + +{ + "retentionPeriodOverrideDays": 180 +} +``` + +# [JavaScript](#tab/javascript) +[!INCLUDE [sample-code](../includes/snippets/javascript/update-filestoragecontainer-recyclebin-settings-javascript-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +--- + +### Response +The following example shows the response. + +``` http +HTTP/1.1 200 OK +``` + From afe01e61475d2eef0aa3ba692d4ddf4cfc9313a0 Mon Sep 17 00:00:00 2001 From: Gautam Jain Date: Mon, 28 Oct 2024 16:36:03 -0700 Subject: [PATCH 086/308] Copilot limited mode documentation --- .../beta/api/copilotadminlimitedmode-get.md | 97 +++++++++++++++++ .../api/copilotadminlimitedmode-update.md | 101 ++++++++++++++++++ .../beta/resources/copilotadminlimitedmode.md | 54 ++++++++++ changelog/Microsoft.CopilotSettings.json | 22 ++++ 4 files changed, 274 insertions(+) create mode 100644 api-reference/beta/api/copilotadminlimitedmode-get.md create mode 100644 api-reference/beta/api/copilotadminlimitedmode-update.md create mode 100644 api-reference/beta/resources/copilotadminlimitedmode.md create mode 100644 changelog/Microsoft.CopilotSettings.json diff --git a/api-reference/beta/api/copilotadminlimitedmode-get.md b/api-reference/beta/api/copilotadminlimitedmode-get.md new file mode 100644 index 00000000000..b7deed54b7c --- /dev/null +++ b/api-reference/beta/api/copilotadminlimitedmode-get.md @@ -0,0 +1,97 @@ +--- +title: "Get copilotAdminLimitedMode" +description: "Read the properties and relationships of a copilotAdminLimitedMode object." +author: "**TODO: Provide GitHub Name. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" +ms.localizationpriority: medium +ms.subservice: "**TODO: Add MS subservice. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" +doc_type: apiPageType +--- + +# Get copilotAdminLimitedMode + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Read the properties and relationships of a [copilotAdminLimitedMode](../resources/copilotadminlimitedmode.md) 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). + + +Global admin or Global reader permission is required to call this API +|Permission type |Least privileged permissions|Higher privileged permissions| +| --------------- |-----------------------------| --------------------------- | +|Delegated (work or school account)|CopilotSettings-LimitedMode.Read|CopilotSettings-LimitedMode.ReadWrite| +|Delegated (personal Microsoft account)|Not supported| | +|Application|Not supported| | + + +## HTTP request + + +``` http +GET /copilot/admin/settings/limitedMode +``` +## 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 [copilotAdminLimitedMode](../resources/copilotadminlimitedmode.md) object in the response body. + +API can return additional HTTP status codes : `403 Forbidden`, `500 Internal Server Error`, or `429 Too Many Requests`. + +## Examples + +### Request + +The following example shows a request. + +``` http +GET https://graph.microsoft.com/beta/copilot/admin/settings/limitedMode +``` + + +### Response + +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 200 OK +Content-Type: application/json + +{ + "value": { + "@odata.type": "#microsoft.graph.copilotAdminLimitedMode", + "isEnabledForGroup": "Boolean", + "groupId": "String" + } +} +``` + diff --git a/api-reference/beta/api/copilotadminlimitedmode-update.md b/api-reference/beta/api/copilotadminlimitedmode-update.md new file mode 100644 index 00000000000..04e45f15b12 --- /dev/null +++ b/api-reference/beta/api/copilotadminlimitedmode-update.md @@ -0,0 +1,101 @@ +--- +title: "Update copilotAdminLimitedMode" +description: "Update the properties of a copilotAdminLimitedMode object." +author: "**TODO: Provide GitHub Name. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" +ms.localizationpriority: medium +ms.subservice: "**TODO: Add MS subservice. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" +doc_type: apiPageType +--- + +# Update copilotAdminLimitedMode + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Update the properties of a [copilotAdminLimitedMode](../resources/copilotadminlimitedmode.md) 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). + + +Global admin permission is required to call this API +|Permission type |Least privileged permissions|Higher privileged permissions| +| --------------- |-----------------------------| --------------------------- | +|Delegated (work or school account)|CopilotSettings-LimitedMode.ReadWrite| | +|Delegated (personal Microsoft account)|Not supported| | +|Application|Not supported| | + +## HTTP request + + +``` http +PATCH /copilot/admin/settings/limitedMode +``` + +## 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 + +|Property|Type|Description| +|:---|:---|:---| +|isEnabledForGroup|Boolean|Indicates the state of copilot limited mode. When true, copilotLimitedMode is enabled and Copilot will not respond to sentiment-related prompts and questions asked by the user. When false, copilotLimitedMode is disabled and Copilot will respond to sentiment-related prompts and questions asked by the user. Default value is false.| +|groupId|String|The ID of a Microsoft Entra group, of which the value of isEnabledForGroup is applied value for its members. The default value is null. This parameter is optional. If isEnabledForGroup is set to true, groupId value must be provided and copilot limited mode is enabled to the members of the group| + + + +## Response + +If successful, this method returns a `200 OK` response code and an updated [copilotAdminLimitedMode](../resources/copilotadminlimitedmode.md) object in the response body. + +API can return additional HTTP status codes : `403 Forbidden`, `500 Internal Server Error`, or `429 Too Many Requests`. + +## Examples + +### Request + +The following example shows a request. + +``` http +PATCH https://graph.microsoft.com/beta/copilot/admin/settings/limitedMode +Content-Type: application/json + +{ + "@odata.type": "#microsoft.graph.copilotAdminLimitedMode", + "isEnabledForGroup": "Boolean", + "groupId": "String" +} +``` + + +### Response + +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 200 OK +Content-Type: application/json +``` + diff --git a/api-reference/beta/resources/copilotadminlimitedmode.md b/api-reference/beta/resources/copilotadminlimitedmode.md new file mode 100644 index 00000000000..b5945c01702 --- /dev/null +++ b/api-reference/beta/resources/copilotadminlimitedmode.md @@ -0,0 +1,54 @@ +--- +title: "copilotAdminLimitedMode resource type" +description: "**TODO: Add Description**" +author: "**TODO: Provide GitHub Name. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" +ms.localizationpriority: medium +ms.subservice: "**TODO: Add MS subservice. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" +doc_type: resourcePageType +--- + +# copilotAdminLimitedMode resource type + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +**TODO: Add Description** + + +Inherits from [entity](../resources/entity.md). + + +## Methods +|Method|Return type|Description| +|:---|:---|:---| +|[Get](../api/copilotadminlimitedmode-get.md)|[copilotAdminLimitedMode](../resources/copilotadminlimitedmode.md)|Read the properties and relationships of a [copilotAdminLimitedMode](../resources/copilotadminlimitedmode.md) object.| +|[Update](../api/copilotadminlimitedmode-update.md)|[copilotAdminLimitedMode](../resources/copilotadminlimitedmode.md)|Update the properties of a [copilotAdminLimitedMode](../resources/copilotadminlimitedmode.md) object.| + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|isEnabledForGroup|Boolean|Indicates the state of copilot limited mode. When true, copilotLimitedMode is enabled and Copilot will not respond to sentiment-related prompts and questions asked by the user. When false, copilotLimitedMode is disabled and Copilot will respond to sentiment-related prompts and questions asked by the user. Default value is false.| +|groupId|String|The ID of a Microsoft Entra group, of which the value of isEnabledForGroup is applied value for its members. The default value is null. This parameter is optional. If isEnabledForGroup is set to true, groupId value must be provided and copilot limited mode is enabled to the members of the group| + +## Relationships +None. + +## JSON representation +The following JSON representation shows the resource type. + +``` json +{ + "@odata.type": "#microsoft.graph.copilotAdminLimitedMode", + "isEnabledForGroup": "Boolean", + "groupId": "String" +} +``` + diff --git a/changelog/Microsoft.CopilotSettings.json b/changelog/Microsoft.CopilotSettings.json new file mode 100644 index 00000000000..190f719d98e --- /dev/null +++ b/changelog/Microsoft.CopilotSettings.json @@ -0,0 +1,22 @@ +{ + "changelog": [ + { + "ChangeList": [ + { + "Id": "23e6f05c-f98d-49a4-8df2-b63a6491c249", + "ApiChange": "Resource", + "ChangedApiName": "copilotAdminLimitedMode", + "ChangeType": "Addition", + "Description": "Added the [copilotAdminLimitedMode](https://learn.microsoft.com/en-us/graph/api/resources/copilotAdminLimitedMode?view=graph-rest-beta) resource.", + "Target": "copilotAdminLimitedMode" + } + ], + "Id": "23e6f05c-f98d-49a4-8df2-b63a6491c249", + "Cloud": "Prod", + "Version": "beta", + "CreatedDateTime": "2024-10-22T19:12:08.7280528Z", + "WorkloadArea": "Microsoft.CopilotSettings", + "SubArea": "" + } + ] +} \ No newline at end of file From 63f7017ec119ffde1eefa6dbed95e462f5ac6e8b Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Tue, 29 Oct 2024 08:43:01 -0600 Subject: [PATCH 087/308] Update filestorage-delete-deletedcontainers.md --- .../filestorage-delete-deletedcontainers.md | 32 +------------------ 1 file changed, 1 insertion(+), 31 deletions(-) diff --git a/api-reference/v1.0/api/filestorage-delete-deletedcontainers.md b/api-reference/v1.0/api/filestorage-delete-deletedcontainers.md index 022c00586b1..d654d42a24d 100644 --- a/api-reference/v1.0/api/filestorage-delete-deletedcontainers.md +++ b/api-reference/v1.0/api/filestorage-delete-deletedcontainers.md @@ -53,7 +53,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/filestoragecontainer-activate-permissions.md)] diff --git a/api-reference/v1.0/includes/rbac-for-apis/rbac-directory-role-apis-read.md b/api-reference/v1.0/includes/rbac-for-apis/rbac-directory-role-apis-read.md index 8468daff344..4eb61ec6911 100644 --- a/api-reference/v1.0/includes/rbac-for-apis/rbac-directory-role-apis-read.md +++ b/api-reference/v1.0/includes/rbac-for-apis/rbac-directory-role-apis-read.md @@ -1,44 +1,44 @@ ---- -author: DougKirschner -ms.reviewer: msodsrbac -ms.topic: include ---- - -> [!IMPORTANT] -> In delegated scenarios with work or school accounts, the signed-in user must be assigned a supported [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) or a custom role with a supported role permission. The following least privileged roles are supported for this operation. -> - User Administrator -> - Helpdesk Administrator -> - Service Support Administrator -> - Billing Administrator -> - User -> - Mailbox Administrator -> - Directory Readers -> - Directory Writers -> - Application Administrator -> - Security Reader -> - Security Administrator -> - Privileged Role Administrator -> - Cloud Application Administrator -> - Customer LockBox Access Approver -> - Dynamics 365 Administrator -> - Power BI Administrator -> - Azure Information Protection Administrator -> - Desktop Analytics Administrator -> - License Administrator -> - Microsoft Managed Desktop Administrator -> - Authentication Administrator -> - Privileged Authentication Administrator -> - Teams Communications Administrator -> - Teams Communications Support Engineer -> - Teams Communications Support Specialist -> - Teams Administrator -> - Insights Administrator -> - Compliance Data Administrator -> - Security Operator -> - Kaizala Administrator -> - Global Reader -> - Volume Licensing Business Center User -> - Volume Licensing Service Center User -> - Modern Commerce Administrator -> - Microsoft Store for Business User +--- +author: DougKirschner +ms.reviewer: msodsrbac +ms.topic: include +--- + +> [!IMPORTANT] +> In delegated scenarios with work or school accounts, the signed-in user must be assigned a supported [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) or a custom role with a supported role permission. The following least privileged roles are supported for this operation. +> - User Administrator +> - Helpdesk Administrator +> - Service Support Administrator +> - Billing Administrator +> - User +> - Mailbox Administrator +> - Directory Readers +> - Directory Writers +> - Application Administrator +> - Security Reader +> - Security Administrator +> - Privileged Role Administrator +> - Cloud Application Administrator +> - Customer LockBox Access Approver +> - Dynamics 365 Administrator +> - Power BI Administrator +> - Azure Information Protection Administrator +> - Desktop Analytics Administrator +> - License Administrator +> - Microsoft Managed Desktop Administrator +> - Authentication Administrator +> - Privileged Authentication Administrator +> - Teams Communications Administrator +> - Teams Communications Support Engineer +> - Teams Communications Support Specialist +> - Teams Administrator +> - Insights Administrator +> - Compliance Data Administrator +> - Security Operator +> - Kaizala Administrator +> - Global Reader +> - Volume Licensing Business Center User +> - Volume Licensing Service Center User +> - Modern Commerce Administrator +> - Microsoft Store for Business User > - Directory Reviewer \ No newline at end of file diff --git a/api-reference/v1.0/includes/rbac-for-apis/rbac-directory-role-apis-write.md b/api-reference/v1.0/includes/rbac-for-apis/rbac-directory-role-apis-write.md index a5896618c42..24a2fe6a0e5 100644 --- a/api-reference/v1.0/includes/rbac-for-apis/rbac-directory-role-apis-write.md +++ b/api-reference/v1.0/includes/rbac-for-apis/rbac-directory-role-apis-write.md @@ -1,8 +1,8 @@ ---- -author: DougKirschner -ms.reviewer: msodsrbac -ms.topic: include ---- - -> [!IMPORTANT] -> In delegated scenarios with work or school accounts, the signed-in user must be assigned a supported [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) or a custom role with a supported role permission. *Privileged Role Administrator* is the least privileged role supported for this operation. +--- +author: DougKirschner +ms.reviewer: msodsrbac +ms.topic: include +--- + +> [!IMPORTANT] +> In delegated scenarios with work or school accounts, the signed-in user must be assigned a supported [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) or a custom role with a supported role permission. *Privileged Role Administrator* is the least privileged role supported for this operation. From fb45843f1ea93ecbc069a9abfc8e7c7d84392651 Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Tue, 29 Oct 2024 08:45:42 -0600 Subject: [PATCH 090/308] Update filestoragecontainer-update-recyclebinsettings.md --- .../api/filestoragecontainer-update-recyclebinsettings.md | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-update-recyclebinsettings.md b/api-reference/v1.0/api/filestoragecontainer-update-recyclebinsettings.md index 09bb460f294..15cff764957 100644 --- a/api-reference/v1.0/api/filestoragecontainer-update-recyclebinsettings.md +++ b/api-reference/v1.0/api/filestoragecontainer-update-recyclebinsettings.md @@ -50,7 +50,7 @@ If successful, this method returns a `200 OK` response code. ### Request The following example shows a request. -# [HTTP](#tab/http) + + [!INCLUDE [permissions-table](../includes/permissions/filestorage-delete-containers-permissions.md)] [!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] From 97013059a27d7c3bacbd7db276a3a05480d631d2 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Tue, 29 Oct 2024 10:02:55 -0500 Subject: [PATCH 092/308] Update filestorage-delete-containers.md Update author to reflect change --- api-reference/v1.0/api/filestorage-delete-containers.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestorage-delete-containers.md b/api-reference/v1.0/api/filestorage-delete-containers.md index fbcb8220496..63ca2c4aa59 100644 --- a/api-reference/v1.0/api/filestorage-delete-containers.md +++ b/api-reference/v1.0/api/filestorage-delete-containers.md @@ -1,7 +1,7 @@ --- title: "Delete fileStorageContainer" description: "Delete a fileStorageContainer object." -author: "tonchan-msft" +author: "harmoneddie" ms.localizationpriority: medium ms.subservice: "onedrive" doc_type: apiPageType From b385cbfc354de36297ccd316343958b36b3ef9ad Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Tue, 29 Oct 2024 10:23:01 -0500 Subject: [PATCH 093/308] Update filestoragecontainer-get.md Added note on line 93 --- api-reference/v1.0/api/filestoragecontainer-get.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/api-reference/v1.0/api/filestoragecontainer-get.md b/api-reference/v1.0/api/filestoragecontainer-get.md index 187bb6a4749..015d21ef840 100644 --- a/api-reference/v1.0/api/filestoragecontainer-get.md +++ b/api-reference/v1.0/api/filestoragecontainer-get.md @@ -90,6 +90,8 @@ GET https://graph.microsoft.com/v1.0/storage/fileStorage/containers/b!ISJs1WRro0 ### Response The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. + -```http -HTTP/1.1 200 OK -Content-type: application/json - { "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#policies/appManagementPolicies/$entity", "id": "a4ab1ed9-46bb-4bef-88d4-86fd6398dd5d", @@ -176,15 +182,40 @@ Content-type: application/json "passwordCredentials": [ { "restrictionType": "passwordAddition", + "state": "enabled", "maxLifetime": null, "restrictForAppsCreatedAfterDateTime": "2019-10-19T10:37:00Z" }, { "restrictionType": "passwordLifetime", - "maxLifetime": "P4DT12H30M5S", + "state": "enabled", + "maxLifetime": "P90D", "restrictForAppsCreatedAfterDateTime": "2018-10-19T10:37:00Z" + }, + { + "restrictionType": "symmetricKeyAddition", + "state": "enabled", + "maxLifetime": null, + "restrictForAppsCreatedAfterDateTime": "2019-10-19T10:37:00Z" + }, + { + "restrictionType": "symmetricKeyLifetime", + "state": "enabled", + "maxLifetime": "P90D", + "restrictForAppsCreatedAfterDateTime": "2014-10-19T10:37:00Z" + } + ], + "keyCredentials": [], + "applicationRestrictions": { + "identifierUris": { + "nonDefaultUriAddition": { + "state": "disabled", + "restrictForAppsCreatedAfterDateTime": null, + "excludeAppsReceivingV2Tokens": true, + "excludeSaml": true + } } - ] + } } } ``` diff --git a/api-reference/v1.0/resources/applicationauthenticationmethodpolicy.md b/api-reference/v1.0/resources/applicationauthenticationmethodpolicy.md index d7e892cc920..bbd620d3f96 100644 --- a/api-reference/v1.0/resources/applicationauthenticationmethodpolicy.md +++ b/api-reference/v1.0/resources/applicationauthenticationmethodpolicy.md @@ -1,59 +1,61 @@ --- -title: "Microsoft Entra application authentication methods API overview" -description: "Application authentication methods allow apps to acquire tokens to access data in Azure AD." +title: "Microsoft Entra application management policy API overview" +description: "Application management policies allow administrators to set rules on how Entra apps in their tenant can be configured." ms.localizationpriority: medium author: "madansr7" ms.subservice: "entra-sign-in" doc_type: "conceptualPageType" --- -# Microsoft Entra application authentication methods API overview +# Microsoft Entra application management policies API overview Namespace: microsoft.graph -Application authentication methods such as certificates and password secrets allow apps to acquire tokens to access data in Microsoft Entra ID. The policies allow IT admins to enforce best practices for how apps in their organizations use these application authentication methods. For example, an admin might configure a policy to block the use or limit the lifetime of password secrets, and use the creation date of the object to enforce the policy. +Application management policies allow IT admins to enforce best practices for how apps in their organizations should be configured. For example, an admin might configure a policy to block the use or limit the lifetime of password secrets, and use the creation date of the object to enforce the policy. These policies allow organizations to take advantage of the new app security hardening features. By enforcing restrictions that are based on the application or service principal created date, an organization can review their current app security posture, inventory apps, and enforce controls per their resourcing schedules and needs. This approach using the created date allows the organization to enforce the policy for new applications and also apply it to existing applications. There are two types of policy controls: - Tenant default policy that applies to all applications or service principals. -- App (application or service principal) management policies that allow inclusion or exclusion of individual applications from the tenant default policy. +- App (application or service principal) management policies that allow individual applications to be included or excluded from the tenant default policy. ## Tenant default app management policy A tenant default policy is a single object that always exists and is disabled by default. It's defined by the [tenantAppManagementPolicy](tenantappmanagementpolicy.md) resource and enforces restrictions on application vs service principal objects. It contains the following two properties: - **applicationRestrictions** allows targeting applications owned by the tenant (application objects). -- **servicePrincipalRestrictions** allows targeting provisioned from another tenant (service principal objects. +- **servicePrincipalRestrictions** allows targeting provisioned from another tenant (service principal objects). + +These properties enable an organization to separately control the configuration of apps that originate from their tenant vs. their tenant's instance of an externally owned application. -These properties enable an organization to lock down credential usage in apps that originate from their tenant and provide a mechanism to control credential addition in externally provisioned applications to protect them from credential abuse. The application owner of a multi-tenant app could still use any type of credentials in their application object, but the policy only protects the service principal from credential abuse. ## App management policy for applications and service principals -App management policies are defined in the [appManagementPolicy](appmanagementpolicy.md) resource, which contains a collection of policies with varying restrictions or different enforcement dates from what's defined in tenant default policy. One of these policies can be assigned to an application or service principal, excluding them from the tenant default policy. +App management policies are defined in the [appManagementPolicy](appmanagementpolicy.md) resource, which contains a collection of policies with varying restrictions or different enforcement dates from what's defined in tenant default policy. One of these policies can be assigned to an application or service principal to override the tenant default policy. -When both the tenant default policy and an app management policy exist, the app management policy takes precedence and the assigned application or service principal doesn't inherit from the tenant default policy. Only one policy can be assigned to an application or service principal. +When the tenant default policy and an app management policy both define the same restriction, the app management policy takes precedence. If a restriction is set on an app management policy in a `disabled` state, that restriction won't apply to apps with that policy linked to them, regardless of what the tenant default policy would normally enforce. Similarly, if a restriction is set on an app management policy in an `enabled` state, that restriction will apply to apps with that policy linked to them. However, if the app management policy doesn't define any behavior for a certain restriction, it will fall back to the tenant default policy's behavior. Only one app management policy can be assigned to an application or service principal. > [!Note] -> Neither the tenant default policies nor the app management policies block token issuance for existing applications. An application that does not meet the policy requirements will continue to work until it tries to update the resource to add a new secret. +> Neither the tenant default policies nor the app management policies block token issuance for existing applications. An application that does not meet the policy requirements will continue to work; only the app creation/update operation that violates the policy will be blocked. ## What restrictions can be managed in Microsoft Graph? The application authentication methods policy API offers the following restrictions: -| Restriction name | Description | Examples | -| :--------------------- | :--------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------- | -| passwordAddition | Restrict password secrets on applications altogether. | Block new passwords on applications created on or after '01/01/2019'. | -| passwordLifetime | Enforce a max lifetime range for a password secret. | Restrict all new password secrets to a maximum of 30 days for applications created after 01/01/2015. | -| customPasswordAddition | Restrict a custom password secret on application or service principal. | Restrict all new custom password secrets on applications created after 01/01/2015. | -| symmetricKeyAddition | Restrict symmetric keys on applications. | Block new symmetric keys on applications created on or after 01/01/2019. | -| symmetricKeyLifetime | Enforce a max lifetime range for a symmetric key. | Restrict all new symmetric keys to a maximum of 30 days for applications created after 01/01/2019. | -| asymmetricKeyLifetime | Enforce a max lifetime range for an asymmetric key (certificate). | Restrict all new asymmetric key credentials to a maximum of 30 days for applications created after 01/01/2019. | +| Restriction name | Description | Examples | +| :--------------------- | :--------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------- | +| passwordAddition | Restrict password secrets on applications altogether. | Block new passwords on applications created on or after '01/01/2019'. | +| passwordLifetime | Enforce a max lifetime range for a password secret. | Restrict all new password secrets to a maximum of 30 days for applications created after 01/01/2015. | +| customPasswordAddition | Restrict a custom password secret on application or service principal. | Restrict all new custom (non-Azure AD generated) password secrets on applications created after 01/01/2015. | +| symmetricKeyAddition | Restrict symmetric keys on applications. | Block new symmetric keys on applications created on or after 01/01/2019. | +| symmetricKeyLifetime | Enforce a max lifetime range for a symmetric key. | Restrict all new symmetric keys to a maximum of 30 days for applications created after 01/01/2019. | +| asymmetricKeyLifetime | Enforce a max lifetime range for an asymmetric key (certificate). | Restrict all new asymmetric key credentials to a maximum of 30 days for applications created after 01/01/2019. | > [!Note] > All lifetime restrictions are expressed in ISO-8601 duration format (For example: P4DT12H30M5S). -> Restricting customPasswordAddition restriction will block any legacy PowerShell modules that provide a client generated password secret for applications. This restriction still allows the application developer to request Microsoft Entra ID-generated application password secrets. - +> +> Applying the **customPasswordAddition** restriction will block any legacy PowerShell modules that add a client-generated password secret to applications or service principals. This restriction does not block Microsoft Entra ID-generated application or service principal password secrets. + ### Single vs multi-tenant apps Depending on whether your app is a single tenant or multitenant app, you apply the policy on either an application or the service principal object as follows: @@ -67,17 +69,15 @@ Depending on whether your app is a single tenant or multitenant app, you apply t | Tenant default policy | App management policy | | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | Policy always exists. | Policy objects can be created or updated to override default policy. | -| Restrictions are disabled by default for app/SP. | Allows customization for single tenant or multi tenant(backing app in home tenant or provisioned apps). | | Allows only single restriction object definition for all resources. | Allows multiple policy objects to be defined, but only one can be applied to a resource. | | Allows distinction of restrictions for application objects vs. service principals. | Policy can be applied to either an application or service principal object. | -| Applies all restrictions configured to all apps or service principals. | Applies only the restrictions configured in the resource policy to the specified app or service principal, and doesn't inherit from default policy. | +| Applies all restrictions configured to all apps or service principals. | Applies the restrictions configured in the resource policy to the specified app or service principal. Anything not defined will inherit from default policy. | ## Requirements -- The least privileged Microsoft Entra roles for the management of application authentication method policies are Application Administrator and Cloud Application Administrator. -- All app policy management operations require a [Microsoft Entra Workload ID Premium license](/azure/active-directory/workload-identities/workload-identities-faqs#what-is-the-cost-of-workload-identities-premium-plan). +- The least privileged [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) for management of application authentication method policies are Application Administrator and Cloud Application Administrator. ## Next steps - [tenantAppManagementPolicy](tenantappmanagementpolicy.md) resource type. -- [appManagementPolicy](appmanagementpolicy.md) resource type. +- [appManagementPolicy](appmanagementpolicy.md) resource type. \ No newline at end of file From 27c8d4d87ca727bc67c3a0fd8d88c85498aa7d9a Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Tue, 29 Oct 2024 12:30:22 -0500 Subject: [PATCH 098/308] Update filestoragecontainer-permanentdelete.md Update line 60 (Http) and line 37 post path --- api-reference/v1.0/api/filestoragecontainer-permanentdelete.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-permanentdelete.md b/api-reference/v1.0/api/filestoragecontainer-permanentdelete.md index 1fe60c124ad..908f4641eaf 100644 --- a/api-reference/v1.0/api/filestoragecontainer-permanentdelete.md +++ b/api-reference/v1.0/api/filestoragecontainer-permanentdelete.md @@ -34,7 +34,7 @@ Choose the permission or permissions marked as least privileged for this API. Us } --> ``` http -POST /storageContainers/{containerId}/permanentDelete +POST /storage/fileStorage/containers/{containerId}/permanentDelete ``` ## Request headers @@ -57,6 +57,7 @@ If successful, this action returns a `204 No Content` response code. The following example shows a request. +# [HTTP](#tab/http) [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-update-permissions.md)] - ## HTTP request +``` json +{ + "@odata.type": "#microsoft.graph.copilotAdmin" +} +``` + diff --git a/api-reference/beta/resources/copilotadminlimitedmode.md b/api-reference/beta/resources/copilotadminlimitedmode.md index 06163ff52b1..6177ee73ec2 100644 --- a/api-reference/beta/resources/copilotadminlimitedmode.md +++ b/api-reference/beta/resources/copilotadminlimitedmode.md @@ -13,7 +13,7 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -**TODO: Add Description** +LimitedMode copilot setting value controls whether Microsoft 365 Copilot users can receive responses to sentiment-related prompts. If this setting enabled, Copilot will not respond to sentiment-related prompts and questions asked by the user. If setting is disabled, Copilot will respond to sentiment-related prompts and questions asked by the user. In intial version this settings will be honored by Teams Copilot and eventually all M365 Copilots will be honoring this setting. Default value is disabled. Inherits from [entity](../resources/entity.md). diff --git a/api-reference/beta/resources/copilotadminsetting.md b/api-reference/beta/resources/copilotadminsetting.md new file mode 100644 index 00000000000..d94726ba56a --- /dev/null +++ b/api-reference/beta/resources/copilotadminsetting.md @@ -0,0 +1,41 @@ +--- +title: "copilotAdminSetting resource type" +description: "**TODO: Add Description**" +author: "**TODO: Provide GitHub Name. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" +ms.localizationpriority: medium +ms.subservice: "**TODO: Add MS subservice. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" +doc_type: resourcePageType +--- + +# copilotAdminSetting resource type + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Navigation property for `settings` + + +Inherits from [entity](../resources/entity.md). + +## Relationships +|Relationship|Type|Description| +|:---|:---|:---| +|limitedMode|[copilotAdminLimitedMode](../resources/copilotadminlimitedmode.md)|Navigation property for `limitedMode`| + +## JSON representation +The following JSON representation shows the resource type. + +``` json +{ + "@odata.type": "#microsoft.graph.copilotAdminSetting" +} +``` + diff --git a/api-reference/beta/resources/copilotroot.md b/api-reference/beta/resources/copilotroot.md new file mode 100644 index 00000000000..e0c8385f98a --- /dev/null +++ b/api-reference/beta/resources/copilotroot.md @@ -0,0 +1,37 @@ +--- +title: "copilotRoot resource type" +description: "**TODO: Add Description**" +author: "**TODO: Provide GitHub Name. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" +ms.localizationpriority: medium +ms.subservice: "**TODO: Add MS subservice. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" +doc_type: resourcePageType +--- + +# copilotRoot resource type + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Navigation property for `copilotRoot` + +## Relationships +|Relationship|Type|Description| +|:---|:---|:---| +|admin|[copilotAdmin](../resources/copilotadmin.md)|Navigation property for `copilotAdmin`| + +## JSON representation +The following JSON representation shows the resource type. + +``` json +{ + "@odata.type": "#microsoft.graph.copilotRoot" +} +``` + From 85a5b4168fe42c61480575ba1443f05d43c97837 Mon Sep 17 00:00:00 2001 From: Ari Crowe Date: Tue, 29 Oct 2024 15:59:49 -0700 Subject: [PATCH 113/308] Addressing bulid issue --- api-reference/v1.0/api/appmanagementpolicy-post.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/api-reference/v1.0/api/appmanagementpolicy-post.md b/api-reference/v1.0/api/appmanagementpolicy-post.md index c352dafc4d9..1ee805ce003 100644 --- a/api-reference/v1.0/api/appmanagementpolicy-post.md +++ b/api-reference/v1.0/api/appmanagementpolicy-post.md @@ -172,6 +172,9 @@ The following example shows the response. "@odata.type": "microsoft.graph.appManagementPolicy" } --> +```http +HTTP/1.1 200 OK +Content-type: application/json { "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#policies/appManagementPolicies/$entity", "id": "a4ab1ed9-46bb-4bef-88d4-86fd6398dd5d", From 584eec9046c6a1fd37fd4635c8730a82a9c280f2 Mon Sep 17 00:00:00 2001 From: Gautam Jain Date: Tue, 29 Oct 2024 20:12:28 -0700 Subject: [PATCH 114/308] change logs update --- changelog/Microsoft.CopilotSettings.json | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/changelog/Microsoft.CopilotSettings.json b/changelog/Microsoft.CopilotSettings.json index 190f719d98e..d2101d4834d 100644 --- a/changelog/Microsoft.CopilotSettings.json +++ b/changelog/Microsoft.CopilotSettings.json @@ -2,6 +2,14 @@ "changelog": [ { "ChangeList": [ + { + "Id": "23e6f05c-f98d-49a4-8df2-b63a6491c249", + "ApiChange": "Resource", + "ChangedApiName": "copilotAdmin", + "ChangeType": "Addition", + "Description": "Added the [copilotAdmin](https://learn.microsoft.com/en-us/graph/api/resources/copilotAdmin?view=graph-rest-beta) resource.", + "Target": "copilotAdmin" + }, { "Id": "23e6f05c-f98d-49a4-8df2-b63a6491c249", "ApiChange": "Resource", @@ -9,6 +17,22 @@ "ChangeType": "Addition", "Description": "Added the [copilotAdminLimitedMode](https://learn.microsoft.com/en-us/graph/api/resources/copilotAdminLimitedMode?view=graph-rest-beta) resource.", "Target": "copilotAdminLimitedMode" + }, + { + "Id": "23e6f05c-f98d-49a4-8df2-b63a6491c249", + "ApiChange": "Resource", + "ChangedApiName": "copilotAdminSetting", + "ChangeType": "Addition", + "Description": "Added the [copilotAdminSetting](https://learn.microsoft.com/en-us/graph/api/resources/copilotAdminSetting?view=graph-rest-beta) resource.", + "Target": "copilotAdminSetting" + }, + { + "Id": "23e6f05c-f98d-49a4-8df2-b63a6491c249", + "ApiChange": "Resource", + "ChangedApiName": "copilotRoot", + "ChangeType": "Addition", + "Description": "Added the [copilotRoot](https://learn.microsoft.com/en-us/graph/api/resources/copilotRoot?view=graph-rest-beta) resource.", + "Target": "copilotRoot" } ], "Id": "23e6f05c-f98d-49a4-8df2-b63a6491c249", From 2f00a4109472d5753962d2028cdd08903f64ab87 Mon Sep 17 00:00:00 2001 From: Tony Chan <107155297+tonchan-msft@users.noreply.github.com> Date: Tue, 29 Oct 2024 21:15:55 -0700 Subject: [PATCH 115/308] Update filestoragecontainer-get.md --- api-reference/beta/api/filestoragecontainer-get.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/api-reference/beta/api/filestoragecontainer-get.md b/api-reference/beta/api/filestoragecontainer-get.md index a716ff77e80..c1e21f95ed7 100644 --- a/api-reference/beta/api/filestoragecontainer-get.md +++ b/api-reference/beta/api/filestoragecontainer-get.md @@ -110,7 +110,9 @@ Content-Type: application/json "status": "active", "createdDateTime": "2021-11-24T15:41:52.347Z", "settings": { - "isOcrEnabled": false + "isOcrEnabled": false, + "itemMajorVersionLimit": 50, + "isItemVersioningEnabled": true } } ``` From cddb881e15d5f5a191c3b1fea35fa57fe1392058 Mon Sep 17 00:00:00 2001 From: Tony Chan <107155297+tonchan-msft@users.noreply.github.com> Date: Tue, 29 Oct 2024 21:16:42 -0700 Subject: [PATCH 116/308] Update filestoragecontainer-get.md --- api-reference/v1.0/api/filestoragecontainer-get.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-get.md b/api-reference/v1.0/api/filestoragecontainer-get.md index 015d21ef840..babb979ad00 100644 --- a/api-reference/v1.0/api/filestoragecontainer-get.md +++ b/api-reference/v1.0/api/filestoragecontainer-get.md @@ -111,7 +111,9 @@ Content-Type: application/json "status": "active", "createdDateTime": "2021-11-24T15:41:52.347Z", "settings": { - "isOcrEnabled": false + "isOcrEnabled": false, + "itemMajorVersionLimit": 50, + "isItemVersioningEnabled": true } } ``` From c3fdae78520e2fe7d21efa5d53f764bb4c0d8152 Mon Sep 17 00:00:00 2001 From: Tony Chan <107155297+tonchan-msft@users.noreply.github.com> Date: Tue, 29 Oct 2024 21:17:30 -0700 Subject: [PATCH 117/308] Update filestoragecontainer-post.md --- api-reference/beta/api/filestoragecontainer-post.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/api-reference/beta/api/filestoragecontainer-post.md b/api-reference/beta/api/filestoragecontainer-post.md index 2c556d127d3..7ef1939502c 100644 --- a/api-reference/beta/api/filestoragecontainer-post.md +++ b/api-reference/beta/api/filestoragecontainer-post.md @@ -136,7 +136,9 @@ Content-type: application/json "status": "inactive", "createdDateTime": "2021-11-24T15:41:52.347Z", "settings": { - "isOcrEnabled": true + "isOcrEnabled": false, + "itemMajorVersionLimit": 50, + "isItemVersioningEnabled": true } } From c8d3acba661cccd47500da710c35aabb153f02d8 Mon Sep 17 00:00:00 2001 From: Tony Chan <107155297+tonchan-msft@users.noreply.github.com> Date: Tue, 29 Oct 2024 21:18:03 -0700 Subject: [PATCH 118/308] Update filestoragecontainer-post.md --- api-reference/v1.0/api/filestoragecontainer-post.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-post.md b/api-reference/v1.0/api/filestoragecontainer-post.md index 88bb0a56f98..e3ee17d4cd1 100644 --- a/api-reference/v1.0/api/filestoragecontainer-post.md +++ b/api-reference/v1.0/api/filestoragecontainer-post.md @@ -136,7 +136,9 @@ Content-type: application/json "status": "inactive", "createdDateTime": "2021-11-24T15:41:52.347Z", "settings": { - "isOcrEnabled": true + "isOcrEnabled": false, + "itemMajorVersionLimit": 50, + "isItemVersioningEnabled": true } } From 8b1639370cfb3b5678aa2297eb3edce4288d9b22 Mon Sep 17 00:00:00 2001 From: Tony Chan <107155297+tonchan-msft@users.noreply.github.com> Date: Tue, 29 Oct 2024 21:24:06 -0700 Subject: [PATCH 119/308] Update filestoragecontainer-update.md --- api-reference/beta/api/filestoragecontainer-update.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/api-reference/beta/api/filestoragecontainer-update.md b/api-reference/beta/api/filestoragecontainer-update.md index 0b6dda82527..4002e666389 100644 --- a/api-reference/beta/api/filestoragecontainer-update.md +++ b/api-reference/beta/api/filestoragecontainer-update.md @@ -122,7 +122,9 @@ Content-type: application/json "status": "active", "createdDateTime": "2021-11-24T15:41:52.347Z", "settings": { - "isOcrEnabled": false + "isOcrEnabled": false, + "itemMajorVersionLimit": 50, + "isItemVersioningEnabled": true } } ``` From 954eb323a915b116215263ec5b6978f8c68d7886 Mon Sep 17 00:00:00 2001 From: Tony Chan <107155297+tonchan-msft@users.noreply.github.com> Date: Tue, 29 Oct 2024 21:24:36 -0700 Subject: [PATCH 120/308] Update filestoragecontainer-update.md --- api-reference/v1.0/api/filestoragecontainer-update.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-update.md b/api-reference/v1.0/api/filestoragecontainer-update.md index 661ef740e4c..212da5e4aaf 100644 --- a/api-reference/v1.0/api/filestoragecontainer-update.md +++ b/api-reference/v1.0/api/filestoragecontainer-update.md @@ -123,7 +123,9 @@ Content-type: application/json "status": "active", "createdDateTime": "2021-11-24T15:41:52.347Z", "settings": { - "isOcrEnabled": false + "isOcrEnabled": false, + "itemMajorVersionLimit": 50, + "isItemVersioningEnabled": true } } ``` From 80059ace171409396cc48b7cf1aa04f051947a01 Mon Sep 17 00:00:00 2001 From: Gautam Jain Date: Wed, 30 Oct 2024 15:52:34 -0700 Subject: [PATCH 121/308] added author and subservice --- api-reference/beta/api/copilotadminlimitedmode-get.md | 4 ++-- api-reference/beta/api/copilotadminlimitedmode-update.md | 4 ++-- api-reference/beta/resources/copilotadmin.md | 6 +++--- api-reference/beta/resources/copilotadminlimitedmode.md | 6 +++--- api-reference/beta/resources/copilotadminsetting.md | 8 ++++---- api-reference/beta/resources/copilotroot.md | 2 +- 6 files changed, 15 insertions(+), 15 deletions(-) diff --git a/api-reference/beta/api/copilotadminlimitedmode-get.md b/api-reference/beta/api/copilotadminlimitedmode-get.md index b7deed54b7c..cacd1c1df16 100644 --- a/api-reference/beta/api/copilotadminlimitedmode-get.md +++ b/api-reference/beta/api/copilotadminlimitedmode-get.md @@ -1,9 +1,9 @@ --- title: "Get copilotAdminLimitedMode" description: "Read the properties and relationships of a copilotAdminLimitedMode object." -author: "**TODO: Provide GitHub Name. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" +author: "gautamjain14" ms.localizationpriority: medium -ms.subservice: "**TODO: Add MS subservice. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" +ms.subservice: "meetings-copilot" doc_type: apiPageType --- diff --git a/api-reference/beta/api/copilotadminlimitedmode-update.md b/api-reference/beta/api/copilotadminlimitedmode-update.md index 4937a0a7ef7..ce2582fa2da 100644 --- a/api-reference/beta/api/copilotadminlimitedmode-update.md +++ b/api-reference/beta/api/copilotadminlimitedmode-update.md @@ -1,9 +1,9 @@ --- title: "Update copilotAdminLimitedMode" description: "Update the properties of a copilotAdminLimitedMode object." -author: "**TODO: Provide GitHub Name. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" +author: "gautamjain14" ms.localizationpriority: medium -ms.subservice: "**TODO: Add MS subservice. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" +ms.subservice: "meetings-copilot" doc_type: apiPageType --- diff --git a/api-reference/beta/resources/copilotadmin.md b/api-reference/beta/resources/copilotadmin.md index e4be001afa3..e08e695c5a9 100644 --- a/api-reference/beta/resources/copilotadmin.md +++ b/api-reference/beta/resources/copilotadmin.md @@ -1,9 +1,9 @@ --- title: "copilotAdmin resource type" -description: "**TODO: Add Description**" -author: "**TODO: Provide GitHub Name. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" +description: "Navigation property for copilotAdmin" +author: "gautamjain14" ms.localizationpriority: medium -ms.subservice: "**TODO: Add MS subservice. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" +ms.subservice: "meetings-copilot" doc_type: resourcePageType --- diff --git a/api-reference/beta/resources/copilotadminlimitedmode.md b/api-reference/beta/resources/copilotadminlimitedmode.md index 6177ee73ec2..b6d7800b2a5 100644 --- a/api-reference/beta/resources/copilotadminlimitedmode.md +++ b/api-reference/beta/resources/copilotadminlimitedmode.md @@ -1,9 +1,9 @@ --- title: "copilotAdminLimitedMode resource type" -description: "**TODO: Add Description**" -author: "**TODO: Provide GitHub Name. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" +description: "Navigation property for using `copilotAdminLimitedMode` GET and PATCH methods" +author: "gautamjain14" ms.localizationpriority: medium -ms.subservice: "**TODO: Add MS subservice. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" +ms.subservice: "meetings-copilot" doc_type: resourcePageType --- diff --git a/api-reference/beta/resources/copilotadminsetting.md b/api-reference/beta/resources/copilotadminsetting.md index d94726ba56a..bca39e4da57 100644 --- a/api-reference/beta/resources/copilotadminsetting.md +++ b/api-reference/beta/resources/copilotadminsetting.md @@ -1,9 +1,9 @@ --- title: "copilotAdminSetting resource type" -description: "**TODO: Add Description**" -author: "**TODO: Provide GitHub Name. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" +description: "Navigation property for copilotAdminSettings" +author: "gautamjain14" ms.localizationpriority: medium -ms.subservice: "**TODO: Add MS subservice. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" +ms.subservice: "meetings-copilot" doc_type: resourcePageType --- @@ -13,7 +13,7 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Navigation property for `settings` +Navigation property for `copilotAdminSettings` Inherits from [entity](../resources/entity.md). diff --git a/api-reference/beta/resources/copilotroot.md b/api-reference/beta/resources/copilotroot.md index e0c8385f98a..4839eef81d1 100644 --- a/api-reference/beta/resources/copilotroot.md +++ b/api-reference/beta/resources/copilotroot.md @@ -1,6 +1,6 @@ --- title: "copilotRoot resource type" -description: "**TODO: Add Description**" +description: "Navigation property for copilotRoot" author: "**TODO: Provide GitHub Name. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" ms.localizationpriority: medium ms.subservice: "**TODO: Add MS subservice. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" From c895ccec4f9c8c288b742c66004b936bdf701896 Mon Sep 17 00:00:00 2001 From: Gautam Jain Date: Wed, 30 Oct 2024 16:05:37 -0700 Subject: [PATCH 122/308] acrloynx fix --- api-reference/beta/api/copilotadminlimitedmode-update.md | 4 ++-- api-reference/beta/resources/copilotadminlimitedmode.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/api-reference/beta/api/copilotadminlimitedmode-update.md b/api-reference/beta/api/copilotadminlimitedmode-update.md index ce2582fa2da..37e70e5f210 100644 --- a/api-reference/beta/api/copilotadminlimitedmode-update.md +++ b/api-reference/beta/api/copilotadminlimitedmode-update.md @@ -52,7 +52,7 @@ PATCH /copilot/admin/settings/limitedMode |Property|Type|Description| |:---|:---|:---| -|isEnabledForGroup|Boolean|Use this to set whether user should be in limited mode for Copilot in Teams Meetings. When copilotLimitedMode=true, users in this mode can ask any questions, but Copilot will not respond to certain questions related to inferring emotions, behavior, judgements. When copilotLimitedMode=false, this is current mode for Copilot, and it will respond to any types of questions grounded to the meeting conversation. Default value is false.| +|isEnabledForGroup|Boolean|Use this to set whether user should be in limited mode for Copilot in Teams Meetings. When copilotLimitedMode=true, users in this mode can ask any questions, but Copilot will not respond to certain questions related to inferring emotions, behavior, judgments. When copilotLimitedMode=false, this is current mode for Copilot, and it will respond to any types of questions grounded to the meeting conversation. Default value is false.| |groupId|String|The ID of a Microsoft Entra group, of which the value of isEnabledForGroup is applied value for its members. The default value is null. This parameter is optional. If isEnabledForGroup is set to true, groupId value must be provided and copilot limited mode is enabled to the members of the group| @@ -61,7 +61,7 @@ PATCH /copilot/admin/settings/limitedMode If successful, this method returns a `200 OK` response code and an updated [copilotAdminLimitedMode](../resources/copilotadminlimitedmode.md) object in the response body. -API can return additional HTTP status codes : `403 Forbidden`, `500 Internal Server Error`, or `429 Too Many Requests`. +API can return additional HTTP status codes such as `403 Forbidden`, `500 Internal Server Error` or `429 Too Many Requests`. ## Examples diff --git a/api-reference/beta/resources/copilotadminlimitedmode.md b/api-reference/beta/resources/copilotadminlimitedmode.md index b6d7800b2a5..64cce2cdede 100644 --- a/api-reference/beta/resources/copilotadminlimitedmode.md +++ b/api-reference/beta/resources/copilotadminlimitedmode.md @@ -13,7 +13,7 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -LimitedMode copilot setting value controls whether Microsoft 365 Copilot users can receive responses to sentiment-related prompts. If this setting enabled, Copilot will not respond to sentiment-related prompts and questions asked by the user. If setting is disabled, Copilot will respond to sentiment-related prompts and questions asked by the user. In intial version this settings will be honored by Teams Copilot and eventually all M365 Copilots will be honoring this setting. Default value is disabled. +LimitedMode copilot setting value controls whether Microsoft 365 Copilot users can receive responses to sentiment-related prompts. If this setting enabled, Copilot will not respond to sentiment-related prompts and questions asked by the user. If setting is disabled, Copilot will respond to sentiment-related prompts and questions asked by the user. In initial version this setting will be honored by Teams Copilot and eventually all M365 Copilots will be honoring this setting. Default value is disabled. Inherits from [entity](../resources/entity.md). @@ -28,7 +28,7 @@ Inherits from [entity](../resources/entity.md). ## Properties |Property|Type|Description| |:---|:---|:---| -|isEnabledForGroup|Boolean|Use this to set whether user should be in limited mode for Copilot in Teams Meetings. When copilotLimitedMode=true, users in this mode can ask any questions, but Copilot will not respond to certain questions related to inferring emotions, behavior, judgements. When copilotLimitedMode=false, this is current mode for Copilot, and it will respond to any types of questions grounded to the meeting conversation. Default value is false.| +|isEnabledForGroup|Boolean|Use this to set whether user should be in limited mode for Copilot in Teams Meetings. When copilotLimitedMode=true, users in this mode can ask any questions, but Copilot will not respond to certain questions related to inferring emotions, behavior, judgments. When copilotLimitedMode=false, this is current mode for Copilot, and it will respond to any types of questions grounded to the meeting conversation. Default value is false.| |groupId|String|The ID of a Microsoft Entra group, of which the value of isEnabledForGroup is applied value for its members. The default value is null. This parameter is optional. If isEnabledForGroup is set to true, groupId value must be provided and copilot limited mode is enabled to the members of the group| ## Relationships From b0ce4f999bf9947749dadb1dfb9fee61d9bea2c7 Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Wed, 30 Oct 2024 17:05:48 -0600 Subject: [PATCH 123/308] Update filestoragecontainer-permanentdelete.md --- api-reference/v1.0/api/filestoragecontainer-permanentdelete.md | 1 - 1 file changed, 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-permanentdelete.md b/api-reference/v1.0/api/filestoragecontainer-permanentdelete.md index 908f4641eaf..c664312fba6 100644 --- a/api-reference/v1.0/api/filestoragecontainer-permanentdelete.md +++ b/api-reference/v1.0/api/filestoragecontainer-permanentdelete.md @@ -57,7 +57,6 @@ If successful, this action returns a `204 No Content` response code. The following example shows a request. -# [HTTP](#tab/http) ``` http -GET https://graph.microsoft.com/beta/sites/contoso.sharepoint.com,48f1898f-77d9-4a1b-bddc-1f49bb6dc134,7206fc09-e4af-48b3-8730-ed7321396d7a/recycleBin/items +GET https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,48f1898f-77d9-4a1b-bddc-1f49bb6dc134,7206fc09-e4af-48b3-8730-ed7321396d7a/recycleBin/items ``` ### Response From 90a4c183b7c167cf888812476111a23380d15927 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Thu, 31 Oct 2024 11:13:44 -0500 Subject: [PATCH 129/308] Update filestoragecontainer-delete-column.md update line 64 to v1.0 --- api-reference/v1.0/api/filestoragecontainer-delete-column.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-delete-column.md b/api-reference/v1.0/api/filestoragecontainer-delete-column.md index 2ff1348023c..1e4124d40d7 100644 --- a/api-reference/v1.0/api/filestoragecontainer-delete-column.md +++ b/api-reference/v1.0/api/filestoragecontainer-delete-column.md @@ -61,7 +61,7 @@ The following example shows a request. } --> ``` http -DELETE https://graph.microsoft.com/bet/storageContainers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/columns/99ddcf45-e2f7-4f17-82b0-6fba34445103 +DELETE https://graph.microsoft.com/v1.0/storageContainers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/columns/99ddcf45-e2f7-4f17-82b0-6fba34445103 Content-Type: application/json { From 574ebe44f2bb3a03e22b2a506fbf8f13a7283fca Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Thu, 31 Oct 2024 11:15:12 -0500 Subject: [PATCH 130/308] Update recyclebin-list-items.md Removed beta disclaimer on line 14 --- api-reference/v1.0/api/recyclebin-list-items.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/api-reference/v1.0/api/recyclebin-list-items.md b/api-reference/v1.0/api/recyclebin-list-items.md index 846926891b0..9069072eecc 100644 --- a/api-reference/v1.0/api/recyclebin-list-items.md +++ b/api-reference/v1.0/api/recyclebin-list-items.md @@ -11,8 +11,6 @@ doc_type: apiPageType Namespace: microsoft.graph -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] - Get a collection of [recycleBinItem](../resources/recyclebinitem.md) resources in the [recycleBin](../resources/recyclebin.md) of the specified SharePoint [site](../resources/site.md). [!INCLUDE [national-cloud-support](../../includes/global-only.md)] From 853b66c098d37c84b63ffbb4232af3626ac1667e Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Thu, 31 Oct 2024 15:13:57 -0500 Subject: [PATCH 131/308] Update filestoragecontainer-delete-customproperty.md changed to uppercase T and removed extra bracket --- .../v1.0/api/filestoragecontainer-delete-customproperty.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-delete-customproperty.md b/api-reference/v1.0/api/filestoragecontainer-delete-customproperty.md index f12bc20b8ec..241d2a1ad58 100644 --- a/api-reference/v1.0/api/filestoragecontainer-delete-customproperty.md +++ b/api-reference/v1.0/api/filestoragecontainer-delete-customproperty.md @@ -35,7 +35,7 @@ PATCH /storage/fileStorage/containers/{containerId}/customProperties |Name|Description| |:---|:---| |Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Content-type}| application/json. Required.| +|Content-Type| application/json. Required.| ## Request body In the request body, supply the custom properties for deletion by setting them to null. From c2cf5733d215fd1e2651351b3d1cad3a4f31eede Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Thu, 31 Oct 2024 15:34:32 -0500 Subject: [PATCH 132/308] Update filestoragecontainer.md Added settings under properties table --- api-reference/v1.0/resources/filestoragecontainer.md | 1 + 1 file changed, 1 insertion(+) diff --git a/api-reference/v1.0/resources/filestoragecontainer.md b/api-reference/v1.0/resources/filestoragecontainer.md index 143c2c5e22b..66c349e28cc 100644 --- a/api-reference/v1.0/resources/filestoragecontainer.md +++ b/api-reference/v1.0/resources/filestoragecontainer.md @@ -58,6 +58,7 @@ Represents a location where multiple users or a group of users can store files a |displayName|String|The display name of the **fileStorageContainer**. Read-write.| |id|String|The unique stable identifier of the **filerStorageContainer**. Read-only.| |status|fileStorageContainerStatus|Status of the **fileStorageContainer**. Containers are created as inactive and require activation. Inactive containers are subjected to automatic deletion in 24 hours. The possible values are: `inactive `, `active `. Read-only.| +|settings|[fileStorageContainerSettings](../resources/filestoragecontainersettings.md)|Settings associated with a **fileStorageContainer**. Read-write. |viewpoint|[fileStorageContainerViewpoint](../resources/filestoragecontainerviewpoint.md)|Data specific to the current user. Read-only.| ## Relationships From 0935a034cbb07468b35d79424c6f728aa28f9856 Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Thu, 31 Oct 2024 20:08:55 -0600 Subject: [PATCH 133/308] Update copilotadminlimitedmode-get.md --- api-reference/beta/api/copilotadminlimitedmode-get.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/api/copilotadminlimitedmode-get.md b/api-reference/beta/api/copilotadminlimitedmode-get.md index cacd1c1df16..7b4ef4c4d3d 100644 --- a/api-reference/beta/api/copilotadminlimitedmode-get.md +++ b/api-reference/beta/api/copilotadminlimitedmode-get.md @@ -55,7 +55,7 @@ Don't supply a request body for this method. If successful, this method returns a `200 OK` response code and a [copilotAdminLimitedMode](../resources/copilotadminlimitedmode.md) object in the response body. -API can return additional HTTP status codes : `403 Forbidden`, `500 Internal Server Error`, or `429 Too Many Requests`. +API can return more HTTP status codes: `403 Forbidden`, `500 Internal Server Error`, or `429 Too Many Requests`. ## Examples From 813b0d81b80a06fc0709a90593dc5350a2925b08 Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Thu, 31 Oct 2024 20:12:33 -0600 Subject: [PATCH 134/308] Update copilotadminlimitedmode-update.md --- api-reference/beta/api/copilotadminlimitedmode-update.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/api-reference/beta/api/copilotadminlimitedmode-update.md b/api-reference/beta/api/copilotadminlimitedmode-update.md index 37e70e5f210..7692e1e6360 100644 --- a/api-reference/beta/api/copilotadminlimitedmode-update.md +++ b/api-reference/beta/api/copilotadminlimitedmode-update.md @@ -52,16 +52,14 @@ PATCH /copilot/admin/settings/limitedMode |Property|Type|Description| |:---|:---|:---| -|isEnabledForGroup|Boolean|Use this to set whether user should be in limited mode for Copilot in Teams Meetings. When copilotLimitedMode=true, users in this mode can ask any questions, but Copilot will not respond to certain questions related to inferring emotions, behavior, judgments. When copilotLimitedMode=false, this is current mode for Copilot, and it will respond to any types of questions grounded to the meeting conversation. Default value is false.| -|groupId|String|The ID of a Microsoft Entra group, of which the value of isEnabledForGroup is applied value for its members. The default value is null. This parameter is optional. If isEnabledForGroup is set to true, groupId value must be provided and copilot limited mode is enabled to the members of the group| - - +|isEnabledForGroup|Boolean|Enables the user to be in limited mode for Copilot in Teams meetings. When copilotLimitedMode=true, users in this mode can ask any questions, but Copilot doesn't respond to certain questions related to inferring emotions, behavior, or judgments. When copilotLimitedMode=false, the current mode for Copilot, it responds to any types of questions grounded to the meeting conversation. The default value is false.| +|groupId|String|The ID of a Microsoft Entra group, of which the value of isEnabledForGroup is applied value for its members. The default value is null. This parameter is optional. If isEnabledForGroup is set to true, groupID value must be provided and copilot limited mode is enabled for the members of the group| ## Response If successful, this method returns a `200 OK` response code and an updated [copilotAdminLimitedMode](../resources/copilotadminlimitedmode.md) object in the response body. -API can return additional HTTP status codes such as `403 Forbidden`, `500 Internal Server Error` or `429 Too Many Requests`. +API can return additional HTTP status codes such as `403 Forbidden`, `500 Internal Server Error`, or `429 Too Many Requests`. ## Examples From 3dcac44f286bee3361985123988c5c33c27b5432 Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Thu, 31 Oct 2024 20:20:25 -0600 Subject: [PATCH 135/308] Update copilotadminlimitedmode.md --- api-reference/beta/resources/copilotadminlimitedmode.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/api-reference/beta/resources/copilotadminlimitedmode.md b/api-reference/beta/resources/copilotadminlimitedmode.md index 64cce2cdede..eee64ef4c3c 100644 --- a/api-reference/beta/resources/copilotadminlimitedmode.md +++ b/api-reference/beta/resources/copilotadminlimitedmode.md @@ -13,12 +13,10 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -LimitedMode copilot setting value controls whether Microsoft 365 Copilot users can receive responses to sentiment-related prompts. If this setting enabled, Copilot will not respond to sentiment-related prompts and questions asked by the user. If setting is disabled, Copilot will respond to sentiment-related prompts and questions asked by the user. In initial version this setting will be honored by Teams Copilot and eventually all M365 Copilots will be honoring this setting. Default value is disabled. - +LimitedMode copilot setting value controls whether Microsoft 365 Copilot users can receive responses to sentiment-related prompts. If this setting is enabled, Copilot doesn't respond to sentiment-related prompts and questions asked by the user. If the setting is disabled, Copilot responds to sentiment-related prompts and questions asked by the user. In the initial version, this setting is honored by Teams Copilot and eventually all M365 Copilots will be honoring this setting. The default value is disabled. Inherits from [entity](../resources/entity.md). - ## Methods |Method|Return type|Description| |:---|:---|:---| @@ -28,8 +26,8 @@ Inherits from [entity](../resources/entity.md). ## Properties |Property|Type|Description| |:---|:---|:---| -|isEnabledForGroup|Boolean|Use this to set whether user should be in limited mode for Copilot in Teams Meetings. When copilotLimitedMode=true, users in this mode can ask any questions, but Copilot will not respond to certain questions related to inferring emotions, behavior, judgments. When copilotLimitedMode=false, this is current mode for Copilot, and it will respond to any types of questions grounded to the meeting conversation. Default value is false.| -|groupId|String|The ID of a Microsoft Entra group, of which the value of isEnabledForGroup is applied value for its members. The default value is null. This parameter is optional. If isEnabledForGroup is set to true, groupId value must be provided and copilot limited mode is enabled to the members of the group| +|isEnabledForGroup|BooleanEnables the user to be in limited mode for Copilot in Teams meetings. When copilotLimitedMode=true, users in this mode can ask any questions, but Copilot doesn't respond to certain questions related to inferring emotions, behavior, or judgments. When copilotLimitedMode=false, the current mode for Copilot, it responds to any types of questions grounded to the meeting conversation. The default value is false.| +|groupId|String|The ID of a Microsoft Entra group, of which the value of isEnabledForGroup is applied value for its members. The default value is null. This parameter is optional. If isEnabledForGroup is set to true, groupId value must be provided and copilot limited mode is enabled for the members of the group| ## Relationships None. From 8ee50407c226571137e9e98afa35f87fb4d44d6b Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Thu, 31 Oct 2024 20:30:33 -0600 Subject: [PATCH 136/308] Update api-reference/beta/api/copilotadminlimitedmode-update.md --- api-reference/beta/api/copilotadminlimitedmode-update.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/api/copilotadminlimitedmode-update.md b/api-reference/beta/api/copilotadminlimitedmode-update.md index 7692e1e6360..9a690d46020 100644 --- a/api-reference/beta/api/copilotadminlimitedmode-update.md +++ b/api-reference/beta/api/copilotadminlimitedmode-update.md @@ -53,7 +53,7 @@ PATCH /copilot/admin/settings/limitedMode |Property|Type|Description| |:---|:---|:---| |isEnabledForGroup|Boolean|Enables the user to be in limited mode for Copilot in Teams meetings. When copilotLimitedMode=true, users in this mode can ask any questions, but Copilot doesn't respond to certain questions related to inferring emotions, behavior, or judgments. When copilotLimitedMode=false, the current mode for Copilot, it responds to any types of questions grounded to the meeting conversation. The default value is false.| -|groupId|String|The ID of a Microsoft Entra group, of which the value of isEnabledForGroup is applied value for its members. The default value is null. This parameter is optional. If isEnabledForGroup is set to true, groupID value must be provided and copilot limited mode is enabled for the members of the group| +|groupId|String|The ID of a Microsoft Entra group, of which the value of isEnabledForGroup is applied value for its members. The default value is null. This parameter is optional. If isEnabledForGroup is set to true, groupId value must be provided and copilot limited mode is enabled for the members of the group| ## Response From 6d9231593bbdc7d2a0d1a34faee389cd6e9424d8 Mon Sep 17 00:00:00 2001 From: Tony Chan <107155297+tonchan-msft@users.noreply.github.com> Date: Thu, 31 Oct 2024 19:31:30 -0700 Subject: [PATCH 137/308] Update recyclebinsettings.md --- api-reference/v1.0/resources/recyclebinsettings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/resources/recyclebinsettings.md b/api-reference/v1.0/resources/recyclebinsettings.md index fee6e5c6a69..6f6c913a9b9 100644 --- a/api-reference/v1.0/resources/recyclebinsettings.md +++ b/api-reference/v1.0/resources/recyclebinsettings.md @@ -18,7 +18,7 @@ Represents settings for the [recycleBin](recyclebin.md) resource type. ## Properties |Property|Type|Description| |:---|:---|:---| -|retentionPeriodOverrideDays|Int32|Recycle bin retention period override in days for deleted content. The default value is `93`; the value range is `93` to `180`. The setting applies to newly deleted content only. Setting this property to `null` reverts to its default value. Read-write.| +|retentionPeriodOverrideDays|Int32|Recycle bin retention period override in days for deleted content. The default value is `93`; the value range is `7` to `180`. The setting applies to newly deleted content only. Setting this property to `null` reverts to its default value. Read-write.| ## Relationships None. From d24ec31d4fe8f40f37813e07b3854f63da76e04a Mon Sep 17 00:00:00 2001 From: Tony Chan <107155297+tonchan-msft@users.noreply.github.com> Date: Thu, 31 Oct 2024 19:37:19 -0700 Subject: [PATCH 138/308] Update recyclebinsettings.md --- api-reference/beta/resources/recyclebinsettings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/recyclebinsettings.md b/api-reference/beta/resources/recyclebinsettings.md index fee6e5c6a69..6f6c913a9b9 100644 --- a/api-reference/beta/resources/recyclebinsettings.md +++ b/api-reference/beta/resources/recyclebinsettings.md @@ -18,7 +18,7 @@ Represents settings for the [recycleBin](recyclebin.md) resource type. ## Properties |Property|Type|Description| |:---|:---|:---| -|retentionPeriodOverrideDays|Int32|Recycle bin retention period override in days for deleted content. The default value is `93`; the value range is `93` to `180`. The setting applies to newly deleted content only. Setting this property to `null` reverts to its default value. Read-write.| +|retentionPeriodOverrideDays|Int32|Recycle bin retention period override in days for deleted content. The default value is `93`; the value range is `7` to `180`. The setting applies to newly deleted content only. Setting this property to `null` reverts to its default value. Read-write.| ## Relationships None. From f1ffa1de42ebc82822ff9dc33c7cd9b81363999a Mon Sep 17 00:00:00 2001 From: Gautam Jain Date: Fri, 1 Nov 2024 10:05:11 -0700 Subject: [PATCH 139/308] some pr comment fixes on grammar --- api-reference/beta/api/copilotadminlimitedmode-update.md | 2 +- api-reference/beta/resources/copilotadminlimitedmode.md | 4 ++-- api-reference/beta/resources/copilotroot.md | 4 ++-- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/api-reference/beta/api/copilotadminlimitedmode-update.md b/api-reference/beta/api/copilotadminlimitedmode-update.md index 37e70e5f210..f29c3156500 100644 --- a/api-reference/beta/api/copilotadminlimitedmode-update.md +++ b/api-reference/beta/api/copilotadminlimitedmode-update.md @@ -52,7 +52,7 @@ PATCH /copilot/admin/settings/limitedMode |Property|Type|Description| |:---|:---|:---| -|isEnabledForGroup|Boolean|Use this to set whether user should be in limited mode for Copilot in Teams Meetings. When copilotLimitedMode=true, users in this mode can ask any questions, but Copilot will not respond to certain questions related to inferring emotions, behavior, judgments. When copilotLimitedMode=false, this is current mode for Copilot, and it will respond to any types of questions grounded to the meeting conversation. Default value is false.| +|isEnabledForGroup|Boolean|Use this property to set whether user should be in limited mode for Copilot in Teams Meetings. When copilotLimitedMode is true, users in this mode can ask any questions, but Copilot does not respond to certain questions related to inferring emotions, behavior, judgments. When copilotLimitedMode is false, which is also the default value, and it does respond to any types of questions grounded to the meeting conversation. Default value is false.| |groupId|String|The ID of a Microsoft Entra group, of which the value of isEnabledForGroup is applied value for its members. The default value is null. This parameter is optional. If isEnabledForGroup is set to true, groupId value must be provided and copilot limited mode is enabled to the members of the group| diff --git a/api-reference/beta/resources/copilotadminlimitedmode.md b/api-reference/beta/resources/copilotadminlimitedmode.md index 64cce2cdede..fc75fdb62a6 100644 --- a/api-reference/beta/resources/copilotadminlimitedmode.md +++ b/api-reference/beta/resources/copilotadminlimitedmode.md @@ -13,7 +13,7 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -LimitedMode copilot setting value controls whether Microsoft 365 Copilot users can receive responses to sentiment-related prompts. If this setting enabled, Copilot will not respond to sentiment-related prompts and questions asked by the user. If setting is disabled, Copilot will respond to sentiment-related prompts and questions asked by the user. In initial version this setting will be honored by Teams Copilot and eventually all M365 Copilots will be honoring this setting. Default value is disabled. +LimitedMode copilot setting value controls whether Microsoft 365 Copilot users can receive responses to sentiment-related prompts. If this setting enabled, Copilot does not respond to sentiment-related prompts and questions asked by the user. If setting is disabled, Copilot does respond to sentiment-related prompts and questions asked by the user. In initial version, this setting will be honored by Teams Meeting Copilot and eventually all M365 Copilots will be honoring this setting. Default value is disabled. Inherits from [entity](../resources/entity.md). @@ -28,7 +28,7 @@ Inherits from [entity](../resources/entity.md). ## Properties |Property|Type|Description| |:---|:---|:---| -|isEnabledForGroup|Boolean|Use this to set whether user should be in limited mode for Copilot in Teams Meetings. When copilotLimitedMode=true, users in this mode can ask any questions, but Copilot will not respond to certain questions related to inferring emotions, behavior, judgments. When copilotLimitedMode=false, this is current mode for Copilot, and it will respond to any types of questions grounded to the meeting conversation. Default value is false.| +|isEnabledForGroup|Boolean|Use this property to set whether user should be in limited mode for Copilot in Teams Meetings. When copilotLimitedMode is true, users in this mode can ask any questions, but Copilot does not respond to certain questions related to inferring emotions, behavior, judgments. When copilotLimitedMode is false, which is also the default value, and it does respond to any types of questions grounded to the meeting conversation. Default value is false.| |groupId|String|The ID of a Microsoft Entra group, of which the value of isEnabledForGroup is applied value for its members. The default value is null. This parameter is optional. If isEnabledForGroup is set to true, groupId value must be provided and copilot limited mode is enabled to the members of the group| ## Relationships diff --git a/api-reference/beta/resources/copilotroot.md b/api-reference/beta/resources/copilotroot.md index 4839eef81d1..d9ed713b9f2 100644 --- a/api-reference/beta/resources/copilotroot.md +++ b/api-reference/beta/resources/copilotroot.md @@ -1,9 +1,9 @@ --- title: "copilotRoot resource type" description: "Navigation property for copilotRoot" -author: "**TODO: Provide GitHub Name. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" +author: "gautamjain14" ms.localizationpriority: medium -ms.subservice: "**TODO: Add MS subservice. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" +ms.subservice: "meetings-copilot" doc_type: resourcePageType --- From bb1d35c6bbe3bb7d2929007b0f41eda1dd9c2b5c Mon Sep 17 00:00:00 2001 From: Gautam Jain Date: Fri, 1 Nov 2024 10:20:34 -0700 Subject: [PATCH 140/308] pr comments fixed --- api-reference/beta/api/copilotadminlimitedmode-get.md | 2 +- api-reference/beta/resources/copilotadminlimitedmode.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/api-reference/beta/api/copilotadminlimitedmode-get.md b/api-reference/beta/api/copilotadminlimitedmode-get.md index 7b4ef4c4d3d..d8b507d9cdc 100644 --- a/api-reference/beta/api/copilotadminlimitedmode-get.md +++ b/api-reference/beta/api/copilotadminlimitedmode-get.md @@ -55,7 +55,7 @@ Don't supply a request body for this method. If successful, this method returns a `200 OK` response code and a [copilotAdminLimitedMode](../resources/copilotadminlimitedmode.md) object in the response body. -API can return more HTTP status codes: `403 Forbidden`, `500 Internal Server Error`, or `429 Too Many Requests`. +The API can return more HTTP status codes: `403 Forbidden`, `500 Internal Server Error`, or `429 Too Many Requests`. ## Examples diff --git a/api-reference/beta/resources/copilotadminlimitedmode.md b/api-reference/beta/resources/copilotadminlimitedmode.md index eee64ef4c3c..f7365d0dee6 100644 --- a/api-reference/beta/resources/copilotadminlimitedmode.md +++ b/api-reference/beta/resources/copilotadminlimitedmode.md @@ -1,6 +1,6 @@ --- title: "copilotAdminLimitedMode resource type" -description: "Navigation property for using `copilotAdminLimitedMode` GET and PATCH methods" +description: "Represents a setting that controls whether Microsoft 365 Copilot users can receive responses to sentiment-related prompts." author: "gautamjain14" ms.localizationpriority: medium ms.subservice: "meetings-copilot" @@ -13,7 +13,7 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -LimitedMode copilot setting value controls whether Microsoft 365 Copilot users can receive responses to sentiment-related prompts. If this setting is enabled, Copilot doesn't respond to sentiment-related prompts and questions asked by the user. If the setting is disabled, Copilot responds to sentiment-related prompts and questions asked by the user. In the initial version, this setting is honored by Teams Copilot and eventually all M365 Copilots will be honoring this setting. The default value is disabled. +The copilotAdminLimitedMode controls whether Microsoft 365 Copilot users can receive responses to sentiment-related prompts. If this setting is enabled, Microsoft 365 Copilot doesn't respond to sentiment-related prompts and questions asked by the user. If the setting is disabled, Microsoft 365 Copilot responds to sentiment-related prompts and questions asked by the user. In the initial version, this setting is honored by Microsoft Teams Copilot, and eventually all Microsoft 365 Copilots will be honoring this setting. The default value is disabled. Inherits from [entity](../resources/entity.md). From 8bcd4aa054bb76c816f79a960c83062987d5c8e5 Mon Sep 17 00:00:00 2001 From: Gautam Jain Date: Fri, 1 Nov 2024 15:15:10 -0700 Subject: [PATCH 141/308] add toc --- .../beta/api/copilotadminlimitedmode-get.md | 2 +- .../beta/api/copilotadminlimitedmode-update.md | 2 +- api-reference/beta/toc/toc.mapping.json | 14 ++++++++++++++ 3 files changed, 16 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/api/copilotadminlimitedmode-get.md b/api-reference/beta/api/copilotadminlimitedmode-get.md index d8b507d9cdc..5a94805bd1a 100644 --- a/api-reference/beta/api/copilotadminlimitedmode-get.md +++ b/api-reference/beta/api/copilotadminlimitedmode-get.md @@ -1,5 +1,5 @@ --- -title: "Get copilotAdminLimitedMode" +title: "Get Copilot LimitedMode" description: "Read the properties and relationships of a copilotAdminLimitedMode object." author: "gautamjain14" ms.localizationpriority: medium diff --git a/api-reference/beta/api/copilotadminlimitedmode-update.md b/api-reference/beta/api/copilotadminlimitedmode-update.md index 9a690d46020..6e1270d66a8 100644 --- a/api-reference/beta/api/copilotadminlimitedmode-update.md +++ b/api-reference/beta/api/copilotadminlimitedmode-update.md @@ -1,5 +1,5 @@ --- -title: "Update copilotAdminLimitedMode" +title: "Update Copilot LimitedMode" description: "Update the properties of a copilotAdminLimitedMode object." author: "gautamjain14" ms.localizationpriority: medium diff --git a/api-reference/beta/toc/toc.mapping.json b/api-reference/beta/toc/toc.mapping.json index 7db4ac45458..5701853321d 100644 --- a/api-reference/beta/toc/toc.mapping.json +++ b/api-reference/beta/toc/toc.mapping.json @@ -2835,6 +2835,14 @@ "contentSharingSession", "participant", "addLargeGalleryViewOperation" + ], + "childNodes": [ + { + "name": "Copilot settings", + "resources": [ + "copilotAdminLimitedMode" + ] + } ] }, { @@ -2879,6 +2887,12 @@ "href": "../../api/virtualappointment-sendvirtualappointmentsms.md" } ] + }, + { + "name": "Copilot settings", + "resources": [ + "copilotAdminLimitedMode" + ] } ] }, From 9f4d20cade81217eb6ce9838e5c639ed7fe89668 Mon Sep 17 00:00:00 2001 From: Microsoft Graph DevX Tooling Date: Fri, 1 Nov 2024 22:35:26 +0000 Subject: [PATCH 142/308] Update reference TOC --- .../toc/teamwork-and-communications/toc.yml | 20 +++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/api-reference/beta/toc/teamwork-and-communications/toc.yml b/api-reference/beta/toc/teamwork-and-communications/toc.yml index f0277d45f6e..97cf33fa5c2 100644 --- a/api-reference/beta/toc/teamwork-and-communications/toc.yml +++ b/api-reference/beta/toc/teamwork-and-communications/toc.yml @@ -302,6 +302,16 @@ items: href: ../../resources/addlargegalleryviewoperation.md - name: Get large gallery view operation status href: ../../api/addlargegalleryviewoperation-get.md + - name: Copilot settings + items: + - name: Copilot admin limited mode + items: + - name: Copilot admin limited mode + href: ../../resources/copilotadminlimitedmode.md + - name: Get + href: ../../api/copilotadminlimitedmode-get.md + - name: Update + href: ../../api/copilotadminlimitedmode-update.md - name: Call records items: - name: Overview @@ -454,6 +464,16 @@ items: href: ../../api/virtualappointment-sendvirtualappointmentremindersms.md - name: Send virtual appointment SMS href: ../../api/virtualappointment-sendvirtualappointmentsms.md + - name: Copilot settings + items: + - name: Copilot admin limited mode + items: + - name: Copilot admin limited mode + href: ../../resources/copilotadminlimitedmode.md + - name: Get + href: ../../api/copilotadminlimitedmode-get.md + - name: Update + href: ../../api/copilotadminlimitedmode-update.md - name: Virtual events items: - name: Virtual event presenter From 101c210de12088347a7a4a61bae7ed2856b67a01 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 4 Nov 2024 12:57:28 -0600 Subject: [PATCH 143/308] Update filestoragecontainer-delete-customproperty.md removed space in line 38 --- .../v1.0/api/filestoragecontainer-delete-customproperty.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-delete-customproperty.md b/api-reference/v1.0/api/filestoragecontainer-delete-customproperty.md index 241d2a1ad58..94669a4108f 100644 --- a/api-reference/v1.0/api/filestoragecontainer-delete-customproperty.md +++ b/api-reference/v1.0/api/filestoragecontainer-delete-customproperty.md @@ -35,7 +35,7 @@ PATCH /storage/fileStorage/containers/{containerId}/customProperties |Name|Description| |:---|:---| |Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Content-Type| application/json. Required.| +|Content-Type|application/json. Required.| ## Request body In the request body, supply the custom properties for deletion by setting them to null. From 2da884c6e9020fd29fc9ceada94ef5165ec3024c Mon Sep 17 00:00:00 2001 From: Tony Chan <107155297+tonchan-msft@users.noreply.github.com> Date: Mon, 4 Nov 2024 12:09:30 -0800 Subject: [PATCH 144/308] Update recyclebinsettings.md --- api-reference/beta/resources/recyclebinsettings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/recyclebinsettings.md b/api-reference/beta/resources/recyclebinsettings.md index 6f6c913a9b9..7be9c695a41 100644 --- a/api-reference/beta/resources/recyclebinsettings.md +++ b/api-reference/beta/resources/recyclebinsettings.md @@ -18,7 +18,7 @@ Represents settings for the [recycleBin](recyclebin.md) resource type. ## Properties |Property|Type|Description| |:---|:---|:---| -|retentionPeriodOverrideDays|Int32|Recycle bin retention period override in days for deleted content. The default value is `93`; the value range is `7` to `180`. The setting applies to newly deleted content only. Setting this property to `null` reverts to its default value. Read-write.| +|retentionPeriodOverrideDays|Int32|Recycle bin retention period override in days for deleted content. The default value is `93`; the value range is `7` to `180` inclusively. The setting applies to newly deleted content only. Setting this property to `null` reverts to its default value. Read-write.| ## Relationships None. From 4c6aca0bd7ac35424525df3b08e3dc565f1fa471 Mon Sep 17 00:00:00 2001 From: Tony Chan <107155297+tonchan-msft@users.noreply.github.com> Date: Mon, 4 Nov 2024 12:10:52 -0800 Subject: [PATCH 145/308] Update filestoragecontainer-delete-permissions.md --- .../v1.0/api/filestoragecontainer-delete-permissions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-delete-permissions.md b/api-reference/v1.0/api/filestoragecontainer-delete-permissions.md index fa07d658dcc..19207987650 100644 --- a/api-reference/v1.0/api/filestoragecontainer-delete-permissions.md +++ b/api-reference/v1.0/api/filestoragecontainer-delete-permissions.md @@ -14,7 +14,7 @@ Namespace: microsoft.graph Delete permissions from a [fileStorageContainer](../resources/filestoragecontainer.md) object. -By default, this API removes access for an identity to the container and all items within the container, regardless of whether the identity has container-scoped or item-level permissions. You can optimize this behavior by adding an optional `Prefer: onlyRemoveContainerScopedPermission` header when you call the API. When you include the `Prefer:onlyRemoveContainerScopedPermission` header, only the identity's container-scoped permission is removed. All item-level permissions explicitly granted to the identity (if any) are retained. +By default, this API removes access for an identity to the container and all items within the container, regardless of whether the identity has container-scoped or item-level permissions. You can optimize this behavior by adding an optional `Prefer: onlyRemoveContainerScopedPermission` header when you call the API. When you include the `Prefer: onlyRemoveContainerScopedPermission` header, only the identity's container-scoped permission is removed. All item-level permissions explicitly granted to the identity (if any) are retained. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] From 7aad979c183e956088330eb1733dfde25b429c3d Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 4 Nov 2024 14:35:11 -0600 Subject: [PATCH 146/308] Rename delete recyclebin items rename file to adhere to parentresource-method-navproperty convention --- ...in-items.md => filestoragecontainer-delete-recyclebinitems.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename api-reference/v1.0/api/{filestoragecontainer-delete-recyclebin-items.md => filestoragecontainer-delete-recyclebinitems.md} (100%) diff --git a/api-reference/v1.0/api/filestoragecontainer-delete-recyclebin-items.md b/api-reference/v1.0/api/filestoragecontainer-delete-recyclebinitems.md similarity index 100% rename from api-reference/v1.0/api/filestoragecontainer-delete-recyclebin-items.md rename to api-reference/v1.0/api/filestoragecontainer-delete-recyclebinitems.md From 17a5f1614ca63e2e4833cabb17b65a1293e392a8 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 4 Nov 2024 14:36:19 -0600 Subject: [PATCH 147/308] Update file name renamed file to meet parentresource-method-navproperty naming convention. --- ...ebin-items.md => filestoragecontainer-list-recyclebinitems.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename api-reference/v1.0/api/{filestoragecontainer-list-recyclebin-items.md => filestoragecontainer-list-recyclebinitems.md} (100%) diff --git a/api-reference/v1.0/api/filestoragecontainer-list-recyclebin-items.md b/api-reference/v1.0/api/filestoragecontainer-list-recyclebinitems.md similarity index 100% rename from api-reference/v1.0/api/filestoragecontainer-list-recyclebin-items.md rename to api-reference/v1.0/api/filestoragecontainer-list-recyclebinitems.md From fdd589aafdb325bad1fae0d027749c37c0e5dba2 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 4 Nov 2024 14:37:15 -0600 Subject: [PATCH 148/308] rename file rename file to adhere to parentresource-method-navproperty naming conventions --- ...n-items.md => filestoragecontainer-restore-recyclebinitems.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename api-reference/v1.0/api/{filestoragecontainer-restore-recyclebin-items.md => filestoragecontainer-restore-recyclebinitems.md} (100%) diff --git a/api-reference/v1.0/api/filestoragecontainer-restore-recyclebin-items.md b/api-reference/v1.0/api/filestoragecontainer-restore-recyclebinitems.md similarity index 100% rename from api-reference/v1.0/api/filestoragecontainer-restore-recyclebin-items.md rename to api-reference/v1.0/api/filestoragecontainer-restore-recyclebinitems.md From 69a78b5588995defe4f9616bfc3375d7db5df7e0 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 4 Nov 2024 14:39:22 -0600 Subject: [PATCH 149/308] Rename file rename file to adhere to parentresource-method-navproperty naming conventions --- ...=> filestoragecontainer-delete-recyclebinitems-permissions.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename api-reference/v1.0/includes/permissions/{filestoragecontainer-delete-recyclebin-items-permissions.md => filestoragecontainer-delete-recyclebinitems-permissions.md} (100%) diff --git a/api-reference/v1.0/includes/permissions/filestoragecontainer-delete-recyclebin-items-permissions.md b/api-reference/v1.0/includes/permissions/filestoragecontainer-delete-recyclebinitems-permissions.md similarity index 100% rename from api-reference/v1.0/includes/permissions/filestoragecontainer-delete-recyclebin-items-permissions.md rename to api-reference/v1.0/includes/permissions/filestoragecontainer-delete-recyclebinitems-permissions.md From 5864d9e6fe510c6daa6df9b1af82c202851101bf Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 4 Nov 2024 14:39:59 -0600 Subject: [PATCH 150/308] rename file rename file to adhere to parentresource-method-navproperty naming conventions --- ...d => filestoragecontainer-list-recyclebinitems-permissions.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename api-reference/v1.0/includes/permissions/{filestoragecontainer-list-recyclebin-items-permissions.md => filestoragecontainer-list-recyclebinitems-permissions.md} (100%) diff --git a/api-reference/v1.0/includes/permissions/filestoragecontainer-list-recyclebin-items-permissions.md b/api-reference/v1.0/includes/permissions/filestoragecontainer-list-recyclebinitems-permissions.md similarity index 100% rename from api-reference/v1.0/includes/permissions/filestoragecontainer-list-recyclebin-items-permissions.md rename to api-reference/v1.0/includes/permissions/filestoragecontainer-list-recyclebinitems-permissions.md From 00196085d7ce3df317ae07e82a1372a05026717a Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 4 Nov 2024 14:53:27 -0600 Subject: [PATCH 151/308] Update filestoragecontainer-delete-recyclebinitems.md updated permissions line to match file renaming --- .../v1.0/api/filestoragecontainer-delete-recyclebinitems.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-delete-recyclebinitems.md b/api-reference/v1.0/api/filestoragecontainer-delete-recyclebinitems.md index 79c2f9f5d25..94edfa9d181 100644 --- a/api-reference/v1.0/api/filestoragecontainer-delete-recyclebinitems.md +++ b/api-reference/v1.0/api/filestoragecontainer-delete-recyclebinitems.md @@ -22,7 +22,7 @@ Choose the permission or permissions marked as least privileged for this API. Us "name": "filestoragecontainer-delete-recyclebin-items-permissions" } --> -[!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-delete-recyclebin-items-permissions.md)] +[!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-delete-recyclebinitems-permissions.md)] ## HTTP request From daffe6c5355bb217f1e196bb3b3e5954b567f3f9 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 4 Nov 2024 14:54:31 -0600 Subject: [PATCH 152/308] Update filestoragecontainer-list-recyclebinitems.md update permissions in line 25 to correspond with the file name change --- .../v1.0/api/filestoragecontainer-list-recyclebinitems.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-list-recyclebinitems.md b/api-reference/v1.0/api/filestoragecontainer-list-recyclebinitems.md index 476a500033d..7ca4e256be5 100644 --- a/api-reference/v1.0/api/filestoragecontainer-list-recyclebinitems.md +++ b/api-reference/v1.0/api/filestoragecontainer-list-recyclebinitems.md @@ -22,7 +22,7 @@ Choose the permission or permissions marked as least privileged for this API. Us "name": "filestoragecontainer-list-recyclebin-items-permissions" } --> -[!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-list-recyclebin-items-permissions.md)] +[!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-list-recyclebinitems-permissions.md)] ## HTTP request From d6da938773a17ac89ed3678380f8eaa70ab0e8b6 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 4 Nov 2024 14:58:51 -0600 Subject: [PATCH 153/308] Update filestoragecontainer.md update resources files with updated file path corrections --- api-reference/v1.0/resources/filestoragecontainer.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/api-reference/v1.0/resources/filestoragecontainer.md b/api-reference/v1.0/resources/filestoragecontainer.md index 66c349e28cc..1232bd17ad2 100644 --- a/api-reference/v1.0/resources/filestoragecontainer.md +++ b/api-reference/v1.0/resources/filestoragecontainer.md @@ -41,9 +41,9 @@ Represents a location where multiple users or a group of users can store files a |[Delete file storage container column](../api/filestoragecontainer-delete-column.md)|None|Delete a column from a fileStorageContainer.| |[Get column](../api/filestoragecontainer-get-column.md)|[columnDefinition](../resources/columndefinition.md)|Get a column from a fileStorageContainer.| |[Update recycle bin settings](../api/filestoragecontainer-update-recyclebinsettings.md)|[recyclebinsettings](../resources/recyclebinsettings.md)|Update recycleBin settings for a fileStorageContainer.| -|[Restore recycle bin items](../api/filestoragecontainer-restore-recyclebin-items.md)|[recycleBinItem](../resources/recyclebinitem.md) collection|Restore recycle bin items in a fileStorageContainer.| -|[Delete recycle bin items](../api/filestoragecontainer-delete-recyclebin-items.md)|None|Delete recycle bin items from a fileStorageContainer.| -|[Get recycle bin items](../api/filestoragecontainer-list-recyclebin-items.md)|[recycleBinItem](../resources/recyclebinitem.md) collection|List recycle bin items in a fileStorageContainer.| +|[Restore recycle bin items](../api/filestoragecontainer-restore-recyclebinitems.md)|[recycleBinItem](../resources/recyclebinitem.md) collection|Restore recycle bin items in a fileStorageContainer.| +|[Delete recycle bin items](../api/filestoragecontainer-delete-recyclebinitems.md)|None|Delete recycle bin items from a fileStorageContainer.| +|[Get recycle bin items](../api/filestoragecontainer-list-recyclebinitems.md)|[recycleBinItem](../resources/recyclebinitem.md) collection|List recycle bin items in a fileStorageContainer.| |[Lock](../api/filestoragecontainer-lock.md)|None|Lock a [fileStorageContainer](../resources/filestoragecontainer.md).| |[Unlock](../api/filestoragecontainer-unlock.md)|None|Unlock a [fileStorageContainer](../resources/filestoragecontainer.md).| @@ -58,7 +58,7 @@ Represents a location where multiple users or a group of users can store files a |displayName|String|The display name of the **fileStorageContainer**. Read-write.| |id|String|The unique stable identifier of the **filerStorageContainer**. Read-only.| |status|fileStorageContainerStatus|Status of the **fileStorageContainer**. Containers are created as inactive and require activation. Inactive containers are subjected to automatic deletion in 24 hours. The possible values are: `inactive `, `active `. Read-only.| -|settings|[fileStorageContainerSettings](../resources/filestoragecontainersettings.md)|Settings associated with a **fileStorageContainer**. Read-write. +|settings|[fileStorageContainerSettings](../resources/filestoragecontainersettings.md)|Settings associated with a **fileStorageContainer**. Read-write.| |viewpoint|[fileStorageContainerViewpoint](../resources/filestoragecontainerviewpoint.md)|Data specific to the current user. Read-only.| ## Relationships From 6bbbbf8ae5dd676ddb393a62c56b35cab810564e Mon Sep 17 00:00:00 2001 From: Ari Crowe Date: Mon, 4 Nov 2024 14:51:55 -0800 Subject: [PATCH 154/308] acrolinx --- api-reference/beta/api/appmanagementpolicy-post.md | 10 +++++----- api-reference/v1.0/api/appmanagementpolicy-post.md | 10 +++++----- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/api-reference/beta/api/appmanagementpolicy-post.md b/api-reference/beta/api/appmanagementpolicy-post.md index aec00faded6..a68cdcae870 100644 --- a/api-reference/beta/api/appmanagementpolicy-post.md +++ b/api-reference/beta/api/appmanagementpolicy-post.md @@ -53,7 +53,7 @@ You can specify the following properties when creating an **appManagementPolicy* | :----------- | :---------------------------------------------------------- | :--------------------------------------------------------------------- | | displayName | String | The display name of the policy. Required. | | description | String | The description of the policy. Required. | -| isEnabled | Boolean | Denotes whether the policy is enabled. Optional. | +| isEnabled | Boolean | Denotes whether the policy is enabled. Optional. | | restrictions | [appManagementConfiguration](../resources/appManagementConfiguration.md) | Restrictions that apply to an application or service principal object. Optional. | ## Response @@ -67,10 +67,10 @@ If successful, this method returns a `201 Created` response code with the new [a The following example shows a request. This request created an app management policy with the following settings: - Enables the policy. -- Blocks creating of new passwords for applications and service principals created on or after 2019-10-19 at 10:37 AM UTC time. -- Limits password secrets for apps and service principals created after 2014-10-19 at 10:37 AM UTC time to less than 90 days. -- Disables the nonDefaultUriAddition restriction. This means that apps with this policy applied to them will be able to add new non-default identifier URIs to their apps, even if the tenant default policy would typically block it. -- Does not specify any other restrictions. This means that the behavior for those restrictions on apps/service principals with this policy applied will fall back to however the tenant default policy is configured. +- Blocks creating of new passwords for applications and service principals created on or after October 19th 2019 at 10:37 AM UTC time. +- Limits password secrets for apps and service principals created after October 19th 2014 at 10:37 AM UTC time to less than 90 days. +- Disables the nonDefaultUriAddition restriction. This means that apps with this policy applied to them are able to add new nondefault identifier URIs to their apps, even if the tenant default policy would typically block it. +- Doesn't specify any other restrictions. This means that the behavior for those restrictions on apps/service principals with this policy applied falls back to however the tenant default policy is configured. # [HTTP](#tab/http) diff --git a/api-reference/v1.0/api/appmanagementpolicy-post.md b/api-reference/v1.0/api/appmanagementpolicy-post.md index 1ee805ce003..b5e1b818f22 100644 --- a/api-reference/v1.0/api/appmanagementpolicy-post.md +++ b/api-reference/v1.0/api/appmanagementpolicy-post.md @@ -52,7 +52,7 @@ You can specify the following properties when creating an **appManagementPolicy* | :----------- | :---------------------------------------------------------- | :--------------------------------------------------------------------- | | displayName | String | The display name of the policy. Required. | | description | String | The description of the policy. Required. | -| isEnabled | Boolean | Denotes whether the policy is enabled. Optional. | +| isEnabled | Boolean | Denotes whether the policy is enabled. Optional. | | restrictions | [appManagementConfiguration](../resources/appManagementConfiguration.md) | Restrictions that apply to an application or service principal object. Optional. | ## Response @@ -66,10 +66,10 @@ If successful, this method returns a `201 Created` response code with the new [a The following example shows a request. This request created an app management policy with the following settings: - Enables the policy. -- Blocks creating of new passwords for applications and service principals created on or after 2019-10-19 at 10:37 AM UTC time. -- Limits password secrets for apps and service principals created after 2014-10-19 at 10:37 AM UTC time to less than 90 days. -- Disables the nonDefaultUriAddition restriction. This means that apps with this policy applied to them will be able to add new non-default identifier URIs to their apps, even if the tenant default policy would typically block it. -- Does not specify any other restrictions. This means that the behavior for those restrictions on apps/service principals with this policy applied will fall back to however the tenant default policy is configured. +- Blocks creating of new passwords for applications and service principals created on or after October 19th 2019 at 10:37 AM UTC time. +- Limits password secrets for apps and service principals created after October 19th 2014 at 10:37 AM UTC time to less than 90 days. +- Disables the nonDefaultUriAddition restriction. This means that apps with this policy applied to them will be able to add new nondefault identifier URIs to their apps, even if the tenant default policy would typically block it. +- Doesn't specify any other restrictions. This means that the behavior for those restrictions on apps/service principals with this policy applied falls back to however the tenant default policy is configured. # [HTTP](#tab/http) From 657a6047c9d0bcc250f97687bd0d9e830df39a78 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 4 Nov 2024 17:12:15 -0600 Subject: [PATCH 155/308] rename file rename file to singular instead of plural to adhere to naming conventions. --- ...initems.md => filestoragecontainer-delete-recyclebinitem.md} | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) rename api-reference/v1.0/api/{filestoragecontainer-delete-recyclebinitems.md => filestoragecontainer-delete-recyclebinitem.md} (98%) diff --git a/api-reference/v1.0/api/filestoragecontainer-delete-recyclebinitems.md b/api-reference/v1.0/api/filestoragecontainer-delete-recyclebinitem.md similarity index 98% rename from api-reference/v1.0/api/filestoragecontainer-delete-recyclebinitems.md rename to api-reference/v1.0/api/filestoragecontainer-delete-recyclebinitem.md index 94edfa9d181..e6ee856163c 100644 --- a/api-reference/v1.0/api/filestoragecontainer-delete-recyclebinitems.md +++ b/api-reference/v1.0/api/filestoragecontainer-delete-recyclebinitem.md @@ -22,7 +22,7 @@ Choose the permission or permissions marked as least privileged for this API. Us "name": "filestoragecontainer-delete-recyclebin-items-permissions" } --> -[!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-delete-recyclebinitems-permissions.md)] +[!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-delete-recyclebinitem-permissions.md)] ## HTTP request From 14e025b78a018fe6b1a5ea6095faa0bfe9f83459 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 4 Nov 2024 17:14:41 -0600 Subject: [PATCH 156/308] Update file name rename file to singular instead of plural to adhere to naming conventions. --- ...ebinitems.md => filestoragecontainer-list-recyclebinitem.md} | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) rename api-reference/v1.0/api/{filestoragecontainer-list-recyclebinitems.md => filestoragecontainer-list-recyclebinitem.md} (98%) diff --git a/api-reference/v1.0/api/filestoragecontainer-list-recyclebinitems.md b/api-reference/v1.0/api/filestoragecontainer-list-recyclebinitem.md similarity index 98% rename from api-reference/v1.0/api/filestoragecontainer-list-recyclebinitems.md rename to api-reference/v1.0/api/filestoragecontainer-list-recyclebinitem.md index 7ca4e256be5..48cce9bc077 100644 --- a/api-reference/v1.0/api/filestoragecontainer-list-recyclebinitems.md +++ b/api-reference/v1.0/api/filestoragecontainer-list-recyclebinitem.md @@ -22,7 +22,7 @@ Choose the permission or permissions marked as least privileged for this API. Us "name": "filestoragecontainer-list-recyclebin-items-permissions" } --> -[!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-list-recyclebinitems-permissions.md)] +[!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-list-recyclebinitem-permissions.md)] ## HTTP request From f986ca3410761489588214321da528dcc9ce3cea Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 4 Nov 2024 17:16:54 -0600 Subject: [PATCH 157/308] Update filestoragecontainer.md rename file in lines 444 - 46 to singular instead of plural to adhere to naming conventions. --- api-reference/v1.0/resources/filestoragecontainer.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/api-reference/v1.0/resources/filestoragecontainer.md b/api-reference/v1.0/resources/filestoragecontainer.md index 1232bd17ad2..80f251e9f59 100644 --- a/api-reference/v1.0/resources/filestoragecontainer.md +++ b/api-reference/v1.0/resources/filestoragecontainer.md @@ -41,9 +41,9 @@ Represents a location where multiple users or a group of users can store files a |[Delete file storage container column](../api/filestoragecontainer-delete-column.md)|None|Delete a column from a fileStorageContainer.| |[Get column](../api/filestoragecontainer-get-column.md)|[columnDefinition](../resources/columndefinition.md)|Get a column from a fileStorageContainer.| |[Update recycle bin settings](../api/filestoragecontainer-update-recyclebinsettings.md)|[recyclebinsettings](../resources/recyclebinsettings.md)|Update recycleBin settings for a fileStorageContainer.| -|[Restore recycle bin items](../api/filestoragecontainer-restore-recyclebinitems.md)|[recycleBinItem](../resources/recyclebinitem.md) collection|Restore recycle bin items in a fileStorageContainer.| -|[Delete recycle bin items](../api/filestoragecontainer-delete-recyclebinitems.md)|None|Delete recycle bin items from a fileStorageContainer.| -|[Get recycle bin items](../api/filestoragecontainer-list-recyclebinitems.md)|[recycleBinItem](../resources/recyclebinitem.md) collection|List recycle bin items in a fileStorageContainer.| +|[Restore recycle bin items](../api/filestoragecontainer-restore-recyclebinitem.md)|[recycleBinItem](../resources/recyclebinitem.md) collection|Restore recycle bin items in a fileStorageContainer.| +|[Delete recycle bin items](../api/filestoragecontainer-delete-recyclebinitem.md)|None|Delete recycle bin items from a fileStorageContainer.| +|[Get recycle bin items](../api/filestoragecontainer-list-recyclebinitem.md)|[recycleBinItem](../resources/recyclebinitem.md) collection|List recycle bin items in a fileStorageContainer.| |[Lock](../api/filestoragecontainer-lock.md)|None|Lock a [fileStorageContainer](../resources/filestoragecontainer.md).| |[Unlock](../api/filestoragecontainer-unlock.md)|None|Unlock a [fileStorageContainer](../resources/filestoragecontainer.md).| From f1c733595b5e900f4ba0abca35f25b8834eacb0f Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Tue, 5 Nov 2024 10:44:21 -0600 Subject: [PATCH 158/308] Update appmanagementpolicy-post.md --- api-reference/beta/api/appmanagementpolicy-post.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/api-reference/beta/api/appmanagementpolicy-post.md b/api-reference/beta/api/appmanagementpolicy-post.md index a68cdcae870..94e258da21a 100644 --- a/api-reference/beta/api/appmanagementpolicy-post.md +++ b/api-reference/beta/api/appmanagementpolicy-post.md @@ -43,6 +43,7 @@ POST /policies/appManagementPolicies > [!IMPORTANT] > Service principals with a createdDateTime `null` are treated as having being created on 01/01/2019. + ## Request body In the request body, supply a JSON representation of the [appManagementPolicy](../resources/appmanagementpolicy.md) object. @@ -177,6 +178,7 @@ The following example shows the response. HTTP/1.1 200 OK Content-type: application/json + { "@odata.context": "https://graph.microsoft.com/beta/$metadata#policies/appManagementPolicies/$entity", "id": "a4ab1ed9-46bb-4bef-88d4-86fd6398dd5d", From baed71f7858d6dfb4a7a51f7b2acfc65121afd94 Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Tue, 5 Nov 2024 10:45:04 -0600 Subject: [PATCH 159/308] Update appmanagementpolicy-post.md --- api-reference/v1.0/api/appmanagementpolicy-post.md | 1 + 1 file changed, 1 insertion(+) diff --git a/api-reference/v1.0/api/appmanagementpolicy-post.md b/api-reference/v1.0/api/appmanagementpolicy-post.md index b5e1b818f22..78ba1c43c2c 100644 --- a/api-reference/v1.0/api/appmanagementpolicy-post.md +++ b/api-reference/v1.0/api/appmanagementpolicy-post.md @@ -175,6 +175,7 @@ The following example shows the response. ```http HTTP/1.1 200 OK Content-type: application/json + { "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#policies/appManagementPolicies/$entity", "id": "a4ab1ed9-46bb-4bef-88d4-86fd6398dd5d", From 96004e62419b674f098eedf509aa20e5d4c543f4 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Tue, 5 Nov 2024 13:20:01 -0600 Subject: [PATCH 160/308] Change file name Removed s from file name --- ... => filestoragecontainer-delete-recyclebinitem-permissions.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename api-reference/v1.0/includes/permissions/{filestoragecontainer-delete-recyclebinitems-permissions.md => filestoragecontainer-delete-recyclebinitem-permissions.md} (100%) diff --git a/api-reference/v1.0/includes/permissions/filestoragecontainer-delete-recyclebinitems-permissions.md b/api-reference/v1.0/includes/permissions/filestoragecontainer-delete-recyclebinitem-permissions.md similarity index 100% rename from api-reference/v1.0/includes/permissions/filestoragecontainer-delete-recyclebinitems-permissions.md rename to api-reference/v1.0/includes/permissions/filestoragecontainer-delete-recyclebinitem-permissions.md From f2d3a154093844f7687f90bd02ad2217ce931164 Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Tue, 5 Nov 2024 13:25:43 -0600 Subject: [PATCH 161/308] Apply suggestions from code review --- .../beta/resources/applicationauthenticationmethodpolicy.md | 2 +- api-reference/v1.0/api/appmanagementpolicy-post.md | 2 +- .../v1.0/resources/applicationauthenticationmethodpolicy.md | 6 +++--- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/api-reference/beta/resources/applicationauthenticationmethodpolicy.md b/api-reference/beta/resources/applicationauthenticationmethodpolicy.md index 25723dbfc9c..98fe8356f77 100644 --- a/api-reference/beta/resources/applicationauthenticationmethodpolicy.md +++ b/api-reference/beta/resources/applicationauthenticationmethodpolicy.md @@ -75,7 +75,7 @@ Depending on whether your app is a single tenant or multitenant app, you apply t | Policy always exists. | Policy objects can be created or updated to override default policy. | | Allows only single restriction object definition for all resources. | Allows multiple policy objects to be defined, but only one can be applied to a resource. | | Allows distinction of restrictions for application objects vs. service principals. | Policy can be applied to either an application or service principal object. | -| Applies all restrictions configured to all apps or service principals. | Applies the restrictions configured in the resource policy to the specified app or service principal. Anything not defined will inherit from default policy. | +| Applies all restrictions configured to all apps or service principals. | Applies the restrictions configured in the resource policy to the specified app or service principal. Anything not defined inherits from the default policy. | ## Requirements diff --git a/api-reference/v1.0/api/appmanagementpolicy-post.md b/api-reference/v1.0/api/appmanagementpolicy-post.md index 78ba1c43c2c..fae43254948 100644 --- a/api-reference/v1.0/api/appmanagementpolicy-post.md +++ b/api-reference/v1.0/api/appmanagementpolicy-post.md @@ -68,7 +68,7 @@ The following example shows a request. This request created an app management po - Enables the policy. - Blocks creating of new passwords for applications and service principals created on or after October 19th 2019 at 10:37 AM UTC time. - Limits password secrets for apps and service principals created after October 19th 2014 at 10:37 AM UTC time to less than 90 days. -- Disables the nonDefaultUriAddition restriction. This means that apps with this policy applied to them will be able to add new nondefault identifier URIs to their apps, even if the tenant default policy would typically block it. +- Disables the nonDefaultUriAddition restriction. This means that apps with this policy applied to them can add new nondefault identifier URIs to their apps, even if the tenant default policy would typically block it. - Doesn't specify any other restrictions. This means that the behavior for those restrictions on apps/service principals with this policy applied falls back to however the tenant default policy is configured. diff --git a/api-reference/v1.0/resources/applicationauthenticationmethodpolicy.md b/api-reference/v1.0/resources/applicationauthenticationmethodpolicy.md index bbd620d3f96..0b28db4f3d5 100644 --- a/api-reference/v1.0/resources/applicationauthenticationmethodpolicy.md +++ b/api-reference/v1.0/resources/applicationauthenticationmethodpolicy.md @@ -33,10 +33,10 @@ These properties enable an organization to separately control the configuration App management policies are defined in the [appManagementPolicy](appmanagementpolicy.md) resource, which contains a collection of policies with varying restrictions or different enforcement dates from what's defined in tenant default policy. One of these policies can be assigned to an application or service principal to override the tenant default policy. -When the tenant default policy and an app management policy both define the same restriction, the app management policy takes precedence. If a restriction is set on an app management policy in a `disabled` state, that restriction won't apply to apps with that policy linked to them, regardless of what the tenant default policy would normally enforce. Similarly, if a restriction is set on an app management policy in an `enabled` state, that restriction will apply to apps with that policy linked to them. However, if the app management policy doesn't define any behavior for a certain restriction, it will fall back to the tenant default policy's behavior. Only one app management policy can be assigned to an application or service principal. +When the tenant default policy and an app management policy define the same restriction, the app management policy takes precedence. If a restriction is set on an app management policy in a `disabled` state, that restriction won't apply to apps with that policy linked to them, regardless of what the tenant default policy would normally enforce. Similarly, if a restriction is set on an app management policy in an `enabled` state, that restriction applies to apps with that policy linked to them. However, if the app management policy doesn't define any behavior for a certain restriction, it falls back to the tenant default policy's behavior. Only one app management policy can be assigned to an application or service principal. > [!Note] -> Neither the tenant default policies nor the app management policies block token issuance for existing applications. An application that does not meet the policy requirements will continue to work; only the app creation/update operation that violates the policy will be blocked. +> Neither the tenant default nor the app management policies block token issuance for existing applications. An application that does not meet the policy requirements continues to work; only the app creation/update operation that violates the policy is blocked. ## What restrictions can be managed in Microsoft Graph? @@ -71,7 +71,7 @@ Depending on whether your app is a single tenant or multitenant app, you apply t | Policy always exists. | Policy objects can be created or updated to override default policy. | | Allows only single restriction object definition for all resources. | Allows multiple policy objects to be defined, but only one can be applied to a resource. | | Allows distinction of restrictions for application objects vs. service principals. | Policy can be applied to either an application or service principal object. | -| Applies all restrictions configured to all apps or service principals. | Applies the restrictions configured in the resource policy to the specified app or service principal. Anything not defined will inherit from default policy. | +| Applies all restrictions configured to all apps or service principals. | Applies the restrictions configured in the resource policy to the specified app or service principal. Anything not defined inherits from default policy. | ## Requirements From 4e5695eb7261e9601e03965587d93ec5e0d2fe1b Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Tue, 5 Nov 2024 13:27:45 -0600 Subject: [PATCH 162/308] Update filestoragecontainer-delete-recyclebinitem.md change lines 2 and 10 to singular --- .../v1.0/api/filestoragecontainer-delete-recyclebinitem.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-delete-recyclebinitem.md b/api-reference/v1.0/api/filestoragecontainer-delete-recyclebinitem.md index e6ee856163c..dd472fa86ae 100644 --- a/api-reference/v1.0/api/filestoragecontainer-delete-recyclebinitem.md +++ b/api-reference/v1.0/api/filestoragecontainer-delete-recyclebinitem.md @@ -1,5 +1,5 @@ --- -title: "Delete recycleBinItems" +title: "Delete recycleBinItem" description: "Delete items from the fileStorageContainer recycleBin." author: "harmoneddie" ms.localizationpriority: medium @@ -7,7 +7,7 @@ ms.subservice: "onedrive" doc_type: apiPageType --- -# Delete recycleBinItems +# Delete recycleBinItem Namespace: microsoft.graph From f68bac16cdcb062baa8e394d4e442cb989779e18 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Tue, 5 Nov 2024 13:31:53 -0600 Subject: [PATCH 163/308] Update file name and file references Update file and references to singular (items to item) --- ... => filestoragecontainer-restore-recyclebinitem.md} | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) rename api-reference/v1.0/api/{filestoragecontainer-restore-recyclebinitems.md => filestoragecontainer-restore-recyclebinitem.md} (91%) diff --git a/api-reference/v1.0/api/filestoragecontainer-restore-recyclebinitems.md b/api-reference/v1.0/api/filestoragecontainer-restore-recyclebinitem.md similarity index 91% rename from api-reference/v1.0/api/filestoragecontainer-restore-recyclebinitems.md rename to api-reference/v1.0/api/filestoragecontainer-restore-recyclebinitem.md index 54a67ed3cdc..b1d751595d9 100644 --- a/api-reference/v1.0/api/filestoragecontainer-restore-recyclebinitems.md +++ b/api-reference/v1.0/api/filestoragecontainer-restore-recyclebinitem.md @@ -1,13 +1,13 @@ --- -title: "Restore recycleBin items" -description: "Restore recycleBin items to a fileStorageContainer." +title: "Restore recycleBin item" +description: "Restore recycleBin item to a fileStorageContainer." author: "harmoneddie" ms.localizationpriority: medium ms.subservice: "onedrive" doc_type: apiPageType --- -# Restore recycle bin items +# Restore recycle bin item Namespace: microsoft.graph @@ -19,10 +19,10 @@ Choose the permission or permissions marked as least privileged for this API. Us -[!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-restore-recyclebin-items-permissions.md)] +[!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-restore-recyclebinitem-permissions.md)] ## HTTP request From bc23c70327f959e39b086adaa1d8018b450a6259 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Tue, 5 Nov 2024 13:34:40 -0600 Subject: [PATCH 164/308] Update file name update file name and references --- .../{recyclebin-list-items.md => recyclebin-list-item.md} | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) rename api-reference/v1.0/api/{recyclebin-list-items.md => recyclebin-list-item.md} (97%) diff --git a/api-reference/v1.0/api/recyclebin-list-items.md b/api-reference/v1.0/api/recyclebin-list-item.md similarity index 97% rename from api-reference/v1.0/api/recyclebin-list-items.md rename to api-reference/v1.0/api/recyclebin-list-item.md index 9069072eecc..0cbffe2e44b 100644 --- a/api-reference/v1.0/api/recyclebin-list-items.md +++ b/api-reference/v1.0/api/recyclebin-list-item.md @@ -1,13 +1,13 @@ --- author: "vanshisingh" -title: "List items" +title: "List item" description: "Get a collection of recycleBinItem resources in the recycleBin of the specified SharePoint site." ms.localizationpriority: "medium" ms.subservice: "sharepoint" doc_type: apiPageType --- -# List items +# List item Namespace: microsoft.graph @@ -55,7 +55,7 @@ The following example shows a request to list all **recycleBinItem** resources u ``` http From dc57e0487763341bbb6a0a1b1a4593dfebfcab6c Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Tue, 5 Nov 2024 14:20:10 -0600 Subject: [PATCH 165/308] Apply suggestions from code review --- api-reference/beta/api/appmanagementpolicy-post.md | 2 +- .../beta/resources/applicationauthenticationmethodpolicy.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/api-reference/beta/api/appmanagementpolicy-post.md b/api-reference/beta/api/appmanagementpolicy-post.md index 94e258da21a..c67dfcc5a4a 100644 --- a/api-reference/beta/api/appmanagementpolicy-post.md +++ b/api-reference/beta/api/appmanagementpolicy-post.md @@ -70,7 +70,7 @@ The following example shows a request. This request created an app management po - Enables the policy. - Blocks creating of new passwords for applications and service principals created on or after October 19th 2019 at 10:37 AM UTC time. - Limits password secrets for apps and service principals created after October 19th 2014 at 10:37 AM UTC time to less than 90 days. -- Disables the nonDefaultUriAddition restriction. This means that apps with this policy applied to them are able to add new nondefault identifier URIs to their apps, even if the tenant default policy would typically block it. +- Disables the nonDefaultUriAddition restriction. This means that apps with this policy applied to them can add new nondefault identifier URIs to their apps, even if the tenant default policy typically blocks it. - Doesn't specify any other restrictions. This means that the behavior for those restrictions on apps/service principals with this policy applied falls back to however the tenant default policy is configured. diff --git a/api-reference/beta/resources/applicationauthenticationmethodpolicy.md b/api-reference/beta/resources/applicationauthenticationmethodpolicy.md index 98fe8356f77..ed952f2c42e 100644 --- a/api-reference/beta/resources/applicationauthenticationmethodpolicy.md +++ b/api-reference/beta/resources/applicationauthenticationmethodpolicy.md @@ -35,10 +35,10 @@ These properties enable an organization to separately control the configuration App management policies are defined in the [appManagementPolicy](appmanagementpolicy.md) resource, which contains a collection of policies with varying restrictions or different enforcement dates from what's defined in tenant default policy. One of these policies can be assigned to an application or service principal to override the tenant default policy. -When the tenant default policy and an app management policy both define the same restriction, the app management policy takes precedence. If a restriction is set on an app management policy in a `disabled` state, that restriction won't apply to apps with that policy linked to them, regardless of what the tenant default policy would normally enforce. Similarly, if a restriction is set on an app management policy in an `enabled` state, that restriction will apply to apps with that policy linked to them. However, if the app management policy doesn't define any behavior for a certain restriction, it will fall back to the tenant default policy's behavior. Only one app management policy can be assigned to an application or service principal. +When the tenant default policy and an app management policy define the same restriction, the app management policy takes precedence. If a restriction is set on an app management policy in a `disabled` state, that restriction won't apply to apps with that policy linked to them, regardless of what the tenant default policy would normally enforce. Similarly, if a restriction is set on an app management policy in an `enabled` state, that restriction will apply to apps with that policy linked to them. However, if the app management policy doesn't define any behavior for a certain restriction, it falls back to the tenant default policy's behavior. Only one app management policy can be assigned to an application or service principal. > [!Note] -> Neither the tenant default policies nor the app management policies block token issuance for existing applications. An application that does not meet the policy requirements will continue to work; only the app creation/update operation that violates the policy will be blocked. +> Neither the tenant default nor the app management policies block token issuance for existing applications. An application that doesn't meet the policy requirements continues to work; only the app creation/update operation that violates the policy is blocked. ## What restrictions can be managed in Microsoft Graph? From 11627a30895a7fa48501be1fe4587ef3950153e0 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Tue, 5 Nov 2024 14:44:13 -0600 Subject: [PATCH 166/308] Rename file Rename file to singular resource --- ...md => filestoragecontainer-list-recyclebinitem-permissions.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename api-reference/v1.0/includes/permissions/{filestoragecontainer-list-recyclebinitems-permissions.md => filestoragecontainer-list-recyclebinitem-permissions.md} (100%) diff --git a/api-reference/v1.0/includes/permissions/filestoragecontainer-list-recyclebinitems-permissions.md b/api-reference/v1.0/includes/permissions/filestoragecontainer-list-recyclebinitem-permissions.md similarity index 100% rename from api-reference/v1.0/includes/permissions/filestoragecontainer-list-recyclebinitems-permissions.md rename to api-reference/v1.0/includes/permissions/filestoragecontainer-list-recyclebinitem-permissions.md From 03b867f9398f5514190fc0b7ba34ded5cd1149f1 Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Tue, 5 Nov 2024 15:22:00 -0600 Subject: [PATCH 167/308] Rename recyclebin-list-item.md to recyclebin-list-items.md --- .../api/{recyclebin-list-item.md => recyclebin-list-items.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename api-reference/v1.0/api/{recyclebin-list-item.md => recyclebin-list-items.md} (100%) diff --git a/api-reference/v1.0/api/recyclebin-list-item.md b/api-reference/v1.0/api/recyclebin-list-items.md similarity index 100% rename from api-reference/v1.0/api/recyclebin-list-item.md rename to api-reference/v1.0/api/recyclebin-list-items.md From 53b3abb7dee7a31359bd20db66ad842e53ca0b7a Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Tue, 5 Nov 2024 16:43:08 -0600 Subject: [PATCH 168/308] Update file path remove space and plural --- ...=> filestoragecontainer-restore-recyclebinitem-permissions.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename api-reference/v1.0/includes/permissions/{filestoragecontainer-restore-recyclebin-items-permissions.md => filestoragecontainer-restore-recyclebinitem-permissions.md} (100%) diff --git a/api-reference/v1.0/includes/permissions/filestoragecontainer-restore-recyclebin-items-permissions.md b/api-reference/v1.0/includes/permissions/filestoragecontainer-restore-recyclebinitem-permissions.md similarity index 100% rename from api-reference/v1.0/includes/permissions/filestoragecontainer-restore-recyclebin-items-permissions.md rename to api-reference/v1.0/includes/permissions/filestoragecontainer-restore-recyclebinitem-permissions.md From 76fa47e29008e7fbef9f393a90fc3bc75a3378fd Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Tue, 5 Nov 2024 17:19:54 -0600 Subject: [PATCH 169/308] Update Microsoft.FileServices.json --- changelog/Microsoft.FileServices.json | 148 +++++++++++++++++++++++++- 1 file changed, 147 insertions(+), 1 deletion(-) diff --git a/changelog/Microsoft.FileServices.json b/changelog/Microsoft.FileServices.json index 414bd7f367f..7b229efd5e0 100644 --- a/changelog/Microsoft.FileServices.json +++ b/changelog/Microsoft.FileServices.json @@ -3871,6 +3871,152 @@ "CreatedDateTime": "2024-09-10T05:34:22.37196Z", "WorkloadArea": "Files", "SubArea": "" - } + }, + { + "ChangeList": [ + { + "Id": "d4cad5ca-ea99-4c26-bb63-35d74f43", + "ApiChange": "Method", + "ChangedApiName": "Delete", + "ChangeType": "Addition", + "Description": "Added the [Delete](https://learn.microsoft.com/en-us/graph/api/filestorage-delete-deletedcontainers?view=graph-rest-1.0) operation to the [filestorage](https://learn.microsoft.com/en-us/graph/api/resources/filestorage?view=graph-rest-1.0) resource.", + "Target": "filestorage" + }, + { + "Id": "d4cad5ca-ea99-4c26-bb63-35d74f43", + "ApiChange": "Method", + "ChangedApiName": "Delete", + "ChangeType": "Addition", + "Description": "Added the [Delete](https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-delete-column?view=graph-rest-1.0) operation to the [filestoragecontainer](https://learn.microsoft.com/en-us/graph/api/resources/filestoragecontainer?view=graph-rest-1.0) resource.", + "Target": "filestoragecontainer" + }, + { + "Id": "d4cad5ca-ea99-4c26-bb63-35d74f43", + "ApiChange": "Method", + "ChangedApiName": "Delete", + "ChangeType": "Addition", + "Description": "Added the [Delete](https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-delete-recyclebin-items?view=graph-rest-1.0) operation to the [filestoragecontainer](https://learn.microsoft.com/en-us/graph/api/resources/filestoragecontainer?view=graph-rest-1.0) resource.", + "Target": "filestoragecontainer" + }, + { + "Id": "d4cad5ca-ea99-4c26-bb63-35d74f43", + "ApiChange": "Method", + "ChangedApiName": "get", + "ChangeType": "Addition", + "Description": "Added the [get](https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-get-column?view=graph-rest-1.0) operation to the [filestoragecontainer](https://learn.microsoft.com/en-us/graph/api/resources/filestoragecontainer?view=graph-rest-1.0) resource.", + "Target": "filestoragecontainer" + }, + { + "Id": "d4cad5ca-ea99-4c26-bb63-35d74f43", + "ApiChange": "Method", + "ChangedApiName": "List", + "ChangeType": "Addition", + "Description": "Added the [list](https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-list-column?view=graph-rest-1.0) operation to the [filestoragecontainer](https://learn.microsoft.com/en-us/graph/api/resources/filestoragecontainer?view=graph-rest-1.0) resource.", + "Target": "filestoragecontainer" + }, + { + "Id": "d4cad5ca-ea99-4c26-bb63-35d74f43", + "ApiChange": "Method", + "ChangedApiName": "List", + "ChangeType": "Addition", + "Description": "Added the [list](https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-list-recyclebinitem?view=graph-rest-1.0) operation to the [filestoragecontainer](https://learn.microsoft.com/en-us/graph/api/resources/filestoragecontainer?view=graph-rest-1.0) resource.", + "Target": "filestoragecontainer" + }, + { + "Id": "d4cad5ca-ea99-4c26-bb63-35d74f43", + "ApiChange": "Method", + "ChangedApiName": "lock", + "ChangeType": "Addition", + "Description": "Added the [lock](https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-lock?view=graph-rest-1.0) operation to the [filestoragecontainer](https://learn.microsoft.com/en-us/graph/api/resources/filestoragecontainer?view=graph-rest-1.0) resource.", + "Target": "filestoragecontainer" + }, + { + "Id": "d4cad5ca-ea99-4c26-bb63-35d74f43", + "ApiChange": "Method", + "ChangedApiName": "post", + "ChangeType": "Addition", + "Description": "Added the [post](https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-post-columns?view=graph-rest-1.0) operation to the [filestoragecontainer](https://learn.microsoft.com/en-us/graph/api/resources/filestoragecontainer?view=graph-rest-1.0) resource.", + "Target": "filestoragecontainer" + }, + { + "Id": "d4cad5ca-ea99-4c26-bb63-35d74f43", + "ApiChange": "Method", + "ChangedApiName": "Restore", + "ChangeType": "Addition", + "Description": "Added the [Restore recyclebintem](https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-restore-recyclebinitem?view=graph-rest-1.0) operation to the [filestoragecontainer](https://learn.microsoft.com/en-us/graph/api/resources/filestoragecontainer?view=graph-rest-1.0) resource.", + "Target": "filestoragecontainer" + }, + { + "Id": "d4cad5ca-ea99-4c26-bb63-35d74f43", + "ApiChange": "Method", + "ChangedApiName": "Restore", + "ChangeType": "Addition", + "Description": "Added the [Restore](https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-restore?view=graph-rest-1.0) operation to the [filestoragecontainer](https://learn.microsoft.com/en-us/graph/api/resources/filestoragecontainer?view=graph-rest-1.0) resource.", + "Target": "filestoragecontainer" + }, + { + "Id": "d4cad5ca-ea99-4c26-bb63-35d74f43", + "ApiChange": "Method", + "ChangedApiName": "Unlock", + "ChangeType": "Addition", + "Description": "Added the [Unlock](https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-unlock?view=graph-rest-1.0) operation to the [filestoragecontainer](https://learn.microsoft.com/en-us/graph/api/resources/filestoragecontainer?view=graph-rest-1.0) resource.", + "Target": "filestoragecontainer" + }, + { + "Id": "d4cad5ca-ea99-4c26-bb63-35d74f43", + "ApiChange": "Method", + "ChangedApiName": "Update", + "ChangeType": "Addition", + "Description": "Added the [Update](https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-update-column?view=graph-rest-1.0) operation to the [filestoragecontainer](https://learn.microsoft.com/en-us/graph/api/resources/filestoragecontainer?view=graph-rest-1.0) resource.", + "Target": "filestoragecontainer" + }, + { + "Id": "d4cad5ca-ea99-4c26-bb63-35d74f43", + "ApiChange": "Method", + "ChangedApiName": "Update", + "ChangeType": "Addition", + "Description": "Added the [Update](https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-update-recyclebinsettings?view=graph-rest-1.0) operation to the [filestoragecontainer](https://learn.microsoft.com/en-us/graph/api/resources/filestoragecontainer?view=graph-rest-1.0) resource.", + "Target": "filestoragecontainer" + }, + { + "Id": "d4cad5ca-ea99-4c26-bb63-35d74f43", + "ApiChange": "Resource", + "ChangedApiName": "recyblebin", + "ChangeType": "Addition", + "Description": "Added the [recyblebin](https://learn.microsoft.com/en-us/graph/api/resources/recyblebin?view=graph-rest-1.0) resource.", + "Target": "recyblebin" + }, + { + "Id": "d4cad5ca-ea99-4c26-bb63-35d74f43", + "ApiChange": "Resource", + "ChangedApiName": "recyblebin", + "ChangeType": "Addition", + "Description": "Added the [recyblebin](https://learn.microsoft.com/en-us/graph/api/resources/recyblebin?view=graph-rest-1.0) resource.", + "Target": "recyblebin" + }, + { + "Id": "d4cad5ca-ea99-4c26-bb63-35d74f43", + "ApiChange": "Resource", + "ChangedApiName": "recyblebinitem", + "ChangeType": "Addition", + "Description": "Added the [recyblebinitem](https://learn.microsoft.com/en-us/graph/api/resources/recyblebinitem?view=graph-rest-1.0) resource.", + "Target": "recyblebinitem" + }, + { + "Id": "d4cad5ca-ea99-4c26-bb63-35d74f43", + "ApiChange": "Resource", + "ChangedApiName": "recyblebinsettings", + "ChangeType": "Addition", + "Description": "Added the [recyblebinitem](https://learn.microsoft.com/en-us/graph/api/resources/recyblebinsettings?view=graph-rest-1.0) resource.", + "Target": "recyblebinsettings" + } + ], + "Id": "d4cad5ca-ea99-4c26-bb63-35d74f43", + "Cloud": "Prod", + "Version": "v1.0", + "CreatedDateTime": "2024-11-05T06:57:37.5509045Z", + "WorkloadArea": "Files", + "SubArea": "" + } ] } From 9d056a194ce33102683c9e668e2655c472e8267e Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Tue, 5 Nov 2024 17:25:56 -0600 Subject: [PATCH 170/308] Apply suggestions from code review --- changelog/Microsoft.FileServices.json | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/changelog/Microsoft.FileServices.json b/changelog/Microsoft.FileServices.json index 7b229efd5e0..ead8b3c7b15 100644 --- a/changelog/Microsoft.FileServices.json +++ b/changelog/Microsoft.FileServices.json @@ -3887,7 +3887,7 @@ "ApiChange": "Method", "ChangedApiName": "Delete", "ChangeType": "Addition", - "Description": "Added the [Delete](https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-delete-column?view=graph-rest-1.0) operation to the [filestoragecontainer](https://learn.microsoft.com/en-us/graph/api/resources/filestoragecontainer?view=graph-rest-1.0) resource.", + "Description": "Added the [Delete column](https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-delete-column?view=graph-rest-1.0) operation to the [filestoragecontainer](https://learn.microsoft.com/en-us/graph/api/resources/filestoragecontainer?view=graph-rest-1.0) resource.", "Target": "filestoragecontainer" }, { @@ -3895,7 +3895,7 @@ "ApiChange": "Method", "ChangedApiName": "Delete", "ChangeType": "Addition", - "Description": "Added the [Delete](https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-delete-recyclebin-items?view=graph-rest-1.0) operation to the [filestoragecontainer](https://learn.microsoft.com/en-us/graph/api/resources/filestoragecontainer?view=graph-rest-1.0) resource.", + "Description": "Added the [Delete recyclebinitem](https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-delete-recyclebinitem?view=graph-rest-1.0) operation to the [filestoragecontainer](https://learn.microsoft.com/en-us/graph/api/resources/filestoragecontainer?view=graph-rest-1.0) resource.", "Target": "filestoragecontainer" }, { @@ -3903,7 +3903,7 @@ "ApiChange": "Method", "ChangedApiName": "get", "ChangeType": "Addition", - "Description": "Added the [get](https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-get-column?view=graph-rest-1.0) operation to the [filestoragecontainer](https://learn.microsoft.com/en-us/graph/api/resources/filestoragecontainer?view=graph-rest-1.0) resource.", + "Description": "Added the [get column](https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-get-column?view=graph-rest-1.0) operation to the [filestoragecontainer](https://learn.microsoft.com/en-us/graph/api/resources/filestoragecontainer?view=graph-rest-1.0) resource.", "Target": "filestoragecontainer" }, { @@ -3911,7 +3911,7 @@ "ApiChange": "Method", "ChangedApiName": "List", "ChangeType": "Addition", - "Description": "Added the [list](https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-list-column?view=graph-rest-1.0) operation to the [filestoragecontainer](https://learn.microsoft.com/en-us/graph/api/resources/filestoragecontainer?view=graph-rest-1.0) resource.", + "Description": "Added the [list column](https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-list-column?view=graph-rest-1.0) operation to the [filestoragecontainer](https://learn.microsoft.com/en-us/graph/api/resources/filestoragecontainer?view=graph-rest-1.0) resource.", "Target": "filestoragecontainer" }, { @@ -3919,7 +3919,7 @@ "ApiChange": "Method", "ChangedApiName": "List", "ChangeType": "Addition", - "Description": "Added the [list](https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-list-recyclebinitem?view=graph-rest-1.0) operation to the [filestoragecontainer](https://learn.microsoft.com/en-us/graph/api/resources/filestoragecontainer?view=graph-rest-1.0) resource.", + "Description": "Added the [list recyclebinitem](https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-list-recyclebinitem?view=graph-rest-1.0) operation to the [filestoragecontainer](https://learn.microsoft.com/en-us/graph/api/resources/filestoragecontainer?view=graph-rest-1.0) resource.", "Target": "filestoragecontainer" }, { From 6247cd6e1a9708746c74ddd1980e128883754e99 Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Tue, 5 Nov 2024 17:32:25 -0600 Subject: [PATCH 171/308] Apply suggestions from code review --- changelog/Microsoft.FileServices.json | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/changelog/Microsoft.FileServices.json b/changelog/Microsoft.FileServices.json index ead8b3c7b15..eb1042fc712 100644 --- a/changelog/Microsoft.FileServices.json +++ b/changelog/Microsoft.FileServices.json @@ -3983,7 +3983,7 @@ "ApiChange": "Resource", "ChangedApiName": "recyblebin", "ChangeType": "Addition", - "Description": "Added the [recyblebin](https://learn.microsoft.com/en-us/graph/api/resources/recyblebin?view=graph-rest-1.0) resource.", + "Description": "Added the [recyclebin](https://learn.microsoft.com/en-us/graph/api/resources/recyclebin?view=graph-rest-1.0) resource.", "Target": "recyblebin" }, { @@ -3991,7 +3991,7 @@ "ApiChange": "Resource", "ChangedApiName": "recyblebin", "ChangeType": "Addition", - "Description": "Added the [recyblebin](https://learn.microsoft.com/en-us/graph/api/resources/recyblebin?view=graph-rest-1.0) resource.", + "Description": "Added the [recyclebin](https://learn.microsoft.com/en-us/graph/api/resources/recyclebin?view=graph-rest-1.0) resource.", "Target": "recyblebin" }, { @@ -3999,7 +3999,7 @@ "ApiChange": "Resource", "ChangedApiName": "recyblebinitem", "ChangeType": "Addition", - "Description": "Added the [recyblebinitem](https://learn.microsoft.com/en-us/graph/api/resources/recyblebinitem?view=graph-rest-1.0) resource.", + "Description": "Added the [recyclebinitem](https://learn.microsoft.com/en-us/graph/api/resources/recyclebinitem?view=graph-rest-1.0) resource.", "Target": "recyblebinitem" }, { @@ -4007,8 +4007,8 @@ "ApiChange": "Resource", "ChangedApiName": "recyblebinsettings", "ChangeType": "Addition", - "Description": "Added the [recyblebinitem](https://learn.microsoft.com/en-us/graph/api/resources/recyblebinsettings?view=graph-rest-1.0) resource.", - "Target": "recyblebinsettings" + "Description": "Added the [recyclebinitem](https://learn.microsoft.com/en-us/graph/api/resources/recyclebinsettings?view=graph-rest-1.0) resource.", + "Target": "recyclebinsettings" } ], "Id": "d4cad5ca-ea99-4c26-bb63-35d74f43", From 683755936f29519d740b47a331783b9dc8c889aa Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Tue, 5 Nov 2024 17:35:38 -0600 Subject: [PATCH 172/308] Apply suggestions from code review --- changelog/Microsoft.FileServices.json | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/changelog/Microsoft.FileServices.json b/changelog/Microsoft.FileServices.json index eb1042fc712..f8e21efc819 100644 --- a/changelog/Microsoft.FileServices.json +++ b/changelog/Microsoft.FileServices.json @@ -3981,7 +3981,7 @@ { "Id": "d4cad5ca-ea99-4c26-bb63-35d74f43", "ApiChange": "Resource", - "ChangedApiName": "recyblebin", + "ChangedApiName": "recyclebin", "ChangeType": "Addition", "Description": "Added the [recyclebin](https://learn.microsoft.com/en-us/graph/api/resources/recyclebin?view=graph-rest-1.0) resource.", "Target": "recyblebin" @@ -3989,7 +3989,7 @@ { "Id": "d4cad5ca-ea99-4c26-bb63-35d74f43", "ApiChange": "Resource", - "ChangedApiName": "recyblebin", + "ChangedApiName": "recyclebin", "ChangeType": "Addition", "Description": "Added the [recyclebin](https://learn.microsoft.com/en-us/graph/api/resources/recyclebin?view=graph-rest-1.0) resource.", "Target": "recyblebin" @@ -3997,15 +3997,15 @@ { "Id": "d4cad5ca-ea99-4c26-bb63-35d74f43", "ApiChange": "Resource", - "ChangedApiName": "recyblebinitem", + "ChangedApiName": "recyclebinitem", "ChangeType": "Addition", "Description": "Added the [recyclebinitem](https://learn.microsoft.com/en-us/graph/api/resources/recyclebinitem?view=graph-rest-1.0) resource.", - "Target": "recyblebinitem" + "Target": "recyclebinitem" }, { "Id": "d4cad5ca-ea99-4c26-bb63-35d74f43", "ApiChange": "Resource", - "ChangedApiName": "recyblebinsettings", + "ChangedApiName": "recyclebinsettings", "ChangeType": "Addition", "Description": "Added the [recyclebinitem](https://learn.microsoft.com/en-us/graph/api/resources/recyclebinsettings?view=graph-rest-1.0) resource.", "Target": "recyclebinsettings" From 13a85aa58e48047dcebf5c8a3a00175bd1d3ee2c Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Tue, 5 Nov 2024 17:42:51 -0600 Subject: [PATCH 173/308] Apply suggestions from code review --- changelog/Microsoft.FileServices.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/changelog/Microsoft.FileServices.json b/changelog/Microsoft.FileServices.json index f8e21efc819..833cc9a6e9c 100644 --- a/changelog/Microsoft.FileServices.json +++ b/changelog/Microsoft.FileServices.json @@ -3911,7 +3911,7 @@ "ApiChange": "Method", "ChangedApiName": "List", "ChangeType": "Addition", - "Description": "Added the [list column](https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-list-column?view=graph-rest-1.0) operation to the [filestoragecontainer](https://learn.microsoft.com/en-us/graph/api/resources/filestoragecontainer?view=graph-rest-1.0) resource.", + "Description": "Added the [list column](https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-list-columns?view=graph-rest-1.0) operation to the [filestoragecontainer](https://learn.microsoft.com/en-us/graph/api/resources/filestoragecontainer?view=graph-rest-1.0) resource.", "Target": "filestoragecontainer" }, { From 902541c3520a7bb6c4a913b32390065c9da23657 Mon Sep 17 00:00:00 2001 From: raghuma777 <96498706+raghuma777@users.noreply.github.com> Date: Wed, 6 Nov 2024 11:16:45 -0600 Subject: [PATCH 174/308] addedapi --- api-reference/beta/resources/security-ediscoverycase.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/api-reference/beta/resources/security-ediscoverycase.md b/api-reference/beta/resources/security-ediscoverycase.md index 47bc2c1c652..7775cd0a051 100644 --- a/api-reference/beta/resources/security-ediscoverycase.md +++ b/api-reference/beta/resources/security-ediscoverycase.md @@ -23,6 +23,8 @@ In the context of eDiscovery, contains custodians, holds, searches, review sets, |[Get ediscoveryCase](../api/security-ediscoverycase-get.md)|[microsoft.graph.security.ediscoveryCase](../resources/security-ediscoverycase.md)|Read the properties and relationships of an [ediscoveryCase](../resources/security-ediscoverycase.md) object.| |[Update ediscoveryCase](../api/security-ediscoverycase-update.md)|[microsoft.graph.security.ediscoveryCase](../resources/security-ediscoverycase.md)|Update the properties of an [ediscoveryCase](../resources/security-ediscoverycase.md) object.| |[Delete ediscoveryCase](../api/security-casesroot-delete-ediscoverycases.md)|None|Delete an [ediscoveryCase](../resources/security-ediscoverycase.md) object.| +|[Close ediscoveryCase](../api/security-ediscoverycase-close.md)|None|Close an [ediscoveryCase](../resources/security-ediscoverycase.md) object.| +|[Reopen ediscoveryCase](../api/security-ediscoverycase-reopen.md)|None|Reopen an [ediscoveryCase](../resources/security-ediscoverycase.md) object.| |[List custodians](../api/security-ediscoverycase-list-custodians.md)|[microsoft.graph.security.ediscoveryCustodian](../resources/security-ediscoverycustodian.md) collection|Get the ediscoveryCustodian resources from the custodians navigation property.| |[Create ediscoveryCustodian](../api/security-ediscoverycase-post-custodians.md)|[microsoft.graph.security.ediscoveryCustodian](../resources/security-ediscoverycustodian.md)|Create a new ediscoveryCustodian object.| |[List legalHolds](../api/security-ediscoverycase-list-legalholds.md)|[microsoft.graph.security.ediscoveryHoldPolicy](../resources/security-ediscoveryholdpolicy.md) collection|Get the ediscoveryHoldPolicy resources from the legalHolds navigation property.| From 16c340916ae46a628edfc5044eff36df2ac8c358 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Wed, 6 Nov 2024 11:42:04 -0600 Subject: [PATCH 175/308] Adjust variable name corrected variable styling to match consistency of previous variable --- .../api/filestoragecontainer-delete-column.md | 2 +- ...curity-identitycontainer-delete-sensors.md | 113 ++++++++++++++++++ ...itycontainer-delete-sensors-permissions.md | 8 ++ .../get-pagetemplate-javascript-snippets.md | 17 +++ ...toragecontainer-delete-recyclebin-items.md | 85 +++++++++++++ ...estoragecontainer-list-recyclebin-items.md | 103 ++++++++++++++++ .../v1.0/api/recyclebin-list-item.md | 94 +++++++++++++++ ...namepronunciation-boundary-warning-note.md | 11 ++ 8 files changed, 432 insertions(+), 1 deletion(-) create mode 100755 api-reference/beta/api/security-identitycontainer-delete-sensors.md create mode 100755 api-reference/beta/includes/permissions/security-identitycontainer-delete-sensors-permissions.md create mode 100755 api-reference/beta/includes/snippets/javascript/get-pagetemplate-javascript-snippets.md create mode 100755 api-reference/v1.0/api/filestoragecontainer-delete-recyclebin-items.md create mode 100755 api-reference/v1.0/api/filestoragecontainer-list-recyclebin-items.md create mode 100755 api-reference/v1.0/api/recyclebin-list-item.md create mode 100755 includes/namepronunciation-boundary-warning-note.md diff --git a/api-reference/beta/api/filestoragecontainer-delete-column.md b/api-reference/beta/api/filestoragecontainer-delete-column.md index 1240d1f3f71..63535a7790d 100644 --- a/api-reference/beta/api/filestoragecontainer-delete-column.md +++ b/api-reference/beta/api/filestoragecontainer-delete-column.md @@ -34,7 +34,7 @@ Choose the permission or permissions marked as least privileged for this API. Us } --> ``` http -DELETE /storageContainers/{containerId}/columns/{column-id} +DELETE /storageContainers/{containerId}/columns/{columnId} ``` ## Request headers diff --git a/api-reference/beta/api/security-identitycontainer-delete-sensors.md b/api-reference/beta/api/security-identitycontainer-delete-sensors.md new file mode 100755 index 00000000000..74aed403e4e --- /dev/null +++ b/api-reference/beta/api/security-identitycontainer-delete-sensors.md @@ -0,0 +1,113 @@ +--- +title: "Delete sensor" +description: "Delete a sensor object." +author: "amirfeldman" +ms.localizationpriority: medium +ms.subservice: "security" +doc_type: apiPageType +ms.date: 09/10/2024 +--- + +# Delete sensor + +Namespace: microsoft.graph.security + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Delete a [sensor](../resources/security-sensor.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). + + +[!INCLUDE [permissions-table](../includes/permissions/security-identitycontainer-delete-sensors-permissions.md)] + +## HTTP request + + +``` http +DELETE /security/identities/sensors/{sensorId} +``` + +## 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 `204 No Content` response code. + +## Examples + +### Request + +The following example shows a request. +# [HTTP](#tab/http) + +``` http +DELETE https://graph.microsoft.com/beta/security/identities/sensors/d31dd827-92cd-4cd6-b269-c151a0eec55d +``` + +# [C#](#tab/csharp) +[!INCLUDE [sample-code](../includes/snippets/csharp/delete-sensor-csharp-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [CLI](#tab/cli) +[!INCLUDE [sample-code](../includes/snippets/cli/delete-sensor-cli-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Go](#tab/go) +[!INCLUDE [sample-code](../includes/snippets/go/delete-sensor-go-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Java](#tab/java) +[!INCLUDE [sample-code](../includes/snippets/java/delete-sensor-java-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [JavaScript](#tab/javascript) +[!INCLUDE [sample-code](../includes/snippets/javascript/delete-sensor-javascript-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [PHP](#tab/php) +[!INCLUDE [sample-code](../includes/snippets/php/delete-sensor-php-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [PowerShell](#tab/powershell) +[!INCLUDE [sample-code](../includes/snippets/powershell/delete-sensor-powershell-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Python](#tab/python) +[!INCLUDE [sample-code](../includes/snippets/python/delete-sensor-python-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +--- + +### Response + +The following example shows the response. + + +``` http +HTTP/1.1 204 No Content +``` diff --git a/api-reference/beta/includes/permissions/security-identitycontainer-delete-sensors-permissions.md b/api-reference/beta/includes/permissions/security-identitycontainer-delete-sensors-permissions.md new file mode 100755 index 00000000000..d8c95f88267 --- /dev/null +++ b/api-reference/beta/includes/permissions/security-identitycontainer-delete-sensors-permissions.md @@ -0,0 +1,8 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +ms.topic: include +ms.localizationpriority: medium +--- + +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/javascript/get-pagetemplate-javascript-snippets.md b/api-reference/beta/includes/snippets/javascript/get-pagetemplate-javascript-snippets.md new file mode 100755 index 00000000000..4bd45f0e6b9 --- /dev/null +++ b/api-reference/beta/includes/snippets/javascript/get-pagetemplate-javascript-snippets.md @@ -0,0 +1,17 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```javascript + +const options = { + authProvider, +}; + +const client = Client.init(options); + +let pageTemplate = await client.api('/sites/dd00d52e-0db7-4d5f-8269-90060ac688d1/pageTemplates/microsoft.graph.pageTemplate/f6ed8c43-9923-4c6c-ba09-9c32b8f10aeb') + .version('beta') + .get(); + +``` \ No newline at end of file diff --git a/api-reference/v1.0/api/filestoragecontainer-delete-recyclebin-items.md b/api-reference/v1.0/api/filestoragecontainer-delete-recyclebin-items.md new file mode 100755 index 00000000000..79c2f9f5d25 --- /dev/null +++ b/api-reference/v1.0/api/filestoragecontainer-delete-recyclebin-items.md @@ -0,0 +1,85 @@ +--- +title: "Delete recycleBinItems" +description: "Delete items from the fileStorageContainer recycleBin." +author: "harmoneddie" +ms.localizationpriority: medium +ms.subservice: "onedrive" +doc_type: apiPageType +--- + +# Delete recycleBinItems + +Namespace: microsoft.graph + +Permanently delete [recycleBinItem](../resources/recyclebinitem.md) objects from the [recycleBin](../resources/recyclebin.md) of a [fileStorageContainer](../resources/filestoragecontainer.md). Items deleted by this method can't be restored. + +## Permissions + +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). + + +[!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-delete-recyclebin-items-permissions.md)] + +## HTTP request + + +``` http +POST /storage/fileStorage/containers/{containerId}/recycleBin/items/delete +``` + +## 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 [recycleBinItem](../resources/recyclebinitem.md) objects to delete. + + +## Response + +If successful, this method returns a `204 No Content` response code. + +## Examples + +### Request + +The following example shows a request. + + +``` http +POST https://graph.microsoft.com/v1.0/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/recycleBin/items/delete +Content-Type: application/json + +{ + "ids": ["5d625d33-338c-4a77-a98a-3e287116440c", "73133853-48f2-4956-bc4a-03f8d1675042"] +} +``` +### Response + +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 204 No Content +``` + diff --git a/api-reference/v1.0/api/filestoragecontainer-list-recyclebin-items.md b/api-reference/v1.0/api/filestoragecontainer-list-recyclebin-items.md new file mode 100755 index 00000000000..476a500033d --- /dev/null +++ b/api-reference/v1.0/api/filestoragecontainer-list-recyclebin-items.md @@ -0,0 +1,103 @@ +--- +title: "List recycleBin items" +description: "Get a list of recycle bin items from a fileStorageContainer recycleBin." +author: "harmoneddie" +ms.localizationpriority: medium +ms.subservice: "onedrive" +doc_type: apiPageType +--- + +# List recycleBin items + +Namespace: microsoft.graph + +Get a list of [recycleBinItem](../resources/recyclebinitem.md) objects from the [recycleBin](../resources/recyclebin.md) of a [fileStorageContainer](../resources/filestoragecontainer.md). + +## Permissions + +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). + + +[!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-list-recyclebin-items-permissions.md)] + +## HTTP request + + + +``` http +GET /storage/fileStorage/containers/{containerId}/recycleBin/items +``` + +## 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 [recycleBinItem](../resources/recyclebinitem.md) objects in the response body. + +## Examples + +### Request + +The following example shows a request. + + +``` http +GET https://graph.microsoft.com/v1.0/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/recycleBin/items +``` + +### Response + +The following example shows the response. + +>**Note:** The response object shown here might be shortened for readability. + + + +``` http +HTTP/1.1 200 OK +Content-Type: application/json + +{ + "value": [ + { + "id": "5d625d33-338c-4a77-a98a-3e287116440c", + "name": "document.docx", + "size": 1024, + "deletedDateTime": "2022-04-25T20:11:51Z", + "title": "my document", + "deletedBy": { + "user": { + "displayName": "Tenant Admin User", + "id": "EBA7DBE0-B42F-4BC8-AEF6-97B66EFC77D0", + "userPrincipalName": "jhan@contoso.com" + } + } + } + ] +} +``` + diff --git a/api-reference/v1.0/api/recyclebin-list-item.md b/api-reference/v1.0/api/recyclebin-list-item.md new file mode 100755 index 00000000000..0cbffe2e44b --- /dev/null +++ b/api-reference/v1.0/api/recyclebin-list-item.md @@ -0,0 +1,94 @@ +--- +author: "vanshisingh" +title: "List item" +description: "Get a collection of recycleBinItem resources in the recycleBin of the specified SharePoint site." +ms.localizationpriority: "medium" +ms.subservice: "sharepoint" +doc_type: apiPageType +--- + +# List item + +Namespace: microsoft.graph + +Get a collection of [recycleBinItem](../resources/recyclebinitem.md) resources in the [recycleBin](../resources/recyclebin.md) of the specified SharePoint [site](../resources/site.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). + + +[!INCLUDE [permissions-table](../includes/permissions/recyclebin-list-items-permissions.md)] + +## HTTP request + + +``` http +GET /sites/{siteId}/recycleBin/items +``` + +## Optional query parameters + +This method supports the `$select` and `$top` OData query parameters to 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 [recycleBinItem](../resources/recyclebinitem.md) objects in the response body. + +## Examples + +### Request + +The following example shows a request to list all **recycleBinItem** resources under a specific site. + + +``` http +GET https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,48f1898f-77d9-4a1b-bddc-1f49bb6dc134,7206fc09-e4af-48b3-8730-ed7321396d7a/recycleBin/items +``` + +### Response + +The following example shows the response. + + +``` http +HTTP/1.1 200 OK +Content-Type: application/json + +{ + "value": [ + { + "id": "825e764f-c118-438f-b5c4-b8fbe60ab569", + "name": "file1.txt", + "size": 469, + "deletedDateTime": "2023-03-27T12:06:59Z", + "deletedFromLocation": "Shared Documents/folder1" + } + ] +} +``` + + diff --git a/includes/namepronunciation-boundary-warning-note.md b/includes/namepronunciation-boundary-warning-note.md new file mode 100755 index 00000000000..65f063c1961 --- /dev/null +++ b/includes/namepronunciation-boundary-warning-note.md @@ -0,0 +1,11 @@ +--- +author: fondieki +ms.topic: include +ms.date: 10/09/2024 +ms.localizationpriority: medium +--- + + + +> [!NOTE] +> Data is sent outside the Microsoft 365 data boundary to the Microsoft Defender Endpoint for malware scanning. By turning the toggle on, you're consenting to this data flow. Data is not stored outside the Microsoft 365 data boundary. From 7f075d41443048ed0c7c80a6b6203d736fcfb7ba Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Wed, 6 Nov 2024 12:55:18 -0600 Subject: [PATCH 176/308] Update filestoragecontainer-get-column.md Update casing consistency in variable name --- api-reference/v1.0/api/filestoragecontainer-get-column.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-get-column.md b/api-reference/v1.0/api/filestoragecontainer-get-column.md index 03d3e1c1ed5..fe825a2d9db 100644 --- a/api-reference/v1.0/api/filestoragecontainer-get-column.md +++ b/api-reference/v1.0/api/filestoragecontainer-get-column.md @@ -31,7 +31,7 @@ Choose the permission or permissions marked as least privileged for this API. Us } --> ``` http -GET /storageContainers/{containerId}/columns/{column-id} +GET /storageContainers/{containerId}/columns/{columnId} ``` ## Request headers From 03a81337d25323e34b23c72dcb327e65f031b5ba Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Wed, 6 Nov 2024 13:06:47 -0600 Subject: [PATCH 177/308] Update filestoragecontainer-lock.md Remove user and clarify the description --- api-reference/v1.0/api/filestoragecontainer-lock.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-lock.md b/api-reference/v1.0/api/filestoragecontainer-lock.md index bbff7ac509f..092718e9e3b 100644 --- a/api-reference/v1.0/api/filestoragecontainer-lock.md +++ b/api-reference/v1.0/api/filestoragecontainer-lock.md @@ -11,7 +11,7 @@ doc_type: apiPageType Namespace: microsoft.graph -Lock a [fileStorageContainer](../resources/filestoragecontainer.md) to prevent users from adding, updating, or deleting content. +Lock a [fileStorageContainer](../resources/filestoragecontainer.md) to prevent modifications to its contents. This action updates the [lockState](../resources/enums.md#sitelockstate-values). From c2be921ea21edfd227fa56f07ba0a957c9550861 Mon Sep 17 00:00:00 2001 From: Gautam Jain Date: Wed, 6 Nov 2024 11:07:31 -0800 Subject: [PATCH 178/308] pr comments fixes --- .../beta/api/copilotadminlimitedmode-get.md | 3 ++- .../api/copilotadminlimitedmode-update.md | 3 ++- .../beta/resources/copilotadminlimitedmode.md | 2 +- api-reference/beta/toc/toc.mapping.json | 20 ++++++------------- 4 files changed, 11 insertions(+), 17 deletions(-) diff --git a/api-reference/beta/api/copilotadminlimitedmode-get.md b/api-reference/beta/api/copilotadminlimitedmode-get.md index 5a94805bd1a..c784e342fe2 100644 --- a/api-reference/beta/api/copilotadminlimitedmode-get.md +++ b/api-reference/beta/api/copilotadminlimitedmode-get.md @@ -24,7 +24,8 @@ Choose the permission or permissions marked as least privileged for this API. Us "name": "copilotadminlimitedmode-get-permissions" } --> -Global admin or Global reader permission is required to call this API +> **Note:** Global admin or Global reader permission is required to call this API + |Permission type |Least privileged permissions|Higher privileged permissions| | --------------- |-----------------------------| --------------------------- | |Delegated (work or school account)|CopilotSettings-LimitedMode.Read|CopilotSettings-LimitedMode.ReadWrite| diff --git a/api-reference/beta/api/copilotadminlimitedmode-update.md b/api-reference/beta/api/copilotadminlimitedmode-update.md index 6e1270d66a8..3f57c04763c 100644 --- a/api-reference/beta/api/copilotadminlimitedmode-update.md +++ b/api-reference/beta/api/copilotadminlimitedmode-update.md @@ -24,7 +24,8 @@ Choose the permission or permissions marked as least privileged for this API. Us "name": "copilotadminlimitedmode-update-permissions" } --> -Global admin permission is required to call this API +> **Note:** Global admin or Global reader permission is required to call this API + |Permission type |Least privileged permissions|Higher privileged permissions| | --------------- |-----------------------------| --------------------------- | |Delegated (work or school account)|CopilotSettings-LimitedMode.ReadWrite| | diff --git a/api-reference/beta/resources/copilotadminlimitedmode.md b/api-reference/beta/resources/copilotadminlimitedmode.md index f7365d0dee6..aef7ef88c38 100644 --- a/api-reference/beta/resources/copilotadminlimitedmode.md +++ b/api-reference/beta/resources/copilotadminlimitedmode.md @@ -26,7 +26,7 @@ Inherits from [entity](../resources/entity.md). ## Properties |Property|Type|Description| |:---|:---|:---| -|isEnabledForGroup|BooleanEnables the user to be in limited mode for Copilot in Teams meetings. When copilotLimitedMode=true, users in this mode can ask any questions, but Copilot doesn't respond to certain questions related to inferring emotions, behavior, or judgments. When copilotLimitedMode=false, the current mode for Copilot, it responds to any types of questions grounded to the meeting conversation. The default value is false.| +|isEnabledForGroup|Boolean|Enables the user to be in limited mode for Copilot in Teams meetings. When copilotLimitedMode=true, users in this mode can ask any questions, but Copilot doesn't respond to certain questions related to inferring emotions, behavior, or judgments. When copilotLimitedMode=false, the current mode for Copilot, it responds to any types of questions grounded to the meeting conversation. The default value is false.| |groupId|String|The ID of a Microsoft Entra group, of which the value of isEnabledForGroup is applied value for its members. The default value is null. This parameter is optional. If isEnabledForGroup is set to true, groupId value must be provided and copilot limited mode is enabled for the members of the group| ## Relationships diff --git a/api-reference/beta/toc/toc.mapping.json b/api-reference/beta/toc/toc.mapping.json index 5701853321d..1b4b63002a7 100644 --- a/api-reference/beta/toc/toc.mapping.json +++ b/api-reference/beta/toc/toc.mapping.json @@ -2835,14 +2835,6 @@ "contentSharingSession", "participant", "addLargeGalleryViewOperation" - ], - "childNodes": [ - { - "name": "Copilot settings", - "resources": [ - "copilotAdminLimitedMode" - ] - } ] }, { @@ -2859,6 +2851,12 @@ "microsoft.graph.callRecords.smsLogRow" ] }, + { + "name": "Copilot settings", + "resources": [ + "copilotAdminLimitedMode" + ] + }, { "name": "Online meetings", "resources": [ @@ -2887,12 +2885,6 @@ "href": "../../api/virtualappointment-sendvirtualappointmentsms.md" } ] - }, - { - "name": "Copilot settings", - "resources": [ - "copilotAdminLimitedMode" - ] } ] }, From 7b2c9a7509a45201a0670b9aad1ab8cd7577b609 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Wed, 6 Nov 2024 13:08:25 -0600 Subject: [PATCH 179/308] Update filestoragecontainer-unlock.md Remove user and update description. --- api-reference/v1.0/api/filestoragecontainer-unlock.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-unlock.md b/api-reference/v1.0/api/filestoragecontainer-unlock.md index 57b18cc4606..35a67ac162f 100644 --- a/api-reference/v1.0/api/filestoragecontainer-unlock.md +++ b/api-reference/v1.0/api/filestoragecontainer-unlock.md @@ -11,7 +11,7 @@ doc_type: apiPageType Namespace: microsoft.graph -Unlock a [fileStorageContainer](../resources/filestoragecontainer.md) to allow users to add, update, or delete content. +Unlock a [fileStorageContainer](../resources/filestoragecontainer.md) to allow modifications of its content. This action updates the value of the **lockState** property. From de9f4f0b6a5e68b2db8d0ac6f66d874cbd879e55 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Wed, 6 Nov 2024 13:16:17 -0600 Subject: [PATCH 180/308] Update filestoragecontainer-post-columns.md Update to more precise language on line 14. --- api-reference/v1.0/api/filestoragecontainer-post-columns.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-post-columns.md b/api-reference/v1.0/api/filestoragecontainer-post-columns.md index 6d7ca623c8e..4fa520b55af 100644 --- a/api-reference/v1.0/api/filestoragecontainer-post-columns.md +++ b/api-reference/v1.0/api/filestoragecontainer-post-columns.md @@ -11,7 +11,7 @@ doc_type: apiPageType Namespace: microsoft.graph -Create a column for a [fileStorageContainer](../resources/filestoragecontainer.md) that specifies a [columnDefinition](../resources/columndefinition.md). +Create a columnDefinition for a [fileStorageContainer](../resources/filestoragecontainer.md) that specifies a [columnDefinition](../resources/columndefinition.md). [!INCLUDE [national-cloud-support](../../includes/global-only.md)] From b9b8088966f04c862054aa938cc7d1d0169a0b67 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Wed, 6 Nov 2024 13:19:36 -0600 Subject: [PATCH 181/308] Update filestoragecontainer-post.md update line 16 to state registered instead of enabled. --- api-reference/v1.0/api/filestoragecontainer-post.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-post.md b/api-reference/v1.0/api/filestoragecontainer-post.md index e3ee17d4cd1..72e6595becf 100644 --- a/api-reference/v1.0/api/filestoragecontainer-post.md +++ b/api-reference/v1.0/api/filestoragecontainer-post.md @@ -13,7 +13,7 @@ Namespace: microsoft.graph Create a new [fileStorageContainer](../resources/filestoragecontainer.md) object. -The respective container type identified by **containerTypeId** must be enabled in the tenant. +The respective container type identified by **containerTypeId** must be registered in the tenant. For delegated calls, the calling user is set as the owner of the **fileStorageContainer**. From df91f7cef8e6fb487b6d4f391a3a65cc1778d251 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Wed, 6 Nov 2024 13:21:32 -0600 Subject: [PATCH 182/308] Update filestoragecontainer-post.md Update line 55 to container. --- api-reference/v1.0/api/filestoragecontainer-post.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-post.md b/api-reference/v1.0/api/filestoragecontainer-post.md index 72e6595becf..1f16fa2d262 100644 --- a/api-reference/v1.0/api/filestoragecontainer-post.md +++ b/api-reference/v1.0/api/filestoragecontainer-post.md @@ -52,7 +52,7 @@ You can specify the following properties when you create a **fileStorageContaine |Property|Type|Description| |:---|:---|:---| |displayName|String|The display name of the container. Required.| -|description|String|Provides a user-visible description of the item. Optional.| +|description|String|Provides a user-visible description of the container. Optional.| |containerTypeId|GUID|The container type of the container instance. Required.| |settings|[fileStorageContainerSettings](../resources/filestoragecontainersettings.md)|Settings associated with the container. Optional.| From 8ace6b6e201872c0091ae91a2799b95fc34f4e05 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Wed, 6 Nov 2024 13:29:22 -0600 Subject: [PATCH 183/308] Update filestoragecontainer-unlock.md update line 14 --- api-reference/v1.0/api/filestoragecontainer-unlock.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-unlock.md b/api-reference/v1.0/api/filestoragecontainer-unlock.md index 35a67ac162f..2fe243327b8 100644 --- a/api-reference/v1.0/api/filestoragecontainer-unlock.md +++ b/api-reference/v1.0/api/filestoragecontainer-unlock.md @@ -11,7 +11,7 @@ doc_type: apiPageType Namespace: microsoft.graph -Unlock a [fileStorageContainer](../resources/filestoragecontainer.md) to allow modifications of its content. +Unlock a [fileStorageContainer](../resources/filestoragecontainer.md) for users and application-only identities to allow adding, updating, and deleting content. This action updates the value of the **lockState** property. From ab7e9ef997ddcdbcea5862fb7425570465bdafe0 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Wed, 6 Nov 2024 13:33:04 -0600 Subject: [PATCH 184/308] Update filestoragecontainer-update-column.md Updated line 34 for casing consistency. --- api-reference/v1.0/api/filestoragecontainer-update-column.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-update-column.md b/api-reference/v1.0/api/filestoragecontainer-update-column.md index b6c741e54e1..7aab4fd5520 100644 --- a/api-reference/v1.0/api/filestoragecontainer-update-column.md +++ b/api-reference/v1.0/api/filestoragecontainer-update-column.md @@ -31,7 +31,7 @@ Choose the permission or permissions marked as least privileged for this API. Us } --> ``` http -PATCH /storage/fileStorage/containers/{containerId}/columns/{column-id} +PATCH /storage/fileStorage/containers/{containerId}/columns/{columnId} ``` ## Request headers From 0e76a418147632942db1d572aba424c2c1f77ab0 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Wed, 6 Nov 2024 13:36:41 -0600 Subject: [PATCH 185/308] Update filestoragecontainer-update-recyclebinsettings.md Update from setting to settings --- .../v1.0/api/filestoragecontainer-update-recyclebinsettings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-update-recyclebinsettings.md b/api-reference/v1.0/api/filestoragecontainer-update-recyclebinsettings.md index 15cff764957..8b2280ba5ca 100644 --- a/api-reference/v1.0/api/filestoragecontainer-update-recyclebinsettings.md +++ b/api-reference/v1.0/api/filestoragecontainer-update-recyclebinsettings.md @@ -12,7 +12,7 @@ doc_type: apiPageType Namespace: microsoft.graph -Update the setting on the recycleBin for a [fileStorageContainer](../resources/filestoragecontainer.md) by making a PATCH request on the [recycleBinSettings](../resources/recyclebinsettings.md) resource. +Update the settings of one recycleBin for a [fileStorageContainer](../resources/filestoragecontainer.md) by making a PATCH request on the [recycleBinSettings](../resources/recyclebinsettings.md) resource. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] From f4b7b3df411d1ba3f5111848d98f5893caba723e Mon Sep 17 00:00:00 2001 From: Microsoft Graph DevX Tooling Date: Wed, 6 Nov 2024 19:44:48 +0000 Subject: [PATCH 186/308] Update reference TOC --- .../beta/toc/identity-and-access/toc.yml | 72 +++++++++---------- .../toc/teamwork-and-communications/toc.yml | 30 +++----- 2 files changed, 46 insertions(+), 56 deletions(-) diff --git a/api-reference/beta/toc/identity-and-access/toc.yml b/api-reference/beta/toc/identity-and-access/toc.yml index d0042867414..b1e99061122 100644 --- a/api-reference/beta/toc/identity-and-access/toc.yml +++ b/api-reference/beta/toc/identity-and-access/toc.yml @@ -380,6 +380,14 @@ items: href: ../../api/subscribedsku-get.md - name: List href: ../../api/subscribedsku-list.md + - name: Microsoft Entra admin center settings + items: + - name: Microsoft Entra admin center settings + href: ../../resources/uxsetting.md + - name: Get + href: ../../api/uxsetting-get.md + - name: Update + href: ../../api/uxsetting-update.md - name: Mobility management policy items: - name: Mobility management policy @@ -629,42 +637,6 @@ items: href: ../../api/tenantrelationship-findtenantinformationbydomainname.md - name: Find tenant by tenant ID href: ../../api/tenantrelationship-findtenantinformationbytenantid.md - - name: Trusted certificate authorities for apps (preview) - items: - - name: Certificate-based application configuration - items: - - name: Certificate-based application configuration - href: ../../resources/certificatebasedapplicationconfiguration.md - - name: List - href: ../../api/certificateauthoritypath-list-certificatebasedapplicationconfigurations.md - - name: Create - href: ../../api/certificateauthoritypath-post-certificatebasedapplicationconfigurations.md - - name: Get - href: ../../api/certificatebasedapplicationconfiguration-get.md - - name: Update - href: ../../api/certificatebasedapplicationconfiguration-update.md - - name: Certificate authority as entity - items: - - name: Certificate authority as entity - href: ../../resources/certificateauthorityasentity.md - - name: List - href: ../../api/certificatebasedapplicationconfiguration-list-trustedcertificateauthorities.md - - name: Create - href: ../../api/certificatebasedapplicationconfiguration-post-trustedcertificateauthorities.md - - name: Get - href: ../../api/certificateauthorityasentity-get.md - - name: Update - href: ../../api/certificateauthorityasentity-update.md - - name: Delete - href: ../../api/certificateauthorityasentity-delete.md - - name: Ux setting - items: - - name: Ux setting - href: ../../resources/uxsetting.md - - name: Get - href: ../../api/uxsetting-get.md - - name: Update - href: ../../api/uxsetting-update.md - name: Governance displayName: Identity Governance, Access reviews, Entitlement Management, Terms of Use, Privileged Identity Management, Microsoft Entra ID Governance items: @@ -3028,6 +3000,34 @@ items: href: ../../api/serviceprincipal-post-permissiongrantpreapprovalpolicies.md - name: Unassign from service principal href: ../../api/serviceprincipal-delete-permissiongrantpreapprovalpolicies.md + - name: Trusted certificate authorities for apps (preview) + items: + - name: Certificate-based application configuration + items: + - name: Certificate-based application configuration + href: ../../resources/certificatebasedapplicationconfiguration.md + - name: List + href: ../../api/certificateauthoritypath-list-certificatebasedapplicationconfigurations.md + - name: Create + href: ../../api/certificateauthoritypath-post-certificatebasedapplicationconfigurations.md + - name: Get + href: ../../api/certificatebasedapplicationconfiguration-get.md + - name: Update + href: ../../api/certificatebasedapplicationconfiguration-update.md + - name: Certificate authority as entity + items: + - name: Certificate authority as entity + href: ../../resources/certificateauthorityasentity.md + - name: List + href: ../../api/certificatebasedapplicationconfiguration-list-trustedcertificateauthorities.md + - name: Create + href: ../../api/certificatebasedapplicationconfiguration-post-trustedcertificateauthorities.md + - name: Get + href: ../../api/certificateauthorityasentity-get.md + - name: Update + href: ../../api/certificateauthorityasentity-update.md + - name: Delete + href: ../../api/certificateauthorityasentity-delete.md - name: User flows in external tenants items: - name: Authentication events flow diff --git a/api-reference/beta/toc/teamwork-and-communications/toc.yml b/api-reference/beta/toc/teamwork-and-communications/toc.yml index 97cf33fa5c2..07f9e6b8a8e 100644 --- a/api-reference/beta/toc/teamwork-and-communications/toc.yml +++ b/api-reference/beta/toc/teamwork-and-communications/toc.yml @@ -302,16 +302,6 @@ items: href: ../../resources/addlargegalleryviewoperation.md - name: Get large gallery view operation status href: ../../api/addlargegalleryviewoperation-get.md - - name: Copilot settings - items: - - name: Copilot admin limited mode - items: - - name: Copilot admin limited mode - href: ../../resources/copilotadminlimitedmode.md - - name: Get - href: ../../api/copilotadminlimitedmode-get.md - - name: Update - href: ../../api/copilotadminlimitedmode-update.md - name: Call records items: - name: Overview @@ -376,6 +366,16 @@ items: href: ../../resources/callrecords-smslogrow.md - name: Get SMS log href: ../../api/callrecords-callrecord-getsmslog.md + - name: Copilot settings + items: + - name: Copilot admin limited mode + items: + - name: Copilot admin limited mode + href: ../../resources/copilotadminlimitedmode.md + - name: Get + href: ../../api/copilotadminlimitedmode-get.md + - name: Update + href: ../../api/copilotadminlimitedmode-update.md - name: Online meetings items: - name: Meeting attendance report @@ -464,16 +464,6 @@ items: href: ../../api/virtualappointment-sendvirtualappointmentremindersms.md - name: Send virtual appointment SMS href: ../../api/virtualappointment-sendvirtualappointmentsms.md - - name: Copilot settings - items: - - name: Copilot admin limited mode - items: - - name: Copilot admin limited mode - href: ../../resources/copilotadminlimitedmode.md - - name: Get - href: ../../api/copilotadminlimitedmode-get.md - - name: Update - href: ../../api/copilotadminlimitedmode-update.md - name: Virtual events items: - name: Virtual event presenter From 927e49146953cab64e753676ac5119f69f7411d8 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Wed, 6 Nov 2024 13:51:25 -0600 Subject: [PATCH 187/308] Update recyclebinitem.md update line 14 to include SharePoint Embedded fileStorageContainer. --- api-reference/v1.0/resources/recyclebinitem.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/resources/recyclebinitem.md b/api-reference/v1.0/resources/recyclebinitem.md index dc452e4cf33..7b64b845310 100644 --- a/api-reference/v1.0/resources/recyclebinitem.md +++ b/api-reference/v1.0/resources/recyclebinitem.md @@ -11,7 +11,7 @@ ms.subservice: "sharepoint" Namespace: microsoft.graph -Represents information about a deleted item in a [recycleBin](recyclebin.md) of a SharePoint [site](site.md). +Represents information about a deleted item in a [recycleBin](recyclebin.md) of a SharePoint [site](site.md) or a SharePoint Embedded fileStorageContainer. Inherits from [baseItem](baseitem.md). From 5b53dcf6f97631f12d0543e8838bbf29a785a548 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Wed, 6 Nov 2024 16:14:29 -0600 Subject: [PATCH 188/308] Update filestoragecontainer-post.md Updated line 55 --- api-reference/v1.0/api/filestoragecontainer-post.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-post.md b/api-reference/v1.0/api/filestoragecontainer-post.md index 1f16fa2d262..4ef4d233c9b 100644 --- a/api-reference/v1.0/api/filestoragecontainer-post.md +++ b/api-reference/v1.0/api/filestoragecontainer-post.md @@ -52,7 +52,7 @@ You can specify the following properties when you create a **fileStorageContaine |Property|Type|Description| |:---|:---|:---| |displayName|String|The display name of the container. Required.| -|description|String|Provides a user-visible description of the container. Optional.| +|description|String|User-visible description of the container. Optional.| |containerTypeId|GUID|The container type of the container instance. Required.| |settings|[fileStorageContainerSettings](../resources/filestoragecontainersettings.md)|Settings associated with the container. Optional.| From 17ef99f85e85b6720f25b44f5733b5bf2e1432ed Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Wed, 6 Nov 2024 16:17:30 -0600 Subject: [PATCH 189/308] Update filestoragecontainer-post.md Removed the word respective on line 16 --- api-reference/v1.0/api/filestoragecontainer-post.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-post.md b/api-reference/v1.0/api/filestoragecontainer-post.md index 4ef4d233c9b..b98fa1d0b66 100644 --- a/api-reference/v1.0/api/filestoragecontainer-post.md +++ b/api-reference/v1.0/api/filestoragecontainer-post.md @@ -13,7 +13,7 @@ Namespace: microsoft.graph Create a new [fileStorageContainer](../resources/filestoragecontainer.md) object. -The respective container type identified by **containerTypeId** must be registered in the tenant. +The container type identified by **containerTypeId** must be registered in the tenant. For delegated calls, the calling user is set as the owner of the **fileStorageContainer**. From ded93a36d35aa3e68bacaacc301560947f136ae3 Mon Sep 17 00:00:00 2001 From: Diego Luces Date: Wed, 6 Nov 2024 17:48:54 -0600 Subject: [PATCH 190/308] Fix notes on fileStorageContainer update permissions API There was an incorrect note about the update permissions operation updating the permission ID. This is not accurate and has been removed. --- .../beta/api/filestoragecontainer-update-permissions.md | 2 +- .../v1.0/api/filestoragecontainer-update-permissions.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/api/filestoragecontainer-update-permissions.md b/api-reference/beta/api/filestoragecontainer-update-permissions.md index 08dfa0d5e19..fdd99940a29 100644 --- a/api-reference/beta/api/filestoragecontainer-update-permissions.md +++ b/api-reference/beta/api/filestoragecontainer-update-permissions.md @@ -14,7 +14,7 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Update an existing [permission](../resources/permission.md) on a [fileStorageContainer](../resources/filestoragecontainer.md) by making a PATCH request on the permission resource. Only the **roles** property can be updated. One role per user is supported. A new ID is generated for the updated permissions object. +Update an existing [permission](../resources/permission.md) on a [fileStorageContainer](../resources/filestoragecontainer.md) by making a PATCH request on the permission resource. Only the **roles** property can be updated. One role per user is supported. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] diff --git a/api-reference/v1.0/api/filestoragecontainer-update-permissions.md b/api-reference/v1.0/api/filestoragecontainer-update-permissions.md index de0f3b8892e..d9fbfcea06a 100644 --- a/api-reference/v1.0/api/filestoragecontainer-update-permissions.md +++ b/api-reference/v1.0/api/filestoragecontainer-update-permissions.md @@ -12,7 +12,7 @@ doc_type: apiPageType Namespace: microsoft.graph -Update an existing [permission](../resources/permission.md) on a [fileStorageContainer](../resources/filestoragecontainer.md) by making a PATCH request on the permission resource. Only the **roles** property can be updated. One role per user is supported. A new ID is generated for the updated permissions object. +Update an existing [permission](../resources/permission.md) on a [fileStorageContainer](../resources/filestoragecontainer.md) by making a PATCH request on the permission resource. Only the **roles** property can be updated. One role per user is supported. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] From 9a51f61dfc4d1bb8c61eae515d6b90cb8bbd5922 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Wed, 6 Nov 2024 18:04:24 -0600 Subject: [PATCH 191/308] Delete files Removed unnecessary files --- ...toragecontainer-delete-recyclebin-items.md | 85 --------------- ...estoragecontainer-list-recyclebin-items.md | 103 ------------------ 2 files changed, 188 deletions(-) delete mode 100755 api-reference/v1.0/api/filestoragecontainer-delete-recyclebin-items.md delete mode 100755 api-reference/v1.0/api/filestoragecontainer-list-recyclebin-items.md diff --git a/api-reference/v1.0/api/filestoragecontainer-delete-recyclebin-items.md b/api-reference/v1.0/api/filestoragecontainer-delete-recyclebin-items.md deleted file mode 100755 index 79c2f9f5d25..00000000000 --- a/api-reference/v1.0/api/filestoragecontainer-delete-recyclebin-items.md +++ /dev/null @@ -1,85 +0,0 @@ ---- -title: "Delete recycleBinItems" -description: "Delete items from the fileStorageContainer recycleBin." -author: "harmoneddie" -ms.localizationpriority: medium -ms.subservice: "onedrive" -doc_type: apiPageType ---- - -# Delete recycleBinItems - -Namespace: microsoft.graph - -Permanently delete [recycleBinItem](../resources/recyclebinitem.md) objects from the [recycleBin](../resources/recyclebin.md) of a [fileStorageContainer](../resources/filestoragecontainer.md). Items deleted by this method can't be restored. - -## Permissions - -Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). - - -[!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-delete-recyclebin-items-permissions.md)] - -## HTTP request - - -``` http -POST /storage/fileStorage/containers/{containerId}/recycleBin/items/delete -``` - -## 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 [recycleBinItem](../resources/recyclebinitem.md) objects to delete. - - -## Response - -If successful, this method returns a `204 No Content` response code. - -## Examples - -### Request - -The following example shows a request. - - -``` http -POST https://graph.microsoft.com/v1.0/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/recycleBin/items/delete -Content-Type: application/json - -{ - "ids": ["5d625d33-338c-4a77-a98a-3e287116440c", "73133853-48f2-4956-bc4a-03f8d1675042"] -} -``` -### Response - -The following example shows the response. ->**Note:** The response object shown here might be shortened for readability. - -``` http -HTTP/1.1 204 No Content -``` - diff --git a/api-reference/v1.0/api/filestoragecontainer-list-recyclebin-items.md b/api-reference/v1.0/api/filestoragecontainer-list-recyclebin-items.md deleted file mode 100755 index 476a500033d..00000000000 --- a/api-reference/v1.0/api/filestoragecontainer-list-recyclebin-items.md +++ /dev/null @@ -1,103 +0,0 @@ ---- -title: "List recycleBin items" -description: "Get a list of recycle bin items from a fileStorageContainer recycleBin." -author: "harmoneddie" -ms.localizationpriority: medium -ms.subservice: "onedrive" -doc_type: apiPageType ---- - -# List recycleBin items - -Namespace: microsoft.graph - -Get a list of [recycleBinItem](../resources/recyclebinitem.md) objects from the [recycleBin](../resources/recyclebin.md) of a [fileStorageContainer](../resources/filestoragecontainer.md). - -## Permissions - -Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). - - -[!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-list-recyclebin-items-permissions.md)] - -## HTTP request - - - -``` http -GET /storage/fileStorage/containers/{containerId}/recycleBin/items -``` - -## 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 [recycleBinItem](../resources/recyclebinitem.md) objects in the response body. - -## Examples - -### Request - -The following example shows a request. - - -``` http -GET https://graph.microsoft.com/v1.0/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/recycleBin/items -``` - -### Response - -The following example shows the response. - ->**Note:** The response object shown here might be shortened for readability. - - - -``` http -HTTP/1.1 200 OK -Content-Type: application/json - -{ - "value": [ - { - "id": "5d625d33-338c-4a77-a98a-3e287116440c", - "name": "document.docx", - "size": 1024, - "deletedDateTime": "2022-04-25T20:11:51Z", - "title": "my document", - "deletedBy": { - "user": { - "displayName": "Tenant Admin User", - "id": "EBA7DBE0-B42F-4BC8-AEF6-97B66EFC77D0", - "userPrincipalName": "jhan@contoso.com" - } - } - } - ] -} -``` - From 89384184c3d25ace3c020afd18d6577ef697e53a Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Wed, 6 Nov 2024 18:35:47 -0600 Subject: [PATCH 192/308] Update filestoragecontainer-post.md --- api-reference/beta/api/filestoragecontainer-post.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/api-reference/beta/api/filestoragecontainer-post.md b/api-reference/beta/api/filestoragecontainer-post.md index 7ef1939502c..6a343d79f88 100644 --- a/api-reference/beta/api/filestoragecontainer-post.md +++ b/api-reference/beta/api/filestoragecontainer-post.md @@ -37,6 +37,13 @@ Choose the permission or permissions marked as least privileged for this API. Us ``` http POST /storage/fileStorage/containers ``` +## Optional query parameters + +This method supports the following OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). + +| Name |Description| +|:----------|:----------| +| placerholder | Use the `$select` query parameter to return a set of properties that are different than the default set for an individual resource or a collection of resources. Only supported for `callRecord` and `session` resources. | ## Request headers |Name|Description| From ac2a46050c5bffe7238953a3776bf20bf6e903f5 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Wed, 6 Nov 2024 18:44:40 -0600 Subject: [PATCH 193/308] Update filestoragecontainer-post.md Add dataLocation parameter description. --- api-reference/beta/api/filestoragecontainer-post.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/api/filestoragecontainer-post.md b/api-reference/beta/api/filestoragecontainer-post.md index 6a343d79f88..a9f742bf481 100644 --- a/api-reference/beta/api/filestoragecontainer-post.md +++ b/api-reference/beta/api/filestoragecontainer-post.md @@ -43,7 +43,7 @@ This method supports the following OData query parameters to help customize the | Name |Description| |:----------|:----------| -| placerholder | Use the `$select` query parameter to return a set of properties that are different than the default set for an individual resource or a collection of resources. Only supported for `callRecord` and `session` resources. | +| dataLocation | Use the `$dataLocation` query parameter to select the desired data locatiion for container creation. Omitting the `$dataLocation` parameter in the Graph Storage Container creation request will default the creation of the container to a tenant’s default geography. | ## Request headers |Name|Description| From e09af6fd726f828c569d0ef5da839b199ce21cea Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Wed, 6 Nov 2024 18:48:58 -0600 Subject: [PATCH 194/308] Update filestoragecontainer-post.md Add dataLocation description to V1 --- api-reference/v1.0/api/filestoragecontainer-post.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/api-reference/v1.0/api/filestoragecontainer-post.md b/api-reference/v1.0/api/filestoragecontainer-post.md index b98fa1d0b66..0e95734013f 100644 --- a/api-reference/v1.0/api/filestoragecontainer-post.md +++ b/api-reference/v1.0/api/filestoragecontainer-post.md @@ -37,6 +37,13 @@ Choose the permission or permissions marked as least privileged for this API. Us ``` http POST /storage/fileStorage/containers ``` +## Optional query parameters + +This method supports the following OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). + +| Name |Description| +|:----------|:----------| +| dataLocation | Use the `$dataLocation` query parameter to select the desired data locatiion for container creation. Omitting the `$dataLocation` parameter in the Graph Storage Container creation request will default the creation of the container to a tenant’s default geography. | ## Request headers |Name|Description| From 1a1402168fb42d262ab0533d717cc167d88e4f3b Mon Sep 17 00:00:00 2001 From: Tony Chan <107155297+tonchan-msft@users.noreply.github.com> Date: Wed, 6 Nov 2024 17:19:20 -0800 Subject: [PATCH 195/308] Update filestoragecontainer-update-customproperty.md --- .../v1.0/api/filestoragecontainer-update-customproperty.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-update-customproperty.md b/api-reference/v1.0/api/filestoragecontainer-update-customproperty.md index 86a7128ddd8..c3720a51482 100644 --- a/api-reference/v1.0/api/filestoragecontainer-update-customproperty.md +++ b/api-reference/v1.0/api/filestoragecontainer-update-customproperty.md @@ -15,7 +15,7 @@ Update one or multiple custom properties on a [fileStorageContainer](../resource Updating a custom property to a `null` value deletes the property from the container. -The application calling this API must have read/write permissions to the **fileStorageContainer** for the respective container type. +The application calling this API must have read and write permissions to the **fileStorageContainer** for the respective container type. ## 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). From 7f609f1c309f66d724abd3a2fa04b1d3c2c35e6c Mon Sep 17 00:00:00 2001 From: Tony Chan <107155297+tonchan-msft@users.noreply.github.com> Date: Wed, 6 Nov 2024 17:19:51 -0800 Subject: [PATCH 196/308] Update filestoragecontainer-update-customproperty.md --- .../beta/api/filestoragecontainer-update-customproperty.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/api/filestoragecontainer-update-customproperty.md b/api-reference/beta/api/filestoragecontainer-update-customproperty.md index c4342869528..4bbd9f60a26 100644 --- a/api-reference/beta/api/filestoragecontainer-update-customproperty.md +++ b/api-reference/beta/api/filestoragecontainer-update-customproperty.md @@ -17,7 +17,7 @@ Update one or multiple custom properties on a [fileStorageContainer](../resource Updating a custom property to a `null` value deletes the property from the container. -The application calling this API must have read/write permissions to the **fileStorageContainer** for the respective container type. +The application calling this API must have read and write permissions to the **fileStorageContainer** for the respective container type. ## 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). From 1df2d6ee0a23a5b9ad2793438c934fe830582613 Mon Sep 17 00:00:00 2001 From: Tony Chan <107155297+tonchan-msft@users.noreply.github.com> Date: Wed, 6 Nov 2024 17:38:18 -0800 Subject: [PATCH 197/308] Update filestoragecontainer-post.md --- api-reference/v1.0/api/filestoragecontainer-post.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-post.md b/api-reference/v1.0/api/filestoragecontainer-post.md index 0e95734013f..c4f9759dba3 100644 --- a/api-reference/v1.0/api/filestoragecontainer-post.md +++ b/api-reference/v1.0/api/filestoragecontainer-post.md @@ -43,7 +43,7 @@ This method supports the following OData query parameters to help customize the | Name |Description| |:----------|:----------| -| dataLocation | Use the `$dataLocation` query parameter to select the desired data locatiion for container creation. Omitting the `$dataLocation` parameter in the Graph Storage Container creation request will default the creation of the container to a tenant’s default geography. | +| dataLocation | Use the `$dataLocation` query parameter to specify the desired data location for container creation in Multi-Geo tenants. Omitting the `$dataLocation` parameter in the request will create the container at the tenant's default location. Learn more about [available Multi-Geo regions and their location codes](https://learn.microsoft.com/en-us/microsoft-365/enterprise/microsoft-365-multi-geo?view=o365-worldwide#microsoft-365-multi-geo-availability). | ## Request headers |Name|Description| From ae4df8c2d8ea37d1d97f5e47a23ded7acd1b690d Mon Sep 17 00:00:00 2001 From: raghuma777 <96498706+raghuma777@users.noreply.github.com> Date: Thu, 7 Nov 2024 11:16:05 -0600 Subject: [PATCH 198/308] removedreviewsetapi --- api-reference/beta/api/security-ediscoverycustodian-get.md | 1 - 1 file changed, 1 deletion(-) diff --git a/api-reference/beta/api/security-ediscoverycustodian-get.md b/api-reference/beta/api/security-ediscoverycustodian-get.md index d04fa6ec6aa..3e915919303 100644 --- a/api-reference/beta/api/security-ediscoverycustodian-get.md +++ b/api-reference/beta/api/security-ediscoverycustodian-get.md @@ -30,7 +30,6 @@ Choose the permission or permissions marked as least privileged for this API. Us --> ``` http GET /security/cases/ediscoveryCases/{ediscoveryCaseId}/custodians/{ediscoveryCustodianId} -GET /security/cases/ediscoveryCases/{ediscoveryCaseId}/reviewSets/{ediscoveryReviewSetId}/files/{ediscoveryFileId}/custodian ``` ## Optional query parameters From 95638efff69371937b241f8f87d8d76deb98a943 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Thu, 7 Nov 2024 13:17:18 -0600 Subject: [PATCH 199/308] Update filestoragecontainer-delete-column.md changed line 35 --- api-reference/v1.0/api/filestoragecontainer-delete-column.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-delete-column.md b/api-reference/v1.0/api/filestoragecontainer-delete-column.md index 1e4124d40d7..856daf0d0f0 100644 --- a/api-reference/v1.0/api/filestoragecontainer-delete-column.md +++ b/api-reference/v1.0/api/filestoragecontainer-delete-column.md @@ -32,7 +32,7 @@ Choose the permission or permissions marked as least privileged for this API. Us } --> ``` http -DELETE /storageContainers/{containerId}/columns/{column-id} +DELETE /storageContainers/{containerId}/columns/{columnId} ``` ## Request headers From 29c6c741c898ab37f0c36c20a33834399d8673c9 Mon Sep 17 00:00:00 2001 From: Tony Chan <107155297+tonchan-msft@users.noreply.github.com> Date: Thu, 7 Nov 2024 11:18:05 -0800 Subject: [PATCH 200/308] Update filestoragecontainer-delete-column.md --- .../api/filestoragecontainer-delete-column.md | 16 +--------------- 1 file changed, 1 insertion(+), 15 deletions(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-delete-column.md b/api-reference/v1.0/api/filestoragecontainer-delete-column.md index 856daf0d0f0..17c9a6745a0 100644 --- a/api-reference/v1.0/api/filestoragecontainer-delete-column.md +++ b/api-reference/v1.0/api/filestoragecontainer-delete-column.md @@ -62,21 +62,7 @@ The following example shows a request. --> ``` http DELETE https://graph.microsoft.com/v1.0/storageContainers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/columns/99ddcf45-e2f7-4f17-82b0-6fba34445103 -Content-Type: application/json - -{ - "description": "test", - "enforceUniqueValues": false, - "hidden": false, - "indexed": false, - "name": "Title", - "text": { - "allowMultipleLines": false, - "appendChangesToExistingText": false, - "linesForEditing": 0, - "maxLength": 255 - } -} + ``` From d8f34978e81016ee2f4be9862522036119f283d5 Mon Sep 17 00:00:00 2001 From: jingqiang Date: Fri, 8 Nov 2024 10:57:51 +0800 Subject: [PATCH 201/308] fix time --- changelog/Microsoft.CloudManagedDesktop.json | 36 ++++++++++---------- 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/changelog/Microsoft.CloudManagedDesktop.json b/changelog/Microsoft.CloudManagedDesktop.json index 9a878fb6568..9c8da2ba237 100644 --- a/changelog/Microsoft.CloudManagedDesktop.json +++ b/changelog/Microsoft.CloudManagedDesktop.json @@ -1,5 +1,23 @@ { "changelog": [ + { + "ChangeList": [ + { + "Id": "8efd6ed8-dce5-4fb2-b59d-06a05d851029", + "ApiChange": "Method", + "ChangedApiName": "apply", + "ChangeType": "Addition", + "Description": "Added the **reservePercentage** to the [apply](https://learn.microsoft.com/en-us/graph/api/cloudpcprovisioningpolicy-apply?view=graph-rest-beta) method.", + "Target": "cloudPcProvisioningPolicy" + } + ], + "Id": "8efd6ed8-dce5-4fb2-b59d-06a05d851029", + "Cloud": "Prod", + "Version": "beta", + "CreatedDateTime": "2024-11-15T10:25:21.3434973Z", + "WorkloadArea": "Device and app management", + "SubArea": "Cloud PC" + }, { "ChangeList": [ { @@ -324,24 +342,6 @@ "WorkloadArea": "Device and app management", "SubArea": "Cloud PC" }, - { - "ChangeList": [ - { - "Id": "8efd6ed8-dce5-4fb2-b59d-06a05d851029", - "ApiChange": "Method", - "ChangedApiName": "apply", - "ChangeType": "Addition", - "Description": "Added the **reservePercentage** to the [apply](https://learn.microsoft.com/en-us/graph/api/cloudpcprovisioningpolicy-apply?view=graph-rest-beta) method.", - "Target": "cloudPcProvisioningPolicy" - } - ], - "Id": "8efd6ed8-dce5-4fb2-b59d-06a05d851029", - "Cloud": "Prod", - "Version": "beta", - "CreatedDateTime": "2024-09-15T10:25:21.3434973Z", - "WorkloadArea": "Device and app management", - "SubArea": "Cloud PC" - }, { "ChangeList": [ { From 0b20406f4b8f047bd9abd7b444322e31a631b4a4 Mon Sep 17 00:00:00 2001 From: mnorman-ms Date: Fri, 8 Nov 2024 10:47:58 +0700 Subject: [PATCH 202/308] Acrolinx and review pass. --- api-reference/beta/api/cloudpcprovisioningpolicy-apply.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/api/cloudpcprovisioningpolicy-apply.md b/api-reference/beta/api/cloudpcprovisioningpolicy-apply.md index ed2796e6f84..fb35b88cf8a 100644 --- a/api-reference/beta/api/cloudpcprovisioningpolicy-apply.md +++ b/api-reference/beta/api/cloudpcprovisioningpolicy-apply.md @@ -50,8 +50,8 @@ The following table shows the parameter that you can use with this method. |Parameter|Type|Description| |:---|:---|:---| -|policySettings|cloudPcPolicySettingType|The target property of this apply action. Possible values are: `region`, `singleSignOn`, `unknownFutureValue`. The default value is `region`. This action applies `region` as a value if this parameter is `null`.| -|reservePercentage|Int32|For `Frontline shared` only. Administrators can set a value (0-99) to keep a percentage of Cloud PCs available. Cloud PCs are reprovisioned only when there are no active and connected Cloud PC users.| +|policySettings|cloudPcPolicySettingType|The target property of the apply action. Possible values are: `region`, `singleSignOn`, `unknownFutureValue`. The default value is `region`. This action applies `region` as a value if this parameter is `null`.| +|reservePercentage|Int32|For `Frontline shared` only. The percentage of Cloud PCs to keep available. Administrators can set this property to a value from 0 to 99. Cloud PCs are reprovisioned only when there are no active and connected Cloud PC users.| ## Response From 58f2f698dc1eaccde92e6ca93fd849500e54386b Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Fri, 8 Nov 2024 10:30:43 -0600 Subject: [PATCH 203/308] Apply suggestions from code review --- api-reference/beta/api/copilotadminlimitedmode-get.md | 2 +- api-reference/beta/api/copilotadminlimitedmode-update.md | 2 +- changelog/Microsoft.CopilotSettings.json | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/api-reference/beta/api/copilotadminlimitedmode-get.md b/api-reference/beta/api/copilotadminlimitedmode-get.md index c784e342fe2..f3488f68c93 100644 --- a/api-reference/beta/api/copilotadminlimitedmode-get.md +++ b/api-reference/beta/api/copilotadminlimitedmode-get.md @@ -1,5 +1,5 @@ --- -title: "Get Copilot LimitedMode" +title: "Get copilotLimitedMode" description: "Read the properties and relationships of a copilotAdminLimitedMode object." author: "gautamjain14" ms.localizationpriority: medium diff --git a/api-reference/beta/api/copilotadminlimitedmode-update.md b/api-reference/beta/api/copilotadminlimitedmode-update.md index 3f57c04763c..23503865075 100644 --- a/api-reference/beta/api/copilotadminlimitedmode-update.md +++ b/api-reference/beta/api/copilotadminlimitedmode-update.md @@ -1,5 +1,5 @@ --- -title: "Update Copilot LimitedMode" +title: "Update copilotLimitedMode" description: "Update the properties of a copilotAdminLimitedMode object." author: "gautamjain14" ms.localizationpriority: medium diff --git a/changelog/Microsoft.CopilotSettings.json b/changelog/Microsoft.CopilotSettings.json index d2101d4834d..e7764d27d01 100644 --- a/changelog/Microsoft.CopilotSettings.json +++ b/changelog/Microsoft.CopilotSettings.json @@ -15,7 +15,7 @@ "ApiChange": "Resource", "ChangedApiName": "copilotAdminLimitedMode", "ChangeType": "Addition", - "Description": "Added the [copilotAdminLimitedMode](https://learn.microsoft.com/en-us/graph/api/resources/copilotAdminLimitedMode?view=graph-rest-beta) resource.", + "Description": "Added the [copilotAdminLimitedMode](https://learn.microsoft.com/en-us/graph/api/resources/copilotAdminLimitedMode?view=graph-rest-beta) resource and its methods.", "Target": "copilotAdminLimitedMode" }, { From da81c02c6986053c0cfc5e678e5938c717154660 Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Fri, 8 Nov 2024 10:47:22 -0600 Subject: [PATCH 204/308] Apply suggestions from code review --- api-reference/beta/api/copilotadminlimitedmode-get.md | 2 +- api-reference/beta/api/copilotadminlimitedmode-update.md | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/api-reference/beta/api/copilotadminlimitedmode-get.md b/api-reference/beta/api/copilotadminlimitedmode-get.md index f3488f68c93..654ccf4f3de 100644 --- a/api-reference/beta/api/copilotadminlimitedmode-get.md +++ b/api-reference/beta/api/copilotadminlimitedmode-get.md @@ -24,7 +24,7 @@ Choose the permission or permissions marked as least privileged for this API. Us "name": "copilotadminlimitedmode-get-permissions" } --> -> **Note:** Global admin or Global reader permission is required to call this API +> **Note:** Global admin or Global reader permission is required to call this API. |Permission type |Least privileged permissions|Higher privileged permissions| | --------------- |-----------------------------| --------------------------- | diff --git a/api-reference/beta/api/copilotadminlimitedmode-update.md b/api-reference/beta/api/copilotadminlimitedmode-update.md index 23503865075..5fc8343b72a 100644 --- a/api-reference/beta/api/copilotadminlimitedmode-update.md +++ b/api-reference/beta/api/copilotadminlimitedmode-update.md @@ -24,7 +24,7 @@ Choose the permission or permissions marked as least privileged for this API. Us "name": "copilotadminlimitedmode-update-permissions" } --> -> **Note:** Global admin or Global reader permission is required to call this API +> **Note:** Global admin or Global reader permission is required to call this API. |Permission type |Least privileged permissions|Higher privileged permissions| | --------------- |-----------------------------| --------------------------- | @@ -53,8 +53,8 @@ PATCH /copilot/admin/settings/limitedMode |Property|Type|Description| |:---|:---|:---| -|isEnabledForGroup|Boolean|Enables the user to be in limited mode for Copilot in Teams meetings. When copilotLimitedMode=true, users in this mode can ask any questions, but Copilot doesn't respond to certain questions related to inferring emotions, behavior, or judgments. When copilotLimitedMode=false, the current mode for Copilot, it responds to any types of questions grounded to the meeting conversation. The default value is false.| -|groupId|String|The ID of a Microsoft Entra group, of which the value of isEnabledForGroup is applied value for its members. The default value is null. This parameter is optional. If isEnabledForGroup is set to true, groupId value must be provided and copilot limited mode is enabled for the members of the group| +|isEnabledForGroup|Boolean|Enables the user to be in limited mode for Copilot in Teams meetings. When copilotLimitedMode=true, users in this mode can ask any questions, but Copilot doesn't respond to certain questions related to inferring emotions, behavior, or judgments. When copilotLimitedMode=false, the current mode for Copilot, it responds to any types of questions grounded to the meeting conversation. The default value is `false`.| +|groupId|String|The ID of a Microsoft Entra group, of which the value of `isEnabledForGroup` is applied value for its members. The default value is `null`. This parameter is optional. If `isEnabledForGroup` is set to true, the `groupId` value must be provided for the copilotLimitedMode to be enabled for the members of the group.| ## Response From 70a650f81de50b610ee5b69d85618a2bd3a73c63 Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Fri, 8 Nov 2024 10:49:55 -0600 Subject: [PATCH 205/308] Apply suggestions from code review --- api-reference/beta/resources/copilotadminlimitedmode.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/copilotadminlimitedmode.md b/api-reference/beta/resources/copilotadminlimitedmode.md index aef7ef88c38..d4133ad2f17 100644 --- a/api-reference/beta/resources/copilotadminlimitedmode.md +++ b/api-reference/beta/resources/copilotadminlimitedmode.md @@ -27,7 +27,7 @@ Inherits from [entity](../resources/entity.md). |Property|Type|Description| |:---|:---|:---| |isEnabledForGroup|Boolean|Enables the user to be in limited mode for Copilot in Teams meetings. When copilotLimitedMode=true, users in this mode can ask any questions, but Copilot doesn't respond to certain questions related to inferring emotions, behavior, or judgments. When copilotLimitedMode=false, the current mode for Copilot, it responds to any types of questions grounded to the meeting conversation. The default value is false.| -|groupId|String|The ID of a Microsoft Entra group, of which the value of isEnabledForGroup is applied value for its members. The default value is null. This parameter is optional. If isEnabledForGroup is set to true, groupId value must be provided and copilot limited mode is enabled for the members of the group| +|groupId|String|The ID of a Microsoft Entra group, of which the value of `isEnabledForGroup` is applied value for its members. The default value is `null`. This parameter is optional. If `isEnabledForGroup` is set to true, the `groupId` value must be provided for the copilotLimitedMode to be enabled for the members of the group ## Relationships None. From b2380194bdb573afadce66bcf2e30724ef1a65c9 Mon Sep 17 00:00:00 2001 From: Gautam Jain Date: Fri, 8 Nov 2024 09:19:13 -0800 Subject: [PATCH 206/308] pr comments fixed --- api-reference/beta/api/copilotadminlimitedmode-get.md | 4 ++-- api-reference/beta/api/copilotadminlimitedmode-update.md | 4 ++-- api-reference/beta/resources/copilotadmin.md | 6 +++--- api-reference/beta/resources/copilotadminsetting.md | 6 +++--- api-reference/beta/resources/copilotroot.md | 6 +++--- 5 files changed, 13 insertions(+), 13 deletions(-) diff --git a/api-reference/beta/api/copilotadminlimitedmode-get.md b/api-reference/beta/api/copilotadminlimitedmode-get.md index 654ccf4f3de..807dd229d0e 100644 --- a/api-reference/beta/api/copilotadminlimitedmode-get.md +++ b/api-reference/beta/api/copilotadminlimitedmode-get.md @@ -29,8 +29,8 @@ Choose the permission or permissions marked as least privileged for this API. Us |Permission type |Least privileged permissions|Higher privileged permissions| | --------------- |-----------------------------| --------------------------- | |Delegated (work or school account)|CopilotSettings-LimitedMode.Read|CopilotSettings-LimitedMode.ReadWrite| -|Delegated (personal Microsoft account)|Not supported| | -|Application|Not supported| | +|Delegated (personal Microsoft account)|Not supported|Not supported| +|Application|Not supported|Not supported| ## HTTP request diff --git a/api-reference/beta/api/copilotadminlimitedmode-update.md b/api-reference/beta/api/copilotadminlimitedmode-update.md index 5fc8343b72a..43e5d2a6b0b 100644 --- a/api-reference/beta/api/copilotadminlimitedmode-update.md +++ b/api-reference/beta/api/copilotadminlimitedmode-update.md @@ -29,8 +29,8 @@ Choose the permission or permissions marked as least privileged for this API. Us |Permission type |Least privileged permissions|Higher privileged permissions| | --------------- |-----------------------------| --------------------------- | |Delegated (work or school account)|CopilotSettings-LimitedMode.ReadWrite| | -|Delegated (personal Microsoft account)|Not supported| | -|Application|Not supported| | +|Delegated (personal Microsoft account)|Not supported|Not supported| +|Application|Not supported|Not supported| ## HTTP request diff --git a/api-reference/beta/resources/copilotadmin.md b/api-reference/beta/resources/copilotadmin.md index e08e695c5a9..3a0870f93fb 100644 --- a/api-reference/beta/resources/copilotadmin.md +++ b/api-reference/beta/resources/copilotadmin.md @@ -1,6 +1,6 @@ --- title: "copilotAdmin resource type" -description: "Navigation property for copilotAdmin" +description: "Represents a navigation property for Copilot admin. Copilot admin can add or modify Copilot settings." author: "gautamjain14" ms.localizationpriority: medium ms.subservice: "meetings-copilot" @@ -13,7 +13,7 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Navigation property for `copilotAdmin` +Represents a navigation property for Copilot admin. Copilot admin can add or modify Copilot settings. Inherits from [entity](../resources/entity.md). @@ -21,7 +21,7 @@ Inherits from [entity](../resources/entity.md). ## Relationships |Relationship|Type|Description| |:---|:---|:---| -|settings|[copilotAdminSetting](../resources/copilotadminsetting.md)|Navigation property for `settings`| +|settings|[Settings](../resources/copilotadminsetting.md)|Set of Copilot settings that can be added or modified.. Navigation property. Read-only. Nullable.| ## JSON representation The following JSON representation shows the resource type. diff --git a/api-reference/beta/resources/copilotadminsetting.md b/api-reference/beta/resources/copilotadminsetting.md index bca39e4da57..dd68e7bce48 100644 --- a/api-reference/beta/resources/copilotadminsetting.md +++ b/api-reference/beta/resources/copilotadminsetting.md @@ -1,6 +1,6 @@ --- title: "copilotAdminSetting resource type" -description: "Navigation property for copilotAdminSettings" +description: "Represents a navigation property for set of Copilot settings." author: "gautamjain14" ms.localizationpriority: medium ms.subservice: "meetings-copilot" @@ -13,7 +13,7 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Navigation property for `copilotAdminSettings` +Represents a navigation property for Copilot settings. Inherits from [entity](../resources/entity.md). @@ -21,7 +21,7 @@ Inherits from [entity](../resources/entity.md). ## Relationships |Relationship|Type|Description| |:---|:---|:---| -|limitedMode|[copilotAdminLimitedMode](../resources/copilotadminlimitedmode.md)|Navigation property for `limitedMode`| +|limitedMode|[LimitedMode](../resources/copilotadminlimitedmode.md)|Add or modify copilot limited mode. Navigation property. Read-only. Nullable.| ## JSON representation The following JSON representation shows the resource type. diff --git a/api-reference/beta/resources/copilotroot.md b/api-reference/beta/resources/copilotroot.md index d9ed713b9f2..b7d1126e123 100644 --- a/api-reference/beta/resources/copilotroot.md +++ b/api-reference/beta/resources/copilotroot.md @@ -1,6 +1,6 @@ --- title: "copilotRoot resource type" -description: "Navigation property for copilotRoot" +description: "Represents a navigation property for Copilot controls." author: "gautamjain14" ms.localizationpriority: medium ms.subservice: "meetings-copilot" @@ -13,12 +13,12 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Navigation property for `copilotRoot` +Represents a navigation property for Copilot controls. ## Relationships |Relationship|Type|Description| |:---|:---|:---| -|admin|[copilotAdmin](../resources/copilotadmin.md)|Navigation property for `copilotAdmin`| +|admin|[Admin](../resources/copilotadmin.md)|Copilot admin can add or modify Copilot settings. Navigation property. Read-only. Nullable.| ## JSON representation The following JSON representation shows the resource type. From 29cef7ffb50bebcf8cb5da52bb67d0aa4b496d3b Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Fri, 8 Nov 2024 11:37:59 -0600 Subject: [PATCH 207/308] Apply suggestions from code review --- api-reference/beta/api/copilotadminlimitedmode-update.md | 2 +- api-reference/beta/resources/copilotadmin.md | 2 +- api-reference/beta/resources/copilotadminsetting.md | 2 +- api-reference/beta/resources/copilotroot.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/api-reference/beta/api/copilotadminlimitedmode-update.md b/api-reference/beta/api/copilotadminlimitedmode-update.md index 43e5d2a6b0b..8db0d394386 100644 --- a/api-reference/beta/api/copilotadminlimitedmode-update.md +++ b/api-reference/beta/api/copilotadminlimitedmode-update.md @@ -28,7 +28,7 @@ Choose the permission or permissions marked as least privileged for this API. Us |Permission type |Least privileged permissions|Higher privileged permissions| | --------------- |-----------------------------| --------------------------- | -|Delegated (work or school account)|CopilotSettings-LimitedMode.ReadWrite| | +|Delegated (work or school account)|CopilotSettings-LimitedMode.ReadWrite| Not available| |Delegated (personal Microsoft account)|Not supported|Not supported| |Application|Not supported|Not supported| diff --git a/api-reference/beta/resources/copilotadmin.md b/api-reference/beta/resources/copilotadmin.md index 3a0870f93fb..89581861cc2 100644 --- a/api-reference/beta/resources/copilotadmin.md +++ b/api-reference/beta/resources/copilotadmin.md @@ -21,7 +21,7 @@ Inherits from [entity](../resources/entity.md). ## Relationships |Relationship|Type|Description| |:---|:---|:---| -|settings|[Settings](../resources/copilotadminsetting.md)|Set of Copilot settings that can be added or modified.. Navigation property. Read-only. Nullable.| +|settings|[Settings](../resources/copilotadminsetting.md)|Set of Copilot settings that can be added or modified. Read-only. Nullable.| ## JSON representation The following JSON representation shows the resource type. diff --git a/api-reference/beta/resources/copilotadminsetting.md b/api-reference/beta/resources/copilotadminsetting.md index dd68e7bce48..4e2c6ca6032 100644 --- a/api-reference/beta/resources/copilotadminsetting.md +++ b/api-reference/beta/resources/copilotadminsetting.md @@ -1,6 +1,6 @@ --- title: "copilotAdminSetting resource type" -description: "Represents a navigation property for set of Copilot settings." +description: "Represents a navigation property for Copilot settings." author: "gautamjain14" ms.localizationpriority: medium ms.subservice: "meetings-copilot" diff --git a/api-reference/beta/resources/copilotroot.md b/api-reference/beta/resources/copilotroot.md index b7d1126e123..c3c3d11b1b9 100644 --- a/api-reference/beta/resources/copilotroot.md +++ b/api-reference/beta/resources/copilotroot.md @@ -18,7 +18,7 @@ Represents a navigation property for Copilot controls. ## Relationships |Relationship|Type|Description| |:---|:---|:---| -|admin|[Admin](../resources/copilotadmin.md)|Copilot admin can add or modify Copilot settings. Navigation property. Read-only. Nullable.| +|admin|[Admin](../resources/copilotadmin.md)|Copilot admin can add or modify Copilot settings. Read-only. Nullable.| ## JSON representation The following JSON representation shows the resource type. From 954102d6aa39017891ca83d4ed1fae2cd5ea49ce Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Fri, 8 Nov 2024 11:50:09 -0600 Subject: [PATCH 208/308] Apply suggestions from code review --- api-reference/beta/api/copilotadminlimitedmode-get.md | 6 +++--- api-reference/beta/api/copilotadminlimitedmode-update.md | 8 ++++---- 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/api-reference/beta/api/copilotadminlimitedmode-get.md b/api-reference/beta/api/copilotadminlimitedmode-get.md index 807dd229d0e..262e41dd044 100644 --- a/api-reference/beta/api/copilotadminlimitedmode-get.md +++ b/api-reference/beta/api/copilotadminlimitedmode-get.md @@ -1,5 +1,5 @@ --- -title: "Get copilotLimitedMode" +title: "Get copilotAdminLimitedMode" description: "Read the properties and relationships of a copilotAdminLimitedMode object." author: "gautamjain14" ms.localizationpriority: medium @@ -29,8 +29,8 @@ Choose the permission or permissions marked as least privileged for this API. Us |Permission type |Least privileged permissions|Higher privileged permissions| | --------------- |-----------------------------| --------------------------- | |Delegated (work or school account)|CopilotSettings-LimitedMode.Read|CopilotSettings-LimitedMode.ReadWrite| -|Delegated (personal Microsoft account)|Not supported|Not supported| -|Application|Not supported|Not supported| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Not supported.Not supported.| ## HTTP request diff --git a/api-reference/beta/api/copilotadminlimitedmode-update.md b/api-reference/beta/api/copilotadminlimitedmode-update.md index 8db0d394386..fc893917e99 100644 --- a/api-reference/beta/api/copilotadminlimitedmode-update.md +++ b/api-reference/beta/api/copilotadminlimitedmode-update.md @@ -1,5 +1,5 @@ --- -title: "Update copilotLimitedMode" +title: "Update copilotAminLimitedMode" description: "Update the properties of a copilotAdminLimitedMode object." author: "gautamjain14" ms.localizationpriority: medium @@ -28,9 +28,9 @@ Choose the permission or permissions marked as least privileged for this API. Us |Permission type |Least privileged permissions|Higher privileged permissions| | --------------- |-----------------------------| --------------------------- | -|Delegated (work or school account)|CopilotSettings-LimitedMode.ReadWrite| Not available| -|Delegated (personal Microsoft account)|Not supported|Not supported| -|Application|Not supported|Not supported| +|Delegated (work or school account)|CopilotSettings-LimitedMode.ReadWrite| Not available.| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Not supported.|Not supported.| ## HTTP request From c310cb6429857ddccea6b10afa29558bdae1e745 Mon Sep 17 00:00:00 2001 From: raghuma777 <96498706+raghuma777@users.noreply.github.com> Date: Fri, 8 Nov 2024 12:15:54 -0600 Subject: [PATCH 209/308] removedunsupportedapiv1.0 --- api-reference/v1.0/api/security-ediscoverycustodian-get.md | 1 - 1 file changed, 1 deletion(-) diff --git a/api-reference/v1.0/api/security-ediscoverycustodian-get.md b/api-reference/v1.0/api/security-ediscoverycustodian-get.md index 948cff2babb..b66dd4d114b 100644 --- a/api-reference/v1.0/api/security-ediscoverycustodian-get.md +++ b/api-reference/v1.0/api/security-ediscoverycustodian-get.md @@ -30,7 +30,6 @@ Choose the permission or permissions marked as least privileged for this API. Us --> ``` http GET /security/cases/ediscoveryCases/{ediscoveryCaseId}/custodians/{ediscoveryCustodianId} -GET /security/cases/ediscoveryCases/{ediscoveryCaseId}/reviewSets/{ediscoveryReviewSetId}/files/{ediscoveryFileId}/custodian ``` ## Optional query parameters From 90087659de1a90ba4734defbbf1699d46beb6f20 Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Fri, 8 Nov 2024 13:40:59 -0600 Subject: [PATCH 210/308] Apply suggestions from code review --- api-reference/beta/resources/copilotadminlimitedmode.md | 6 +++--- api-reference/beta/resources/copilotadminsetting.md | 2 +- api-reference/beta/resources/copilotroot.md | 2 +- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/api-reference/beta/resources/copilotadminlimitedmode.md b/api-reference/beta/resources/copilotadminlimitedmode.md index d4133ad2f17..285e92a5f47 100644 --- a/api-reference/beta/resources/copilotadminlimitedmode.md +++ b/api-reference/beta/resources/copilotadminlimitedmode.md @@ -20,13 +20,13 @@ Inherits from [entity](../resources/entity.md). ## Methods |Method|Return type|Description| |:---|:---|:---| -|[Get](../api/copilotadminlimitedmode-get.md)|[copilotAdminLimitedMode](../resources/copilotadminlimitedmode.md)|Read the properties and relationships of a [copilotAdminLimitedMode](../resources/copilotadminlimitedmode.md) object.| -|[Update](../api/copilotadminlimitedmode-update.md)|[copilotAdminLimitedMode](../resources/copilotadminlimitedmode.md)|Update the properties of a [copilotAdminLimitedMode](../resources/copilotadminlimitedmode.md) object.| +|[Get](../api/copilotadminlimitedmode-get.md)|[copilotAdminLimitedMode](../resources/copilotadminlimitedmode.md)|Read the properties and relationships of a copilotAdminLimitedMode object.| +|[Update](../api/copilotadminlimitedmode-update.md)|[copilotAdminLimitedMode](../resources/copilotadminlimitedmode.md)|Update the properties of a copilotAdminLimitedMode object.| ## Properties |Property|Type|Description| |:---|:---|:---| -|isEnabledForGroup|Boolean|Enables the user to be in limited mode for Copilot in Teams meetings. When copilotLimitedMode=true, users in this mode can ask any questions, but Copilot doesn't respond to certain questions related to inferring emotions, behavior, or judgments. When copilotLimitedMode=false, the current mode for Copilot, it responds to any types of questions grounded to the meeting conversation. The default value is false.| +|isEnabledForGroup|Boolean|Enables the user to be in limited mode for Copilot in Teams meetings. When copilotAdminLimitedMode=true, users in this mode can ask any questions, but Copilot doesn't respond to certain questions related to inferring emotions, behavior, or judgments. When copilotAdminLimitedMode=false, the current mode for Copilot, it responds to any types of questions grounded to the meeting conversation. The default value is false.| |groupId|String|The ID of a Microsoft Entra group, of which the value of `isEnabledForGroup` is applied value for its members. The default value is `null`. This parameter is optional. If `isEnabledForGroup` is set to true, the `groupId` value must be provided for the copilotLimitedMode to be enabled for the members of the group ## Relationships diff --git a/api-reference/beta/resources/copilotadminsetting.md b/api-reference/beta/resources/copilotadminsetting.md index 4e2c6ca6032..04f5cccc5cb 100644 --- a/api-reference/beta/resources/copilotadminsetting.md +++ b/api-reference/beta/resources/copilotadminsetting.md @@ -21,7 +21,7 @@ Inherits from [entity](../resources/entity.md). ## Relationships |Relationship|Type|Description| |:---|:---|:---| -|limitedMode|[LimitedMode](../resources/copilotadminlimitedmode.md)|Add or modify copilot limited mode. Navigation property. Read-only. Nullable.| +|limitedMode|[CopilotAdminLimitedMode](../resources/copilotadminlimitedmode.md)|Add or modify copilot limited mode. Navigation property. Read-only. Nullable.| ## JSON representation The following JSON representation shows the resource type. diff --git a/api-reference/beta/resources/copilotroot.md b/api-reference/beta/resources/copilotroot.md index c3c3d11b1b9..1cd50a2a440 100644 --- a/api-reference/beta/resources/copilotroot.md +++ b/api-reference/beta/resources/copilotroot.md @@ -18,7 +18,7 @@ Represents a navigation property for Copilot controls. ## Relationships |Relationship|Type|Description| |:---|:---|:---| -|admin|[Admin](../resources/copilotadmin.md)|Copilot admin can add or modify Copilot settings. Read-only. Nullable.| +|admin|[CopilotAdmin](../resources/copilotadmin.md)|Copilot admin can add or modify Copilot settings. Read-only. Nullable.| ## JSON representation The following JSON representation shows the resource type. From 327615c1f485189b8194b255cbdc4f415d33ada9 Mon Sep 17 00:00:00 2001 From: raghuma777 <96498706+raghuma777@users.noreply.github.com> Date: Fri, 8 Nov 2024 14:11:59 -0600 Subject: [PATCH 211/308] updatedv1.0 --- .../rbac-directory-role-apis-write.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/api-reference/v1.0/includes/rbac-for-apis/rbac-directory-role-apis-write.md b/api-reference/v1.0/includes/rbac-for-apis/rbac-directory-role-apis-write.md index a5896618c42..24a2fe6a0e5 100644 --- a/api-reference/v1.0/includes/rbac-for-apis/rbac-directory-role-apis-write.md +++ b/api-reference/v1.0/includes/rbac-for-apis/rbac-directory-role-apis-write.md @@ -1,8 +1,8 @@ ---- -author: DougKirschner -ms.reviewer: msodsrbac -ms.topic: include ---- - -> [!IMPORTANT] -> In delegated scenarios with work or school accounts, the signed-in user must be assigned a supported [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) or a custom role with a supported role permission. *Privileged Role Administrator* is the least privileged role supported for this operation. +--- +author: DougKirschner +ms.reviewer: msodsrbac +ms.topic: include +--- + +> [!IMPORTANT] +> In delegated scenarios with work or school accounts, the signed-in user must be assigned a supported [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) or a custom role with a supported role permission. *Privileged Role Administrator* is the least privileged role supported for this operation. From 028d00ba9287d12019d0a3731312347d3510c469 Mon Sep 17 00:00:00 2001 From: raghuma777 <96498706+raghuma777@users.noreply.github.com> Date: Fri, 8 Nov 2024 14:27:18 -0600 Subject: [PATCH 212/308] updatedv1.0 --- api-reference/v1.0/resources/security-ediscoverycase.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/api-reference/v1.0/resources/security-ediscoverycase.md b/api-reference/v1.0/resources/security-ediscoverycase.md index a4402b761e1..32a35c67811 100644 --- a/api-reference/v1.0/resources/security-ediscoverycase.md +++ b/api-reference/v1.0/resources/security-ediscoverycase.md @@ -23,6 +23,8 @@ In the context of eDiscovery, contains custodians, searches, review sets. For de |[Get ediscoveryCase](../api/security-ediscoverycase-get.md)|[microsoft.graph.security.ediscoveryCase](../resources/security-ediscoverycase.md)|Read the properties and relationships of an [ediscoveryCase](../resources/security-ediscoverycase.md) object.| |[Update ediscoveryCase](../api/security-ediscoverycase-update.md)|[microsoft.graph.security.ediscoveryCase](../resources/security-ediscoverycase.md)|Update the properties of an [ediscoveryCase](../resources/security-ediscoverycase.md) object.| |[Delete ediscoveryCase](../api/security-casesroot-delete-ediscoverycases.md)|None|Delete an [ediscoveryCase](../resources/security-ediscoverycase.md) object.| +|[Close ediscoveryCase](../api/security-ediscoverycase-close.md)|None|Close an [ediscoveryCase](../resources/security-ediscoverycase.md) object.| +|[Reopen ediscoveryCase](../api/security-ediscoverycase-reopen.md)|None|Reopen an [ediscoveryCase](../resources/security-ediscoverycase.md) object.| |[List custodians](../api/security-ediscoverycase-list-custodians.md)|[microsoft.graph.security.ediscoveryCustodian](../resources/security-ediscoverycustodian.md) collection|Get the ediscoveryCustodian resources from the custodians navigation property.| |[Create ediscoveryCustodian](../api/security-ediscoverycase-post-custodians.md)|[microsoft.graph.security.ediscoveryCustodian](../resources/security-ediscoverycustodian.md)|Create a new ediscoveryCustodian object.| |[List legalHolds](../api/security-ediscoverycase-list-legalholds.md)|[microsoft.graph.security.ediscoveryHoldPolicy](../resources/security-ediscoveryholdpolicy.md) collection|Get the ediscoveryHoldPolicy resources from the legalHolds navigation property.| From 903b34de75a5a37a11e8e9293c539f91a7a0104e Mon Sep 17 00:00:00 2001 From: Laura Graham Date: Fri, 8 Nov 2024 17:44:52 -0800 Subject: [PATCH 213/308] Edits. --- api-reference/beta/resources/copilotadminlimitedmode.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/api-reference/beta/resources/copilotadminlimitedmode.md b/api-reference/beta/resources/copilotadminlimitedmode.md index 285e92a5f47..274d99f2ea6 100644 --- a/api-reference/beta/resources/copilotadminlimitedmode.md +++ b/api-reference/beta/resources/copilotadminlimitedmode.md @@ -13,7 +13,7 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -The copilotAdminLimitedMode controls whether Microsoft 365 Copilot users can receive responses to sentiment-related prompts. If this setting is enabled, Microsoft 365 Copilot doesn't respond to sentiment-related prompts and questions asked by the user. If the setting is disabled, Microsoft 365 Copilot responds to sentiment-related prompts and questions asked by the user. In the initial version, this setting is honored by Microsoft Teams Copilot, and eventually all Microsoft 365 Copilots will be honoring this setting. The default value is disabled. +Represents a setting that controls whether Microsoft 365 Copilot users can receive responses to sentiment-related prompts. If this setting is enabled, Copilot doesn't respond to sentiment-related prompts and questions asked by the user. If the setting is disabled, Copilot responds to sentiment-related prompts and questions asked by the user. Copilot in Microsoft Teams currently honors this setting. By default, the setting is disabled. Inherits from [entity](../resources/entity.md). @@ -26,8 +26,8 @@ Inherits from [entity](../resources/entity.md). ## Properties |Property|Type|Description| |:---|:---|:---| -|isEnabledForGroup|Boolean|Enables the user to be in limited mode for Copilot in Teams meetings. When copilotAdminLimitedMode=true, users in this mode can ask any questions, but Copilot doesn't respond to certain questions related to inferring emotions, behavior, or judgments. When copilotAdminLimitedMode=false, the current mode for Copilot, it responds to any types of questions grounded to the meeting conversation. The default value is false.| -|groupId|String|The ID of a Microsoft Entra group, of which the value of `isEnabledForGroup` is applied value for its members. The default value is `null`. This parameter is optional. If `isEnabledForGroup` is set to true, the `groupId` value must be provided for the copilotLimitedMode to be enabled for the members of the group +|isEnabledForGroup|Boolean|Enables the user to be in limited mode for Copilot in Teams meetings. When `copilotAdminLimitedMode=true`, users in this mode can ask any questions, but Copilot doesn't respond to certain questions related to inferring emotions, behavior, or judgments. When `copilotAdminLimitedMode=false`, it responds to any types of questions grounded to the meeting conversation. The default value is false.| +|groupId|String|The ID of a Microsoft Entra group to which the value of the **isEnabledForGroup** property is applied value. The default value is `null`. This parameter is optional. If **isEnabledForGroup** is set to `true`, the **groupId** value must be provided in order for Copilot limited mode to be enabled for the members of the group. | ## Relationships None. From f744a804a910db0f6e11411327e163398f2c769d Mon Sep 17 00:00:00 2001 From: Laura Graham Date: Fri, 8 Nov 2024 17:51:41 -0800 Subject: [PATCH 214/308] Updated values. --- changelog/Microsoft.CopilotSettings.json | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/changelog/Microsoft.CopilotSettings.json b/changelog/Microsoft.CopilotSettings.json index e7764d27d01..cb9bd8461ff 100644 --- a/changelog/Microsoft.CopilotSettings.json +++ b/changelog/Microsoft.CopilotSettings.json @@ -38,9 +38,9 @@ "Id": "23e6f05c-f98d-49a4-8df2-b63a6491c249", "Cloud": "Prod", "Version": "beta", - "CreatedDateTime": "2024-10-22T19:12:08.7280528Z", - "WorkloadArea": "Microsoft.CopilotSettings", - "SubArea": "" + "CreatedDateTime": "2024-11-11T19:12:08.7280528Z", + "WorkloadArea": "Teamwork and communications", + "SubArea": "Calls and online meetings" } ] -} \ No newline at end of file +} From 556c97664a87439e15d682e42e1d926146f88497 Mon Sep 17 00:00:00 2001 From: Philippe Signoret Date: Sat, 9 Nov 2024 14:36:25 +0100 Subject: [PATCH 215/308] Add links to application --- api-reference/beta/resources/apiapplication.md | 2 +- api-reference/v1.0/resources/apiapplication.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/resources/apiapplication.md b/api-reference/beta/resources/apiapplication.md index fdf69073f62..4137c3fe041 100644 --- a/api-reference/beta/resources/apiapplication.md +++ b/api-reference/beta/resources/apiapplication.md @@ -13,7 +13,7 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Specifies settings for an application that implements a web API. +Specifies settings for an [application](application.md) that implements a web API. ## Properties diff --git a/api-reference/v1.0/resources/apiapplication.md b/api-reference/v1.0/resources/apiapplication.md index bbc5e33e8d0..93008a68b80 100644 --- a/api-reference/v1.0/resources/apiapplication.md +++ b/api-reference/v1.0/resources/apiapplication.md @@ -11,7 +11,7 @@ author: "sureshja" Namespace: microsoft.graph -Specifies settings for an application that implements a web API. +Specifies settings for an [application](application.md) that implements a web API. ## Properties From 32cddcf4e5945aae0cf971ea54aa44f02e2afc74 Mon Sep 17 00:00:00 2001 From: jingqiang Date: Mon, 11 Nov 2024 10:02:12 +0800 Subject: [PATCH 216/308] fix time --- changelog/Microsoft.CloudManagedDesktop.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/changelog/Microsoft.CloudManagedDesktop.json b/changelog/Microsoft.CloudManagedDesktop.json index 9c8da2ba237..fa7fb73bc02 100644 --- a/changelog/Microsoft.CloudManagedDesktop.json +++ b/changelog/Microsoft.CloudManagedDesktop.json @@ -14,7 +14,7 @@ "Id": "8efd6ed8-dce5-4fb2-b59d-06a05d851029", "Cloud": "Prod", "Version": "beta", - "CreatedDateTime": "2024-11-15T10:25:21.3434973Z", + "CreatedDateTime": "2024-11-11T01:25:21.3434973Z", "WorkloadArea": "Device and app management", "SubArea": "Cloud PC" }, From 2361fb8101846bbff81c76db99a77202fd7862a3 Mon Sep 17 00:00:00 2001 From: Microsoft Graph DevX Tooling Date: Mon, 11 Nov 2024 06:04:44 +0000 Subject: [PATCH 217/308] Update permissions reference --- concepts/permissions-reference.md | 57 +++++++++++++++---------------- 1 file changed, 28 insertions(+), 29 deletions(-) diff --git a/concepts/permissions-reference.md b/concepts/permissions-reference.md index d9e1459ba3d..a7c6aef7ba4 100644 --- a/concepts/permissions-reference.md +++ b/concepts/permissions-reference.md @@ -7,7 +7,7 @@ ms.localizationpriority: high ms.topic: reference ms.subservice: entra-applications ms.custom: graphiamtop20, scenarios:getting-started -ms.date: 11/04/2024 +ms.date: 11/11/2024 #Customer intent: As a developer, I want to learn more about the permissions available in Microsoft Graph, so that I understand the impact of granting specific permissions to my app. --- @@ -906,7 +906,7 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 |--|--|--| | Identifier | 284383ee-7f6e-4e40-a2a8-e85dcb029101 | - | | DisplayText | Initiate outgoing 1 to 1 calls from the app | - | -| Description | Allows the app to place outbound calls to a single user and transfer calls to users in your organization's directory, without a signed-in user. | - | +| Description | Allows the app to place outbound calls to a single user and transfer calls to users in your organization’s directory, without a signed-in user. | - | | AdminConsentRequired | Yes | - | --- @@ -1917,7 +1917,7 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 |--|--|--| | Identifier | 243333ab-4d21-40cb-a475-36241daa0842 | 44642bfe-8385-4adc-8fc6-fe3cb2c375c3 | | DisplayText | Read and write Microsoft Intune devices | Read and write Microsoft Intune devices | -| Description | Allows the app to read and write the properties of devices managed by Microsoft Intune, without a signed-in user. Does not allow high impact operations such as remote wipe and password reset on the device's owner | Allows the app to read and write the properties of devices managed by Microsoft Intune. Does not allow high impact operations such as remote wipe and password reset on the device's owner. | +| Description | Allows the app to read and write the properties of devices managed by Microsoft Intune, without a signed-in user. Does not allow high impact operations such as remote wipe and password reset on the device’s owner | Allows the app to read and write the properties of devices managed by Microsoft Intune. Does not allow high impact operations such as remote wipe and password reset on the device’s owner. | | AdminConsentRequired | Yes | Yes | [!INCLUDE [DeviceManagementManagedDevices.ReadWrite.All](../includes/permissions-notes/devicemanagementmanageddevices.readwrite.all.md)] @@ -2837,7 +2837,7 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 |--|--|--| | Identifier | e321f0bb-e7f7-481e-bb28-e3b0b32d4bd0 | 43781733-b5a7-4d1b-98f4-e8edff23e1a9 | | DisplayText | Read identity providers | Read identity providers | -| Description | Allows the app to read your organization's identity (authentication) providers' properties without a signed in user. | Allows the app to read your organization's identity (authentication) providers' properties on behalf of the user. | +| Description | Allows the app to read your organization’s identity (authentication) providers’ properties without a signed in user. | Allows the app to read your organization’s identity (authentication) providers’ properties on behalf of the user. | | AdminConsentRequired | Yes | Yes | --- @@ -2848,7 +2848,7 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 |--|--|--| | Identifier | 90db2b9a-d928-4d33-a4dd-8442ae3d41e4 | f13ce604-1677-429f-90bd-8a10b9f01325 | | DisplayText | Read and write identity providers | Read and write identity providers | -| Description | Allows the app to read and write your organization's identity (authentication) providers' properties without a signed in user. | Allows the app to read and write your organization's identity (authentication) providers' properties on behalf of the user. | +| Description | Allows the app to read and write your organization’s identity (authentication) providers’ properties without a signed in user. | Allows the app to read and write your organization’s identity (authentication) providers’ properties on behalf of the user. | | AdminConsentRequired | Yes | Yes | --- @@ -4355,8 +4355,8 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 | Category | Application | Delegated | |--|--|--| | Identifier | b21b72f6-4e6a-4533-9112-47eea9f97b28 | d146432f-b803-4ed4-8d42-ba74193a6ede | -| DisplayText | Read your organization's identity protection policy | Read your organization's identity protection policy | -| Description | Allows the app to read your organization's identity protection policy without a signed-in user. | Allows the app to read your organization's identity protection policy on behalf of the signed-in user. | +| DisplayText | Read your organization’s identity protection policy | Read your organization’s identity protection policy | +| Description | Allows the app to read your organization’s identity protection policy without a signed-in user. | Allows the app to read your organization’s identity protection policy on behalf of the signed-in user. | | AdminConsentRequired | Yes | Yes | --- @@ -4511,8 +4511,8 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 | Category | Application | Delegated | |--|--|--| | Identifier | 2dcf8603-09eb-4078-b1ec-d30a1a76b873 | 7256e131-3efb-4323-9854-cf41c6021770 | -| DisplayText | Read and write your organization's identity protection policy | Read and write your organization's identity protection policy | -| Description | Allows the app to read and write your organization's identity protection policy without a signed-in user. | Allows the app to read and write your organization's identity protection policy on behalf of the signed-in user. | +| DisplayText | Read and write your organization’s identity protection policy | Read and write your organization’s identity protection policy | +| Description | Allows the app to read and write your organization’s identity protection policy without a signed-in user. | Allows the app to read and write your organization’s identity protection policy on behalf of the signed-in user. | | AdminConsentRequired | Yes | Yes | --- @@ -5571,8 +5571,8 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 | Category | Application | Delegated | |--|--|--| | Identifier | bf394140-e372-4bf9-a898-299cfc7564e5 | 64733abd-851e-478a-bffb-e47a14b18235 | -| DisplayText | Read your organization's security events | Read your organization's security events | -| Description | Allows the app to read your organization's security events without a signed-in user. | Allows the app to read your organization's security events on behalf of the signed-in user. | +| DisplayText | Read your organization’s security events | Read your organization’s security events | +| Description | Allows the app to read your organization’s security events without a signed-in user. | Allows the app to read your organization’s security events on behalf of the signed-in user. | | AdminConsentRequired | Yes | Yes | --- @@ -5582,8 +5582,8 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 | Category | Application | Delegated | |--|--|--| | Identifier | d903a879-88e0-4c09-b0c9-82f6a1333f84 | 6aedf524-7e1c-45a7-bd76-ded8cab8d0fc | -| DisplayText | Read and update your organization's security events | Read and update your organization's security events | -| Description | Allows the app to read your organization's security events without a signed-in user. Also allows the app to update editable properties in security events. | Allows the app to read your organization's security events on behalf of the signed-in user. Also allows the app to update editable properties in security events on behalf of the signed-in user. | +| DisplayText | Read and update your organization’s security events | Read and update your organization’s security events | +| Description | Allows the app to read your organization’s security events without a signed-in user. Also allows the app to update editable properties in security events. | Allows the app to read your organization’s security events on behalf of the signed-in user. Also allows the app to update editable properties in security events on behalf of the signed-in user. | | AdminConsentRequired | Yes | Yes | --- @@ -5918,7 +5918,7 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 |--|--|--| | Identifier | - | 258f6531-6087-4cc4-bb90-092c5fb3ed3f | | DisplayText | - | Send emails from mailboxes using SMTP AUTH. | -| Description | - | Allows the app to be able to send emails from the user's mailbox using the SMTP AUTH client submission protocol. | +| Description | - | Allows the app to be able to send emails from the user’s mailbox using the SMTP AUTH client submission protocol. | | AdminConsentRequired | - | No | ![personal Microsoft accounts][MSA] The *SMTP.Send* delegated permission is available for consent in personal Microsoft accounts. @@ -6019,7 +6019,7 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 |--|--|--| | Identifier | - | f45671fb-e0fe-4b4b-be20-3d3ce43f1bcb | | DisplayText | - | Read user's tasks and task lists | -| Description | - | Allows the app to read the signed-in user's tasks and task lists, including any shared with the user. Doesn't include permission to create, delete, or update anything. | +| Description | - | Allows the app to read the signed-in user’s tasks and task lists, including any shared with the user. Doesn't include permission to create, delete, or update anything. | | AdminConsentRequired | - | No | ![personal Microsoft accounts][MSA] The *Tasks.Read* delegated permission is available for consent in personal Microsoft accounts. @@ -6031,8 +6031,8 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 | Category | Application | Delegated | |--|--|--| | Identifier | f10e1f91-74ed-437f-a6fd-d6ae88e26c1f | - | -| DisplayText | Read all users' tasks and tasklist | - | -| Description | Allows the app to read all users' tasks and task lists in your organization, without a signed-in user. | - | +| DisplayText | Read all users’ tasks and tasklist | - | +| Description | Allows the app to read all users’ tasks and task lists in your organization, without a signed-in user. | - | | AdminConsentRequired | Yes | - | --- @@ -6053,7 +6053,7 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 | Category | Application | Delegated | |--|--|--| | Identifier | - | 2219042f-cab5-40cc-b0d2-16b1540b4c5f | -| DisplayText | - | Create, read, update, and delete user's tasks and task lists | +| DisplayText | - | Create, read, update, and delete user’s tasks and task lists | | Description | - | Allows the app to create, read, update, and delete the signed-in user's tasks and task lists, including any shared with the user. | | AdminConsentRequired | - | No | @@ -6066,8 +6066,8 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 | Category | Application | Delegated | |--|--|--| | Identifier | 44e666d1-d276-445b-a5fc-8815eeb81d55 | - | -| DisplayText | Read and write all users' tasks and tasklists | - | -| Description | Allows the app to create, read, update and delete all users' tasks and task lists in your organization, without a signed-in user | - | +| DisplayText | Read and write all users’ tasks and tasklists | - | +| Description | Allows the app to create, read, update and delete all users’ tasks and task lists in your organization, without a signed-in user | - | | AdminConsentRequired | Yes | - | --- @@ -7277,7 +7277,7 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 |--|--|--| | Identifier | 38d9df27-64da-44fd-b7c5-a6fbac20248f | aec28ec7-4d02-4e8c-b864-50163aea77eb | | DisplayText | Read all users' authentication methods | Read all users' authentication methods | -| Description | Allows the app to read authentication methods of all users in your organization, without a signed-in user. Authentication methods include things like a user's phone numbers and Authenticator app settings. This does not allow the app to see secret information like passwords, or to sign-in or otherwise use the authentication methods. | Allows the app to read authentication methods of all users in your organization that the signed-in user has access to. Authentication methods include things like a user's phone numbers and Authenticator app settings. This does not allow the app to see secret information like passwords, or to sign-in or otherwise use the authentication methods. | +| Description | Allows the app to read authentication methods of all users in your organization, without a signed-in user. Authentication methods include things like a user’s phone numbers and Authenticator app settings. This does not allow the app to see secret information like passwords, or to sign-in or otherwise use the authentication methods. | Allows the app to read authentication methods of all users in your organization that the signed-in user has access to. Authentication methods include things like a user’s phone numbers and Authenticator app settings. This does not allow the app to see secret information like passwords, or to sign-in or otherwise use the authentication methods. | | AdminConsentRequired | Yes | Yes | --- @@ -7299,7 +7299,7 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 |--|--|--| | Identifier | 50483e42-d915-4231-9639-7fdb7fd190e5 | b7887744-6746-4312-813d-72daeaee7e2d | | DisplayText | Read and write all users' authentication methods | Read and write all users' authentication methods. | -| Description | Allows the application to read and write authentication methods of all users in your organization, without a signed-in user. Authentication methods include things like a user's phone numbers and Authenticator app settings. This does not allow the app to see secret information like passwords, or to sign-in or otherwise use the authentication methods | Allows the app to read and write authentication methods of all users in your organization that the signed-in user has access to. Authentication methods include things like a user's phone numbers and Authenticator app settings. This does not allow the app to see secret information like passwords, or to sign-in or otherwise use the authentication methods. | +| Description | Allows the application to read and write authentication methods of all users in your organization, without a signed-in user. Authentication methods include things like a user’s phone numbers and Authenticator app settings. This does not allow the app to see secret information like passwords, or to sign-in or otherwise use the authentication methods | Allows the app to read and write authentication methods of all users in your organization that the signed-in user has access to. Authentication methods include things like a user’s phone numbers and Authenticator app settings. This does not allow the app to see secret information like passwords, or to sign-in or otherwise use the authentication methods. | | AdminConsentRequired | Yes | Yes | --- @@ -7310,7 +7310,7 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 |--|--|--| | Identifier | 4e774092-a092-48d1-90bd-baad67c7eb47 | 26e2f3e8-b2a1-47fc-9620-89bb5b042024 | | DisplayText | Deliver and manage all user's notifications | Deliver and manage user's notifications | -| Description | Allows the app to send, read, update and delete user's notifications, without a signed-in user. | Allows the app to send, read, update and delete user's notifications. | +| Description | Allows the app to send, read, update and delete user’s notifications, without a signed-in user. | Allows the app to send, read, update and delete user’s notifications. | | AdminConsentRequired | Yes | No | --- @@ -7387,7 +7387,7 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 |--|--|--| | Identifier | d4f67ec2-59b5-4bdc-b4af-d78f6f9c1954 | - | | DisplayText | Read all virtual appointments for users, as authorized by online meetings application access policy | - | -| Description | Allows the application to read virtual appointments for all users, without a signed-in user. The app must also be authorized to access an individual user's data by the online meetings application access policy. | - | +| Description | Allows the application to read virtual appointments for all users, without a signed-in user. The app must also be authorized to access an individual user’s data by the online meetings application access policy. | - | | AdminConsentRequired | Yes | - | --- @@ -7409,7 +7409,7 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 |--|--|--| | Identifier | bf46a256-f47d-448f-ab78-f226fff08d40 | - | | DisplayText | Read-write all virtual appointments for users, as authorized by online meetings app access policy | - | -| Description | Allows the application to read and write virtual appointments for all users, without a signed-in user. The app must also be authorized to access an individual user's data by the online meetings application access policy. | - | +| Description | Allows the application to read and write virtual appointments for all users, without a signed-in user. The app must also be authorized to access an individual user’s data by the online meetings application access policy. | - | | AdminConsentRequired | Yes | - | --- @@ -7521,9 +7521,9 @@ Learn more about [RSC authorization framework and RSC permissions](/microsofttea | ChannelMeetingTranscript.Read.Group | 37e59e88-1a46-482b-b623-0a4aa6abdf67 | Read the transcripts of all channel meetings associated with this team | Allows the app to read transcripts of all the channel meetings associated with this team, without a signed-in user. | | ChannelMember.Read.Group | 7e3614f5-3467-419c-9c63-dd0bbd2a88f9 | Read the members of channels of a team | Read the members of channels of a team, without a signed-in user | | ChannelMessage.Read.Group | 19103a54-c397-4bcd-be5a-ef111e0406fa | Read this team's channel messages | Allows the app to read this team's channel's messages, without a signed-in user. | -| ChannelMessage.Send.Group | 3e38d437-815b-4368-9f19-e39dea9a6c7f | Send messages to this team's channels | Allows the app to send messages to this team's channels, without a signed-in user. | -| ChannelSettings.Read.Group | 0a7b3084-8d18-46f5-8aef-b5b829292c6f | Read the names, descriptions, and settings of this team's channels | Allows the app to read this team's channel names, channel descriptions, and channel settings, without a signed-in user. | -| ChannelSettings.ReadWrite.Group | d057ad03-b27b-49f7-8219-e0d4a706da55 | Update the names, descriptions, and settings of this team's channels | Allows the app to update and read the names, descriptions, and settings of this team's channels, without a signed-in user. | +| ChannelMessage.Send.Group | 3e38d437-815b-4368-9f19-e39dea9a6c7f | Send mesages to this team's channels | Allows the app to send messages to this team's channels, without a signed-in user. | +| ChannelSettings.Read.Group | 0a7b3084-8d18-46f5-8aef-b5b829292c6f | Read the names, descriptions, and settings of this team’s channels | Allows the app to read this team's channel names, channel descriptions, and channel settings, without a signed-in user. | +| ChannelSettings.ReadWrite.Group | d057ad03-b27b-49f7-8219-e0d4a706da55 | Update the names, descriptions, and settings of this team’s channels | Allows the app to update and read the names, descriptions, and settings of this team’s channels, without a signed-in user. | | Chat.Manage.Chat | 4a14842e-6bb6-4088-b21a-7d0a24f835a6 | Manage this chat | Allows the app to manage the chat, the chat's members and grant access to the chat's data, without a signed-in user. | | Chat.ManageDeletion.Chat | b827a2af-24b2-4f61-9eb3-8788e66a0d86 | Delete and recover deleted chat | Allows the app to delete and recover deleted chat, without a signed-in user. | | ChatMember.Read.Chat | e854bbc6-07e3-45cc-af99-b6e78fab5b80 | Read this chat's members | Allows the app to read the members of this chat, without a signed-in user. | @@ -7567,4 +7567,3 @@ Learn more about [RSC authorization framework and RSC permissions](/microsofttea + [Grant or revoke Microsoft Graph permissions programmatically](permissions-grant-via-msgraph.md) [MSA]: images/permissions-reference/msa.svg "personal Microsoft accounts (MSA)" - From 7aad7f2b38fc2da3818e2f9669ab8837a930493e Mon Sep 17 00:00:00 2001 From: Microsoft Graph DevX Tooling Date: Mon, 11 Nov 2024 06:04:46 +0000 Subject: [PATCH 218/308] Correct errors in permissions reference --- concepts/permissions-reference.md | 55 ++++++++++++++++--------------- 1 file changed, 28 insertions(+), 27 deletions(-) diff --git a/concepts/permissions-reference.md b/concepts/permissions-reference.md index a7c6aef7ba4..0bc7c647f92 100644 --- a/concepts/permissions-reference.md +++ b/concepts/permissions-reference.md @@ -906,7 +906,7 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 |--|--|--| | Identifier | 284383ee-7f6e-4e40-a2a8-e85dcb029101 | - | | DisplayText | Initiate outgoing 1 to 1 calls from the app | - | -| Description | Allows the app to place outbound calls to a single user and transfer calls to users in your organization’s directory, without a signed-in user. | - | +| Description | Allows the app to place outbound calls to a single user and transfer calls to users in your organization's directory, without a signed-in user. | - | | AdminConsentRequired | Yes | - | --- @@ -1917,7 +1917,7 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 |--|--|--| | Identifier | 243333ab-4d21-40cb-a475-36241daa0842 | 44642bfe-8385-4adc-8fc6-fe3cb2c375c3 | | DisplayText | Read and write Microsoft Intune devices | Read and write Microsoft Intune devices | -| Description | Allows the app to read and write the properties of devices managed by Microsoft Intune, without a signed-in user. Does not allow high impact operations such as remote wipe and password reset on the device’s owner | Allows the app to read and write the properties of devices managed by Microsoft Intune. Does not allow high impact operations such as remote wipe and password reset on the device’s owner. | +| Description | Allows the app to read and write the properties of devices managed by Microsoft Intune, without a signed-in user. Does not allow high impact operations such as remote wipe and password reset on the device's owner | Allows the app to read and write the properties of devices managed by Microsoft Intune. Does not allow high impact operations such as remote wipe and password reset on the device's owner. | | AdminConsentRequired | Yes | Yes | [!INCLUDE [DeviceManagementManagedDevices.ReadWrite.All](../includes/permissions-notes/devicemanagementmanageddevices.readwrite.all.md)] @@ -2837,7 +2837,7 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 |--|--|--| | Identifier | e321f0bb-e7f7-481e-bb28-e3b0b32d4bd0 | 43781733-b5a7-4d1b-98f4-e8edff23e1a9 | | DisplayText | Read identity providers | Read identity providers | -| Description | Allows the app to read your organization’s identity (authentication) providers’ properties without a signed in user. | Allows the app to read your organization’s identity (authentication) providers’ properties on behalf of the user. | +| Description | Allows the app to read your organization's identity (authentication) providers' properties without a signed in user. | Allows the app to read your organization's identity (authentication) providers' properties on behalf of the user. | | AdminConsentRequired | Yes | Yes | --- @@ -2848,7 +2848,7 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 |--|--|--| | Identifier | 90db2b9a-d928-4d33-a4dd-8442ae3d41e4 | f13ce604-1677-429f-90bd-8a10b9f01325 | | DisplayText | Read and write identity providers | Read and write identity providers | -| Description | Allows the app to read and write your organization’s identity (authentication) providers’ properties without a signed in user. | Allows the app to read and write your organization’s identity (authentication) providers’ properties on behalf of the user. | +| Description | Allows the app to read and write your organization's identity (authentication) providers' properties without a signed in user. | Allows the app to read and write your organization's identity (authentication) providers' properties on behalf of the user. | | AdminConsentRequired | Yes | Yes | --- @@ -4355,8 +4355,8 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 | Category | Application | Delegated | |--|--|--| | Identifier | b21b72f6-4e6a-4533-9112-47eea9f97b28 | d146432f-b803-4ed4-8d42-ba74193a6ede | -| DisplayText | Read your organization’s identity protection policy | Read your organization’s identity protection policy | -| Description | Allows the app to read your organization’s identity protection policy without a signed-in user. | Allows the app to read your organization’s identity protection policy on behalf of the signed-in user. | +| DisplayText | Read your organization's identity protection policy | Read your organization's identity protection policy | +| Description | Allows the app to read your organization's identity protection policy without a signed-in user. | Allows the app to read your organization's identity protection policy on behalf of the signed-in user. | | AdminConsentRequired | Yes | Yes | --- @@ -4511,8 +4511,8 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 | Category | Application | Delegated | |--|--|--| | Identifier | 2dcf8603-09eb-4078-b1ec-d30a1a76b873 | 7256e131-3efb-4323-9854-cf41c6021770 | -| DisplayText | Read and write your organization’s identity protection policy | Read and write your organization’s identity protection policy | -| Description | Allows the app to read and write your organization’s identity protection policy without a signed-in user. | Allows the app to read and write your organization’s identity protection policy on behalf of the signed-in user. | +| DisplayText | Read and write your organization's identity protection policy | Read and write your organization's identity protection policy | +| Description | Allows the app to read and write your organization's identity protection policy without a signed-in user. | Allows the app to read and write your organization's identity protection policy on behalf of the signed-in user. | | AdminConsentRequired | Yes | Yes | --- @@ -5571,8 +5571,8 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 | Category | Application | Delegated | |--|--|--| | Identifier | bf394140-e372-4bf9-a898-299cfc7564e5 | 64733abd-851e-478a-bffb-e47a14b18235 | -| DisplayText | Read your organization’s security events | Read your organization’s security events | -| Description | Allows the app to read your organization’s security events without a signed-in user. | Allows the app to read your organization’s security events on behalf of the signed-in user. | +| DisplayText | Read your organization's security events | Read your organization's security events | +| Description | Allows the app to read your organization's security events without a signed-in user. | Allows the app to read your organization's security events on behalf of the signed-in user. | | AdminConsentRequired | Yes | Yes | --- @@ -5582,8 +5582,8 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 | Category | Application | Delegated | |--|--|--| | Identifier | d903a879-88e0-4c09-b0c9-82f6a1333f84 | 6aedf524-7e1c-45a7-bd76-ded8cab8d0fc | -| DisplayText | Read and update your organization’s security events | Read and update your organization’s security events | -| Description | Allows the app to read your organization’s security events without a signed-in user. Also allows the app to update editable properties in security events. | Allows the app to read your organization’s security events on behalf of the signed-in user. Also allows the app to update editable properties in security events on behalf of the signed-in user. | +| DisplayText | Read and update your organization's security events | Read and update your organization's security events | +| Description | Allows the app to read your organization's security events without a signed-in user. Also allows the app to update editable properties in security events. | Allows the app to read your organization's security events on behalf of the signed-in user. Also allows the app to update editable properties in security events on behalf of the signed-in user. | | AdminConsentRequired | Yes | Yes | --- @@ -5918,7 +5918,7 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 |--|--|--| | Identifier | - | 258f6531-6087-4cc4-bb90-092c5fb3ed3f | | DisplayText | - | Send emails from mailboxes using SMTP AUTH. | -| Description | - | Allows the app to be able to send emails from the user’s mailbox using the SMTP AUTH client submission protocol. | +| Description | - | Allows the app to be able to send emails from the user's mailbox using the SMTP AUTH client submission protocol. | | AdminConsentRequired | - | No | ![personal Microsoft accounts][MSA] The *SMTP.Send* delegated permission is available for consent in personal Microsoft accounts. @@ -6019,7 +6019,7 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 |--|--|--| | Identifier | - | f45671fb-e0fe-4b4b-be20-3d3ce43f1bcb | | DisplayText | - | Read user's tasks and task lists | -| Description | - | Allows the app to read the signed-in user’s tasks and task lists, including any shared with the user. Doesn't include permission to create, delete, or update anything. | +| Description | - | Allows the app to read the signed-in user's tasks and task lists, including any shared with the user. Doesn't include permission to create, delete, or update anything. | | AdminConsentRequired | - | No | ![personal Microsoft accounts][MSA] The *Tasks.Read* delegated permission is available for consent in personal Microsoft accounts. @@ -6031,8 +6031,8 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 | Category | Application | Delegated | |--|--|--| | Identifier | f10e1f91-74ed-437f-a6fd-d6ae88e26c1f | - | -| DisplayText | Read all users’ tasks and tasklist | - | -| Description | Allows the app to read all users’ tasks and task lists in your organization, without a signed-in user. | - | +| DisplayText | Read all users' tasks and tasklist | - | +| Description | Allows the app to read all users' tasks and task lists in your organization, without a signed-in user. | - | | AdminConsentRequired | Yes | - | --- @@ -6053,7 +6053,7 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 | Category | Application | Delegated | |--|--|--| | Identifier | - | 2219042f-cab5-40cc-b0d2-16b1540b4c5f | -| DisplayText | - | Create, read, update, and delete user’s tasks and task lists | +| DisplayText | - | Create, read, update, and delete user's tasks and task lists | | Description | - | Allows the app to create, read, update, and delete the signed-in user's tasks and task lists, including any shared with the user. | | AdminConsentRequired | - | No | @@ -6066,8 +6066,8 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 | Category | Application | Delegated | |--|--|--| | Identifier | 44e666d1-d276-445b-a5fc-8815eeb81d55 | - | -| DisplayText | Read and write all users’ tasks and tasklists | - | -| Description | Allows the app to create, read, update and delete all users’ tasks and task lists in your organization, without a signed-in user | - | +| DisplayText | Read and write all users' tasks and tasklists | - | +| Description | Allows the app to create, read, update and delete all users' tasks and task lists in your organization, without a signed-in user | - | | AdminConsentRequired | Yes | - | --- @@ -7277,7 +7277,7 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 |--|--|--| | Identifier | 38d9df27-64da-44fd-b7c5-a6fbac20248f | aec28ec7-4d02-4e8c-b864-50163aea77eb | | DisplayText | Read all users' authentication methods | Read all users' authentication methods | -| Description | Allows the app to read authentication methods of all users in your organization, without a signed-in user. Authentication methods include things like a user’s phone numbers and Authenticator app settings. This does not allow the app to see secret information like passwords, or to sign-in or otherwise use the authentication methods. | Allows the app to read authentication methods of all users in your organization that the signed-in user has access to. Authentication methods include things like a user’s phone numbers and Authenticator app settings. This does not allow the app to see secret information like passwords, or to sign-in or otherwise use the authentication methods. | +| Description | Allows the app to read authentication methods of all users in your organization, without a signed-in user. Authentication methods include things like a user's phone numbers and Authenticator app settings. This does not allow the app to see secret information like passwords, or to sign-in or otherwise use the authentication methods. | Allows the app to read authentication methods of all users in your organization that the signed-in user has access to. Authentication methods include things like a user's phone numbers and Authenticator app settings. This does not allow the app to see secret information like passwords, or to sign-in or otherwise use the authentication methods. | | AdminConsentRequired | Yes | Yes | --- @@ -7299,7 +7299,7 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 |--|--|--| | Identifier | 50483e42-d915-4231-9639-7fdb7fd190e5 | b7887744-6746-4312-813d-72daeaee7e2d | | DisplayText | Read and write all users' authentication methods | Read and write all users' authentication methods. | -| Description | Allows the application to read and write authentication methods of all users in your organization, without a signed-in user. Authentication methods include things like a user’s phone numbers and Authenticator app settings. This does not allow the app to see secret information like passwords, or to sign-in or otherwise use the authentication methods | Allows the app to read and write authentication methods of all users in your organization that the signed-in user has access to. Authentication methods include things like a user’s phone numbers and Authenticator app settings. This does not allow the app to see secret information like passwords, or to sign-in or otherwise use the authentication methods. | +| Description | Allows the application to read and write authentication methods of all users in your organization, without a signed-in user. Authentication methods include things like a user's phone numbers and Authenticator app settings. This does not allow the app to see secret information like passwords, or to sign-in or otherwise use the authentication methods | Allows the app to read and write authentication methods of all users in your organization that the signed-in user has access to. Authentication methods include things like a user's phone numbers and Authenticator app settings. This does not allow the app to see secret information like passwords, or to sign-in or otherwise use the authentication methods. | | AdminConsentRequired | Yes | Yes | --- @@ -7310,7 +7310,7 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 |--|--|--| | Identifier | 4e774092-a092-48d1-90bd-baad67c7eb47 | 26e2f3e8-b2a1-47fc-9620-89bb5b042024 | | DisplayText | Deliver and manage all user's notifications | Deliver and manage user's notifications | -| Description | Allows the app to send, read, update and delete user’s notifications, without a signed-in user. | Allows the app to send, read, update and delete user’s notifications. | +| Description | Allows the app to send, read, update and delete user's notifications, without a signed-in user. | Allows the app to send, read, update and delete user's notifications. | | AdminConsentRequired | Yes | No | --- @@ -7387,7 +7387,7 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 |--|--|--| | Identifier | d4f67ec2-59b5-4bdc-b4af-d78f6f9c1954 | - | | DisplayText | Read all virtual appointments for users, as authorized by online meetings application access policy | - | -| Description | Allows the application to read virtual appointments for all users, without a signed-in user. The app must also be authorized to access an individual user’s data by the online meetings application access policy. | - | +| Description | Allows the application to read virtual appointments for all users, without a signed-in user. The app must also be authorized to access an individual user's data by the online meetings application access policy. | - | | AdminConsentRequired | Yes | - | --- @@ -7409,7 +7409,7 @@ GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='00000003-0000-0000 |--|--|--| | Identifier | bf46a256-f47d-448f-ab78-f226fff08d40 | - | | DisplayText | Read-write all virtual appointments for users, as authorized by online meetings app access policy | - | -| Description | Allows the application to read and write virtual appointments for all users, without a signed-in user. The app must also be authorized to access an individual user’s data by the online meetings application access policy. | - | +| Description | Allows the application to read and write virtual appointments for all users, without a signed-in user. The app must also be authorized to access an individual user's data by the online meetings application access policy. | - | | AdminConsentRequired | Yes | - | --- @@ -7521,9 +7521,9 @@ Learn more about [RSC authorization framework and RSC permissions](/microsofttea | ChannelMeetingTranscript.Read.Group | 37e59e88-1a46-482b-b623-0a4aa6abdf67 | Read the transcripts of all channel meetings associated with this team | Allows the app to read transcripts of all the channel meetings associated with this team, without a signed-in user. | | ChannelMember.Read.Group | 7e3614f5-3467-419c-9c63-dd0bbd2a88f9 | Read the members of channels of a team | Read the members of channels of a team, without a signed-in user | | ChannelMessage.Read.Group | 19103a54-c397-4bcd-be5a-ef111e0406fa | Read this team's channel messages | Allows the app to read this team's channel's messages, without a signed-in user. | -| ChannelMessage.Send.Group | 3e38d437-815b-4368-9f19-e39dea9a6c7f | Send mesages to this team's channels | Allows the app to send messages to this team's channels, without a signed-in user. | -| ChannelSettings.Read.Group | 0a7b3084-8d18-46f5-8aef-b5b829292c6f | Read the names, descriptions, and settings of this team’s channels | Allows the app to read this team's channel names, channel descriptions, and channel settings, without a signed-in user. | -| ChannelSettings.ReadWrite.Group | d057ad03-b27b-49f7-8219-e0d4a706da55 | Update the names, descriptions, and settings of this team’s channels | Allows the app to update and read the names, descriptions, and settings of this team’s channels, without a signed-in user. | +| ChannelMessage.Send.Group | 3e38d437-815b-4368-9f19-e39dea9a6c7f | Send messages to this team's channels | Allows the app to send messages to this team's channels, without a signed-in user. | +| ChannelSettings.Read.Group | 0a7b3084-8d18-46f5-8aef-b5b829292c6f | Read the names, descriptions, and settings of this team's channels | Allows the app to read this team's channel names, channel descriptions, and channel settings, without a signed-in user. | +| ChannelSettings.ReadWrite.Group | d057ad03-b27b-49f7-8219-e0d4a706da55 | Update the names, descriptions, and settings of this team's channels | Allows the app to update and read the names, descriptions, and settings of this team's channels, without a signed-in user. | | Chat.Manage.Chat | 4a14842e-6bb6-4088-b21a-7d0a24f835a6 | Manage this chat | Allows the app to manage the chat, the chat's members and grant access to the chat's data, without a signed-in user. | | Chat.ManageDeletion.Chat | b827a2af-24b2-4f61-9eb3-8788e66a0d86 | Delete and recover deleted chat | Allows the app to delete and recover deleted chat, without a signed-in user. | | ChatMember.Read.Chat | e854bbc6-07e3-45cc-af99-b6e78fab5b80 | Read this chat's members | Allows the app to read the members of this chat, without a signed-in user. | @@ -7567,3 +7567,4 @@ Learn more about [RSC authorization framework and RSC permissions](/microsofttea + [Grant or revoke Microsoft Graph permissions programmatically](permissions-grant-via-msgraph.md) [MSA]: images/permissions-reference/msa.svg "personal Microsoft accounts (MSA)" + From a237a4feca33aec5ad250474da754072abcb31ee Mon Sep 17 00:00:00 2001 From: Microsoft Graph DevX Tooling Date: Mon, 11 Nov 2024 08:59:13 +0000 Subject: [PATCH 219/308] Update generated permissions tables with build 170254 --- .../permissions/site-post-permissions-permissions.md | 12 ------------ .../permissions/site-post-permissions-permissions.md | 12 ------------ 2 files changed, 24 deletions(-) delete mode 100644 api-reference/beta/includes/permissions/site-post-permissions-permissions.md delete mode 100644 api-reference/v1.0/includes/permissions/site-post-permissions-permissions.md diff --git a/api-reference/beta/includes/permissions/site-post-permissions-permissions.md b/api-reference/beta/includes/permissions/site-post-permissions-permissions.md deleted file mode 100644 index 4d99a37884e..00000000000 --- a/api-reference/beta/includes/permissions/site-post-permissions-permissions.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" -ms.topic: include -ms.localizationpriority: medium ---- - -|Permission type|Least privileged permissions|Higher privileged permissions| -|:---|:---|:---| -|Delegated (work or school account)|Site.FullControl.All|Not available.| -|Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|Sites.FullControl.All|Not available.| - diff --git a/api-reference/v1.0/includes/permissions/site-post-permissions-permissions.md b/api-reference/v1.0/includes/permissions/site-post-permissions-permissions.md deleted file mode 100644 index c1dc2d60279..00000000000 --- a/api-reference/v1.0/includes/permissions/site-post-permissions-permissions.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" -ms.topic: include -ms.localizationpriority: medium ---- - -|Permission type|Least privileged permissions|Higher privileged permissions| -|:---|:---|:---| -|Delegated (work or school account)|Sites.FullControl.All|Not available.| -|Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|Sites.FullControl.All|Not available.| - From 12583b15d839ffe5e697fb0ce79108ac4186b6fd Mon Sep 17 00:00:00 2001 From: Faith Moraa Ombongi Date: Mon, 11 Nov 2024 20:21:21 +0300 Subject: [PATCH 220/308] Update tutorial-lifecycle-workflows-set-employeeleavedatetime.md --- ...ycle-workflows-set-employeeleavedatetime.md | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/concepts/tutorial-lifecycle-workflows-set-employeeleavedatetime.md b/concepts/tutorial-lifecycle-workflows-set-employeeleavedatetime.md index ed427c32519..1c32d37aa2f 100644 --- a/concepts/tutorial-lifecycle-workflows-set-employeeleavedatetime.md +++ b/concepts/tutorial-lifecycle-workflows-set-employeeleavedatetime.md @@ -30,14 +30,16 @@ For delegated scenarios, the admin must also have the Global Administrator [Micr > [!NOTE] > This information is best updated via automation by using either an HR provisioning, Microsoft Entra Connect, or custom sync solution. For more information about this process, see [How to synchronize attributes for lifecycle workflows](/entra/id-governance/how-to-lifecycle-workflow-sync-attributes). -## Request +## Set the employeeLeaveDateTime property + +### Request The following example configures September 30, 2022 at 23:59 as the date and time when the user will leave the organization. # [HTTP](#tab/http) ```http -PATCH https://graph.microsoft.com/v1.0/users/df744d9e-2148-4922-88a8-633896c1e929 +PATCH https://graph.microsoft.com/v1.0/users/aaaaaaaa-bbbb-cccc-1111-222222222222 { "employeeLeaveDateTime": "2022-09-30T23:59:59Z" @@ -61,6 +63,18 @@ PATCH https://graph.microsoft.com/v1.0/users/df744d9e-2148-4922-88a8-633896c1e92 --- +## Reset the employeeLeveDateTime property back to null + +The request returns a `204 No Content` response code. + +```http +PATCH https://graph.microsoft.com/v1.0/users/aaaaaaaa-bbbb-cccc-1111-222222222222 + +{ + "employeeLeaveDateTime": null +} +``` + ## Related content - [Lifecycle Workflows API overview](/graph/api/resources/identitygovernance-lifecycleworkflows-overview) From eaa726a192b43720dca35d9a5d9a49d1234e2ae6 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 11 Nov 2024 11:26:39 -0600 Subject: [PATCH 221/308] Update filestoragecontainer-post.md Update the dataLocation property in beta file. --- api-reference/beta/api/filestoragecontainer-post.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/api/filestoragecontainer-post.md b/api-reference/beta/api/filestoragecontainer-post.md index a9f742bf481..0c58c76e6c7 100644 --- a/api-reference/beta/api/filestoragecontainer-post.md +++ b/api-reference/beta/api/filestoragecontainer-post.md @@ -43,7 +43,7 @@ This method supports the following OData query parameters to help customize the | Name |Description| |:----------|:----------| -| dataLocation | Use the `$dataLocation` query parameter to select the desired data locatiion for container creation. Omitting the `$dataLocation` parameter in the Graph Storage Container creation request will default the creation of the container to a tenant’s default geography. | +| dataLocation | Use the `$dataLocation` query parameter to specify the desired data location for container creation in Multi-Geo tenants. Omitting the `$dataLocation` parameter in the request will create the container at the tenant's default location. Learn more about [available Multi-Geo regions and their location codes](https://learn.microsoft.com/en-us/microsoft-365/enterprise/microsoft-365-multi-geo?view=o365-worldwide#microsoft-365-multi-geo-availability). | ## Request headers |Name|Description| From 13adc968a783a8b8c4146680ece00d5d6ecbd113 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 11 Nov 2024 12:34:57 -0600 Subject: [PATCH 222/308] Update filestoragecontainer-post-columns.md added missing blurb to file --- api-reference/v1.0/api/filestoragecontainer-post-columns.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/api-reference/v1.0/api/filestoragecontainer-post-columns.md b/api-reference/v1.0/api/filestoragecontainer-post-columns.md index 4fa520b55af..56e9bf6c4ce 100644 --- a/api-reference/v1.0/api/filestoragecontainer-post-columns.md +++ b/api-reference/v1.0/api/filestoragecontainer-post-columns.md @@ -26,6 +26,8 @@ Choose the permission or permissions marked as least privileged for this API. Us --> [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-post-columns-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request + [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-post-columns-permissions.md)] [!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] From ae7f629c84cebfa6c0258170eb575fd23f9f733c Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Mon, 11 Nov 2024 15:00:36 -0600 Subject: [PATCH 225/308] Update filestoragecontainer-post-columns.md --- api-reference/v1.0/api/filestoragecontainer-post-columns.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-post-columns.md b/api-reference/v1.0/api/filestoragecontainer-post-columns.md index c3339adb13a..56e9bf6c4ce 100644 --- a/api-reference/v1.0/api/filestoragecontainer-post-columns.md +++ b/api-reference/v1.0/api/filestoragecontainer-post-columns.md @@ -19,7 +19,11 @@ Create a columnDefinition for a [fileStorageContainer](../resources/filestoragec Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). - + [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-post-columns-permissions.md)] [!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] From 1c4538780d9c40ca82519c2724ae62108c040bbb Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Mon, 11 Nov 2024 15:11:21 -0600 Subject: [PATCH 226/308] Update filestoragecontainer-post-columns.md --- api-reference/v1.0/api/filestoragecontainer-post-columns.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-post-columns.md b/api-reference/v1.0/api/filestoragecontainer-post-columns.md index 56e9bf6c4ce..d8475301850 100644 --- a/api-reference/v1.0/api/filestoragecontainer-post-columns.md +++ b/api-reference/v1.0/api/filestoragecontainer-post-columns.md @@ -26,7 +26,8 @@ Choose the permission or permissions marked as least privileged for this API. Us --> [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-post-columns-permissions.md)] -[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] +>**Note** +>[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] ## HTTP request From 6f18942720b47478331de746782bdab3eda8989d Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Mon, 11 Nov 2024 15:18:13 -0600 Subject: [PATCH 227/308] Update filestoragecontainer-post-columns.md --- api-reference/v1.0/api/filestoragecontainer-post-columns.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-post-columns.md b/api-reference/v1.0/api/filestoragecontainer-post-columns.md index d8475301850..0d5c4566e6e 100644 --- a/api-reference/v1.0/api/filestoragecontainer-post-columns.md +++ b/api-reference/v1.0/api/filestoragecontainer-post-columns.md @@ -26,8 +26,8 @@ Choose the permission or permissions marked as least privileged for this API. Us --> [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-post-columns-permissions.md)] ->**Note** ->[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] +> [!NOTE] +> [!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] ## HTTP request From fbb9d64d2ed67f72b74ddbf6cb55c721a71e9c61 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 11 Nov 2024 15:29:03 -0600 Subject: [PATCH 228/308] Update filestoragecontainer-activate.md Add blurb under the permissions table. --- api-reference/beta/api/filestoragecontainer-activate.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/api-reference/beta/api/filestoragecontainer-activate.md b/api-reference/beta/api/filestoragecontainer-activate.md index 5d74a4d75d7..3240dbb215d 100644 --- a/api-reference/beta/api/filestoragecontainer-activate.md +++ b/api-reference/beta/api/filestoragecontainer-activate.md @@ -28,6 +28,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-activate-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-delete-customproperty-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-delete-permissions-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-delete-recyclebin-items-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-get-columns-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-get-drive-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-get-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-list-columns-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-list-customproperty-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-list-permissions-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-list-recyclebin-items-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-lock-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + > [!NOTE] > When delegated permissions are used, only members who are assigned the `owner` role can call this method. From 9be21152c5c40bbdd4ffbf45ff8f482fba909e66 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 11 Nov 2024 15:42:13 -0600 Subject: [PATCH 241/308] Update filestoragecontainer-permanentdelete.md Add blurb under the permissions table. --- api-reference/beta/api/filestoragecontainer-permanentdelete.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/api-reference/beta/api/filestoragecontainer-permanentdelete.md b/api-reference/beta/api/filestoragecontainer-permanentdelete.md index 34e6dc0af69..e646b0aaae3 100644 --- a/api-reference/beta/api/filestoragecontainer-permanentdelete.md +++ b/api-reference/beta/api/filestoragecontainer-permanentdelete.md @@ -28,6 +28,8 @@ Choose the permission or permissions marked as least privileged for this API. Us --> [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-permanentdelete-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-post-columns-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-post-customproperty-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-post-permissions-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-post-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-restore-recyclebin-items-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-restore-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-unlock-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request ``` http From 7fd6607c983e2fe6de0be5ac49fe85070a9f0e7c Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 11 Nov 2024 15:47:03 -0600 Subject: [PATCH 249/308] Update filestoragecontainer-update-column.md Add blurb under the permissions table. --- api-reference/beta/api/filestoragecontainer-update-column.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/api-reference/beta/api/filestoragecontainer-update-column.md b/api-reference/beta/api/filestoragecontainer-update-column.md index dbd827edb8c..792131d25f4 100644 --- a/api-reference/beta/api/filestoragecontainer-update-column.md +++ b/api-reference/beta/api/filestoragecontainer-update-column.md @@ -28,6 +28,8 @@ Choose the permission or permissions marked as least privileged for this API. Us --> [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-update-columns-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-update-customproperty-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-update-permissions-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-update-recyclebinsettings-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-update-permissions.md)] + +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-delete-recyclebinitem-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-get-columns-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-list-columns-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-list-recyclebinitem-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-lock-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + > [!NOTE] > When delegated permissions are used, only members who are assigned the `owner` role can call this method. From 5388331356989218915b094fcea36dbf1c249b17 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 11 Nov 2024 15:55:31 -0600 Subject: [PATCH 260/308] Update filestoragecontainer-restore-recyclebinitem.md Add blurb under the permissions table. --- .../v1.0/api/filestoragecontainer-restore-recyclebinitem.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/api-reference/v1.0/api/filestoragecontainer-restore-recyclebinitem.md b/api-reference/v1.0/api/filestoragecontainer-restore-recyclebinitem.md index b1d751595d9..f30c17677df 100644 --- a/api-reference/v1.0/api/filestoragecontainer-restore-recyclebinitem.md +++ b/api-reference/v1.0/api/filestoragecontainer-restore-recyclebinitem.md @@ -24,6 +24,8 @@ Choose the permission or permissions marked as least privileged for this API. Us --> [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-restore-recyclebinitem-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-restore-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-unlock-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request ``` http From 48a8ce6e902513b9b0e25eb156617a43d9758ad1 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 11 Nov 2024 15:57:04 -0600 Subject: [PATCH 263/308] Update filestoragecontainer-update-column.md Add blurb under the permissions table. --- api-reference/v1.0/api/filestoragecontainer-update-column.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/api-reference/v1.0/api/filestoragecontainer-update-column.md b/api-reference/v1.0/api/filestoragecontainer-update-column.md index 7aab4fd5520..18fe2477276 100644 --- a/api-reference/v1.0/api/filestoragecontainer-update-column.md +++ b/api-reference/v1.0/api/filestoragecontainer-update-column.md @@ -24,6 +24,8 @@ Choose the permission or permissions marked as least privileged for this API. Us --> [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-update-columns-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request [!INCLUDE [permissions-table](../includes/permissions/filestoragecontainer-update-recyclebinsettings-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request -[!INCLUDE [permissions-table](../includes/permissions/recyclebin-list-items-permissions.md)] - -## HTTP request - - -``` http -GET /sites/{siteId}/recycleBin/items -``` - -## Optional query parameters - -This method supports the `$select` and `$top` OData query parameters to 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 [recycleBinItem](../resources/recyclebinitem.md) objects in the response body. - -## Examples - -### Request - -The following example shows a request to list all **recycleBinItem** resources under a specific site. - - -``` http -GET https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,48f1898f-77d9-4a1b-bddc-1f49bb6dc134,7206fc09-e4af-48b3-8730-ed7321396d7a/recycleBin/items -``` - -### Response - -The following example shows the response. - - -``` http -HTTP/1.1 200 OK -Content-Type: application/json - -{ - "value": [ - { - "id": "825e764f-c118-438f-b5c4-b8fbe60ab569", - "name": "file1.txt", - "size": 469, - "deletedDateTime": "2023-03-27T12:06:59Z", - "deletedFromLocation": "Shared Documents/folder1" - } - ] -} -``` - - From 0b2003985c6faa3a9cb0b60706a31aa7a43b0712 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 11 Nov 2024 16:32:50 -0600 Subject: [PATCH 266/308] Update filestoragecontainer.md Added missing lockState property. --- api-reference/v1.0/resources/filestoragecontainer.md | 1 + 1 file changed, 1 insertion(+) diff --git a/api-reference/v1.0/resources/filestoragecontainer.md b/api-reference/v1.0/resources/filestoragecontainer.md index 80f251e9f59..d5b5f194a26 100644 --- a/api-reference/v1.0/resources/filestoragecontainer.md +++ b/api-reference/v1.0/resources/filestoragecontainer.md @@ -57,6 +57,7 @@ Represents a location where multiple users or a group of users can store files a |description|String|Provides a user-visible description of the **fileStorageContainer**. Read-write.| |displayName|String|The display name of the **fileStorageContainer**. Read-write.| |id|String|The unique stable identifier of the **filerStorageContainer**. Read-only.| +|lockState|siteLockState|Indicates the lock state of the **fileStorageContainer**. The possible values are `unlocked` and `lockedReadOnly`. Read-only.| |status|fileStorageContainerStatus|Status of the **fileStorageContainer**. Containers are created as inactive and require activation. Inactive containers are subjected to automatic deletion in 24 hours. The possible values are: `inactive `, `active `. Read-only.| |settings|[fileStorageContainerSettings](../resources/filestoragecontainersettings.md)|Settings associated with a **fileStorageContainer**. Read-write.| |viewpoint|[fileStorageContainerViewpoint](../resources/filestoragecontainerviewpoint.md)|Data specific to the current user. Read-only.| From 78bd6e3b8633544dd712aa7554d384326bf6150a Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 11 Nov 2024 16:56:16 -0600 Subject: [PATCH 267/308] Delete rbac-device-local-credentials-apis-read.md Removed file unrelated to SPE. --- .../rbac-device-local-credentials-apis-read.md | 18 ------------------ 1 file changed, 18 deletions(-) delete mode 100755 api-reference/beta/includes/rbac-for-apis/rbac-device-local-credentials-apis-read.md diff --git a/api-reference/beta/includes/rbac-for-apis/rbac-device-local-credentials-apis-read.md b/api-reference/beta/includes/rbac-for-apis/rbac-device-local-credentials-apis-read.md deleted file mode 100755 index 0e28f2562c8..00000000000 --- a/api-reference/beta/includes/rbac-for-apis/rbac-device-local-credentials-apis-read.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -author: sandeo-MSFT -ms.topic: include ---- - -In delegated scenarios with work or school accounts, the signed-in user must be assigned a supported [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) or a custom role with a supported role permission. The following least privileged roles are supported for this operation. - -- Cloud Device Administrator -- Helpdesk Administrator -- Intune Service Administrator -- Security Administrator -- Security Reader -- Global Reader - -To access the actual passwords on the device by using the `$select=credentials` query parameter, the calling user must be a user assigned to one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): - -- Cloud Device Administrator -- Intune Service Administrator From 20e83d17cff31ebaaafe36aa5a24641433e5e827 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 11 Nov 2024 16:57:50 -0600 Subject: [PATCH 268/308] Delete rbac-device-local-credentials-basic-apis-read.md Removed file unrelated to SPE. --- ...rbac-device-local-credentials-basic-apis-read.md | 13 ------------- 1 file changed, 13 deletions(-) delete mode 100755 api-reference/beta/includes/rbac-for-apis/rbac-device-local-credentials-basic-apis-read.md diff --git a/api-reference/beta/includes/rbac-for-apis/rbac-device-local-credentials-basic-apis-read.md b/api-reference/beta/includes/rbac-for-apis/rbac-device-local-credentials-basic-apis-read.md deleted file mode 100755 index 4a985435d72..00000000000 --- a/api-reference/beta/includes/rbac-for-apis/rbac-device-local-credentials-basic-apis-read.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -author: sandeo-MSFT -ms.topic: include ---- - -In delegated scenarios with work or school accounts, the signed-in user must be assigned a supported [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) or a custom role with a supported role permission. The following least privileged roles are supported for this operation. - -- Cloud Device Administrator -- Helpdesk Administrator -- Intune Service Administrator -- Security Administrator -- Security Reader -- Global Reader From 5ba0117c4dfe2e84a73c72f8a2191c5788b9673b Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 11 Nov 2024 17:00:31 -0600 Subject: [PATCH 269/308] Delete rbac-device-local-credentials-apis-read.md Removed file unrelated to SPE. --- .../rbac-device-local-credentials-apis-read.md | 18 ------------------ 1 file changed, 18 deletions(-) delete mode 100755 api-reference/v1.0/includes/rbac-for-apis/rbac-device-local-credentials-apis-read.md diff --git a/api-reference/v1.0/includes/rbac-for-apis/rbac-device-local-credentials-apis-read.md b/api-reference/v1.0/includes/rbac-for-apis/rbac-device-local-credentials-apis-read.md deleted file mode 100755 index 0e28f2562c8..00000000000 --- a/api-reference/v1.0/includes/rbac-for-apis/rbac-device-local-credentials-apis-read.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -author: sandeo-MSFT -ms.topic: include ---- - -In delegated scenarios with work or school accounts, the signed-in user must be assigned a supported [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) or a custom role with a supported role permission. The following least privileged roles are supported for this operation. - -- Cloud Device Administrator -- Helpdesk Administrator -- Intune Service Administrator -- Security Administrator -- Security Reader -- Global Reader - -To access the actual passwords on the device by using the `$select=credentials` query parameter, the calling user must be a user assigned to one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json): - -- Cloud Device Administrator -- Intune Service Administrator From 1ee23d323512f6f8861aee6a67e871cbaa000846 Mon Sep 17 00:00:00 2001 From: harmoneddie <138822459+harmoneddie@users.noreply.github.com> Date: Mon, 11 Nov 2024 17:01:50 -0600 Subject: [PATCH 270/308] Delete rbac-device-local-credentials-basic-apis-read.md Removed file unrelated to SPE. --- ...rbac-device-local-credentials-basic-apis-read.md | 13 ------------- 1 file changed, 13 deletions(-) delete mode 100755 api-reference/v1.0/includes/rbac-for-apis/rbac-device-local-credentials-basic-apis-read.md diff --git a/api-reference/v1.0/includes/rbac-for-apis/rbac-device-local-credentials-basic-apis-read.md b/api-reference/v1.0/includes/rbac-for-apis/rbac-device-local-credentials-basic-apis-read.md deleted file mode 100755 index 4a985435d72..00000000000 --- a/api-reference/v1.0/includes/rbac-for-apis/rbac-device-local-credentials-basic-apis-read.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -author: sandeo-MSFT -ms.topic: include ---- - -In delegated scenarios with work or school accounts, the signed-in user must be assigned a supported [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) or a custom role with a supported role permission. The following least privileged roles are supported for this operation. - -- Cloud Device Administrator -- Helpdesk Administrator -- Intune Service Administrator -- Security Administrator -- Security Reader -- Global Reader From f70e044bf1a1386300856673cf49b5a20445cfc6 Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Mon, 11 Nov 2024 17:23:43 -0600 Subject: [PATCH 271/308] Apply suggestions from code review --- .../v1.0/api/filestoragecontainer-restore-recyclebinitem.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-restore-recyclebinitem.md b/api-reference/v1.0/api/filestoragecontainer-restore-recyclebinitem.md index f30c17677df..7fb6ef39ab0 100644 --- a/api-reference/v1.0/api/filestoragecontainer-restore-recyclebinitem.md +++ b/api-reference/v1.0/api/filestoragecontainer-restore-recyclebinitem.md @@ -1,6 +1,6 @@ --- title: "Restore recycleBin item" -description: "Restore recycleBin item to a fileStorageContainer." +description: "Restore recycleBinItem to a fileStorageContainer." author: "harmoneddie" ms.localizationpriority: medium ms.subservice: "onedrive" From 41e8d56261dec2eb39c0b0ca503931f3b1c0f82d Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Mon, 11 Nov 2024 17:29:13 -0600 Subject: [PATCH 272/308] Update Microsoft.FileServices.json --- changelog/Microsoft.FileServices.json | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/changelog/Microsoft.FileServices.json b/changelog/Microsoft.FileServices.json index 833cc9a6e9c..1b2f3f2bee4 100644 --- a/changelog/Microsoft.FileServices.json +++ b/changelog/Microsoft.FileServices.json @@ -3954,7 +3954,7 @@ "Description": "Added the [Restore](https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-restore?view=graph-rest-1.0) operation to the [filestoragecontainer](https://learn.microsoft.com/en-us/graph/api/resources/filestoragecontainer?view=graph-rest-1.0) resource.", "Target": "filestoragecontainer" }, - { + { "Id": "d4cad5ca-ea99-4c26-bb63-35d74f43", "ApiChange": "Method", "ChangedApiName": "Unlock", @@ -3978,6 +3978,14 @@ "Description": "Added the [Update](https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-update-recyclebinsettings?view=graph-rest-1.0) operation to the [filestoragecontainer](https://learn.microsoft.com/en-us/graph/api/resources/filestoragecontainer?view=graph-rest-1.0) resource.", "Target": "filestoragecontainer" }, + { + "Id": "d4cad5ca-ea99-4c26-bb63-35d74f43", + "ApiChange": "Method", + "ChangedApiName": "List", + "ChangeType": "Addition", + "Description": "Added the [List items](https://learn.microsoft.com/en-us/graph/api/recyclebin-list-items?view=graph-rest-1.0) operation to the [recyclebin](https://learn.microsoft.com/en-us/graph/api/resources/recyclebin?view=graph-rest-1.0) resource.", + "Target": "recyclebin" + }, { "Id": "d4cad5ca-ea99-4c26-bb63-35d74f43", "ApiChange": "Resource", From d70556637b4e28dd8977f73a41ae55f71640b976 Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Mon, 11 Nov 2024 17:45:30 -0600 Subject: [PATCH 273/308] Delete api-reference/beta/api/security-identitycontainer-delete-sensors.md --- ...curity-identitycontainer-delete-sensors.md | 113 ------------------ 1 file changed, 113 deletions(-) delete mode 100755 api-reference/beta/api/security-identitycontainer-delete-sensors.md diff --git a/api-reference/beta/api/security-identitycontainer-delete-sensors.md b/api-reference/beta/api/security-identitycontainer-delete-sensors.md deleted file mode 100755 index 74aed403e4e..00000000000 --- a/api-reference/beta/api/security-identitycontainer-delete-sensors.md +++ /dev/null @@ -1,113 +0,0 @@ ---- -title: "Delete sensor" -description: "Delete a sensor object." -author: "amirfeldman" -ms.localizationpriority: medium -ms.subservice: "security" -doc_type: apiPageType -ms.date: 09/10/2024 ---- - -# Delete sensor - -Namespace: microsoft.graph.security - -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] - -Delete a [sensor](../resources/security-sensor.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). - - -[!INCLUDE [permissions-table](../includes/permissions/security-identitycontainer-delete-sensors-permissions.md)] - -## HTTP request - - -``` http -DELETE /security/identities/sensors/{sensorId} -``` - -## 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 `204 No Content` response code. - -## Examples - -### Request - -The following example shows a request. -# [HTTP](#tab/http) - -``` http -DELETE https://graph.microsoft.com/beta/security/identities/sensors/d31dd827-92cd-4cd6-b269-c151a0eec55d -``` - -# [C#](#tab/csharp) -[!INCLUDE [sample-code](../includes/snippets/csharp/delete-sensor-csharp-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [CLI](#tab/cli) -[!INCLUDE [sample-code](../includes/snippets/cli/delete-sensor-cli-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [Go](#tab/go) -[!INCLUDE [sample-code](../includes/snippets/go/delete-sensor-go-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [Java](#tab/java) -[!INCLUDE [sample-code](../includes/snippets/java/delete-sensor-java-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [JavaScript](#tab/javascript) -[!INCLUDE [sample-code](../includes/snippets/javascript/delete-sensor-javascript-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [PHP](#tab/php) -[!INCLUDE [sample-code](../includes/snippets/php/delete-sensor-php-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [PowerShell](#tab/powershell) -[!INCLUDE [sample-code](../includes/snippets/powershell/delete-sensor-powershell-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [Python](#tab/python) -[!INCLUDE [sample-code](../includes/snippets/python/delete-sensor-python-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - ---- - -### Response - -The following example shows the response. - - -``` http -HTTP/1.1 204 No Content -``` From aedc15995be472e427858f1d0135c1be3c4c2372 Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Mon, 11 Nov 2024 17:48:06 -0600 Subject: [PATCH 274/308] Delete api-reference/beta/includes/permissions/security-identitycontainer-delete-sensors-permissions.md --- ...curity-identitycontainer-delete-sensors-permissions.md | 8 -------- 1 file changed, 8 deletions(-) delete mode 100755 api-reference/beta/includes/permissions/security-identitycontainer-delete-sensors-permissions.md diff --git a/api-reference/beta/includes/permissions/security-identitycontainer-delete-sensors-permissions.md b/api-reference/beta/includes/permissions/security-identitycontainer-delete-sensors-permissions.md deleted file mode 100755 index d8c95f88267..00000000000 --- a/api-reference/beta/includes/permissions/security-identitycontainer-delete-sensors-permissions.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" -ms.topic: include -ms.localizationpriority: medium ---- - -|Permission type|Least privileged permissions|Higher privileged permissions| -|:---|:---|:---| \ No newline at end of file From 98410c25d9aa1e27e6c5e2b95705bd11e8af2b16 Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Mon, 11 Nov 2024 17:51:56 -0600 Subject: [PATCH 275/308] Delete api-reference/beta/includes/snippets/javascript/get-pagetemplate-javascript-snippets.md --- .../get-pagetemplate-javascript-snippets.md | 17 ----------------- 1 file changed, 17 deletions(-) delete mode 100755 api-reference/beta/includes/snippets/javascript/get-pagetemplate-javascript-snippets.md diff --git a/api-reference/beta/includes/snippets/javascript/get-pagetemplate-javascript-snippets.md b/api-reference/beta/includes/snippets/javascript/get-pagetemplate-javascript-snippets.md deleted file mode 100755 index 4bd45f0e6b9..00000000000 --- a/api-reference/beta/includes/snippets/javascript/get-pagetemplate-javascript-snippets.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" ---- - -```javascript - -const options = { - authProvider, -}; - -const client = Client.init(options); - -let pageTemplate = await client.api('/sites/dd00d52e-0db7-4d5f-8269-90060ac688d1/pageTemplates/microsoft.graph.pageTemplate/f6ed8c43-9923-4c6c-ba09-9c32b8f10aeb') - .version('beta') - .get(); - -``` \ No newline at end of file From 253cfa84663f9a4a0e4b7531f6f1882cca38ab0f Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Mon, 11 Nov 2024 17:55:40 -0600 Subject: [PATCH 276/308] Delete includes/namepronunciation-boundary-warning-note.md --- includes/namepronunciation-boundary-warning-note.md | 11 ----------- 1 file changed, 11 deletions(-) delete mode 100755 includes/namepronunciation-boundary-warning-note.md diff --git a/includes/namepronunciation-boundary-warning-note.md b/includes/namepronunciation-boundary-warning-note.md deleted file mode 100755 index 65f063c1961..00000000000 --- a/includes/namepronunciation-boundary-warning-note.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -author: fondieki -ms.topic: include -ms.date: 10/09/2024 -ms.localizationpriority: medium ---- - - - -> [!NOTE] -> Data is sent outside the Microsoft 365 data boundary to the Microsoft Defender Endpoint for malware scanning. By turning the toggle on, you're consenting to this data flow. Data is not stored outside the Microsoft 365 data boundary. From 9cb32d24d497176db69a2a0304c989eaa42495aa Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Mon, 11 Nov 2024 18:11:07 -0600 Subject: [PATCH 277/308] Apply suggestions from code review --- api-reference/beta/api/filestoragecontainer-post.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/api/filestoragecontainer-post.md b/api-reference/beta/api/filestoragecontainer-post.md index 5b7ad532bc8..bafe6b5e246 100644 --- a/api-reference/beta/api/filestoragecontainer-post.md +++ b/api-reference/beta/api/filestoragecontainer-post.md @@ -45,7 +45,7 @@ This method supports the following OData query parameters to help customize the | Name |Description| |:----------|:----------| -| dataLocation | Use the `$dataLocation` query parameter to specify the desired data location for container creation in Multi-Geo tenants. Omitting the `$dataLocation` parameter in the request will create the container at the tenant's default location. Learn more about [available Multi-Geo regions and their location codes](https://learn.microsoft.com/en-us/microsoft-365/enterprise/microsoft-365-multi-geo?view=o365-worldwide#microsoft-365-multi-geo-availability). | +| dataLocation | Use the `$dataLocation` query parameter to specify the desired data location for container creation in Multi-Geo tenants. Omitting the `$dataLocation` parameter in the request will create the container at the tenant's default location. Learn more about [available Multi-Geo regions and their location codes](https://learn.microsoft.com/microsoft-365/enterprise/microsoft-365-multi-geo?view=o365-worldwide#microsoft-365-multi-geo-availability). | ## Request headers |Name|Description| From cad952a3f0ae4d3cee87e7cb61ca438cbf9d1ff4 Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Mon, 11 Nov 2024 18:53:33 -0600 Subject: [PATCH 278/308] Apply suggestions from code review --- api-reference/v1.0/api/filestoragecontainer-post.md | 2 +- .../v1.0/api/filestoragecontainer-restore-recyclebinitem.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-post.md b/api-reference/v1.0/api/filestoragecontainer-post.md index c4f9759dba3..01a4da96c9b 100644 --- a/api-reference/v1.0/api/filestoragecontainer-post.md +++ b/api-reference/v1.0/api/filestoragecontainer-post.md @@ -43,7 +43,7 @@ This method supports the following OData query parameters to help customize the | Name |Description| |:----------|:----------| -| dataLocation | Use the `$dataLocation` query parameter to specify the desired data location for container creation in Multi-Geo tenants. Omitting the `$dataLocation` parameter in the request will create the container at the tenant's default location. Learn more about [available Multi-Geo regions and their location codes](https://learn.microsoft.com/en-us/microsoft-365/enterprise/microsoft-365-multi-geo?view=o365-worldwide#microsoft-365-multi-geo-availability). | +| dataLocation | Use the `$dataLocation` query parameter to specify the desired data location for container creation in Multi-Geo tenants. Omitting the `$dataLocation` parameter in the request will create the container at the tenant's default location. Learn more about [available Multi-Geo regions and their location codes](https://learn.microsoft.com/microsoft-365/enterprise/microsoft-365-multi-geo?view=o365-worldwide#microsoft-365-multi-geo-availability). | ## Request headers |Name|Description| diff --git a/api-reference/v1.0/api/filestoragecontainer-restore-recyclebinitem.md b/api-reference/v1.0/api/filestoragecontainer-restore-recyclebinitem.md index 7fb6ef39ab0..bd329b753e3 100644 --- a/api-reference/v1.0/api/filestoragecontainer-restore-recyclebinitem.md +++ b/api-reference/v1.0/api/filestoragecontainer-restore-recyclebinitem.md @@ -7,7 +7,7 @@ ms.subservice: "onedrive" doc_type: apiPageType --- -# Restore recycle bin item +# Restore recycleBinItem Namespace: microsoft.graph From af24e3dd25c5915e9873fe1cf596a5d578d6d351 Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Mon, 11 Nov 2024 19:08:59 -0600 Subject: [PATCH 279/308] Apply suggestions from code review --- api-reference/beta/api/filestoragecontainer-post.md | 2 +- api-reference/v1.0/api/filestoragecontainer-post.md | 2 +- api-reference/v1.0/resources/recyclebinitem.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/api-reference/beta/api/filestoragecontainer-post.md b/api-reference/beta/api/filestoragecontainer-post.md index bafe6b5e246..8aaff91a036 100644 --- a/api-reference/beta/api/filestoragecontainer-post.md +++ b/api-reference/beta/api/filestoragecontainer-post.md @@ -45,7 +45,7 @@ This method supports the following OData query parameters to help customize the | Name |Description| |:----------|:----------| -| dataLocation | Use the `$dataLocation` query parameter to specify the desired data location for container creation in Multi-Geo tenants. Omitting the `$dataLocation` parameter in the request will create the container at the tenant's default location. Learn more about [available Multi-Geo regions and their location codes](https://learn.microsoft.com/microsoft-365/enterprise/microsoft-365-multi-geo?view=o365-worldwide#microsoft-365-multi-geo-availability). | +| dataLocation |Specifies the desired data location for container creation in Multi-Geo tenants. Omitting the `$dataLocation` parameter in the request creates the container at the tenant's default location. For more information, see [available Multi-Geo regions and their location codes](https://learn.microsoft.com/microsoft-365/enterprise/microsoft-365-multi-geo?view=o365-worldwide#microsoft-365-multi-geo-availability). | ## Request headers |Name|Description| diff --git a/api-reference/v1.0/api/filestoragecontainer-post.md b/api-reference/v1.0/api/filestoragecontainer-post.md index 01a4da96c9b..dfe05a12a1f 100644 --- a/api-reference/v1.0/api/filestoragecontainer-post.md +++ b/api-reference/v1.0/api/filestoragecontainer-post.md @@ -43,7 +43,7 @@ This method supports the following OData query parameters to help customize the | Name |Description| |:----------|:----------| -| dataLocation | Use the `$dataLocation` query parameter to specify the desired data location for container creation in Multi-Geo tenants. Omitting the `$dataLocation` parameter in the request will create the container at the tenant's default location. Learn more about [available Multi-Geo regions and their location codes](https://learn.microsoft.com/microsoft-365/enterprise/microsoft-365-multi-geo?view=o365-worldwide#microsoft-365-multi-geo-availability). | +| dataLocation | Specifies the desired data location for container creation in Multi-Geo tenants. Omitting the `$dataLocation` parameter in the request creates the container at the tenant's default location. Learn more about [available Multi-Geo regions and their location codes](https://learn.microsoft.com/microsoft-365/enterprise/microsoft-365-multi-geo?view=o365-worldwide#microsoft-365-multi-geo-availability). | ## Request headers |Name|Description| diff --git a/api-reference/v1.0/resources/recyclebinitem.md b/api-reference/v1.0/resources/recyclebinitem.md index 7b64b845310..70e11a0d297 100644 --- a/api-reference/v1.0/resources/recyclebinitem.md +++ b/api-reference/v1.0/resources/recyclebinitem.md @@ -24,7 +24,7 @@ Inherits from [baseItem](baseitem.md). ## Properties | Property | Type | Description | -|:--------------------|:---------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +|:--------------------|:---------------|:------------------| | deletedDateTime | DateTimeOffset | Date and time when the item was deleted. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. | | deletedFromLocation | String | Relative URL of the list or folder that originally contained the item. | | id | String | Unique identifier of the delete transaction. Inherited from [baseItem](baseitem.md). | From 16c06ffbbea92913264b9559d9a267e6f466bfc2 Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Mon, 11 Nov 2024 19:24:23 -0600 Subject: [PATCH 280/308] Apply suggestions from code review --- api-reference/beta/api/filestoragecontainer-post.md | 2 +- api-reference/v1.0/api/filestoragecontainer-post.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/api/filestoragecontainer-post.md b/api-reference/beta/api/filestoragecontainer-post.md index 8aaff91a036..e678b1a85fd 100644 --- a/api-reference/beta/api/filestoragecontainer-post.md +++ b/api-reference/beta/api/filestoragecontainer-post.md @@ -45,7 +45,7 @@ This method supports the following OData query parameters to help customize the | Name |Description| |:----------|:----------| -| dataLocation |Specifies the desired data location for container creation in Multi-Geo tenants. Omitting the `$dataLocation` parameter in the request creates the container at the tenant's default location. For more information, see [available Multi-Geo regions and their location codes](https://learn.microsoft.com/microsoft-365/enterprise/microsoft-365-multi-geo?view=o365-worldwide#microsoft-365-multi-geo-availability). | +| dataLocation |Specifies the desired data location for container creation in Multi-Geo tenants. Omitting the `$dataLocation` parameter in the request creates the container at the tenant's default location. For more information, see [available Multi-Geo regions and their location codes]/microsoft-365/enterprise/microsoft-365-multi-geo?view=o365-worldwide#microsoft-365-multi-geo-availability). | ## Request headers |Name|Description| diff --git a/api-reference/v1.0/api/filestoragecontainer-post.md b/api-reference/v1.0/api/filestoragecontainer-post.md index dfe05a12a1f..15d733998b1 100644 --- a/api-reference/v1.0/api/filestoragecontainer-post.md +++ b/api-reference/v1.0/api/filestoragecontainer-post.md @@ -43,7 +43,7 @@ This method supports the following OData query parameters to help customize the | Name |Description| |:----------|:----------| -| dataLocation | Specifies the desired data location for container creation in Multi-Geo tenants. Omitting the `$dataLocation` parameter in the request creates the container at the tenant's default location. Learn more about [available Multi-Geo regions and their location codes](https://learn.microsoft.com/microsoft-365/enterprise/microsoft-365-multi-geo?view=o365-worldwide#microsoft-365-multi-geo-availability). | +| dataLocation |Specifies the desired data location for container creation in Multi-Geo tenants. Omitting the `$dataLocation` parameter in the request creates the container at the tenant's default location. For more information, see [available Multi-Geo regions and their location codes](/microsoft-365/enterprise/microsoft-365-multi-geo?view=o365-worldwide#microsoft-365-multi-geo-availability). | ## Request headers |Name|Description| From d002ae5fea03a1a31a07724cddbaf89ac37a4824 Mon Sep 17 00:00:00 2001 From: Gautam Jain Date: Mon, 11 Nov 2024 17:42:46 -0800 Subject: [PATCH 281/308] feedback addressed --- api-reference/beta/resources/copilotadmin.md | 4 ++-- api-reference/beta/resources/copilotadminsetting.md | 6 +++--- api-reference/beta/resources/copilotroot.md | 4 ++-- 3 files changed, 7 insertions(+), 7 deletions(-) diff --git a/api-reference/beta/resources/copilotadmin.md b/api-reference/beta/resources/copilotadmin.md index 3a0870f93fb..d80167b21d8 100644 --- a/api-reference/beta/resources/copilotadmin.md +++ b/api-reference/beta/resources/copilotadmin.md @@ -1,6 +1,6 @@ --- title: "copilotAdmin resource type" -description: "Represents a navigation property for Copilot admin. Copilot admin can add or modify Copilot settings." +description: "Represents a Microsoft 365 Copilot admin who can add or modify Microsoft 365 Copilot settings" author: "gautamjain14" ms.localizationpriority: medium ms.subservice: "meetings-copilot" @@ -21,7 +21,7 @@ Inherits from [entity](../resources/entity.md). ## Relationships |Relationship|Type|Description| |:---|:---|:---| -|settings|[Settings](../resources/copilotadminsetting.md)|Set of Copilot settings that can be added or modified.. Navigation property. Read-only. Nullable.| +|settings|[copilotAdminSettings](../resources/copilotadminsetting.md)|Set of Copilot settings that can be added or modified.. Navigation property. Read-only. Nullable.| ## JSON representation The following JSON representation shows the resource type. diff --git a/api-reference/beta/resources/copilotadminsetting.md b/api-reference/beta/resources/copilotadminsetting.md index dd68e7bce48..7258c01a632 100644 --- a/api-reference/beta/resources/copilotadminsetting.md +++ b/api-reference/beta/resources/copilotadminsetting.md @@ -1,6 +1,6 @@ --- title: "copilotAdminSetting resource type" -description: "Represents a navigation property for set of Copilot settings." +description: "Represents a navigation property for set of Microsoft 365 Copilot settings." author: "gautamjain14" ms.localizationpriority: medium ms.subservice: "meetings-copilot" @@ -13,7 +13,7 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents a navigation property for Copilot settings. +Represents an admin setting for Microsoft 365 Copilot. Inherits from [entity](../resources/entity.md). @@ -21,7 +21,7 @@ Inherits from [entity](../resources/entity.md). ## Relationships |Relationship|Type|Description| |:---|:---|:---| -|limitedMode|[LimitedMode](../resources/copilotadminlimitedmode.md)|Add or modify copilot limited mode. Navigation property. Read-only. Nullable.| +|limitedMode|[copilotAdminLimitedMode](../resources/copilotadminlimitedmode.md)|Represents a setting that controls whether Microsoft 365 Copilot users can receive responses to sentiment-related prompts. Read-only. Nullable.| ## JSON representation The following JSON representation shows the resource type. diff --git a/api-reference/beta/resources/copilotroot.md b/api-reference/beta/resources/copilotroot.md index b7d1126e123..2af2b173bb1 100644 --- a/api-reference/beta/resources/copilotroot.md +++ b/api-reference/beta/resources/copilotroot.md @@ -13,12 +13,12 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents a navigation property for Copilot controls. +A container for Microsoft 365 Copilot admin controls. ## Relationships |Relationship|Type|Description| |:---|:---|:---| -|admin|[Admin](../resources/copilotadmin.md)|Copilot admin can add or modify Copilot settings. Navigation property. Read-only. Nullable.| +|admin|[copilotAdmin](../resources/copilotadmin.md)|The Microsoft 365 Copilot admin who can add or modify Copilot settings. Read-only. Nullable.| ## JSON representation The following JSON representation shows the resource type. From dad8faf794d5fdc1fd7d2516b0c50988d2ce4a8c Mon Sep 17 00:00:00 2001 From: Laura Graham Date: Mon, 11 Nov 2024 17:49:20 -0800 Subject: [PATCH 282/308] Update copilotadmin.md --- api-reference/beta/resources/copilotadmin.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/api-reference/beta/resources/copilotadmin.md b/api-reference/beta/resources/copilotadmin.md index d80167b21d8..0e478909b17 100644 --- a/api-reference/beta/resources/copilotadmin.md +++ b/api-reference/beta/resources/copilotadmin.md @@ -1,6 +1,6 @@ --- title: "copilotAdmin resource type" -description: "Represents a Microsoft 365 Copilot admin who can add or modify Microsoft 365 Copilot settings" +description: "Represents a Microsoft 365 admin who can add or modify Microsoft 365 Copilot settings." author: "gautamjain14" ms.localizationpriority: medium ms.subservice: "meetings-copilot" @@ -13,15 +13,19 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents a navigation property for Copilot admin. Copilot admin can add or modify Copilot settings. +Represents a Microsoft 365 admin who can add or modify Microsoft 365 Copilot settings. Inherits from [entity](../resources/entity.md). +## Properties + +None. + ## Relationships |Relationship|Type|Description| |:---|:---|:---| -|settings|[copilotAdminSettings](../resources/copilotadminsetting.md)|Set of Copilot settings that can be added or modified.. Navigation property. Read-only. Nullable.| +|settings|[copilotAdminSettings](../resources/copilotadminsetting.md)|Set of Copilot settings that can be added or modified. Navigation property. Read-only. Nullable.| ## JSON representation The following JSON representation shows the resource type. From 6520476d2d25ee5ee0cd6eddb5eb858aa3dcc237 Mon Sep 17 00:00:00 2001 From: Laura Graham Date: Mon, 11 Nov 2024 17:50:31 -0800 Subject: [PATCH 283/308] Update copilotadminsetting.md --- api-reference/beta/resources/copilotadminsetting.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/api-reference/beta/resources/copilotadminsetting.md b/api-reference/beta/resources/copilotadminsetting.md index 7258c01a632..127f38e5e43 100644 --- a/api-reference/beta/resources/copilotadminsetting.md +++ b/api-reference/beta/resources/copilotadminsetting.md @@ -1,6 +1,6 @@ --- title: "copilotAdminSetting resource type" -description: "Represents a navigation property for set of Microsoft 365 Copilot settings." +description: "Represents an admin setting for Microsoft 365 Copilot." author: "gautamjain14" ms.localizationpriority: medium ms.subservice: "meetings-copilot" @@ -18,6 +18,10 @@ Represents an admin setting for Microsoft 365 Copilot. Inherits from [entity](../resources/entity.md). +## Properties + +None. + ## Relationships |Relationship|Type|Description| |:---|:---|:---| From 4bedcdd1c468d1e97ca4dac444420fb44215507a Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Mon, 11 Nov 2024 19:51:59 -0600 Subject: [PATCH 284/308] Apply suggestions from code review --- api-reference/beta/api/filestoragecontainer-post.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/api/filestoragecontainer-post.md b/api-reference/beta/api/filestoragecontainer-post.md index e678b1a85fd..18295b285b4 100644 --- a/api-reference/beta/api/filestoragecontainer-post.md +++ b/api-reference/beta/api/filestoragecontainer-post.md @@ -45,7 +45,7 @@ This method supports the following OData query parameters to help customize the | Name |Description| |:----------|:----------| -| dataLocation |Specifies the desired data location for container creation in Multi-Geo tenants. Omitting the `$dataLocation` parameter in the request creates the container at the tenant's default location. For more information, see [available Multi-Geo regions and their location codes]/microsoft-365/enterprise/microsoft-365-multi-geo?view=o365-worldwide#microsoft-365-multi-geo-availability). | +| dataLocation |Specifies the desired data location for container creation in Multi-Geo tenants. Omitting the `$dataLocation` parameter in the request creates the container at the tenant's default location. For more information, see [available Multi-Geo regions and their location codes](/microsoft-365/enterprise/microsoft-365-multi-geo?view=o365-worldwide#microsoft-365-multi-geo-availability). | ## Request headers |Name|Description| From b1a5eba84b0042d6476271efeac6a1013358fbbc Mon Sep 17 00:00:00 2001 From: Laura Graham Date: Mon, 11 Nov 2024 17:52:08 -0800 Subject: [PATCH 285/308] Update copilotroot.md --- api-reference/beta/resources/copilotroot.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/api-reference/beta/resources/copilotroot.md b/api-reference/beta/resources/copilotroot.md index 2af2b173bb1..7b380e18ef2 100644 --- a/api-reference/beta/resources/copilotroot.md +++ b/api-reference/beta/resources/copilotroot.md @@ -1,6 +1,6 @@ --- title: "copilotRoot resource type" -description: "Represents a navigation property for Copilot controls." +description: "A container for Microsoft 365 Copilot admin controls." author: "gautamjain14" ms.localizationpriority: medium ms.subservice: "meetings-copilot" @@ -15,6 +15,10 @@ Namespace: microsoft.graph A container for Microsoft 365 Copilot admin controls. +## Properties + +None. + ## Relationships |Relationship|Type|Description| |:---|:---|:---| From 84a5421b3ec7b3f5aa1cdc1ac26be0e1db35615f Mon Sep 17 00:00:00 2001 From: Laura Graham Date: Mon, 11 Nov 2024 18:00:53 -0800 Subject: [PATCH 286/308] Update toc.mapping.json --- api-reference/beta/toc/toc.mapping.json | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/api-reference/beta/toc/toc.mapping.json b/api-reference/beta/toc/toc.mapping.json index d141114cbbf..cfdecd2af0e 100644 --- a/api-reference/beta/toc/toc.mapping.json +++ b/api-reference/beta/toc/toc.mapping.json @@ -2862,6 +2862,11 @@ "name": "Copilot settings", "resources": [ "copilotAdminLimitedMode" + ], + "complexTypes": [ + "copilotAdmin", + "copilotAdminSetting", + "copilotRoot" ] }, { From d2a65f67d22d6b9425be18c4d875bb0916bdd5fd Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Mon, 11 Nov 2024 20:15:07 -0600 Subject: [PATCH 287/308] Update toc.mapping.json --- api-reference/v1.0/toc/toc.mapping.json | 1 + 1 file changed, 1 insertion(+) diff --git a/api-reference/v1.0/toc/toc.mapping.json b/api-reference/v1.0/toc/toc.mapping.json index 20f9eea8dc9..becf0af0578 100644 --- a/api-reference/v1.0/toc/toc.mapping.json +++ b/api-reference/v1.0/toc/toc.mapping.json @@ -1635,6 +1635,7 @@ "contentType", "listItem", "documentSetVersion", + "recycleBinItem", "richLongRunningOperation", "sharepointSettings" ], From f0902ef2b984677cc69654f967c6a9b0b29311f6 Mon Sep 17 00:00:00 2001 From: Microsoft Graph DevX Tooling Date: Tue, 12 Nov 2024 02:20:04 +0000 Subject: [PATCH 288/308] Update reference TOC --- api-reference/v1.0/toc/files/toc.yml | 30 +++++++++++++++++-- .../v1.0/toc/sites-and-lists/toc.yml | 6 ++++ 2 files changed, 34 insertions(+), 2 deletions(-) diff --git a/api-reference/v1.0/toc/files/toc.yml b/api-reference/v1.0/toc/files/toc.yml index 63b32ff42d6..bc279bd39ee 100644 --- a/api-reference/v1.0/toc/files/toc.yml +++ b/api-reference/v1.0/toc/files/toc.yml @@ -144,13 +144,17 @@ items: href: ../../api/filestorage-delete-containers.md - name: Activate href: ../../api/filestoragecontainer-activate.md + - name: Restore deleted + href: ../../api/filestoragecontainer-restore.md + - name: Remove deleted + href: ../../api/filestorage-delete-deletedcontainers.md - name: Permanently delete href: ../../api/filestoragecontainer-permanentdelete.md - name: Get drive href: ../../api/filestoragecontainer-get-drive.md - name: List permissions href: ../../api/filestoragecontainer-list-permissions.md - - name: Create permissions + - name: Add permissions href: ../../api/filestoragecontainer-post-permissions.md - name: Update permissions href: ../../api/filestoragecontainer-update-permissions.md @@ -158,12 +162,34 @@ items: href: ../../api/filestoragecontainer-delete-permissions.md - name: List custom property href: ../../api/filestoragecontainer-list-customproperty.md - - name: Create custom property + - name: Add custom property href: ../../api/filestoragecontainer-post-customproperty.md - name: Update custom property href: ../../api/filestoragecontainer-update-customproperty.md - name: Delete custom property href: ../../api/filestoragecontainer-delete-customproperty.md + - name: List columns + href: ../../api/filestoragecontainer-list-columns.md + - name: Add column + href: ../../api/filestoragecontainer-post-columns.md + - name: Update column + href: ../../api/filestoragecontainer-update-column.md + - name: Delete file storage container column + href: ../../api/filestoragecontainer-delete-column.md + - name: Get column + href: ../../api/filestoragecontainer-get-column.md + - name: Update recycle bin settings + href: ../../api/filestoragecontainer-update-recyclebinsettings.md + - name: Restore recycle bin items + href: ../../api/filestoragecontainer-restore-recyclebinitem.md + - name: Delete recycle bin items + href: ../../api/filestoragecontainer-delete-recyclebinitem.md + - name: Get recycle bin items + href: ../../api/filestoragecontainer-list-recyclebinitem.md + - name: Lock + href: ../../api/filestoragecontainer-lock.md + - name: Unlock + href: ../../api/filestoragecontainer-unlock.md - name: Shared drive item items: - name: Shared drive item diff --git a/api-reference/v1.0/toc/sites-and-lists/toc.yml b/api-reference/v1.0/toc/sites-and-lists/toc.yml index 6aa6a11fb0c..7e4bf4f24f6 100644 --- a/api-reference/v1.0/toc/sites-and-lists/toc.yml +++ b/api-reference/v1.0/toc/sites-and-lists/toc.yml @@ -168,6 +168,12 @@ items: href: ../../api/documentsetversion-delete.md - name: Restore href: ../../api/documentsetversion-restore.md +- name: Recycle bin item + items: + - name: Recycle bin item + href: ../../resources/recyclebinitem.md + - name: List + href: ../../api/recyclebin-list-items.md - name: Rich long running operation items: - name: Rich long running operation From 970a2848c6d29a9e46ca861403e2ec50b73eded3 Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Mon, 11 Nov 2024 20:27:49 -0600 Subject: [PATCH 289/308] Apply suggestions from code review --- .../v1.0/api/filestoragecontainer-list-recyclebinitem.md | 6 +++--- .../v1.0/api/filestoragecontainer-restore-recyclebinitem.md | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-list-recyclebinitem.md b/api-reference/v1.0/api/filestoragecontainer-list-recyclebinitem.md index b399b630a2b..03dbf84f8c8 100644 --- a/api-reference/v1.0/api/filestoragecontainer-list-recyclebinitem.md +++ b/api-reference/v1.0/api/filestoragecontainer-list-recyclebinitem.md @@ -1,13 +1,13 @@ --- -title: "List recycleBin items" -description: "Get a list of recycle bin items from a fileStorageContainer recycleBin." +title: "List recycleBinItems" +description: "Get a list of recycleBinItems from a fileStorageContainer recycleBin." author: "harmoneddie" ms.localizationpriority: medium ms.subservice: "onedrive" doc_type: apiPageType --- -# List recycleBin items +# List recycleBinItems Namespace: microsoft.graph diff --git a/api-reference/v1.0/api/filestoragecontainer-restore-recyclebinitem.md b/api-reference/v1.0/api/filestoragecontainer-restore-recyclebinitem.md index bd329b753e3..43925e45036 100644 --- a/api-reference/v1.0/api/filestoragecontainer-restore-recyclebinitem.md +++ b/api-reference/v1.0/api/filestoragecontainer-restore-recyclebinitem.md @@ -1,5 +1,5 @@ --- -title: "Restore recycleBin item" +title: "Restore recycleBinItem" description: "Restore recycleBinItem to a fileStorageContainer." author: "harmoneddie" ms.localizationpriority: medium From c4cd1207c3245d20107d53bb2d220bf71598e2c2 Mon Sep 17 00:00:00 2001 From: Daniela Bonilla Montero <92937694+Danielabom@users.noreply.github.com> Date: Mon, 11 Nov 2024 20:48:06 -0600 Subject: [PATCH 290/308] Apply suggestions from code review --- api-reference/v1.0/resources/filestoragecontainer.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/v1.0/resources/filestoragecontainer.md b/api-reference/v1.0/resources/filestoragecontainer.md index d5b5f194a26..464cd4dbe34 100644 --- a/api-reference/v1.0/resources/filestoragecontainer.md +++ b/api-reference/v1.0/resources/filestoragecontainer.md @@ -23,8 +23,8 @@ Represents a location where multiple users or a group of users can store files a |[Update](../api/filestoragecontainer-update.md)|[fileStorageContainer](../resources/filestoragecontainer.md)|Update the properties of a [fileStorageContainer](../resources/filestoragecontainer.md) object.| |[Delete](../api/filestorage-delete-containers.md)|None|Delete a [fileStorageContainer](../resources/filestoragecontainer.md) object.| |[Activate](../api/filestoragecontainer-activate.md)|None|Activate a [fileStorageContainer](../resources/filestoragecontainer.md) object.| -|[Restore deleted](../api/filestoragecontainer-restore.md)|[fileStorageContainer](../resources/filestoragecontainer.md)|Restore a deleted [fileStorageContainer](../resources/filestoragecontainer.md) object.| -|[Remove deleted](../api/filestorage-delete-deletedcontainers.md)|None|Remove a deleted [fileStorageContainer](../resources/filestoragecontainer.md) object.| +|[Restore deleted container](../api/filestoragecontainer-restore.md)|[fileStorageContainer](../resources/filestoragecontainer.md)|Restore a deleted [fileStorageContainer](../resources/filestoragecontainer.md) object.| +|[Remove deleted containers](../api/filestorage-delete-deletedcontainers.md)|None|Remove a deleted [fileStorageContainer](../resources/filestoragecontainer.md) object.| |[Permanently delete](../api/filestoragecontainer-permanentdelete.md)|None|Permanently delete a [fileStorageContainer](../resources/filestoragecontainer.md) object.| |[Get drive](../api/filestoragecontainer-get-drive.md)|[drive](../resources/drive.md)|Get the drive resource from a [fileStorageContainer](../resources/filestoragecontainer.md) object.| |[List permissions](../api/filestoragecontainer-list-permissions.md)|[permission](../resources/permission.md)| List permissions on a fileStorageContainer.| From 1f22a879781d013183200a17b2a857d9a99cca4a Mon Sep 17 00:00:00 2001 From: Tony Chan <107155297+tonchan-msft@users.noreply.github.com> Date: Mon, 11 Nov 2024 19:18:37 -0800 Subject: [PATCH 291/308] Update filestoragecontainer-delete-permissions.md --- .../v1.0/api/filestoragecontainer-delete-permissions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-delete-permissions.md b/api-reference/v1.0/api/filestoragecontainer-delete-permissions.md index 19207987650..3f550ddc2d7 100644 --- a/api-reference/v1.0/api/filestoragecontainer-delete-permissions.md +++ b/api-reference/v1.0/api/filestoragecontainer-delete-permissions.md @@ -14,7 +14,7 @@ Namespace: microsoft.graph Delete permissions from a [fileStorageContainer](../resources/filestoragecontainer.md) object. -By default, this API removes access for an identity to the container and all items within the container, regardless of whether the identity has container-scoped or item-level permissions. You can optimize this behavior by adding an optional `Prefer: onlyRemoveContainerScopedPermission` header when you call the API. When you include the `Prefer: onlyRemoveContainerScopedPermission` header, only the identity's container-scoped permission is removed. All item-level permissions explicitly granted to the identity (if any) are retained. +By default, this API removes access for an identity to the container and all items within the container, regardless of whether the identity has container-scoped or item-level permissions. You can add an optional `Prefer: onlyRemoveContainerScopedPermission` header when you call the API if only the identity's container-scoped permissions need to be removed. All item-level permissions explicitly granted to the identity (if any) are retained. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] From a831d209d44c10b6f21ccd6c237d7ee484184e1d Mon Sep 17 00:00:00 2001 From: Tony Chan <107155297+tonchan-msft@users.noreply.github.com> Date: Mon, 11 Nov 2024 19:19:40 -0800 Subject: [PATCH 292/308] Update filestoragecontainer-delete-permissions.md --- .../v1.0/api/filestoragecontainer-delete-permissions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/filestoragecontainer-delete-permissions.md b/api-reference/v1.0/api/filestoragecontainer-delete-permissions.md index 3f550ddc2d7..e6697466def 100644 --- a/api-reference/v1.0/api/filestoragecontainer-delete-permissions.md +++ b/api-reference/v1.0/api/filestoragecontainer-delete-permissions.md @@ -14,7 +14,7 @@ Namespace: microsoft.graph Delete permissions from a [fileStorageContainer](../resources/filestoragecontainer.md) object. -By default, this API removes access for an identity to the container and all items within the container, regardless of whether the identity has container-scoped or item-level permissions. You can add an optional `Prefer: onlyRemoveContainerScopedPermission` header when you call the API if only the identity's container-scoped permissions need to be removed. All item-level permissions explicitly granted to the identity (if any) are retained. +By default, this API removes access for an identity to the container and all items within the container, regardless of whether the identity has container-scoped or item-level permissions. You can add an optional `Prefer: onlyRemoveContainerScopedPermission` header when you call the API if only the identity's container-scoped permissions need to be removed. All item-level permissions explicitly granted to the identity (if any) are retained. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] From 62dbf8650bb63c0e49b2947ddf80cecbd7752145 Mon Sep 17 00:00:00 2001 From: Tony Chan <107155297+tonchan-msft@users.noreply.github.com> Date: Mon, 11 Nov 2024 19:21:29 -0800 Subject: [PATCH 293/308] Update filestoragecontainer-delete-permissions.md --- .../beta/api/filestoragecontainer-delete-permissions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/api/filestoragecontainer-delete-permissions.md b/api-reference/beta/api/filestoragecontainer-delete-permissions.md index 0ee20092e40..c823b30e862 100644 --- a/api-reference/beta/api/filestoragecontainer-delete-permissions.md +++ b/api-reference/beta/api/filestoragecontainer-delete-permissions.md @@ -16,7 +16,7 @@ Namespace: microsoft.graph Delete permissions from a [fileStorageContainer](../resources/filestoragecontainer.md) object. -By default, this API removes access for an identity to the container and all items within the container, regardless of whether the identity has container-scoped or item-level permissions. You can optimize this behavior by adding an optional `Prefer: onlyRemoveContainerScopedPermission` header when you call the API. When you include the `Prefer:onlyRemoveContainerScopedPermission` header, only the identity's container-scoped permission is removed. All item-level permissions explicitly granted to the identity (if any) are retained. +By default, this API removes access for an identity to the container and all items within the container, regardless of whether the identity has container-scoped or item-level permissions. You can add an optional `Prefer: onlyRemoveContainerScopedPermission` header when you call the API if only the identity's container-scoped permissions need to be removed. All item-level permissions explicitly granted to the identity (if any) are retained. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] From d71f8fa30d00e3d39e1ddf67eca776135221b38a Mon Sep 17 00:00:00 2001 From: Tony Chan <107155297+tonchan-msft@users.noreply.github.com> Date: Mon, 11 Nov 2024 19:21:59 -0800 Subject: [PATCH 294/308] Update filestoragecontainer-delete-permissions.md --- .../beta/api/filestoragecontainer-delete-permissions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/api/filestoragecontainer-delete-permissions.md b/api-reference/beta/api/filestoragecontainer-delete-permissions.md index c823b30e862..20573924580 100644 --- a/api-reference/beta/api/filestoragecontainer-delete-permissions.md +++ b/api-reference/beta/api/filestoragecontainer-delete-permissions.md @@ -16,7 +16,7 @@ Namespace: microsoft.graph Delete permissions from a [fileStorageContainer](../resources/filestoragecontainer.md) object. -By default, this API removes access for an identity to the container and all items within the container, regardless of whether the identity has container-scoped or item-level permissions. You can add an optional `Prefer: onlyRemoveContainerScopedPermission` header when you call the API if only the identity's container-scoped permissions need to be removed. All item-level permissions explicitly granted to the identity (if any) are retained. +By default, this API removes access for an identity to the container and all items within the container, regardless of whether the identity has container-scoped or item-level permissions. You can add an optional `Prefer: onlyRemoveContainerScopedPermission` header when you call the API if only the identity's container-scoped permissions need to be removed. All item-level permissions explicitly granted to the identity (if any) are retained. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] From d4eb9090b860ac18f230cf4ba8609dc9a51a44b1 Mon Sep 17 00:00:00 2001 From: Tony Chan <107155297+tonchan-msft@users.noreply.github.com> Date: Mon, 11 Nov 2024 19:26:29 -0800 Subject: [PATCH 295/308] Update filestorage-delete-deletedcontainers.md --- api-reference/v1.0/api/filestorage-delete-deletedcontainers.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/api-reference/v1.0/api/filestorage-delete-deletedcontainers.md b/api-reference/v1.0/api/filestorage-delete-deletedcontainers.md index d654d42a24d..fdc572f53f1 100644 --- a/api-reference/v1.0/api/filestorage-delete-deletedcontainers.md +++ b/api-reference/v1.0/api/filestorage-delete-deletedcontainers.md @@ -24,6 +24,8 @@ Choose the permission or permissions marked as least privileged for this API. Us --> [!INCLUDE [permissions-table](../includes/permissions/filestorage-delete-deletedcontainers-permissions.md)] +[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-permissions.md)] + ## HTTP request