Skip to content

Commit fd5c14d

Browse files
DanipocketDanipocket
authored
Merge pull request #28487 from microsoftgraph/fileservices-updates
Fileservices updates
2 parents 8a754f2 + 7e31996 commit fd5c14d

8 files changed

Lines changed: 146 additions & 10 deletions

File tree

‎api-reference/beta/resources/list.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,7 @@ Represents a list in a [site](site.md). This resource contains the top level pro
5050
| displayName | String | The displayable title of the list. |
5151
| eTag | String | ETag for the item. Inherited from [baseItem](baseitem.md). |
5252
| id | String | The unique identifier of the item. Read-only. Inherited from [baseItem](baseitem.md). |
53+
| itemCount | Int32 | The number of items in the list. Read-only. |
5354
| lastModifiedBy | [identitySet](identityset.md) | Identity of the last modifier of this item. Read-only. Inherited from [baseItem](baseitem.md). |
5455
| lastModifiedDateTime | DateTimeOffset | The date and time when the item was last modified. Read-only. Inherited from [baseItem](baseitem.md). |
5556
| list | [listInfo](listinfo.md) | Contains more details about the list. |
@@ -92,6 +93,7 @@ The following JSON representation shows the resource type.
9293
"lastModifiedBy": { "@odata.type": "microsoft.graph.identitySet" },
9394
"lastModifiedDateTime": "String (timestamp)",
9495
"list": { "@odata.type": "microsoft.graph.listInfo" },
96+
"itemCount": "Int32",
9597
"name": "String",
9698
"parentReference": { "@odata.type": "microsoft.graph.itemReference" },
9799
"sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },

‎api-reference/beta/resources/sharepointgroup.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,7 @@ Represents a cohort of users or Microsoft 365 groups that are localized to a Sha
3333
|:---|:---|:---|
3434
|description|String|The user-visible description of the **sharePointGroup**. Read-write.|
3535
|id|String|The unique stable identifier of the **sharePointGroup**. This ID is unique only within the context of a single SharePoint Embedded container or SharePoint site. Read-only.|
36+
|principalId|String|The principal ID of the SharePoint group in the tenant. Read-only.|
3637
|title|String|The user-visible title of the **sharePointGroup**. Read-write.|
3738

3839
## Relationships
@@ -54,6 +55,7 @@ The following JSON representation shows the resource type.
5455
"@odata.type": "#microsoft.graph.sharePointGroup",
5556
"description": "String",
5657
"id": "String (identifier)",
58+
"principalId": "String",
5759
"title": "String"
5860
}
5961
```

‎api-reference/beta/resources/sharepointgroupidentity.md‎

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
---
2+
author: spgraph-docs-team
3+
description: "Represents the identity of a SharePoint group."
4+
title: "sharePointGroupIdentity resource type"
5+
ms.localizationpriority: medium
6+
ms.subservice: "sharepoint"
7+
doc_type: resourcePageType
8+
ms.date: 03/23/2026
9+
toc.title: "SharePoint group identity"
10+
---
11+
12+
# sharePointGroupIdentity resource type
13+
14+
Namespace: microsoft.graph
15+
16+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
17+
18+
Represents the identity of a SharePoint group. Extends the [identity](identity.md) type with SharePoint-specific properties.
19+
20+
Inherits from [identity](identity.md).
21+
22+
## Properties
23+
24+
| Property | Type | Description |
25+
|:-------------|:-------|:-------------------------------------------------------------------------------------------------|
26+
| displayName | String | The display name of the SharePoint group. Inherited from [identity](identity.md). Read-only. |
27+
| id | String | The unique identifier of the SharePoint group. Inherited from [identity](identity.md). Read-only. |
28+
| principalId | String | The principal ID of the SharePoint group in the tenant. Read-only. |
29+
| title | String | The title of the SharePoint group. Read-only. |
30+
31+
## Relationships
32+
33+
None.
34+
35+
## JSON representation
36+
37+
The following JSON representation shows the resource type.
38+
39+
<!-- {
40+
"blockType": "resource",
41+
"optionalProperties": [],
42+
"@odata.type": "microsoft.graph.sharePointGroupIdentity"
43+
}-->
44+
45+
```json
46+
{
47+
"@odata.type": "#microsoft.graph.sharePointGroupIdentity",
48+
"displayName": "String",
49+
"id": "String",
50+
"principalId": "String",
51+
"title": "String"
52+
}
53+
```
54+
55+
## Related content
56+
57+
- [sharePointIdentitySet resource type](sharepointidentityset.md)
58+
- [identity resource type](identity.md)
59+
- [sharePointGroup resource type](sharepointgroup.md)
60+
61+
<!--
62+
{
63+
"type": "#page.annotation",
64+
"description": "The sharePointGroupIdentity resource represents the identity of a SharePoint group.",
65+
"keywords": "identity,sharepoint,group",
66+
"section": "documentation",
67+
"tocPath": "Resources/SharePointGroupIdentity",
68+
"suppressions": []
69+
}
70+
-->

‎api-reference/beta/resources/sharepointidentityset.md‎

Lines changed: 12 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -19,16 +19,18 @@ For usage information, see [driveItem][].
1919

2020
## Properties
2121

22-
| Property | Type | Description |
23-
|:------------|:-----------------------|:----------------------------------------------------------- |
24-
| application | [identity][] | The application associated with this action. Optional. |
25-
| device | [identity][] | The device associated with this action. Optional. |
26-
| group | [identity][] | The group associated with this action. Optional. |
27-
| user | [identity][] | The user associated with this action. Optional. |
28-
| siteUser | [sharePointIdentity][] | The SharePoint user associated with this action. Optional. |
29-
| siteGroup | [sharePointIdentity][] | The SharePoint group associated with this action. Optional. |
22+
| Property | Type | Description |
23+
|:---|:---|:---|
24+
| application | [identity][] | The application associated with this action. Optional. |
25+
| device | [identity][] | The device associated with this action. Optional. |
26+
| group | [identity][] | The group associated with this action. Optional. |
27+
| sharePointGroup | [sharePointGroupIdentity][] | The SharePoint group associated with this action. Optional. |
28+
| siteGroup | [sharePointIdentity][] | The SharePoint group associated with this action. Optional. |
29+
| siteUser | [sharePointIdentity][] | The SharePoint user associated with this action. Optional. |
30+
| user | [identity][] | The user associated with this action. Optional. |
3031

3132
## Relationships
33+
3234
None.
3335

3436
## JSON representation
@@ -47,13 +49,15 @@ The following JSON representation shows the resource type.
4749
"user": {"@odata.type": "microsoft.graph.identity"},
4850

4951
"group": {"@odata.type": "microsoft.graph.identity"},
52+
"sharePointGroup": {"@odata.type": "microsoft.graph.sharePointGroupIdentity"},
5053
"siteUser": {"@odata.type": "microsoft.graph.sharePointIdentity"},
5154
"siteGroup":{"@odata.type": "microsoft.graph.sharePointIdentity"}
5255
}
5356
```
5457

5558
[driveItem]: driveitem.md
5659
[identity]: identity.md
60+
[sharePointGroupIdentity]: sharepointgroupidentity.md
5761
[sharePointIdentity]: sharePointidentity.md
5862

5963
<!-- {

‎api-reference/beta/toc/files/toc.yml‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -448,3 +448,5 @@ items:
448448
href: ../../resources/filestoragecontainertyperegistrationsettings.md
449449
- name: File storage container type settings
450450
href: ../../resources/filestoragecontainertypesettings.md
451+
- name: SharePoint group identity
452+
href: ../../resources/sharepointgroupidentity.md

‎api-reference/beta/toc/toc.mapping.json‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1130,7 +1130,8 @@
11301130
"complexTypes": [
11311131
"fileStorageContainerTypeRegistrationSettings",
11321132
"fileStorageContainerTypeAgentSettings",
1133-
"fileStorageContainerTypeSettings"
1133+
"fileStorageContainerTypeSettings",
1134+
"sharePointGroupIdentity"
11341135
],
11351136
"childNodes": [
11361137
{

‎changelog/Microsoft.FileServices.json‎

Lines changed: 53 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,57 @@
11
{
22
"changelog": [
3+
{
4+
"ChangeList": [
5+
{
6+
"Id": "e010d96a-7a4e-4b7c-aa22-05bd067da980",
7+
"ApiChange": "Property",
8+
"ChangedApiName": "itemCount",
9+
"ChangeType": "Addition",
10+
"Description": "Added the **itemCount** property to the [list](https://learn.microsoft.com/en-us/graph/api/resources/list?view=graph-rest-beta) resource.",
11+
"Target": "list"
12+
}
13+
],
14+
"Id": "e010d96a-7a4e-4b7c-aa22-05bd067da980",
15+
"Cloud": "Prod",
16+
"Version": "beta",
17+
"CreatedDateTime": "2026-03-29T23:41:39.1409717Z",
18+
"WorkloadArea": "Files",
19+
"SubArea": ""
20+
},
21+
{
22+
"ChangeList": [
23+
{
24+
"Id": "555e6775-6e2e-4c2e-9077-45141b8bf490",
25+
"ApiChange": "Property",
26+
"ChangedApiName": "principalId",
27+
"ChangeType": "Addition",
28+
"Description": "Added the **principalId** property to the [sharePointGroup](https://learn.microsoft.com/en-us/graph/api/resources/sharePointGroup?view=graph-rest-beta) resource.",
29+
"Target": "sharePointGroup"
30+
},
31+
{
32+
"Id": "555e6775-6e2e-4c2e-9077-45141b8bf490",
33+
"ApiChange": "Resource",
34+
"ChangedApiName": "sharePointGroupIdentity",
35+
"ChangeType": "Addition",
36+
"Description": "Added the [sharePointGroupIdentity](https://learn.microsoft.com/en-us/graph/api/resources/sharePointGroupIdentity?view=graph-rest-beta) resource type.",
37+
"Target": "sharePointGroupIdentity"
38+
},
39+
{
40+
"Id": "555e6775-6e2e-4c2e-9077-45141b8bf490",
41+
"ApiChange": "Property",
42+
"ChangedApiName": "sharePointGroup",
43+
"ChangeType": "Addition",
44+
"Description": "Added the **sharePointGroup** property to the [sharePointIdentitySet](https://learn.microsoft.com/en-us/graph/api/resources/sharePointIdentitySet?view=graph-rest-beta) resource.",
45+
"Target": "sharePointIdentitySet"
46+
}
47+
],
48+
"Id": "555e6775-6e2e-4c2e-9077-45141b8bf490",
49+
"Cloud": "Prod",
50+
"Version": "beta",
51+
"CreatedDateTime": "2026-03-29T01:57:33.226047Z",
52+
"WorkloadArea": "Files",
53+
"SubArea": ""
54+
},
355
{
456
"ChangeList": [
557
{
@@ -5615,4 +5667,4 @@
56155667
"SubArea": ""
56165668
}
56175669
]
5618-
}
5670+
}

‎concepts/whats-new-overview.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -132,6 +132,9 @@ Use the [follow user](/graph/api/storyline-follow?view=graph-rest-beta&preserve-
132132
- Use the [list](/graph/api/filestoragecontainertype-list-permissions?view=graph-rest-beta&preserve-view=true), [create](/graph/api/filestoragecontainertype-post-permissions?view=graph-rest-beta&preserve-view=true), [get](/graph/api/filestoragecontainertype-get-permission?view=graph-rest-beta&preserve-view=true), and [delete](/graph/api/filestoragecontainertype-delete-permissions?view=graph-rest-beta&preserve-view=true) APIs to manage user permissions for SharePoint Embedded [file storage container types](/graph/api/resources/filestoragecontainertype?view=graph-rest-beta&preserve-view=true).
133133
- [Archive](/graph/api/filestoragecontainer-archive?view=graph-rest-beta&preserve-view=true) or [unarchive](/graph/api/filestoragecontainer-unarchive?view=graph-rest-beta&preserve-view=true) a SharePoint Embedded storage container.
134134
- Requests made using the [list containers](/graph/api/filestorage-list-containers?view=graph-rest-beta&preserve-view=true) API without a user context (app-only authentication) aren't currently supported for multi-geo tenants.
135+
- Use the **itemCount** property on the [list](/graph/api/resources/list?view=graph-rest-beta&preserve-view=true) resource to quickly access the total number of items in a SharePoint list without retrieving all items or making additional queries.
136+
- Use the **principalId** property on [sharePointGroup](/graph/api/resources/sharepointgroup?view=graph-rest-beta&preserve-view=true) to get the principal ID of the SharePoint group in the tenant.
137+
- Use the **sharePointGroup** property on [sharePointIdentitySet](/graph/api/resources/sharepointidentityset?view=graph-rest-beta&preserve-view=true) to get the SharePoint group associated with a **sharePointIdentitySet** object.
135138

136139
### Groups
137140

0 commit comments

Comments
 (0)