From 8a0d5c1b51ffd11543ed7f567f4feddcb8fb0c0e Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Thu, 15 Feb 2024 12:07:52 -0800 Subject: [PATCH 001/139] Create windowsupdates-product --- api-reference/beta/resources/windowsupdates-product | 1 + 1 file changed, 1 insertion(+) create mode 100644 api-reference/beta/resources/windowsupdates-product diff --git a/api-reference/beta/resources/windowsupdates-product b/api-reference/beta/resources/windowsupdates-product new file mode 100644 index 00000000000..8b137891791 --- /dev/null +++ b/api-reference/beta/resources/windowsupdates-product @@ -0,0 +1 @@ + From 13bd9ae5cb0374aa73c2eb51a7587d6d04c914ee Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Thu, 15 Feb 2024 14:37:08 -0800 Subject: [PATCH 002/139] Create windowsupdates-productRevision.md --- .../windowsupdates-productRevision.md | 51 +++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 api-reference/beta/resources/windowsupdates-productRevision.md diff --git a/api-reference/beta/resources/windowsupdates-productRevision.md b/api-reference/beta/resources/windowsupdates-productRevision.md new file mode 100644 index 00000000000..5489e28dc13 --- /dev/null +++ b/api-reference/beta/resources/windowsupdates-productRevision.md @@ -0,0 +1,51 @@ +--- +title: "productRevision resource type" +description: "This entity represents a product revision related to a specific Windows Product" +author: "skandula" +ms.localizationpriority: medium +ms.prod: "w10" +doc_type: resourcePageType +--- + +# productRevision resource type + +Namespace: microsoft.graph.windowsUpdates + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +The productRevision entity type represents a product revision related to a specific Windows Product. + + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|deployableUntilDateTime|DateTimeOffset|The date on which the content is no longer available to deploy using the service. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only.| +|displayName|String|The display name of the content. Read-only.| +|id|String|The unique identifier for the entry. Read-only.| +|releaseDateTime|DateTimeOffset|The release date and time for the content. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only.| +|version|String| The version number of the product.| +|product|String| The name of the affected product. | + + + +## Relationships +None. + +## JSON representation +The following is a JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.windowsUpdates.catalogEntry", + "deployableUntilDateTime": "String (timestamp)", + "displayName": "String", + "id": "String (identifier)", + "releaseDateTime": "String (timestamp)" +} +``` From 190ab9a7283c3ee3de9eda81e6161857345ce4b5 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Fri, 16 Feb 2024 10:26:15 -0800 Subject: [PATCH 003/139] Update and rename windowsupdates-product to windowsUpdates-product.md --- .../beta/resources/windowsUpdates-product.md | 50 +++++++++++++++++++ .../beta/resources/windowsupdates-product | 1 - 2 files changed, 50 insertions(+), 1 deletion(-) create mode 100644 api-reference/beta/resources/windowsUpdates-product.md delete mode 100644 api-reference/beta/resources/windowsupdates-product diff --git a/api-reference/beta/resources/windowsUpdates-product.md b/api-reference/beta/resources/windowsUpdates-product.md new file mode 100644 index 00000000000..c22a3775baa --- /dev/null +++ b/api-reference/beta/resources/windowsUpdates-product.md @@ -0,0 +1,50 @@ +--- +title: "product resource type" +description: "This EntityType represents a Windows product." +author: "skandula" +ms.localizationpriority: medium +ms.prod: "w10" +doc_type: resourcePageType +--- + +# product resource type + +Namespace: microsoft.graph.windowsUpdates + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +This is an Entity type that represents a specific Windows product. + +All catalog entries exist as one of the following derived types: [featureUpdateCatalogEntry](../resources/windowsupdates-featureupdatecatalogentry.md), [driverUpdateCatalogEntry](../resources/windowsupdates-driverupdatecatalogentry.md), and [qualityUpdateCatalogEntry](../resources/windowsupdates-qualityupdatecatalogentry.md). + +Base type for [softwareUpdateCatalogEntry](../resources/windowsupdates-softwareupdatecatalogentry.md). + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|deployableUntilDateTime|DateTimeOffset|The date on which the content is no longer available to deploy using the service. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only.| +|displayName|String|The display name of the content. Read-only.| +|id|String|The unique identifier for the catalog entry. Read-only.| +|releaseDateTime|DateTimeOffset|The release date for the content. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only.| + +## Relationships +None. + +## JSON representation +The following is a JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.windowsUpdates.catalogEntry", + "deployableUntilDateTime": "String (timestamp)", + "displayName": "String", + "id": "String (identifier)", + "releaseDateTime": "String (timestamp)" +} +``` diff --git a/api-reference/beta/resources/windowsupdates-product b/api-reference/beta/resources/windowsupdates-product deleted file mode 100644 index 8b137891791..00000000000 --- a/api-reference/beta/resources/windowsupdates-product +++ /dev/null @@ -1 +0,0 @@ - From 1b24e4eb70112bc74df0712aa41e1e713eac8438 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Fri, 16 Feb 2024 12:00:13 -0800 Subject: [PATCH 004/139] Delete api-reference/beta/resources/windowsupdates-productRevision.md --- .../windowsupdates-productRevision.md | 51 ------------------- 1 file changed, 51 deletions(-) delete mode 100644 api-reference/beta/resources/windowsupdates-productRevision.md diff --git a/api-reference/beta/resources/windowsupdates-productRevision.md b/api-reference/beta/resources/windowsupdates-productRevision.md deleted file mode 100644 index 5489e28dc13..00000000000 --- a/api-reference/beta/resources/windowsupdates-productRevision.md +++ /dev/null @@ -1,51 +0,0 @@ ---- -title: "productRevision resource type" -description: "This entity represents a product revision related to a specific Windows Product" -author: "skandula" -ms.localizationpriority: medium -ms.prod: "w10" -doc_type: resourcePageType ---- - -# productRevision resource type - -Namespace: microsoft.graph.windowsUpdates - -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] - -The productRevision entity type represents a product revision related to a specific Windows Product. - - -## Properties -|Property|Type|Description| -|:---|:---|:---| -|deployableUntilDateTime|DateTimeOffset|The date on which the content is no longer available to deploy using the service. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only.| -|displayName|String|The display name of the content. Read-only.| -|id|String|The unique identifier for the entry. Read-only.| -|releaseDateTime|DateTimeOffset|The release date and time for the content. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only.| -|version|String| The version number of the product.| -|product|String| The name of the affected product. | - - - -## Relationships -None. - -## JSON representation -The following is a JSON representation of the resource. - -``` json -{ - "@odata.type": "#microsoft.graph.windowsUpdates.catalogEntry", - "deployableUntilDateTime": "String (timestamp)", - "displayName": "String", - "id": "String (identifier)", - "releaseDateTime": "String (timestamp)" -} -``` From ee606cd964f2e602632404edb1d3b67f2d0a8480 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Fri, 16 Feb 2024 13:22:02 -0800 Subject: [PATCH 005/139] Update and rename windowsUpdates-product.md to windowsupdates-product.md --- .../beta/resources/windowsUpdates-product.md | 50 ---------------- .../beta/resources/windowsupdates-product.md | 59 +++++++++++++++++++ 2 files changed, 59 insertions(+), 50 deletions(-) delete mode 100644 api-reference/beta/resources/windowsUpdates-product.md create mode 100644 api-reference/beta/resources/windowsupdates-product.md diff --git a/api-reference/beta/resources/windowsUpdates-product.md b/api-reference/beta/resources/windowsUpdates-product.md deleted file mode 100644 index c22a3775baa..00000000000 --- a/api-reference/beta/resources/windowsUpdates-product.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: "product resource type" -description: "This EntityType represents a Windows product." -author: "skandula" -ms.localizationpriority: medium -ms.prod: "w10" -doc_type: resourcePageType ---- - -# product resource type - -Namespace: microsoft.graph.windowsUpdates - -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] - -This is an Entity type that represents a specific Windows product. - -All catalog entries exist as one of the following derived types: [featureUpdateCatalogEntry](../resources/windowsupdates-featureupdatecatalogentry.md), [driverUpdateCatalogEntry](../resources/windowsupdates-driverupdatecatalogentry.md), and [qualityUpdateCatalogEntry](../resources/windowsupdates-qualityupdatecatalogentry.md). - -Base type for [softwareUpdateCatalogEntry](../resources/windowsupdates-softwareupdatecatalogentry.md). - -## Properties -|Property|Type|Description| -|:---|:---|:---| -|deployableUntilDateTime|DateTimeOffset|The date on which the content is no longer available to deploy using the service. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only.| -|displayName|String|The display name of the content. Read-only.| -|id|String|The unique identifier for the catalog entry. Read-only.| -|releaseDateTime|DateTimeOffset|The release date for the content. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only.| - -## Relationships -None. - -## JSON representation -The following is a JSON representation of the resource. - -``` json -{ - "@odata.type": "#microsoft.graph.windowsUpdates.catalogEntry", - "deployableUntilDateTime": "String (timestamp)", - "displayName": "String", - "id": "String (identifier)", - "releaseDateTime": "String (timestamp)" -} -``` diff --git a/api-reference/beta/resources/windowsupdates-product.md b/api-reference/beta/resources/windowsupdates-product.md new file mode 100644 index 00000000000..bcf3a2e9c63 --- /dev/null +++ b/api-reference/beta/resources/windowsupdates-product.md @@ -0,0 +1,59 @@ +--- +title: "product resource type" +description: "This EntityType represents a Windows product." +author: "skandula" +ms.localizationpriority: medium +ms.prod: "w10" +doc_type: resourcePageType +--- + +# product resource type + +Namespace: microsoft.graph.windowsUpdates + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +This is an Entity type that represents a specific Windows product. + +Examples: + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|id|String|The unique identifier for the catalog entry. Read-only.| +|name|String|The name of the product. Read-only.| +|groupName|String|The name of the product group. Read-only.| +|friendlyName|String|The name of the product. Read-only.| +|editions|Navigation property| Represents an edition of a particular Windows product. [Add link] | +|knownIssues|Navigation property| Represents a knonw issue related to a Windows product. [Add link] | +|revisions|Navigation property|Represents product revision.| +|releaseDateTime|DateTimeOffset|The release date for the content. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only.| + +Supported Methods: GET + +Supported query parameters: filter(eq) name, expand(editions,knownIssues, revisions) + +## Relationships +None. + +## JSON representation +The following is a JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.windowsUpdates.product", + "id": "String (identifier)", + "name": "String", + "groupName": "String", + "friendlyNames": "Collection(Edm.String)", + "editions": "Collection(microsoft.graph.windowsUpdates.edition)", + "knownIssues": "Collection(microsoft.graph.windowsUpdates.knownIssue)", + "revisions": "Collection(microsoft.graph.windowsUpdates.productRevision)" +} +``` From b3f298f1bef21b1a70a8b52a7f05a90ab94fca98 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Fri, 16 Feb 2024 14:23:04 -0800 Subject: [PATCH 006/139] Create windowsupdates-edition.md --- .../beta/resources/windowsupdates-edition.md | 60 +++++++++++++++++++ 1 file changed, 60 insertions(+) create mode 100644 api-reference/beta/resources/windowsupdates-edition.md diff --git a/api-reference/beta/resources/windowsupdates-edition.md b/api-reference/beta/resources/windowsupdates-edition.md new file mode 100644 index 00000000000..56cfd6b2f5e --- /dev/null +++ b/api-reference/beta/resources/windowsupdates-edition.md @@ -0,0 +1,60 @@ +--- +title: "edition resource type" +description: "This EntityType represents a Windows product." +author: "skandula" +ms.localizationpriority: medium +ms.prod: "w10" +doc_type: resourcePageType +--- + +# edition resource type + +Namespace: microsoft.graph.windowsUpdates + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +This is an Entity type that represents an edition of a particular Windows product. + +Examples: To be added + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|id|String|The identifier for the entry. Read-only.| +|name|String|The name of the edition. Read-only.| +|releasedName|String|The public name of the edition. Read-only.| +|deviceFamily|String|The Device family targeted by the edition| +|isInService|Boolean| Represents an edition of a particular Windows product. [Add link] | +|generalAvailabilityDateTime|DateTimeOffset|The date when the edition became available to the general customers for the first time. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only.| +|endofServiceDateTime|DateTimeOffset|The date when the edition will reach or has already reached end of service. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only. | +|servicingPeriods|Navigation property| Collection of type microsoft.graph.windowsUpdates.servicingPeriod. Each object holds information of a servicing period related to the product edition.| + +Supported Methods: GET + +Supported query parameters: filter(eq) name, expand(editions,knownIssues, revisions) + +## Relationships +None. + +## JSON representation +The following is a JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.windowsUpdates.edition", + "id": "String (identifier)", + "name": "String", + "releasedName": "String", + "deviceFamily": "String", + "isInService": "Boolean", + "generalAvailabilityDateTime": "DateTimeOffset", + "endOfServiceDateTime": "DateTimeOffset", + "servicePeriods": "Collection(microsoft.graph.windowsUpdates.servicingPeriod)" +} +``` From e2b68cae831208c74f717e8cff62b4a0d836af75 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Fri, 16 Feb 2024 14:57:18 -0800 Subject: [PATCH 007/139] Create windowsupdates-knownIssue.md --- .../resources/windowsupdates-knownIssue.md | 66 +++++++++++++++++++ 1 file changed, 66 insertions(+) create mode 100644 api-reference/beta/resources/windowsupdates-knownIssue.md diff --git a/api-reference/beta/resources/windowsupdates-knownIssue.md b/api-reference/beta/resources/windowsupdates-knownIssue.md new file mode 100644 index 00000000000..907ae0eb8d9 --- /dev/null +++ b/api-reference/beta/resources/windowsupdates-knownIssue.md @@ -0,0 +1,66 @@ +--- +title: "knownIssue resource type" +description: "This Entity Type represents a known issue related to a Windows product." +author: "skandula" +ms.localizationpriority: medium +ms.service: "windows-10" +doc_type: resourcePageType +--- + +# edition resource type + +Namespace: microsoft.graph.windowsUpdates + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md) ] + +This Entity Type represents a known issue related to a Windows product + +Examples: To be added + +## Properties + +|Property|Type|Description| +|:---|:---|:---| +|id|String|The identifier for the entry. Read-only.| +|status|String|The Status of the known issue.| +|webViewUrl|String|The URL to the known issue in the Windows Release Health dashboard on M365 admin center.| +|description|String|The description of the particular known issue.| +|startDateTime|DateTimeOffset|The date and time when the known issue was first reported. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. | +|title|String|The title of the known issue.| +|resolvedDateTime|DateTimeOffset| The date and time when the known issue was resolved or mitigated.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| +|lastUpdatedDateTime|DateTimeOffset|The date and time when the known issue was last updated. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only.| +|originatingKnowledgeBaseArticle || | +|resolvingKnowledgeBaseArticle|| | +|safeguardHoldIds|| | +|knownIssueHistories||| + +Supported Methods: GET + +Supported query parameters: filter(eq) status, filter(ge, le) startDateTime, filter(ge, le) lastUpdatedDateTime, filter(ge, le) resolvedDateTime + +## Relationships +None. + +## JSON representation +The following is a JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.windowsUpdates.knowsIssue", + "id": "String (identifier)", + "status": "String", + "webViewUrl": "String", + "description": "String", + "startDateTime": "DateTimeOffset", + "title": "string", + "resolvedDateTime": "DateTimeOffset", + "lastUpdatedDateTime": "DateTimeOffset", + +} +``` From 0e0c66738b4cf58c6be74e8cb0a8c0c618c9c13a Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Fri, 16 Feb 2024 15:19:14 -0800 Subject: [PATCH 008/139] Update windowsupdates-knownIssue.md --- api-reference/beta/resources/windowsupdates-knownIssue.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/windowsupdates-knownIssue.md b/api-reference/beta/resources/windowsupdates-knownIssue.md index 907ae0eb8d9..04cbd7aa2d3 100644 --- a/api-reference/beta/resources/windowsupdates-knownIssue.md +++ b/api-reference/beta/resources/windowsupdates-knownIssue.md @@ -7,7 +7,7 @@ ms.service: "windows-10" doc_type: resourcePageType --- -# edition resource type +# knownIssue resource type Namespace: microsoft.graph.windowsUpdates From 170fae0d46ea0681cfaa3b38d3a90a53cde9af7c Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Tue, 20 Feb 2024 16:23:24 -0800 Subject: [PATCH 009/139] Update windowsupdates-knownIssue.md --- .../resources/windowsupdates-knownIssue.md | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/api-reference/beta/resources/windowsupdates-knownIssue.md b/api-reference/beta/resources/windowsupdates-knownIssue.md index 04cbd7aa2d3..b6f96172305 100644 --- a/api-reference/beta/resources/windowsupdates-knownIssue.md +++ b/api-reference/beta/resources/windowsupdates-knownIssue.md @@ -29,17 +29,19 @@ Examples: To be added |title|String|The title of the known issue.| |resolvedDateTime|DateTimeOffset| The date and time when the known issue was resolved or mitigated.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| |lastUpdatedDateTime|DateTimeOffset|The date and time when the known issue was last updated. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only.| -|originatingKnowledgeBaseArticle || | -|resolvingKnowledgeBaseArticle|| | -|safeguardHoldIds|| | -|knownIssueHistories||| Supported Methods: GET Supported query parameters: filter(eq) status, filter(ge, le) startDateTime, filter(ge, le) lastUpdatedDateTime, filter(ge, le) resolvedDateTime ## Relationships -None. +|Relationship|Type|Description| +|:---|:---|:---| +|originatingKnowledgeBaseArticle | [microsoft.graph.windowsUpdates.knowledgeBaseArticlecollection](../resources/windowsupdates-knowledgeBaseArticlecollection.md) collection |Knowledge base article associated with the release when the known issue was first reported. | +|resolvingKnowledgeBaseArticle| [microsoft.graph.windowsUpdates.knowledgeBaseArticlecollection](../resources/windowsupdates-knowledgeBaseArticlecollection.md) collection|Knowledge base article associated with the release when the known issue was resolved or mitigated. | +|safeguardHoldIds|Edm.Int32 collection|List of safeguard hold idsassociated with the known issue.| +|knownIssueHistories| [microsoft.graph.windowsUpdates.knownIssueHistories](../resources/windowsupdates-knownIssueHistories.md) collection|The history of the known Issue. | + ## JSON representation The following is a JSON representation of the resource. @@ -60,7 +62,11 @@ The following is a JSON representation of the resource. "startDateTime": "DateTimeOffset", "title": "string", "resolvedDateTime": "DateTimeOffset", - "lastUpdatedDateTime": "DateTimeOffset", + "lastUpdatedDateTime": "DateTimeOffset", + "originatingKnowledgeBaseArticle": "microsoft.graph.windowsUpdates.knowledgeBaseArticle", + "resolvingKnowledgeBaseArticle": "microsoft.graph.windowsUpdates.knowledgeBaseArticle", + "safeguardHoldIds": "Collection(Edm.Int32)", + "knownIssueHistories": "Collection(microsoft.graph.windowsUpdates.knownIssueHistoryItem)" } ``` From 8efe4b1a4f3ba656e949390dfd9da9589db53364 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Tue, 20 Feb 2024 16:27:54 -0800 Subject: [PATCH 010/139] Update windowsupdates-product.md --- api-reference/beta/resources/windowsupdates-product.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/api-reference/beta/resources/windowsupdates-product.md b/api-reference/beta/resources/windowsupdates-product.md index bcf3a2e9c63..5d77f3899fd 100644 --- a/api-reference/beta/resources/windowsupdates-product.md +++ b/api-reference/beta/resources/windowsupdates-product.md @@ -24,9 +24,6 @@ Examples: |name|String|The name of the product. Read-only.| |groupName|String|The name of the product group. Read-only.| |friendlyName|String|The name of the product. Read-only.| -|editions|Navigation property| Represents an edition of a particular Windows product. [Add link] | -|knownIssues|Navigation property| Represents a knonw issue related to a Windows product. [Add link] | -|revisions|Navigation property|Represents product revision.| |releaseDateTime|DateTimeOffset|The release date for the content. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only.| Supported Methods: GET @@ -34,7 +31,11 @@ Supported Methods: GET Supported query parameters: filter(eq) name, expand(editions,knownIssues, revisions) ## Relationships -None. +|Relationship|Type|Description| +|:---|:---|:---| +|editions|[microsoft.graph.windowsUpdates.edition](.../resources/windowsupdates-edition.md) collection| Represents an edition of a particular Windows product. | +|knownIssues|[microsoft.graph.windowsUpdates.knownIssues](.../resources/windowsupdates-knownIssues.md) collection| Represents a knonw issue related to a Windows product. | +|revisions|[microsoft.graph.windowsUpdates.productRevision](.../resources/windowsupdates-productRevision.md)|Represents a product revision.| ## JSON representation The following is a JSON representation of the resource. From b01685f177acda637721d1d80400be9ba756e4a8 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Tue, 20 Feb 2024 16:35:07 -0800 Subject: [PATCH 011/139] Update windowsupdates-edition.md --- api-reference/beta/resources/windowsupdates-edition.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/resources/windowsupdates-edition.md b/api-reference/beta/resources/windowsupdates-edition.md index 56cfd6b2f5e..c26cb1610ae 100644 --- a/api-reference/beta/resources/windowsupdates-edition.md +++ b/api-reference/beta/resources/windowsupdates-edition.md @@ -27,14 +27,16 @@ Examples: To be added |isInService|Boolean| Represents an edition of a particular Windows product. [Add link] | |generalAvailabilityDateTime|DateTimeOffset|The date when the edition became available to the general customers for the first time. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only.| |endofServiceDateTime|DateTimeOffset|The date when the edition will reach or has already reached end of service. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only. | -|servicingPeriods|Navigation property| Collection of type microsoft.graph.windowsUpdates.servicingPeriod. Each object holds information of a servicing period related to the product edition.| Supported Methods: GET Supported query parameters: filter(eq) name, expand(editions,knownIssues, revisions) ## Relationships -None. +|Relationships|Type|Description| +|:---|:---|:---| +|servicingPeriods| [microsoft.graph.windowsUpdates.servicingPeriod](.../resources/windowsupdates.servicingPeriod.md)| Each object holds information of a servicing period related to the product edition.| + ## JSON representation The following is a JSON representation of the resource. From 90bbac6bbfb38a0368fad259b3a42b54d6af64bb Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Thu, 22 Feb 2024 11:44:01 -0800 Subject: [PATCH 012/139] Update windowsupdates-knownIssue.md --- api-reference/beta/resources/windowsupdates-knownIssue.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/resources/windowsupdates-knownIssue.md b/api-reference/beta/resources/windowsupdates-knownIssue.md index b6f96172305..59e1960cb90 100644 --- a/api-reference/beta/resources/windowsupdates-knownIssue.md +++ b/api-reference/beta/resources/windowsupdates-knownIssue.md @@ -11,11 +11,11 @@ doc_type: resourcePageType Namespace: microsoft.graph.windowsUpdates -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md) ] +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] This Entity Type represents a known issue related to a Windows product -Examples: To be added +A known issue ## Properties From 6e2f418b61ec192e3b7386c628c0ca60d755afbe Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Thu, 22 Feb 2024 11:44:07 -0800 Subject: [PATCH 013/139] Update windowsupdates-product.md --- api-reference/beta/resources/windowsupdates-product.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/api-reference/beta/resources/windowsupdates-product.md b/api-reference/beta/resources/windowsupdates-product.md index 5d77f3899fd..a7372b6b0a5 100644 --- a/api-reference/beta/resources/windowsupdates-product.md +++ b/api-reference/beta/resources/windowsupdates-product.md @@ -3,7 +3,7 @@ title: "product resource type" description: "This EntityType represents a Windows product." author: "skandula" ms.localizationpriority: medium -ms.prod: "w10" +ms.service: "windows-10" doc_type: resourcePageType --- @@ -34,8 +34,8 @@ Supported query parameters: filter(eq) name, expand(editions,knownIssues, revisi |Relationship|Type|Description| |:---|:---|:---| |editions|[microsoft.graph.windowsUpdates.edition](.../resources/windowsupdates-edition.md) collection| Represents an edition of a particular Windows product. | -|knownIssues|[microsoft.graph.windowsUpdates.knownIssues](.../resources/windowsupdates-knownIssues.md) collection| Represents a knonw issue related to a Windows product. | -|revisions|[microsoft.graph.windowsUpdates.productRevision](.../resources/windowsupdates-productRevision.md)|Represents a product revision.| +|knownIssues|[microsoft.graph.windowsUpdates.knownIssues](.../resources/windowsupdates-knownIssue.md) collection| Represents a knonw issue related to a Windows product. | +|revisions|[microsoft.graph.windowsUpdates.productRevision](.../resources/windowsupdates-productrevision.md)|Represents a product revision.| ## JSON representation The following is a JSON representation of the resource. From d57b784f6d07058baf85f76058e5e409b3e0b9c5 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Thu, 22 Feb 2024 12:07:13 -0800 Subject: [PATCH 014/139] Update windowsupdates-product.md --- api-reference/beta/resources/windowsupdates-product.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/resources/windowsupdates-product.md b/api-reference/beta/resources/windowsupdates-product.md index a7372b6b0a5..56939bb0f79 100644 --- a/api-reference/beta/resources/windowsupdates-product.md +++ b/api-reference/beta/resources/windowsupdates-product.md @@ -34,8 +34,8 @@ Supported query parameters: filter(eq) name, expand(editions,knownIssues, revisi |Relationship|Type|Description| |:---|:---|:---| |editions|[microsoft.graph.windowsUpdates.edition](.../resources/windowsupdates-edition.md) collection| Represents an edition of a particular Windows product. | -|knownIssues|[microsoft.graph.windowsUpdates.knownIssues](.../resources/windowsupdates-knownIssue.md) collection| Represents a knonw issue related to a Windows product. | -|revisions|[microsoft.graph.windowsUpdates.productRevision](.../resources/windowsupdates-productrevision.md)|Represents a product revision.| +|knownIssues|[microsoft.graph.windowsUpdates.knownIssue](.../resources/windowsupdates-knownIssue.md) collection| Represents a knonw issue related to a Windows product. | +|revisions|[microsoft.graph.windowsUpdates.productrevision](.../resources/windowsupdates-productrevision.md)|Represents a product revision.| ## JSON representation The following is a JSON representation of the resource. From 9bc0275a1b528e8d32a55764c1932bf5135ae63b Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Thu, 22 Feb 2024 12:09:37 -0800 Subject: [PATCH 015/139] Create windowsupdates-servicingPeriod.md --- .../windowsupdates-servicingPeriod.md | 52 +++++++++++++++++++ 1 file changed, 52 insertions(+) create mode 100644 api-reference/beta/resources/windowsupdates-servicingPeriod.md diff --git a/api-reference/beta/resources/windowsupdates-servicingPeriod.md b/api-reference/beta/resources/windowsupdates-servicingPeriod.md new file mode 100644 index 00000000000..32e91178a2b --- /dev/null +++ b/api-reference/beta/resources/windowsupdates-servicingPeriod.md @@ -0,0 +1,52 @@ +--- +title: "servicingPeriod resource type" +description: "This EntityType holds information of a servicing period related to a product edition." +author: "skandula" +ms.localizationpriority: medium +ms.service: "windows-10" +doc_type: resourcePageType +--- + +# product resource type + +Namespace: microsoft.graph.windowsUpdates + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +This EntityType holds information of a servicing period related to a product edition + +Examples: + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|id|String|The unique identifier for the catalog entry. Read-only.| +|name|String|The name of the servicing period. Example: "Modern Lifecycle".| +|startDateTime|DateTimeOffset| Start date time of the servicing period. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only.| +|endDateTime|DateTimeOffset|Date time when the servicing period ends. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only.| + +Supported Methods: GET + +Supported query parameters: filter(eq) name, expand(editions,knownIssues, revisions) + +## Relationships +None. + +## JSON representation +The following is a JSON representation of the resource. + +``` json +{ + "@odata.type": "#microsoft.graph.windowsUpdates.servicingPeriod", + "id": "String (identifier)", + "name": "String", + "startDateTime": "DateTimeOffset", + "endDateTime": "DateTimeOffset", +} +``` From fb88bf65fdbaf722c7404c9332b8119d80b258f4 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Thu, 29 Feb 2024 09:55:26 -0800 Subject: [PATCH 016/139] Update windowsupdates-servicingPeriod.md --- .../beta/resources/windowsupdates-servicingPeriod.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/api-reference/beta/resources/windowsupdates-servicingPeriod.md b/api-reference/beta/resources/windowsupdates-servicingPeriod.md index 32e91178a2b..3509975e7b1 100644 --- a/api-reference/beta/resources/windowsupdates-servicingPeriod.md +++ b/api-reference/beta/resources/windowsupdates-servicingPeriod.md @@ -7,15 +7,13 @@ ms.service: "windows-10" doc_type: resourcePageType --- -# product resource type +# servicingPeriod resource type Namespace: microsoft.graph.windowsUpdates [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -This EntityType holds information of a servicing period related to a product edition - -Examples: +This EntityType holds information of a servicing period related to a product edition. Each edition of a particular product may have one or more servicing periods. Knowing the end of service dates is critical information to IT admins. ## Properties |Property|Type|Description| From 745344331ddd95434ba2993bf7008991a963c152 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Thu, 29 Feb 2024 10:01:28 -0800 Subject: [PATCH 017/139] Update windowsupdates-servicingPeriod.md --- api-reference/beta/resources/windowsupdates-servicingPeriod.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/windowsupdates-servicingPeriod.md b/api-reference/beta/resources/windowsupdates-servicingPeriod.md index 3509975e7b1..a531e098093 100644 --- a/api-reference/beta/resources/windowsupdates-servicingPeriod.md +++ b/api-reference/beta/resources/windowsupdates-servicingPeriod.md @@ -13,7 +13,7 @@ Namespace: microsoft.graph.windowsUpdates [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -This EntityType holds information of a servicing period related to a product edition. Each edition of a particular product may have one or more servicing periods. Knowing the end of service dates is critical information to IT admins. +This EntityType holds information of a servicing period related to a product edition. Each edition of a particular product may have one or more servicing periods. ## Properties |Property|Type|Description| From cdf6a36fe96f25a274bc80d300b7d6d70eb42555 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Thu, 29 Feb 2024 10:27:35 -0800 Subject: [PATCH 018/139] Update windowsupdates-edition.md --- api-reference/beta/resources/windowsupdates-edition.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/api-reference/beta/resources/windowsupdates-edition.md b/api-reference/beta/resources/windowsupdates-edition.md index c26cb1610ae..d3151b0b52f 100644 --- a/api-reference/beta/resources/windowsupdates-edition.md +++ b/api-reference/beta/resources/windowsupdates-edition.md @@ -1,9 +1,9 @@ --- title: "edition resource type" -description: "This EntityType represents a Windows product." +description: "This EntityType represents an edition of a particular Windows product." author: "skandula" ms.localizationpriority: medium -ms.prod: "w10" +ms.service: "windows-10" doc_type: resourcePageType --- @@ -14,8 +14,7 @@ Namespace: microsoft.graph.windowsUpdates [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] This is an Entity type that represents an edition of a particular Windows product. - -Examples: To be added +Examples of product editions: Enterprise, Core, Education, etc. ## Properties |Property|Type|Description| From da39ff9b9257d06b7b1441a35e0ea5f86a2215ae Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Thu, 29 Feb 2024 10:47:52 -0800 Subject: [PATCH 019/139] Update windowsupdates-knownIssue.md --- api-reference/beta/resources/windowsupdates-knownIssue.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/api-reference/beta/resources/windowsupdates-knownIssue.md b/api-reference/beta/resources/windowsupdates-knownIssue.md index 59e1960cb90..836537dc7ef 100644 --- a/api-reference/beta/resources/windowsupdates-knownIssue.md +++ b/api-reference/beta/resources/windowsupdates-knownIssue.md @@ -15,7 +15,6 @@ Namespace: microsoft.graph.windowsUpdates This Entity Type represents a known issue related to a Windows product -A known issue ## Properties @@ -37,10 +36,9 @@ Supported query parameters: filter(eq) status, filter(ge, le) startDateTime, fil ## Relationships |Relationship|Type|Description| |:---|:---|:---| -|originatingKnowledgeBaseArticle | [microsoft.graph.windowsUpdates.knowledgeBaseArticlecollection](../resources/windowsupdates-knowledgeBaseArticlecollection.md) collection |Knowledge base article associated with the release when the known issue was first reported. | -|resolvingKnowledgeBaseArticle| [microsoft.graph.windowsUpdates.knowledgeBaseArticlecollection](../resources/windowsupdates-knowledgeBaseArticlecollection.md) collection|Knowledge base article associated with the release when the known issue was resolved or mitigated. | +|originatingKnowledgeBaseArticle | [microsoft.graph.windowsUpdates.knowledgebasearticle](../resources/windowsupdates-knowledgebasearticle.md) collection |Knowledge base article associated with the release when the known issue was first reported. | +|resolvingKnowledgeBaseArticle| [microsoft.graph.windowsUpdates.knowledgebasearticle](../resources/windowsupdates-knowledgebasearticle.md) collection|Knowledge base article associated with the release when the known issue was resolved or mitigated. | |safeguardHoldIds|Edm.Int32 collection|List of safeguard hold idsassociated with the known issue.| -|knownIssueHistories| [microsoft.graph.windowsUpdates.knownIssueHistories](../resources/windowsupdates-knownIssueHistories.md) collection|The history of the known Issue. | ## JSON representation From 898d16382016e765f3d949e9e1a26558774edd8a Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Thu, 29 Feb 2024 15:33:47 -0800 Subject: [PATCH 020/139] Update windowsupdates-servicingPeriod.md --- .../beta/resources/windowsupdates-servicingPeriod.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/api-reference/beta/resources/windowsupdates-servicingPeriod.md b/api-reference/beta/resources/windowsupdates-servicingPeriod.md index a531e098093..fcd96a003d0 100644 --- a/api-reference/beta/resources/windowsupdates-servicingPeriod.md +++ b/api-reference/beta/resources/windowsupdates-servicingPeriod.md @@ -13,25 +13,25 @@ Namespace: microsoft.graph.windowsUpdates [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -This EntityType holds information of a servicing period related to a product edition. Each edition of a particular product may have one or more servicing periods. +This EntityType holds information of a servicing period related to a product edition. Each edition of a particular product will have one or more servicing periods. ## Properties |Property|Type|Description| |:---|:---|:---| -|id|String|The unique identifier for the catalog entry. Read-only.| -|name|String|The name of the servicing period. Example: "Modern Lifecycle".| +|ID|String|The unique identifier for the catalog entry. Read-only.| +|name|String|The name of the servicing period. Example: "Modern Lifecycle."| |startDateTime|DateTimeOffset| Start date time of the servicing period. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only.| |endDateTime|DateTimeOffset|Date time when the servicing period ends. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only.| Supported Methods: GET -Supported query parameters: filter(eq) name, expand(editions,knownIssues, revisions) +Supported query parameters: filter(eq) name, expand(editions, knownIssues, revisions). ## Relationships None. ## JSON representation -The following is a JSON representation of the resource. +The following code is a JSON representation of the resource. +``` json +{ + "@odata.type": "#microsoft.graph.windowsUpdates.knownIssueHistoryItem", + "createdDateTime": "DateTimeOffset", + "endOfServiceDateTime": "DateTimeOffset", +} +``` From 0a20ba7f844937ac2d8da69f8bd334b2eb1dd587 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Fri, 1 Mar 2024 11:42:41 -0800 Subject: [PATCH 025/139] Update toc.yml --- api-reference/beta/toc.yml | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/api-reference/beta/toc.yml b/api-reference/beta/toc.yml index cc953565a7d..e968383ae0a 100644 --- a/api-reference/beta/toc.yml +++ b/api-reference/beta/toc.yml @@ -10189,6 +10189,28 @@ items: href: resources/windowsupdates-driverupdatecatalogentry.md - name: List catalog entries href: api/windowsupdates-catalog-list-entries.md + - name: Feature update catalog entry + href: resources/windowsupdates-featureupdatecatalogentry.md + - name: Quality update catalog entry + href: resources/windowsupdates-qualityupdatecatalogentry.md + - name: Driver update catalog entry + href: resources/windowsupdates-driverupdatecatalogentry.md + - name: List catalog entries + href: api/windowsupdates-catalog-list-entries.md + - name: Windows Release Information + items: + - name: Product + href: resources/windowsupdates-product.md + items: + - name: Known Issues + href: resources/windowsupdates-knownIssues.md + items: + - name: Known Issue Histories + href: resources/windowsupdates-knownIssueHistories.md + - name: Edition + href: resources/windowsupdates-edition.md + - name: Servicing Period + href: resources/windowsupdates-servicingPeriod.md - name: Compliance change href: resources/windowsupdates-compliancechange.md items: From 525b45bf7e64889d5b849e334f011ec924246691 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Fri, 1 Mar 2024 13:59:35 -0800 Subject: [PATCH 026/139] Create windowsupdate-WindowsServicing.md --- concepts/windowsupdate-WindowsServicing.md | 432 +++++++++++++++++++++ 1 file changed, 432 insertions(+) create mode 100644 concepts/windowsupdate-WindowsServicing.md diff --git a/concepts/windowsupdate-WindowsServicing.md b/concepts/windowsupdate-WindowsServicing.md new file mode 100644 index 00000000000..ec0caf9b234 --- /dev/null +++ b/concepts/windowsupdate-WindowsServicing.md @@ -0,0 +1,432 @@ +--- +title: "Windows Release Information: Products, Product Lifecycle and known Issues information" +description: "Windows Servicing and Release Informations encompasses specific Product information, including product edition, known Issues, and lifecycle data. " +author: "skandula" +ms.localizationpriority: medium +ms.service: "windows-10" +doc_type: conceptualPageType +--- + +# Windows Release Information - Known Issues and Product Lifecycle + +Windows Servicing and Release information encompasses specific Product information, including product edition, known Issues, and lifecycle data. + +| Windows Servicing | Description | +|-------------|---------------------------------------------------------------------------------------------------| +| Known Issues | Windows release health known Issues refer to information about known problems or issues that may affect the stability or reliability of a particular Windows release or product. This data is collected and analyzed by Microsoft to identify potential issues with a Windows release and provide customers with information on how to address them. | +|Product Lifecycle| Product lifecycle data refers to information about the various stages of a product's existence, from its initial development to its eventual discontinuation. This data includes details such as release dates, end-of-life/servicing dates, and support timelines. Please refer to the following resources for more information: | + +## Product Life Cycle (PLC) Scenarios + +Refer to the following resource pages for more information: + +|Resource|Type|Description| +|:---|:---|:---| +|product|[microsoft.graph.windowsUpdates.product](.../resources/windowsupdates-product.md)|Represents a Windows product.| +|editions|[microsoft.graph.windowsUpdates.edition](.../resources/windowsupdates-edition.md) | Represents an edition of a particular Windows product. | +|revisions|[microsoft.graph.windowsUpdates.productrevision](.../resources/windowsupdates-productrevision.md)|Represents a product revision.| + +### Scenario 1: Get all editions for a particular product. + +#### Example API Request and Response +##### REST API request +```http +GET /admin/windows/updates/products/{id}/editions +GET /admin/windows/updates/products({id})/editions +``` +##### REST API response +```HTTP/1.1 200 OK +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#collection(microsoft.graph.windowsUpdates.edition)", + "value": [ + { + "id": "1_4", + "name": "Enterprise", + "releasedName": "Windows 11 Enterprise", + "deviceFamily": "Desktop", + "isInService": true, + "generalAvailabilityDateTime": "2022-09-20T00:00:00-07:00", + "endOfServiceDateTime": "2025-10-14T00:00:00-07:00", + "servicingPeriods": [ + { + "name": "Modern Lifecycle", + "startDateTime": "2022-09-20T00:00:00-07:00", + "endDateTime": "2025-10-14T00:00:00-07:00" + } + ] + }, + { + "id": "1_101", + "name": "Core", + "releasedName": "Windows 11 Home", + "deviceFamily": "Desktop", + "isInService": true, + "generalAvailabilityDateTime": "2022-09-20T00:00:00-07:00", + "endOfServiceDateTime": "2024-10-08T00:00:00-07:00", + "servicingPeriods": [ + { + "name": "Modern Lifecycle", + "startDateTime": "2022-09-20T00:00:00-07:00", + "endDateTime": "2024-10-08T00:00:00-07:00" + } + ] + } + ] +} +``` +### Scenario 2: Get all servicing periods for a particular edition of a particular product. + +Each edition of a particular product may have one or more servicing periods. Knowing the end of service dates is critical information to IT admins. +The below query fiters the editions on id and expands the GetServicingPeriods array while selecting an additional property, 'name'. + +#### Example API Request and Response +##### REST API request + +```http +GET /admin/windows/updates/products({id})/editions({editionId})?$select=name,servicingPeriods +GET /admin/windows/updates/products/{id}/editions/{editionId}?$select=name,servicingPeriods +``` +##### REST API response + +```HTTP/1.1 200 OK +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.windowsUpdates.edition)", + "value": [ + { + "name": "Enterprise", + "servicingPeriods": [ + { + "name": "Modern Lifecycle", + "startDateTime": "2022-09-20T00:00:00-07:00", + "endDateTime": "2025-10-14T00:00:00-07:00" + }... + ] + } + ] +} + +``` +Similar queries can be used for getting more or less data points as per the need. + + +### Scenario 3: Get all editions of all products with the service status. + +#### Example API Request and Response +##### REST API request +```http +GET /admin/windows/updates/products?expand=editions($select=name,isInService) +``` +##### REST API response + +```HTTP/1.1 200 OK +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/products(editions(name,isInService))", + "value": [ + { + "id": "1", + "name": "Windows 11, version 22H2", + "groupName": "Windows 11", + "friendlyNames": [ + "Version 22H2 (OS build 22621)" + ], + "editions": [ + { + "name": "Enterprise", + "isInService": true + }, + { + "name": "Core", + "isInService": true + } + ] + }, + { + "id": "2", + "name": "Windows 11, version 21H2", + "groupName": "Windows 11", + "friendlyNames": [ + "Version 21H2 (OS build 22000)" + ], + "editions": [ + { + "name": "Enterprise", + "isInService": true + }, + { + "name": "Core", + "isInService": true + } + ] + } + ] +} +``` + + +### Scenario 4: Get the general availability date of a particular edition belonging to a particular product. + +#### Example API Request and Response +##### REST API request +```http +GET /admin/windows/updates/products({id})/editions({editionId})?$select=name,generalAvailabilityDateTime +GET /admin/windows/updates/products/{id}/editions/{editionId}?$select=name,generalAvailabilityDateTime +``` +##### REST API response + +```HTTP/1.1 200 OK +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.windowsUpdates.edition)", + "value": [ + { + "name": "Enterprise", + "generalAvailabilityDateTime": "2022-09-20T00:00:00-07:00" + } + ] +} +``` +### Scenario 5: Get the product information based on end of servicing + +It is important to know when products are reaching end of servicing (EOS). + +The below example showcases how a query can be used to find relevant information based on end of servicing. +#### Example API Request and Response + +The followin example code showcases an example to get a list of all Products and editions which are reaching end of servicing before a particular date. More conditions can be added to the query to get more specific results, like finding products reaching end of service between two dates etc. +##### REST API request + +```http +GET /admin/windows/updates/Products?filter=editions/any(edition: edition/endOfServiceDateTime lt {date})&expand=editions(filter= endOfServiceDateTime lt {date}) +``` + +##### REST API response + +```HTTP/1.1 200 OK +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.windowsUpdates.product)", + "value": [ + { + "id": "1", + "name": "Windows 11, version 22H2", + "groupName": "Windows 11", + "friendlyNames": [ + "Version 22H2 (OS build 22621)" + ], + "editions": [ + { + "id": "1_101", + "name": "Core", + "releasedName": "Windows 11 Home", + "deviceFamily": "Desktop", + "isInService": true, + "generalAvailabilityDateTime": "2022-09-20T00:00:00-07:00", + "endOfServiceDateTime": "2024-10-08T00:00:00-07:00", + "servicingPeriods": [ + { + "name": "Modern Lifecycle", + "startDateTime": "2022-09-20T00:00:00-07:00", + "endDateTime": "2024-10-08T00:00:00-07:00" + } + ] + } + ] + }, + { + "id": "2", + "name": "Windows 11, version 21H2", + "groupName": "Windows 11", + "friendlyNames": [ + "Version 21H2 (OS build 22000)" + ], + "editions": [ + { + "id": "2_4", + "name": "Enterprise", + "releasedName": "Windows 11 Enterprise", + "deviceFamily": "Desktop", + "isInService": true, + "generalAvailabilityDateTime": "2021-10-04T00:00:00-07:00", + "endOfServiceDateTime": "2024-10-08T00:00:00-07:00", + "servicingPeriods": [ + { + "name": "Modern Lifecycle", + "startDateTime": "2021-10-04T00:00:00-07:00", + "endDateTime": "2024-10-08T00:00:00-07:00" + } + ] + } + ] + } + ] +} + +``` +## Product known Issues Scenarios +Refer to the following resource pages for more information: + +|Resource|Type|Description| +|:---|:---|:---| +|product|[microsoft.graph.windowsUpdates.product](.../resources/windowsupdates-product.md)|Represents a Windows product.| +|knownIssues|[microsoft.graph.windowsUpdates.knownIssue](.../resources/windowsupdates-knownIssue.md)| Represents a known issue related to a Windows product. | + +### Scenario 1: Get all known issues for a particular product + +This example will retrieve a list of all known issues associated with a particular product + +#### Example API Request and Response + +##### REST API request +```http +GET /admin/windows/updates/products/{id}/knownissues +GET /admin/windows/updates/products({id})/knownissues +``` +##### REST API response +```HTTP/1.1 200 OK +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.windowsUpdates.knownIssue)", + "value": [ + { + "id": "WI670072", + "status": "mitigatedExternal", + "webViewUrl": "https://admin.microsoft.com/Adminportal/Home#/windowsreleasehealth/knownissues/:/issue/WI670072", + "description": "Investigation concluded that the error reported by users was not caused by the August 2023 preview updates.", + "startDateTime": "2023-08-22T10:00:00-07:00", + "title": "Microsoft received reports about an “UNSUPPORTED_PROCESSOR” error", + "resolvedDateTime": "2023-09-07T16:14:07.1881817-07:00", + "lastUpdatedDateTime": "2023-09-07T16:41:58.577-07:00", + "originatingKnowledgeBaseArticle": { + "Url": "https://support.microsoft.com/help/5029351", + "Id": "KB5029351" + }, + "resolvingKnowledgeBaseArticle": null, + "safeguardHoldIds": [], + "knownIssueHistories": [ + { + "createdDateTime": "2023-08-24T02:51:27.29Z", + "body": { + "content": "Microsoft has received reports of an issue in which users are receiving an “UNSUPPORTED_PROCESSOR” error message on a blue screen after installing updates released on August 22, 2023 (KB5029351 (https://support.microsoft.com/help/5029351)) and then restarting their device. KB5029351 (https://support.microsoft.com/help/5029351) might automatically uninstall to allow Windows to start up as expected. KB5029351 (https://support.microsoft.com/help/5029351) might not offer to some Windows devices which might be affected by this issue.\n\nIf you are experiencing issues, please use Feedback Hub to file a report following the below steps:\n 1. Launch Feedback Hub by opening the Start menu and typing \"Feedback hub\", or pressing the Windows key + F\n 2. Fill in the \"Summarize your feedback\" and \"Explain in more detail\" boxes, then click Next.\n 3. Under the \"Choose a category\" section, click the \"Problem\" button, and select \"Install and Update\" category. Then select \"Downloading, installing, and configuring Windows Update” subcategory. Click Next.\n 4. Under the \"Find similar feedback\" section, select the \"Make new bug\" radio button and click Next.\n 5. Under the \"Add more details\" section, supply any relevant detail (Note this is not critical to addressing your issue).\n 6. Expand the \"Recreate my problem\" box and press \"Start recording\". Reproduce the issue on your device.\n 7. Press \"Stop recording\" once finished. Click the \"Submit\" button.\nFor additional information, see Send feedback to Microsoft with the Feedback Hub app (https://support.microsoft.com/windows/send-feedback-to-microsoft-with-the-feedback-hub-app-f59187f8-8739-22d6-ba93-f66612949332).\n\nNext steps: We are presently investigating to determine if this is an issue caused by Microsoft. We will provide an update when more information is available.\n\nAffected platforms:\n - Client: Windows 11, version 22H2; Windows 10, version 22H2; Windows 11, version 21H2\n - Server: None\n", + "contentType": "html" + } + }... + ] + }, + { + "id": "WI519857", + "status": "confirmed", + "webViewUrl": "https://admin.microsoft.com/Adminportal/Home#/windowsreleasehealth/knownissues/:/issue/WI519857", + "description": "This can affect applications which retrieve the device's currency for purchases or other transactions.", + "startDateTime": "2023-02-22T13:32:41.143-08:00", + "title": "Devices with locale set to Croatia might not utilize the expected currency", + "resolvedDateTime": null, + "lastUpdatedDateTime": "2023-02-23T13:32:42.76-08:00", + "originatingKnowledgeBaseArticle": null, + "resolvingKnowledgeBaseArticle": null, + "safeguardHoldIds": [], + "knownIssueHistories": [ + { + "createdDateTime": "2023-02-23T21:32:42.76Z", + "body": { + "content": "The correct default currency might not display or be used in Windows devices which have locale set to Croatia. This can affect applications which retrieve the device's currency for purchases or other transactions. \nEarlier this year, Croatia joined the Eurozone, changing its currency from the Kuna to Euro. Windows Locale data for Croatia will be updated for this change in the short term.\n\nWorkaround: Changing the currency in Windows can help. This can be accomplished via the Windows Control Panel.\n 1. Open the \"Windows Region\" settings. This can be done in one of the following ways:\n a. Open \"Control Panel\" from the start menu and select \"Change date, time, or number formats\" under \"Clock and Region\"\n b. On your keyboard, press and hold the Windows key, then press the letter R. This will open the \"Run\" window. Type INTL.CPL into the Open field,\n 2. In the Region settings, choose one of the 2 locales for Croatia:\n c. Croatian (Bosnia & Herzegovina)\n d. Croatian (Croatia)\n 3. In this same window, click the \"Additional settings\" button. Once there, click the \"Currency\" tab.\n 4. Change the currency symbol from \"KN\" to Euro, \"€\"\n\nAdditional information can be seen here: Currency formatting - Globalization | Microsoft Learn (https://learn.microsoft.com/globalization/locale/currency-formatting).\n\nManually changing currency might also be an option in some applications. Although this won't change the device’s default currency, this could allow usage of the application with the desired currency preference. Some applications might not allow this manual change. Please view the settings and documentation for your applications.\n\nNext steps: We are working on a resolution and will provide an update in an upcoming release.\n\nAffected platforms:\n - Client: Windows 11, version 22H2; Windows 10, version 22H2; Windows 11, version 21H2; Windows 10, version 21H2; Windows 10, version 20H2; Windows 10, version 1809; Windows 10 Enterprise LTSC 2019; Windows 10 Enterprise LTSC 2016; Windows 10, version 1607; Windows 10 Enterprise 2015 LTSB\n - Server: Windows Server 2022; Windows Server, version 20H2; Windows Server, version 1809; Windows Server 2019; Windows Server 2012 R2; Windows Server 2012; Windows Server 2008 R2 SP1; Windows Server 2008 SP2\n", + "contentType": "html" + } + } + ] + }... + ] +} +``` +### Scenario 2: Find Known Issues for a parctular product based on a set time period +The following example showcases how to retrieve all of the recent known issues based on a set time frame (i.e. last 30 days, last 3 months, last year, etc.) + +#### Example 1: Retrieve the known issues for a particular product and filter them by date range on any of the date fields. + +##### REST API request +```http +GET /admin/windows/updates/products/{id}/knownissues?$filter=lastUpdatedDateTime ge {startDate} and lastUpdatedDateTime le {endDate} +GET /admin/windows/updates/products({id})/knownissues$filter=lastUpdatedDateTime ge {startDate} and lastUpdatedDateTime le {endDate} +``` + +```http +GET /admin/windows/updates/products('1')/knownIssues?$filter=lastUpdatedDateTime ge 2023-02-01T16:41:58.577-07:00 and lastUpdatedDateTime le 2023-02-28T16:41:58.577-07:00 +``` +##### REST API response +``` +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.windowsUpdates.knownIssue)", + "value": [ + { + "id": "WI519857", + "status": "confirmed", + "webViewUrl": "https://admin.microsoft.com/Adminportal/Home#/windowsreleasehealth/knownissues/:/issue/WI519857", + "description": "This can affect applications which retrieve the device's currency for purchases or other transactions.", + "startDateTime": "2023-02-22T13:32:41.143-08:00", + "title": "Devices with locale set to Croatia might not utilize the expected currency", + "resolvedDateTime": null, + "lastUpdatedDateTime": "2023-02-23T13:32:42.76-08:00", + "originatingKnowledgeBaseArticle": null, + "resolvingKnowledgeBaseArticle": null, + "safeguardHoldIds": [], + "knownIssueHistories": [ + { + "createdDateTime": "2023-02-23T21:32:42.76Z", + "body": { + "content": "The correct default currency might not display or be used in Windows devices which have locale set to Croatia. This can affect applications which retrieve the device's currency for purchases or other transactions. \nEarlier this year, Croatia joined the Eurozone, changing its currency from the Kuna to Euro. Windows Locale data for Croatia will be updated for this change in the short term.\n\nWorkaround: Changing the currency in Windows can help. This can be accomplished via the Windows Control Panel.\n 1. Open the \"Windows Region\" settings. This can be done in one of the following ways:\n a. Open \"Control Panel\" from the start menu and select \"Change date, time, or number formats\" under \"Clock and Region\"\n b. On your keyboard, press and hold the Windows key, then press the letter R. This will open the \"Run\" window. Type INTL.CPL into the Open field,\n 2. In the Region settings, choose one of the 2 locales for Croatia:\n c. Croatian (Bosnia & Herzegovina)\n d. Croatian (Croatia)\n 3. In this same window, click the \"Additional settings\" button. Once there, click the \"Currency\" tab.\n 4. Change the currency symbol from \"KN\" to Euro, \"€\"\n\nAdditional information can be seen here: Currency formatting - Globalization | Microsoft Learn (https://learn.microsoft.com/globalization/locale/currency-formatting).\n\nManually changing currency might also be an option in some applications. Although this won't change the device’s default currency, this could allow usage of the application with the desired currency preference. Some applications might not allow this manual change. Please view the settings and documentation for your applications.\n\nNext steps: We are working on a resolution and will provide an update in an upcoming release.\n\nAffected platforms:\n - Client: Windows 11, version 22H2; Windows 10, version 22H2; Windows 11, version 21H2; Windows 10, version 21H2; Windows 10, version 20H2; Windows 10, version 1809; Windows 10 Enterprise LTSC 2019; Windows 10 Enterprise LTSC 2016; Windows 10, version 1607; Windows 10 Enterprise 2015 LTSB\n - Server: Windows Server 2022; Windows Server, version 20H2; Windows Server, version 1809; Windows Server 2019; Windows Server 2012 R2; Windows Server 2012; Windows Server 2008 R2 SP1; Windows Server 2008 SP2\n", + "contentType": "html" + } + } + ] + } + ] +} + +``` + +#### Example 2: List the known issues related to a particular product based on timeframe in the past. + +This function (GetKnownIssuesByTimeRange) will query the known issues for a particular product based on a time frame in the past (days). The function will return all known issues resoved in the time frame defined by the parameter 'daysInPast'. The parameter +'includeAllActive' can be null, true or false. If it is null or true, all active known issues (no time filter applied) for the desired product will be included in the response, whereas if it is false then active known issues would not be included. + +##### REST API request +```http +GET /admin/windows/updates/products({id})/Default.GetKnownIssuesByTimeRange(daysInPast={daysInPast},includeAllActive={includeAllActive}) +GET /admin/windows/updates/products({id})/GetKnownIssuesByTimeRange(daysInPast={daysInPast},includeAllActive={includeAllActive}) +GET /admin/windows/updates/products/{id}/Default.GetKnownIssuesByTimeRange(daysInPast={daysInPast},includeAllActive={includeAllActive}) +GET /admin/windows/updates/products/{id}/GetKnownIssuesByTimeRange(daysInPast={daysInPast},includeAllActive={includeAllActive}) +``` +Example +```http +GET /admin/windows/updates/products('1')/GetKnownIssuesByTimeRange(daysInPast=70,includeAllActive=false) +``` + +##### REST API response +``` +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.windowsUpdates.knownIssue)", + "value": [ + { + "id": "WI670072", + "status": "mitigatedExternal", + "webViewUrl": "https://admin.microsoft.com/Adminportal/Home#/windowsreleasehealth/knownissues/:/issue/WI670072", + "description": "Investigation concluded that the error reported by users was not caused by the August 2023 preview updates.", + "startDateTime": "2023-08-22T10:00:00-07:00", + "title": "Microsoft received reports about an “UNSUPPORTED_PROCESSOR” error", + "resolvedDateTime": "2023-09-07T16:14:07.1881817-07:00", + "lastUpdatedDateTime": "2023-09-07T16:41:58.577-07:00", + "originatingKnowledgeBaseArticle": { + "Url": "https://support.microsoft.com/help/5029351", + "Id": "KB5029351" + }, + "resolvingKnowledgeBaseArticle": null, + "safeguardHoldIds": [], + "knownIssueHistories": [ + { + "createdDateTime": "2023-08-24T02:51:27.29Z", + "body": { + "content": "Microsoft has received reports of an issue in which users are receiving an “UNSUPPORTED_PROCESSOR” error message on a blue screen after installing updates released on August 22, 2023 (KB5029351 (https://support.microsoft.com/help/5029351)) and then restarting their device. KB5029351 (https://support.microsoft.com/help/5029351) might automatically uninstall to allow Windows to start up as expected. KB5029351 (https://support.microsoft.com/help/5029351) might not offer to some Windows devices which might be affected by this issue.\n\nIf you are experiencing issues, please use Feedback Hub to file a report following the below steps:\n 1. Launch Feedback Hub by opening the Start menu and typing \"Feedback hub\", or pressing the Windows key + F\n 2. Fill in the \"Summarize your feedback\" and \"Explain in more detail\" boxes, then click Next.\n 3. Under the \"Choose a category\" section, click the \"Problem\" button, and select \"Install and Update\" category. Then select \"Downloading, installing, and configuring Windows Update” subcategory. Click Next.\n 4. Under the \"Find similar feedback\" section, select the \"Make new bug\" radio button and click Next.\n 5. Under the \"Add more details\" section, supply any relevant detail (Note this is not critical to addressing your issue).\n 6. Expand the \"Recreate my problem\" box and press \"Start recording\". Reproduce the issue on your device.\n 7. Press \"Stop recording\" once finished. Click the \"Submit\" button.\nFor additional information, see Send feedback to Microsoft with the Feedback Hub app (https://support.microsoft.com/windows/send-feedback-to-microsoft-with-the-feedback-hub-app-f59187f8-8739-22d6-ba93-f66612949332).\n\nNext steps: We are presently investigating to determine if this is an issue caused by Microsoft. We will provide an update when more information is available.\n\nAffected platforms:\n - Client: Windows 11, version 22H2; Windows 10, version 22H2; Windows 11, version 21H2\n - Server: None\n", + "contentType": "html" + } + }... + ] + }... + ] +} +``` From 98c53575440d03afb8bd544d8e9995d7b6791f0c Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Fri, 1 Mar 2024 14:03:33 -0800 Subject: [PATCH 027/139] Update windowsupdates-knownIssue.md --- api-reference/beta/resources/windowsupdates-knownIssue.md | 1 + 1 file changed, 1 insertion(+) diff --git a/api-reference/beta/resources/windowsupdates-knownIssue.md b/api-reference/beta/resources/windowsupdates-knownIssue.md index 666ddcbf9a2..d47938c69d7 100644 --- a/api-reference/beta/resources/windowsupdates-knownIssue.md +++ b/api-reference/beta/resources/windowsupdates-knownIssue.md @@ -38,6 +38,7 @@ Supported query parameters: filter(eq) status, filter(ge, le) startDateTime, fil |:---|:---|:---| |originatingKnowledgeBaseArticle | [microsoft.graph.windowsUpdates.knowledgebasearticle](../resources/windowsupdates-knowledgebasearticle.md) collection |Knowledge base article associated with the release when the known issue was first reported. | |resolvingKnowledgeBaseArticle| [microsoft.graph.windowsUpdates.knowledgebasearticle](../resources/windowsupdates-knowledgebasearticle.md) collection|Knowledge base article associated with the release when the known issue was resolved or mitigated. | +|knownIssueHistories| [microsoft.graph.windowsUpdates.knownIssueHistories](../resources/windowsupdates-knownIssueHistories.md) collection| A list of known Issue Histories.| |safeguardHoldIds|Edm.Int32 collection|A list of safeguard hold ids associated with the known issue.| From e535f643171c851491c43688ad168baf67e52815 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Mon, 4 Mar 2024 07:26:19 +0100 Subject: [PATCH 028/139] Update windowsupdates-edition.md Edit. --- .../beta/resources/windowsupdates-edition.md | 34 +++++++++---------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/api-reference/beta/resources/windowsupdates-edition.md b/api-reference/beta/resources/windowsupdates-edition.md index b128a74f855..d60a98c4600 100644 --- a/api-reference/beta/resources/windowsupdates-edition.md +++ b/api-reference/beta/resources/windowsupdates-edition.md @@ -1,6 +1,6 @@ --- title: "edition resource type" -description: "This EntityType represents an edition of a particular Windows product." +description: "Represents an edition of a particular Windows product." author: "skandula" ms.localizationpriority: medium ms.service: "windows-10" @@ -13,29 +13,30 @@ Namespace: microsoft.graph.windowsUpdates [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -This Entity type represents an edition of a particular Windows product. -Examples of product editions: Enterprise, Core, Education, etc. +Represents an edition of a particular Windows product. For example, Enterprise, Core, or Education. ## Properties + |Property|Type|Description| |:---|:---|:---| -|ID|String|The identifier for the entry. Read-only.| +|id|String|The unique identifier for the entry. Read-only.| |name|String|The name of the edition. Read-only.| |releasedName|String|The public name of the edition. Read-only.| -|deviceFamily|String|The Device family targeted by the edition| +|deviceFamily|String|The device family targeted by the edition| |isInService|Boolean| Represents an edition of a particular Windows product. [Add link] | -|generalAvailabilityDateTime|DateTimeOffset|The date when the edition became available to the general customers for the first time. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only.| -|endofServiceDateTime|DateTimeOffset|The date when the edition reaches or reached end of service. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only. | - +|generalAvailabilityDateTime|DateTimeOffset|The date and time when the edition became available to the general customers for the first time. 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`. Read-only.| +|endofServiceDateTime|DateTimeOffset|The date and time when the edition reaches or reached end of service. 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`. Read-only. | ## Relationships + |Relationships|Type|Description| |:---|:---|:---| -|servicingPeriods| [microsoft.graph.windowsUpdates.servicingPeriod](.../resources/windowsupdates.servicingPeriod.md)| Each object holds information of a servicing period related to the product edition.| - +|servicingPeriods| [microsoft.graph.windowsUpdates.servicingPeriod](.../resources/windowsupdates.servicingperiod.md)| Each object holds information of a servicing period related to the product edition.| ## JSON representation -The following code is a JSON representation of the resource. + +The following JSON representation shows the resource type. + -``` json -{ - "@odata.type": "#microsoft.graph.windowsUpdates.servicingPeriod", - "id": "String (identifier)", - "name": "String", - "startDateTime": "DateTimeOffset", - "endDateTime": "DateTimeOffset", -} -``` diff --git a/api-reference/beta/resources/windowsupdates-servicingperiod.md b/api-reference/beta/resources/windowsupdates-servicingperiod.md new file mode 100644 index 00000000000..15c0fa78c3c --- /dev/null +++ b/api-reference/beta/resources/windowsupdates-servicingperiod.md @@ -0,0 +1,54 @@ +--- +title: "servicingPeriod resource type" +description: "Represents information about a servicing period related to a product edition." +author: "skandula" +ms.localizationpriority: medium +ms.service: "windows-10" +doc_type: resourcePageType +--- + +# servicingPeriod resource type + +Namespace: microsoft.graph.windowsUpdates + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Represents information about a servicing period related to a product edition. Each edition of a particular product has one or more servicing periods. + +Supported Methods: GET + +Supported query parameters: filter(eq) name, expand(editions, knownIssues, revisions). + +## Properties + +|Property|Type|Description| +|:---|:---|:---| +|endDateTime|DateTimeOffset|The date and time when the servicing period ends. 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`. Read-only.| +|id|String|The unique identifier for the catalog entry. Read-only.| +|name|String|The name of the servicing period. For example, `Modern Lifecycle`.| +|startDateTime|DateTimeOffset|The start date and time of the servicing period. 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`. Read-only.| + +## Relationships + +None. + +## JSON representation + +The following JSON representation shows the resource type. + + +``` json +{ + "@odata.type": "#microsoft.graph.windowsUpdates.servicingPeriod", + "endDateTime": "String (timestamp)", + "id": "String (identifier)", + "name": "String", + "startDateTime": "String (timestamp)" +} +``` From c9eb688f540c53ea0f4c639f34bf7e649f4a7d0b Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Tue, 5 Mar 2024 06:57:47 +0100 Subject: [PATCH 037/139] Update toc.yml Edit. --- api-reference/beta/toc.yml | 22 +++++++--------------- 1 file changed, 7 insertions(+), 15 deletions(-) diff --git a/api-reference/beta/toc.yml b/api-reference/beta/toc.yml index 21e907bfd74..37a4926d3af 100644 --- a/api-reference/beta/toc.yml +++ b/api-reference/beta/toc.yml @@ -10189,28 +10189,20 @@ items: href: resources/windowsupdates-driverupdatecatalogentry.md - name: List catalog entries href: api/windowsupdates-catalog-list-entries.md - - name: Feature update catalog entry - href: resources/windowsupdates-featureupdatecatalogentry.md - - name: Quality update catalog entry - href: resources/windowsupdates-qualityupdatecatalogentry.md - - name: Driver update catalog entry - href: resources/windowsupdates-driverupdatecatalogentry.md - - name: List catalog entries - href: api/windowsupdates-catalog-list-entries.md - - name: Windows Release Information + - name: Windows release information items: - name: Product href: resources/windowsupdates-product.md items: - - name: Known Issues - href: resources/windowsupdates-knownIssues.md + - name: Known issue + href: resources/windowsupdates-knownissue.md items: - - name: Known Issue Histories - href: resources/windowsupdates-knownIssueHistories.md + - name: Known issue history item + href: resources/windowsupdates-knownissuehistoryitem.md - name: Edition href: resources/windowsupdates-edition.md - - name: Servicing Period - href: resources/windowsupdates-servicingPeriod.md + - name: Servicing period + href: resources/windowsupdates-servicingperiod.md - name: Compliance change href: resources/windowsupdates-compliancechange.md items: From 28cd055eb9a5dcd6d8c3a10e2fb4c214639bad21 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Tue, 5 Mar 2024 16:14:08 -0800 Subject: [PATCH 038/139] Update windowsupdates-edition.md --- .../beta/resources/windowsupdates-edition.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/api-reference/beta/resources/windowsupdates-edition.md b/api-reference/beta/resources/windowsupdates-edition.md index cf91499ada0..c1d80e6ec18 100644 --- a/api-reference/beta/resources/windowsupdates-edition.md +++ b/api-reference/beta/resources/windowsupdates-edition.md @@ -13,7 +13,13 @@ Namespace: microsoft.graph.windowsUpdates [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents an edition of a particular Windows product. For example, Enterprise, Core, or Education. +Represents an edition of a particular Windows product. + +|Examples| +|:---| +|Enterprise| +|Core| +|Education| ## Properties @@ -22,8 +28,8 @@ Represents an edition of a particular Windows product. For example, Enterprise, |deviceFamily|String|The device family targeted by the edition| |endofServiceDateTime|DateTimeOffset|The date and time when the edition reaches or reached end of service. 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`. Read-only. | |generalAvailabilityDateTime|DateTimeOffset|The date and time when the edition became available to the general customers for the first time. 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`. Read-only.| -|id|String|The unique identifier for the entry. Read-only.| -|isInService|Boolean| Represents an edition of a particular Windows product. [Add link] | +|id|String|The unique identifier for the edition entry. Read-only.| +|isInService|Boolean| Represents an edition of a particular Windows product.| |name|String|The name of the edition. Read-only.| |releasedName|String|The public name of the edition. Read-only.| @@ -31,7 +37,7 @@ Represents an edition of a particular Windows product. For example, Enterprise, |Relationships|Type|Description| |:---|:---|:---| -|servicingPeriods| [microsoft.graph.windowsUpdates.servicingPeriod](.../resources/windowsupdates.servicingperiod.md)| Each object holds information of a servicing period related to the product edition.| +|servicingPeriods| [microsoft.graph.windowsUpdates.servicingPeriod](.../resources/windowsupdates.servicingperiod.md) collection| Each object holds information of a servicing period related to the product edition.| ## JSON representation From 83be0c4efd946eccdcead208e1b0fd8102e6302c Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Tue, 5 Mar 2024 16:36:00 -0800 Subject: [PATCH 039/139] Update windowsupdates-knownissue.md --- api-reference/beta/resources/windowsupdates-knownissue.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/api-reference/beta/resources/windowsupdates-knownissue.md b/api-reference/beta/resources/windowsupdates-knownissue.md index f3653cdb3b2..098b2e1d885 100644 --- a/api-reference/beta/resources/windowsupdates-knownissue.md +++ b/api-reference/beta/resources/windowsupdates-knownissue.md @@ -15,9 +15,7 @@ Namespace: microsoft.graph.windowsUpdates Represents a known issue related to a Windows product. -Supported Methods: GET - -Supported query parameters: filter(eq) status, filter(ge, le) startDateTime, filter(ge, le) lastUpdatedDateTime, filter(ge, le) resolvedDateTime +Example of known Issues: [Windows 11, version 22H2 known Issues and notifications](https://learn.microsoft.com/en-us/windows/release-health/status-windows-11-22h2) ## Properties From 91fb79b11ef0140b1137096bec34a00a26fec9db Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Wed, 6 Mar 2024 10:00:01 -0800 Subject: [PATCH 040/139] Update windowsupdates-servicingperiod.md --- .../beta/resources/windowsupdates-servicingperiod.md | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/api-reference/beta/resources/windowsupdates-servicingperiod.md b/api-reference/beta/resources/windowsupdates-servicingperiod.md index 15c0fa78c3c..5e331d7d6bb 100644 --- a/api-reference/beta/resources/windowsupdates-servicingperiod.md +++ b/api-reference/beta/resources/windowsupdates-servicingperiod.md @@ -15,16 +15,12 @@ Namespace: microsoft.graph.windowsUpdates Represents information about a servicing period related to a product edition. Each edition of a particular product has one or more servicing periods. -Supported Methods: GET - -Supported query parameters: filter(eq) name, expand(editions, knownIssues, revisions). - ## Properties |Property|Type|Description| |:---|:---|:---| |endDateTime|DateTimeOffset|The date and time when the servicing period ends. 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`. Read-only.| -|id|String|The unique identifier for the catalog entry. Read-only.| +|id|String|The unique identifier for the servicing period. Read-only.| |name|String|The name of the servicing period. For example, `Modern Lifecycle`.| |startDateTime|DateTimeOffset|The start date and time of the servicing period. 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`. Read-only.| From 1881c5e1335cfb55b1641563616843401af39bd6 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Wed, 6 Mar 2024 10:06:04 -0800 Subject: [PATCH 041/139] Update windowsupdates-product.md --- api-reference/beta/resources/windowsupdates-product.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/api-reference/beta/resources/windowsupdates-product.md b/api-reference/beta/resources/windowsupdates-product.md index cb64358d48a..16fb10dc9ea 100644 --- a/api-reference/beta/resources/windowsupdates-product.md +++ b/api-reference/beta/resources/windowsupdates-product.md @@ -15,9 +15,13 @@ Namespace: microsoft.graph.windowsUpdates Represents a Windows product. -Supported Methods: GET +Example of a Windows Product: -Supported query parameters: filter(eq) name, expand(editions, knownIssues, revisions). +|Name|Example| +|:---|:---| +|Name| Windows 11, version 22H2 | +|Friendly Name| Version 22H2 (OS build 22621) | +|Group Name| Windows 11| ## Properties @@ -25,7 +29,7 @@ Supported query parameters: filter(eq) name, expand(editions, knownIssues, revis |:---|:---|:---| |friendlyName|String|The name of the product. For example, `Version 22H2 (OS build 22621)`. Read-only.| |groupName|String|The name of the product group. For example, `Windows 11`. Read-only.| -|id|String|The unique identifier for the catalog entry. Read-only.| +|id|String|The unique identifier for the product. Read-only.| |name|String|The name of the product. For example, `Windows 11, version 22H2`. Read-only.| |releaseDateTime|DateTimeOffset|The release date for the content. 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`. Read-only.| From 2eb360244cd88bf67c239d6fda4e0a560158f64e Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Wed, 6 Mar 2024 22:03:29 -0800 Subject: [PATCH 042/139] Update windowsupdates-product.md --- api-reference/beta/resources/windowsupdates-product.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/windowsupdates-product.md b/api-reference/beta/resources/windowsupdates-product.md index 16fb10dc9ea..b7c560f088f 100644 --- a/api-reference/beta/resources/windowsupdates-product.md +++ b/api-reference/beta/resources/windowsupdates-product.md @@ -39,7 +39,7 @@ Example of a Windows Product: |:---|:---|:---| |editions|[microsoft.graph.windowsUpdates.edition](.../resources/windowsupdates-edition.md) collection| Represents an edition of a particular Windows product. | |knownIssues|[microsoft.graph.windowsUpdates.knownIssue](.../resources/windowsupdates-knownIssue.md) collection| Represents a known issue related to a Windows product. | -|revisions|[microsoft.graph.windowsUpdates.productrevision](.../resources/windowsupdates-productrevision.md)|Represents a product revision.| +|revisions|[microsoft.graph.windowsUpdates.productrevision](.../resources/windowsupdates-productrevision.md) collection|Represents a product revision.| ## JSON representation The following JSON representation shows the resource type. From 9c0c837bf552e2c1a9c3e9e6396da40c4ad57774 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Thu, 7 Mar 2024 17:20:35 -0800 Subject: [PATCH 043/139] Create windowsupdates-itembody.md --- api-reference/beta/windowsupdates-itembody.md | 40 +++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 api-reference/beta/windowsupdates-itembody.md diff --git a/api-reference/beta/windowsupdates-itembody.md b/api-reference/beta/windowsupdates-itembody.md new file mode 100644 index 00000000000..0cc4bed015a --- /dev/null +++ b/api-reference/beta/windowsupdates-itembody.md @@ -0,0 +1,40 @@ +--- +title: "itemBody resource type" +description: "Represents properties of the body of an item, such as a message, event or group post." +ms.localizationpriority: medium +author: "skandula" +ms.service: "windows-10" +doc_type: resourcePageType +--- + +# itemBody resource type + +Namespace: microsoft.graph.windowsUpdates + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Represents a container for holding content and its type. + +## Properties +| Property | Type |Description| +|:---------------|:--------|:----------| +|content|String|The content of the item.| +|contentType|bodyType|The type of the contentindicated by enum value of bodyType| + +## JSON representation + +Here is a JSON representation of the resource + +``` json +{ + "@odata.type": "#microsoft.graph.windowsUpdates.itembody", + "content": "string", + "contentType": "string" +} +``` From 638f9c98c896217fb5024fa442cf0ead8d2abe96 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Thu, 7 Mar 2024 20:46:51 -0800 Subject: [PATCH 044/139] Create windowsupdates.findByCatalogId.md --- .../beta/windowsupdates.findByCatalogId.md | 135 ++++++++++++++++++ 1 file changed, 135 insertions(+) create mode 100644 api-reference/beta/windowsupdates.findByCatalogId.md diff --git a/api-reference/beta/windowsupdates.findByCatalogId.md b/api-reference/beta/windowsupdates.findByCatalogId.md new file mode 100644 index 00000000000..833ef3dcd22 --- /dev/null +++ b/api-reference/beta/windowsupdates.findByCatalogId.md @@ -0,0 +1,135 @@ +--- +title: "findByCatalogId function" +description: "This function finds the product revisions associated with the catalog Id and also finds the known Issues directly or indirectly related to the catalog id, and returns this information in a collection of type *Windows.graph.windowsUpdates.product* to provide complete context." +author: "skandula" +ms.localizationpriority: medium +ms.service: "windows-10" +doc_type: resourcePageType +--- + +# findByCatalogId function + +Namespace: microsoft.graph.windowsUpdates + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +This function finds the product revisions associated with the catalog ID and also finds the known Issues directly or indirectly related to the catalog id, and returns this information in a collection of type Windows.graph.windowsUpdates.product. + +## HTTP request + + +``` http +GET /admin/windows/updates/products/FindByCatalogId(catalogID= {catalogID}) + +``` +## Function Parameters +In the request URL, provide the following query parameters with values. +The following table shows the parameters that must be used with this function. + +|Parameter|Type|Description| +|:---|:---|:---| +|catalogID|String|Catalog identifier from the catalog entry.| +|bindingParameter|method|This method has to be called on collection of type [microsoft.graph.windowsupdates.product](.../resources/windowsupdates.product.md)| + +## Examples + +### Request +The following is an example of a request. + +# [HTTP](#tab/http) + +``` http +GET /admin/windows/updates/products/FindByCatalogId(catalogID= '10cb1ba292c5586e22c9991be3f12fbd39f2ebf231cb5d201c67f42fbaccc567')?expand=revisions($expand=catalogEntry,knowledgeBaseArticle),knownIssues($expand=originatingKnowledgeBaseArticle,resolvingKnowledgeBaseArticle) +``` + +### Response +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. +> + +``` http + + +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.windowsUpdates.product)", + "value": [ + { + "id": "1", + "name": "Windows 11, version 22H2", + "groupName": "Windows 11", + "friendlyNames": [ + "Version 22H2 (OS build 22621)" + ], + "revisions": [ + { + "id": "10.0.22621.2215", + "displayName": "Windows 11, version 22H2, build 22621.2215", + "releaseDateTime": "2023-08-22T00:00:00Z", + "version": "22H2", + "osBuild": { + "BuildNumber": 22621, + "MajorVersion": 10, + "MinorVersion": 0, + "UpdateBuildRevision": 2215 + }, + "catalogEntry": { + "@odata.type": "#microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry", + "deployableUntilDateTime": null, + "displayName": "08/22/2023 - 2023.08 D Update for Windows 10 and later", + "id": "10cb1ba292c5586e22c9991be3f12fbd39f2ebf231cb5d201c67f42fbaccc567", + "releaseDateTime": "2023-08-22T00:00:00Z", + "catalogName": "2023-08 Cumulative Update Preview for Windows 10 and later", + "isExpeditable": true, + "qualityUpdateCadence": "Monthly", + "qualityUpdateClassification": "NonSecurity", + "shortName": "2023.08 D", + "cveSeverityInformation": null + }, + "knowledgeBaseArticle": { + "Url": "https://support.microsoft.com/help/5029351", + "Id": "KB5029351" + } + } + ], + "knownIssues": [ + { + "id": "WI670072", + "status": "mitigatedExternal", + "webViewUrl": "https://admin.microsoft.com/Adminportal/Home#/windowsreleasehealth/knownissues/:/issue/WI670072", + "description": "Investigation concluded that the error reported by users was not caused by the August 2023 preview updates.", + "startDateTime": "2023-08-22T10:00:00-07:00", + "title": "Microsoft received reports about an “UNSUPPORTED_PROCESSOR” error", + "resolvedDateTime": "2023-09-07T16:14:07.1881817-07:00", + "lastUpdatedDateTime": "2023-09-07T16:41:58.577-07:00", + "originatingKnowledgeBaseArticle": { + "Url": "https://support.microsoft.com/help/5029351", + "Id": "KB5029351" + }, + "resolvingKnowledgeBaseArticle": null, + "safeguardHoldIds": [], + "knownIssueHistories": [ + { + "createdDateTime": "2023-08-24T02:51:27.29Z", + "body": { + "content": "Microsoft has received reports of an issue in which users are receiving an “UNSUPPORTED_PROCESSOR” error message on a blue screen after installing updates released on August 22, 2023 (KB5029351 (https://support.microsoft.com/help/5029351)) and then restarting their device. KB5029351 (https://support.microsoft.com/help/5029351) might automatically uninstall to allow Windows to start up as expected. KB5029351 (https://support.microsoft.com/help/5029351) might not offer to some Windows devices which might be affected by this issue.\n\nIf you are experiencing issues, please use Feedback Hub to file a report following the below steps:\n 1. Launch Feedback Hub by opening the Start menu and typing \"Feedback hub\", or pressing the Windows key + F\n 2. Fill in the \"Summarize your feedback\" and \"Explain in more detail\" boxes, then click Next.\n 3. Under the \"Choose a category\" section, click the \"Problem\" button, and select \"Install and Update\" category. Then select \"Downloading, installing, and configuring Windows Update” subcategory. Click Next.\n 4. Under the \"Find similar feedback\" section, select the \"Make new bug\" radio button and click Next.\n 5. Under the \"Add more details\" section, supply any relevant detail (Note this is not critical to addressing your issue).\n 6. Expand the \"Recreate my problem\" box and press \"Start recording\". Reproduce the issue on your device.\n 7. Press \"Stop recording\" once finished. Click the \"Submit\" button.\nFor additional information, see Send feedback to Microsoft with the Feedback Hub app (https://support.microsoft.com/windows/send-feedback-to-microsoft-with-the-feedback-hub-app-f59187f8-8739-22d6-ba93-f66612949332).\n\nNext steps: We are presently investigating to determine if this is an issue caused by Microsoft. We will provide an update when more information is available.\n\nAffected platforms:\n - Client: Windows 11, version 22H2; Windows 10, version 22H2; Windows 11, version 21H2\n - Server: None\n", + "contentType": "html" + } + }... + ] + }... + ] + }... + ] +} From b7b2715d8e104ca88cd51d0ff86f4031aee40c5b Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Thu, 7 Mar 2024 21:37:12 -0800 Subject: [PATCH 045/139] Create windowsupdates-getKnownIssuesByTimeRange.md --- ...indowsupdates-getKnownIssuesByTimeRange.md | 93 +++++++++++++++++++ 1 file changed, 93 insertions(+) create mode 100644 api-reference/beta/windowsupdates-getKnownIssuesByTimeRange.md diff --git a/api-reference/beta/windowsupdates-getKnownIssuesByTimeRange.md b/api-reference/beta/windowsupdates-getKnownIssuesByTimeRange.md new file mode 100644 index 00000000000..7af3b1e03df --- /dev/null +++ b/api-reference/beta/windowsupdates-getKnownIssuesByTimeRange.md @@ -0,0 +1,93 @@ +--- +title: "getKnownIssuesByTimeRange" +description: "This function gets the known issues related to a particular product based on timeframe in the past." +author: "skandula" +ms.localizationpriority: medium +ms.service: "windows-10" +doc_type: resourcePageType +--- + +# getKnownIssuesByTimeRange + +Namespace: microsoft.graph.windowsUpdates + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +This function gets the known issues related to a particular product based on timeframe in the past. + +## HTTP request + + +``` http +GET /admin/windows/updates/products({id})/GetKnownIssuesByTimeRange(daysInPast={daysInPast},includeAllActive={includeAllActive}) + +``` +## Function Parameters +In the request URL, provide the following query parameters with values. +The following table shows the parameters that must be used with this function. + +|Parameter|Type|Description| +|:---|:---|:---| +|daysInPast|Int32|This is the number of days to lookup in the past. This filter is applied on all known issues which are in final status and have a resolved date time.| +|includeAllActive|Boolean|The response will include all Active known issues if this is set to true or null. If this is set to false, the response will not have any Active known issues.| + +## Examples + +### Request +The following is an example of a request. + +# [HTTP](#tab/http) + +``` http +GET /admin/windows/updates/products('1')/GetKnownIssuesByTimeRange(daysInPast=70,includeAllActive=false) +``` + +### Response +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. +> + +``` http + +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.windowsUpdates.knownIssue)", + "value": [ + { + "id": "WI670072", + "status": "mitigatedExternal", + "webViewUrl": "https://admin.microsoft.com/Adminportal/Home#/windowsreleasehealth/knownissues/:/issue/WI670072", + "description": "Investigation concluded that the error reported by users was not caused by the August 2023 preview updates.", + "startDateTime": "2023-08-22T10:00:00-07:00", + "title": "Microsoft received reports about an “UNSUPPORTED_PROCESSOR” error", + "resolvedDateTime": "2023-09-07T16:14:07.1881817-07:00", + "lastUpdatedDateTime": "2023-09-07T16:41:58.577-07:00", + "originatingKnowledgeBaseArticle": { + "Url": "https://support.microsoft.com/help/5029351", + "Id": "KB5029351" + }, + "resolvingKnowledgeBaseArticle": null, + "safeguardHoldIds": [], + "knownIssueHistories": [ + { + "createdDateTime": "2023-08-24T02:51:27.29Z", + "body": { + "content": "Microsoft has received reports of an issue in which users are receiving an “UNSUPPORTED_PROCESSOR” error message on a blue screen after installing updates released on August 22, 2023 (KB5029351 (https://support.microsoft.com/help/5029351)) and then restarting their device. KB5029351 (https://support.microsoft.com/help/5029351) might automatically uninstall to allow Windows to start up as expected. KB5029351 (https://support.microsoft.com/help/5029351) might not offer to some Windows devices which might be affected by this issue.\n\nIf you are experiencing issues, please use Feedback Hub to file a report following the below steps:\n 1. Launch Feedback Hub by opening the Start menu and typing \"Feedback hub\", or pressing the Windows key + F\n 2. Fill in the \"Summarize your feedback\" and \"Explain in more detail\" boxes, then click Next.\n 3. Under the \"Choose a category\" section, click the \"Problem\" button, and select \"Install and Update\" category. Then select \"Downloading, installing, and configuring Windows Update” subcategory. Click Next.\n 4. Under the \"Find similar feedback\" section, select the \"Make new bug\" radio button and click Next.\n 5. Under the \"Add more details\" section, supply any relevant detail (Note this is not critical to addressing your issue).\n 6. Expand the \"Recreate my problem\" box and press \"Start recording\". Reproduce the issue on your device.\n 7. Press \"Stop recording\" once finished. Click the \"Submit\" button.\nFor additional information, see Send feedback to Microsoft with the Feedback Hub app (https://support.microsoft.com/windows/send-feedback-to-microsoft-with-the-feedback-hub-app-f59187f8-8739-22d6-ba93-f66612949332).\n\nNext steps: We are presently investigating to determine if this is an issue caused by Microsoft. We will provide an update when more information is available.\n\nAffected platforms:\n - Client: Windows 11, version 22H2; Windows 10, version 22H2; Windows 11, version 21H2\n - Server: None\n", + "contentType": "html" + } + } + ] + } + ] +} From 54ab932112d00646522d3e996cbe168abff4019a Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Thu, 7 Mar 2024 21:44:27 -0800 Subject: [PATCH 046/139] Update toc.yml --- api-reference/beta/toc.yml | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/api-reference/beta/toc.yml b/api-reference/beta/toc.yml index 37a4926d3af..16b20c4859c 100644 --- a/api-reference/beta/toc.yml +++ b/api-reference/beta/toc.yml @@ -10197,12 +10197,19 @@ items: - name: Known issue href: resources/windowsupdates-knownissue.md items: - - name: Known issue history item + - name: Known Issue history item href: resources/windowsupdates-knownissuehistoryitem.md + - name: Get known Issues by time range + href: resources/windowsupdates-getKnownIssuesByTimeRange.md - name: Edition href: resources/windowsupdates-edition.md - name: Servicing period href: resources/windowsupdates-servicingperiod.md + - name: Find Product revisions by Catalog ID + href: resources/windowsupdates-findByCatalogId.md + - name: Find Product revisions by KB number + href: resources/windowsupdates-findByCatalogId.md + - name: Compliance change href: resources/windowsupdates-compliancechange.md items: From b9d6a1d0404de13f05b6cb0d8cd6b830debcc7a7 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Fri, 8 Mar 2024 11:30:06 -0800 Subject: [PATCH 047/139] Delete api-reference/beta/windowsupdates-getKnownIssuesByTimeRange.md --- ...indowsupdates-getKnownIssuesByTimeRange.md | 93 ------------------- 1 file changed, 93 deletions(-) delete mode 100644 api-reference/beta/windowsupdates-getKnownIssuesByTimeRange.md diff --git a/api-reference/beta/windowsupdates-getKnownIssuesByTimeRange.md b/api-reference/beta/windowsupdates-getKnownIssuesByTimeRange.md deleted file mode 100644 index 7af3b1e03df..00000000000 --- a/api-reference/beta/windowsupdates-getKnownIssuesByTimeRange.md +++ /dev/null @@ -1,93 +0,0 @@ ---- -title: "getKnownIssuesByTimeRange" -description: "This function gets the known issues related to a particular product based on timeframe in the past." -author: "skandula" -ms.localizationpriority: medium -ms.service: "windows-10" -doc_type: resourcePageType ---- - -# getKnownIssuesByTimeRange - -Namespace: microsoft.graph.windowsUpdates - -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] - -This function gets the known issues related to a particular product based on timeframe in the past. - -## HTTP request - - -``` http -GET /admin/windows/updates/products({id})/GetKnownIssuesByTimeRange(daysInPast={daysInPast},includeAllActive={includeAllActive}) - -``` -## Function Parameters -In the request URL, provide the following query parameters with values. -The following table shows the parameters that must be used with this function. - -|Parameter|Type|Description| -|:---|:---|:---| -|daysInPast|Int32|This is the number of days to lookup in the past. This filter is applied on all known issues which are in final status and have a resolved date time.| -|includeAllActive|Boolean|The response will include all Active known issues if this is set to true or null. If this is set to false, the response will not have any Active known issues.| - -## Examples - -### Request -The following is an example of a request. - -# [HTTP](#tab/http) - -``` http -GET /admin/windows/updates/products('1')/GetKnownIssuesByTimeRange(daysInPast=70,includeAllActive=false) -``` - -### Response -The following example shows the response. ->**Note:** The response object shown here might be shortened for readability. -> - -``` http - -{ - "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.windowsUpdates.knownIssue)", - "value": [ - { - "id": "WI670072", - "status": "mitigatedExternal", - "webViewUrl": "https://admin.microsoft.com/Adminportal/Home#/windowsreleasehealth/knownissues/:/issue/WI670072", - "description": "Investigation concluded that the error reported by users was not caused by the August 2023 preview updates.", - "startDateTime": "2023-08-22T10:00:00-07:00", - "title": "Microsoft received reports about an “UNSUPPORTED_PROCESSOR” error", - "resolvedDateTime": "2023-09-07T16:14:07.1881817-07:00", - "lastUpdatedDateTime": "2023-09-07T16:41:58.577-07:00", - "originatingKnowledgeBaseArticle": { - "Url": "https://support.microsoft.com/help/5029351", - "Id": "KB5029351" - }, - "resolvingKnowledgeBaseArticle": null, - "safeguardHoldIds": [], - "knownIssueHistories": [ - { - "createdDateTime": "2023-08-24T02:51:27.29Z", - "body": { - "content": "Microsoft has received reports of an issue in which users are receiving an “UNSUPPORTED_PROCESSOR” error message on a blue screen after installing updates released on August 22, 2023 (KB5029351 (https://support.microsoft.com/help/5029351)) and then restarting their device. KB5029351 (https://support.microsoft.com/help/5029351) might automatically uninstall to allow Windows to start up as expected. KB5029351 (https://support.microsoft.com/help/5029351) might not offer to some Windows devices which might be affected by this issue.\n\nIf you are experiencing issues, please use Feedback Hub to file a report following the below steps:\n 1. Launch Feedback Hub by opening the Start menu and typing \"Feedback hub\", or pressing the Windows key + F\n 2. Fill in the \"Summarize your feedback\" and \"Explain in more detail\" boxes, then click Next.\n 3. Under the \"Choose a category\" section, click the \"Problem\" button, and select \"Install and Update\" category. Then select \"Downloading, installing, and configuring Windows Update” subcategory. Click Next.\n 4. Under the \"Find similar feedback\" section, select the \"Make new bug\" radio button and click Next.\n 5. Under the \"Add more details\" section, supply any relevant detail (Note this is not critical to addressing your issue).\n 6. Expand the \"Recreate my problem\" box and press \"Start recording\". Reproduce the issue on your device.\n 7. Press \"Stop recording\" once finished. Click the \"Submit\" button.\nFor additional information, see Send feedback to Microsoft with the Feedback Hub app (https://support.microsoft.com/windows/send-feedback-to-microsoft-with-the-feedback-hub-app-f59187f8-8739-22d6-ba93-f66612949332).\n\nNext steps: We are presently investigating to determine if this is an issue caused by Microsoft. We will provide an update when more information is available.\n\nAffected platforms:\n - Client: Windows 11, version 22H2; Windows 10, version 22H2; Windows 11, version 21H2\n - Server: None\n", - "contentType": "html" - } - } - ] - } - ] -} From 36cb293ee7e6cc03ba8ed24e3c5fe350d616999f Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Fri, 8 Mar 2024 12:43:06 -0800 Subject: [PATCH 048/139] Create windowsupdates-get-knownIssues-time-range.md --- ...ndowsupdates-get-knownIssues-time-range.md | 149 ++++++++++++++++++ 1 file changed, 149 insertions(+) create mode 100644 api-reference/beta/api/windowsupdates-get-knownIssues-time-range.md diff --git a/api-reference/beta/api/windowsupdates-get-knownIssues-time-range.md b/api-reference/beta/api/windowsupdates-get-knownIssues-time-range.md new file mode 100644 index 00000000000..61cd594d90f --- /dev/null +++ b/api-reference/beta/api/windowsupdates-get-knownIssues-time-range.md @@ -0,0 +1,149 @@ +--- +title: "Get Known Issues by Time Range" +description: "This function gets the known issues related to a particular product based on timeframe in the past." +author: "skandula" +ms.localizationpriority: medium +ms.service: "windows-10" +doc_type: apiPageType +--- + +# Get Known Issues by Time Range + +Namespace: microsoft.graph.windowsUpdates + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Get a list of known Issues related to a particular product based on timeframe in the past. + +[!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/windowsupdates-catalog-list-entries-permissions.md)] + +[!INCLUDE [rbac-windows-updates-apis](../includes/rbac-for-apis/rbac-windows-updates-apis.md)] + + +## HTTP request + + +``` http +GET /admin/windows/updates/products({id})/GetKnownIssuesByTimeRange(daysInPast={daysInPast},includeAllActive={includeAllActive}) + +``` +## Query Parameters +In the request URL, provide the following query parameters with values. +The following table shows the parameters that must be used with this function. + +|Parameter|Type|Description| +|:---|:---|:---| +|daysInPast|Int32|This is the number of days to lookup in the past. This filter is applied on all known issues which are in final status and have a resolved date time.| +|includeAllActive|Boolean|The response will include all Active known issues if this is set to true or null. If this is set to false, the response will not have any Active known issues.| + +## 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 list of [known Issues](../resources/windowsupdates-knownissues.md) per the given time range in the response body. + +## Examples + +### Request +The following is an example of a request. + +# [HTTP](#tab/http) + +``` http +GET /admin/windows/updates/products('1')/GetKnownIssuesByTimeRange(daysInPast=70,includeAllActive=false) +``` +# [C#](#tab/csharp) +[!INCLUDE [sample-code](../includes/snippets/csharp/get-knownissues-timerange-csharp-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [CLI](#tab/cli) +[!INCLUDE [sample-code](../includes/snippets/cli/get-knownissues-timerange-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Go](#tab/go) +[!INCLUDE [sample-code](../includes/snippets/go/get-knownissues-timerange-go-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Java](#tab/java) +[!INCLUDE [sample-code](../includes/snippets/java/get-knownissues-timerange-java-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [JavaScript](#tab/javascript) +[!INCLUDE [sample-code](../includes/snippets/javascript/get-knownissues-timerange-javascript-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [PHP](#tab/php) +[!INCLUDE [sample-code](../includes/snippets/php/get-knownissues-timerange-php-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [PowerShell](#tab/powershell) +[!INCLUDE [sample-code](../includes/snippets/powershell/get-knownissues-timerange-powershell-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Python](#tab/python) +[!INCLUDE [sample-code](../includes/snippets/python/get-knownissues-timerange-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 + +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.windowsUpdates.knownIssue)", + "value": [ + { + "id": "WI670072", + "status": "mitigatedExternal", + "webViewUrl": "https://admin.microsoft.com/Adminportal/Home#/windowsreleasehealth/knownissues/:/issue/WI670072", + "description": "Investigation concluded that the error reported by users was not caused by the August 2023 preview updates.", + "startDateTime": "2023-08-22T10:00:00-07:00", + "title": "Microsoft received reports about an “UNSUPPORTED_PROCESSOR” error", + "resolvedDateTime": "2023-09-07T16:14:07.1881817-07:00", + "lastUpdatedDateTime": "2023-09-07T16:41:58.577-07:00", + "originatingKnowledgeBaseArticle": { + "Url": "https://support.microsoft.com/help/5029351", + "Id": "KB5029351" + }, + "resolvingKnowledgeBaseArticle": null, + "safeguardHoldIds": [], + "knownIssueHistories": [ + { + "createdDateTime": "2023-08-24T02:51:27.29Z", + "body": { + "content": "Microsoft has received reports of an issue in which users are receiving an “UNSUPPORTED_PROCESSOR” error message on a blue screen after installing updates released on August 22, 2023 (KB5029351 (https://support.microsoft.com/help/5029351)) and then restarting their device. KB5029351 (https://support.microsoft.com/help/5029351) might automatically uninstall to allow Windows to start up as expected. KB5029351 (https://support.microsoft.com/help/5029351) might not offer to some Windows devices which might be affected by this issue.\n\nIf you are experiencing issues, please use Feedback Hub to file a report following the below steps:\n 1. Launch Feedback Hub by opening the Start menu and typing \"Feedback hub\", or pressing the Windows key + F\n 2. Fill in the \"Summarize your feedback\" and \"Explain in more detail\" boxes, then click Next.\n 3. Under the \"Choose a category\" section, click the \"Problem\" button, and select \"Install and Update\" category. Then select \"Downloading, installing, and configuring Windows Update” subcategory. Click Next.\n 4. Under the \"Find similar feedback\" section, select the \"Make new bug\" radio button and click Next.\n 5. Under the \"Add more details\" section, supply any relevant detail (Note this is not critical to addressing your issue).\n 6. Expand the \"Recreate my problem\" box and press \"Start recording\". Reproduce the issue on your device.\n 7. Press \"Stop recording\" once finished. Click the \"Submit\" button.\nFor additional information, see Send feedback to Microsoft with the Feedback Hub app (https://support.microsoft.com/windows/send-feedback-to-microsoft-with-the-feedback-hub-app-f59187f8-8739-22d6-ba93-f66612949332).\n\nNext steps: We are presently investigating to determine if this is an issue caused by Microsoft. We will provide an update when more information is available.\n\nAffected platforms:\n - Client: Windows 11, version 22H2; Windows 10, version 22H2; Windows 11, version 21H2\n - Server: None\n", + "contentType": "html" + } + } + ] + } + ] +} From 2fb25bbf038ef3511ceb0b2a9058890a8ff399ca Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Fri, 8 Mar 2024 13:49:24 -0800 Subject: [PATCH 049/139] Update Microsoft.WindowsUpdates.json --- changelog/Microsoft.WindowsUpdates.json | 50 +++++++++++++++++++++++++ 1 file changed, 50 insertions(+) diff --git a/changelog/Microsoft.WindowsUpdates.json b/changelog/Microsoft.WindowsUpdates.json index 974295048f0..3d7f5186ea0 100644 --- a/changelog/Microsoft.WindowsUpdates.json +++ b/changelog/Microsoft.WindowsUpdates.json @@ -1069,6 +1069,56 @@ "CreatedDateTime": "2023-02-02T03:35:46.1510967Z", "WorkloadArea": "Device and app management", "SubArea": "Device updates" + }, + { + "ChangeList": [ + { + "Id": " ", + "ApiChange": "Resource", + "ChangedApiName": "product", + "ChangeType": "Addition", + "Description": "Added the [product](https://learn.microsoft.com/en-us/graph/api/resources/product?view=graph-rest-beta) resource type."", + "Target": "product" + }, + { + "Id": "", + "ApiChange": "Resource", + "ChangedApiName": "edition", + "ChangeType": "Addition", + "Description": "Added the [edition](https://learn.microsoft.com/en-us/graph/api/resources/edition?view=graph-rest-beta) resource type."", + "Target": "edition" + }, + { + "Id": " ", + "ApiChange": "Resource", + "ChangedApiName": "knownissue", + "ChangeType": "Addition", + "Description": "Added the [knownissue](https://learn.microsoft.com/en-us/graph/api/resources/knownissue?view=graph-rest-beta) resource type.", + "Target": "knownissue" + }, + { + "Id": " ", + "ApiChange": "Resource", + "ChangedApiName": "servicingPeriod", + "ChangeType": "Addition", + "Description": "Added the [servicingPeriod](https://learn.microsoft.com/en-us/graph/api/resources/servicingPeriod?view=graph-rest-beta) resource type.", + "Target": "servicingPeriod" + }, + { + "Id": " ", + "ApiChange": "Resource", + "ChangedApiName": "knownIssueHistoryItem", + "ChangeType": "Addition", + "Description": "Added the [knownIssueHistoryItem](https://learn.microsoft.com/en-us/graph/api/resources/knownIssueHistoryItemt?view=graph-rest-beta) resource type.", + "Target": "knownIssueHistoryItem" + } + ], + "Id": " ", + "Cloud": "Prod", + "Version": "beta", + "CreatedDateTime": " ", + "WorkloadArea": "Device and app management", + "SubArea": "Device updates" } ] } From 9cb13e02b471f7e976d7f243eccbd1587d77c394 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Fri, 8 Mar 2024 14:35:47 -0800 Subject: [PATCH 050/139] Update windowsupdates-get-knownIssues-time-range.md --- ...ndowsupdates-get-knownIssues-time-range.md | 37 ++----------------- 1 file changed, 3 insertions(+), 34 deletions(-) diff --git a/api-reference/beta/api/windowsupdates-get-knownIssues-time-range.md b/api-reference/beta/api/windowsupdates-get-knownIssues-time-range.md index 61cd594d90f..0ff6923afbe 100644 --- a/api-reference/beta/api/windowsupdates-get-knownIssues-time-range.md +++ b/api-reference/beta/api/windowsupdates-get-knownIssues-time-range.md @@ -34,8 +34,8 @@ Choose the permission or permissions marked as least privileged for this API. Us --> ``` http GET /admin/windows/updates/products({id})/GetKnownIssuesByTimeRange(daysInPast={daysInPast},includeAllActive={includeAllActive}) +``` -``` ## Query Parameters In the request URL, provide the following query parameters with values. The following table shows the parameters that must be used with this function. @@ -71,42 +71,10 @@ The following is an example of a request. ``` http GET /admin/windows/updates/products('1')/GetKnownIssuesByTimeRange(daysInPast=70,includeAllActive=false) ``` -# [C#](#tab/csharp) -[!INCLUDE [sample-code](../includes/snippets/csharp/get-knownissues-timerange-csharp-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [CLI](#tab/cli) -[!INCLUDE [sample-code](../includes/snippets/cli/get-knownissues-timerange-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [Go](#tab/go) -[!INCLUDE [sample-code](../includes/snippets/go/get-knownissues-timerange-go-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [Java](#tab/java) -[!INCLUDE [sample-code](../includes/snippets/java/get-knownissues-timerange-java-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [JavaScript](#tab/javascript) -[!INCLUDE [sample-code](../includes/snippets/javascript/get-knownissues-timerange-javascript-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [PHP](#tab/php) -[!INCLUDE [sample-code](../includes/snippets/php/get-knownissues-timerange-php-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [PowerShell](#tab/powershell) -[!INCLUDE [sample-code](../includes/snippets/powershell/get-knownissues-timerange-powershell-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [Python](#tab/python) -[!INCLUDE [sample-code](../includes/snippets/python/get-knownissues-timerange-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. > +[!INCLUDE [permissions-table](../includes/permissions/windowsupdates-catalog-list-entries-permissions.md)] + +[!INCLUDE [rbac-windows-updates-apis](../includes/rbac-for-apis/rbac-windows-updates-apis.md)] + + +## HTTP request + + +``` http +GET /admin/windows/updates/products/FindByCatalogId(catalogID='catalogID') +``` + +## Query Parameters +In the request URL, provide the following query parameters with values. +The following table shows the parameters that must be used with this function. + +|Parameter|Type|Description| +|:---|:---|:---| +|catalogID|string| The catalog identifier from the catalog entry.| + + +## 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 this information in a collection of type [product](../resources/windowsupdates-product.md) in the response body. + +## Examples + +### Request +The following is an example of a request. + +# [HTTP](#tab/http) + +``` http +GET /admin/windows/updates/products/FindByCatalogId(catalogID= '10cb1ba292c5586e22c9991be3f12fbd39f2ebf231cb5d201c67f42fbaccc567')?expand=revisions($expand=catalogEntry,knowledgeBaseArticle),knownIssues($expand=originatingKnowledgeBaseArticle,resolvingKnowledgeBaseArticle) + +``` + +### Response +The following example shows the response. + +>**Note:** The response object shown here might be shortened for readability. +> + +``` http + +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.windowsUpdates.product)", + "value": [ + { + "id": "1", + "name": "Windows 11, version 22H2", + "groupName": "Windows 11", + "friendlyNames": [ + "Version 22H2 (OS build 22621)" + ], + "revisions": [ + { + "id": "10.0.22621.2215", + "displayName": "Windows 11, version 22H2, build 22621.2215", + "releaseDateTime": "2023-08-22T00:00:00Z", + "version": "22H2", + "osBuild": { + "BuildNumber": 22621, + "MajorVersion": 10, + "MinorVersion": 0, + "UpdateBuildRevision": 2215 + }, + "catalogEntry": { + "@odata.type": "#microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry", + "deployableUntilDateTime": null, + "displayName": "08/22/2023 - 2023.08 D Update for Windows 10 and later", + "id": "10cb1ba292c5586e22c9991be3f12fbd39f2ebf231cb5d201c67f42fbaccc567", + "releaseDateTime": "2023-08-22T00:00:00Z", + "catalogName": "2023-08 Cumulative Update Preview for Windows 10 and later", + "isExpeditable": true, + "qualityUpdateCadence": "Monthly", + "qualityUpdateClassification": "NonSecurity", + "shortName": "2023.08 D", + "cveSeverityInformation": null + }, + "knowledgeBaseArticle": { + "Url": "https://support.microsoft.com/help/5029351", + "Id": "KB5029351" + } + } + ], + "knownIssues": [ + { + "id": "WI670072", + "status": "mitigatedExternal", + "webViewUrl": "https://admin.microsoft.com/Adminportal/Home#/windowsreleasehealth/knownissues/:/issue/WI670072", + "description": "Investigation concluded that the error reported by users was not caused by the August 2023 preview updates.", + "startDateTime": "2023-08-22T10:00:00-07:00", + "title": "Microsoft received reports about an “UNSUPPORTED_PROCESSOR” error", + "resolvedDateTime": "2023-09-07T16:14:07.1881817-07:00", + "lastUpdatedDateTime": "2023-09-07T16:41:58.577-07:00", + "originatingKnowledgeBaseArticle": { + "Url": "https://support.microsoft.com/help/5029351", + "Id": "KB5029351" + }, + "resolvingKnowledgeBaseArticle": null, + "safeguardHoldIds": [], + "knownIssueHistories": [ + { + "createdDateTime": "2023-08-24T02:51:27.29Z", + "body": { + "content": "Microsoft has received reports of an issue in which users are receiving an “UNSUPPORTED_PROCESSOR” error message on a blue screen after installing updates released on August 22, 2023 (KB5029351 (https://support.microsoft.com/help/5029351)) and then restarting their device. KB5029351 (https://support.microsoft.com/help/5029351) might automatically uninstall to allow Windows to start up as expected. KB5029351 (https://support.microsoft.com/help/5029351) might not offer to some Windows devices which might be affected by this issue.\n\nIf you are experiencing issues, please use Feedback Hub to file a report following the below steps:\n 1. Launch Feedback Hub by opening the Start menu and typing \"Feedback hub\", or pressing the Windows key + F\n 2. Fill in the \"Summarize your feedback\" and \"Explain in more detail\" boxes, then click Next.\n 3. Under the \"Choose a category\" section, click the \"Problem\" button, and select \"Install and Update\" category. Then select \"Downloading, installing, and configuring Windows Update” subcategory. Click Next.\n 4. Under the \"Find similar feedback\" section, select the \"Make new bug\" radio button and click Next.\n 5. Under the \"Add more details\" section, supply any relevant detail (Note this is not critical to addressing your issue).\n 6. Expand the \"Recreate my problem\" box and press \"Start recording\". Reproduce the issue on your device.\n 7. Press \"Stop recording\" once finished. Click the \"Submit\" button.\nFor additional information, see Send feedback to Microsoft with the Feedback Hub app (https://support.microsoft.com/windows/send-feedback-to-microsoft-with-the-feedback-hub-app-f59187f8-8739-22d6-ba93-f66612949332).\n\nNext steps: We are presently investigating to determine if this is an issue caused by Microsoft. We will provide an update when more information is available.\n\nAffected platforms:\n - Client: Windows 11, version 22H2; Windows 10, version 22H2; Windows 11, version 21H2\n - Server: None\n", + "contentType": "html" + } + }... + ] + }... + ] + }... + ] +} + +``` From 6e5ebd9b28dd00764a5cad15983b5d3fa80c527c Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Fri, 8 Mar 2024 16:24:00 -0800 Subject: [PATCH 052/139] Create windowsupdates-find-by-KbNumber.md --- .../api/windowsupdates-find-by-KbNumber.md | 161 ++++++++++++++++++ 1 file changed, 161 insertions(+) create mode 100644 api-reference/beta/api/windowsupdates-find-by-KbNumber.md diff --git a/api-reference/beta/api/windowsupdates-find-by-KbNumber.md b/api-reference/beta/api/windowsupdates-find-by-KbNumber.md new file mode 100644 index 00000000000..08916cd7f27 --- /dev/null +++ b/api-reference/beta/api/windowsupdates-find-by-KbNumber.md @@ -0,0 +1,161 @@ +--- +title: "Find Product information by KbNumber" +description: "Finds the product revisions associated with the kbNumber and also finds the known issues directly or indirectly related to the kbNumber." +author: "skandula" +ms.localizationpriority: medium +ms.service: "windows-10" +doc_type: apiPageType +--- + +# Find Product information by KbNumber + +Namespace: microsoft.graph.windowsUpdates + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +This function finds the product revisions associated with the kbNumber and also finds the known issues directly or indirectly related to the kbNumber, and returns this information in a collection of type [windows.graph.windowsUpdates.product](../includes/permissions/windowsupdates-product.md) to provide complete context. + + +[!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/windowsupdates-catalog-list-entries-permissions.md)] + +[!INCLUDE [rbac-windows-updates-apis](../includes/rbac-for-apis/rbac-windows-updates-apis.md)] + + +## HTTP request + + +``` http +GET /admin/windows/updates/products/FindByKbNumber(kbNumber={kbNumber}) + +``` + +## Query Parameters +In the request URL, provide the following query parameters with values. +The following table shows the parameters that must be used with this function. + +|Parameter|Type|Description| +|:---|:---|:---| +|kbNumber|Int32|Knowledge base article number.| + +## 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 returns this information in a collection of type [windows.graph.windowsUpdates.product](../includes/permissions/windowsupdates-product.md). + +## Examples + +### Request +The following is an example of a request. + +# [HTTP](#tab/http) + +``` http +GET /admin/windows/updates/products/FindByKbNumber(kbNumber=5029332)?expand=revisions($expand=catalogEntry,knowledgeBaseArticle),knownIssues +``` + +### Response +The following example shows the response. + +>**Note:** The response object shown here might be shortened for readability. +> + +``` http +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.windowsUpdates.product)", + "value": [ + { + "id": "1", + "name": "Windows 11, version 21H2", + "groupName": "Windows 11", + "friendlyNames": [ + "Version 21H2 (OS build 22000)" + ], + "revisions": [ + { + "id": "10.0.22000.2360", + "displayName": "Windows 11, version 21H2, build 22000.2360", + "releaseDateTime": "2023-08-22T00:00:00Z", + "version": "21H2", + "osBuild": { + "BuildNumber": 22000, + "MajorVersion": 10, + "MinorVersion": 0, + "UpdateBuildRevision": 2360 + }, + "catalogEntry": { + "@odata.type": "#microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry", + "deployableUntilDateTime": null, + "displayName": "08/22/2023 - 2023.08 D Update for Windows 10 and later", + "id": "10cb1ba292c5586e22c9991be3f12fbd39f2ebf231cb5d201c67f42fbaccc567", + "releaseDateTime": "2023-08-22T00:00:00Z", + "catalogName": "2023-08 Cumulative Update Preview for Windows 10 and later", + "isExpeditable": true, + "qualityUpdateCadence": "Monthly", + "qualityUpdateClassification": "NonSecurity", + "shortName": "2023.08 D", + "cveSeverityInformation": null + }, + "knowledgeBaseArticle": { + "Url": "https://support.microsoft.com/help/5029332", + "Id": "KB5029332" + } + } + ], + "knownIssues": [ + { + "id": "WI670073", + "status": "mitigatedExternal", + "webViewUrl": "https://admin.microsoft.com/Adminportal/Home#/windowsreleasehealth/knownissues/:/issue/WI670073", + "description": "Investigation concluded that the error reported by users was not caused by the August 2023 preview updates.", + "startDateTime": "2023-08-22T10:00:00-07:00", + "title": "Microsoft received reports about an “UNSUPPORTED_PROCESSOR” error", + "resolvedDateTime": "2023-09-07T16:14:07.1881817-07:00", + "lastUpdatedDateTime": "2023-09-07T16:41:58.577-07:00", + "originatingKnowledgeBaseArticle": { + "Url": "https://support.microsoft.com/help/5029332", + "Id": "KB5029332" + }, + "resolvingKnowledgeBaseArticle": null, + "safeguardHoldIds": [], + "knownIssueHistories": [ + { + "createdDateTime": "2023-08-24T02:51:27.29Z", + "body": { + "content": "Microsoft has received reports of an issue in which users are receiving an “UNSUPPORTED_PROCESSOR” error message on a blue screen after installing updates released on August 22, 2023 (KB5029351 (https://support.microsoft.com/help/5029351)) and then restarting their device. KB5029351 (https://support.microsoft.com/help/5029351) might automatically uninstall to allow Windows to start up as expected. KB5029351 (https://support.microsoft.com/help/5029351) might not offer to some Windows devices which might be affected by this issue.\n\nIf you are experiencing issues, please use Feedback Hub to file a report following the below steps:\n 1. Launch Feedback Hub by opening the Start menu and typing \"Feedback hub\", or pressing the Windows key + F\n 2. Fill in the \"Summarize your feedback\" and \"Explain in more detail\" boxes, then click Next.\n 3. Under the \"Choose a category\" section, click the \"Problem\" button, and select \"Install and Update\" category. Then select \"Downloading, installing, and configuring Windows Update” subcategory. Click Next.\n 4. Under the \"Find similar feedback\" section, select the \"Make new bug\" radio button and click Next.\n 5. Under the \"Add more details\" section, supply any relevant detail (Note this is not critical to addressing your issue).\n 6. Expand the \"Recreate my problem\" box and press \"Start recording\". Reproduce the issue on your device.\n 7. Press \"Stop recording\" once finished. Click the \"Submit\" button.\nFor additional information, see Send feedback to Microsoft with the Feedback Hub app (https://support.microsoft.com/windows/send-feedback-to-microsoft-with-the-feedback-hub-app-f59187f8-8739-22d6-ba93-f66612949332).\n\nNext steps: We are presently investigating to determine if this is an issue caused by Microsoft. We will provide an update when more information is available.\n\nAffected platforms:\n - Client: Windows 11, version 22H2; Windows 10, version 22H2; Windows 11, version 21H2\n - Server: None\n", + "contentType": "html" + } + } + ] + } + ] + } + ] +} + + +``` From 3a18a93290bec720638e779cff5b7a0eae5ba456 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Fri, 8 Mar 2024 16:39:14 -0800 Subject: [PATCH 053/139] Delete api-reference/beta/windowsupdates.findByCatalogId.md --- .../beta/windowsupdates.findByCatalogId.md | 135 ------------------ 1 file changed, 135 deletions(-) delete mode 100644 api-reference/beta/windowsupdates.findByCatalogId.md diff --git a/api-reference/beta/windowsupdates.findByCatalogId.md b/api-reference/beta/windowsupdates.findByCatalogId.md deleted file mode 100644 index 833ef3dcd22..00000000000 --- a/api-reference/beta/windowsupdates.findByCatalogId.md +++ /dev/null @@ -1,135 +0,0 @@ ---- -title: "findByCatalogId function" -description: "This function finds the product revisions associated with the catalog Id and also finds the known Issues directly or indirectly related to the catalog id, and returns this information in a collection of type *Windows.graph.windowsUpdates.product* to provide complete context." -author: "skandula" -ms.localizationpriority: medium -ms.service: "windows-10" -doc_type: resourcePageType ---- - -# findByCatalogId function - -Namespace: microsoft.graph.windowsUpdates - -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] - -This function finds the product revisions associated with the catalog ID and also finds the known Issues directly or indirectly related to the catalog id, and returns this information in a collection of type Windows.graph.windowsUpdates.product. - -## HTTP request - - -``` http -GET /admin/windows/updates/products/FindByCatalogId(catalogID= {catalogID}) - -``` -## Function Parameters -In the request URL, provide the following query parameters with values. -The following table shows the parameters that must be used with this function. - -|Parameter|Type|Description| -|:---|:---|:---| -|catalogID|String|Catalog identifier from the catalog entry.| -|bindingParameter|method|This method has to be called on collection of type [microsoft.graph.windowsupdates.product](.../resources/windowsupdates.product.md)| - -## Examples - -### Request -The following is an example of a request. - -# [HTTP](#tab/http) - -``` http -GET /admin/windows/updates/products/FindByCatalogId(catalogID= '10cb1ba292c5586e22c9991be3f12fbd39f2ebf231cb5d201c67f42fbaccc567')?expand=revisions($expand=catalogEntry,knowledgeBaseArticle),knownIssues($expand=originatingKnowledgeBaseArticle,resolvingKnowledgeBaseArticle) -``` - -### Response -The following example shows the response. ->**Note:** The response object shown here might be shortened for readability. -> - -``` http - - -{ - "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.windowsUpdates.product)", - "value": [ - { - "id": "1", - "name": "Windows 11, version 22H2", - "groupName": "Windows 11", - "friendlyNames": [ - "Version 22H2 (OS build 22621)" - ], - "revisions": [ - { - "id": "10.0.22621.2215", - "displayName": "Windows 11, version 22H2, build 22621.2215", - "releaseDateTime": "2023-08-22T00:00:00Z", - "version": "22H2", - "osBuild": { - "BuildNumber": 22621, - "MajorVersion": 10, - "MinorVersion": 0, - "UpdateBuildRevision": 2215 - }, - "catalogEntry": { - "@odata.type": "#microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry", - "deployableUntilDateTime": null, - "displayName": "08/22/2023 - 2023.08 D Update for Windows 10 and later", - "id": "10cb1ba292c5586e22c9991be3f12fbd39f2ebf231cb5d201c67f42fbaccc567", - "releaseDateTime": "2023-08-22T00:00:00Z", - "catalogName": "2023-08 Cumulative Update Preview for Windows 10 and later", - "isExpeditable": true, - "qualityUpdateCadence": "Monthly", - "qualityUpdateClassification": "NonSecurity", - "shortName": "2023.08 D", - "cveSeverityInformation": null - }, - "knowledgeBaseArticle": { - "Url": "https://support.microsoft.com/help/5029351", - "Id": "KB5029351" - } - } - ], - "knownIssues": [ - { - "id": "WI670072", - "status": "mitigatedExternal", - "webViewUrl": "https://admin.microsoft.com/Adminportal/Home#/windowsreleasehealth/knownissues/:/issue/WI670072", - "description": "Investigation concluded that the error reported by users was not caused by the August 2023 preview updates.", - "startDateTime": "2023-08-22T10:00:00-07:00", - "title": "Microsoft received reports about an “UNSUPPORTED_PROCESSOR” error", - "resolvedDateTime": "2023-09-07T16:14:07.1881817-07:00", - "lastUpdatedDateTime": "2023-09-07T16:41:58.577-07:00", - "originatingKnowledgeBaseArticle": { - "Url": "https://support.microsoft.com/help/5029351", - "Id": "KB5029351" - }, - "resolvingKnowledgeBaseArticle": null, - "safeguardHoldIds": [], - "knownIssueHistories": [ - { - "createdDateTime": "2023-08-24T02:51:27.29Z", - "body": { - "content": "Microsoft has received reports of an issue in which users are receiving an “UNSUPPORTED_PROCESSOR” error message on a blue screen after installing updates released on August 22, 2023 (KB5029351 (https://support.microsoft.com/help/5029351)) and then restarting their device. KB5029351 (https://support.microsoft.com/help/5029351) might automatically uninstall to allow Windows to start up as expected. KB5029351 (https://support.microsoft.com/help/5029351) might not offer to some Windows devices which might be affected by this issue.\n\nIf you are experiencing issues, please use Feedback Hub to file a report following the below steps:\n 1. Launch Feedback Hub by opening the Start menu and typing \"Feedback hub\", or pressing the Windows key + F\n 2. Fill in the \"Summarize your feedback\" and \"Explain in more detail\" boxes, then click Next.\n 3. Under the \"Choose a category\" section, click the \"Problem\" button, and select \"Install and Update\" category. Then select \"Downloading, installing, and configuring Windows Update” subcategory. Click Next.\n 4. Under the \"Find similar feedback\" section, select the \"Make new bug\" radio button and click Next.\n 5. Under the \"Add more details\" section, supply any relevant detail (Note this is not critical to addressing your issue).\n 6. Expand the \"Recreate my problem\" box and press \"Start recording\". Reproduce the issue on your device.\n 7. Press \"Stop recording\" once finished. Click the \"Submit\" button.\nFor additional information, see Send feedback to Microsoft with the Feedback Hub app (https://support.microsoft.com/windows/send-feedback-to-microsoft-with-the-feedback-hub-app-f59187f8-8739-22d6-ba93-f66612949332).\n\nNext steps: We are presently investigating to determine if this is an issue caused by Microsoft. We will provide an update when more information is available.\n\nAffected platforms:\n - Client: Windows 11, version 22H2; Windows 10, version 22H2; Windows 11, version 21H2\n - Server: None\n", - "contentType": "html" - } - }... - ] - }... - ] - }... - ] -} From 6a3e98e3d35654cb92129da77acd6d916edd051f Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Fri, 8 Mar 2024 16:47:27 -0800 Subject: [PATCH 054/139] Update windowsupdates-itembody.md --- api-reference/beta/windowsupdates-itembody.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/api-reference/beta/windowsupdates-itembody.md b/api-reference/beta/windowsupdates-itembody.md index 0cc4bed015a..d914318cbec 100644 --- a/api-reference/beta/windowsupdates-itembody.md +++ b/api-reference/beta/windowsupdates-itembody.md @@ -21,6 +21,10 @@ Represents a container for holding content and its type. |content|String|The content of the item.| |contentType|bodyType|The type of the contentindicated by enum value of bodyType| +## Relationships + +None. + ## JSON representation Here is a JSON representation of the resource From ff4ec2b31f49bd56af9acd7c6e624e7226331283 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Fri, 8 Mar 2024 16:56:29 -0800 Subject: [PATCH 055/139] Update toc.yml --- api-reference/beta/toc.yml | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/api-reference/beta/toc.yml b/api-reference/beta/toc.yml index 16b20c4859c..dab068be69b 100644 --- a/api-reference/beta/toc.yml +++ b/api-reference/beta/toc.yml @@ -10189,7 +10189,7 @@ items: href: resources/windowsupdates-driverupdatecatalogentry.md - name: List catalog entries href: api/windowsupdates-catalog-list-entries.md - - name: Windows release information + - name: Windows Release Information items: - name: Product href: resources/windowsupdates-product.md @@ -10200,16 +10200,17 @@ items: - name: Known Issue history item href: resources/windowsupdates-knownissuehistoryitem.md - name: Get known Issues by time range - href: resources/windowsupdates-getKnownIssuesByTimeRange.md + href: api/windowsupdates-get-knownIssues-time-range.md - name: Edition href: resources/windowsupdates-edition.md - name: Servicing period href: resources/windowsupdates-servicingperiod.md + - name: Item Body + href: resources/windowsupdates-itembody.md - name: Find Product revisions by Catalog ID - href: resources/windowsupdates-findByCatalogId.md + href: resources/windowsupdates-find-by-CatalogId.md - name: Find Product revisions by KB number - href: resources/windowsupdates-findByCatalogId.md - + href: resources/windowsupdates-find-by-KbNumber.md - name: Compliance change href: resources/windowsupdates-compliancechange.md items: From eec59b929d2f1aa4e2ea382fb59894a61a181fc6 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Fri, 8 Mar 2024 17:03:58 -0800 Subject: [PATCH 056/139] Create windowsupdates-itemBody.md --- .../beta/resources/windowsupdates-itemBody.md | 44 +++++++++++++++++++ 1 file changed, 44 insertions(+) create mode 100644 api-reference/beta/resources/windowsupdates-itemBody.md diff --git a/api-reference/beta/resources/windowsupdates-itemBody.md b/api-reference/beta/resources/windowsupdates-itemBody.md new file mode 100644 index 00000000000..d914318cbec --- /dev/null +++ b/api-reference/beta/resources/windowsupdates-itemBody.md @@ -0,0 +1,44 @@ +--- +title: "itemBody resource type" +description: "Represents properties of the body of an item, such as a message, event or group post." +ms.localizationpriority: medium +author: "skandula" +ms.service: "windows-10" +doc_type: resourcePageType +--- + +# itemBody resource type + +Namespace: microsoft.graph.windowsUpdates + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Represents a container for holding content and its type. + +## Properties +| Property | Type |Description| +|:---------------|:--------|:----------| +|content|String|The content of the item.| +|contentType|bodyType|The type of the contentindicated by enum value of bodyType| + +## Relationships + +None. + +## JSON representation + +Here is a JSON representation of the resource + +``` json +{ + "@odata.type": "#microsoft.graph.windowsUpdates.itembody", + "content": "string", + "contentType": "string" +} +``` From f0950fef598c4112dcdc15a85f5dd7f793c7ca99 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Sun, 10 Mar 2024 17:23:07 -0700 Subject: [PATCH 057/139] Delete api-reference/beta/windowsupdates-itembody.md --- api-reference/beta/windowsupdates-itembody.md | 44 ------------------- 1 file changed, 44 deletions(-) delete mode 100644 api-reference/beta/windowsupdates-itembody.md diff --git a/api-reference/beta/windowsupdates-itembody.md b/api-reference/beta/windowsupdates-itembody.md deleted file mode 100644 index d914318cbec..00000000000 --- a/api-reference/beta/windowsupdates-itembody.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: "itemBody resource type" -description: "Represents properties of the body of an item, such as a message, event or group post." -ms.localizationpriority: medium -author: "skandula" -ms.service: "windows-10" -doc_type: resourcePageType ---- - -# itemBody resource type - -Namespace: microsoft.graph.windowsUpdates - -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] - -Represents a container for holding content and its type. - -## Properties -| Property | Type |Description| -|:---------------|:--------|:----------| -|content|String|The content of the item.| -|contentType|bodyType|The type of the contentindicated by enum value of bodyType| - -## Relationships - -None. - -## JSON representation - -Here is a JSON representation of the resource - -``` json -{ - "@odata.type": "#microsoft.graph.windowsUpdates.itembody", - "content": "string", - "contentType": "string" -} -``` From 8ce21abf322bf86004bfb7f77a4e343f495b71dd Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Sun, 10 Mar 2024 17:39:48 -0700 Subject: [PATCH 058/139] Update Microsoft.WindowsUpdates.json --- changelog/Microsoft.WindowsUpdates.json | 32 +++++++++++++++---------- 1 file changed, 20 insertions(+), 12 deletions(-) diff --git a/changelog/Microsoft.WindowsUpdates.json b/changelog/Microsoft.WindowsUpdates.json index 3d7f5186ea0..80bd721ca1c 100644 --- a/changelog/Microsoft.WindowsUpdates.json +++ b/changelog/Microsoft.WindowsUpdates.json @@ -1073,50 +1073,58 @@ { "ChangeList": [ { - "Id": " ", + "Id": "a6639056-8a1d-4d07-8dc0-75fefd3a6006", "ApiChange": "Resource", "ChangedApiName": "product", "ChangeType": "Addition", - "Description": "Added the [product](https://learn.microsoft.com/en-us/graph/api/resources/product?view=graph-rest-beta) resource type."", + "Description": "Added the [product](https://learn.microsoft.com/en-us/graph/api/resources/windowsupdates-product?view=graph-rest-beta) resource type."", "Target": "product" }, { - "Id": "", + "Id": "a6639056-8a1d-4d07-8dc0-75fefd3a6006", "ApiChange": "Resource", "ChangedApiName": "edition", "ChangeType": "Addition", - "Description": "Added the [edition](https://learn.microsoft.com/en-us/graph/api/resources/edition?view=graph-rest-beta) resource type."", + "Description": "Added the [edition](https://learn.microsoft.com/en-us/graph/api/resources/windowsupdates-edition?view=graph-rest-beta) resource type."", "Target": "edition" }, { - "Id": " ", + "Id": "a6639056-8a1d-4d07-8dc0-75fefd3a6006", "ApiChange": "Resource", "ChangedApiName": "knownissue", "ChangeType": "Addition", - "Description": "Added the [knownissue](https://learn.microsoft.com/en-us/graph/api/resources/knownissue?view=graph-rest-beta) resource type.", + "Description": "Added the [knownissue](https://learn.microsoft.com/en-us/graph/api/resources/windowsupdates-knownissue?view=graph-rest-beta) resource type.", "Target": "knownissue" }, { - "Id": " ", + "Id": "a6639056-8a1d-4d07-8dc0-75fefd3a6006", "ApiChange": "Resource", "ChangedApiName": "servicingPeriod", "ChangeType": "Addition", - "Description": "Added the [servicingPeriod](https://learn.microsoft.com/en-us/graph/api/resources/servicingPeriod?view=graph-rest-beta) resource type.", + "Description": "Added the [servicingPeriod](https://learn.microsoft.com/en-us/graph/api/resources/windowsupdates-servicingPeriod?view=graph-rest-beta) resource type.", "Target": "servicingPeriod" }, { - "Id": " ", + "Id": "a6639056-8a1d-4d07-8dc0-75fefd3a6006", "ApiChange": "Resource", "ChangedApiName": "knownIssueHistoryItem", "ChangeType": "Addition", - "Description": "Added the [knownIssueHistoryItem](https://learn.microsoft.com/en-us/graph/api/resources/knownIssueHistoryItemt?view=graph-rest-beta) resource type.", + "Description": "Added the [knownIssueHistoryItem](https://learn.microsoft.com/en-us/graph/api/resources/windowsupdates-knownissuehistoryitem?view=graph-rest-beta) resource type.", "Target": "knownIssueHistoryItem" + }, + { + "Id": "a6639056-8a1d-4d07-8dc0-75fefd3a6006", + "ApiChange": "Resource", + "ChangedApiName": "itemBody", + "ChangeType": "Addition", + "Description": "Added the [itemBody](https://learn.microsoft.com/en-us/graph/api/resources/windowsupdates-itembody?view=graph-rest-beta) resource type.", + "Target": "itemBody" } ], - "Id": " ", + "Id": "a6639056-8a1d-4d07-8dc0-75fefd3a6006", "Cloud": "Prod", "Version": "beta", - "CreatedDateTime": " ", + "CreatedDateTime": "2024-03-08T00:00:00Z", "WorkloadArea": "Device and app management", "SubArea": "Device updates" } From d2304f5fc6f3312d27afa482dab5e3697ff8d668 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Sun, 10 Mar 2024 17:42:06 -0700 Subject: [PATCH 059/139] Update windowsupdates-itemBody.md --- api-reference/beta/resources/windowsupdates-itemBody.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/api-reference/beta/resources/windowsupdates-itemBody.md b/api-reference/beta/resources/windowsupdates-itemBody.md index d914318cbec..4f7b0f2bc3b 100644 --- a/api-reference/beta/resources/windowsupdates-itemBody.md +++ b/api-reference/beta/resources/windowsupdates-itemBody.md @@ -1,6 +1,6 @@ --- title: "itemBody resource type" -description: "Represents properties of the body of an item, such as a message, event or group post." +description: "Represents properties of the body of an item, such as a message, event, or group post." ms.localizationpriority: medium author: "skandula" ms.service: "windows-10" @@ -19,7 +19,7 @@ Represents a container for holding content and its type. | Property | Type |Description| |:---------------|:--------|:----------| |content|String|The content of the item.| -|contentType|bodyType|The type of the contentindicated by enum value of bodyType| +|contentType|bodyType|The type of the content indicated by enum value of bodyType.| ## Relationships @@ -27,7 +27,8 @@ None. ## JSON representation -Here is a JSON representation of the resource +Here is a JSON representation of the resource. + ``` json { - "@odata.type": "#microsoft.graph.windowsUpdates.itembody", - "content": "string", - "contentType": "string" + "@odata.type": "#microsoft.graph.windowsUpdates.itemBody", + "content": "String", + "contentType": "String" } ``` From da309ceeccb2af770e9ac489d5a132d2aa22ad9e Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Mon, 11 Mar 2024 07:10:47 +0100 Subject: [PATCH 064/139] Update and rename windowsupdates-find-by-CatalogId.md to windowsupdates-product-findbycatalogid.md Edit. --- .../api/windowsupdates-find-by-CatalogId.md | 161 ------------------ .../windowsupdates-product-findbycatalogid.md | 158 +++++++++++++++++ 2 files changed, 158 insertions(+), 161 deletions(-) delete mode 100644 api-reference/beta/api/windowsupdates-find-by-CatalogId.md create mode 100644 api-reference/beta/api/windowsupdates-product-findbycatalogid.md diff --git a/api-reference/beta/api/windowsupdates-find-by-CatalogId.md b/api-reference/beta/api/windowsupdates-find-by-CatalogId.md deleted file mode 100644 index e1fe8309ee2..00000000000 --- a/api-reference/beta/api/windowsupdates-find-by-CatalogId.md +++ /dev/null @@ -1,161 +0,0 @@ ---- -title: "Find by Catalog ID" -description: "This function fnds the product revisions associated with the catalog ID and also finds the known Issues directly or indirectly related to the catalog id." -author: "skandula" -ms.localizationpriority: medium -ms.service: "windows-10" -doc_type: apiPageType ---- - -# Find by Catalog ID - -Namespace: microsoft.graph.windowsUpdates - -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] - -Get a list of known Issues related to a particular product based on timeframe in the past. - -[!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/windowsupdates-catalog-list-entries-permissions.md)] - -[!INCLUDE [rbac-windows-updates-apis](../includes/rbac-for-apis/rbac-windows-updates-apis.md)] - - -## HTTP request - - -``` http -GET /admin/windows/updates/products/FindByCatalogId(catalogID='catalogID') -``` - -## Query Parameters -In the request URL, provide the following query parameters with values. -The following table shows the parameters that must be used with this function. - -|Parameter|Type|Description| -|:---|:---|:---| -|catalogID|string| The catalog identifier from the catalog entry.| - - -## 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 this information in a collection of type [product](../resources/windowsupdates-product.md) in the response body. - -## Examples - -### Request -The following is an example of a request. - -# [HTTP](#tab/http) - -``` http -GET /admin/windows/updates/products/FindByCatalogId(catalogID= '10cb1ba292c5586e22c9991be3f12fbd39f2ebf231cb5d201c67f42fbaccc567')?expand=revisions($expand=catalogEntry,knowledgeBaseArticle),knownIssues($expand=originatingKnowledgeBaseArticle,resolvingKnowledgeBaseArticle) - -``` - -### Response -The following example shows the response. - ->**Note:** The response object shown here might be shortened for readability. -> - -``` http - -{ - "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.windowsUpdates.product)", - "value": [ - { - "id": "1", - "name": "Windows 11, version 22H2", - "groupName": "Windows 11", - "friendlyNames": [ - "Version 22H2 (OS build 22621)" - ], - "revisions": [ - { - "id": "10.0.22621.2215", - "displayName": "Windows 11, version 22H2, build 22621.2215", - "releaseDateTime": "2023-08-22T00:00:00Z", - "version": "22H2", - "osBuild": { - "BuildNumber": 22621, - "MajorVersion": 10, - "MinorVersion": 0, - "UpdateBuildRevision": 2215 - }, - "catalogEntry": { - "@odata.type": "#microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry", - "deployableUntilDateTime": null, - "displayName": "08/22/2023 - 2023.08 D Update for Windows 10 and later", - "id": "10cb1ba292c5586e22c9991be3f12fbd39f2ebf231cb5d201c67f42fbaccc567", - "releaseDateTime": "2023-08-22T00:00:00Z", - "catalogName": "2023-08 Cumulative Update Preview for Windows 10 and later", - "isExpeditable": true, - "qualityUpdateCadence": "Monthly", - "qualityUpdateClassification": "NonSecurity", - "shortName": "2023.08 D", - "cveSeverityInformation": null - }, - "knowledgeBaseArticle": { - "Url": "https://support.microsoft.com/help/5029351", - "Id": "KB5029351" - } - } - ], - "knownIssues": [ - { - "id": "WI670072", - "status": "mitigatedExternal", - "webViewUrl": "https://admin.microsoft.com/Adminportal/Home#/windowsreleasehealth/knownissues/:/issue/WI670072", - "description": "Investigation concluded that the error reported by users was not caused by the August 2023 preview updates.", - "startDateTime": "2023-08-22T10:00:00-07:00", - "title": "Microsoft received reports about an “UNSUPPORTED_PROCESSOR” error", - "resolvedDateTime": "2023-09-07T16:14:07.1881817-07:00", - "lastUpdatedDateTime": "2023-09-07T16:41:58.577-07:00", - "originatingKnowledgeBaseArticle": { - "Url": "https://support.microsoft.com/help/5029351", - "Id": "KB5029351" - }, - "resolvingKnowledgeBaseArticle": null, - "safeguardHoldIds": [], - "knownIssueHistories": [ - { - "createdDateTime": "2023-08-24T02:51:27.29Z", - "body": { - "content": "Microsoft has received reports of an issue in which users are receiving an “UNSUPPORTED_PROCESSOR” error message on a blue screen after installing updates released on August 22, 2023 (KB5029351 (https://support.microsoft.com/help/5029351)) and then restarting their device. KB5029351 (https://support.microsoft.com/help/5029351) might automatically uninstall to allow Windows to start up as expected. KB5029351 (https://support.microsoft.com/help/5029351) might not offer to some Windows devices which might be affected by this issue.\n\nIf you are experiencing issues, please use Feedback Hub to file a report following the below steps:\n 1. Launch Feedback Hub by opening the Start menu and typing \"Feedback hub\", or pressing the Windows key + F\n 2. Fill in the \"Summarize your feedback\" and \"Explain in more detail\" boxes, then click Next.\n 3. Under the \"Choose a category\" section, click the \"Problem\" button, and select \"Install and Update\" category. Then select \"Downloading, installing, and configuring Windows Update” subcategory. Click Next.\n 4. Under the \"Find similar feedback\" section, select the \"Make new bug\" radio button and click Next.\n 5. Under the \"Add more details\" section, supply any relevant detail (Note this is not critical to addressing your issue).\n 6. Expand the \"Recreate my problem\" box and press \"Start recording\". Reproduce the issue on your device.\n 7. Press \"Stop recording\" once finished. Click the \"Submit\" button.\nFor additional information, see Send feedback to Microsoft with the Feedback Hub app (https://support.microsoft.com/windows/send-feedback-to-microsoft-with-the-feedback-hub-app-f59187f8-8739-22d6-ba93-f66612949332).\n\nNext steps: We are presently investigating to determine if this is an issue caused by Microsoft. We will provide an update when more information is available.\n\nAffected platforms:\n - Client: Windows 11, version 22H2; Windows 10, version 22H2; Windows 11, version 21H2\n - Server: None\n", - "contentType": "html" - } - }... - ] - }... - ] - }... - ] -} - -``` diff --git a/api-reference/beta/api/windowsupdates-product-findbycatalogid.md b/api-reference/beta/api/windowsupdates-product-findbycatalogid.md new file mode 100644 index 00000000000..aeba04de86a --- /dev/null +++ b/api-reference/beta/api/windowsupdates-product-findbycatalogid.md @@ -0,0 +1,158 @@ +--- +title: "product: findByCatalogId" +description: "Find the product revisions associated with a catalog ID and the known issues directly or indirectly related to the catalog ID." +author: "skandula" +ms.localizationpriority: medium +ms.service: "windows-10" +doc_type: apiPageType +--- + +# product: findByCatalogId + +Namespace: microsoft.graph.windowsUpdates + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Find the product revisions associated with a catalog ID and the known issues directly or indirectly related to the catalog ID. + +## 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/windowsupdates-catalog-list-entries-permissions.md)] + +[!INCLUDE [rbac-windows-updates-apis](../includes/rbac-for-apis/rbac-windows-updates-apis.md)] + + +## HTTP request + + +``` http +GET /admin/windows/updates/products/FindByCatalogId(catalogID='catalogID') +``` + +## Query parameters + +In the request URL, provide the following query parameters with values. +The following table shows the parameter that must be used with this function. + +|Parameter|Type|Description| +|:---|:---|:---| +|catalogID|string|The catalog identifier from the catalog entry.| + + +## 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 [microsoft.graph.windowsUpdates.product](../resources/windowsupdates-product.md) objects in the response body. + +## Examples + +### Request +The following example shows a request. + + +``` http +GET https://graph.microsoft.com/beta/admin/windows/updates/products/FindByCatalogId(catalogID= '10cb1ba292c5586e22c9991be3f12fbd39f2ebf231cb5d201c67f42fbaccc567')?expand=revisions($expand=catalogEntry,knowledgeBaseArticle),knownIssues($expand=originatingKnowledgeBaseArticle,resolvingKnowledgeBaseArticle) +``` + +### Response +The following example shows the response. + +>**Note:** The response object shown here might be shortened for readability. + + +``` http + +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.windowsUpdates.product)", + "value": [ + { + "id": "1", + "name": "Windows 11, version 22H2", + "groupName": "Windows 11", + "friendlyNames": [ + "Version 22H2 (OS build 22621)" + ], + "revisions": [ + { + "id": "10.0.22621.2215", + "displayName": "Windows 11, version 22H2, build 22621.2215", + "releaseDateTime": "2023-08-22T00:00:00Z", + "version": "22H2", + "osBuild": { + "BuildNumber": 22621, + "MajorVersion": 10, + "MinorVersion": 0, + "UpdateBuildRevision": 2215 + }, + "catalogEntry": { + "@odata.type": "#microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry", + "deployableUntilDateTime": null, + "displayName": "08/22/2023 - 2023.08 D Update for Windows 10 and later", + "id": "10cb1ba292c5586e22c9991be3f12fbd39f2ebf231cb5d201c67f42fbaccc567", + "releaseDateTime": "2023-08-22T00:00:00Z", + "catalogName": "2023-08 Cumulative Update Preview for Windows 10 and later", + "isExpeditable": true, + "qualityUpdateCadence": "Monthly", + "qualityUpdateClassification": "NonSecurity", + "shortName": "2023.08 D", + "cveSeverityInformation": null + }, + "knowledgeBaseArticle": { + "Url": "https://support.microsoft.com/help/5029351", + "Id": "KB5029351" + } + } + ], + "knownIssues": [ + { + "id": "WI670072", + "status": "mitigatedExternal", + "webViewUrl": "https://admin.microsoft.com/Adminportal/Home#/windowsreleasehealth/knownissues/:/issue/WI670072", + "description": "Investigation concluded that the error reported by users was not caused by the August 2023 preview updates.", + "startDateTime": "2023-08-22T10:00:00-07:00", + "title": "Microsoft received reports about an “UNSUPPORTED_PROCESSOR” error", + "resolvedDateTime": "2023-09-07T16:14:07.1881817-07:00", + "lastUpdatedDateTime": "2023-09-07T16:41:58.577-07:00", + "originatingKnowledgeBaseArticle": { + "Url": "https://support.microsoft.com/help/5029351", + "Id": "KB5029351" + }, + "resolvingKnowledgeBaseArticle": null, + "safeguardHoldIds": [], + "knownIssueHistories": [ + { + "createdDateTime": "2023-08-24T02:51:27.29Z", + "body": { + "content": "Microsoft has received reports of an issue in which users are receiving an “UNSUPPORTED_PROCESSOR” error message on a blue screen after installing updates released on August 22, 2023 (KB5029351 (https://support.microsoft.com/help/5029351)) and then restarting their device. KB5029351 (https://support.microsoft.com/help/5029351) might automatically uninstall to allow Windows to start up as expected. KB5029351 (https://support.microsoft.com/help/5029351) might not offer to some Windows devices which might be affected by this issue.\n\nIf you are experiencing issues, please use Feedback Hub to file a report following the below steps:\n 1. Launch Feedback Hub by opening the Start menu and typing \"Feedback hub\", or pressing the Windows key + F\n 2. Fill in the \"Summarize your feedback\" and \"Explain in more detail\" boxes, then click Next.\n 3. Under the \"Choose a category\" section, click the \"Problem\" button, and select \"Install and Update\" category. Then select \"Downloading, installing, and configuring Windows Update” subcategory. Click Next.\n 4. Under the \"Find similar feedback\" section, select the \"Make new bug\" radio button and click Next.\n 5. Under the \"Add more details\" section, supply any relevant detail (Note this is not critical to addressing your issue).\n 6. Expand the \"Recreate my problem\" box and press \"Start recording\". Reproduce the issue on your device.\n 7. Press \"Stop recording\" once finished. Click the \"Submit\" button.\nFor additional information, see Send feedback to Microsoft with the Feedback Hub app (https://support.microsoft.com/windows/send-feedback-to-microsoft-with-the-feedback-hub-app-f59187f8-8739-22d6-ba93-f66612949332).\n\nNext steps: We are presently investigating to determine if this is an issue caused by Microsoft. We will provide an update when more information is available.\n\nAffected platforms:\n - Client: Windows 11, version 22H2; Windows 10, version 22H2; Windows 11, version 21H2\n - Server: None\n", + "contentType": "html" + } + } + ] + } + ] + } + ] +} +``` From b3a5ff027bd18f1756e46242f91c2f99b6423772 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Mon, 11 Mar 2024 07:19:39 +0100 Subject: [PATCH 065/139] Update and rename windowsupdates-get-knownIssues-time-range.md to windowsupdates-product-getknownissuesbytimerange.md Edit. --- ...ndowsupdates-get-knownIssues-time-range.md | 118 ----------------- ...dates-product-getknownissuesbytimerange.md | 120 ++++++++++++++++++ 2 files changed, 120 insertions(+), 118 deletions(-) delete mode 100644 api-reference/beta/api/windowsupdates-get-knownIssues-time-range.md create mode 100644 api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md diff --git a/api-reference/beta/api/windowsupdates-get-knownIssues-time-range.md b/api-reference/beta/api/windowsupdates-get-knownIssues-time-range.md deleted file mode 100644 index 3c3ece1a21c..00000000000 --- a/api-reference/beta/api/windowsupdates-get-knownIssues-time-range.md +++ /dev/null @@ -1,118 +0,0 @@ ---- -title: "Get Known Issues by Time Range" -description: "This function gets the known Issues related to a particular product based on timeframe in the past." -author: "skandula" -ms.localizationpriority: medium -ms.service: "windows-10" -doc_type: apiPageType ---- - -# Get Known Issues by Time Range - -Namespace: microsoft.graph.windowsUpdates - -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] - -Get a list of known Issues related to a particular product based on timeframe in the past. - -[!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/windowsupdates-catalog-list-entries-permissions.md)] - -[!INCLUDE [rbac-windows-updates-apis](../includes/rbac-for-apis/rbac-windows-updates-apis.md)] - - -## HTTP request - - -``` http -GET /admin/windows/updates/products({id})/GetKnownIssuesByTimeRange(daysInPast={daysInPast},includeAllActive={includeAllActive}) -``` - -## Query Parameters -In the request URL, provide the following query parameters with values. -The following table shows the parameters that must be used with this function. - -|Parameter|Type|Description| -|:---|:---|:---| -|daysInPast|Int32|This parameter represents the number of days to look up in the past. This filter is applied on all known issues that are in final status and have a resolved date time.| -|includeAllActive|Boolean|If this parameter is set to true or null, the response includes all active known Issues. If the parameter is set to false, the response does not include have any active known Issues.| - -## 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 list of [known Issues](../resources/windowsupdates-knownissues.md) per the given time range in the response body. - -## Examples - -### Request -The following is an example of a request. - -# [HTTP](#tab/http) - -``` http -GET /admin/windows/updates/products('1')/GetKnownIssuesByTimeRange(daysInPast=70,includeAllActive=false) -``` - -### Response -The following example shows the response. - ->**Note:** The response object shown here might be shortened for readability. -> - -``` http - -{ - "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.windowsUpdates.knownIssue)", - "value": [ - { - "id": "WI670072", - "status": "mitigatedExternal", - "webViewUrl": "https://admin.microsoft.com/Adminportal/Home#/windowsreleasehealth/knownissues/:/issue/WI670072", - "description": "Investigation concluded that the error reported by users was not caused by the August 2023 preview updates.", - "startDateTime": "2023-08-22T10:00:00-07:00", - "title": "Microsoft received reports about an “UNSUPPORTED_PROCESSOR” error", - "resolvedDateTime": "2023-09-07T16:14:07.1881817-07:00", - "lastUpdatedDateTime": "2023-09-07T16:41:58.577-07:00", - "originatingKnowledgeBaseArticle": { - "Url": "https://support.microsoft.com/help/5029351", - "Id": "KB5029351" - }, - "resolvingKnowledgeBaseArticle": null, - "safeguardHoldIds": [], - "knownIssueHistories": [ - { - "createdDateTime": "2023-08-24T02:51:27.29Z", - "body": { - "content": "Microsoft has received reports of an issue in which users are receiving an “UNSUPPORTED_PROCESSOR” error message on a blue screen after installing updates released on August 22, 2023 (KB5029351 (https://support.microsoft.com/help/5029351)) and then restarting their device. KB5029351 (https://support.microsoft.com/help/5029351) might automatically uninstall to allow Windows to start up as expected. KB5029351 (https://support.microsoft.com/help/5029351) might not offer to some Windows devices which might be affected by this issue.\n\nIf you are experiencing issues, please use Feedback Hub to file a report following the below steps:\n 1. Launch Feedback Hub by opening the Start menu and typing \"Feedback hub\", or pressing the Windows key + F\n 2. Fill in the \"Summarize your feedback\" and \"Explain in more detail\" boxes, then click Next.\n 3. Under the \"Choose a category\" section, click the \"Problem\" button, and select \"Install and Update\" category. Then select \"Downloading, installing, and configuring Windows Update” subcategory. Click Next.\n 4. Under the \"Find similar feedback\" section, select the \"Make new bug\" radio button and click Next.\n 5. Under the \"Add more details\" section, supply any relevant detail (Note this is not critical to addressing your issue).\n 6. Expand the \"Recreate my problem\" box and press \"Start recording\". Reproduce the issue on your device.\n 7. Press \"Stop recording\" once finished. Click the \"Submit\" button.\nFor additional information, see Send feedback to Microsoft with the Feedback Hub app (https://support.microsoft.com/windows/send-feedback-to-microsoft-with-the-feedback-hub-app-f59187f8-8739-22d6-ba93-f66612949332).\n\nNext steps: We are presently investigating to determine if this is an issue caused by Microsoft. We will provide an update when more information is available.\n\nAffected platforms:\n - Client: Windows 11, version 22H2; Windows 10, version 22H2; Windows 11, version 21H2\n - Server: None\n", - "contentType": "html" - } - } - ] - } - ] -} -``` diff --git a/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md b/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md new file mode 100644 index 00000000000..8a976fec41f --- /dev/null +++ b/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md @@ -0,0 +1,120 @@ +--- +title: "product: getKnownIssuesByTimeRange" +description: "Get known issues related to a particular product based on a specified timeframe in the past." +author: "skandula" +ms.localizationpriority: medium +ms.service: "windows-10" +doc_type: apiPageType +--- + +# product: getKnownIssuesByTimeRange + +Namespace: microsoft.graph.windowsUpdates + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Get known issues related to a particular product based on a specified timeframe in the past. + +## 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/windowsupdates-catalog-list-entries-permissions.md)] + +[!INCLUDE [rbac-windows-updates-apis](../includes/rbac-for-apis/rbac-windows-updates-apis.md)] + + +## HTTP request + + +``` http +GET /admin/windows/updates/products({id})/GetKnownIssuesByTimeRange(daysInPast={daysInPast},includeAllActive={includeAllActive}) +``` + +## Query parameters + +In the request URL, provide the following query parameters with values. +The following table shows the parameters that must be used with this function. + +|Parameter|Type|Description| +|:---|:---|:---| +|daysInPast|Int32|The number of days to look up in the past. This filter is applied on all known issues that are in final status and have a resolved date time.| +|includeAllActive|Boolean|If set to `true` or `null`, the response includes all active known issues; otherwise, the response doesn't include any active known issues.| + +## 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 [microsoft.graph.windowsUpdates.knownIssue](../resources/windowsupdates-knownissues.md) objects for the given time range in the response body. + +## Examples + +### Request + +The following example shows a request. + + +``` http +GET https://graph.microsoft.com/beta/admin/windows/updates/products('1')/GetKnownIssuesByTimeRange(daysInPast=70,includeAllActive=false) +``` + +### Response + +The following example shows the response. + +>**Note:** The response object shown here might be shortened for readability. + + +``` http + +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.windowsUpdates.knownIssue)", + "value": [ + { + "id": "WI670072", + "status": "mitigatedExternal", + "webViewUrl": "https://admin.microsoft.com/Adminportal/Home#/windowsreleasehealth/knownissues/:/issue/WI670072", + "description": "Investigation concluded that the error reported by users was not caused by the August 2023 preview updates.", + "startDateTime": "2023-08-22T10:00:00-07:00", + "title": "Microsoft received reports about an “UNSUPPORTED_PROCESSOR” error", + "resolvedDateTime": "2023-09-07T16:14:07.1881817-07:00", + "lastUpdatedDateTime": "2023-09-07T16:41:58.577-07:00", + "originatingKnowledgeBaseArticle": { + "Url": "https://support.microsoft.com/help/5029351", + "Id": "KB5029351" + }, + "resolvingKnowledgeBaseArticle": null, + "safeguardHoldIds": [], + "knownIssueHistories": [ + { + "createdDateTime": "2023-08-24T02:51:27.29Z", + "body": { + "content": "Microsoft has received reports of an issue in which users are receiving an “UNSUPPORTED_PROCESSOR” error message on a blue screen after installing updates released on August 22, 2023 (KB5029351 (https://support.microsoft.com/help/5029351)) and then restarting their device. KB5029351 (https://support.microsoft.com/help/5029351) might automatically uninstall to allow Windows to start up as expected. KB5029351 (https://support.microsoft.com/help/5029351) might not offer to some Windows devices which might be affected by this issue.\n\nIf you are experiencing issues, please use Feedback Hub to file a report following the below steps:\n 1. Launch Feedback Hub by opening the Start menu and typing \"Feedback hub\", or pressing the Windows key + F\n 2. Fill in the \"Summarize your feedback\" and \"Explain in more detail\" boxes, then click Next.\n 3. Under the \"Choose a category\" section, click the \"Problem\" button, and select \"Install and Update\" category. Then select \"Downloading, installing, and configuring Windows Update” subcategory. Click Next.\n 4. Under the \"Find similar feedback\" section, select the \"Make new bug\" radio button and click Next.\n 5. Under the \"Add more details\" section, supply any relevant detail (Note this is not critical to addressing your issue).\n 6. Expand the \"Recreate my problem\" box and press \"Start recording\". Reproduce the issue on your device.\n 7. Press \"Stop recording\" once finished. Click the \"Submit\" button.\nFor additional information, see Send feedback to Microsoft with the Feedback Hub app (https://support.microsoft.com/windows/send-feedback-to-microsoft-with-the-feedback-hub-app-f59187f8-8739-22d6-ba93-f66612949332).\n\nNext steps: We are presently investigating to determine if this is an issue caused by Microsoft. We will provide an update when more information is available.\n\nAffected platforms:\n - Client: Windows 11, version 22H2; Windows 10, version 22H2; Windows 11, version 21H2\n - Server: None\n", + "contentType": "html" + } + } + ] + } + ] +} +``` From 53c29dd1a24bbe492eb2c759ef90df4d7b151ea8 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Mon, 11 Mar 2024 07:24:01 +0100 Subject: [PATCH 066/139] Update and rename windowsupdates-find-by-KbNumber.md to windowsupdates-product-findbykbnumber.md Edit. --- .../api/windowsupdates-find-by-KbNumber.md | 161 ------------------ .../windowsupdates-product-findbykbnumber.md | 159 +++++++++++++++++ 2 files changed, 159 insertions(+), 161 deletions(-) delete mode 100644 api-reference/beta/api/windowsupdates-find-by-KbNumber.md create mode 100644 api-reference/beta/api/windowsupdates-product-findbykbnumber.md diff --git a/api-reference/beta/api/windowsupdates-find-by-KbNumber.md b/api-reference/beta/api/windowsupdates-find-by-KbNumber.md deleted file mode 100644 index 08916cd7f27..00000000000 --- a/api-reference/beta/api/windowsupdates-find-by-KbNumber.md +++ /dev/null @@ -1,161 +0,0 @@ ---- -title: "Find Product information by KbNumber" -description: "Finds the product revisions associated with the kbNumber and also finds the known issues directly or indirectly related to the kbNumber." -author: "skandula" -ms.localizationpriority: medium -ms.service: "windows-10" -doc_type: apiPageType ---- - -# Find Product information by KbNumber - -Namespace: microsoft.graph.windowsUpdates - -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] - -This function finds the product revisions associated with the kbNumber and also finds the known issues directly or indirectly related to the kbNumber, and returns this information in a collection of type [windows.graph.windowsUpdates.product](../includes/permissions/windowsupdates-product.md) to provide complete context. - - -[!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/windowsupdates-catalog-list-entries-permissions.md)] - -[!INCLUDE [rbac-windows-updates-apis](../includes/rbac-for-apis/rbac-windows-updates-apis.md)] - - -## HTTP request - - -``` http -GET /admin/windows/updates/products/FindByKbNumber(kbNumber={kbNumber}) - -``` - -## Query Parameters -In the request URL, provide the following query parameters with values. -The following table shows the parameters that must be used with this function. - -|Parameter|Type|Description| -|:---|:---|:---| -|kbNumber|Int32|Knowledge base article number.| - -## 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 returns this information in a collection of type [windows.graph.windowsUpdates.product](../includes/permissions/windowsupdates-product.md). - -## Examples - -### Request -The following is an example of a request. - -# [HTTP](#tab/http) - -``` http -GET /admin/windows/updates/products/FindByKbNumber(kbNumber=5029332)?expand=revisions($expand=catalogEntry,knowledgeBaseArticle),knownIssues -``` - -### Response -The following example shows the response. - ->**Note:** The response object shown here might be shortened for readability. -> - -``` http -{ - "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.windowsUpdates.product)", - "value": [ - { - "id": "1", - "name": "Windows 11, version 21H2", - "groupName": "Windows 11", - "friendlyNames": [ - "Version 21H2 (OS build 22000)" - ], - "revisions": [ - { - "id": "10.0.22000.2360", - "displayName": "Windows 11, version 21H2, build 22000.2360", - "releaseDateTime": "2023-08-22T00:00:00Z", - "version": "21H2", - "osBuild": { - "BuildNumber": 22000, - "MajorVersion": 10, - "MinorVersion": 0, - "UpdateBuildRevision": 2360 - }, - "catalogEntry": { - "@odata.type": "#microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry", - "deployableUntilDateTime": null, - "displayName": "08/22/2023 - 2023.08 D Update for Windows 10 and later", - "id": "10cb1ba292c5586e22c9991be3f12fbd39f2ebf231cb5d201c67f42fbaccc567", - "releaseDateTime": "2023-08-22T00:00:00Z", - "catalogName": "2023-08 Cumulative Update Preview for Windows 10 and later", - "isExpeditable": true, - "qualityUpdateCadence": "Monthly", - "qualityUpdateClassification": "NonSecurity", - "shortName": "2023.08 D", - "cveSeverityInformation": null - }, - "knowledgeBaseArticle": { - "Url": "https://support.microsoft.com/help/5029332", - "Id": "KB5029332" - } - } - ], - "knownIssues": [ - { - "id": "WI670073", - "status": "mitigatedExternal", - "webViewUrl": "https://admin.microsoft.com/Adminportal/Home#/windowsreleasehealth/knownissues/:/issue/WI670073", - "description": "Investigation concluded that the error reported by users was not caused by the August 2023 preview updates.", - "startDateTime": "2023-08-22T10:00:00-07:00", - "title": "Microsoft received reports about an “UNSUPPORTED_PROCESSOR” error", - "resolvedDateTime": "2023-09-07T16:14:07.1881817-07:00", - "lastUpdatedDateTime": "2023-09-07T16:41:58.577-07:00", - "originatingKnowledgeBaseArticle": { - "Url": "https://support.microsoft.com/help/5029332", - "Id": "KB5029332" - }, - "resolvingKnowledgeBaseArticle": null, - "safeguardHoldIds": [], - "knownIssueHistories": [ - { - "createdDateTime": "2023-08-24T02:51:27.29Z", - "body": { - "content": "Microsoft has received reports of an issue in which users are receiving an “UNSUPPORTED_PROCESSOR” error message on a blue screen after installing updates released on August 22, 2023 (KB5029351 (https://support.microsoft.com/help/5029351)) and then restarting their device. KB5029351 (https://support.microsoft.com/help/5029351) might automatically uninstall to allow Windows to start up as expected. KB5029351 (https://support.microsoft.com/help/5029351) might not offer to some Windows devices which might be affected by this issue.\n\nIf you are experiencing issues, please use Feedback Hub to file a report following the below steps:\n 1. Launch Feedback Hub by opening the Start menu and typing \"Feedback hub\", or pressing the Windows key + F\n 2. Fill in the \"Summarize your feedback\" and \"Explain in more detail\" boxes, then click Next.\n 3. Under the \"Choose a category\" section, click the \"Problem\" button, and select \"Install and Update\" category. Then select \"Downloading, installing, and configuring Windows Update” subcategory. Click Next.\n 4. Under the \"Find similar feedback\" section, select the \"Make new bug\" radio button and click Next.\n 5. Under the \"Add more details\" section, supply any relevant detail (Note this is not critical to addressing your issue).\n 6. Expand the \"Recreate my problem\" box and press \"Start recording\". Reproduce the issue on your device.\n 7. Press \"Stop recording\" once finished. Click the \"Submit\" button.\nFor additional information, see Send feedback to Microsoft with the Feedback Hub app (https://support.microsoft.com/windows/send-feedback-to-microsoft-with-the-feedback-hub-app-f59187f8-8739-22d6-ba93-f66612949332).\n\nNext steps: We are presently investigating to determine if this is an issue caused by Microsoft. We will provide an update when more information is available.\n\nAffected platforms:\n - Client: Windows 11, version 22H2; Windows 10, version 22H2; Windows 11, version 21H2\n - Server: None\n", - "contentType": "html" - } - } - ] - } - ] - } - ] -} - - -``` diff --git a/api-reference/beta/api/windowsupdates-product-findbykbnumber.md b/api-reference/beta/api/windowsupdates-product-findbykbnumber.md new file mode 100644 index 00000000000..b3b52731adb --- /dev/null +++ b/api-reference/beta/api/windowsupdates-product-findbykbnumber.md @@ -0,0 +1,159 @@ +--- +title: "product: findByKbNumber" +description: "Find the product revisions associated with a knowledge base number and the known issues directly or indirectly related to the knowledge base number." +author: "skandula" +ms.localizationpriority: medium +ms.service: "windows-10" +doc_type: apiPageType +--- + +# product: findByKbNumber + +Namespace: microsoft.graph.windowsUpdates + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Find the product revisions associated with a knowledge base number and the known issues directly or indirectly related to the knowledge base number. + +## 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/windowsupdates-catalog-list-entries-permissions.md)] + +[!INCLUDE [rbac-windows-updates-apis](../includes/rbac-for-apis/rbac-windows-updates-apis.md)] + + +## HTTP request + + +``` http +GET /admin/windows/updates/products/FindByKbNumber(kbNumber={kbNumber}) +``` + +## Query parameters + +In the request URL, provide the following query parameters with values. +The following table shows the parameter that must be used with this function. + +|Parameter|Type|Description| +|:---|:---|:---| +|kbNumber|Int32|Knowledge base article number.| + +## 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 collection of [windows.graph.windowsUpdates.product](../includes/permissions/windowsupdates-product.md) objects in the response body. + +## Examples + +### Request + +The following example shows a request. + + +``` http +GET /admin/windows/updates/products/FindByKbNumber(kbNumber=5029332)?expand=revisions($expand=catalogEntry,knowledgeBaseArticle),knownIssues +``` + +### Response + +The following example shows the response. + +>**Note:** The response object shown here might be shortened for readability. + + +``` http +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.windowsUpdates.product)", + "value": [ + { + "id": "1", + "name": "Windows 11, version 21H2", + "groupName": "Windows 11", + "friendlyNames": [ + "Version 21H2 (OS build 22000)" + ], + "revisions": [ + { + "id": "10.0.22000.2360", + "displayName": "Windows 11, version 21H2, build 22000.2360", + "releaseDateTime": "2023-08-22T00:00:00Z", + "version": "21H2", + "osBuild": { + "BuildNumber": 22000, + "MajorVersion": 10, + "MinorVersion": 0, + "UpdateBuildRevision": 2360 + }, + "catalogEntry": { + "@odata.type": "#microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry", + "deployableUntilDateTime": null, + "displayName": "08/22/2023 - 2023.08 D Update for Windows 10 and later", + "id": "10cb1ba292c5586e22c9991be3f12fbd39f2ebf231cb5d201c67f42fbaccc567", + "releaseDateTime": "2023-08-22T00:00:00Z", + "catalogName": "2023-08 Cumulative Update Preview for Windows 10 and later", + "isExpeditable": true, + "qualityUpdateCadence": "Monthly", + "qualityUpdateClassification": "NonSecurity", + "shortName": "2023.08 D", + "cveSeverityInformation": null + }, + "knowledgeBaseArticle": { + "Url": "https://support.microsoft.com/help/5029332", + "Id": "KB5029332" + } + } + ], + "knownIssues": [ + { + "id": "WI670073", + "status": "mitigatedExternal", + "webViewUrl": "https://admin.microsoft.com/Adminportal/Home#/windowsreleasehealth/knownissues/:/issue/WI670073", + "description": "Investigation concluded that the error reported by users was not caused by the August 2023 preview updates.", + "startDateTime": "2023-08-22T10:00:00-07:00", + "title": "Microsoft received reports about an “UNSUPPORTED_PROCESSOR” error", + "resolvedDateTime": "2023-09-07T16:14:07.1881817-07:00", + "lastUpdatedDateTime": "2023-09-07T16:41:58.577-07:00", + "originatingKnowledgeBaseArticle": { + "Url": "https://support.microsoft.com/help/5029332", + "Id": "KB5029332" + }, + "resolvingKnowledgeBaseArticle": null, + "safeguardHoldIds": [], + "knownIssueHistories": [ + { + "createdDateTime": "2023-08-24T02:51:27.29Z", + "body": { + "content": "Microsoft has received reports of an issue in which users are receiving an “UNSUPPORTED_PROCESSOR” error message on a blue screen after installing updates released on August 22, 2023 (KB5029351 (https://support.microsoft.com/help/5029351)) and then restarting their device. KB5029351 (https://support.microsoft.com/help/5029351) might automatically uninstall to allow Windows to start up as expected. KB5029351 (https://support.microsoft.com/help/5029351) might not offer to some Windows devices which might be affected by this issue.\n\nIf you are experiencing issues, please use Feedback Hub to file a report following the below steps:\n 1. Launch Feedback Hub by opening the Start menu and typing \"Feedback hub\", or pressing the Windows key + F\n 2. Fill in the \"Summarize your feedback\" and \"Explain in more detail\" boxes, then click Next.\n 3. Under the \"Choose a category\" section, click the \"Problem\" button, and select \"Install and Update\" category. Then select \"Downloading, installing, and configuring Windows Update” subcategory. Click Next.\n 4. Under the \"Find similar feedback\" section, select the \"Make new bug\" radio button and click Next.\n 5. Under the \"Add more details\" section, supply any relevant detail (Note this is not critical to addressing your issue).\n 6. Expand the \"Recreate my problem\" box and press \"Start recording\". Reproduce the issue on your device.\n 7. Press \"Stop recording\" once finished. Click the \"Submit\" button.\nFor additional information, see Send feedback to Microsoft with the Feedback Hub app (https://support.microsoft.com/windows/send-feedback-to-microsoft-with-the-feedback-hub-app-f59187f8-8739-22d6-ba93-f66612949332).\n\nNext steps: We are presently investigating to determine if this is an issue caused by Microsoft. We will provide an update when more information is available.\n\nAffected platforms:\n - Client: Windows 11, version 22H2; Windows 10, version 22H2; Windows 11, version 21H2\n - Server: None\n", + "contentType": "html" + } + } + ] + } + ] + } + ] +} +``` From a75b3a367563a2a9ff79f170c75e3f381bee1f02 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Mon, 11 Mar 2024 07:27:59 +0100 Subject: [PATCH 067/139] Update Microsoft.WindowsUpdates.json Edit. --- changelog/Microsoft.WindowsUpdates.json | 36 ++++++++++++------------- 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/changelog/Microsoft.WindowsUpdates.json b/changelog/Microsoft.WindowsUpdates.json index 80bd721ca1c..79f914d7445 100644 --- a/changelog/Microsoft.WindowsUpdates.json +++ b/changelog/Microsoft.WindowsUpdates.json @@ -1072,37 +1072,29 @@ }, { "ChangeList": [ - { - "Id": "a6639056-8a1d-4d07-8dc0-75fefd3a6006", - "ApiChange": "Resource", - "ChangedApiName": "product", - "ChangeType": "Addition", - "Description": "Added the [product](https://learn.microsoft.com/en-us/graph/api/resources/windowsupdates-product?view=graph-rest-beta) resource type."", - "Target": "product" - }, { "Id": "a6639056-8a1d-4d07-8dc0-75fefd3a6006", "ApiChange": "Resource", "ChangedApiName": "edition", "ChangeType": "Addition", - "Description": "Added the [edition](https://learn.microsoft.com/en-us/graph/api/resources/windowsupdates-edition?view=graph-rest-beta) resource type."", + "Description": "Added the [edition](https://learn.microsoft.com/en-us/graph/api/resources/windowsupdates-edition?view=graph-rest-beta) resource type.", "Target": "edition" }, { "Id": "a6639056-8a1d-4d07-8dc0-75fefd3a6006", "ApiChange": "Resource", - "ChangedApiName": "knownissue", + "ChangedApiName": "itemBody", "ChangeType": "Addition", - "Description": "Added the [knownissue](https://learn.microsoft.com/en-us/graph/api/resources/windowsupdates-knownissue?view=graph-rest-beta) resource type.", - "Target": "knownissue" + "Description": "Added the [itemBody](https://learn.microsoft.com/en-us/graph/api/resources/windowsupdates-itembody?view=graph-rest-beta) resource type.", + "Target": "itemBody" }, { "Id": "a6639056-8a1d-4d07-8dc0-75fefd3a6006", "ApiChange": "Resource", - "ChangedApiName": "servicingPeriod", + "ChangedApiName": "knownIssue", "ChangeType": "Addition", - "Description": "Added the [servicingPeriod](https://learn.microsoft.com/en-us/graph/api/resources/windowsupdates-servicingPeriod?view=graph-rest-beta) resource type.", - "Target": "servicingPeriod" + "Description": "Added the [knownIssue](https://learn.microsoft.com/en-us/graph/api/resources/windowsupdates-knownissue?view=graph-rest-beta) resource type.", + "Target": "knownIssue" }, { "Id": "a6639056-8a1d-4d07-8dc0-75fefd3a6006", @@ -1115,10 +1107,18 @@ { "Id": "a6639056-8a1d-4d07-8dc0-75fefd3a6006", "ApiChange": "Resource", - "ChangedApiName": "itemBody", + "ChangedApiName": "product", "ChangeType": "Addition", - "Description": "Added the [itemBody](https://learn.microsoft.com/en-us/graph/api/resources/windowsupdates-itembody?view=graph-rest-beta) resource type.", - "Target": "itemBody" + "Description": "Added the [product](https://learn.microsoft.com/en-us/graph/api/resources/windowsupdates-product?view=graph-rest-beta) resource and supported methods.", + "Target": "product" + }, + { + "Id": "a6639056-8a1d-4d07-8dc0-75fefd3a6006", + "ApiChange": "Resource", + "ChangedApiName": "servicingPeriod", + "ChangeType": "Addition", + "Description": "Added the [servicingPeriod](https://learn.microsoft.com/en-us/graph/api/resources/windowsupdates-servicingPeriod?view=graph-rest-beta) resource type.", + "Target": "servicingPeriod" } ], "Id": "a6639056-8a1d-4d07-8dc0-75fefd3a6006", From 71bce5b64f9280413e9037f482c2e55a11826fa5 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Mon, 11 Mar 2024 07:28:24 +0100 Subject: [PATCH 068/139] Update windowsupdates-itembody.md Edit. --- api-reference/beta/resources/windowsupdates-itembody.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/windowsupdates-itembody.md b/api-reference/beta/resources/windowsupdates-itembody.md index 5f266148ecf..e95b37b724e 100644 --- a/api-reference/beta/resources/windowsupdates-itembody.md +++ b/api-reference/beta/resources/windowsupdates-itembody.md @@ -20,7 +20,7 @@ Represents a container for holding content and its type. | Property | Type |Description| |:---------------|:--------|:----------| |content|String|The content of the item.| -|contentType|bodyType|The type of the content indicated by the enum value of **bodyType**. Possible values are: `text` and `html`.| +|contentType|microsoft.graph.bodyType|The type of the content indicated by the enum value of **bodyType**. Possible values are: `text` and `html`.| ## Relationships From f78742ae80b437ee040da5a28024bfbc2b3035b9 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Mon, 11 Mar 2024 07:28:43 +0100 Subject: [PATCH 069/139] Update windowsupdates-itembody.md Edit. --- api-reference/beta/resources/windowsupdates-itembody.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/windowsupdates-itembody.md b/api-reference/beta/resources/windowsupdates-itembody.md index e95b37b724e..442552d05a7 100644 --- a/api-reference/beta/resources/windowsupdates-itembody.md +++ b/api-reference/beta/resources/windowsupdates-itembody.md @@ -20,7 +20,7 @@ Represents a container for holding content and its type. | Property | Type |Description| |:---------------|:--------|:----------| |content|String|The content of the item.| -|contentType|microsoft.graph.bodyType|The type of the content indicated by the enum value of **bodyType**. Possible values are: `text` and `html`.| +|contentType|microsoft.graph.bodyType|The type of the content indicated by the enum value of **bodyType**. Possible values are: `text`, `html`.| ## Relationships From 04591fdfd048e43fc6cd030a060bb76a3866b962 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Mon, 11 Mar 2024 07:31:02 +0100 Subject: [PATCH 070/139] Update windowsupdates-product.md Edit. --- api-reference/beta/resources/windowsupdates-product.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/resources/windowsupdates-product.md b/api-reference/beta/resources/windowsupdates-product.md index b7c560f088f..55bfaf09fe5 100644 --- a/api-reference/beta/resources/windowsupdates-product.md +++ b/api-reference/beta/resources/windowsupdates-product.md @@ -38,8 +38,8 @@ Example of a Windows Product: |Relationship|Type|Description| |:---|:---|:---| |editions|[microsoft.graph.windowsUpdates.edition](.../resources/windowsupdates-edition.md) collection| Represents an edition of a particular Windows product. | -|knownIssues|[microsoft.graph.windowsUpdates.knownIssue](.../resources/windowsupdates-knownIssue.md) collection| Represents a known issue related to a Windows product. | -|revisions|[microsoft.graph.windowsUpdates.productrevision](.../resources/windowsupdates-productrevision.md) collection|Represents a product revision.| +|knownIssues|[microsoft.graph.windowsUpdates.knownIssue](.../resources/windowsupdates-knownissue.md) collection| Represents a known issue related to a Windows product. | +|revisions|[microsoft.graph.windowsUpdates.productRevision](.../resources/windowsupdates-productrevision.md) collection|Represents a product revision.| ## JSON representation The following JSON representation shows the resource type. From 0d2ed2e50027066d281101f926b239912cc05ed8 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Mon, 11 Mar 2024 22:23:04 +0100 Subject: [PATCH 071/139] Update toc.yml Edit. --- api-reference/beta/toc.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/api-reference/beta/toc.yml b/api-reference/beta/toc.yml index dab068be69b..32ea60b93a5 100644 --- a/api-reference/beta/toc.yml +++ b/api-reference/beta/toc.yml @@ -10200,7 +10200,7 @@ items: - name: Known Issue history item href: resources/windowsupdates-knownissuehistoryitem.md - name: Get known Issues by time range - href: api/windowsupdates-get-knownIssues-time-range.md + href: api/windowsupdates-product-getknownissuesbytimerange.md - name: Edition href: resources/windowsupdates-edition.md - name: Servicing period @@ -10208,9 +10208,9 @@ items: - name: Item Body href: resources/windowsupdates-itembody.md - name: Find Product revisions by Catalog ID - href: resources/windowsupdates-find-by-CatalogId.md + href: resources/windowsupdates-product-findbycatalogid.md - name: Find Product revisions by KB number - href: resources/windowsupdates-find-by-KbNumber.md + href: resources/windowsupdates-product-findbykbnumber.md - name: Compliance change href: resources/windowsupdates-compliancechange.md items: From a779634d4f95ea90835ea2cc26a16a846917d884 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Mon, 11 Mar 2024 22:25:24 +0100 Subject: [PATCH 072/139] Update windowsupdates-edition.md Edit. --- api-reference/beta/resources/windowsupdates-edition.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/windowsupdates-edition.md b/api-reference/beta/resources/windowsupdates-edition.md index c1d80e6ec18..2f44d240555 100644 --- a/api-reference/beta/resources/windowsupdates-edition.md +++ b/api-reference/beta/resources/windowsupdates-edition.md @@ -37,7 +37,7 @@ Represents an edition of a particular Windows product. |Relationships|Type|Description| |:---|:---|:---| -|servicingPeriods| [microsoft.graph.windowsUpdates.servicingPeriod](.../resources/windowsupdates.servicingperiod.md) collection| Each object holds information of a servicing period related to the product edition.| +|servicingPeriods| [microsoft.graph.windowsUpdates.servicingPeriod](../resources/windowsupdates.servicingperiod.md) collection| Each object holds information of a servicing period related to the product edition.| ## JSON representation From 3b0e5aa4367ac411926624481ef8c6294ca902f9 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Mon, 11 Mar 2024 22:25:59 +0100 Subject: [PATCH 073/139] Update windowsupdates-knownissuehistoryitem.md Edit. --- .../beta/resources/windowsupdates-knownissuehistoryitem.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/windowsupdates-knownissuehistoryitem.md b/api-reference/beta/resources/windowsupdates-knownissuehistoryitem.md index 1c55b158288..567f14a589b 100644 --- a/api-reference/beta/resources/windowsupdates-knownissuehistoryitem.md +++ b/api-reference/beta/resources/windowsupdates-knownissuehistoryitem.md @@ -25,7 +25,7 @@ Represents the description text for the known issue, used to maintain historical |Relationship|Type|Description| |:---|:---|:---| -|body| [microsoft.graph.windowsUpdates.itemBody](.../resources/windowsupdates.itembody.md)| Container for holding content and type. | +|body| [microsoft.graph.windowsUpdates.itemBody](../resources/windowsupdates.itembody.md)| Container for holding content and type. | ## JSON representation From 9f02ebb1cf794548f3a8478472cab9813adcccee Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Mon, 11 Mar 2024 22:26:35 +0100 Subject: [PATCH 074/139] Update windowsupdates-product.md Edit. --- api-reference/beta/resources/windowsupdates-product.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/api-reference/beta/resources/windowsupdates-product.md b/api-reference/beta/resources/windowsupdates-product.md index 55bfaf09fe5..d1802fff8d2 100644 --- a/api-reference/beta/resources/windowsupdates-product.md +++ b/api-reference/beta/resources/windowsupdates-product.md @@ -37,9 +37,9 @@ Example of a Windows Product: |Relationship|Type|Description| |:---|:---|:---| -|editions|[microsoft.graph.windowsUpdates.edition](.../resources/windowsupdates-edition.md) collection| Represents an edition of a particular Windows product. | -|knownIssues|[microsoft.graph.windowsUpdates.knownIssue](.../resources/windowsupdates-knownissue.md) collection| Represents a known issue related to a Windows product. | -|revisions|[microsoft.graph.windowsUpdates.productRevision](.../resources/windowsupdates-productrevision.md) collection|Represents a product revision.| +|editions|[microsoft.graph.windowsUpdates.edition](../resources/windowsupdates-edition.md) collection| Represents an edition of a particular Windows product. | +|knownIssues|[microsoft.graph.windowsUpdates.knownIssue](../resources/windowsupdates-knownissue.md) collection| Represents a known issue related to a Windows product. | +|revisions|[microsoft.graph.windowsUpdates.productRevision](../resources/windowsupdates-productrevision.md) collection|Represents a product revision.| ## JSON representation The following JSON representation shows the resource type. From 6b12feeac58dc46898c94bfaddc657d4e4d609e8 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Mon, 11 Mar 2024 22:34:05 +0100 Subject: [PATCH 075/139] Update windowsupdates-knownissue.md Edit. --- .../beta/resources/windowsupdates-knownissue.md | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/api-reference/beta/resources/windowsupdates-knownissue.md b/api-reference/beta/resources/windowsupdates-knownissue.md index 098b2e1d885..099b8706103 100644 --- a/api-reference/beta/resources/windowsupdates-knownissue.md +++ b/api-reference/beta/resources/windowsupdates-knownissue.md @@ -13,9 +13,7 @@ Namespace: microsoft.graph.windowsUpdates [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents a known issue related to a Windows product. - -Example of known Issues: [Windows 11, version 22H2 known Issues and notifications](https://learn.microsoft.com/en-us/windows/release-health/status-windows-11-22h2) +Represents a known issue related to a Windows product. For example of known issues, see [Windows 11, version 22H2 known issues and notifications](/windows/release-health/status-windows-11-22h2). ## Properties @@ -34,9 +32,9 @@ Example of known Issues: [Windows 11, version 22H2 known Issues and notification |Relationship|Type|Description| |:---|:---|:---| -|knownIssueHistories| [microsoft.graph.windowsUpdates.knownIssueHistories](../resources/windowsupdates-knownissuehistories.md) collection| A list of known issue histories.| -|originatingKnowledgeBaseArticle | [microsoft.graph.windowsUpdates.knowledgebasearticle](../resources/windowsupdates-knowledgebasearticle.md) collection |Knowledge base article associated with the release when the known issue was first reported. | -|resolvingKnowledgeBaseArticle| [microsoft.graph.windowsUpdates.knowledgebasearticle](../resources/windowsupdates-knowledgebasearticle.md) collection|Knowledge base article associated with the release when the known issue was resolved or mitigated. | +|knownIssueHistories| [microsoft.graph.windowsUpdates.knownIssueHistoryItem](../resources/windowsupdates-knownissuehistoryitem.md) collection| A list of known issue histories.| +|originatingKnowledgeBaseArticle | [microsoft.graph.windowsUpdates.knowledgeBaseArticle](../resources/windowsupdates-knowledgebasearticle.md) collection |Knowledge base article associated with the release when the known issue was first reported. | +|resolvingKnowledgeBaseArticle| [microsoft.graph.windowsUpdates.knowledgeBaseArticle](../resources/windowsupdates-knowledgebasearticle.md) collection|Knowledge base article associated with the release when the known issue was resolved or mitigated. | |safeguardHoldIds|Int32 collection|A list of safeguard hold IDs associated with the known issue.| ## JSON representation From e0eefd7a5624a713132afcf53a2e5d407dd6e05c Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Mon, 11 Mar 2024 22:38:17 +0100 Subject: [PATCH 076/139] Update windowsupdates-product-getknownissuesbytimerange.md Edit. --- .../api/windowsupdates-product-getknownissuesbytimerange.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md b/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md index 8a976fec41f..b166ad311c1 100644 --- a/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md +++ b/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md @@ -56,7 +56,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 [microsoft.graph.windowsUpdates.knownIssue](../resources/windowsupdates-knownissues.md) objects for the given time range in the response body. +If successful, this method returns a `200 OK` response code and a collection of [microsoft.graph.windowsUpdates.knownIssue](../resources/windowsupdates-knownissue.md) objects for the given time range in the response body. ## Examples From 22f8867d3da4336b7bff57d8be12c27160dbdf15 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Mon, 11 Mar 2024 22:39:01 +0100 Subject: [PATCH 077/139] Update windowsupdates-edition.md Edit. --- api-reference/beta/resources/windowsupdates-edition.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/windowsupdates-edition.md b/api-reference/beta/resources/windowsupdates-edition.md index 2f44d240555..eb53de23f2e 100644 --- a/api-reference/beta/resources/windowsupdates-edition.md +++ b/api-reference/beta/resources/windowsupdates-edition.md @@ -37,7 +37,7 @@ Represents an edition of a particular Windows product. |Relationships|Type|Description| |:---|:---|:---| -|servicingPeriods| [microsoft.graph.windowsUpdates.servicingPeriod](../resources/windowsupdates.servicingperiod.md) collection| Each object holds information of a servicing period related to the product edition.| +|servicingPeriods| [microsoft.graph.windowsUpdates.servicingPeriod](../resources/windowsupdates-servicingperiod.md) collection| Each object holds information of a servicing period related to the product edition.| ## JSON representation From 881b673757f1fff6551a9618aef66f678a29448f Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Mon, 11 Mar 2024 22:40:05 +0100 Subject: [PATCH 078/139] Update windowsupdates-knownissuehistoryitem.md Edit. --- .../beta/resources/windowsupdates-knownissuehistoryitem.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/windowsupdates-knownissuehistoryitem.md b/api-reference/beta/resources/windowsupdates-knownissuehistoryitem.md index 567f14a589b..ca89e21bff3 100644 --- a/api-reference/beta/resources/windowsupdates-knownissuehistoryitem.md +++ b/api-reference/beta/resources/windowsupdates-knownissuehistoryitem.md @@ -25,7 +25,7 @@ Represents the description text for the known issue, used to maintain historical |Relationship|Type|Description| |:---|:---|:---| -|body| [microsoft.graph.windowsUpdates.itemBody](../resources/windowsupdates.itembody.md)| Container for holding content and type. | +|body| [microsoft.graph.windowsUpdates.itemBody](../resources/windowsupdates-itembody.md)| Container for holding content and type. | ## JSON representation From 5fab45dc158a0d39abd41234b9aae77d3a37d95a Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Mon, 11 Mar 2024 22:43:49 +0100 Subject: [PATCH 079/139] Update windowsupdates-product-findbykbnumber.md Edit. --- api-reference/beta/api/windowsupdates-product-findbykbnumber.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/api/windowsupdates-product-findbykbnumber.md b/api-reference/beta/api/windowsupdates-product-findbykbnumber.md index b3b52731adb..23e8ed68a1d 100644 --- a/api-reference/beta/api/windowsupdates-product-findbykbnumber.md +++ b/api-reference/beta/api/windowsupdates-product-findbykbnumber.md @@ -55,7 +55,7 @@ Don't supply a request body for this method. ## Response -If successful, this method returns a `200 OK` response code and a collection collection of [windows.graph.windowsUpdates.product](../includes/permissions/windowsupdates-product.md) objects in the response body. +If successful, this method returns a `200 OK` response code and a collection collection of [microsoft.graph.windowsUpdates.product](../resources/windowsupdates-product.md) objects in the response body. ## Examples From 4298de0a782b9a488ebfc79df3478fa8551ea016 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Mon, 11 Mar 2024 22:45:59 +0100 Subject: [PATCH 080/139] Update windowsupdates-product-findbykbnumber.md Edit. --- api-reference/beta/api/windowsupdates-product-findbykbnumber.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/api/windowsupdates-product-findbykbnumber.md b/api-reference/beta/api/windowsupdates-product-findbykbnumber.md index 23e8ed68a1d..994a1a3c80b 100644 --- a/api-reference/beta/api/windowsupdates-product-findbykbnumber.md +++ b/api-reference/beta/api/windowsupdates-product-findbykbnumber.md @@ -69,7 +69,7 @@ The following example shows a request. } --> ``` http -GET /admin/windows/updates/products/FindByKbNumber(kbNumber=5029332)?expand=revisions($expand=catalogEntry,knowledgeBaseArticle),knownIssues +GET https://graph.microsoft.com/beta/admin/windows/updates/products/FindByKbNumber(kbNumber=5029332)?expand=revisions($expand=catalogEntry,knowledgeBaseArticle),knownIssues ``` ### Response From 50763a52809534b5861dc29b78be09a8646ea643 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Mon, 11 Mar 2024 22:57:35 +0100 Subject: [PATCH 081/139] Update windowsupdates-edition.md Edit. --- .../beta/resources/windowsupdates-edition.md | 12 +++--------- 1 file changed, 3 insertions(+), 9 deletions(-) diff --git a/api-reference/beta/resources/windowsupdates-edition.md b/api-reference/beta/resources/windowsupdates-edition.md index eb53de23f2e..a60d7d1466d 100644 --- a/api-reference/beta/resources/windowsupdates-edition.md +++ b/api-reference/beta/resources/windowsupdates-edition.md @@ -1,6 +1,6 @@ --- title: "edition resource type" -description: "Represents an edition of a particular Windows product." +description: "Represents a specific edition of a Windows product, such as Enterprise, Core, or Education." author: "skandula" ms.localizationpriority: medium ms.service: "windows-10" @@ -13,19 +13,13 @@ Namespace: microsoft.graph.windowsUpdates [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents an edition of a particular Windows product. - -|Examples| -|:---| -|Enterprise| -|Core| -|Education| +Represents a specific edition of a Windows product, such as Enterprise, Core, or Education. ## Properties |Property|Type|Description| |:---|:---|:---| -|deviceFamily|String|The device family targeted by the edition| +|deviceFamily|String|The device family targeted by the edition.| |endofServiceDateTime|DateTimeOffset|The date and time when the edition reaches or reached end of service. 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`. Read-only. | |generalAvailabilityDateTime|DateTimeOffset|The date and time when the edition became available to the general customers for the first time. 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`. Read-only.| |id|String|The unique identifier for the edition entry. Read-only.| From d6dd7e5f1e0b47bbcdd7ef56490eca7ceea401a9 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Mon, 11 Mar 2024 23:08:31 +0100 Subject: [PATCH 082/139] Update windowsupdates-knownissuehistoryitem.md Edit, --- .../beta/resources/windowsupdates-knownissuehistoryitem.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/api-reference/beta/resources/windowsupdates-knownissuehistoryitem.md b/api-reference/beta/resources/windowsupdates-knownissuehistoryitem.md index ca89e21bff3..8de8632911c 100644 --- a/api-reference/beta/resources/windowsupdates-knownissuehistoryitem.md +++ b/api-reference/beta/resources/windowsupdates-knownissuehistoryitem.md @@ -41,7 +41,6 @@ The following JSON representation shows the resource type. ``` json { "@odata.type": "#microsoft.graph.windowsUpdates.knownIssueHistoryItem", - "createdDateTime": "String (timestamp)", - "endOfServiceDateTime": "String (timestamp)" + "createdDateTime": "String (timestamp)" } ``` From ca77ba07e9f4e0405abde500865041e4c6d8a77b Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Mon, 11 Mar 2024 23:20:27 +0100 Subject: [PATCH 083/139] Update windowsupdates-product.md Edit. --- .../beta/resources/windowsupdates-product.md | 14 +++----------- 1 file changed, 3 insertions(+), 11 deletions(-) diff --git a/api-reference/beta/resources/windowsupdates-product.md b/api-reference/beta/resources/windowsupdates-product.md index d1802fff8d2..54e4e4b2e12 100644 --- a/api-reference/beta/resources/windowsupdates-product.md +++ b/api-reference/beta/resources/windowsupdates-product.md @@ -14,20 +14,12 @@ Namespace: microsoft.graph.windowsUpdates [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Represents a Windows product. - -Example of a Windows Product: - -|Name|Example| -|:---|:---| -|Name| Windows 11, version 22H2 | -|Friendly Name| Version 22H2 (OS build 22621) | -|Group Name| Windows 11| ## Properties |Property|Type|Description| |:---|:---|:---| -|friendlyName|String|The name of the product. For example, `Version 22H2 (OS build 22621)`. Read-only.| +|friendlyNames|String collection|The friendly names of the product. For example, `Version 22H2 (OS build 22621)`. Read-only.| |groupName|String|The name of the product group. For example, `Windows 11`. Read-only.| |id|String|The unique identifier for the product. Read-only.| |name|String|The name of the product. For example, `Windows 11, version 22H2`. Read-only.| @@ -53,10 +45,10 @@ The following JSON representation shows the resource type. ``` json { "@odata.type": "#microsoft.graph.windowsUpdates.product", - "groupName": "String", "friendlyNames": ["String"], + "groupName": "String", "id": "String (identifier)", - "name": "String" + "name": "String", "releaseDateTime": "String (timestamp)" } ``` From 5e96331f241334d69bf89aa2601f1bdd6c916635 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Mon, 11 Mar 2024 23:26:25 +0100 Subject: [PATCH 084/139] Update windowsupdates-product-findbykbnumber.md Edit. --- api-reference/beta/api/windowsupdates-product-findbykbnumber.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/api/windowsupdates-product-findbykbnumber.md b/api-reference/beta/api/windowsupdates-product-findbykbnumber.md index 994a1a3c80b..21ce9de7418 100644 --- a/api-reference/beta/api/windowsupdates-product-findbykbnumber.md +++ b/api-reference/beta/api/windowsupdates-product-findbykbnumber.md @@ -55,7 +55,7 @@ Don't supply a request body for this method. ## Response -If successful, this method returns a `200 OK` response code and a collection collection of [microsoft.graph.windowsUpdates.product](../resources/windowsupdates-product.md) objects in the response body. +If successful, this method returns a `200 OK` response code and a collection of [microsoft.graph.windowsUpdates.product](../resources/windowsupdates-product.md) objects in the response body. ## Examples From 6d9f8d19bc724b7a7c9dcdd754499c7957a4ba7a Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Mon, 11 Mar 2024 23:45:57 +0100 Subject: [PATCH 085/139] Update windowsupdates-edition.md Edit --- api-reference/beta/resources/windowsupdates-edition.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/windowsupdates-edition.md b/api-reference/beta/resources/windowsupdates-edition.md index a60d7d1466d..4621141a5b2 100644 --- a/api-reference/beta/resources/windowsupdates-edition.md +++ b/api-reference/beta/resources/windowsupdates-edition.md @@ -20,7 +20,7 @@ Represents a specific edition of a Windows product, such as Enterprise, Core, or |Property|Type|Description| |:---|:---|:---| |deviceFamily|String|The device family targeted by the edition.| -|endofServiceDateTime|DateTimeOffset|The date and time when the edition reaches or reached end of service. 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`. Read-only. | +|endOfServiceDateTime|DateTimeOffset|The date and time when the edition reaches or reached end of service. 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`. Read-only. | |generalAvailabilityDateTime|DateTimeOffset|The date and time when the edition became available to the general customers for the first time. 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`. Read-only.| |id|String|The unique identifier for the edition entry. Read-only.| |isInService|Boolean| Represents an edition of a particular Windows product.| From d1bbc15cc75e42db4fc424e3cf0e3e374f42f854 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Mon, 11 Mar 2024 23:47:59 +0100 Subject: [PATCH 086/139] Update windowsupdates-edition.md Edit. --- api-reference/beta/resources/windowsupdates-edition.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/windowsupdates-edition.md b/api-reference/beta/resources/windowsupdates-edition.md index 4621141a5b2..6b4571c8c5c 100644 --- a/api-reference/beta/resources/windowsupdates-edition.md +++ b/api-reference/beta/resources/windowsupdates-edition.md @@ -20,7 +20,7 @@ Represents a specific edition of a Windows product, such as Enterprise, Core, or |Property|Type|Description| |:---|:---|:---| |deviceFamily|String|The device family targeted by the edition.| -|endOfServiceDateTime|DateTimeOffset|The date and time when the edition reaches or reached end of service. 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`. Read-only. | +|endOfServiceDateTime|DateTimeOffset|The date and time when the edition reached the end of service. 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`. Read-only. | |generalAvailabilityDateTime|DateTimeOffset|The date and time when the edition became available to the general customers for the first time. 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`. Read-only.| |id|String|The unique identifier for the edition entry. Read-only.| |isInService|Boolean| Represents an edition of a particular Windows product.| From 0ac5ff29b0265b6a6dd5810ea99f0e3c74eb8a14 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Tue, 12 Mar 2024 00:00:45 +0100 Subject: [PATCH 087/139] Update toc.yml Edit --- api-reference/beta/toc.yml | 34 ++++++++++++---------------------- 1 file changed, 12 insertions(+), 22 deletions(-) diff --git a/api-reference/beta/toc.yml b/api-reference/beta/toc.yml index 8cc5d08141f..71c36d8f69c 100644 --- a/api-reference/beta/toc.yml +++ b/api-reference/beta/toc.yml @@ -10219,28 +10219,6 @@ items: href: resources/windowsupdates-driverupdatecatalogentry.md - name: List catalog entries href: api/windowsupdates-catalog-list-entries.md - - name: Windows Release Information - items: - - name: Product - href: resources/windowsupdates-product.md - items: - - name: Known issue - href: resources/windowsupdates-knownissue.md - items: - - name: Known Issue history item - href: resources/windowsupdates-knownissuehistoryitem.md - - name: Get known Issues by time range - href: api/windowsupdates-product-getknownissuesbytimerange.md - - name: Edition - href: resources/windowsupdates-edition.md - - name: Servicing period - href: resources/windowsupdates-servicingperiod.md - - name: Item Body - href: resources/windowsupdates-itembody.md - - name: Find Product revisions by Catalog ID - href: resources/windowsupdates-product-findbycatalogid.md - - name: Find Product revisions by KB number - href: resources/windowsupdates-product-findbykbnumber.md - name: Compliance change href: resources/windowsupdates-compliancechange.md items: @@ -10301,6 +10279,18 @@ items: href: api/windowsupdates-deploymentaudience-updateaudience.md - name: Update by ID href: api/windowsupdates-deploymentaudience-updateaudiencebyid.md + - name: Product + href: resources/windowsupdates-product.md + items: + - name: Find by catalog ID + href: resources/windowsupdates-product-findbycatalogid.md + - name: Find by knowledge base number + href: resources/windowsupdates-product-findbykbnumber.md + - name: Known issue + href: resources/windowsupdates-knownissue.md + items: + - name: Get known issues by time range + href: api/windowsupdates-product-getknownissuesbytimerange.md - name: Resource connection href: resources/windowsupdates-resourceconnection.md items: From 6d4e316875492b89cefce4e4862d42189cdd58a2 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Tue, 12 Mar 2024 00:10:15 +0100 Subject: [PATCH 088/139] Update windowsupdates-product.md Edit. --- api-reference/beta/resources/windowsupdates-product.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/api-reference/beta/resources/windowsupdates-product.md b/api-reference/beta/resources/windowsupdates-product.md index 54e4e4b2e12..acafc80d345 100644 --- a/api-reference/beta/resources/windowsupdates-product.md +++ b/api-reference/beta/resources/windowsupdates-product.md @@ -14,7 +14,15 @@ Namespace: microsoft.graph.windowsUpdates [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Represents a Windows product. - + +## Methods + +|Method|Return type|Description| +|:---|:---|:---| +|[Get known issues by time range](../api/windowsupdates-product-getknownissuesbytimerange.md)|[microsoft.graph.windowsUpdates.knownIssue](../resources/windowsupdates-knownissue.md) collection|Get known issues related to a particular product based on a specified timeframe in the past.| +|[Find by catalog ID](../api/windowsupdates-product-findbycatalogid.md)|[microsoft.graph.windowsUpdates.product](../resources/windowsupdates-product.md) collection|Find the product revisions associated with a catalog ID and the known issues directly or indirectly related to the catalog ID.| +|[Find by knowledge base number](../api/windowsupdates-product-findbykbnumber.md)|[microsoft.graph.windowsUpdates.product](../resources/windowsupdates-product.md) collection|Find the product revisions associated with a knowledge base number and the known issues directly or indirectly related to the knowledge base number.| + ## Properties |Property|Type|Description| From 93928bfc2696a1f34d290c1d76f95257345b0dcf Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Mon, 11 Mar 2024 22:37:05 -0700 Subject: [PATCH 089/139] Create windowsupdates-product-findbycatalogid-permissions.md --- ...dowsupdates-product-findbycatalogid-permissions.md | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 api-reference/beta/includes/permissions/windowsupdates-product-findbycatalogid-permissions.md diff --git a/api-reference/beta/includes/permissions/windowsupdates-product-findbycatalogid-permissions.md b/api-reference/beta/includes/permissions/windowsupdates-product-findbycatalogid-permissions.md new file mode 100644 index 00000000000..cd75e75d217 --- /dev/null +++ b/api-reference/beta/includes/permissions/windowsupdates-product-findbycatalogid-permissions.md @@ -0,0 +1,11 @@ +--- +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)|WindowsUpdates.Read.All|WindowsUpdates.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|WindowsUpdates.Read.All|WindowsUpdates.ReadWrite.All| From a059a289a68cefce6d20b20a502814ffa2a468ce Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Mon, 11 Mar 2024 22:38:15 -0700 Subject: [PATCH 090/139] Create windowsupdates-product-findbykbnumber-permissions.md --- ...ndowsupdates-product-findbykbnumber-permissions.md | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 api-reference/beta/includes/permissions/windowsupdates-product-findbykbnumber-permissions.md diff --git a/api-reference/beta/includes/permissions/windowsupdates-product-findbykbnumber-permissions.md b/api-reference/beta/includes/permissions/windowsupdates-product-findbykbnumber-permissions.md new file mode 100644 index 00000000000..cd75e75d217 --- /dev/null +++ b/api-reference/beta/includes/permissions/windowsupdates-product-findbykbnumber-permissions.md @@ -0,0 +1,11 @@ +--- +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)|WindowsUpdates.Read.All|WindowsUpdates.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|WindowsUpdates.Read.All|WindowsUpdates.ReadWrite.All| From ba16db877750f3c51dd9f47294623b9ad5bb52a3 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Mon, 11 Mar 2024 22:38:51 -0700 Subject: [PATCH 091/139] Create windowsupdates-product-getknownissuesbytimerange-permissions.md --- ...s-product-getknownissuesbytimerange-permissions.md | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 api-reference/beta/includes/permissions/windowsupdates-product-getknownissuesbytimerange-permissions.md diff --git a/api-reference/beta/includes/permissions/windowsupdates-product-getknownissuesbytimerange-permissions.md b/api-reference/beta/includes/permissions/windowsupdates-product-getknownissuesbytimerange-permissions.md new file mode 100644 index 00000000000..cd75e75d217 --- /dev/null +++ b/api-reference/beta/includes/permissions/windowsupdates-product-getknownissuesbytimerange-permissions.md @@ -0,0 +1,11 @@ +--- +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)|WindowsUpdates.Read.All|WindowsUpdates.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|WindowsUpdates.Read.All|WindowsUpdates.ReadWrite.All| From 684dcf6a52ef557d538fd862f15a366f1e87f9ac Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Tue, 12 Mar 2024 06:40:05 +0100 Subject: [PATCH 092/139] Update windowsupdates-product-getknownissuesbytimerange.md Edit. --- .../beta/api/windowsupdates-product-getknownissuesbytimerange.md | 1 - 1 file changed, 1 deletion(-) diff --git a/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md b/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md index b166ad311c1..f753493a8ce 100644 --- a/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md +++ b/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md @@ -86,7 +86,6 @@ The following example shows the response. } --> ``` http - { "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.windowsUpdates.knownIssue)", "value": [ From 54760572a224842510bdadf1f41ad43fe2349829 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Tue, 12 Mar 2024 06:41:22 +0100 Subject: [PATCH 093/139] Update windowsupdates-product-findbycatalogid.md Edit. --- .../beta/api/windowsupdates-product-findbycatalogid.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/api-reference/beta/api/windowsupdates-product-findbycatalogid.md b/api-reference/beta/api/windowsupdates-product-findbycatalogid.md index aeba04de86a..60541171289 100644 --- a/api-reference/beta/api/windowsupdates-product-findbycatalogid.md +++ b/api-reference/beta/api/windowsupdates-product-findbycatalogid.md @@ -83,6 +83,8 @@ The following example shows the response. } --> ``` http +HTTP/1.1 200 OK +Content-Type: application/json { "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.windowsUpdates.product)", From 80ce27969158ec41ef36e1da62dfbdf800c21ced Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Tue, 12 Mar 2024 06:41:41 +0100 Subject: [PATCH 094/139] Update windowsupdates-product-findbykbnumber.md Edit. --- .../beta/api/windowsupdates-product-findbykbnumber.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/api-reference/beta/api/windowsupdates-product-findbykbnumber.md b/api-reference/beta/api/windowsupdates-product-findbykbnumber.md index 21ce9de7418..fae8f0123df 100644 --- a/api-reference/beta/api/windowsupdates-product-findbykbnumber.md +++ b/api-reference/beta/api/windowsupdates-product-findbykbnumber.md @@ -85,6 +85,9 @@ The following example shows the response. } --> ``` http +HTTP/1.1 200 OK +Content-Type: application/json + { "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.windowsUpdates.product)", "value": [ From 30bb8a727da78653cc9f0d37a99916779dd54c8f Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Tue, 12 Mar 2024 06:42:01 +0100 Subject: [PATCH 095/139] Update windowsupdates-product-getknownissuesbytimerange.md Edit. --- .../api/windowsupdates-product-getknownissuesbytimerange.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md b/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md index f753493a8ce..cee87da35c0 100644 --- a/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md +++ b/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md @@ -86,6 +86,9 @@ The following example shows the response. } --> ``` http +HTTP/1.1 200 OK +Content-Type: application/json + { "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.windowsUpdates.knownIssue)", "value": [ From 6a24b0750d94f004d69f90ca59734ba32dd563c6 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Tue, 12 Mar 2024 06:43:12 +0100 Subject: [PATCH 096/139] Update windowsupdates-product-findbycatalogid.md Edit. --- .../beta/api/windowsupdates-product-findbycatalogid.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/api/windowsupdates-product-findbycatalogid.md b/api-reference/beta/api/windowsupdates-product-findbycatalogid.md index 60541171289..1b71793a4b8 100644 --- a/api-reference/beta/api/windowsupdates-product-findbycatalogid.md +++ b/api-reference/beta/api/windowsupdates-product-findbycatalogid.md @@ -68,7 +68,7 @@ The following example shows a request. } --> ``` http -GET https://graph.microsoft.com/beta/admin/windows/updates/products/FindByCatalogId(catalogID= '10cb1ba292c5586e22c9991be3f12fbd39f2ebf231cb5d201c67f42fbaccc567')?expand=revisions($expand=catalogEntry,knowledgeBaseArticle),knownIssues($expand=originatingKnowledgeBaseArticle,resolvingKnowledgeBaseArticle) +GET https://graph.microsoft.com/beta/admin/windows/updates/products/FindByCatalogId(catalogID='10cb1ba292c5586e22c9991be3f12fbd39f2ebf231cb5d201c67f42fbaccc567')?expand=revisions($expand=catalogEntry,knowledgeBaseArticle),knownIssues($expand=originatingKnowledgeBaseArticle,resolvingKnowledgeBaseArticle) ``` ### Response From 648dc1e1cedb5bc4445eba8bfd2ba992262841ba Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Tue, 12 Mar 2024 06:54:53 +0100 Subject: [PATCH 097/139] Update windowsupdates-knownissue.md Edit. --- .../beta/resources/windowsupdates-knownissue.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/api-reference/beta/resources/windowsupdates-knownissue.md b/api-reference/beta/resources/windowsupdates-knownissue.md index 099b8706103..48343c984be 100644 --- a/api-reference/beta/resources/windowsupdates-knownissue.md +++ b/api-reference/beta/resources/windowsupdates-knownissue.md @@ -24,10 +24,23 @@ Represents a known issue related to a Windows product. For example of known issu |lastUpdatedDateTime|DateTimeOffset|The date and time when the known issue was last updated. 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`. Read-only.| |resolvedDateTime|DateTimeOffset| The date and time when the known issue was resolved or mitigated. 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`.| |startDateTime|DateTimeOffset|The date and time when the known issue was first reported. 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`. | -|status|String|The status of the known issue.| +|status|[windowsReleaseHealthStatus](../resources/knownissue.md#windowsreleasehealthstatus-values)|The status of the known issue.| |title|String|The title of the known issue.| |webViewUrl|String|The URL to the known issue in the Windows Release Health dashboard on Microsoft 365 admin center.| +### windowsReleaseHealthStatus values + +| Member | Description | +|:-------------------|:---------------------------------------------------------| +| resolved | The known issues was resolved by Microsoft. | +| mitigatedExternal | The known issue was mitigated by an external entity. | +| mitigated | The known issues was mitigated by Microsoft. | +| resolvedExternal | The known issue was resolved by an external entity. | +| confirmed | The known issue was confirmed by Microsoft. | +| reported | Microsoft acknowledges that the known issue is reported. | +| investigating | Microsoft is investigating the known issue. | +| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | + ## Relationships |Relationship|Type|Description| From 4d52a01e2c9959b35b2e178d899e1d8c51dd8658 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Tue, 12 Mar 2024 06:58:41 +0100 Subject: [PATCH 098/139] Update Microsoft.WindowsUpdates.json Edit. --- changelog/Microsoft.WindowsUpdates.json | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/changelog/Microsoft.WindowsUpdates.json b/changelog/Microsoft.WindowsUpdates.json index 79f914d7445..d6ff2a780c8 100644 --- a/changelog/Microsoft.WindowsUpdates.json +++ b/changelog/Microsoft.WindowsUpdates.json @@ -1072,6 +1072,14 @@ }, { "ChangeList": [ + { + "Id": "a6639056-8a1d-4d07-8dc0-75fefd3a6006", + "ApiChange": "Enum type", + "ChangedApiName": "windowsReleaseHealthStatus", + "ChangeType": "Addition", + "Description": "Added the **windowsReleaseHealthStatus** enumeration type.", + "Target": "windowsReleaseHealthStatus" + }, { "Id": "a6639056-8a1d-4d07-8dc0-75fefd3a6006", "ApiChange": "Resource", From 35b693f201c80f8afbde2bc7c7cac472178d3e8b Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Tue, 12 Mar 2024 07:00:11 +0100 Subject: [PATCH 099/139] Update windowsupdates-knownissue.md Edit. --- api-reference/beta/resources/windowsupdates-knownissue.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/windowsupdates-knownissue.md b/api-reference/beta/resources/windowsupdates-knownissue.md index 48343c984be..d9421259f8c 100644 --- a/api-reference/beta/resources/windowsupdates-knownissue.md +++ b/api-reference/beta/resources/windowsupdates-knownissue.md @@ -24,7 +24,7 @@ Represents a known issue related to a Windows product. For example of known issu |lastUpdatedDateTime|DateTimeOffset|The date and time when the known issue was last updated. 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`. Read-only.| |resolvedDateTime|DateTimeOffset| The date and time when the known issue was resolved or mitigated. 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`.| |startDateTime|DateTimeOffset|The date and time when the known issue was first reported. 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`. | -|status|[windowsReleaseHealthStatus](../resources/knownissue.md#windowsreleasehealthstatus-values)|The status of the known issue.| +|status|[microsoft.graph.windowsUpdates.windowsReleaseHealthStatus](../resources/knownissue.md#windowsreleasehealthstatus-values)|The status of the known issue.| |title|String|The title of the known issue.| |webViewUrl|String|The URL to the known issue in the Windows Release Health dashboard on Microsoft 365 admin center.| From 1e123d5510fd008dc3675d1c22e88c6f21ea101d Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Tue, 12 Mar 2024 07:04:12 +0100 Subject: [PATCH 100/139] Update enums-windowsupdates.md Edit. --- api-reference/beta/resources/enums-windowsupdates.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/api-reference/beta/resources/enums-windowsupdates.md b/api-reference/beta/resources/enums-windowsupdates.md index da44402d4fb..9736152fbe5 100644 --- a/api-reference/beta/resources/enums-windowsupdates.md +++ b/api-reference/beta/resources/enums-windowsupdates.md @@ -120,6 +120,14 @@ Namespace: microsoft.graph.windowsUpdates |important| |unknownFutureValue| +### bodyType values + +| Member | +|:-------| +| text | +| html | +| unknownFutureValue | + -[!INCLUDE [permissions-table](../includes/permissions/windowsupdates-catalog-list-entries-permissions.md)] + +[!INCLUDE [permissions-table](../includes/permissions/windowsupdates-product-getknownissuesbytimerange-permissions.md)] [!INCLUDE [rbac-windows-updates-apis](../includes/rbac-for-apis/rbac-windows-updates-apis.md)] From 69eeb55933b0e858b2f5c22f67a8c7e4fbde310a Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Tue, 12 Mar 2024 07:10:30 +0100 Subject: [PATCH 104/139] Update windowsupdates-product-findbykbnumber.md Edit. --- .../beta/api/windowsupdates-product-findbykbnumber.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/api/windowsupdates-product-findbykbnumber.md b/api-reference/beta/api/windowsupdates-product-findbykbnumber.md index fae8f0123df..a8a0f45bf0f 100644 --- a/api-reference/beta/api/windowsupdates-product-findbykbnumber.md +++ b/api-reference/beta/api/windowsupdates-product-findbykbnumber.md @@ -18,8 +18,8 @@ Find the product revisions associated with a knowledge base number and the known ## 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/windowsupdates-catalog-list-entries-permissions.md)] + +[!INCLUDE [permissions-table](../includes/permissions/windowsupdates-product-findbykbnumber-permissions.md)] [!INCLUDE [rbac-windows-updates-apis](../includes/rbac-for-apis/rbac-windows-updates-apis.md)] From ed5313c02c5786eaefec3556ee375d7905055db4 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Tue, 12 Mar 2024 07:11:20 +0100 Subject: [PATCH 105/139] Update windowsupdates-product-findbycatalogid.md Edit. --- .../beta/api/windowsupdates-product-findbycatalogid.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/api/windowsupdates-product-findbycatalogid.md b/api-reference/beta/api/windowsupdates-product-findbycatalogid.md index 1b71793a4b8..593905076bb 100644 --- a/api-reference/beta/api/windowsupdates-product-findbycatalogid.md +++ b/api-reference/beta/api/windowsupdates-product-findbycatalogid.md @@ -18,8 +18,8 @@ Find the product revisions associated with a catalog ID and the known issues dir ## 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/windowsupdates-catalog-list-entries-permissions.md)] + +[!INCLUDE [permissions-table](../includes/permissions/windowsupdates-product-findbycatalogid-permissions.md)] [!INCLUDE [rbac-windows-updates-apis](../includes/rbac-for-apis/rbac-windows-updates-apis.md)] From 73bac825595e5f36dec5ff1e52730e558bc9094b Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Tue, 12 Mar 2024 07:13:12 +0100 Subject: [PATCH 106/139] Update toc.yml Edit. --- api-reference/beta/toc.yml | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/api-reference/beta/toc.yml b/api-reference/beta/toc.yml index 96259bdeeef..63a1ed50924 100644 --- a/api-reference/beta/toc.yml +++ b/api-reference/beta/toc.yml @@ -10292,15 +10292,12 @@ items: - name: Product href: resources/windowsupdates-product.md items: + - name: Get known issues by time range + href: api/windowsupdates-product-getknownissuesbytimerange.md - name: Find by catalog ID href: resources/windowsupdates-product-findbycatalogid.md - name: Find by knowledge base number href: resources/windowsupdates-product-findbykbnumber.md - - name: Known issue - href: resources/windowsupdates-knownissue.md - items: - - name: Get known issues by time range - href: api/windowsupdates-product-getknownissuesbytimerange.md - name: Resource connection href: resources/windowsupdates-resourceconnection.md items: From 757c7a4a431127265c8ed63e1013642dba93fb20 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Tue, 12 Mar 2024 07:25:43 +0100 Subject: [PATCH 107/139] Update whats-new-overview.md Edit. --- 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 28419a32173..8ccbb18b6c1 100644 --- a/concepts/whats-new-overview.md +++ b/concepts/whats-new-overview.md @@ -28,6 +28,10 @@ Use the [billedReconciliation: export](/graph/api/partners-billing-billedreconci ## March 2024: New in preview only +### Device and app management | Device updates + +Added methods to the Windows Updates API for Windows products, including [retrieval of known issues by time range](/graph/api/resources/windowsupdates-product-getknownissuesbytimerange?view=graph-rest-beta&preserve-view=true), [finding product revisions by catalog ID](/graph/api/resources/windowsupdates-product-findbycatalogid?view=graph-rest-beta&preserve-view=true), and [by knowledge base number](/graph/api/resources/windowsupdates-product-findbykbnumber?view=graph-rest-beta&preserve-view=true). + ### Identity and access | Identity and sign-in Use the [federatedTokenValidationPolicy resource type](/graph/api/resources/federatedtokenvalidationpolicy?view=graph-rest-beta&preserve-view=true) and its associated methods to manage whether Microsoft Entra ID validates federation authentication tokens. From a50362363e6949a918d4364c4464598c269727bb Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Tue, 12 Mar 2024 07:30:17 +0100 Subject: [PATCH 108/139] Update windowsupdates-knownissue.md Edit. --- .../beta/resources/windowsupdates-knownissue.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/api-reference/beta/resources/windowsupdates-knownissue.md b/api-reference/beta/resources/windowsupdates-knownissue.md index d9421259f8c..616843d6a3a 100644 --- a/api-reference/beta/resources/windowsupdates-knownissue.md +++ b/api-reference/beta/resources/windowsupdates-knownissue.md @@ -32,11 +32,11 @@ Represents a known issue related to a Windows product. For example of known issu | Member | Description | |:-------------------|:---------------------------------------------------------| -| resolved | The known issues was resolved by Microsoft. | -| mitigatedExternal | The known issue was mitigated by an external entity. | -| mitigated | The known issues was mitigated by Microsoft. | -| resolvedExternal | The known issue was resolved by an external entity. | -| confirmed | The known issue was confirmed by Microsoft. | +| resolved | Microsoft resolved the known issue. | +| mitigatedExternal | An external entity mitigated the known issue. | +| mitigated | Microsoft mitigated the known issue. | +| resolvedExternal | An external entity resolved the known issue. | +| confirmed | Microsoft confirmed the known issue. | | reported | Microsoft acknowledges that the known issue is reported. | | investigating | Microsoft is investigating the known issue. | | unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | From 2d484eaa300786522d0f57a51d11ad81e22c9e91 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Tue, 12 Mar 2024 07:31:35 +0100 Subject: [PATCH 109/139] Update windowsupdates-knownissue.md Edit. --- api-reference/beta/resources/windowsupdates-knownissue.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/windowsupdates-knownissue.md b/api-reference/beta/resources/windowsupdates-knownissue.md index 616843d6a3a..943c570d054 100644 --- a/api-reference/beta/resources/windowsupdates-knownissue.md +++ b/api-reference/beta/resources/windowsupdates-knownissue.md @@ -24,7 +24,7 @@ Represents a known issue related to a Windows product. For example of known issu |lastUpdatedDateTime|DateTimeOffset|The date and time when the known issue was last updated. 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`. Read-only.| |resolvedDateTime|DateTimeOffset| The date and time when the known issue was resolved or mitigated. 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`.| |startDateTime|DateTimeOffset|The date and time when the known issue was first reported. 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`. | -|status|[microsoft.graph.windowsUpdates.windowsReleaseHealthStatus](../resources/knownissue.md#windowsreleasehealthstatus-values)|The status of the known issue.| +|status|[microsoft.graph.windowsUpdates.windowsReleaseHealthStatus](../resources/windowsupdates-knownissue.md#windowsreleasehealthstatus-values)|The status of the known issue.| |title|String|The title of the known issue.| |webViewUrl|String|The URL to the known issue in the Windows Release Health dashboard on Microsoft 365 admin center.| From 286a1e0f051ff3b137df301f588bba96a9e2a50e Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Tue, 12 Mar 2024 07:37:05 +0100 Subject: [PATCH 110/139] Update adminwindowsupdates.md Edit. --- api-reference/beta/resources/adminwindowsupdates.md | 1 + 1 file changed, 1 insertion(+) diff --git a/api-reference/beta/resources/adminwindowsupdates.md b/api-reference/beta/resources/adminwindowsupdates.md index 472c6a5516d..8c65958d0d4 100644 --- a/api-reference/beta/resources/adminwindowsupdates.md +++ b/api-reference/beta/resources/adminwindowsupdates.md @@ -26,6 +26,7 @@ Represents an entity that acts as a container for all Windows Update for Busines |catalog|[microsoft.graph.windowsUpdates.catalog](../resources/windowsupdates-catalog.md)|Catalog of content that can be approved for deployment by the deployment service. Read-only.| |deploymentAudiences|[microsoft.graph.windowsUpdates.deploymentAudience](../resources/windowsupdates-deploymentaudience.md) collection|The set of [updatableAsset](../resources/windowsupdates-updatableasset.md) resources to which a [deployment](../resources/windowsupdates-deployment.md) can apply.| |deployments|[microsoft.graph.windowsUpdates.deployment](../resources/windowsupdates-deployment.md) collection|Deployments created using the deployment service.| +|products|[microsoft.graph.windowsUpdates.product](../resources/windowsupdates-product.md) collection|**TODO**| |resourceConnections|[microsoft.graph.windowsUpdates.resourceConnection](../resources/windowsupdates-resourceconnection.md) collection|Service connections to external resources such as analytics workspaces.| |updatableAssets|[microsoft.graph.windowsUpdates.updatableAsset](../resources/windowsupdates-updatableasset.md) collection|Assets registered with the deployment service that can receive updates.| |updatePolicies|[microsoft.graph.windowsUpdates.updatePolicy](../resources/windowsupdates-updatepolicy.md) collection|A collection of policies for approving the deployment of different content to an audience over time.| From 14886fad3affbeb023d980137b11962bf742fe4d Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Tue, 12 Mar 2024 07:39:57 +0100 Subject: [PATCH 111/139] Update Microsoft.WindowsUpdates.json Edit. --- changelog/Microsoft.WindowsUpdates.json | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/changelog/Microsoft.WindowsUpdates.json b/changelog/Microsoft.WindowsUpdates.json index d6ff2a780c8..851a4847c7a 100644 --- a/changelog/Microsoft.WindowsUpdates.json +++ b/changelog/Microsoft.WindowsUpdates.json @@ -1080,6 +1080,14 @@ "Description": "Added the **windowsReleaseHealthStatus** enumeration type.", "Target": "windowsReleaseHealthStatus" }, + { + "Id": "a6639056-8a1d-4d07-8dc0-75fefd3a6006", + "ApiChange": "Relationship", + "ChangedApiName": "products", + "ChangeType": "Addition", + "Description": "Added the **products** relationship to the [adminWindowsUpdates](https://learn.microsoft.com/en-us/graph/api/resources/adminWindowsUpdates?view=graph-rest-beta) resource.", + "Target": "adminWindowsUpdates" + }, { "Id": "a6639056-8a1d-4d07-8dc0-75fefd3a6006", "ApiChange": "Resource", From 6048221e9b46aeceab583b43d570a209d1bf70ec Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Tue, 12 Mar 2024 07:40:40 +0100 Subject: [PATCH 112/139] Update enums-windowsupdates.md Edit. --- api-reference/beta/resources/enums-windowsupdates.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/enums-windowsupdates.md b/api-reference/beta/resources/enums-windowsupdates.md index 9736152fbe5..b5ca77f2dc2 100644 --- a/api-reference/beta/resources/enums-windowsupdates.md +++ b/api-reference/beta/resources/enums-windowsupdates.md @@ -3,7 +3,7 @@ title: "Microsoft Graph Windows Updates enumeration values" description: "Microsoft Graph Windows Updates enumeration values" author: "ryan-k-williams" ms.localizationpriority: medium -ms.prod: "w10" +ms.service: "windows-update-business" doc_type: enumTypes --- From 8574a89e4068fe464d94d2d175e9184515017284 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Tue, 12 Mar 2024 21:56:19 +0100 Subject: [PATCH 113/139] Update windowsupdates-product-getknownissuesbytimerange.md Edit. --- .../windowsupdates-product-getknownissuesbytimerange.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md b/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md index 18b80951b9d..0663eb2a9a5 100644 --- a/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md +++ b/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md @@ -31,7 +31,7 @@ Choose the permission or permissions marked as least privileged for this API. Us } --> ``` http -GET /admin/windows/updates/products({id})/GetKnownIssuesByTimeRange(daysInPast={daysInPast},includeAllActive={includeAllActive}) +GET /admin/windows/updates/products/{id}/GetKnownIssuesByTimeRange(daysInPast={daysInPast},includeAllActive={includeAllActive}) ``` ## Query parameters @@ -66,11 +66,12 @@ The following example shows a request. ``` http -GET https://graph.microsoft.com/beta/admin/windows/updates/products('1')/GetKnownIssuesByTimeRange(daysInPast=70,includeAllActive=false) +GET https://graph.microsoft.com/beta/admin/windows/updates/products/1/GetKnownIssuesByTimeRange(daysInPast=70,includeAllActive=false) ``` ### Response From ce632434d359b993f50ebf7d8303ad7c7e74284c Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Tue, 12 Mar 2024 21:19:35 -0700 Subject: [PATCH 114/139] Update windowsupdates-product-getknownissuesbytimerange.md --- .../api/windowsupdates-product-getknownissuesbytimerange.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md b/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md index 0663eb2a9a5..691078bf3cf 100644 --- a/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md +++ b/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md @@ -3,7 +3,7 @@ title: "product: getKnownIssuesByTimeRange" description: "Get known issues related to a particular product based on a specified timeframe in the past." author: "skandula" ms.localizationpriority: medium -ms.service: "windows-10" +ms.service: "windows-update-business" doc_type: apiPageType --- @@ -42,7 +42,7 @@ The following table shows the parameters that must be used with this function. |Parameter|Type|Description| |:---|:---|:---| |daysInPast|Int32|The number of days to look up in the past. This filter is applied on all known issues that are in final status and have a resolved date time.| -|includeAllActive|Boolean|If set to `true` or `null`, the response includes all active known issues; otherwise, the response doesn't include any active known issues.| +|includeAllActive|Boolean|If set to `true`, the response includes all active known issues. If set to 'false', the response doesn't include any active known issues.| ## Request headers @@ -52,7 +52,7 @@ The following table shows the parameters that must be used with this function. ## Request body -Don't supply a request body for this method. +Don't supply a request body for this method. ## Response From c27e99d29ed42e4e86c078d340ebb2ac07114cf6 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Tue, 12 Mar 2024 21:21:54 -0700 Subject: [PATCH 115/139] Update windowsupdates-servicingperiod.md --- api-reference/beta/resources/windowsupdates-servicingperiod.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/api-reference/beta/resources/windowsupdates-servicingperiod.md b/api-reference/beta/resources/windowsupdates-servicingperiod.md index 5e331d7d6bb..5797c64d9a2 100644 --- a/api-reference/beta/resources/windowsupdates-servicingperiod.md +++ b/api-reference/beta/resources/windowsupdates-servicingperiod.md @@ -3,7 +3,7 @@ title: "servicingPeriod resource type" description: "Represents information about a servicing period related to a product edition." author: "skandula" ms.localizationpriority: medium -ms.service: "windows-10" +ms.service: "windows-update-business" doc_type: resourcePageType --- @@ -20,7 +20,6 @@ Represents information about a servicing period related to a product edition. Ea |Property|Type|Description| |:---|:---|:---| |endDateTime|DateTimeOffset|The date and time when the servicing period ends. 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`. Read-only.| -|id|String|The unique identifier for the servicing period. Read-only.| |name|String|The name of the servicing period. For example, `Modern Lifecycle`.| |startDateTime|DateTimeOffset|The start date and time of the servicing period. 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`. Read-only.| From 5c6016595e1bc7468aed72b9244d83aed07bc636 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Tue, 12 Mar 2024 21:22:35 -0700 Subject: [PATCH 116/139] Update windowsupdates-knownissue.md --- api-reference/beta/resources/windowsupdates-knownissue.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/windowsupdates-knownissue.md b/api-reference/beta/resources/windowsupdates-knownissue.md index 943c570d054..3cea563a462 100644 --- a/api-reference/beta/resources/windowsupdates-knownissue.md +++ b/api-reference/beta/resources/windowsupdates-knownissue.md @@ -3,7 +3,7 @@ title: "knownIssue resource type" description: "Represents a known issue related to a Windows product." author: "skandula" ms.localizationpriority: medium -ms.service: "windows-10" +ms.service: ""windows-update-business" doc_type: resourcePageType --- From 5b6b29b862c7a6828eb18002149849ac4c252b13 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Tue, 12 Mar 2024 21:24:36 -0700 Subject: [PATCH 117/139] Update windowsupdates-knownissue.md From b2aa8e50d67c9e0714e8ed669ab73930f2a2db33 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Tue, 12 Mar 2024 21:26:32 -0700 Subject: [PATCH 118/139] Update windowsupdates-product.md --- api-reference/beta/resources/windowsupdates-product.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/api-reference/beta/resources/windowsupdates-product.md b/api-reference/beta/resources/windowsupdates-product.md index acafc80d345..56a30766957 100644 --- a/api-reference/beta/resources/windowsupdates-product.md +++ b/api-reference/beta/resources/windowsupdates-product.md @@ -3,7 +3,7 @@ title: "product resource type" description: "Represents a Windows product." author: "skandula" ms.localizationpriority: medium -ms.service: "windows-10" +ms.service: "windows-update-business" doc_type: resourcePageType --- @@ -31,7 +31,6 @@ Represents a Windows product. |groupName|String|The name of the product group. For example, `Windows 11`. Read-only.| |id|String|The unique identifier for the product. Read-only.| |name|String|The name of the product. For example, `Windows 11, version 22H2`. Read-only.| -|releaseDateTime|DateTimeOffset|The release date for the content. 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`. Read-only.| ## Relationships From 14ab2d329e4d3a0acbbeb9526e43d7f70e46baa7 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Tue, 12 Mar 2024 21:34:05 -0700 Subject: [PATCH 119/139] Update windowsupdates-product-findbycatalogid.md --- .../beta/api/windowsupdates-product-findbycatalogid.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/api/windowsupdates-product-findbycatalogid.md b/api-reference/beta/api/windowsupdates-product-findbycatalogid.md index 593905076bb..986c3707b69 100644 --- a/api-reference/beta/api/windowsupdates-product-findbycatalogid.md +++ b/api-reference/beta/api/windowsupdates-product-findbycatalogid.md @@ -3,7 +3,7 @@ title: "product: findByCatalogId" description: "Find the product revisions associated with a catalog ID and the known issues directly or indirectly related to the catalog ID." author: "skandula" ms.localizationpriority: medium -ms.service: "windows-10" +ms.service: "windows-update-business" doc_type: apiPageType --- From 48e90ea49d6e61f6641efc1127fc71599582b92e Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Tue, 12 Mar 2024 21:34:26 -0700 Subject: [PATCH 120/139] Update windowsupdates-product-findbykbnumber.md --- api-reference/beta/api/windowsupdates-product-findbykbnumber.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/api/windowsupdates-product-findbykbnumber.md b/api-reference/beta/api/windowsupdates-product-findbykbnumber.md index a8a0f45bf0f..46700303c4a 100644 --- a/api-reference/beta/api/windowsupdates-product-findbykbnumber.md +++ b/api-reference/beta/api/windowsupdates-product-findbykbnumber.md @@ -3,7 +3,7 @@ title: "product: findByKbNumber" description: "Find the product revisions associated with a knowledge base number and the known issues directly or indirectly related to the knowledge base number." author: "skandula" ms.localizationpriority: medium -ms.service: "windows-10" +ms.service: "windows-update-business" doc_type: apiPageType --- From 94751b1b5030f56f6844d54a35404c857e9690d6 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Tue, 12 Mar 2024 21:43:22 -0700 Subject: [PATCH 121/139] Update windowsupdates-edition.md --- api-reference/beta/resources/windowsupdates-edition.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/windowsupdates-edition.md b/api-reference/beta/resources/windowsupdates-edition.md index 878df2b90d9..1c69b886924 100644 --- a/api-reference/beta/resources/windowsupdates-edition.md +++ b/api-reference/beta/resources/windowsupdates-edition.md @@ -3,7 +3,7 @@ title: "edition resource type" description: "Represents a specific edition of a Windows product, such as Enterprise, Core, or Education." author: "skandula" ms.localizationpriority: medium -ms.service: "windows-10" +ms.service: "windows-update-business" doc_type: resourcePageType --- From 0b76ec0ccb1829c2f6222e784ab137fbba5eec51 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Tue, 12 Mar 2024 21:44:25 -0700 Subject: [PATCH 122/139] Update windowsupdates-itembody.md --- api-reference/beta/resources/windowsupdates-itembody.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/windowsupdates-itembody.md b/api-reference/beta/resources/windowsupdates-itembody.md index 44237fedd7e..cb3abb2e26c 100644 --- a/api-reference/beta/resources/windowsupdates-itembody.md +++ b/api-reference/beta/resources/windowsupdates-itembody.md @@ -3,7 +3,7 @@ title: "itemBody resource type" description: "Represents a container for holding content and its type." ms.localizationpriority: medium author: "skandula" -ms.service: "windows-10" +ms.service: "windows-update-business" doc_type: resourcePageType --- From 4c2b9ee43de547ec0fe1bb04edb71d67336734a3 Mon Sep 17 00:00:00 2001 From: skandula1234 <160075501+skandula1234@users.noreply.github.com> Date: Tue, 12 Mar 2024 21:45:16 -0700 Subject: [PATCH 123/139] Update windowsupdates-knownissuehistoryitem.md --- .../beta/resources/windowsupdates-knownissuehistoryitem.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/windowsupdates-knownissuehistoryitem.md b/api-reference/beta/resources/windowsupdates-knownissuehistoryitem.md index 8de8632911c..c793e785915 100644 --- a/api-reference/beta/resources/windowsupdates-knownissuehistoryitem.md +++ b/api-reference/beta/resources/windowsupdates-knownissuehistoryitem.md @@ -3,7 +3,7 @@ title: "knownIssueHistoryItem resource type" description: "Represents the description text for the known issue, used to maintain historical records." author: "skandula" ms.localizationpriority: medium -ms.service: "windows-10" +ms.service: "windows-update-business" doc_type: resourcePageType --- From 9e68f1bd398b5dda32a7cce621acfd0526165f8b Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 13 Mar 2024 06:07:20 +0100 Subject: [PATCH 124/139] Update windowsupdates-product-getknownissuesbytimerange.md Edit. --- .../api/windowsupdates-product-getknownissuesbytimerange.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md b/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md index 691078bf3cf..922124f325c 100644 --- a/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md +++ b/api-reference/beta/api/windowsupdates-product-getknownissuesbytimerange.md @@ -42,7 +42,7 @@ The following table shows the parameters that must be used with this function. |Parameter|Type|Description| |:---|:---|:---| |daysInPast|Int32|The number of days to look up in the past. This filter is applied on all known issues that are in final status and have a resolved date time.| -|includeAllActive|Boolean|If set to `true`, the response includes all active known issues. If set to 'false', the response doesn't include any active known issues.| +|includeAllActive|Boolean|If set to `true`, the response includes all active known issues. If set to `false`, the response doesn't include any active known issues.| ## Request headers From 6cd4860f0889a56fdfb9305d4d75796616a07efa Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 13 Mar 2024 06:14:46 +0100 Subject: [PATCH 125/139] Update adminwindowsupdates.md Edit. --- api-reference/beta/resources/adminwindowsupdates.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/api-reference/beta/resources/adminwindowsupdates.md b/api-reference/beta/resources/adminwindowsupdates.md index 8c65958d0d4..8d91c07abea 100644 --- a/api-reference/beta/resources/adminwindowsupdates.md +++ b/api-reference/beta/resources/adminwindowsupdates.md @@ -3,7 +3,7 @@ title: "adminWindowsUpdates resource type" description: "Represents an entity that acts as a container for all Windows Update for Business deployment service functionalities." author: "ryan-k-williams" ms.localizationpriority: medium -ms.prod: "w10" +ms.service: "windows-update-business" doc_type: resourcePageType --- @@ -26,13 +26,13 @@ Represents an entity that acts as a container for all Windows Update for Busines |catalog|[microsoft.graph.windowsUpdates.catalog](../resources/windowsupdates-catalog.md)|Catalog of content that can be approved for deployment by the deployment service. Read-only.| |deploymentAudiences|[microsoft.graph.windowsUpdates.deploymentAudience](../resources/windowsupdates-deploymentaudience.md) collection|The set of [updatableAsset](../resources/windowsupdates-updatableasset.md) resources to which a [deployment](../resources/windowsupdates-deployment.md) can apply.| |deployments|[microsoft.graph.windowsUpdates.deployment](../resources/windowsupdates-deployment.md) collection|Deployments created using the deployment service.| -|products|[microsoft.graph.windowsUpdates.product](../resources/windowsupdates-product.md) collection|**TODO**| +|products|[microsoft.graph.windowsUpdates.product](../resources/windowsupdates-product.md) collection|A collection of Windows products.| |resourceConnections|[microsoft.graph.windowsUpdates.resourceConnection](../resources/windowsupdates-resourceconnection.md) collection|Service connections to external resources such as analytics workspaces.| |updatableAssets|[microsoft.graph.windowsUpdates.updatableAsset](../resources/windowsupdates-updatableasset.md) collection|Assets registered with the deployment service that can receive updates.| |updatePolicies|[microsoft.graph.windowsUpdates.updatePolicy](../resources/windowsupdates-updatepolicy.md) collection|A collection of policies for approving the deployment of different content to an audience over time.| ## JSON representation -The following is a JSON representation of the resource. +The following JSON representation shows the resource type. +[!INCLUDE [permissions-table](../includes/permissions/channel-delete-tabs-permissions.md)] > [!NOTE] > - The TeamsTab.Delete.Group and TeamsTab.ReadWrite.Group permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/beta/api/channel-delete.md b/api-reference/beta/api/channel-delete.md index 113230871e8..4899dd572a0 100644 --- a/api-reference/beta/api/channel-delete.md +++ b/api-reference/beta/api/channel-delete.md @@ -20,15 +20,10 @@ Delete the [channel](../resources/channel.md). [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. - -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | Channel.Delete.All, Group.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Channel.Delete.Group, Channel.Delete.All, Group.ReadWrite.All, Directory.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/channel-delete-permissions.md)] > [!NOTE] > - The Channel.Delete.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/beta/api/channel-get-filesfolder.md b/api-reference/beta/api/channel-get-filesfolder.md index 051a514dc22..13e5c7c1261 100644 --- a/api-reference/beta/api/channel-get-filesfolder.md +++ b/api-reference/beta/api/channel-get-filesfolder.md @@ -21,13 +21,10 @@ Get the metadata for the location where the files of a [channel](../resources/ch [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | Files.Read.All, Files.ReadWrite.All, Group.Read.All, Group.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | File.Read.Group, Files.Read.All, Files.ReadWrite.All, Group.Read.All, Group.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/channel-get-filesfolder-permissions.md)] > [!NOTE] > - The File.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/beta/api/channel-get-tabs.md b/api-reference/beta/api/channel-get-tabs.md index 8fb251da16b..9e2ded28725 100644 --- a/api-reference/beta/api/channel-get-tabs.md +++ b/api-reference/beta/api/channel-get-tabs.md @@ -18,15 +18,10 @@ Retrieve the properties and relationships of the specified [tab](../resources/te [!INCLUDE [national-cloud-support](../../includes/global-us.md)] ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. - -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | TeamsTab.Read.All, TeamsTab.ReadWriteSelfForTeam, TeamsTab.ReadWriteForTeam, TeamsTab.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | TeamsTab.Read.Group, TeamsTab.ReadWrite.Group, TeamsTab.Read.All, TeamsTab.ReadWriteSelfForTeam.All, TeamsTab.ReadWriteForTeam.All, TeamsTab.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/channel-get-tabs-permissions.md)] > [!NOTE] > - The TeamsTab.Read.Group and TeamsTab.ReadWrite.Group permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/beta/api/channel-get.md b/api-reference/beta/api/channel-get.md index 18bb2dec8dd..494ea42e0e8 100644 --- a/api-reference/beta/api/channel-get.md +++ b/api-reference/beta/api/channel-get.md @@ -21,15 +21,10 @@ This method supports federation. Only a user who is a member of the shared chann ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. - -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | ChannelSettings.Read.Group, ChannelSettings.ReadWrite.Group, Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/channel-get-permissions.md)] > [!NOTE] > - The ChannelSettings.Read.Group and ChannelSettings.ReadWrite.Group permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/beta/api/channel-list-messages.md b/api-reference/beta/api/channel-list-messages.md index 353eb8a74ac..c067f16fae5 100644 --- a/api-reference/beta/api/channel-list-messages.md +++ b/api-reference/beta/api/channel-list-messages.md @@ -25,13 +25,10 @@ This method supports federation. To list channel messages in application context ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -|Permission Type|Permissions (from least to most privileged)| -|---------|-------------| -|Delegated (work or school account)| ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All | -|Delegated (personal Microsoft account)|Not supported.| -|Application| ChannelMessage.Read.Group, ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/channel-list-messages-permissions.md)] > [!NOTE] > - The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/beta/api/channel-list-tabs.md b/api-reference/beta/api/channel-list-tabs.md index f9f0d5185b5..f77a54405cc 100644 --- a/api-reference/beta/api/channel-list-tabs.md +++ b/api-reference/beta/api/channel-list-tabs.md @@ -20,15 +20,10 @@ Retrieve the list of [tabs](../resources/teamstab.md) in the specified [channel] [!INCLUDE [national-cloud-support](../../includes/global-us.md)] ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. - -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | TeamsTab.Read.All, TeamsTab.ReadWriteSelfForTeam, TeamsTab.ReadWriteForTeam, TeamsTab.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All| -|Delegated (personal Microsoft account) | Not supported. | -|Application | TeamsTab.Read.Group, TeamsTab.ReadWrite.Group, TeamsTab.Read.All, TeamsTab.ReadWriteSelfForTeam.All, TeamsTab.ReadWriteForTeam.All, TeamsTab.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/channel-list-tabs-permissions.md)] > [!NOTE] > - The TeamsTab.Read.Group and TeamsTab.ReadWrite.Group permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/beta/api/channel-list.md b/api-reference/beta/api/channel-list.md index 7398bfb57d6..b4e5588dc70 100644 --- a/api-reference/beta/api/channel-list.md +++ b/api-reference/beta/api/channel-list.md @@ -22,15 +22,10 @@ Retrieve the list of [channels](../resources/channel.md) in this [team](../resou ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. - -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | ChannelSettings.Read.Group, ChannelSettings.ReadWrite.Group, Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/channel-list-permissions.md)] > [!NOTE] > - The ChannelSettings.Read.Group and ChannelSettings.ReadWrite.Group permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/beta/api/channel-patch-tabs.md b/api-reference/beta/api/channel-patch-tabs.md index 5ab100e8883..6e5fc5a4ce1 100644 --- a/api-reference/beta/api/channel-patch-tabs.md +++ b/api-reference/beta/api/channel-patch-tabs.md @@ -20,15 +20,10 @@ This API can be used to configure the content of the tab. [!INCLUDE [national-cloud-support](../../includes/global-us.md)] ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. - -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | TeamsTab.ReadWriteSelfForTeam, TeamsTab.ReadWriteForTeam, TeamsTab.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | TeamsTab.ReadWrite.Group, TeamsTab.ReadWriteSelfForTeam.All, TeamsTab.ReadWriteForTeam.All, TeamsTab.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/channel-patch-tabs-permissions.md)] > [!NOTE] > - The TeamsTab.ReadWrite.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/beta/api/channel-patch.md b/api-reference/beta/api/channel-patch.md index f60afcff774..70f5b75e632 100644 --- a/api-reference/beta/api/channel-patch.md +++ b/api-reference/beta/api/channel-patch.md @@ -21,15 +21,10 @@ Update the properties of the specified [channel](../resources/channel.md). ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. - -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | ChannelSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | ChannelSettings.ReadWrite.Group, ChannelSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/channel-patch-permissions.md)] > [!NOTE] > - The ChannelSettings.ReadWrite.Group permissions uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/beta/api/channel-post-tabs.md b/api-reference/beta/api/channel-post-tabs.md index 6f2834b1e3b..d117b9ec40d 100644 --- a/api-reference/beta/api/channel-post-tabs.md +++ b/api-reference/beta/api/channel-post-tabs.md @@ -19,15 +19,10 @@ Add (pin) a [tab](../resources/teamstab.md) to the specified [channel](../resour ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. - -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | TeamsTab.Create, TeamsTab.ReadWriteSelfForTeam, TeamsTab.ReadWriteForTeam, TeamsTab.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -| Application | TeamsTab.Create.Group, TeamsTab.Create, TeamsTab.ReadWriteSelfForTeam.All, TeamsTab.ReadWriteForTeam.All, TeamsTab.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/channel-post-tabs-permissions.md)] > [!NOTE] > - The TeamsTab.Create.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/beta/api/channel-post.md b/api-reference/beta/api/channel-post.md index ac286192947..1cc9f79df77 100644 --- a/api-reference/beta/api/channel-post.md +++ b/api-reference/beta/api/channel-post.md @@ -26,15 +26,10 @@ You can add a maximum of 200 members when you create a private channel. ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. - -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | Channel.Create, Group.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Channel.Create.Group, Channel.Create, Teamwork.Migrate.All, Group.ReadWrite.All, Directory.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/channel-post-permissions.md)] > [!NOTE] > - The Channel.Create.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/beta/api/chatmessage-delta.md b/api-reference/beta/api/chatmessage-delta.md index 64d9398cd52..d17b2132887 100644 --- a/api-reference/beta/api/chatmessage-delta.md +++ b/api-reference/beta/api/chatmessage-delta.md @@ -34,13 +34,10 @@ For more information, see the [delta query](/graph/delta-query-overview) documen ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -|Permission Type |Permissions (from least to most privileged) | -|---------------------------------------|---------------------------------------------| -|Delegated (work or school account) | ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All | -|Delegated (personal Microsoft account) | Not Supported | -|Application | ChannelMessage.Read.Group, ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/chatmessage-delta-permissions.md)] > [!NOTE] > - The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/beta/api/team-archive.md b/api-reference/beta/api/team-archive.md index 7782c29c4c0..508aaade4f7 100644 --- a/api-reference/beta/api/team-archive.md +++ b/api-reference/beta/api/team-archive.md @@ -25,15 +25,10 @@ To restore a team from its archived state, use the API to [unarchive](team-unarc [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. - -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | TeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | TeamSettings.ReadWrite.Group, TeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/team-archive-permissions.md)] > [!NOTE] > - The TeamSettings.ReadWrite.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/beta/api/team-get.md b/api-reference/beta/api/team-get.md index d1126036abb..a64b19d7896 100644 --- a/api-reference/beta/api/team-get.md +++ b/api-reference/beta/api/team-get.md @@ -18,15 +18,10 @@ Retrieve the properties and relationships of the specified [team](../resources/t [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. - -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | TeamSettings.Read.Group, TeamSettings.ReadWrite.Group, Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/team-get-permissions.md)] > [!NOTE] > - The TeamSettings.Read.Group and TeamSettings.ReadWrite.Group permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/beta/api/team-unarchive.md b/api-reference/beta/api/team-unarchive.md index 05073698876..1c44cbb430e 100644 --- a/api-reference/beta/api/team-unarchive.md +++ b/api-reference/beta/api/team-unarchive.md @@ -20,15 +20,10 @@ Unarchiving is an async operation. A team is unarchived once the async operation [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. - -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | TeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | TeamSettings.ReadWrite.Group, TeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/team-unarchive-permissions.md)] > [!NOTE] > - The TeamSettings.ReadWrite.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/beta/api/team-update.md b/api-reference/beta/api/team-update.md index 9784e48b573..22367a73298 100644 --- a/api-reference/beta/api/team-update.md +++ b/api-reference/beta/api/team-update.md @@ -18,15 +18,10 @@ Update the properties of the specified [team](../resources/team.md). [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. - -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | TeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | TeamSettings.ReadWrite.Group, TeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/team-update-permissions.md)] > [!NOTE] > - The TeamSettings.ReadWrite.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/beta/includes/permissions/channel-delete-permissions.md b/api-reference/beta/includes/permissions/channel-delete-permissions.md new file mode 100644 index 00000000000..ae1b77da2af --- /dev/null +++ b/api-reference/beta/includes/permissions/channel-delete-permissions.md @@ -0,0 +1,12 @@ +--- +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)|Channel.Delete.All|Directory.ReadWrite.All, Group.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Channel.Delete.Group|Channel.Delete.All, Directory.ReadWrite.All, Group.ReadWrite.All| + diff --git a/api-reference/beta/includes/permissions/channel-delete-tabs-permissions.md b/api-reference/beta/includes/permissions/channel-delete-tabs-permissions.md new file mode 100644 index 00000000000..2c861d27b44 --- /dev/null +++ b/api-reference/beta/includes/permissions/channel-delete-tabs-permissions.md @@ -0,0 +1,12 @@ +--- +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)|TeamsTab.ReadWriteSelfForTeam|Directory.ReadWrite.All, Group.ReadWrite.All, TeamsTab.ReadWrite.All, TeamsTab.ReadWriteForTeam| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|TeamsTab.Delete.Group|TeamsTab.ReadWrite.Group, Directory.ReadWrite.All, Group.ReadWrite.All, TeamsTab.ReadWrite.All, TeamsTab.ReadWriteForTeam.All, TeamsTab.ReadWriteSelfForTeam.All| + diff --git a/api-reference/beta/includes/permissions/channel-get-filesfolder-permissions.md b/api-reference/beta/includes/permissions/channel-get-filesfolder-permissions.md new file mode 100644 index 00000000000..7f76ee0f3f8 --- /dev/null +++ b/api-reference/beta/includes/permissions/channel-get-filesfolder-permissions.md @@ -0,0 +1,12 @@ +--- +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)|Files.Read.All|Files.Read, Files.ReadWrite, Files.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All| +|Delegated (personal Microsoft account)|Files.Read|Files.Read.All, Files.ReadWrite, Files.ReadWrite.All| +|Application|Files.Read.All|File.Read.Group, Files.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All| + diff --git a/api-reference/beta/includes/permissions/channel-get-permissions.md b/api-reference/beta/includes/permissions/channel-get-permissions.md new file mode 100644 index 00000000000..6d16327555f --- /dev/null +++ b/api-reference/beta/includes/permissions/channel-get-permissions.md @@ -0,0 +1,12 @@ +--- +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)|Channel.ReadBasic.All|ChannelSettings.ReadWrite.All, ChannelSettings.Read.All, Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|ChannelSettings.Read.Group|ChannelSettings.ReadWrite.Group, Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All| + diff --git a/api-reference/beta/includes/permissions/channel-get-tabs-permissions.md b/api-reference/beta/includes/permissions/channel-get-tabs-permissions.md new file mode 100644 index 00000000000..c55621e43b5 --- /dev/null +++ b/api-reference/beta/includes/permissions/channel-get-tabs-permissions.md @@ -0,0 +1,12 @@ +--- +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)|TeamsTab.Read.All|TeamsTab.ReadWriteSelfForTeam, Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, TeamsTab.ReadWrite.All, TeamsTab.ReadWriteForTeam| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|TeamsTab.Read.Group|TeamsTab.ReadWrite.Group, Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, TeamsTab.Read.All, TeamsTab.ReadWrite.All, TeamsTab.ReadWriteForTeam.All, TeamsTab.ReadWriteSelfForTeam.All| + diff --git a/api-reference/beta/includes/permissions/channel-list-messages-permissions.md b/api-reference/beta/includes/permissions/channel-list-messages-permissions.md new file mode 100644 index 00000000000..c6b5612f84d --- /dev/null +++ b/api-reference/beta/includes/permissions/channel-list-messages-permissions.md @@ -0,0 +1,12 @@ +--- +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)|ChannelMessage.Read.All|Group.Read.All, Group.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|ChannelMessage.Read.Group|ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All| + diff --git a/api-reference/beta/includes/permissions/channel-list-permissions.md b/api-reference/beta/includes/permissions/channel-list-permissions.md new file mode 100644 index 00000000000..ef19888dee0 --- /dev/null +++ b/api-reference/beta/includes/permissions/channel-list-permissions.md @@ -0,0 +1,12 @@ +--- +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)|Channel.ReadBasic.All|ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|ChannelSettings.Read.Group|Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, ChannelSettings.ReadWrite.Group, Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All| + diff --git a/api-reference/beta/includes/permissions/channel-list-tabs-permissions.md b/api-reference/beta/includes/permissions/channel-list-tabs-permissions.md new file mode 100644 index 00000000000..8819f1b7b85 --- /dev/null +++ b/api-reference/beta/includes/permissions/channel-list-tabs-permissions.md @@ -0,0 +1,12 @@ +--- +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)|TeamsTab.Read.All|Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, TeamsTab.ReadWrite.All, TeamsTab.ReadWriteForTeam, TeamsTab.ReadWriteSelfForTeam| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|TeamsTab.Read.Group|Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, TeamsTab.Read.All, TeamsTab.ReadWrite.All, TeamsTab.ReadWrite.Group, TeamsTab.ReadWriteForTeam.All, TeamsTab.ReadWriteSelfForTeam.All| + diff --git a/api-reference/beta/includes/permissions/channel-patch-permissions.md b/api-reference/beta/includes/permissions/channel-patch-permissions.md new file mode 100644 index 00000000000..17be294c3af --- /dev/null +++ b/api-reference/beta/includes/permissions/channel-patch-permissions.md @@ -0,0 +1,12 @@ +--- +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)|ChannelSettings.ReadWrite.All|Directory.ReadWrite.All, Group.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|ChannelSettings.ReadWrite.Group|ChannelSettings.ReadWrite.All, Directory.ReadWrite.All, Group.ReadWrite.All| + diff --git a/api-reference/beta/includes/permissions/channel-patch-tabs-permissions.md b/api-reference/beta/includes/permissions/channel-patch-tabs-permissions.md new file mode 100644 index 00000000000..26f743e843a --- /dev/null +++ b/api-reference/beta/includes/permissions/channel-patch-tabs-permissions.md @@ -0,0 +1,12 @@ +--- +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)|TeamsTab.ReadWriteSelfForTeam|Directory.ReadWrite.All, Group.ReadWrite.All, TeamsTab.ReadWrite.All, TeamsTab.ReadWriteForTeam| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|TeamsTab.ReadWrite.Group|Directory.ReadWrite.All, Group.ReadWrite.All, TeamsTab.ReadWrite.All, TeamsTab.ReadWriteForTeam.All, TeamsTab.ReadWriteSelfForTeam.All| + diff --git a/api-reference/beta/includes/permissions/channel-post-permissions.md b/api-reference/beta/includes/permissions/channel-post-permissions.md new file mode 100644 index 00000000000..53de9b0f7ff --- /dev/null +++ b/api-reference/beta/includes/permissions/channel-post-permissions.md @@ -0,0 +1,12 @@ +--- +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)|Channel.Create|Directory.ReadWrite.All, Group.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Channel.Create.Group|Channel.Create, Directory.ReadWrite.All, Group.ReadWrite.All, Teamwork.Migrate.All| + diff --git a/api-reference/beta/includes/permissions/channel-post-tabs-permissions.md b/api-reference/beta/includes/permissions/channel-post-tabs-permissions.md new file mode 100644 index 00000000000..5edef72319b --- /dev/null +++ b/api-reference/beta/includes/permissions/channel-post-tabs-permissions.md @@ -0,0 +1,12 @@ +--- +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)|TeamsTab.Create|Directory.ReadWrite.All, Group.ReadWrite.All, TeamsTab.ReadWrite.All, TeamsTab.ReadWriteForTeam, TeamsTab.ReadWriteSelfForTeam| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|TeamsTab.Create.Group|Directory.ReadWrite.All, Group.ReadWrite.All, TeamsTab.Create, TeamsTab.ReadWrite.All, TeamsTab.ReadWriteForTeam.All, TeamsTab.ReadWriteSelfForTeam.All| + diff --git a/api-reference/beta/includes/permissions/chatmessage-delta-permissions.md b/api-reference/beta/includes/permissions/chatmessage-delta-permissions.md new file mode 100644 index 00000000000..c6b5612f84d --- /dev/null +++ b/api-reference/beta/includes/permissions/chatmessage-delta-permissions.md @@ -0,0 +1,12 @@ +--- +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)|ChannelMessage.Read.All|Group.Read.All, Group.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|ChannelMessage.Read.Group|ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All| + diff --git a/api-reference/beta/includes/permissions/team-archive-permissions.md b/api-reference/beta/includes/permissions/team-archive-permissions.md new file mode 100644 index 00000000000..30aa10a3b72 --- /dev/null +++ b/api-reference/beta/includes/permissions/team-archive-permissions.md @@ -0,0 +1,12 @@ +--- +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)|TeamSettings.ReadWrite.All|Directory.ReadWrite.All, Group.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|TeamSettings.ReadWrite.Group|Directory.ReadWrite.All, Group.ReadWrite.All, TeamSettings.ReadWrite.All| + diff --git a/api-reference/beta/includes/permissions/team-get-permissions.md b/api-reference/beta/includes/permissions/team-get-permissions.md new file mode 100644 index 00000000000..781ec0e1ba2 --- /dev/null +++ b/api-reference/beta/includes/permissions/team-get-permissions.md @@ -0,0 +1,12 @@ +--- +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)|Team.ReadBasic.All|TeamSettings.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, TeamSettings.Read.All| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|TeamSettings.Read.Group|TeamSettings.ReadWrite.Group, Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All| + diff --git a/api-reference/beta/includes/permissions/team-unarchive-permissions.md b/api-reference/beta/includes/permissions/team-unarchive-permissions.md new file mode 100644 index 00000000000..30aa10a3b72 --- /dev/null +++ b/api-reference/beta/includes/permissions/team-unarchive-permissions.md @@ -0,0 +1,12 @@ +--- +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)|TeamSettings.ReadWrite.All|Directory.ReadWrite.All, Group.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|TeamSettings.ReadWrite.Group|Directory.ReadWrite.All, Group.ReadWrite.All, TeamSettings.ReadWrite.All| + diff --git a/api-reference/beta/includes/permissions/team-update-permissions.md b/api-reference/beta/includes/permissions/team-update-permissions.md new file mode 100644 index 00000000000..30aa10a3b72 --- /dev/null +++ b/api-reference/beta/includes/permissions/team-update-permissions.md @@ -0,0 +1,12 @@ +--- +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)|TeamSettings.ReadWrite.All|Directory.ReadWrite.All, Group.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|TeamSettings.ReadWrite.Group|Directory.ReadWrite.All, Group.ReadWrite.All, TeamSettings.ReadWrite.All| + diff --git a/api-reference/v1.0/api/channel-delete-tabs.md b/api-reference/v1.0/api/channel-delete-tabs.md index 8515a780719..b1641720d70 100644 --- a/api-reference/v1.0/api/channel-delete-tabs.md +++ b/api-reference/v1.0/api/channel-delete-tabs.md @@ -18,15 +18,10 @@ Removes (unpins) a tab from the specified [channel](../resources/channel.md) wit [!INCLUDE [national-cloud-support](../../includes/global-us.md)] ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. - -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | TeamsTab.ReadWriteSelfForTeam, TeamsTab.ReadWriteForTeam, TeamsTab.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | TeamsTab.Delete.Group, TeamsTab.ReadWrite.Group, TeamsTab.ReadWriteSelfForTeam.All, TeamsTab.ReadWriteForTeam.All, TeamsTab.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/channel-delete-tabs-permissions.md)] > [!NOTE] > - The TeamsTab.Delete.Group and TeamsTab.ReadWrite.Group permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/v1.0/api/channel-delete.md b/api-reference/v1.0/api/channel-delete.md index 606a1fb4211..aeb1f3a9c87 100644 --- a/api-reference/v1.0/api/channel-delete.md +++ b/api-reference/v1.0/api/channel-delete.md @@ -19,15 +19,10 @@ Delete the [channel](../resources/channel.md). ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. - -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | Channel.Delete.All, Group.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Channel.Delete.Group, Channel.Delete.All, Group.ReadWrite.All, Directory.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/channel-delete-permissions.md)] > [!NOTE] > - The Channel.Delete.Group permissions uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/v1.0/api/channel-get-tabs.md b/api-reference/v1.0/api/channel-get-tabs.md index 0dbcf181115..3b1c173d70d 100644 --- a/api-reference/v1.0/api/channel-get-tabs.md +++ b/api-reference/v1.0/api/channel-get-tabs.md @@ -16,15 +16,10 @@ Retrieve the properties and relationships of the specified [tab](../resources/te [!INCLUDE [national-cloud-support](../../includes/global-us.md)] ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. - -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | TeamsTab.Read.All, TeamsTab.ReadWriteSelfForTeam, TeamsTab.ReadWriteForTeam, TeamsTab.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | TeamsTab.Read.Group, TeamsTab.ReadWrite.Group, TeamsTab.Read.All, TeamsTab.ReadWriteSelfForTeam.All, TeamsTab.ReadWriteForTeam.All, TeamsTab.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/channel-get-tabs-permissions.md)] > [!NOTE] > - The TeamsTab.Read.Group and TeamsTab.ReadWrite.Group permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/v1.0/api/channel-get.md b/api-reference/v1.0/api/channel-get.md index 556e0b55eca..3ee53f679da 100644 --- a/api-reference/v1.0/api/channel-get.md +++ b/api-reference/v1.0/api/channel-get.md @@ -19,15 +19,10 @@ This method supports federation. Only a user who is a member of the shared chann ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. - -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | ChannelSettings.Read.Group, ChannelSettings.ReadWrite.Group, Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/channel-get-permissions.md)] > [!NOTE] > - The ChannelSettings.Read.Group and ChannelSettings.ReadWrite.Group permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/v1.0/api/channel-list-tabs.md b/api-reference/v1.0/api/channel-list-tabs.md index 084976679ad..ff6059169e7 100644 --- a/api-reference/v1.0/api/channel-list-tabs.md +++ b/api-reference/v1.0/api/channel-list-tabs.md @@ -19,15 +19,10 @@ Retrieve the list of [tabs](../resources/teamstab.md) in the specified [channel] [!INCLUDE [national-cloud-support](../../includes/global-us.md)] ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. - -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | TeamsTab.Read.All, TeamsTab.ReadWriteSelfForTeam, TeamsTab.ReadWriteForTeam, TeamsTab.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | TeamsTab.Read.Group, TeamsTab.ReadWrite.Group, TeamsTab.Read.All, TeamsTab.ReadWriteSelfForTeam.All, TeamsTab.ReadWriteForTeam.All, TeamsTab.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/channel-list-tabs-permissions.md)] > [!NOTE] > - The TeamsTab.Read.Group and TeamsTab.ReadWrite.Group permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/v1.0/api/channel-list.md b/api-reference/v1.0/api/channel-list.md index 99bbff55904..ef2b3f2fbe3 100644 --- a/api-reference/v1.0/api/channel-list.md +++ b/api-reference/v1.0/api/channel-list.md @@ -20,15 +20,10 @@ Retrieve the list of [channels](../resources/channel.md) in this [team](../resou ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. - -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | ChannelSettings.Read.Group, ChannelSettings.ReadWrite.Group, Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/channel-list-permissions.md)] > [!NOTE] > - The ChannelSettings.Read.Group and ChannelSettings.ReadWrite.Group permissions use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/v1.0/api/channel-patch-tabs.md b/api-reference/v1.0/api/channel-patch-tabs.md index e02e8df868f..24e85a5cf6b 100644 --- a/api-reference/v1.0/api/channel-patch-tabs.md +++ b/api-reference/v1.0/api/channel-patch-tabs.md @@ -18,16 +18,11 @@ This API can be used to configure the content of the tab. [!INCLUDE [national-cloud-support](../../includes/global-us.md)] ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. - -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | TeamsTab.ReadWriteSelfForTeam, TeamsTab.ReadWriteForTeam, TeamsTab.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | TeamsTab.ReadWrite.Group, TeamsTab.ReadWriteSelfForTeam.All, TeamsTab.ReadWriteForTeam.All, TeamsTab.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/channel-patch-tabs-permissions.md)] > [!NOTE] > - The TeamsTab.ReadWrite.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/v1.0/api/channel-patch.md b/api-reference/v1.0/api/channel-patch.md index 0fe721a266f..8d3a821521b 100644 --- a/api-reference/v1.0/api/channel-patch.md +++ b/api-reference/v1.0/api/channel-patch.md @@ -19,15 +19,10 @@ Update the properties of the specified [channel](../resources/channel.md). ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. - -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | ChannelSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | ChannelSettings.ReadWrite.Group, ChannelSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/channel-patch-permissions.md)] > [!NOTE] > - The ChannelSettings.ReadWrite.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/v1.0/api/channel-post-tabs.md b/api-reference/v1.0/api/channel-post-tabs.md index 0b39b41c559..6e49581dbbe 100644 --- a/api-reference/v1.0/api/channel-post-tabs.md +++ b/api-reference/v1.0/api/channel-post-tabs.md @@ -17,15 +17,10 @@ Add (pin) a [tab](../resources/teamstab.md) to the specified [channel](../resour ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. - -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | TeamsTab.Create, TeamsTab.ReadWriteSelfForTeam, TeamsTab.ReadWriteForTeam, TeamsTab.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -| Application | TeamsTab.Create.Group, TeamsTab.Create, TeamsTab.ReadWriteSelfForTeam.All, TeamsTab.ReadWriteForTeam.All, TeamsTab.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/channel-post-tabs-permissions.md)] > [!NOTE] > - The TeamsTab.Create.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/v1.0/api/team-archive.md b/api-reference/v1.0/api/team-archive.md index ee146fd2ee8..f7d472715af 100644 --- a/api-reference/v1.0/api/team-archive.md +++ b/api-reference/v1.0/api/team-archive.md @@ -23,15 +23,10 @@ To restore a team from its archived state, use the API to [unarchive](team-unarc [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. - -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | TeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | TeamSettings.ReadWrite.Group, TeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/team-archive-permissions.md)] > [!NOTE] > - The TeamSettings.ReadWrite.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/v1.0/api/team-get.md b/api-reference/v1.0/api/team-get.md index f437ea0f8a3..c2c88bfedb2 100644 --- a/api-reference/v1.0/api/team-get.md +++ b/api-reference/v1.0/api/team-get.md @@ -18,15 +18,10 @@ Retrieve the properties and relationships of the specified [team](../resources/t [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. - -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | TeamSettings.Read.Group, TeamSettings.ReadWrite.Group, Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/team-get-permissions.md)] > [!NOTE] > - The TeamSettings.Read.Group and TeamSettings.ReadWrite.Group permission use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/v1.0/api/team-unarchive.md b/api-reference/v1.0/api/team-unarchive.md index 845ba6c1a3f..61d28df7034 100644 --- a/api-reference/v1.0/api/team-unarchive.md +++ b/api-reference/v1.0/api/team-unarchive.md @@ -20,15 +20,10 @@ Unarchiving is an async operation. A team is unarchived once the async operation [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. - -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | TeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | TeamSettings.ReadWrite.Group, TeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/team-unarchive-permissions.md)] > [!NOTE] > - The TeamSettings.ReadWrite.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/v1.0/api/team-update.md b/api-reference/v1.0/api/team-update.md index 4f4197db61b..71623e91d02 100644 --- a/api-reference/v1.0/api/team-update.md +++ b/api-reference/v1.0/api/team-update.md @@ -18,15 +18,10 @@ Update the properties of the specified [team](../resources/team.md). [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. - -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | TeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | TeamSettings.ReadWrite.Group, TeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | + +[!INCLUDE [permissions-table](../includes/permissions/team-update-permissions.md)] > [!NOTE] > - The TeamSettings.ReadWrite.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). diff --git a/api-reference/v1.0/includes/permissions/channel-delete-permissions.md b/api-reference/v1.0/includes/permissions/channel-delete-permissions.md new file mode 100644 index 00000000000..ae1b77da2af --- /dev/null +++ b/api-reference/v1.0/includes/permissions/channel-delete-permissions.md @@ -0,0 +1,12 @@ +--- +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)|Channel.Delete.All|Directory.ReadWrite.All, Group.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Channel.Delete.Group|Channel.Delete.All, Directory.ReadWrite.All, Group.ReadWrite.All| + diff --git a/api-reference/v1.0/includes/permissions/channel-delete-tabs-permissions.md b/api-reference/v1.0/includes/permissions/channel-delete-tabs-permissions.md new file mode 100644 index 00000000000..2c861d27b44 --- /dev/null +++ b/api-reference/v1.0/includes/permissions/channel-delete-tabs-permissions.md @@ -0,0 +1,12 @@ +--- +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)|TeamsTab.ReadWriteSelfForTeam|Directory.ReadWrite.All, Group.ReadWrite.All, TeamsTab.ReadWrite.All, TeamsTab.ReadWriteForTeam| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|TeamsTab.Delete.Group|TeamsTab.ReadWrite.Group, Directory.ReadWrite.All, Group.ReadWrite.All, TeamsTab.ReadWrite.All, TeamsTab.ReadWriteForTeam.All, TeamsTab.ReadWriteSelfForTeam.All| + diff --git a/api-reference/v1.0/includes/permissions/channel-get-permissions.md b/api-reference/v1.0/includes/permissions/channel-get-permissions.md new file mode 100644 index 00000000000..6d16327555f --- /dev/null +++ b/api-reference/v1.0/includes/permissions/channel-get-permissions.md @@ -0,0 +1,12 @@ +--- +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)|Channel.ReadBasic.All|ChannelSettings.ReadWrite.All, ChannelSettings.Read.All, Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|ChannelSettings.Read.Group|ChannelSettings.ReadWrite.Group, Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All| + diff --git a/api-reference/v1.0/includes/permissions/channel-get-tabs-permissions.md b/api-reference/v1.0/includes/permissions/channel-get-tabs-permissions.md new file mode 100644 index 00000000000..c55621e43b5 --- /dev/null +++ b/api-reference/v1.0/includes/permissions/channel-get-tabs-permissions.md @@ -0,0 +1,12 @@ +--- +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)|TeamsTab.Read.All|TeamsTab.ReadWriteSelfForTeam, Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, TeamsTab.ReadWrite.All, TeamsTab.ReadWriteForTeam| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|TeamsTab.Read.Group|TeamsTab.ReadWrite.Group, Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, TeamsTab.Read.All, TeamsTab.ReadWrite.All, TeamsTab.ReadWriteForTeam.All, TeamsTab.ReadWriteSelfForTeam.All| + diff --git a/api-reference/v1.0/includes/permissions/channel-list-permissions.md b/api-reference/v1.0/includes/permissions/channel-list-permissions.md new file mode 100644 index 00000000000..ef19888dee0 --- /dev/null +++ b/api-reference/v1.0/includes/permissions/channel-list-permissions.md @@ -0,0 +1,12 @@ +--- +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)|Channel.ReadBasic.All|ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|ChannelSettings.Read.Group|Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, ChannelSettings.ReadWrite.Group, Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All| + diff --git a/api-reference/v1.0/includes/permissions/channel-list-tabs-permissions.md b/api-reference/v1.0/includes/permissions/channel-list-tabs-permissions.md new file mode 100644 index 00000000000..8819f1b7b85 --- /dev/null +++ b/api-reference/v1.0/includes/permissions/channel-list-tabs-permissions.md @@ -0,0 +1,12 @@ +--- +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)|TeamsTab.Read.All|Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, TeamsTab.ReadWrite.All, TeamsTab.ReadWriteForTeam, TeamsTab.ReadWriteSelfForTeam| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|TeamsTab.Read.Group|Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, TeamsTab.Read.All, TeamsTab.ReadWrite.All, TeamsTab.ReadWrite.Group, TeamsTab.ReadWriteForTeam.All, TeamsTab.ReadWriteSelfForTeam.All| + diff --git a/api-reference/v1.0/includes/permissions/channel-patch-permissions.md b/api-reference/v1.0/includes/permissions/channel-patch-permissions.md new file mode 100644 index 00000000000..17be294c3af --- /dev/null +++ b/api-reference/v1.0/includes/permissions/channel-patch-permissions.md @@ -0,0 +1,12 @@ +--- +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)|ChannelSettings.ReadWrite.All|Directory.ReadWrite.All, Group.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|ChannelSettings.ReadWrite.Group|ChannelSettings.ReadWrite.All, Directory.ReadWrite.All, Group.ReadWrite.All| + diff --git a/api-reference/v1.0/includes/permissions/channel-patch-tabs-permissions.md b/api-reference/v1.0/includes/permissions/channel-patch-tabs-permissions.md new file mode 100644 index 00000000000..26f743e843a --- /dev/null +++ b/api-reference/v1.0/includes/permissions/channel-patch-tabs-permissions.md @@ -0,0 +1,12 @@ +--- +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)|TeamsTab.ReadWriteSelfForTeam|Directory.ReadWrite.All, Group.ReadWrite.All, TeamsTab.ReadWrite.All, TeamsTab.ReadWriteForTeam| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|TeamsTab.ReadWrite.Group|Directory.ReadWrite.All, Group.ReadWrite.All, TeamsTab.ReadWrite.All, TeamsTab.ReadWriteForTeam.All, TeamsTab.ReadWriteSelfForTeam.All| + diff --git a/api-reference/v1.0/includes/permissions/channel-post-tabs-permissions.md b/api-reference/v1.0/includes/permissions/channel-post-tabs-permissions.md new file mode 100644 index 00000000000..5edef72319b --- /dev/null +++ b/api-reference/v1.0/includes/permissions/channel-post-tabs-permissions.md @@ -0,0 +1,12 @@ +--- +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)|TeamsTab.Create|Directory.ReadWrite.All, Group.ReadWrite.All, TeamsTab.ReadWrite.All, TeamsTab.ReadWriteForTeam, TeamsTab.ReadWriteSelfForTeam| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|TeamsTab.Create.Group|Directory.ReadWrite.All, Group.ReadWrite.All, TeamsTab.Create, TeamsTab.ReadWrite.All, TeamsTab.ReadWriteForTeam.All, TeamsTab.ReadWriteSelfForTeam.All| + diff --git a/api-reference/v1.0/includes/permissions/team-archive-permissions.md b/api-reference/v1.0/includes/permissions/team-archive-permissions.md new file mode 100644 index 00000000000..30aa10a3b72 --- /dev/null +++ b/api-reference/v1.0/includes/permissions/team-archive-permissions.md @@ -0,0 +1,12 @@ +--- +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)|TeamSettings.ReadWrite.All|Directory.ReadWrite.All, Group.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|TeamSettings.ReadWrite.Group|Directory.ReadWrite.All, Group.ReadWrite.All, TeamSettings.ReadWrite.All| + diff --git a/api-reference/v1.0/includes/permissions/team-get-permissions.md b/api-reference/v1.0/includes/permissions/team-get-permissions.md new file mode 100644 index 00000000000..781ec0e1ba2 --- /dev/null +++ b/api-reference/v1.0/includes/permissions/team-get-permissions.md @@ -0,0 +1,12 @@ +--- +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)|Team.ReadBasic.All|TeamSettings.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, TeamSettings.Read.All| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|TeamSettings.Read.Group|TeamSettings.ReadWrite.Group, Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All| + diff --git a/api-reference/v1.0/includes/permissions/team-unarchive-permissions.md b/api-reference/v1.0/includes/permissions/team-unarchive-permissions.md new file mode 100644 index 00000000000..30aa10a3b72 --- /dev/null +++ b/api-reference/v1.0/includes/permissions/team-unarchive-permissions.md @@ -0,0 +1,12 @@ +--- +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)|TeamSettings.ReadWrite.All|Directory.ReadWrite.All, Group.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|TeamSettings.ReadWrite.Group|Directory.ReadWrite.All, Group.ReadWrite.All, TeamSettings.ReadWrite.All| + diff --git a/api-reference/v1.0/includes/permissions/team-update-permissions.md b/api-reference/v1.0/includes/permissions/team-update-permissions.md new file mode 100644 index 00000000000..30aa10a3b72 --- /dev/null +++ b/api-reference/v1.0/includes/permissions/team-update-permissions.md @@ -0,0 +1,12 @@ +--- +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)|TeamSettings.ReadWrite.All|Directory.ReadWrite.All, Group.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|TeamSettings.ReadWrite.Group|Directory.ReadWrite.All, Group.ReadWrite.All, TeamSettings.ReadWrite.All| + From d40598126ad6953c2b3eb4cb3c580f69c4fd5936 Mon Sep 17 00:00:00 2001 From: Millicent Achieng Date: Tue, 19 Mar 2024 14:52:52 +0300 Subject: [PATCH 129/139] Apply suggestions from code review --- api-reference/beta/api/channel-delete-tabs.md | 2 ++ api-reference/beta/api/channel-delete.md | 2 ++ api-reference/beta/api/channel-get-tabs.md | 2 ++ api-reference/beta/api/channel-get.md | 2 ++ api-reference/beta/api/channel-list-tabs.md | 2 ++ api-reference/beta/api/channel-list.md | 2 ++ api-reference/beta/api/channel-patch-tabs.md | 2 ++ api-reference/beta/api/channel-patch.md | 2 ++ api-reference/beta/api/channel-post-tabs.md | 2 ++ api-reference/beta/api/channel-post.md | 2 ++ api-reference/beta/api/team-archive.md | 2 ++ api-reference/beta/api/team-get.md | 2 ++ api-reference/beta/api/team-unarchive.md | 2 ++ api-reference/beta/api/team-update.md | 2 ++ api-reference/v1.0/api/channel-delete-tabs.md | 2 ++ api-reference/v1.0/api/channel-delete.md | 2 ++ api-reference/v1.0/api/channel-get-tabs.md | 2 ++ api-reference/v1.0/api/channel-get.md | 2 ++ api-reference/v1.0/api/channel-list-tabs.md | 2 ++ api-reference/v1.0/api/channel-list.md | 2 ++ api-reference/v1.0/api/channel-patch-tabs.md | 2 ++ api-reference/v1.0/api/channel-patch.md | 2 ++ api-reference/v1.0/api/channel-post-tabs.md | 2 ++ api-reference/v1.0/api/team-archive.md | 2 ++ api-reference/v1.0/api/team-get.md | 2 ++ api-reference/v1.0/api/team-unarchive.md | 2 ++ api-reference/v1.0/api/team-update.md | 2 ++ 27 files changed, 54 insertions(+) diff --git a/api-reference/beta/api/channel-delete-tabs.md b/api-reference/beta/api/channel-delete-tabs.md index 7036edfdb9b..ead2a45cca9 100644 --- a/api-reference/beta/api/channel-delete-tabs.md +++ b/api-reference/beta/api/channel-delete-tabs.md @@ -20,6 +20,8 @@ Removes (unpins) a tab from the specified [channel](../resources/channel.md) wit ## 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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/channel-delete-tabs-permissions.md)] diff --git a/api-reference/beta/api/channel-delete.md b/api-reference/beta/api/channel-delete.md index 4899dd572a0..767abba8a48 100644 --- a/api-reference/beta/api/channel-delete.md +++ b/api-reference/beta/api/channel-delete.md @@ -22,6 +22,8 @@ Delete the [channel](../resources/channel.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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/channel-delete-permissions.md)] diff --git a/api-reference/beta/api/channel-get-tabs.md b/api-reference/beta/api/channel-get-tabs.md index 9e2ded28725..4cc3045808c 100644 --- a/api-reference/beta/api/channel-get-tabs.md +++ b/api-reference/beta/api/channel-get-tabs.md @@ -20,6 +20,8 @@ Retrieve the properties and relationships of the specified [tab](../resources/te ## 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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/channel-get-tabs-permissions.md)] diff --git a/api-reference/beta/api/channel-get.md b/api-reference/beta/api/channel-get.md index 494ea42e0e8..36147811038 100644 --- a/api-reference/beta/api/channel-get.md +++ b/api-reference/beta/api/channel-get.md @@ -23,6 +23,8 @@ This method supports federation. Only a user who is a member of the shared chann 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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/channel-get-permissions.md)] diff --git a/api-reference/beta/api/channel-list-tabs.md b/api-reference/beta/api/channel-list-tabs.md index f77a54405cc..04e13fd4d12 100644 --- a/api-reference/beta/api/channel-list-tabs.md +++ b/api-reference/beta/api/channel-list-tabs.md @@ -22,6 +22,8 @@ Retrieve the list of [tabs](../resources/teamstab.md) in the specified [channel] ## 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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/channel-list-tabs-permissions.md)] diff --git a/api-reference/beta/api/channel-list.md b/api-reference/beta/api/channel-list.md index b4e5588dc70..cc3c05cc1fb 100644 --- a/api-reference/beta/api/channel-list.md +++ b/api-reference/beta/api/channel-list.md @@ -24,6 +24,8 @@ Retrieve the list of [channels](../resources/channel.md) in this [team](../resou 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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/channel-list-permissions.md)] diff --git a/api-reference/beta/api/channel-patch-tabs.md b/api-reference/beta/api/channel-patch-tabs.md index 6e5fc5a4ce1..b73eb9044b4 100644 --- a/api-reference/beta/api/channel-patch-tabs.md +++ b/api-reference/beta/api/channel-patch-tabs.md @@ -22,6 +22,8 @@ This API can be used to configure the content of the tab. ## 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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/channel-patch-tabs-permissions.md)] diff --git a/api-reference/beta/api/channel-patch.md b/api-reference/beta/api/channel-patch.md index 70f5b75e632..73262f1255d 100644 --- a/api-reference/beta/api/channel-patch.md +++ b/api-reference/beta/api/channel-patch.md @@ -23,6 +23,8 @@ Update the properties of the specified [channel](../resources/channel.md). 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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/channel-patch-permissions.md)] diff --git a/api-reference/beta/api/channel-post-tabs.md b/api-reference/beta/api/channel-post-tabs.md index d117b9ec40d..47c20cdae20 100644 --- a/api-reference/beta/api/channel-post-tabs.md +++ b/api-reference/beta/api/channel-post-tabs.md @@ -21,6 +21,8 @@ Add (pin) a [tab](../resources/teamstab.md) to the specified [channel](../resour 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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/channel-post-tabs-permissions.md)] diff --git a/api-reference/beta/api/channel-post.md b/api-reference/beta/api/channel-post.md index 1cc9f79df77..487baa60508 100644 --- a/api-reference/beta/api/channel-post.md +++ b/api-reference/beta/api/channel-post.md @@ -28,6 +28,8 @@ You can add a maximum of 200 members when you create a private channel. 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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/channel-post-permissions.md)] diff --git a/api-reference/beta/api/team-archive.md b/api-reference/beta/api/team-archive.md index 508aaade4f7..e7c44dd7b5e 100644 --- a/api-reference/beta/api/team-archive.md +++ b/api-reference/beta/api/team-archive.md @@ -27,6 +27,8 @@ To restore a team from its archived state, use the API to [unarchive](team-unarc ## 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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/team-archive-permissions.md)] diff --git a/api-reference/beta/api/team-get.md b/api-reference/beta/api/team-get.md index a64b19d7896..12d72da9857 100644 --- a/api-reference/beta/api/team-get.md +++ b/api-reference/beta/api/team-get.md @@ -20,6 +20,8 @@ Retrieve the properties and relationships of the specified [team](../resources/t ## 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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/team-get-permissions.md)] diff --git a/api-reference/beta/api/team-unarchive.md b/api-reference/beta/api/team-unarchive.md index 1c44cbb430e..fb9ea420ea9 100644 --- a/api-reference/beta/api/team-unarchive.md +++ b/api-reference/beta/api/team-unarchive.md @@ -22,6 +22,8 @@ Unarchiving is an async operation. A team is unarchived once the async operation ## 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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/team-unarchive-permissions.md)] diff --git a/api-reference/beta/api/team-update.md b/api-reference/beta/api/team-update.md index 22367a73298..5c60f551913 100644 --- a/api-reference/beta/api/team-update.md +++ b/api-reference/beta/api/team-update.md @@ -20,6 +20,8 @@ Update the properties of the specified [team](../resources/team.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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/team-update-permissions.md)] diff --git a/api-reference/v1.0/api/channel-delete-tabs.md b/api-reference/v1.0/api/channel-delete-tabs.md index b1641720d70..51eb7b3dfe0 100644 --- a/api-reference/v1.0/api/channel-delete-tabs.md +++ b/api-reference/v1.0/api/channel-delete-tabs.md @@ -20,6 +20,8 @@ Removes (unpins) a tab from the specified [channel](../resources/channel.md) wit ## 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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/channel-delete-tabs-permissions.md)] diff --git a/api-reference/v1.0/api/channel-delete.md b/api-reference/v1.0/api/channel-delete.md index aeb1f3a9c87..1fea3775fb7 100644 --- a/api-reference/v1.0/api/channel-delete.md +++ b/api-reference/v1.0/api/channel-delete.md @@ -21,6 +21,8 @@ Delete the [channel](../resources/channel.md). 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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/channel-delete-permissions.md)] diff --git a/api-reference/v1.0/api/channel-get-tabs.md b/api-reference/v1.0/api/channel-get-tabs.md index 3b1c173d70d..7bf4bca5e03 100644 --- a/api-reference/v1.0/api/channel-get-tabs.md +++ b/api-reference/v1.0/api/channel-get-tabs.md @@ -18,6 +18,8 @@ Retrieve the properties and relationships of the specified [tab](../resources/te ## 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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/channel-get-tabs-permissions.md)] diff --git a/api-reference/v1.0/api/channel-get.md b/api-reference/v1.0/api/channel-get.md index 3ee53f679da..f2625efe6ec 100644 --- a/api-reference/v1.0/api/channel-get.md +++ b/api-reference/v1.0/api/channel-get.md @@ -21,6 +21,8 @@ This method supports federation. Only a user who is a member of the shared chann 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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/channel-get-permissions.md)] diff --git a/api-reference/v1.0/api/channel-list-tabs.md b/api-reference/v1.0/api/channel-list-tabs.md index ff6059169e7..f945fd7a508 100644 --- a/api-reference/v1.0/api/channel-list-tabs.md +++ b/api-reference/v1.0/api/channel-list-tabs.md @@ -21,6 +21,8 @@ Retrieve the list of [tabs](../resources/teamstab.md) in the specified [channel] ## 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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/channel-list-tabs-permissions.md)] diff --git a/api-reference/v1.0/api/channel-list.md b/api-reference/v1.0/api/channel-list.md index ef2b3f2fbe3..a038843e7d6 100644 --- a/api-reference/v1.0/api/channel-list.md +++ b/api-reference/v1.0/api/channel-list.md @@ -22,6 +22,8 @@ Retrieve the list of [channels](../resources/channel.md) in this [team](../resou 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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/channel-list-permissions.md)] diff --git a/api-reference/v1.0/api/channel-patch-tabs.md b/api-reference/v1.0/api/channel-patch-tabs.md index 24e85a5cf6b..9114b3b2c8a 100644 --- a/api-reference/v1.0/api/channel-patch-tabs.md +++ b/api-reference/v1.0/api/channel-patch-tabs.md @@ -20,6 +20,8 @@ This API can be used to configure the content of the tab. ## 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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/channel-patch-tabs-permissions.md)] diff --git a/api-reference/v1.0/api/channel-patch.md b/api-reference/v1.0/api/channel-patch.md index 8d3a821521b..db58e09c5df 100644 --- a/api-reference/v1.0/api/channel-patch.md +++ b/api-reference/v1.0/api/channel-patch.md @@ -21,6 +21,8 @@ Update the properties of the specified [channel](../resources/channel.md). 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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/channel-patch-permissions.md)] diff --git a/api-reference/v1.0/api/channel-post-tabs.md b/api-reference/v1.0/api/channel-post-tabs.md index 6e49581dbbe..4dd1b33dd2c 100644 --- a/api-reference/v1.0/api/channel-post-tabs.md +++ b/api-reference/v1.0/api/channel-post-tabs.md @@ -19,6 +19,8 @@ Add (pin) a [tab](../resources/teamstab.md) to the specified [channel](../resour 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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/channel-post-tabs-permissions.md)] diff --git a/api-reference/v1.0/api/team-archive.md b/api-reference/v1.0/api/team-archive.md index f7d472715af..8c23fdb6218 100644 --- a/api-reference/v1.0/api/team-archive.md +++ b/api-reference/v1.0/api/team-archive.md @@ -25,6 +25,8 @@ To restore a team from its archived state, use the API to [unarchive](team-unarc ## 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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/team-archive-permissions.md)] diff --git a/api-reference/v1.0/api/team-get.md b/api-reference/v1.0/api/team-get.md index c2c88bfedb2..c5c173cacc4 100644 --- a/api-reference/v1.0/api/team-get.md +++ b/api-reference/v1.0/api/team-get.md @@ -20,6 +20,8 @@ Retrieve the properties and relationships of the specified [team](../resources/t ## 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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/team-get-permissions.md)] diff --git a/api-reference/v1.0/api/team-unarchive.md b/api-reference/v1.0/api/team-unarchive.md index 61d28df7034..74780f97368 100644 --- a/api-reference/v1.0/api/team-unarchive.md +++ b/api-reference/v1.0/api/team-unarchive.md @@ -22,6 +22,8 @@ Unarchiving is an async operation. A team is unarchived once the async operation ## 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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/team-unarchive-permissions.md)] diff --git a/api-reference/v1.0/api/team-update.md b/api-reference/v1.0/api/team-update.md index 71623e91d02..34a22eb8f49 100644 --- a/api-reference/v1.0/api/team-update.md +++ b/api-reference/v1.0/api/team-update.md @@ -20,6 +20,8 @@ Update the properties of the specified [team](../resources/team.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). +This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. + [!INCLUDE [permissions-table](../includes/permissions/team-update-permissions.md)] From 90c7f59cc5719b64823a785e5fe24095ccc57c96 Mon Sep 17 00:00:00 2001 From: Microsoft Graph DevX Tooling Date: Tue, 19 Mar 2024 12:44:35 +0000 Subject: [PATCH 130/139] Update generated files with build 140046 --- .../beta/api/cloudclipboardroot-list-items.md | 1 - .../beta/api/driveitem-get-contentstream.md | 19 +++- ...nmentsettings-post-defaultgradingscheme.md | 1 - .../beta/api/educationgradingscheme-get.md | 1 - .../beta/api/search-acronym-delete.md | 1 - api-reference/beta/api/search-qna-delete.md | 1 - .../beta/api/security-analyzedemail-get.md | 1 - .../api/security-analyzedemail-remediate.md | 1 - ...ser-convertexternaltointernalmemberuser.md | 72 ++++++++++++++ api-reference/beta/api/windowssetting-get.md | 1 - .../beta/api/windowssetting-list-instances.md | 1 - ...loudpconpremisesconnection-cli-snippets.md | 1 + ...isesconnection-withdetails-cli-snippets.md | 2 +- .../cli/get-signins-1-cli-snippets.md | 2 +- ...ternalmemberuser-cloudonly-cli-snippets.md | 17 ++++ ...eruser-cloudonly-with-mail-cli-snippets.md | 18 ++++ ...ernalmemberuser-synceduser-cli-snippets.md | 10 ++ ...dpconpremisesconnection-csharp-snippets.md | 1 + ...sconnection-withdetails-csharp-snippets.md | 2 +- .../csharp/get-signins-1-csharp-snippets.md | 5 +- ...nalmemberuser-cloudonly-csharp-snippets.md | 27 ++++++ ...ser-cloudonly-with-mail-csharp-snippets.md | 28 ++++++ ...almemberuser-synceduser-csharp-snippets.md | 13 +++ ...cloudpconpremisesconnection-go-snippets.md | 2 + ...misesconnection-withdetails-go-snippets.md | 2 +- .../snippets/go/get-signins-1-go-snippets.md | 12 ++- ...nternalmemberuser-cloudonly-go-snippets.md | 32 +++++++ ...beruser-cloudonly-with-mail-go-snippets.md | 34 +++++++ ...ernalmemberuser-synceduser-go-snippets.md} | 2 +- ...oudpconpremisesconnection-java-snippets.md | 1 + ...sesconnection-withdetails-java-snippets.md | 2 +- .../java/get-signins-1-java-snippets.md | 4 +- ...ernalmemberuser-cloudonly-java-snippets.md | 20 ++++ ...ruser-cloudonly-with-mail-java-snippets.md | 21 ++++ ...nalmemberuser-synceduser-java-snippets.md} | 2 +- ...npremisesconnection-javascript-snippets.md | 1 + ...item-content-stream-javascript-snippets.md | 17 ++++ ...item-partial-stream-javascript-snippets.md | 18 ++++ ...nection-withdetails-javascript-snippets.md | 2 +- .../get-signins-1-javascript-snippets.md | 1 + ...emberuser-cloudonly-javascript-snippets.md | 4 +- ...cloudonly-with-mail-javascript-snippets.md | 4 +- ...loudpconpremisesconnection-php-snippets.md | 1 + ...isesconnection-withdetails-php-snippets.md | 2 +- .../php/get-signins-1-php-snippets.md | 7 +- ...ternalmemberuser-cloudonly-php-snippets.md | 21 ++++ ...eruser-cloudonly-with-mail-php-snippets.md | 22 +++++ ...ernalmemberuser-synceduser-php-snippets.md | 15 +++ ...npremisesconnection-powershell-snippets.md | 1 + ...nection-withdetails-powershell-snippets.md | 2 +- .../get-signins-1-powershell-snippets.md | 2 +- ...dpconpremisesconnection-python-snippets.md | 1 + ...sconnection-withdetails-python-snippets.md | 2 +- .../python/get-signins-1-python-snippets.md | 10 +- ...nalmemberuser-cloudonly-python-snippets.md | 24 +++++ ...ser-cloudonly-with-mail-python-snippets.md | 25 +++++ ...almemberuser-synceduser-python-snippets.md | 15 +++ ...tlementmanagement-post-resourcerequests.md | 35 +++++++ ...s-enterprisecodesigningcertificate-list.md | 35 ------- ...enterprisecodesigningcertificate-update.md | 35 ------- .../api/m365appsinstallationoptions-get.md | 31 ++++++ .../api/m365appsinstallationoptions-update.md | 31 ++++++ ...ers-billing-billedreconciliation-export.md | 31 ++++++ .../v1.0/api/search-acronym-update.md | 1 - .../v1.0/api/search-bookmark-delete.md | 1 - .../v1.0/api/search-bookmark-update.md | 1 - api-reference/v1.0/api/search-qna-get.md | 1 - .../api/search-searchentity-post-bookmarks.md | 1 - ...tion-synchronizationjob-post-bulkupload.md | 2 - api-reference/v1.0/api/windowssetting-get.md | 1 - .../v1.0/api/windowssetting-list-instances.md | 1 - ...edreconciliationthisexport-cli-snippets.md | 14 +++ ...sourcerequests-appwithattr-cli-snippets.md | 57 +++++++++++ ...65appsinstallationoptions-cli-snippets.md} | 2 +- ...risecodesigningcertificate-cli-snippets.md | 21 ---- ...duleactionsforrules-action-cli-snippets.md | 2 +- .../snippets/cli/list-signins-cli-snippets.md | 2 +- ...365appsinstallationoptions-cli-snippets.md | 13 +++ ...econciliationthisexport-csharp-snippets.md | 23 +++++ ...rcerequests-appwithattr-csharp-snippets.md | 76 +++++++++++++++ ...ppsinstallationoptions-csharp-snippets.md} | 2 +- ...ecodesigningcertificate-csharp-snippets.md | 29 ------ ...eactionsforrules-action-csharp-snippets.md | 4 +- .../csharp/list-signins-csharp-snippets.md | 5 +- ...appsinstallationoptions-csharp-snippets.md | 21 ++++ ...ledreconciliationthisexport-go-snippets.md | 28 ++++++ ...esourcerequests-appwithattr-go-snippets.md | 83 ++++++++++++++++ ...m365appsinstallationoptions-go-snippets.md | 21 ++++ ...prisecodesigningcertificate-go-snippets.md | 40 -------- ...eduleactionsforrules-action-go-snippets.md | 6 +- .../snippets/go/list-signins-go-snippets.md | 12 ++- ...m365appsinstallationoptions-go-snippets.md | 25 +++++ ...dreconciliationthisexport-java-snippets.md | 17 ++++ ...ourcerequests-appwithattr-java-snippets.md | 60 ++++++++++++ ...65appsinstallationoptions-java-snippets.md | 14 +++ ...isecodesigningcertificate-java-snippets.md | 27 ------ ...uleactionsforrules-action-java-snippets.md | 2 +- .../java/list-signins-java-snippets.md | 4 +- ...65appsinstallationoptions-java-snippets.md | 16 ++++ ...ciliationthisexport-javascript-snippets.md | 21 ++++ ...equests-appwithattr-javascript-snippets.md | 64 +++++++++++++ ...nstallationoptions-javascript-snippets.md} | 3 +- ...esigningcertificate-javascript-snippets.md | 29 ------ ...ionsforrules-action-javascript-snippets.md | 1 - .../list-signins-javascript-snippets.md | 1 + ...installationoptions-javascript-snippets.md | 20 ++++ ...edreconciliationthisexport-php-snippets.md | 18 ++++ ...sourcerequests-appwithattr-php-snippets.md | 61 ++++++++++++ ...65appsinstallationoptions-php-snippets.md} | 2 +- ...risecodesigningcertificate-php-snippets.md | 25 ----- .../snippets/php/list-signins-php-snippets.md | 7 +- ...365appsinstallationoptions-php-snippets.md | 17 ++++ ...equests-appwithattr-powershell-snippets.md | 59 ++++++++++++ ...signingcertificates-powershell-snippets.md | 11 --- ...esigningcertificate-powershell-snippets.md | 23 ----- ...ionsforrules-action-powershell-snippets.md | 4 +- .../list-signins-powershell-snippets.md | 2 +- ...econciliationthisexport-python-snippets.md | 20 ++++ ...rcerequests-appwithattr-python-snippets.md | 69 +++++++++++++ ...ppsinstallationoptions-python-snippets.md} | 2 +- ...ecodesigningcertificate-python-snippets.md | 27 ------ .../python/list-signins-python-snippets.md | 10 +- ...appsinstallationoptions-python-snippets.md | 19 ++++ concepts/search-concept-answers.md | 2 - ...ycle-workflows-offboard-custom-workflow.md | 80 ++++++++-------- ...cycle-workflows-onboard-custom-workflow.md | 96 +++++++++---------- ...al-lifecycle-workflows-scheduled-leaver.md | 96 +++++++++---------- ...list-taskprocessingresults-cli-snippets.md | 10 -- ...erprocessingresultssummary-cli-snippets.md | 10 -- ...neronboarding-run-workflow-cli-snippets.md | 10 -- ...list-taskprocessingresults-cli-snippets.md | 10 -- ...erprocessingresultssummary-cli-snippets.md | 10 -- ...eaverondemand-run-workflow-cli-snippets.md | 10 -- ...list-taskprocessingresults-cli-snippets.md | 10 -- ...erprocessingresultssummary-cli-snippets.md | 10 -- ...heduledleaver-run-workflow-cli-snippets.md | 10 -- ...onboarding-create-workflow-cli-snippets.md | 2 +- ...list-taskprocessingresults-cli-snippets.md | 10 ++ ...list-userprocessingresults-cli-snippets.md | 2 +- ...erprocessingresultssummary-cli-snippets.md | 10 ++ ...neronboarding-run-workflow-cli-snippets.md | 10 ++ ...onboarding-update-workflow-cli-snippets.md | 2 +- ...erondemand-create-workflow-cli-snippets.md | 2 +- ...list-taskprocessingresults-cli-snippets.md | 10 ++ ...list-userprocessingresults-cli-snippets.md | 2 +- ...erprocessingresultssummary-cli-snippets.md | 10 ++ ...eaverondemand-run-workflow-cli-snippets.md | 10 ++ ...uledleaver-create-workflow-cli-snippets.md | 2 +- ...list-taskprocessingresults-cli-snippets.md | 10 ++ ...list-userprocessingresults-cli-snippets.md | 2 +- ...erprocessingresultssummary-cli-snippets.md | 10 ++ ...heduledleaver-run-workflow-cli-snippets.md | 10 ++ ...uledleaver-update-workflow-cli-snippets.md | 2 +- ...oarding-create-workflow-csharp-snippets.md | 4 +- ...t-taskprocessingresults-csharp-snippets.md | 0 ...t-userprocessingresults-csharp-snippets.md | 0 ...rocessingresultssummary-csharp-snippets.md | 0 ...onboarding-run-workflow-csharp-snippets.md | 4 +- ...oarding-update-workflow-csharp-snippets.md | 2 +- ...ndemand-create-workflow-csharp-snippets.md | 4 +- ...t-taskprocessingresults-csharp-snippets.md | 0 ...t-userprocessingresults-csharp-snippets.md | 0 ...rocessingresultssummary-csharp-snippets.md | 0 ...erondemand-run-workflow-csharp-snippets.md | 4 +- ...dleaver-create-workflow-csharp-snippets.md | 4 +- ...t-taskprocessingresults-csharp-snippets.md | 0 ...t-userprocessingresults-csharp-snippets.md | 0 ...rocessingresultssummary-csharp-snippets.md | 0 ...uledleaver-run-workflow-csharp-snippets.md | 4 +- ...dleaver-update-workflow-csharp-snippets.md | 2 +- ...ronboarding-create-workflow-go-snippets.md | 6 +- ...-list-taskprocessingresults-go-snippets.md | 2 +- ...-list-userprocessingresults-go-snippets.md | 2 +- ...serprocessingresultssummary-go-snippets.md | 2 +- ...ineronboarding-run-workflow-go-snippets.md | 6 +- ...ronboarding-update-workflow-go-snippets.md | 4 +- ...verondemand-create-workflow-go-snippets.md | 6 +- ...-list-taskprocessingresults-go-snippets.md | 2 +- ...-list-userprocessingresults-go-snippets.md | 2 +- ...serprocessingresultssummary-go-snippets.md | 2 +- ...leaverondemand-run-workflow-go-snippets.md | 6 +- ...duledleaver-create-workflow-go-snippets.md | 6 +- ...-list-taskprocessingresults-go-snippets.md | 2 +- ...-list-userprocessingresults-go-snippets.md | 2 +- ...serprocessingresultssummary-go-snippets.md | 2 +- ...cheduledleaver-run-workflow-go-snippets.md | 6 +- ...duledleaver-update-workflow-go-snippets.md | 4 +- ...nboarding-create-workflow-java-snippets.md | 16 ++-- ...ist-taskprocessingresults-java-snippets.md | 0 ...ist-userprocessingresults-java-snippets.md | 0 ...rprocessingresultssummary-java-snippets.md | 0 ...eronboarding-run-workflow-java-snippets.md | 2 +- ...nboarding-update-workflow-java-snippets.md | 2 +- ...rondemand-create-workflow-java-snippets.md | 14 +-- ...ist-taskprocessingresults-java-snippets.md | 0 ...ist-userprocessingresults-java-snippets.md | 0 ...rprocessingresultssummary-java-snippets.md | 0 ...averondemand-run-workflow-java-snippets.md | 2 +- ...ledleaver-create-workflow-java-snippets.md | 26 ++--- ...ist-taskprocessingresults-java-snippets.md | 0 ...ist-userprocessingresults-java-snippets.md | 0 ...rprocessingresultssummary-java-snippets.md | 0 ...eduledleaver-run-workflow-java-snippets.md | 2 +- ...ledleaver-update-workflow-java-snippets.md | 2 +- ...ing-create-workflow-javascript-snippets.md | 3 +- ...skprocessingresults-javascript-snippets.md | 3 +- ...erprocessingresults-javascript-snippets.md | 3 +- ...ssingresultssummary-javascript-snippets.md | 3 +- ...arding-run-workflow-javascript-snippets.md | 3 +- ...ing-update-workflow-javascript-snippets.md | 1 - ...and-create-workflow-javascript-snippets.md | 1 - ...skprocessingresults-javascript-snippets.md | 1 - ...erprocessingresults-javascript-snippets.md | 1 - ...ssingresultssummary-javascript-snippets.md | 1 - ...demand-run-workflow-javascript-snippets.md | 1 - ...ver-create-workflow-javascript-snippets.md | 1 - ...skprocessingresults-javascript-snippets.md | 1 - ...erprocessingresults-javascript-snippets.md | 1 - ...ssingresultssummary-javascript-snippets.md | 3 +- ...leaver-run-workflow-javascript-snippets.md | 1 - ...ver-update-workflow-javascript-snippets.md | 1 - ...onboarding-create-workflow-php-snippets.md | 0 ...list-taskprocessingresults-php-snippets.md | 0 ...list-userprocessingresults-php-snippets.md | 0 ...erprocessingresultssummary-php-snippets.md | 0 ...neronboarding-run-workflow-php-snippets.md | 0 ...onboarding-update-workflow-php-snippets.md | 0 ...erondemand-create-workflow-php-snippets.md | 0 ...list-taskprocessingresults-php-snippets.md | 0 ...list-userprocessingresults-php-snippets.md | 0 ...erprocessingresultssummary-php-snippets.md | 0 ...eaverondemand-run-workflow-php-snippets.md | 0 ...uledleaver-create-workflow-php-snippets.md | 0 ...list-taskprocessingresults-php-snippets.md | 0 ...list-userprocessingresults-php-snippets.md | 0 ...erprocessingresultssummary-php-snippets.md | 0 ...heduledleaver-run-workflow-php-snippets.md | 0 ...uledleaver-update-workflow-php-snippets.md | 0 ...skprocessingresults-powershell-snippets.md | 11 --- ...erprocessingresults-powershell-snippets.md | 11 --- ...ssingresultssummary-powershell-snippets.md | 11 --- ...skprocessingresults-powershell-snippets.md | 11 --- ...erprocessingresults-powershell-snippets.md | 11 --- ...ssingresultssummary-powershell-snippets.md | 11 --- ...skprocessingresults-powershell-snippets.md | 11 --- ...erprocessingresults-powershell-snippets.md | 11 --- ...ssingresultssummary-powershell-snippets.md | 11 --- ...ing-create-workflow-powershell-snippets.md | 4 +- ...skprocessingresults-powershell-snippets.md | 11 +++ ...erprocessingresults-powershell-snippets.md | 11 +++ ...ssingresultssummary-powershell-snippets.md | 11 +++ ...arding-run-workflow-powershell-snippets.md | 4 +- ...ing-update-workflow-powershell-snippets.md | 4 +- ...and-create-workflow-powershell-snippets.md | 4 +- ...skprocessingresults-powershell-snippets.md | 11 +++ ...erprocessingresults-powershell-snippets.md | 11 +++ ...ssingresultssummary-powershell-snippets.md | 11 +++ ...demand-run-workflow-powershell-snippets.md | 4 +- ...ver-create-workflow-powershell-snippets.md | 4 +- ...skprocessingresults-powershell-snippets.md | 11 +++ ...erprocessingresults-powershell-snippets.md | 11 +++ ...ssingresultssummary-powershell-snippets.md | 11 +++ ...leaver-run-workflow-powershell-snippets.md | 4 +- ...ver-update-workflow-powershell-snippets.md | 4 +- ...oarding-create-workflow-python-snippets.md | 0 ...t-taskprocessingresults-python-snippets.md | 0 ...t-userprocessingresults-python-snippets.md | 0 ...rocessingresultssummary-python-snippets.md | 0 ...onboarding-run-workflow-python-snippets.md | 0 ...oarding-update-workflow-python-snippets.md | 0 ...ndemand-create-workflow-python-snippets.md | 0 ...t-taskprocessingresults-python-snippets.md | 0 ...t-userprocessingresults-python-snippets.md | 0 ...rocessingresultssummary-python-snippets.md | 0 ...erondemand-run-workflow-python-snippets.md | 0 ...dleaver-create-workflow-python-snippets.md | 0 ...t-taskprocessingresults-python-snippets.md | 0 ...t-userprocessingresults-python-snippets.md | 0 ...rocessingresultssummary-python-snippets.md | 0 ...uledleaver-run-workflow-python-snippets.md | 0 ...dleaver-update-workflow-python-snippets.md | 0 281 files changed, 1972 insertions(+), 818 deletions(-) create mode 100644 api-reference/beta/includes/snippets/cli/userthisconvertexternaltointernalmemberuser-cloudonly-cli-snippets.md create mode 100644 api-reference/beta/includes/snippets/cli/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-cli-snippets.md create mode 100644 api-reference/beta/includes/snippets/cli/userthisconvertexternaltointernalmemberuser-synceduser-cli-snippets.md create mode 100644 api-reference/beta/includes/snippets/csharp/userthisconvertexternaltointernalmemberuser-cloudonly-csharp-snippets.md create mode 100644 api-reference/beta/includes/snippets/csharp/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-csharp-snippets.md create mode 100644 api-reference/beta/includes/snippets/csharp/userthisconvertexternaltointernalmemberuser-synceduser-csharp-snippets.md create mode 100644 api-reference/beta/includes/snippets/go/userthisconvertexternaltointernalmemberuser-cloudonly-go-snippets.md create mode 100644 api-reference/beta/includes/snippets/go/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-go-snippets.md rename api-reference/{v1.0/includes/snippets/go/intune-apps-enterprisecodesigningcertificate-list-list-enterprisecodesigningcertificates-go-snippets.md => beta/includes/snippets/go/userthisconvertexternaltointernalmemberuser-synceduser-go-snippets.md} (63%) create mode 100644 api-reference/beta/includes/snippets/java/userthisconvertexternaltointernalmemberuser-cloudonly-java-snippets.md create mode 100644 api-reference/beta/includes/snippets/java/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-java-snippets.md rename api-reference/{v1.0/includes/snippets/java/intune-apps-enterprisecodesigningcertificate-list-list-enterprisecodesigningcertificates-java-snippets.md => beta/includes/snippets/java/userthisconvertexternaltointernalmemberuser-synceduser-java-snippets.md} (63%) create mode 100644 api-reference/beta/includes/snippets/javascript/download-item-content-stream-javascript-snippets.md create mode 100644 api-reference/beta/includes/snippets/javascript/download-item-partial-stream-javascript-snippets.md create mode 100644 api-reference/beta/includes/snippets/php/userthisconvertexternaltointernalmemberuser-cloudonly-php-snippets.md create mode 100644 api-reference/beta/includes/snippets/php/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-php-snippets.md create mode 100644 api-reference/beta/includes/snippets/php/userthisconvertexternaltointernalmemberuser-synceduser-php-snippets.md create mode 100644 api-reference/beta/includes/snippets/python/userthisconvertexternaltointernalmemberuser-cloudonly-python-snippets.md create mode 100644 api-reference/beta/includes/snippets/python/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-python-snippets.md create mode 100644 api-reference/beta/includes/snippets/python/userthisconvertexternaltointernalmemberuser-synceduser-python-snippets.md create mode 100644 api-reference/v1.0/includes/snippets/cli/billedreconciliationthisexport-cli-snippets.md create mode 100644 api-reference/v1.0/includes/snippets/cli/create-accesspackageresourcerequest-from-accesspackageresourcerequests-appwithattr-cli-snippets.md rename api-reference/v1.0/includes/snippets/cli/{intune-apps-enterprisecodesigningcertificate-list-list-enterprisecodesigningcertificates-cli-snippets.md => get-m365appsinstallationoptions-cli-snippets.md} (64%) delete mode 100644 api-reference/v1.0/includes/snippets/cli/intune-apps-enterprisecodesigningcertificate-update-update-enterprisecodesigningcertificate-cli-snippets.md create mode 100644 api-reference/v1.0/includes/snippets/cli/update-m365appsinstallationoptions-cli-snippets.md create mode 100644 api-reference/v1.0/includes/snippets/csharp/billedreconciliationthisexport-csharp-snippets.md create mode 100644 api-reference/v1.0/includes/snippets/csharp/create-accesspackageresourcerequest-from-accesspackageresourcerequests-appwithattr-csharp-snippets.md rename api-reference/v1.0/includes/snippets/csharp/{intune-apps-enterprisecodesigningcertificate-list-list-enterprisecodesigningcertificates-csharp-snippets.md => get-m365appsinstallationoptions-csharp-snippets.md} (75%) delete mode 100644 api-reference/v1.0/includes/snippets/csharp/intune-apps-enterprisecodesigningcertificate-update-update-enterprisecodesigningcertificate-csharp-snippets.md create mode 100644 api-reference/v1.0/includes/snippets/csharp/update-m365appsinstallationoptions-csharp-snippets.md create mode 100644 api-reference/v1.0/includes/snippets/go/billedreconciliationthisexport-go-snippets.md create mode 100644 api-reference/v1.0/includes/snippets/go/create-accesspackageresourcerequest-from-accesspackageresourcerequests-appwithattr-go-snippets.md create mode 100644 api-reference/v1.0/includes/snippets/go/get-m365appsinstallationoptions-go-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/go/intune-apps-enterprisecodesigningcertificate-update-update-enterprisecodesigningcertificate-go-snippets.md create mode 100644 api-reference/v1.0/includes/snippets/go/update-m365appsinstallationoptions-go-snippets.md create mode 100644 api-reference/v1.0/includes/snippets/java/billedreconciliationthisexport-java-snippets.md create mode 100644 api-reference/v1.0/includes/snippets/java/create-accesspackageresourcerequest-from-accesspackageresourcerequests-appwithattr-java-snippets.md create mode 100644 api-reference/v1.0/includes/snippets/java/get-m365appsinstallationoptions-java-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/java/intune-apps-enterprisecodesigningcertificate-update-update-enterprisecodesigningcertificate-java-snippets.md create mode 100644 api-reference/v1.0/includes/snippets/java/update-m365appsinstallationoptions-java-snippets.md create mode 100644 api-reference/v1.0/includes/snippets/javascript/billedreconciliationthisexport-javascript-snippets.md create mode 100644 api-reference/v1.0/includes/snippets/javascript/create-accesspackageresourcerequest-from-accesspackageresourcerequests-appwithattr-javascript-snippets.md rename api-reference/v1.0/includes/snippets/javascript/{intune-apps-enterprisecodesigningcertificate-list-list-enterprisecodesigningcertificates-javascript-snippets.md => get-m365appsinstallationoptions-javascript-snippets.md} (56%) delete mode 100644 api-reference/v1.0/includes/snippets/javascript/intune-apps-enterprisecodesigningcertificate-update-update-enterprisecodesigningcertificate-javascript-snippets.md create mode 100644 api-reference/v1.0/includes/snippets/javascript/update-m365appsinstallationoptions-javascript-snippets.md create mode 100644 api-reference/v1.0/includes/snippets/php/billedreconciliationthisexport-php-snippets.md create mode 100644 api-reference/v1.0/includes/snippets/php/create-accesspackageresourcerequest-from-accesspackageresourcerequests-appwithattr-php-snippets.md rename api-reference/v1.0/includes/snippets/php/{intune-apps-enterprisecodesigningcertificate-list-list-enterprisecodesigningcertificates-php-snippets.md => get-m365appsinstallationoptions-php-snippets.md} (61%) delete mode 100644 api-reference/v1.0/includes/snippets/php/intune-apps-enterprisecodesigningcertificate-update-update-enterprisecodesigningcertificate-php-snippets.md create mode 100644 api-reference/v1.0/includes/snippets/php/update-m365appsinstallationoptions-php-snippets.md create mode 100644 api-reference/v1.0/includes/snippets/powershell/create-accesspackageresourcerequest-from-accesspackageresourcerequests-appwithattr-powershell-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/powershell/intune-apps-enterprisecodesigningcertificate-list-list-enterprisecodesigningcertificates-powershell-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/powershell/intune-apps-enterprisecodesigningcertificate-update-update-enterprisecodesigningcertificate-powershell-snippets.md create mode 100644 api-reference/v1.0/includes/snippets/python/billedreconciliationthisexport-python-snippets.md create mode 100644 api-reference/v1.0/includes/snippets/python/create-accesspackageresourcerequest-from-accesspackageresourcerequests-appwithattr-python-snippets.md rename api-reference/v1.0/includes/snippets/python/{intune-apps-enterprisecodesigningcertificate-list-list-enterprisecodesigningcertificates-python-snippets.md => get-m365appsinstallationoptions-python-snippets.md} (66%) delete mode 100644 api-reference/v1.0/includes/snippets/python/intune-apps-enterprisecodesigningcertificate-update-update-enterprisecodesigningcertificate-python-snippets.md create mode 100644 api-reference/v1.0/includes/snippets/python/update-m365appsinstallationoptions-python-snippets.md delete mode 100644 includes/snippets/cli/beta/tutorial-lifecycle-workflows-joineronboarding-list-taskprocessingresults-cli-snippets.md delete mode 100644 includes/snippets/cli/beta/tutorial-lifecycle-workflows-joineronboarding-list-userprocessingresultssummary-cli-snippets.md delete mode 100644 includes/snippets/cli/beta/tutorial-lifecycle-workflows-joineronboarding-run-workflow-cli-snippets.md delete mode 100644 includes/snippets/cli/beta/tutorial-lifecycle-workflows-leaverondemand-list-taskprocessingresults-cli-snippets.md delete mode 100644 includes/snippets/cli/beta/tutorial-lifecycle-workflows-leaverondemand-list-userprocessingresultssummary-cli-snippets.md delete mode 100644 includes/snippets/cli/beta/tutorial-lifecycle-workflows-leaverondemand-run-workflow-cli-snippets.md delete mode 100644 includes/snippets/cli/beta/tutorial-lifecycle-workflows-scheduledleaver-list-taskprocessingresults-cli-snippets.md delete mode 100644 includes/snippets/cli/beta/tutorial-lifecycle-workflows-scheduledleaver-list-userprocessingresultssummary-cli-snippets.md delete mode 100644 includes/snippets/cli/beta/tutorial-lifecycle-workflows-scheduledleaver-run-workflow-cli-snippets.md rename includes/snippets/cli/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-create-workflow-cli-snippets.md (94%) create mode 100644 includes/snippets/cli/v1/tutorial-lifecycle-workflows-joineronboarding-list-taskprocessingresults-cli-snippets.md rename includes/snippets/cli/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-list-userprocessingresults-cli-snippets.md (53%) create mode 100644 includes/snippets/cli/v1/tutorial-lifecycle-workflows-joineronboarding-list-userprocessingresultssummary-cli-snippets.md create mode 100644 includes/snippets/cli/v1/tutorial-lifecycle-workflows-joineronboarding-run-workflow-cli-snippets.md rename includes/snippets/cli/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-update-workflow-cli-snippets.md (65%) rename includes/snippets/cli/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-create-workflow-cli-snippets.md (95%) create mode 100644 includes/snippets/cli/v1/tutorial-lifecycle-workflows-leaverondemand-list-taskprocessingresults-cli-snippets.md rename includes/snippets/cli/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-list-userprocessingresults-cli-snippets.md (53%) create mode 100644 includes/snippets/cli/v1/tutorial-lifecycle-workflows-leaverondemand-list-userprocessingresultssummary-cli-snippets.md create mode 100644 includes/snippets/cli/v1/tutorial-lifecycle-workflows-leaverondemand-run-workflow-cli-snippets.md rename includes/snippets/cli/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-create-workflow-cli-snippets.md (96%) create mode 100644 includes/snippets/cli/v1/tutorial-lifecycle-workflows-scheduledleaver-list-taskprocessingresults-cli-snippets.md rename includes/snippets/cli/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-list-userprocessingresults-cli-snippets.md (53%) create mode 100644 includes/snippets/cli/v1/tutorial-lifecycle-workflows-scheduledleaver-list-userprocessingresultssummary-cli-snippets.md create mode 100644 includes/snippets/cli/v1/tutorial-lifecycle-workflows-scheduledleaver-run-workflow-cli-snippets.md rename includes/snippets/cli/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-update-workflow-cli-snippets.md (65%) rename includes/snippets/csharp/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-create-workflow-csharp-snippets.md (95%) rename includes/snippets/csharp/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-list-taskprocessingresults-csharp-snippets.md (100%) rename includes/snippets/csharp/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-list-userprocessingresults-csharp-snippets.md (100%) rename includes/snippets/csharp/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-list-userprocessingresultssummary-csharp-snippets.md (100%) rename includes/snippets/csharp/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-run-workflow-csharp-snippets.md (79%) rename includes/snippets/csharp/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-update-workflow-csharp-snippets.md (90%) rename includes/snippets/csharp/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-create-workflow-csharp-snippets.md (95%) rename includes/snippets/csharp/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-list-taskprocessingresults-csharp-snippets.md (100%) rename includes/snippets/csharp/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-list-userprocessingresults-csharp-snippets.md (100%) rename includes/snippets/csharp/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-list-userprocessingresultssummary-csharp-snippets.md (100%) rename includes/snippets/csharp/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-run-workflow-csharp-snippets.md (79%) rename includes/snippets/csharp/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-create-workflow-csharp-snippets.md (96%) rename includes/snippets/csharp/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-list-taskprocessingresults-csharp-snippets.md (100%) rename includes/snippets/csharp/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-list-userprocessingresults-csharp-snippets.md (100%) rename includes/snippets/csharp/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-list-userprocessingresultssummary-csharp-snippets.md (100%) rename includes/snippets/csharp/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-run-workflow-csharp-snippets.md (79%) rename includes/snippets/csharp/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-update-workflow-csharp-snippets.md (90%) rename includes/snippets/go/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-create-workflow-go-snippets.md (93%) rename includes/snippets/go/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-list-taskprocessingresults-go-snippets.md (88%) rename includes/snippets/go/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-list-userprocessingresults-go-snippets.md (86%) rename includes/snippets/go/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-list-userprocessingresultssummary-go-snippets.md (91%) rename includes/snippets/go/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-run-workflow-go-snippets.md (73%) rename includes/snippets/go/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-update-workflow-go-snippets.md (85%) rename includes/snippets/go/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-create-workflow-go-snippets.md (94%) rename includes/snippets/go/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-list-taskprocessingresults-go-snippets.md (88%) rename includes/snippets/go/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-list-userprocessingresults-go-snippets.md (86%) rename includes/snippets/go/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-list-userprocessingresultssummary-go-snippets.md (91%) rename includes/snippets/go/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-run-workflow-go-snippets.md (73%) rename includes/snippets/go/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-create-workflow-go-snippets.md (95%) rename includes/snippets/go/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-list-taskprocessingresults-go-snippets.md (88%) rename includes/snippets/go/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-list-userprocessingresults-go-snippets.md (86%) rename includes/snippets/go/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-list-userprocessingresultssummary-go-snippets.md (91%) rename includes/snippets/go/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-run-workflow-go-snippets.md (73%) rename includes/snippets/go/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-update-workflow-go-snippets.md (85%) rename includes/snippets/java/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-create-workflow-java-snippets.md (59%) rename includes/snippets/java/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-list-taskprocessingresults-java-snippets.md (100%) rename includes/snippets/java/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-list-userprocessingresults-java-snippets.md (100%) rename includes/snippets/java/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-list-userprocessingresultssummary-java-snippets.md (100%) rename includes/snippets/java/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-run-workflow-java-snippets.md (65%) rename includes/snippets/java/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-update-workflow-java-snippets.md (77%) rename includes/snippets/java/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-create-workflow-java-snippets.md (67%) rename includes/snippets/java/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-list-taskprocessingresults-java-snippets.md (100%) rename includes/snippets/java/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-list-userprocessingresults-java-snippets.md (100%) rename includes/snippets/java/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-list-userprocessingresultssummary-java-snippets.md (100%) rename includes/snippets/java/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-run-workflow-java-snippets.md (65%) rename includes/snippets/java/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-create-workflow-java-snippets.md (56%) rename includes/snippets/java/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-list-taskprocessingresults-java-snippets.md (100%) rename includes/snippets/java/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-list-userprocessingresults-java-snippets.md (100%) rename includes/snippets/java/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-list-userprocessingresultssummary-java-snippets.md (100%) rename includes/snippets/java/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-run-workflow-java-snippets.md (65%) rename includes/snippets/java/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-update-workflow-java-snippets.md (77%) rename includes/snippets/javascript/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-create-workflow-javascript-snippets.md (94%) rename includes/snippets/javascript/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-list-taskprocessingresults-javascript-snippets.md (79%) rename includes/snippets/javascript/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-list-userprocessingresults-javascript-snippets.md (76%) rename includes/snippets/javascript/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-list-userprocessingresultssummary-javascript-snippets.md (57%) rename includes/snippets/javascript/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-run-workflow-javascript-snippets.md (81%) rename includes/snippets/javascript/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-update-workflow-javascript-snippets.md (95%) rename includes/snippets/javascript/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-create-workflow-javascript-snippets.md (98%) rename includes/snippets/javascript/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-list-taskprocessingresults-javascript-snippets.md (95%) rename includes/snippets/javascript/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-list-userprocessingresults-javascript-snippets.md (94%) rename includes/snippets/javascript/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-list-userprocessingresultssummary-javascript-snippets.md (95%) rename includes/snippets/javascript/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-run-workflow-javascript-snippets.md (95%) rename includes/snippets/javascript/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-create-workflow-javascript-snippets.md (99%) rename includes/snippets/javascript/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-list-taskprocessingresults-javascript-snippets.md (95%) rename includes/snippets/javascript/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-list-userprocessingresults-javascript-snippets.md (94%) rename includes/snippets/javascript/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-list-userprocessingresultssummary-javascript-snippets.md (72%) rename includes/snippets/javascript/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-run-workflow-javascript-snippets.md (95%) rename includes/snippets/javascript/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-update-workflow-javascript-snippets.md (95%) rename includes/snippets/php/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-create-workflow-php-snippets.md (100%) rename includes/snippets/php/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-list-taskprocessingresults-php-snippets.md (100%) rename includes/snippets/php/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-list-userprocessingresults-php-snippets.md (100%) rename includes/snippets/php/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-list-userprocessingresultssummary-php-snippets.md (100%) rename includes/snippets/php/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-run-workflow-php-snippets.md (100%) rename includes/snippets/php/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-update-workflow-php-snippets.md (100%) rename includes/snippets/php/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-create-workflow-php-snippets.md (100%) rename includes/snippets/php/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-list-taskprocessingresults-php-snippets.md (100%) rename includes/snippets/php/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-list-userprocessingresults-php-snippets.md (100%) rename includes/snippets/php/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-list-userprocessingresultssummary-php-snippets.md (100%) rename includes/snippets/php/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-run-workflow-php-snippets.md (100%) rename includes/snippets/php/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-create-workflow-php-snippets.md (100%) rename includes/snippets/php/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-list-taskprocessingresults-php-snippets.md (100%) rename includes/snippets/php/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-list-userprocessingresults-php-snippets.md (100%) rename includes/snippets/php/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-list-userprocessingresultssummary-php-snippets.md (100%) rename includes/snippets/php/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-run-workflow-php-snippets.md (100%) rename includes/snippets/php/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-update-workflow-php-snippets.md (100%) delete mode 100644 includes/snippets/powershell/beta/tutorial-lifecycle-workflows-joineronboarding-list-taskprocessingresults-powershell-snippets.md delete mode 100644 includes/snippets/powershell/beta/tutorial-lifecycle-workflows-joineronboarding-list-userprocessingresults-powershell-snippets.md delete mode 100644 includes/snippets/powershell/beta/tutorial-lifecycle-workflows-joineronboarding-list-userprocessingresultssummary-powershell-snippets.md delete mode 100644 includes/snippets/powershell/beta/tutorial-lifecycle-workflows-leaverondemand-list-taskprocessingresults-powershell-snippets.md delete mode 100644 includes/snippets/powershell/beta/tutorial-lifecycle-workflows-leaverondemand-list-userprocessingresults-powershell-snippets.md delete mode 100644 includes/snippets/powershell/beta/tutorial-lifecycle-workflows-leaverondemand-list-userprocessingresultssummary-powershell-snippets.md delete mode 100644 includes/snippets/powershell/beta/tutorial-lifecycle-workflows-scheduledleaver-list-taskprocessingresults-powershell-snippets.md delete mode 100644 includes/snippets/powershell/beta/tutorial-lifecycle-workflows-scheduledleaver-list-userprocessingresults-powershell-snippets.md delete mode 100644 includes/snippets/powershell/beta/tutorial-lifecycle-workflows-scheduledleaver-list-userprocessingresultssummary-powershell-snippets.md rename includes/snippets/powershell/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-create-workflow-powershell-snippets.md (89%) create mode 100644 includes/snippets/powershell/v1/tutorial-lifecycle-workflows-joineronboarding-list-taskprocessingresults-powershell-snippets.md create mode 100644 includes/snippets/powershell/v1/tutorial-lifecycle-workflows-joineronboarding-list-userprocessingresults-powershell-snippets.md create mode 100644 includes/snippets/powershell/v1/tutorial-lifecycle-workflows-joineronboarding-list-userprocessingresultssummary-powershell-snippets.md rename includes/snippets/powershell/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-run-workflow-powershell-snippets.md (53%) rename includes/snippets/powershell/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-update-workflow-powershell-snippets.md (50%) rename includes/snippets/powershell/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-create-workflow-powershell-snippets.md (90%) create mode 100644 includes/snippets/powershell/v1/tutorial-lifecycle-workflows-leaverondemand-list-taskprocessingresults-powershell-snippets.md create mode 100644 includes/snippets/powershell/v1/tutorial-lifecycle-workflows-leaverondemand-list-userprocessingresults-powershell-snippets.md create mode 100644 includes/snippets/powershell/v1/tutorial-lifecycle-workflows-leaverondemand-list-userprocessingresultssummary-powershell-snippets.md rename includes/snippets/powershell/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-run-workflow-powershell-snippets.md (53%) rename includes/snippets/powershell/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-create-workflow-powershell-snippets.md (92%) create mode 100644 includes/snippets/powershell/v1/tutorial-lifecycle-workflows-scheduledleaver-list-taskprocessingresults-powershell-snippets.md create mode 100644 includes/snippets/powershell/v1/tutorial-lifecycle-workflows-scheduledleaver-list-userprocessingresults-powershell-snippets.md create mode 100644 includes/snippets/powershell/v1/tutorial-lifecycle-workflows-scheduledleaver-list-userprocessingresultssummary-powershell-snippets.md rename includes/snippets/powershell/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-run-workflow-powershell-snippets.md (53%) rename includes/snippets/powershell/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-update-workflow-powershell-snippets.md (50%) rename includes/snippets/python/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-create-workflow-python-snippets.md (100%) rename includes/snippets/python/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-list-taskprocessingresults-python-snippets.md (100%) rename includes/snippets/python/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-list-userprocessingresults-python-snippets.md (100%) rename includes/snippets/python/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-list-userprocessingresultssummary-python-snippets.md (100%) rename includes/snippets/python/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-run-workflow-python-snippets.md (100%) rename includes/snippets/python/{beta => v1}/tutorial-lifecycle-workflows-joineronboarding-update-workflow-python-snippets.md (100%) rename includes/snippets/python/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-create-workflow-python-snippets.md (100%) rename includes/snippets/python/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-list-taskprocessingresults-python-snippets.md (100%) rename includes/snippets/python/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-list-userprocessingresults-python-snippets.md (100%) rename includes/snippets/python/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-list-userprocessingresultssummary-python-snippets.md (100%) rename includes/snippets/python/{beta => v1}/tutorial-lifecycle-workflows-leaverondemand-run-workflow-python-snippets.md (100%) rename includes/snippets/python/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-create-workflow-python-snippets.md (100%) rename includes/snippets/python/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-list-taskprocessingresults-python-snippets.md (100%) rename includes/snippets/python/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-list-userprocessingresults-python-snippets.md (100%) rename includes/snippets/python/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-list-userprocessingresultssummary-python-snippets.md (100%) rename includes/snippets/python/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-run-workflow-python-snippets.md (100%) rename includes/snippets/python/{beta => v1}/tutorial-lifecycle-workflows-scheduledleaver-update-workflow-python-snippets.md (100%) diff --git a/api-reference/beta/api/cloudclipboardroot-list-items.md b/api-reference/beta/api/cloudclipboardroot-list-items.md index 22b4a9f1f25..7dafa23faf4 100644 --- a/api-reference/beta/api/cloudclipboardroot-list-items.md +++ b/api-reference/beta/api/cloudclipboardroot-list-items.md @@ -114,7 +114,6 @@ GET https://graph.microsoft.com/beta/me/cloudClipboard/items --- - ### Response The following example shows the response. diff --git a/api-reference/beta/api/driveitem-get-contentstream.md b/api-reference/beta/api/driveitem-get-contentstream.md index 66fb846f351..835169b0014 100644 --- a/api-reference/beta/api/driveitem-get-contentstream.md +++ b/api-reference/beta/api/driveitem-get-contentstream.md @@ -64,12 +64,19 @@ The following example shows how to download a file. #### Request +# [HTTP](#tab/http) -```http +```msgraph-interactive GET https://graph.microsoft.com/beta/drives/b!fMInbiL5dkK51VbATG0ddrCg6AJpEj9Lm4uGj5HgEi4guyuYp4W5SbH4dPfXTbCF/items/014Y52UITTNSVUQI43PZBJMKLAY6LJBUVE/contentStream ``` +# [JavaScript](#tab/javascript) +[!INCLUDE [sample-code](../includes/snippets/javascript/download-item-content-stream-javascript-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +--- + #### Response The following example shows the response. @@ -92,11 +99,19 @@ Content-Type: text/plain To download a partial range of bytes from the file, your app can use the `Range` header, as specified in [RFC 2616](https://www.ietf.org/rfc/rfc2616.txt). #### Request +# [HTTP](#tab/http) -```http +```msgraph-interactive GET https://graph.microsoft.com/beta/drives/b!fMInbiL5dkK51VbATG0ddrCg6AJpEj9Lm4uGj5HgEi4guyuYp4W5SbH4dPfXTbCF/items/014Y52UITTNSVUQI43PZBJMKLAY6LJBUVE/contentStream Range: bytes=0-1023 ``` + +# [JavaScript](#tab/javascript) +[!INCLUDE [sample-code](../includes/snippets/javascript/download-item-partial-stream-javascript-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +--- + #### Response The call returns a `206 Partial Content` HTTP response with the requested range of bytes from the file. If the range can't be generated, the `Range` header is ignored and a `200 OK` HTTP response is returned with the full contents of the file. diff --git a/api-reference/beta/api/educationassignmentsettings-post-defaultgradingscheme.md b/api-reference/beta/api/educationassignmentsettings-post-defaultgradingscheme.md index b8b138bdbd1..771bd0edac2 100644 --- a/api-reference/beta/api/educationassignmentsettings-post-defaultgradingscheme.md +++ b/api-reference/beta/api/educationassignmentsettings-post-defaultgradingscheme.md @@ -77,7 +77,6 @@ Content-Type: application/json --- - ### Response The following example shows the response. diff --git a/api-reference/beta/api/educationgradingscheme-get.md b/api-reference/beta/api/educationgradingscheme-get.md index 4d5ad41f3b6..532f6dc4f0d 100644 --- a/api-reference/beta/api/educationgradingscheme-get.md +++ b/api-reference/beta/api/educationgradingscheme-get.md @@ -95,7 +95,6 @@ GET https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f --- - ### Response The following example shows the response. diff --git a/api-reference/beta/api/search-acronym-delete.md b/api-reference/beta/api/search-acronym-delete.md index 2dcd7ddac83..a0ce89785bd 100644 --- a/api-reference/beta/api/search-acronym-delete.md +++ b/api-reference/beta/api/search-acronym-delete.md @@ -98,7 +98,6 @@ DELETE https://graph.microsoft.com/beta/search/acronyms/733b26d5-af76-4eea-ac69- --- - ### Response The following example shows the response. diff --git a/api-reference/beta/api/search-qna-delete.md b/api-reference/beta/api/search-qna-delete.md index 6922d654b58..e6c84bc5746 100644 --- a/api-reference/beta/api/search-qna-delete.md +++ b/api-reference/beta/api/search-qna-delete.md @@ -98,7 +98,6 @@ DELETE https://graph.microsoft.com/beta/search/qnas/733b26d5-af76-4eea-ac69-1a0c --- - ### Response The following example shows the response. diff --git a/api-reference/beta/api/security-analyzedemail-get.md b/api-reference/beta/api/security-analyzedemail-get.md index ae6f85a3693..36ca300cb8f 100644 --- a/api-reference/beta/api/security-analyzedemail-get.md +++ b/api-reference/beta/api/security-analyzedemail-get.md @@ -96,7 +96,6 @@ GET https://graph.microsoft.com/beta/security/collaboration/analyzedEmails/{anal --- - ### Response The following example shows the response. diff --git a/api-reference/beta/api/security-analyzedemail-remediate.md b/api-reference/beta/api/security-analyzedemail-remediate.md index c8b9be2f430..c1aa893d905 100644 --- a/api-reference/beta/api/security-analyzedemail-remediate.md +++ b/api-reference/beta/api/security-analyzedemail-remediate.md @@ -129,7 +129,6 @@ Content-Type: application/json --- - ### Response The following example shows the response. diff --git a/api-reference/beta/api/user-convertexternaltointernalmemberuser.md b/api-reference/beta/api/user-convertexternaltointernalmemberuser.md index bff00e44452..4c0dd2c6f61 100644 --- a/api-reference/beta/api/user-convertexternaltointernalmemberuser.md +++ b/api-reference/beta/api/user-convertexternaltointernalmemberuser.md @@ -85,10 +85,34 @@ Content-type: application/json } ``` +# [C#](#tab/csharp) +[!INCLUDE [sample-code](../includes/snippets/csharp/userthisconvertexternaltointernalmemberuser-cloudonly-csharp-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [CLI](#tab/cli) +[!INCLUDE [sample-code](../includes/snippets/cli/userthisconvertexternaltointernalmemberuser-cloudonly-cli-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Go](#tab/go) +[!INCLUDE [sample-code](../includes/snippets/go/userthisconvertexternaltointernalmemberuser-cloudonly-go-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Java](#tab/java) +[!INCLUDE [sample-code](../includes/snippets/java/userthisconvertexternaltointernalmemberuser-cloudonly-java-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/userthisconvertexternaltointernalmemberuser-cloudonly-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PHP](#tab/php) +[!INCLUDE [sample-code](../includes/snippets/php/userthisconvertexternaltointernalmemberuser-cloudonly-php-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Python](#tab/python) +[!INCLUDE [sample-code](../includes/snippets/python/userthisconvertexternaltointernalmemberuser-cloudonly-python-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + --- #### Response @@ -139,10 +163,34 @@ Content-type: application/json } ``` +# [C#](#tab/csharp) +[!INCLUDE [sample-code](../includes/snippets/csharp/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-csharp-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [CLI](#tab/cli) +[!INCLUDE [sample-code](../includes/snippets/cli/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-cli-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Go](#tab/go) +[!INCLUDE [sample-code](../includes/snippets/go/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-go-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Java](#tab/java) +[!INCLUDE [sample-code](../includes/snippets/java/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-java-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PHP](#tab/php) +[!INCLUDE [sample-code](../includes/snippets/php/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-php-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Python](#tab/python) +[!INCLUDE [sample-code](../includes/snippets/python/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-python-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + --- #### Response @@ -183,10 +231,34 @@ The following example shows a request. POST https://graph.microsoft.com/beta/users/0b8cc234-ef87-4015-9785-cbb42000d41c/convertExternalToInternalMemberUser ``` +# [C#](#tab/csharp) +[!INCLUDE [sample-code](../includes/snippets/csharp/userthisconvertexternaltointernalmemberuser-synceduser-csharp-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [CLI](#tab/cli) +[!INCLUDE [sample-code](../includes/snippets/cli/userthisconvertexternaltointernalmemberuser-synceduser-cli-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Go](#tab/go) +[!INCLUDE [sample-code](../includes/snippets/go/userthisconvertexternaltointernalmemberuser-synceduser-go-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Java](#tab/java) +[!INCLUDE [sample-code](../includes/snippets/java/userthisconvertexternaltointernalmemberuser-synceduser-java-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/userthisconvertexternaltointernalmemberuser-synceduser-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PHP](#tab/php) +[!INCLUDE [sample-code](../includes/snippets/php/userthisconvertexternaltointernalmemberuser-synceduser-php-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Python](#tab/python) +[!INCLUDE [sample-code](../includes/snippets/python/userthisconvertexternaltointernalmemberuser-synceduser-python-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + --- #### Response diff --git a/api-reference/beta/api/windowssetting-get.md b/api-reference/beta/api/windowssetting-get.md index c1a9cb4a041..d0ac0e3d23f 100644 --- a/api-reference/beta/api/windowssetting-get.md +++ b/api-reference/beta/api/windowssetting-get.md @@ -95,7 +95,6 @@ GET https://graph.microsoft.com/beta/me/settings/windows/{windowsSettingId} --- - ### Response The following example shows the response. diff --git a/api-reference/beta/api/windowssetting-list-instances.md b/api-reference/beta/api/windowssetting-list-instances.md index 50ccdd0fe8e..927f04743a9 100644 --- a/api-reference/beta/api/windowssetting-list-instances.md +++ b/api-reference/beta/api/windowssetting-list-instances.md @@ -95,7 +95,6 @@ GET https://graph.microsoft.com/beta/me/settings/windows/{windowsSettingId}/inst --- - ### Response The following example shows the response. diff --git a/api-reference/beta/includes/snippets/cli/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-cli-snippets.md b/api-reference/beta/includes/snippets/cli/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-cli-snippets.md index 74d9c6f42da..4fbd4de9d53 100644 --- a/api-reference/beta/includes/snippets/cli/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-cli-snippets.md +++ b/api-reference/beta/includes/snippets/cli/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-cli-snippets.md @@ -7,6 +7,7 @@ description: "Automatically generated file. DO NOT MODIFY" // THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY mgc-beta device-management virtual-endpoint on-premises-connections create --body '{ \ "displayName": "test-canary-02", \ + "connectionType": "hybridAzureADJoin", \ "type": "hybridAzureADJoin", \ "subscriptionId": "0ac520ee-14c0-480f-b6c9-0a90c585ffff", \ "adDomainName": "contoso001.com", \ diff --git a/api-reference/beta/includes/snippets/cli/get-cloudpconpremisesconnection-withdetails-cli-snippets.md b/api-reference/beta/includes/snippets/cli/get-cloudpconpremisesconnection-withdetails-cli-snippets.md index 8a79a02b523..b1c18c4ffd5 100644 --- a/api-reference/beta/includes/snippets/cli/get-cloudpconpremisesconnection-withdetails-cli-snippets.md +++ b/api-reference/beta/includes/snippets/cli/get-cloudpconpremisesconnection-withdetails-cli-snippets.md @@ -5,6 +5,6 @@ description: "Automatically generated file. DO NOT MODIFY" ```bash // THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY -mgc-beta device-management virtual-endpoint on-premises-connections get --cloud-pc-on-premises-connection-id {cloudPcOnPremisesConnection-id} --select "id,displayName,healthCheckStatus,healthCheckStatusDetails,inUse" +mgc-beta device-management virtual-endpoint on-premises-connections get --cloud-pc-on-premises-connection-id {cloudPcOnPremisesConnection-id} --select "id,displayName,healthCheckStatus,healthCheckStatusDetail,healthCheckStatusDetails,inUse" ``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/cli/get-signins-1-cli-snippets.md b/api-reference/beta/includes/snippets/cli/get-signins-1-cli-snippets.md index 17f769507d9..f92378e314e 100644 --- a/api-reference/beta/includes/snippets/cli/get-signins-1-cli-snippets.md +++ b/api-reference/beta/includes/snippets/cli/get-signins-1-cli-snippets.md @@ -5,6 +5,6 @@ description: "Automatically generated file. DO NOT MODIFY" ```bash // THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY -mgc-beta audit-logs sign-ins list +mgc-beta audit-logs sign-ins list --filter "createdDateTime ge 2024-07-01T00:00:00Z and createdDateTime le 2024-07-14T23:59:59Z" ``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/cli/userthisconvertexternaltointernalmemberuser-cloudonly-cli-snippets.md b/api-reference/beta/includes/snippets/cli/userthisconvertexternaltointernalmemberuser-cloudonly-cli-snippets.md new file mode 100644 index 00000000000..22c9c9585a5 --- /dev/null +++ b/api-reference/beta/includes/snippets/cli/userthisconvertexternaltointernalmemberuser-cloudonly-cli-snippets.md @@ -0,0 +1,17 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```bash + +// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY +mgc-beta users convert-external-to-internal-member-user post --user-id {user-id} --body '{ \ + "userPrincipalName": "AdeleVance@contoso.com", \ + "passwordProfile": { \ + "password": "Zdi087#2jhkahf", \ + "forceChangePasswordNextSignIn": "true" \ + } \ +} \ +' + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/cli/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-cli-snippets.md b/api-reference/beta/includes/snippets/cli/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-cli-snippets.md new file mode 100644 index 00000000000..49f9cf94c64 --- /dev/null +++ b/api-reference/beta/includes/snippets/cli/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-cli-snippets.md @@ -0,0 +1,18 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```bash + +// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY +mgc-beta users convert-external-to-internal-member-user post --user-id {user-id} --body '{ \ + "userPrincipalName": "AdeleVance@contoso.com", \ + "passwordProfile": { \ + "password": "Zdi087#2jhkahf", \ + "forceChangePasswordNextSignIn": "true" \ + }, \ + "mail": "AdeleV@contoso.com" \ +} \ +' + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/cli/userthisconvertexternaltointernalmemberuser-synceduser-cli-snippets.md b/api-reference/beta/includes/snippets/cli/userthisconvertexternaltointernalmemberuser-synceduser-cli-snippets.md new file mode 100644 index 00000000000..82b88de756f --- /dev/null +++ b/api-reference/beta/includes/snippets/cli/userthisconvertexternaltointernalmemberuser-synceduser-cli-snippets.md @@ -0,0 +1,10 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```bash + +// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY +mgc-beta users convert-external-to-internal-member-user post --user-id {user-id} + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/csharp/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-csharp-snippets.md b/api-reference/beta/includes/snippets/csharp/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-csharp-snippets.md index e5d828c3dac..e0eba96a414 100644 --- a/api-reference/beta/includes/snippets/csharp/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-csharp-snippets.md +++ b/api-reference/beta/includes/snippets/csharp/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-csharp-snippets.md @@ -12,6 +12,7 @@ using Microsoft.Graph.Beta.Models; var requestBody = new CloudPcOnPremisesConnection { DisplayName = "test-canary-02", + ConnectionType = CloudPcOnPremisesConnectionType.HybridAzureADJoin, Type = CloudPcOnPremisesConnectionType.HybridAzureADJoin, SubscriptionId = "0ac520ee-14c0-480f-b6c9-0a90c585ffff", AdDomainName = "contoso001.com", diff --git a/api-reference/beta/includes/snippets/csharp/get-cloudpconpremisesconnection-withdetails-csharp-snippets.md b/api-reference/beta/includes/snippets/csharp/get-cloudpconpremisesconnection-withdetails-csharp-snippets.md index 9571088c173..55160464765 100644 --- a/api-reference/beta/includes/snippets/csharp/get-cloudpconpremisesconnection-withdetails-csharp-snippets.md +++ b/api-reference/beta/includes/snippets/csharp/get-cloudpconpremisesconnection-withdetails-csharp-snippets.md @@ -9,7 +9,7 @@ description: "Automatically generated file. DO NOT MODIFY" // To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp var result = await graphClient.DeviceManagement.VirtualEndpoint.OnPremisesConnections["{cloudPcOnPremisesConnection-id}"].GetAsync((requestConfiguration) => { - requestConfiguration.QueryParameters.Select = new string []{ "id","displayName","healthCheckStatus","healthCheckStatusDetails","inUse" }; + requestConfiguration.QueryParameters.Select = new string []{ "id","displayName","healthCheckStatus","healthCheckStatusDetail","healthCheckStatusDetails","inUse" }; }); diff --git a/api-reference/beta/includes/snippets/csharp/get-signins-1-csharp-snippets.md b/api-reference/beta/includes/snippets/csharp/get-signins-1-csharp-snippets.md index 98ace54d6e4..9a457eff592 100644 --- a/api-reference/beta/includes/snippets/csharp/get-signins-1-csharp-snippets.md +++ b/api-reference/beta/includes/snippets/csharp/get-signins-1-csharp-snippets.md @@ -7,7 +7,10 @@ description: "Automatically generated file. DO NOT MODIFY" // Code snippets are only available for the latest version. Current version is 5.x // To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp -var result = await graphClient.AuditLogs.SignIns.GetAsync(); +var result = await graphClient.AuditLogs.SignIns.GetAsync((requestConfiguration) => +{ + requestConfiguration.QueryParameters.Filter = "createdDateTime ge 2024-07-01T00:00:00Z and createdDateTime le 2024-07-14T23:59:59Z"; +}); ``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/csharp/userthisconvertexternaltointernalmemberuser-cloudonly-csharp-snippets.md b/api-reference/beta/includes/snippets/csharp/userthisconvertexternaltointernalmemberuser-cloudonly-csharp-snippets.md new file mode 100644 index 00000000000..8738bd8a94f --- /dev/null +++ b/api-reference/beta/includes/snippets/csharp/userthisconvertexternaltointernalmemberuser-cloudonly-csharp-snippets.md @@ -0,0 +1,27 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```csharp + +// Code snippets are only available for the latest version. Current version is 5.x + +// Dependencies +using Microsoft.Graph.Beta.Users.Item.ConvertExternalToInternalMemberUser; +using Microsoft.Graph.Beta.Models; + +var requestBody = new ConvertExternalToInternalMemberUserPostRequestBody +{ + UserPrincipalName = "AdeleVance@contoso.com", + PasswordProfile = new PasswordProfile + { + Password = "Zdi087#2jhkahf", + ForceChangePasswordNextSignIn = true, + }, +}; + +// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp +var result = await graphClient.Users["{user-id}"].ConvertExternalToInternalMemberUser.PostAsync(requestBody); + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/csharp/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-csharp-snippets.md b/api-reference/beta/includes/snippets/csharp/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-csharp-snippets.md new file mode 100644 index 00000000000..a10b11280be --- /dev/null +++ b/api-reference/beta/includes/snippets/csharp/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-csharp-snippets.md @@ -0,0 +1,28 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```csharp + +// Code snippets are only available for the latest version. Current version is 5.x + +// Dependencies +using Microsoft.Graph.Beta.Users.Item.ConvertExternalToInternalMemberUser; +using Microsoft.Graph.Beta.Models; + +var requestBody = new ConvertExternalToInternalMemberUserPostRequestBody +{ + UserPrincipalName = "AdeleVance@contoso.com", + PasswordProfile = new PasswordProfile + { + Password = "Zdi087#2jhkahf", + ForceChangePasswordNextSignIn = true, + }, + Mail = "AdeleV@contoso.com", +}; + +// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp +var result = await graphClient.Users["{user-id}"].ConvertExternalToInternalMemberUser.PostAsync(requestBody); + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/csharp/userthisconvertexternaltointernalmemberuser-synceduser-csharp-snippets.md b/api-reference/beta/includes/snippets/csharp/userthisconvertexternaltointernalmemberuser-synceduser-csharp-snippets.md new file mode 100644 index 00000000000..caa955a82db --- /dev/null +++ b/api-reference/beta/includes/snippets/csharp/userthisconvertexternaltointernalmemberuser-synceduser-csharp-snippets.md @@ -0,0 +1,13 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```csharp + +// Code snippets are only available for the latest version. Current version is 5.x + +// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp +var result = await graphClient.Users["{user-id}"].ConvertExternalToInternalMemberUser.PostAsync(null); + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/go/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-go-snippets.md b/api-reference/beta/includes/snippets/go/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-go-snippets.md index 71042a1b1b9..8085ccb05f2 100644 --- a/api-reference/beta/includes/snippets/go/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-go-snippets.md +++ b/api-reference/beta/includes/snippets/go/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-go-snippets.md @@ -18,6 +18,8 @@ graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) requestBody := graphmodels.NewCloudPcOnPremisesConnection() displayName := "test-canary-02" requestBody.SetDisplayName(&displayName) +connectionType := graphmodels.HYBRIDAZUREADJOIN_CLOUDPCONPREMISESCONNECTIONTYPE +requestBody.SetConnectionType(&connectionType) type := graphmodels.HYBRIDAZUREADJOIN_CLOUDPCONPREMISESCONNECTIONTYPE requestBody.SetType(&type) subscriptionId := "0ac520ee-14c0-480f-b6c9-0a90c585ffff" diff --git a/api-reference/beta/includes/snippets/go/get-cloudpconpremisesconnection-withdetails-go-snippets.md b/api-reference/beta/includes/snippets/go/get-cloudpconpremisesconnection-withdetails-go-snippets.md index be15e5641e9..0b06fe4265e 100644 --- a/api-reference/beta/includes/snippets/go/get-cloudpconpremisesconnection-withdetails-go-snippets.md +++ b/api-reference/beta/includes/snippets/go/get-cloudpconpremisesconnection-withdetails-go-snippets.md @@ -16,7 +16,7 @@ graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) requestParameters := &graphdevicemanagement.DeviceManagementVirtualEndpointOnPremisesConnectionItemRequestBuilderGetQueryParameters{ - Select: [] string {"id","displayName","healthCheckStatus","healthCheckStatusDetails","inUse"}, + Select: [] string {"id","displayName","healthCheckStatus","healthCheckStatusDetail","healthCheckStatusDetails","inUse"}, } configuration := &graphdevicemanagement.DeviceManagementVirtualEndpointOnPremisesConnectionItemRequestBuilderGetRequestConfiguration{ QueryParameters: requestParameters, diff --git a/api-reference/beta/includes/snippets/go/get-signins-1-go-snippets.md b/api-reference/beta/includes/snippets/go/get-signins-1-go-snippets.md index 55254fa19d1..f036b091f1a 100644 --- a/api-reference/beta/includes/snippets/go/get-signins-1-go-snippets.md +++ b/api-reference/beta/includes/snippets/go/get-signins-1-go-snippets.md @@ -8,6 +8,7 @@ description: "Automatically generated file. DO NOT MODIFY" import ( "context" msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go" + graphauditlogs "github.com/microsoftgraph/msgraph-beta-sdk-go/auditlogs" //other-imports ) @@ -15,7 +16,16 @@ graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) -signIns, err := graphClient.AuditLogs().SignIns().Get(context.Background(), nil) +requestFilter := "createdDateTime ge 2024-07-01T00:00:00Z and createdDateTime le 2024-07-14T23:59:59Z" + +requestParameters := &graphauditlogs.AuditLogsSignInsRequestBuilderGetQueryParameters{ + Filter: &requestFilter, +} +configuration := &graphauditlogs.AuditLogsSignInsRequestBuilderGetRequestConfiguration{ + QueryParameters: requestParameters, +} + +signIns, err := graphClient.AuditLogs().SignIns().Get(context.Background(), configuration) ``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/go/userthisconvertexternaltointernalmemberuser-cloudonly-go-snippets.md b/api-reference/beta/includes/snippets/go/userthisconvertexternaltointernalmemberuser-cloudonly-go-snippets.md new file mode 100644 index 00000000000..442ac28b92d --- /dev/null +++ b/api-reference/beta/includes/snippets/go/userthisconvertexternaltointernalmemberuser-cloudonly-go-snippets.md @@ -0,0 +1,32 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```go + + +import ( + "context" + msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go" + graphusers "github.com/microsoftgraph/msgraph-beta-sdk-go/users" + graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models" + //other-imports +) + +graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) + + +requestBody := graphusers.NewConvertExternalToInternalMemberUserPostRequestBody() +userPrincipalName := "AdeleVance@contoso.com" +requestBody.SetUserPrincipalName(&userPrincipalName) +passwordProfile := graphmodels.NewPasswordProfile() +password := "Zdi087#2jhkahf" +passwordProfile.SetPassword(&password) +forceChangePasswordNextSignIn := true +passwordProfile.SetForceChangePasswordNextSignIn(&forceChangePasswordNextSignIn) +requestBody.SetPasswordProfile(passwordProfile) + +convertExternalToInternalMemberUser, err := graphClient.Users().ByUserId("user-id").ConvertExternalToInternalMemberUser().Post(context.Background(), requestBody, nil) + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/go/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-go-snippets.md b/api-reference/beta/includes/snippets/go/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-go-snippets.md new file mode 100644 index 00000000000..f6b8797067f --- /dev/null +++ b/api-reference/beta/includes/snippets/go/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-go-snippets.md @@ -0,0 +1,34 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```go + + +import ( + "context" + msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go" + graphusers "github.com/microsoftgraph/msgraph-beta-sdk-go/users" + graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models" + //other-imports +) + +graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) + + +requestBody := graphusers.NewConvertExternalToInternalMemberUserPostRequestBody() +userPrincipalName := "AdeleVance@contoso.com" +requestBody.SetUserPrincipalName(&userPrincipalName) +passwordProfile := graphmodels.NewPasswordProfile() +password := "Zdi087#2jhkahf" +passwordProfile.SetPassword(&password) +forceChangePasswordNextSignIn := true +passwordProfile.SetForceChangePasswordNextSignIn(&forceChangePasswordNextSignIn) +requestBody.SetPasswordProfile(passwordProfile) +mail := "AdeleV@contoso.com" +requestBody.SetMail(&mail) + +convertExternalToInternalMemberUser, err := graphClient.Users().ByUserId("user-id").ConvertExternalToInternalMemberUser().Post(context.Background(), requestBody, nil) + + +``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/go/intune-apps-enterprisecodesigningcertificate-list-list-enterprisecodesigningcertificates-go-snippets.md b/api-reference/beta/includes/snippets/go/userthisconvertexternaltointernalmemberuser-synceduser-go-snippets.md similarity index 63% rename from api-reference/v1.0/includes/snippets/go/intune-apps-enterprisecodesigningcertificate-list-list-enterprisecodesigningcertificates-go-snippets.md rename to api-reference/beta/includes/snippets/go/userthisconvertexternaltointernalmemberuser-synceduser-go-snippets.md index 48e7b22cd8f..0ee4d71318d 100644 --- a/api-reference/v1.0/includes/snippets/go/intune-apps-enterprisecodesigningcertificate-list-list-enterprisecodesigningcertificates-go-snippets.md +++ b/api-reference/beta/includes/snippets/go/userthisconvertexternaltointernalmemberuser-synceduser-go-snippets.md @@ -15,7 +15,7 @@ graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) -enterpriseCodeSigningCertificates, err := graphClient.DeviceAppManagement().EnterpriseCodeSigningCertificates().Get(context.Background(), nil) +convertExternalToInternalMemberUser, err := graphClient.Users().ByUserId("user-id").ConvertExternalToInternalMemberUser().Post(context.Background(), nil) ``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/java/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-java-snippets.md b/api-reference/beta/includes/snippets/java/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-java-snippets.md index f8ef8d69cdb..7bb754f032c 100644 --- a/api-reference/beta/includes/snippets/java/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-java-snippets.md +++ b/api-reference/beta/includes/snippets/java/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-java-snippets.md @@ -10,6 +10,7 @@ GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); CloudPcOnPremisesConnection cloudPcOnPremisesConnection = new CloudPcOnPremisesConnection(); cloudPcOnPremisesConnection.setDisplayName("test-canary-02"); +cloudPcOnPremisesConnection.setConnectionType(CloudPcOnPremisesConnectionType.HybridAzureADJoin); cloudPcOnPremisesConnection.setType(CloudPcOnPremisesConnectionType.HybridAzureADJoin); cloudPcOnPremisesConnection.setSubscriptionId("0ac520ee-14c0-480f-b6c9-0a90c585ffff"); cloudPcOnPremisesConnection.setAdDomainName("contoso001.com"); diff --git a/api-reference/beta/includes/snippets/java/get-cloudpconpremisesconnection-withdetails-java-snippets.md b/api-reference/beta/includes/snippets/java/get-cloudpconpremisesconnection-withdetails-java-snippets.md index 9b9a8fa4d3f..3e01dc26fb2 100644 --- a/api-reference/beta/includes/snippets/java/get-cloudpconpremisesconnection-withdetails-java-snippets.md +++ b/api-reference/beta/includes/snippets/java/get-cloudpconpremisesconnection-withdetails-java-snippets.md @@ -9,7 +9,7 @@ description: "Automatically generated file. DO NOT MODIFY" GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); CloudPcOnPremisesConnection result = graphClient.deviceManagement().virtualEndpoint().onPremisesConnections().byCloudPcOnPremisesConnectionId("{cloudPcOnPremisesConnection-id}").get(requestConfiguration -> { - requestConfiguration.queryParameters.select = new String []{"id", "displayName", "healthCheckStatus", "healthCheckStatusDetails", "inUse"}; + requestConfiguration.queryParameters.select = new String []{"id", "displayName", "healthCheckStatus", "healthCheckStatusDetail", "healthCheckStatusDetails", "inUse"}; }); diff --git a/api-reference/beta/includes/snippets/java/get-signins-1-java-snippets.md b/api-reference/beta/includes/snippets/java/get-signins-1-java-snippets.md index 9da0382511b..3f4023a1445 100644 --- a/api-reference/beta/includes/snippets/java/get-signins-1-java-snippets.md +++ b/api-reference/beta/includes/snippets/java/get-signins-1-java-snippets.md @@ -8,7 +8,9 @@ description: "Automatically generated file. DO NOT MODIFY" GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); -SignInCollectionResponse result = graphClient.auditLogs().signIns().get(); +SignInCollectionResponse result = graphClient.auditLogs().signIns().get(requestConfiguration -> { + requestConfiguration.queryParameters.filter = "createdDateTime ge 2024-07-01T00:00:00Z and createdDateTime le 2024-07-14T23:59:59Z"; +}); ``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/java/userthisconvertexternaltointernalmemberuser-cloudonly-java-snippets.md b/api-reference/beta/includes/snippets/java/userthisconvertexternaltointernalmemberuser-cloudonly-java-snippets.md new file mode 100644 index 00000000000..401c73f8d24 --- /dev/null +++ b/api-reference/beta/includes/snippets/java/userthisconvertexternaltointernalmemberuser-cloudonly-java-snippets.md @@ -0,0 +1,20 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```java + +// Code snippets are only available for the latest version. Current version is 6.x + +GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); + +com.microsoft.graph.beta.users.item.convertexternaltointernalmemberuser.ConvertExternalToInternalMemberUserPostRequestBody convertExternalToInternalMemberUserPostRequestBody = new com.microsoft.graph.beta.users.item.convertexternaltointernalmemberuser.ConvertExternalToInternalMemberUserPostRequestBody(); +convertExternalToInternalMemberUserPostRequestBody.setUserPrincipalName("AdeleVance@contoso.com"); +PasswordProfile passwordProfile = new PasswordProfile(); +passwordProfile.setPassword("Zdi087#2jhkahf"); +passwordProfile.setForceChangePasswordNextSignIn(true); +convertExternalToInternalMemberUserPostRequestBody.setPasswordProfile(passwordProfile); +var result = graphClient.users().byUserId("{user-id}").convertExternalToInternalMemberUser().post(convertExternalToInternalMemberUserPostRequestBody); + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/java/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-java-snippets.md b/api-reference/beta/includes/snippets/java/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-java-snippets.md new file mode 100644 index 00000000000..1d613b58508 --- /dev/null +++ b/api-reference/beta/includes/snippets/java/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-java-snippets.md @@ -0,0 +1,21 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```java + +// Code snippets are only available for the latest version. Current version is 6.x + +GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); + +com.microsoft.graph.beta.users.item.convertexternaltointernalmemberuser.ConvertExternalToInternalMemberUserPostRequestBody convertExternalToInternalMemberUserPostRequestBody = new com.microsoft.graph.beta.users.item.convertexternaltointernalmemberuser.ConvertExternalToInternalMemberUserPostRequestBody(); +convertExternalToInternalMemberUserPostRequestBody.setUserPrincipalName("AdeleVance@contoso.com"); +PasswordProfile passwordProfile = new PasswordProfile(); +passwordProfile.setPassword("Zdi087#2jhkahf"); +passwordProfile.setForceChangePasswordNextSignIn(true); +convertExternalToInternalMemberUserPostRequestBody.setPasswordProfile(passwordProfile); +convertExternalToInternalMemberUserPostRequestBody.setMail("AdeleV@contoso.com"); +var result = graphClient.users().byUserId("{user-id}").convertExternalToInternalMemberUser().post(convertExternalToInternalMemberUserPostRequestBody); + + +``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/java/intune-apps-enterprisecodesigningcertificate-list-list-enterprisecodesigningcertificates-java-snippets.md b/api-reference/beta/includes/snippets/java/userthisconvertexternaltointernalmemberuser-synceduser-java-snippets.md similarity index 63% rename from api-reference/v1.0/includes/snippets/java/intune-apps-enterprisecodesigningcertificate-list-list-enterprisecodesigningcertificates-java-snippets.md rename to api-reference/beta/includes/snippets/java/userthisconvertexternaltointernalmemberuser-synceduser-java-snippets.md index eea34d41d3c..b5fce821104 100644 --- a/api-reference/v1.0/includes/snippets/java/intune-apps-enterprisecodesigningcertificate-list-list-enterprisecodesigningcertificates-java-snippets.md +++ b/api-reference/beta/includes/snippets/java/userthisconvertexternaltointernalmemberuser-synceduser-java-snippets.md @@ -8,7 +8,7 @@ description: "Automatically generated file. DO NOT MODIFY" GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); -EnterpriseCodeSigningCertificateCollectionResponse result = graphClient.deviceAppManagement().enterpriseCodeSigningCertificates().get(); +var result = graphClient.users().byUserId("{user-id}").convertExternalToInternalMemberUser().post(null); ``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/javascript/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-javascript-snippets.md b/api-reference/beta/includes/snippets/javascript/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-javascript-snippets.md index d94ba43505b..f772b2760c6 100644 --- a/api-reference/beta/includes/snippets/javascript/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-javascript-snippets.md +++ b/api-reference/beta/includes/snippets/javascript/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-javascript-snippets.md @@ -12,6 +12,7 @@ const client = Client.init(options); const cloudPcOnPremisesConnection = { displayName: 'test-canary-02', + connectionType: 'hybridAzureADJoin', type: 'hybridAzureADJoin', subscriptionId: '0ac520ee-14c0-480f-b6c9-0a90c585ffff', adDomainName: 'contoso001.com', diff --git a/api-reference/beta/includes/snippets/javascript/download-item-content-stream-javascript-snippets.md b/api-reference/beta/includes/snippets/javascript/download-item-content-stream-javascript-snippets.md new file mode 100644 index 00000000000..29139fbeec7 --- /dev/null +++ b/api-reference/beta/includes/snippets/javascript/download-item-content-stream-javascript-snippets.md @@ -0,0 +1,17 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```javascript + +const options = { + authProvider, +}; + +const client = Client.init(options); + +let contentStream = await client.api('/drives/b!fMInbiL5dkK51VbATG0ddrCg6AJpEj9Lm4uGj5HgEi4guyuYp4W5SbH4dPfXTbCF/items/014Y52UITTNSVUQI43PZBJMKLAY6LJBUVE/contentStream') + .version('beta') + .get(); + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/javascript/download-item-partial-stream-javascript-snippets.md b/api-reference/beta/includes/snippets/javascript/download-item-partial-stream-javascript-snippets.md new file mode 100644 index 00000000000..7a586321650 --- /dev/null +++ b/api-reference/beta/includes/snippets/javascript/download-item-partial-stream-javascript-snippets.md @@ -0,0 +1,18 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```javascript + +const options = { + authProvider, +}; + +const client = Client.init(options); + +let contentStream = await client.api('/drives/b!fMInbiL5dkK51VbATG0ddrCg6AJpEj9Lm4uGj5HgEi4guyuYp4W5SbH4dPfXTbCF/items/014Y52UITTNSVUQI43PZBJMKLAY6LJBUVE/contentStream') + .version('beta') + .header('Range','bytes=0-1023') + .get(); + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/javascript/get-cloudpconpremisesconnection-withdetails-javascript-snippets.md b/api-reference/beta/includes/snippets/javascript/get-cloudpconpremisesconnection-withdetails-javascript-snippets.md index 2a16f680cf3..c974e96eeb7 100644 --- a/api-reference/beta/includes/snippets/javascript/get-cloudpconpremisesconnection-withdetails-javascript-snippets.md +++ b/api-reference/beta/includes/snippets/javascript/get-cloudpconpremisesconnection-withdetails-javascript-snippets.md @@ -12,7 +12,7 @@ const client = Client.init(options); let cloudPcOnPremisesConnection = await client.api('/deviceManagement/virtualEndpoint/onPremisesConnections/{id}') .version('beta') - .select('id,displayName,healthCheckStatus,healthCheckStatusDetails,inUse') + .select('id,displayName,healthCheckStatus,healthCheckStatusDetail,healthCheckStatusDetails,inUse') .get(); ``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/javascript/get-signins-1-javascript-snippets.md b/api-reference/beta/includes/snippets/javascript/get-signins-1-javascript-snippets.md index 9d0ec12eaea..8d03ffe1b22 100644 --- a/api-reference/beta/includes/snippets/javascript/get-signins-1-javascript-snippets.md +++ b/api-reference/beta/includes/snippets/javascript/get-signins-1-javascript-snippets.md @@ -12,6 +12,7 @@ const client = Client.init(options); let signIns = await client.api('/auditLogs/signIns') .version('beta') + .filter('createdDateTime ge 2024-07-01T00:00:00Z and createdDateTime le 2024-07-14T23:59:59Z') .get(); ``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/javascript/userthisconvertexternaltointernalmemberuser-cloudonly-javascript-snippets.md b/api-reference/beta/includes/snippets/javascript/userthisconvertexternaltointernalmemberuser-cloudonly-javascript-snippets.md index 453091ce8fd..798fe86cacb 100644 --- a/api-reference/beta/includes/snippets/javascript/userthisconvertexternaltointernalmemberuser-cloudonly-javascript-snippets.md +++ b/api-reference/beta/includes/snippets/javascript/userthisconvertexternaltointernalmemberuser-cloudonly-javascript-snippets.md @@ -10,7 +10,7 @@ const options = { const client = Client.init(options); -const convertExternalToInternalMemberUser = { +const conversionUserDetails = { userPrincipalName: 'AdeleVance@contoso.com', passwordProfile: { password: 'Zdi087#2jhkahf', @@ -20,6 +20,6 @@ const convertExternalToInternalMemberUser = { await client.api('/users/0b8cc234-ef87-4015-9785-cbb42000d41c/convertExternalToInternalMemberUser') .version('beta') - .post(convertExternalToInternalMemberUser); + .post(conversionUserDetails); ``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/javascript/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-javascript-snippets.md b/api-reference/beta/includes/snippets/javascript/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-javascript-snippets.md index 1eab525f245..9615a2c340d 100644 --- a/api-reference/beta/includes/snippets/javascript/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-javascript-snippets.md +++ b/api-reference/beta/includes/snippets/javascript/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-javascript-snippets.md @@ -10,7 +10,7 @@ const options = { const client = Client.init(options); -const convertExternalToInternalMemberUser = { +const conversionUserDetails = { userPrincipalName: 'AdeleVance@contoso.com', passwordProfile: { password: 'Zdi087#2jhkahf', @@ -21,6 +21,6 @@ const convertExternalToInternalMemberUser = { await client.api('/users/0b8cc234-ef87-4015-9785-cbb42000d41c/convertExternalToInternalMemberUser') .version('beta') - .post(convertExternalToInternalMemberUser); + .post(conversionUserDetails); ``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/php/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-php-snippets.md b/api-reference/beta/includes/snippets/php/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-php-snippets.md index 83d4ca3e58f..057c7336998 100644 --- a/api-reference/beta/includes/snippets/php/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-php-snippets.md +++ b/api-reference/beta/includes/snippets/php/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-php-snippets.md @@ -11,6 +11,7 @@ $graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes); $requestBody = new CloudPcOnPremisesConnection(); $requestBody->setDisplayName('test-canary-02'); +$requestBody->setConnectionType(new CloudPcOnPremisesConnectionType('hybridAzureADJoin')); $requestBody->setType(new CloudPcOnPremisesConnectionType('hybridAzureADJoin')); $requestBody->setSubscriptionId('0ac520ee-14c0-480f-b6c9-0a90c585ffff'); $requestBody->setAdDomainName('contoso001.com'); diff --git a/api-reference/beta/includes/snippets/php/get-cloudpconpremisesconnection-withdetails-php-snippets.md b/api-reference/beta/includes/snippets/php/get-cloudpconpremisesconnection-withdetails-php-snippets.md index 1cb08c127d3..1334da3f6d3 100644 --- a/api-reference/beta/includes/snippets/php/get-cloudpconpremisesconnection-withdetails-php-snippets.md +++ b/api-reference/beta/includes/snippets/php/get-cloudpconpremisesconnection-withdetails-php-snippets.md @@ -11,7 +11,7 @@ $graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes); $requestConfiguration = new CloudPcOnPremisesConnectionItemRequestBuilderGetRequestConfiguration(); $queryParameters = CloudPcOnPremisesConnectionItemRequestBuilderGetRequestConfiguration::createQueryParameters(); -$queryParameters->select = ["id","displayName","healthCheckStatus","healthCheckStatusDetails","inUse"]; +$queryParameters->select = ["id","displayName","healthCheckStatus","healthCheckStatusDetail","healthCheckStatusDetails","inUse"]; $requestConfiguration->queryParameters = $queryParameters; diff --git a/api-reference/beta/includes/snippets/php/get-signins-1-php-snippets.md b/api-reference/beta/includes/snippets/php/get-signins-1-php-snippets.md index e2d2ec0efc5..3c6d38b5930 100644 --- a/api-reference/beta/includes/snippets/php/get-signins-1-php-snippets.md +++ b/api-reference/beta/includes/snippets/php/get-signins-1-php-snippets.md @@ -9,7 +9,12 @@ description: "Automatically generated file. DO NOT MODIFY" $graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes); +$requestConfiguration = new SignInsRequestBuilderGetRequestConfiguration(); +$queryParameters = SignInsRequestBuilderGetRequestConfiguration::createQueryParameters(); +$queryParameters->filter = "createdDateTime ge 2024-07-01T00:00:00Z and createdDateTime le 2024-07-14T23:59:59Z"; +$requestConfiguration->queryParameters = $queryParameters; -$result = $graphServiceClient->auditLogs()->signIns()->get()->wait(); + +$result = $graphServiceClient->auditLogs()->signIns()->get($requestConfiguration)->wait(); ``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/php/userthisconvertexternaltointernalmemberuser-cloudonly-php-snippets.md b/api-reference/beta/includes/snippets/php/userthisconvertexternaltointernalmemberuser-cloudonly-php-snippets.md new file mode 100644 index 00000000000..65463c49932 --- /dev/null +++ b/api-reference/beta/includes/snippets/php/userthisconvertexternaltointernalmemberuser-cloudonly-php-snippets.md @@ -0,0 +1,21 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```php + +setUserPrincipalName('AdeleVance@contoso.com'); +$passwordProfile = new PasswordProfile(); +$passwordProfile->setPassword('Zdi087#2jhkahf'); +$passwordProfile->setForceChangePasswordNextSignIn(true); +$requestBody->setPasswordProfile($passwordProfile); + +$result = $graphServiceClient->users()->byUserId('user-id')->convertExternalToInternalMemberUser()->post($requestBody)->wait(); + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/php/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-php-snippets.md b/api-reference/beta/includes/snippets/php/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-php-snippets.md new file mode 100644 index 00000000000..6da0f8893e1 --- /dev/null +++ b/api-reference/beta/includes/snippets/php/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-php-snippets.md @@ -0,0 +1,22 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```php + +setUserPrincipalName('AdeleVance@contoso.com'); +$passwordProfile = new PasswordProfile(); +$passwordProfile->setPassword('Zdi087#2jhkahf'); +$passwordProfile->setForceChangePasswordNextSignIn(true); +$requestBody->setPasswordProfile($passwordProfile); +$requestBody->setMail('AdeleV@contoso.com'); + +$result = $graphServiceClient->users()->byUserId('user-id')->convertExternalToInternalMemberUser()->post($requestBody)->wait(); + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/php/userthisconvertexternaltointernalmemberuser-synceduser-php-snippets.md b/api-reference/beta/includes/snippets/php/userthisconvertexternaltointernalmemberuser-synceduser-php-snippets.md new file mode 100644 index 00000000000..2a6409a7868 --- /dev/null +++ b/api-reference/beta/includes/snippets/php/userthisconvertexternaltointernalmemberuser-synceduser-php-snippets.md @@ -0,0 +1,15 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```php + +users()->byUserId('user-id')->convertExternalToInternalMemberUser()->post()->wait(); + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/powershell/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-powershell-snippets.md b/api-reference/beta/includes/snippets/powershell/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-powershell-snippets.md index daaf3d2eb66..a7108069b6c 100644 --- a/api-reference/beta/includes/snippets/powershell/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-powershell-snippets.md +++ b/api-reference/beta/includes/snippets/powershell/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-powershell-snippets.md @@ -8,6 +8,7 @@ Import-Module Microsoft.Graph.Beta.DeviceManagement.Administration $params = @{ displayName = "test-canary-02" + connectionType = "hybridAzureADJoin" type = "hybridAzureADJoin" subscriptionId = "0ac520ee-14c0-480f-b6c9-0a90c585ffff" adDomainName = "contoso001.com" diff --git a/api-reference/beta/includes/snippets/powershell/get-cloudpconpremisesconnection-withdetails-powershell-snippets.md b/api-reference/beta/includes/snippets/powershell/get-cloudpconpremisesconnection-withdetails-powershell-snippets.md index f69a75f821b..87e2adff751 100644 --- a/api-reference/beta/includes/snippets/powershell/get-cloudpconpremisesconnection-withdetails-powershell-snippets.md +++ b/api-reference/beta/includes/snippets/powershell/get-cloudpconpremisesconnection-withdetails-powershell-snippets.md @@ -6,6 +6,6 @@ description: "Automatically generated file. DO NOT MODIFY" Import-Module Microsoft.Graph.Beta.DeviceManagement.Administration -Get-MgBetaDeviceManagementVirtualEndpointOnPremiseConnection -CloudPcOnPremisesConnectionId $cloudPcOnPremisesConnectionId -Property "id,displayName,healthCheckStatus,healthCheckStatusDetails,inUse" +Get-MgBetaDeviceManagementVirtualEndpointOnPremiseConnection -CloudPcOnPremisesConnectionId $cloudPcOnPremisesConnectionId -Property "id,displayName,healthCheckStatus,healthCheckStatusDetail,healthCheckStatusDetails,inUse" ``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/powershell/get-signins-1-powershell-snippets.md b/api-reference/beta/includes/snippets/powershell/get-signins-1-powershell-snippets.md index 7cca3fb67c8..c3362b65c34 100644 --- a/api-reference/beta/includes/snippets/powershell/get-signins-1-powershell-snippets.md +++ b/api-reference/beta/includes/snippets/powershell/get-signins-1-powershell-snippets.md @@ -6,6 +6,6 @@ description: "Automatically generated file. DO NOT MODIFY" Import-Module Microsoft.Graph.Beta.Reports -Get-MgBetaAuditLogSignIn +Get-MgBetaAuditLogSignIn -Filter "createdDateTime ge 2024-07-01T00:00:00Z and createdDateTime le 2024-07-14T23:59:59Z" ``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/python/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-python-snippets.md b/api-reference/beta/includes/snippets/python/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-python-snippets.md index d4e874a5d72..3528d99db1a 100644 --- a/api-reference/beta/includes/snippets/python/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-python-snippets.md +++ b/api-reference/beta/includes/snippets/python/create-cloudpconpremisesconnection-from-cloudpconpremisesconnection-python-snippets.md @@ -11,6 +11,7 @@ graph_client = GraphServiceClient(credentials, scopes) request_body = CloudPcOnPremisesConnection( display_name = "test-canary-02", + connection_type = CloudPcOnPremisesConnectionType.HybridAzureADJoin, type = CloudPcOnPremisesConnectionType.HybridAzureADJoin, subscription_id = "0ac520ee-14c0-480f-b6c9-0a90c585ffff", ad_domain_name = "contoso001.com", diff --git a/api-reference/beta/includes/snippets/python/get-cloudpconpremisesconnection-withdetails-python-snippets.md b/api-reference/beta/includes/snippets/python/get-cloudpconpremisesconnection-withdetails-python-snippets.md index 9749e9214e2..68a2a4899b2 100644 --- a/api-reference/beta/includes/snippets/python/get-cloudpconpremisesconnection-withdetails-python-snippets.md +++ b/api-reference/beta/includes/snippets/python/get-cloudpconpremisesconnection-withdetails-python-snippets.md @@ -10,7 +10,7 @@ from msgraph.generated.deviceManagement.virtualEndpoint.onPremisesConnections.it graph_client = GraphServiceClient(credentials, scopes) query_params = CloudPcOnPremisesConnectionItemRequestBuilder.CloudPcOnPremisesConnectionItemRequestBuilderGetQueryParameters( - select = ["id","displayName","healthCheckStatus","healthCheckStatusDetails","inUse"], + select = ["id","displayName","healthCheckStatus","healthCheckStatusDetail","healthCheckStatusDetails","inUse"], ) request_configuration = CloudPcOnPremisesConnectionItemRequestBuilder.CloudPcOnPremisesConnectionItemRequestBuilderGetRequestConfiguration( diff --git a/api-reference/beta/includes/snippets/python/get-signins-1-python-snippets.md b/api-reference/beta/includes/snippets/python/get-signins-1-python-snippets.md index ea84edd69fd..9f0c626b962 100644 --- a/api-reference/beta/includes/snippets/python/get-signins-1-python-snippets.md +++ b/api-reference/beta/includes/snippets/python/get-signins-1-python-snippets.md @@ -5,11 +5,19 @@ description: "Automatically generated file. DO NOT MODIFY" ```python from msgraph import GraphServiceClient +from msgraph.generated.auditLogs.signIns.sign_ins_request_builder import SignInsRequestBuilder graph_client = GraphServiceClient(credentials, scopes) +query_params = SignInsRequestBuilder.SignInsRequestBuilderGetQueryParameters( + filter = "createdDateTime ge 2024-07-01T00:00:00Z and createdDateTime le 2024-07-14T23:59:59Z", +) -result = await graph_client.audit_logs.sign_ins.get() +request_configuration = SignInsRequestBuilder.SignInsRequestBuilderGetRequestConfiguration( +query_parameters = query_params, +) + +result = await graph_client.audit_logs.sign_ins.get(request_configuration = request_configuration) ``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/python/userthisconvertexternaltointernalmemberuser-cloudonly-python-snippets.md b/api-reference/beta/includes/snippets/python/userthisconvertexternaltointernalmemberuser-cloudonly-python-snippets.md new file mode 100644 index 00000000000..07e90fac513 --- /dev/null +++ b/api-reference/beta/includes/snippets/python/userthisconvertexternaltointernalmemberuser-cloudonly-python-snippets.md @@ -0,0 +1,24 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```python + +from msgraph import GraphServiceClient +from msgraph.generated.models.convert_external_to_internal_member_user_post_request_body import ConvertExternalToInternalMemberUserPostRequestBody +from msgraph.generated.models.password_profile import PasswordProfile + +graph_client = GraphServiceClient(credentials, scopes) + +request_body = ConvertExternalToInternalMemberUserPostRequestBody( + user_principal_name = "AdeleVance@contoso.com", + password_profile = PasswordProfile( + password = "Zdi087#2jhkahf", + force_change_password_next_sign_in = True, + ), +) + +result = await graph_client.users.by_user_id('user-id').convert_external_to_internal_member_user.post(request_body) + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/python/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-python-snippets.md b/api-reference/beta/includes/snippets/python/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-python-snippets.md new file mode 100644 index 00000000000..4d84cf953d8 --- /dev/null +++ b/api-reference/beta/includes/snippets/python/userthisconvertexternaltointernalmemberuser-cloudonly-with-mail-python-snippets.md @@ -0,0 +1,25 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```python + +from msgraph import GraphServiceClient +from msgraph.generated.models.convert_external_to_internal_member_user_post_request_body import ConvertExternalToInternalMemberUserPostRequestBody +from msgraph.generated.models.password_profile import PasswordProfile + +graph_client = GraphServiceClient(credentials, scopes) + +request_body = ConvertExternalToInternalMemberUserPostRequestBody( + user_principal_name = "AdeleVance@contoso.com", + password_profile = PasswordProfile( + password = "Zdi087#2jhkahf", + force_change_password_next_sign_in = True, + ), + mail = "AdeleV@contoso.com", +) + +result = await graph_client.users.by_user_id('user-id').convert_external_to_internal_member_user.post(request_body) + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/python/userthisconvertexternaltointernalmemberuser-synceduser-python-snippets.md b/api-reference/beta/includes/snippets/python/userthisconvertexternaltointernalmemberuser-synceduser-python-snippets.md new file mode 100644 index 00000000000..f471c44097f --- /dev/null +++ b/api-reference/beta/includes/snippets/python/userthisconvertexternaltointernalmemberuser-synceduser-python-snippets.md @@ -0,0 +1,15 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```python + +from msgraph import GraphServiceClient + +graph_client = GraphServiceClient(credentials, scopes) + + +result = await graph_client.users.by_user_id('user-id').convert_external_to_internal_member_user.post(None) + + +``` \ No newline at end of file diff --git a/api-reference/v1.0/api/entitlementmanagement-post-resourcerequests.md b/api-reference/v1.0/api/entitlementmanagement-post-resourcerequests.md index d4b91c779df..2f173cd7042 100644 --- a/api-reference/v1.0/api/entitlementmanagement-post-resourcerequests.md +++ b/api-reference/v1.0/api/entitlementmanagement-post-resourcerequests.md @@ -410,6 +410,7 @@ The following example shows a request to update a resource in a catalog, for an The following example shows a request. +# [HTTP](#tab/http) ``` http GET https://graph.microsoft.com/v1.0/deviceAppManagement/enterpriseCodeSigningCertificates ``` -# [C#](#tab/csharp) -[!INCLUDE [sample-code](../includes/snippets/csharp/intune-apps-enterprisecodesigningcertificate-list-list-enterprisecodesigningcertificates-csharp-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [CLI](#tab/cli) -[!INCLUDE [sample-code](../includes/snippets/cli/intune-apps-enterprisecodesigningcertificate-list-list-enterprisecodesigningcertificates-cli-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [Go](#tab/go) -[!INCLUDE [sample-code](../includes/snippets/go/intune-apps-enterprisecodesigningcertificate-list-list-enterprisecodesigningcertificates-go-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [Java](#tab/java) -[!INCLUDE [sample-code](../includes/snippets/java/intune-apps-enterprisecodesigningcertificate-list-list-enterprisecodesigningcertificates-java-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [JavaScript](#tab/javascript) -[!INCLUDE [sample-code](../includes/snippets/javascript/intune-apps-enterprisecodesigningcertificate-list-list-enterprisecodesigningcertificates-javascript-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [PHP](#tab/php) -[!INCLUDE [sample-code](../includes/snippets/php/intune-apps-enterprisecodesigningcertificate-list-list-enterprisecodesigningcertificates-php-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [PowerShell](#tab/powershell) -[!INCLUDE [sample-code](../includes/snippets/powershell/intune-apps-enterprisecodesigningcertificate-list-list-enterprisecodesigningcertificates-powershell-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [Python](#tab/python) -[!INCLUDE [sample-code](../includes/snippets/python/intune-apps-enterprisecodesigningcertificate-list-list-enterprisecodesigningcertificates-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. diff --git a/api-reference/v1.0/api/intune-apps-enterprisecodesigningcertificate-update.md b/api-reference/v1.0/api/intune-apps-enterprisecodesigningcertificate-update.md index 1d7eb3ea6cd..39560ed3ab1 100644 --- a/api-reference/v1.0/api/intune-apps-enterprisecodesigningcertificate-update.md +++ b/api-reference/v1.0/api/intune-apps-enterprisecodesigningcertificate-update.md @@ -66,7 +66,6 @@ If successful, this method returns a `200 OK` response code and an updated [ente ### Request Here is an example of the request. -# [HTTP](#tab/http) ``` http PATCH https://graph.microsoft.com/v1.0/deviceAppManagement/enterpriseCodeSigningCertificates/{enterpriseCodeSigningCertificateId} @@ -86,40 +85,6 @@ Content-length: 390 } ``` -# [C#](#tab/csharp) -[!INCLUDE [sample-code](../includes/snippets/csharp/intune-apps-enterprisecodesigningcertificate-update-update-enterprisecodesigningcertificate-csharp-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [CLI](#tab/cli) -[!INCLUDE [sample-code](../includes/snippets/cli/intune-apps-enterprisecodesigningcertificate-update-update-enterprisecodesigningcertificate-cli-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [Go](#tab/go) -[!INCLUDE [sample-code](../includes/snippets/go/intune-apps-enterprisecodesigningcertificate-update-update-enterprisecodesigningcertificate-go-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [Java](#tab/java) -[!INCLUDE [sample-code](../includes/snippets/java/intune-apps-enterprisecodesigningcertificate-update-update-enterprisecodesigningcertificate-java-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [JavaScript](#tab/javascript) -[!INCLUDE [sample-code](../includes/snippets/javascript/intune-apps-enterprisecodesigningcertificate-update-update-enterprisecodesigningcertificate-javascript-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [PHP](#tab/php) -[!INCLUDE [sample-code](../includes/snippets/php/intune-apps-enterprisecodesigningcertificate-update-update-enterprisecodesigningcertificate-php-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [PowerShell](#tab/powershell) -[!INCLUDE [sample-code](../includes/snippets/powershell/intune-apps-enterprisecodesigningcertificate-update-update-enterprisecodesigningcertificate-powershell-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - -# [Python](#tab/python) -[!INCLUDE [sample-code](../includes/snippets/python/intune-apps-enterprisecodesigningcertificate-update-update-enterprisecodesigningcertificate-python-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - ---- - ### Response Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. diff --git a/api-reference/v1.0/api/m365appsinstallationoptions-get.md b/api-reference/v1.0/api/m365appsinstallationoptions-get.md index b8871bba2c8..ffbe86a3c1d 100644 --- a/api-reference/v1.0/api/m365appsinstallationoptions-get.md +++ b/api-reference/v1.0/api/m365appsinstallationoptions-get.md @@ -52,6 +52,7 @@ If successful, this method returns a `200 OK` response code and a [m365AppsInsta ### Request The following example shows a request. +# [HTTP](#tab/http) ```http -POST /me/drive/items/{id}/workbook/worksheets -POST /me/drive/root:/{item-path}:/workbook/worksheets +POST /me/drive/items/{id}/workbook/worksheets/add +POST /me/drive/root:/{item-path}:/workbook/worksheets/add ``` ## Request headers | Name | Description| |:---------------|:----------| |Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -| Workbook-Session-Id | Workbook session Id that determines if changes are persisted or not. Optional.| +| Workbook-Session-Id | Workbook session ID that determines whether changes are persisted. Optional.| ## Request body In the request body, provide a JSON object with the following parameters. @@ -43,11 +43,11 @@ In the request body, provide a JSON object with the following parameters. ## Response -If successful, this method returns `201 Created` response code and [WorkbookWorksheet](../resources/worksheet.md) object in the response body. +If successful, this method returns `201 Created` response code and [workbookWorksheet](../resources/worksheet.md) object in the response body. -## Example -Here's an example of how to call this API. -##### Request +## Examples + +### Request The following example shows a request. # [HTTP](#tab/http) @@ -94,8 +94,10 @@ Content-type: application/json --- -##### Response -The following example shows the response. Note: The response object shown here might be shortened for readability. +### Response +The following example shows the response. + +>**Note:** The response object shown here might be shortened for readability.