Skip to content

Commit a350f9b

Browse files
Learn Build Service GitHub AppLearn Build Service GitHub App
Learn Build Service GitHub App
authored and
Learn Build Service GitHub App
committed
Merging changes synced from https://github.com/microsoftgraph/microsoft-graph-docs (branch live)
2 parents b6801c3 + 5750301 commit a350f9b

File tree

283 files changed

+5004
-777
lines changed

Some content is hidden

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

283 files changed

+5004
-777
lines changed

‎.github/pull_request_template.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,11 +15,11 @@ Add other supporting information, such as a description of the PR changes:
1515
1616

1717
- **do not merge** is the default PR status and is automatically added to all open PRs that don't have the **ready to merge** label.
18-
- Add the **ready for content review** label to start a review. Only PRs that have met the [minimum requirements for content review](https://dev.azure.com/msazure/One/_wiki/wikis/Microsoft%20Graph%20Partners/707655/Minimum-requirements-for-content-review) and have this label are reviewed.
18+
- Add the **ready for content review** label to start a review. Only PRs that have met the [minimum requirements for content review](https://eng.ms/cid/27dee76c-3a60-4e65-8fdf-08ea849b3498/fid/679c4bf497d767aa4c1e409cd143d7109564b93a118c29e0e11b15eb04b78844) and have this label are reviewed.
1919
- If your content reviewer requests changes, review the feedback and address accordingly as soon as possible to keep your pull request moving forward. After you address the feedback, remove the **changes requested** label, add the **review feedback addressed** label, and select the **Re-request review** icon next to the content reviewer's alias. If you can't add labels, add a comment with `#feedback-addressed` to the pull request.
2020
- After the content review is complete, your reviewer will add the **content review complete** label. When the updates in this PR are ready for external customers to use, replace the **do not merge** label with **ready to merge** and the PR will be merged within 24 working hours.
2121
- Pull requests that are inactive for more than 6 weeks will be automatically closed. Before that, you receive reminders at 2 weeks, 4 weeks, and 6 weeks. If you still need the PR, you can reopen or recreate the request.
2222

23-
For more information, see the [Content review process summary](https://dev.azure.com/msazure/One/_wiki/wikis/Microsoft%20Graph%20Partners/614263/Content-workflow).
23+
For more information, see the [Content review process summary](https://eng.ms/cid/27dee76c-3a60-4e65-8fdf-08ea849b3498/fid/3a993b6c9d547e46f59d8d7851f191c38bbbea6ead01253dc62fcdd8101a1ff9).
2424

2525
</details>

‎api-reference/beta/api/chat-post.md

Lines changed: 102 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -361,7 +361,105 @@ Location: /chats('19:82fe7758-5bb3-4f0d-a43f-e555fd399c6f_bfb5bb25-3a8d-487d-982
361361

362362
The async operation is initiated, and the response contains a Location header, which includes a link to the [teamsAsyncOperation](../resources/teamsasyncoperation.md). The link can be used to get the operation status and details. For details, see [Get operation on chat](teamsasyncoperation-get.md#example-get-operation-on-chat).
363363

364-
### Example 4: Create a one-on-one chat using user principal name
364+
### Example 4: Create a one-on-one chat with RSC-granted apps
365+
366+
The following example shows how to create a one-on-one chat with installed apps that have resource-specific consent (RSC) permissions.
367+
368+
#### Request
369+
370+
The following example shows a request.
371+
372+
# [HTTP](#tab/http)
373+
<!-- {
374+
"blockType": "request",
375+
"name": "create_chat_oneonone_with_rsc_granted_apps"
376+
}
377+
-->
378+
``` http
379+
POST https://graph.microsoft.com/beta/chats
380+
Content-Type: application/json
381+
382+
{
383+
"chatType": "oneOnOne",
384+
"members": [
385+
{
386+
"@odata.type": "#microsoft.graph.aadUserConversationMember",
387+
"roles": ["owner"],
388+
"user@odata.bind": "https://graph.microsoft.com/beta/users('4b822dfc-2864-44e6-aa1e-7e0e8552168f')"
389+
},
390+
{
391+
"@odata.type": "#microsoft.graph.aadUserConversationMember",
392+
"roles": ["owner"],
393+
"user@odata.bind": "https://graph.microsoft.com/beta/users('6d1e1501-7a3d-45b7-b71b-68d372e5ce14')"
394+
}
395+
],
396+
"installedApps": [
397+
{
398+
"teamsApp@odata.bind": "https://graph.microsoft.com/beta/appCatalogs/teamsApps/8e55a7b1-6766-4f0a-8610-ecacfe3d569a",
399+
"consentedPermissionSet": {
400+
"resourceSpecificPermissions": [
401+
{
402+
"permissionValue": "ChatMessage.Read.Chat",
403+
"permissionType": "application"
404+
},
405+
{
406+
"permissionValue": "OnlineMeeting.ReadBasic.Chat",
407+
"permissionType": "application"
408+
}
409+
]
410+
}
411+
}
412+
]
413+
}
414+
```
415+
416+
# [C#](#tab/csharp)
417+
[!INCLUDE [sample-code](../includes/snippets/csharp/create-chat-oneonone-with-rsc-granted-apps-csharp-snippets.md)]
418+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
419+
420+
# [CLI](#tab/cli)
421+
[!INCLUDE [sample-code](../includes/snippets/cli/create-chat-oneonone-with-rsc-granted-apps-cli-snippets.md)]
422+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
423+
424+
# [Go](#tab/go)
425+
[!INCLUDE [sample-code](../includes/snippets/go/create-chat-oneonone-with-rsc-granted-apps-go-snippets.md)]
426+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
427+
428+
# [Java](#tab/java)
429+
[!INCLUDE [sample-code](../includes/snippets/java/create-chat-oneonone-with-rsc-granted-apps-java-snippets.md)]
430+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
431+
432+
# [JavaScript](#tab/javascript)
433+
[!INCLUDE [sample-code](../includes/snippets/javascript/create-chat-oneonone-with-rsc-granted-apps-javascript-snippets.md)]
434+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
435+
436+
# [PHP](#tab/php)
437+
[!INCLUDE [sample-code](../includes/snippets/php/create-chat-oneonone-with-rsc-granted-apps-php-snippets.md)]
438+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
439+
440+
# [PowerShell](#tab/powershell)
441+
[!INCLUDE [sample-code](../includes/snippets/powershell/create-chat-oneonone-with-rsc-granted-apps-powershell-snippets.md)]
442+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
443+
444+
# [Python](#tab/python)
445+
[!INCLUDE [sample-code](../includes/snippets/python/create-chat-oneonone-with-rsc-granted-apps-python-snippets.md)]
446+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
447+
448+
---
449+
450+
#### Response
451+
The following example shows the response.
452+
<!-- {
453+
"blockType": "response"
454+
}
455+
-->
456+
```http
457+
HTTP/1.1 202 Accepted
458+
Content-Type: application/json
459+
Location: /chats('19:82fe7758-5bb3-4f0d-a43f-e555fd399c6f_bfb5bb25-3a8d-487d-9828-7875ced51a30@unq.gbl.spaces')/operations('2432b57b-0abd-43db-aa7b-16eadd115d34-861f06db-0208-4815-b67a-965df0d28b7f-10adc8a6-60db-42e2-9761-e56a7e4c7bc9')
460+
```
461+
462+
### Example 5: Create a one-on-one chat using user principal name
365463

366464
#### Request
367465

@@ -465,7 +563,7 @@ Content-Type: application/json
465563
}
466564
```
467565

468-
### Example 5: Create a group chat with in-tenant guest
566+
### Example 6: Create a group chat with in-tenant guest
469567

470568
#### Request
471569

@@ -574,7 +672,7 @@ Content-Type: application/json
574672
}
575673
```
576674

577-
### Example 6: Create a one-on-one chat with a federated user (outside of own organization)
675+
### Example 7: Create a one-on-one chat with a federated user (outside of own organization)
578676

579677
#### Request
580678

@@ -655,7 +753,7 @@ HTTP/1.1 201 Created
655753
Content-Type: application/json
656754
657755
{
658-
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#chats/$entity",
756+
"@odata.context": "https://graph.microsoft.com/beta/$metadata#chats/$entity",
659757
"id": "19:82af01c5-f7cc-4a2e-a728-3a5df21afd9d_8b081ef6-4792-4def-b2c9-c363a1bf41d5@unq.gbl.spaces",
660758
"topic": null,
661759
"createdDateTime": "2020-12-04T23:10:28.51Z",

‎api-reference/beta/api/cloudpcreports-getconnectionqualityreports.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -71,6 +71,7 @@ If successful, this action returns a `200 OK` response code and a Stream in the
7171

7272
The following example shows a request.
7373

74+
# [HTTP](#tab/http)
7475
<!-- {
7576
"blockType": "request",
7677
"name": "cloudpcreportsthis.getconnectionqualityreports"
@@ -103,6 +104,36 @@ Content-length: 200
103104
}
104105
```
105106

107+
# [C#](#tab/csharp)
108+
[!INCLUDE [sample-code](../includes/snippets/csharp/cloudpcreportsthisgetconnectionqualityreports-csharp-snippets.md)]
109+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
110+
111+
# [CLI](#tab/cli)
112+
[!INCLUDE [sample-code](../includes/snippets/cli/cloudpcreportsthisgetconnectionqualityreports-cli-snippets.md)]
113+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
114+
115+
# [Go](#tab/go)
116+
[!INCLUDE [sample-code](../includes/snippets/go/cloudpcreportsthisgetconnectionqualityreports-go-snippets.md)]
117+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
118+
119+
# [Java](#tab/java)
120+
[!INCLUDE [sample-code](../includes/snippets/java/cloudpcreportsthisgetconnectionqualityreports-java-snippets.md)]
121+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
122+
123+
# [JavaScript](#tab/javascript)
124+
[!INCLUDE [sample-code](../includes/snippets/javascript/cloudpcreportsthisgetconnectionqualityreports-javascript-snippets.md)]
125+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
126+
127+
# [PHP](#tab/php)
128+
[!INCLUDE [sample-code](../includes/snippets/php/cloudpcreportsthisgetconnectionqualityreports-php-snippets.md)]
129+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
130+
131+
# [Python](#tab/python)
132+
[!INCLUDE [sample-code](../includes/snippets/python/cloudpcreportsthisgetconnectionqualityreports-python-snippets.md)]
133+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
134+
135+
---
136+
106137
### Response
107138

108139
The following example shows the response.

‎api-reference/beta/api/cloudpcreports-getdailyaggregatedremoteconnectionreports.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -65,6 +65,7 @@ If successful, this action returns a `200 OK` response code and a Stream in the
6565
### Request
6666
The following example shows a request.
6767

68+
# [HTTP](#tab/http)
6869
<!-- {
6970
"blockType": "request",
7071
"name": "cloudpcreportsthis.getdailyaggregatedremoteconnectionreports"
@@ -84,6 +85,36 @@ Content-length: 199
8485
}
8586
```
8687

88+
# [C#](#tab/csharp)
89+
[!INCLUDE [sample-code](../includes/snippets/csharp/cloudpcreportsthisgetdailyaggregatedremoteconnectionreports-csharp-snippets.md)]
90+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
91+
92+
# [CLI](#tab/cli)
93+
[!INCLUDE [sample-code](../includes/snippets/cli/cloudpcreportsthisgetdailyaggregatedremoteconnectionreports-cli-snippets.md)]
94+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
95+
96+
# [Go](#tab/go)
97+
[!INCLUDE [sample-code](../includes/snippets/go/cloudpcreportsthisgetdailyaggregatedremoteconnectionreports-go-snippets.md)]
98+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
99+
100+
# [Java](#tab/java)
101+
[!INCLUDE [sample-code](../includes/snippets/java/cloudpcreportsthisgetdailyaggregatedremoteconnectionreports-java-snippets.md)]
102+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
103+
104+
# [JavaScript](#tab/javascript)
105+
[!INCLUDE [sample-code](../includes/snippets/javascript/cloudpcreportsthisgetdailyaggregatedremoteconnectionreports-javascript-snippets.md)]
106+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
107+
108+
# [PHP](#tab/php)
109+
[!INCLUDE [sample-code](../includes/snippets/php/cloudpcreportsthisgetdailyaggregatedremoteconnectionreports-php-snippets.md)]
110+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
111+
112+
# [Python](#tab/python)
113+
[!INCLUDE [sample-code](../includes/snippets/python/cloudpcreportsthisgetdailyaggregatedremoteconnectionreports-python-snippets.md)]
114+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
115+
116+
---
117+
87118
### Response
88119
The following example shows the response.
89120
>**Note:** The response object shown here might be shortened for readability.

‎api-reference/beta/api/cloudpcreports-getrawremoteconnectionreports.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -65,6 +65,7 @@ If successful, this action returns a `200 OK` response code and a Stream in the
6565

6666
The following example shows a request.
6767

68+
# [HTTP](#tab/http)
6869
<!-- {
6970
"blockType": "request",
7071
"name": "cloudpcreportsthis.getrawremoteconnectionreports"
@@ -83,6 +84,36 @@ Content-length: 199
8384
}
8485
```
8586

87+
# [C#](#tab/csharp)
88+
[!INCLUDE [sample-code](../includes/snippets/csharp/cloudpcreportsthisgetrawremoteconnectionreports-csharp-snippets.md)]
89+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
90+
91+
# [CLI](#tab/cli)
92+
[!INCLUDE [sample-code](../includes/snippets/cli/cloudpcreportsthisgetrawremoteconnectionreports-cli-snippets.md)]
93+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
94+
95+
# [Go](#tab/go)
96+
[!INCLUDE [sample-code](../includes/snippets/go/cloudpcreportsthisgetrawremoteconnectionreports-go-snippets.md)]
97+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
98+
99+
# [Java](#tab/java)
100+
[!INCLUDE [sample-code](../includes/snippets/java/cloudpcreportsthisgetrawremoteconnectionreports-java-snippets.md)]
101+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
102+
103+
# [JavaScript](#tab/javascript)
104+
[!INCLUDE [sample-code](../includes/snippets/javascript/cloudpcreportsthisgetrawremoteconnectionreports-javascript-snippets.md)]
105+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
106+
107+
# [PHP](#tab/php)
108+
[!INCLUDE [sample-code](../includes/snippets/php/cloudpcreportsthisgetrawremoteconnectionreports-php-snippets.md)]
109+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
110+
111+
# [Python](#tab/python)
112+
[!INCLUDE [sample-code](../includes/snippets/python/cloudpcreportsthisgetrawremoteconnectionreports-python-snippets.md)]
113+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
114+
115+
---
116+
86117
### Response
87118

88119
The following example shows the response.

‎api-reference/beta/api/cloudpcreports-getremoteconnectionhistoricalreports.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -65,6 +65,7 @@ If successful, this action returns a `200 OK` response code and a Stream in the
6565
### Request
6666
The following example shows a request.
6767

68+
# [HTTP](#tab/http)
6869
<!-- {
6970
"blockType": "request",
7071
"name": "cloudpcreportsthis.getremoteconnectionhistoricalreports"
@@ -90,6 +91,36 @@ Content-length: 199
9091
}
9192
```
9293

94+
# [C#](#tab/csharp)
95+
[!INCLUDE [sample-code](../includes/snippets/csharp/cloudpcreportsthisgetremoteconnectionhistoricalreports-csharp-snippets.md)]
96+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
97+
98+
# [CLI](#tab/cli)
99+
[!INCLUDE [sample-code](../includes/snippets/cli/cloudpcreportsthisgetremoteconnectionhistoricalreports-cli-snippets.md)]
100+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
101+
102+
# [Go](#tab/go)
103+
[!INCLUDE [sample-code](../includes/snippets/go/cloudpcreportsthisgetremoteconnectionhistoricalreports-go-snippets.md)]
104+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
105+
106+
# [Java](#tab/java)
107+
[!INCLUDE [sample-code](../includes/snippets/java/cloudpcreportsthisgetremoteconnectionhistoricalreports-java-snippets.md)]
108+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
109+
110+
# [JavaScript](#tab/javascript)
111+
[!INCLUDE [sample-code](../includes/snippets/javascript/cloudpcreportsthisgetremoteconnectionhistoricalreports-javascript-snippets.md)]
112+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
113+
114+
# [PHP](#tab/php)
115+
[!INCLUDE [sample-code](../includes/snippets/php/cloudpcreportsthisgetremoteconnectionhistoricalreports-php-snippets.md)]
116+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
117+
118+
# [Python](#tab/python)
119+
[!INCLUDE [sample-code](../includes/snippets/python/cloudpcreportsthisgetremoteconnectionhistoricalreports-python-snippets.md)]
120+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
121+
122+
---
123+
93124
### Response
94125
The following example shows the response
95126
>**Note:** The response object shown here might be shortened for readability.

‎api-reference/beta/api/cloudpcreports-post-exportjobs.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -166,6 +166,7 @@ The following example shows how to create an export job to download the `RemoteC
166166

167167
The following example shows a request.
168168

169+
# [HTTP](#tab/http)
169170
<!-- {
170171
"blockType": "request",
171172
"name": "create_cloudpcexportjob_from_example2"
@@ -195,6 +196,40 @@ Content-length: 315
195196
}
196197
```
197198

199+
# [C#](#tab/csharp)
200+
[!INCLUDE [sample-code](../includes/snippets/csharp/create-cloudpcexportjob-from-example2-csharp-snippets.md)]
201+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
202+
203+
# [CLI](#tab/cli)
204+
[!INCLUDE [sample-code](../includes/snippets/cli/create-cloudpcexportjob-from-example2-cli-snippets.md)]
205+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
206+
207+
# [Go](#tab/go)
208+
[!INCLUDE [sample-code](../includes/snippets/go/create-cloudpcexportjob-from-example2-go-snippets.md)]
209+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
210+
211+
# [Java](#tab/java)
212+
[!INCLUDE [sample-code](../includes/snippets/java/create-cloudpcexportjob-from-example2-java-snippets.md)]
213+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
214+
215+
# [JavaScript](#tab/javascript)
216+
[!INCLUDE [sample-code](../includes/snippets/javascript/create-cloudpcexportjob-from-example2-javascript-snippets.md)]
217+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
218+
219+
# [PHP](#tab/php)
220+
[!INCLUDE [sample-code](../includes/snippets/php/create-cloudpcexportjob-from-example2-php-snippets.md)]
221+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
222+
223+
# [PowerShell](#tab/powershell)
224+
[!INCLUDE [sample-code](../includes/snippets/powershell/create-cloudpcexportjob-from-example2-powershell-snippets.md)]
225+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
226+
227+
# [Python](#tab/python)
228+
[!INCLUDE [sample-code](../includes/snippets/python/create-cloudpcexportjob-from-example2-python-snippets.md)]
229+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
230+
231+
---
232+
198233
#### Response
199234

200235
The following example shows the response.

‎api-reference/beta/api/cloudpcreports-retrievecloudpctenantmetricsreport.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ Namespace: microsoft.graph
1616

1717
Get a report related to the performance of Cloud PCs.
1818

19-
[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
19+
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
2020

2121
## Permissions
2222

@@ -285,4 +285,4 @@ HTTP/1.1 200 OK
285285
]
286286
]
287287
}
288-
```
288+
```

0 commit comments

Comments
 (0)