Skip to content

Commit a9c5fee

Browse files
JarbasHorstJarbasHorst
authored
Merge branch 'main' into users/sumanac/customemojicustomreaction
2 parents 34b61dc + bdeccbf commit a9c5fee

File tree

151 files changed

+1714
-208
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

151 files changed

+1714
-208
lines changed

‎api-reference/beta/api/b2cidentityuserflow-list-userattributeassignments.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,8 @@ Choose the permission or permissions marked as least privileged for this API. Us
2222
<!-- { "blockType": "permissions", "name": "b2cidentityuserflow_list_userattributeassignments" } -->
2323
[!INCLUDE [permissions-table](../includes/permissions/b2cidentityuserflow-list-userattributeassignments-permissions.md)]
2424

25+
[!INCLUDE [rbac-b2xb2c-user-flows-apis](../includes/rbac-for-apis/rbac-b2xb2c-user-flows-apis.md)]
26+
2527
## HTTP request
2628

2729
<!-- {

‎api-reference/beta/api/b2cidentityuserflow-post-userattributeassignments.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,8 @@ Choose the permission or permissions marked as least privileged for this API. Us
2222
<!-- { "blockType": "permissions", "name": "b2cidentityuserflow_post_userattributeassignments" } -->
2323
[!INCLUDE [permissions-table](../includes/permissions/b2cidentityuserflow-post-userattributeassignments-permissions.md)]
2424

25+
[!INCLUDE [rbac-b2xb2c-user-flows-apis](../includes/rbac-for-apis/rbac-b2xb2c-user-flows-apis.md)]
26+
2527
## HTTP request
2628

2729
<!-- {

‎api-reference/beta/api/b2xidentityuserflow-list-userattributeassignments.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,8 @@ Choose the permission or permissions marked as least privileged for this API. Us
2222
<!-- { "blockType": "permissions", "name": "b2xidentityuserflow_list_userattributeassignments" } -->
2323
[!INCLUDE [permissions-table](../includes/permissions/b2xidentityuserflow-list-userattributeassignments-permissions.md)]
2424

25+
[!INCLUDE [rbac-b2xb2c-user-flows-apis](../includes/rbac-for-apis/rbac-b2xb2c-user-flows-apis.md)]
26+
2527
## HTTP request
2628

2729
<!-- {

‎api-reference/beta/api/b2xidentityuserflow-post-userattributeassignments.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,8 @@ Choose the permission or permissions marked as least privileged for this API. Us
2222
<!-- { "blockType": "permissions", "name": "b2xidentityuserflow_post_userattributeassignments" } -->
2323
[!INCLUDE [permissions-table](../includes/permissions/b2xidentityuserflow-post-userattributeassignments-permissions.md)]
2424

25+
[!INCLUDE [rbac-b2xb2c-user-flows-apis](../includes/rbac-for-apis/rbac-b2xb2c-user-flows-apis.md)]
26+
2527
## HTTP request
2628

2729
<!-- {

‎api-reference/beta/api/cloudlicensing-groupcloudlicensing-list-usagerights.md

Lines changed: 170 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,170 @@
1+
---
2+
title: "List usageRights for group"
3+
description: "Get a list of the usageRight objects granted to a group."
4+
author: "patrick-starrin"
5+
ms.localizationpriority: medium
6+
ms.subservice: "cloud-licensing"
7+
doc_type: apiPageType
8+
---
9+
10+
# List usageRights for group
11+
12+
Namespace: microsoft.graph.cloudLicensing
13+
14+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
15+
16+
Get a list of the [usageRight](../resources/cloudlicensing-usageright.md) objects granted to a group.
17+
18+
## Permissions
19+
20+
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).
21+
22+
<!-- {
23+
"blockType": "permissions",
24+
"name": "cloudlicensing_groupcloudlicensing_list_usagerights"
25+
}
26+
-->
27+
[!INCLUDE [permissions-table](../includes/permissions/cloudlicensing-groupcloudlicensing-list-usagerights-permissions.md)]
28+
29+
## HTTP request
30+
31+
<!-- {
32+
"blockType": "ignored"
33+
}
34+
-->
35+
``` http
36+
GET /groups/{groupId}/cloudLicensing/usageRights
37+
```
38+
39+
## Optional query parameters
40+
41+
This method supports the `$select` and `$filter` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
42+
43+
The following examples show how to get usage rights information for groups based on specific filters:
44+
45+
<!-- {
46+
"blockType": "ignored"
47+
}
48+
-->
49+
``` http
50+
GET /groups/0003985b-dfc1-4f42-97d4-65f70a335ca8/cloudLicensing/usageRights?$filter=skuId eq 639dec6b-bb19-468b-871c-c5c441c4b0cb
51+
GET /groups/0003985b-dfc1-4f42-97d4-65f70a335ca8/cloudLicensing/usageRights?$filter=skuId in (639dec6b-bb19-468b-871c-c5c441c4b0cb, a403ebcc-fae0-4ca2-8c8c-7a907fd6c235)
52+
GET /groups/0003985b-dfc1-4f42-97d4-65f70a335ca8/cloudLicensing/usageRights?$filter=services/any(c:c/planId eq 113feb6c-3fe4-4440-bddc-54d774bf0318)
53+
GET /groups/0003985b-dfc1-4f42-97d4-65f70a335ca8/cloudLicensing/usageRights?$filter=services/any(c:c/planId in (113feb6c-3fe4-4440-bddc-54d774bf0318, 2049e525-b859-401b-b2a0-e0a31c4b1fe4))
54+
```
55+
56+
## Request headers
57+
58+
|Name|Description|
59+
|:---|:---|
60+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
61+
62+
## Request body
63+
64+
Don't supply a request body for this method.
65+
66+
## Response
67+
68+
If successful, this method returns a `200 OK` response code and a collection of [microsoft.graph.cloudLicensing.usageRight](../resources/cloudlicensing-usageright.md) objects in the response body.
69+
70+
## Examples
71+
72+
### Example 1: Get all usage rights for a group
73+
74+
The following example shows how to get all usage rights granted to a group.
75+
76+
#### Request
77+
78+
The following example shows a request.
79+
<!-- {
80+
"blockType": "request",
81+
"name": "cloudlicensing-groupusageright-list-example-1"
82+
}
83+
-->
84+
``` http
85+
GET https://graph.microsoft.com/beta/groups/0003985b-dfc1-4f42-97d4-65f70a335ca8/cloudLicensing/usageRights
86+
```
87+
88+
#### Response
89+
90+
The following example shows the response.
91+
>**Note:** The response object shown here might be shortened for readability.
92+
<!-- {
93+
"blockType": "response",
94+
"truncated": true,
95+
"@odata.type": "Collection(microsoft.graph.cloudLicensing.usageRight)"
96+
}
97+
-->
98+
``` http
99+
HTTP/1.1 200 OK
100+
Content-Type: application/json
101+
102+
{
103+
"value": [
104+
{
105+
"@odata.type": "#microsoft.graph.cloudLicensing.usageRight",
106+
"id": "1e373a1d-1f05-28cf-bfc0-ee0ecfd3db15",
107+
"skuId": "639dec6b-bb19-468b-871c-c5c441c4b0cb",
108+
"skuPartNumber": "Microsoft_365_Copilot",
109+
"services": [
110+
{
111+
"@odata.type": "microsoft.graph.cloudLicensing.service",
112+
"assignableTo": "user,group",
113+
"planId": "fe6c28b3-d468-44ea-bbd0-a10a5167435c",
114+
"planName": "COPILOT_STUDIO_IN_COPILOT_FOR_M365"
115+
}
116+
]
117+
}
118+
]
119+
}
120+
```
121+
122+
### Example 2: Get all usage rights for a group with a specific service plan
123+
124+
The following example shows how to get all usage rights granted to a group for a specific service plan.
125+
126+
#### Request
127+
128+
The following example shows a request.
129+
<!-- {
130+
"blockType": "request",
131+
"name": "cloudlicensing-groupusageright-list-example-2"
132+
}
133+
-->
134+
``` http
135+
GET https://graph.microsoft.com/beta/groups/0003985b-dfc1-4f42-97d4-65f70a335ca8/cloudLicensing/usageRights?$filter=services/any(c:c/planId eq 113feb6c-3fe4-4440-bddc-54d774bf0318)
136+
```
137+
138+
#### Response
139+
140+
The following example shows the response.
141+
>**Note:** The response object shown here might be shortened for readability.
142+
<!-- {
143+
"blockType": "response",
144+
"truncated": true,
145+
"@odata.type": "Collection(microsoft.graph.cloudLicensing.usageRight)"
146+
}
147+
-->
148+
``` http
149+
HTTP/1.1 200 OK
150+
Content-Type: application/json
151+
152+
{
153+
"value": [
154+
{
155+
"@odata.type": "#microsoft.graph.cloudLicensing.usageRight",
156+
"id": "5bbc716a-f73f-4cc1-bf16-53d38b407b8f",
157+
"skuId": "75398b2a-b060-4057-9ae2-9eb00ef68579",
158+
"skuPartNumber": "Copilot_Pro",
159+
"services": [
160+
{
161+
"@odata.type": "microsoft.graph.cloudLicensing.service",
162+
"assignableTo": "group",
163+
"planId": "113feb6c-3fe4-4440-bddc-54d774bf0318",
164+
"planName": "EXCHANGE_S_FOUNDATION"
165+
}
166+
]
167+
}
168+
]
169+
}
170+
```

‎api-reference/beta/api/cloudlicensing-usageright-get.md

Lines changed: 175 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,175 @@
1+
---
2+
title: "Get usageRight"
3+
description: "Get the properties and relationships of a usageRight for a user or group."
4+
author: "patrick-starrin"
5+
ms.localizationpriority: medium
6+
ms.subservice: "cloud-licensing"
7+
doc_type: apiPageType
8+
---
9+
10+
# Get usageRight
11+
12+
Namespace: microsoft.graph.cloudLicensing
13+
14+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
15+
16+
Get the properties and relationships of a [usageRight](../resources/cloudlicensing-usageright.md) for a [user](../resources/user.md) or [group](../resources/group.md).
17+
18+
## Permissions
19+
20+
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).
21+
22+
Permissions to get a **usageRight** for a user:
23+
24+
<!-- { "blockType": "ignored"} -->
25+
``` http
26+
GET /me/cloudLicensing/usageRights/{usageRightId}
27+
GET /users/{userId}/cloudLicensing/usageRights/{usageRightId}
28+
```
29+
30+
<!-- { "blockType": "permissions", "name": "cloudlicensing_usageright_get", "requestUrls": "GET /users/{userId}/cloudLicensing/usageRights/{usageRightId}" } -->
31+
|Permission type|Least privileged permissions|Higher privileged permissions|
32+
|:---|:---|:---|
33+
|Delegated (work or school account)|User-UsageRight.Read|Directory.Read.All, Directory.ReadWrite.All, User-CloudLicensing.Read, User-CloudLicensing.Read.All, User-UsageRight.Read.All, User.Read, User.Read.All, User.ReadWrite, User.ReadWrite.All|
34+
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
35+
|Application|User-UsageRight.Read.All|Directory.Read.All, Directory.ReadWrite.All, User-CloudLicensing.Read.All, User.Read.All, User.ReadWrite.All|
36+
37+
Permissions to get a **usageRight** for a group:
38+
39+
<!-- { "blockType": "ignored"} -->
40+
``` http
41+
GET /groups/{groupId}/cloudLicensing/usageRights/{usageRightId}
42+
```
43+
44+
<!-- { "blockType": "permissions", "name": "cloudlicensing_usageright_get", "requestUrls": "GET /groups/{groupId}/cloudLicensing/usageRights/{usageRightId}" } -->
45+
|Permission type|Least privileged permissions|Higher privileged permissions|
46+
|:---|:---|:---|
47+
|Delegated (work or school account)|Group-UsageRight.Read.All|Directory.Read.All, Directory.ReadWrite.All, Group-CloudLicensing.Read, Group-CloudLicensing.Read.All, Group.Read.All, Group.ReadWrite.All, User.Read.All, User.ReadWrite.All|
48+
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
49+
|Application|Group-UsageRight.Read.All|Directory.Read.All, Directory.ReadWrite.All, Group-CloudLicensing.Read.All, Group.Read.All, Group.ReadWrite.All, User.Read.All, User.ReadWrite.All|
50+
51+
## HTTP request
52+
53+
<!-- {
54+
"blockType": "ignored"
55+
}
56+
-->
57+
``` http
58+
GET /groups/{groupId}/cloudLicensing/usageRights/{usageRightId}
59+
GET /me/cloudLicensing/usageRights/{usageRightId}
60+
GET /users/{userId}/cloudLicensing/usageRights/{usageRightId}
61+
```
62+
63+
## Optional query parameters
64+
65+
This method supports the `$select` OData query parameter to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
66+
67+
## Request headers
68+
69+
|Name|Description|
70+
|:---|:---|
71+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
72+
73+
## Request body
74+
75+
Don't supply a request body for this method.
76+
77+
## Response
78+
79+
If successful, this method returns a `200 OK` response code and a [microsoft.graph.cloudLicensing.usageRight](../resources/cloudlicensing-usageright.md) object in the response body.
80+
81+
## Examples
82+
83+
### Example 1: Get a usageRight for a user
84+
85+
The following example shows how to get a usage right for a user.
86+
87+
#### Request
88+
89+
The following example shows a request.
90+
<!-- {
91+
"blockType": "request",
92+
"name": "cloudlicensing-usageright-get-example",
93+
"sampleKeys": ["48fbdf70-9e09-40df-9dbe-17af483ab113","i6sq63x2vd3esbkifv7m42xdaugc6lfpqf3ozgvdlvk3ttnamby3"]
94+
}
95+
-->
96+
``` http
97+
GET https://graph.microsoft.com/beta/users/48fbdf70-9e09-40df-9dbe-17af483ab113/cloudLicensing/usageRights/i6sq63x2vd3esbkifv7m42xdaugc6lfpqf3ozgvdlvk3ttnamby3
98+
```
99+
100+
#### Response
101+
102+
The following example shows the response.
103+
>**Note:** The response object shown here might be shortened for readability.
104+
<!-- {
105+
"blockType": "response",
106+
"truncated": true,
107+
"@odata.type": "microsoft.graph.cloudLicensing.usageRight"
108+
}
109+
-->
110+
``` http
111+
HTTP/1.1 200 OK
112+
Content-Type: application/json
113+
114+
{
115+
"@odata.type": "#microsoft.graph.cloudLicensing.usageRight",
116+
"id": "i6sq63x2vd3esbkifv7m42xdaugc6lfpqf3ozgvdlvk3ttnamby3",
117+
"skuId": "639dec6b-bb19-468b-871c-c5c441c4b0cb",
118+
"skuPartNumber": "Microsoft_365_Copilot",
119+
"services": [
120+
{
121+
"@odata.type": "microsoft.graph.cloudLicensing.service",
122+
"assignableTo": "user,group",
123+
"planId": "fe6c28b3-d468-44ea-bbd0-a10a5167435c",
124+
"planName": "COPILOT_STUDIO_IN_COPILOT_FOR_M365"
125+
}
126+
]
127+
}
128+
```
129+
130+
### Example 2: Get a usageRight for a group
131+
132+
The following example shows how to get a usage right for a group.
133+
134+
#### Request
135+
136+
The following example shows a request.
137+
<!-- {
138+
"blockType": "request",
139+
"name": "cloudlicensing-usageright-get-2-example",
140+
"sampleKeys": ["1003985b-dfc1-4f42-97d4-65f70a335ca8","j6sq63x2vd3esbkifv7m42xdaugc6lfpqf3ozgvdlvk3ttnamby4"]
141+
}
142+
-->
143+
``` http
144+
GET https://graph.microsoft.com/beta/groups/1003985b-dfc1-4f42-97d4-65f70a335ca8/cloudLicensing/usageRights/j6sq63x2vd3esbkifv7m42xdaugc6lfpqf3ozgvdlvk3ttnamby4
145+
```
146+
147+
#### Response
148+
149+
The following example shows the response.
150+
>**Note:** The response object shown here might be shortened for readability.
151+
<!-- {
152+
"blockType": "response",
153+
"truncated": true,
154+
"@odata.type": "microsoft.graph.cloudLicensing.usageRight"
155+
}
156+
-->
157+
``` http
158+
HTTP/1.1 200 OK
159+
Content-Type: application/json
160+
161+
{
162+
"@odata.type": "#microsoft.graph.cloudLicensing.usageRight",
163+
"id": "j6sq63x2vd3esbkifv7m42xdaugc6lfpqf3ozgvdlvk3ttnamby4",
164+
"skuId": "639dec6b-bb19-468b-871c-c5c441c4b0cb",
165+
"skuPartNumber": "Microsoft_365_Copilot",
166+
"services": [
167+
{
168+
"@odata.type": "microsoft.graph.cloudLicensing.service",
169+
"assignableTo": "user,group",
170+
"planId": "fe6c28b3-d468-44ea-bbd0-a10a5167435c",
171+
"planName": "COPILOT_STUDIO_IN_COPILOT_FOR_M365"
172+
}
173+
]
174+
}
175+
```

0 commit comments

Comments
 (0)