Skip to content

Commit f1d7503

Browse files
authored
Merge pull request #24166 from microsoftgraph/main
Merge to publish.
2 parents f8e58ce + 82c0ceb commit f1d7503

File tree

2,806 files changed

+2988
-2849
lines changed

Some content is hidden

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

2,806 files changed

+2988
-2849
lines changed

.github/workflows/cloud-support.yml

Lines changed: 97 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
1+
name: Update cloud support status
2+
3+
on:
4+
schedule:
5+
- cron: 0 11 * * 1
6+
workflow_dispatch:
7+
8+
permissions:
9+
contents: write
10+
pull-requests: write
11+
12+
jobs:
13+
update-cloud-support:
14+
name: Update cloud support
15+
runs-on: ubuntu-latest
16+
steps:
17+
- name: Checkout docs repo
18+
uses: actions/checkout@v4.1.3
19+
with:
20+
path: docs
21+
- name: Checkout metadata repo
22+
uses: actions/checkout@v4.1.3
23+
with:
24+
repository: microsoftgraph/msgraph-metadata
25+
path: metadata
26+
- name: Checkout tool repo
27+
uses: actions/checkout@v4.1.3
28+
with:
29+
repository: microsoftgraph/msgraph-cloud-support
30+
path: tool
31+
- name: Setup .NET
32+
uses: actions/setup-dotnet@v4
33+
with:
34+
dotnet-version: 8.x
35+
- name: Build cloud support tool
36+
working-directory: ./tool
37+
run: dotnet build --configuration Release
38+
- name: Install hidi
39+
run: dotnet tool install microsoft.openapi.hidi -g
40+
- name: Create metadata output director
41+
run: |
42+
mkdir openapi
43+
cd openapi
44+
mkdir v1.0
45+
mkdir beta
46+
- name: Apply XSLT to CSDL files
47+
working-directory: ./metadata
48+
shell: pwsh
49+
run: |
50+
./transforms/csdl/transform.ps1 -xslPath preprocess_csdl.xsl -inputPath ../../schemas/v1.0-Prod.csdl -outputPath ../../transformed_v1.0-Prod.csdl -addInnerErrorDescription $true -removeCapabilityAnnotations $false -csdlVersion v1.0
51+
./transforms/csdl/transform.ps1 -xslPath preprocess_csdl.xsl -inputPath ../../schemas/v1.0-Fairfax.csdl -outputPath ../../transformed_v1.0-Fairfax.csdl -addInnerErrorDescription $true -removeCapabilityAnnotations $false -csdlVersion v1.0
52+
./transforms/csdl/transform.ps1 -xslPath preprocess_csdl.xsl -inputPath ../../schemas/v1.0-Mooncake.csdl -outputPath ../../transformed_v1.0-Mooncake.csdl -addInnerErrorDescription $true -removeCapabilityAnnotations $false -csdlVersion v1.0
53+
./transforms/csdl/transform.ps1 -xslPath preprocess_csdl.xsl -inputPath ../../schemas/beta-Prod.csdl -outputPath ../../transformed_beta-Prod.csdl -addInnerErrorDescription $true -removeCapabilityAnnotations $false -csdlVersion v1.0
54+
./transforms/csdl/transform.ps1 -xslPath preprocess_csdl.xsl -inputPath ../../schemas/beta-Fairfax.csdl -outputPath ../../transformed_beta-Fairfax.csdl -addInnerErrorDescription $true -removeCapabilityAnnotations $false -csdlVersion v1.0
55+
./transforms/csdl/transform.ps1 -xslPath preprocess_csdl.xsl -inputPath ../../schemas/beta-Mooncake.csdl -outputPath ../../transformed_beta-Mooncake.csdl -addInnerErrorDescription $true -removeCapabilityAnnotations $false -csdlVersion v1.0
56+
- name: Transform CSDL with hidi
57+
working-directory: ./metadata
58+
env:
59+
SETTINGS: ./conversion-settings/openapi.json
60+
run: |
61+
hidi transform --cs transformed_v1.0-Prod.csdl -o ../openapi/v1.0/Prod.yml --co -f Yaml --sp $SETTINGS
62+
hidi transform --cs transformed_v1.0-Fairfax.csdl -o ../openapi/v1.0/Fairfax.yml --co -f Yaml --sp $SETTINGS
63+
hidi transform --cs transformed_v1.0-Mooncake.csdl -o ../openapi/v1.0/Mooncake.yml --co -f Yaml --sp $SETTINGS
64+
hidi transform --cs transformed_beta-Prod.csdl -o ../openapi/beta/Prod.yml --co -f Yaml --sp $SETTINGS
65+
hidi transform --cs transformed_beta-Fairfax.csdl -o ../openapi/beta/Fairfax.yml --co -f Yaml --sp $SETTINGS
66+
hidi transform --cs transformed_beta-Mooncake.csdl -o ../openapi/beta/Mooncake.yml --co -f Yaml --sp $SETTINGS
67+
- name: Run cloud support tool
68+
env:
69+
TOOL: ./tool/src/bin/Release/net8.0/CheckCloudSupport
70+
run: |
71+
$TOOL --open-api ./openapi/v1.0 --api-docs ./docs/api-reference/v1.0/api --remove-old-includes
72+
$TOOL --open-api ./openapi/beta --api-docs ./docs/api-reference/beta/api --remove-old-includes
73+
- name: Get token
74+
id: get_token
75+
uses: microsoftgraph/get-app-token@v1.0.2
76+
with:
77+
application-id: ${{ secrets.APPLICATION_ID }}
78+
application-private-key: ${{ secrets.APPLICATION_PRIVATE_KEY }}
79+
- name: Commit updates and open pull request
80+
working-directory: ./docs
81+
shell: pwsh
82+
env:
83+
GH_TOKEN: ${{ steps.get_token.outputs.app-token }}
84+
run: |
85+
$status = git status --porcelain
86+
if ($status -eq $null) {
87+
Write-Host "No changes to commit." -ForegroundColor Green
88+
} else {
89+
$timestamp = Get-Date -Format FileDateTimeUniversal
90+
git config user.email "GraphTooling@service.microsoft.com"
91+
git config user.name "Microsoft Graph DevX Tooling"
92+
git checkout -b cloud-support/$timestamp
93+
git add .
94+
git commit -m "Update cloud support status"
95+
git push --set-upstream origin cloud-support/$timestamp
96+
gh pr create --base main --title "Update cloud support status" --body "Ran cloud support tool"
97+
}

api-reference/beta/api/channel-getallretainedmessages.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,16 @@ This method supports the following OData query parameters to help customize the
5454
| $filter | The [$filter](/graph/query-parameters#filter-parameter) query parameter supports date and time range queries on the **lastModifiedDateTime** property.|
5555
| $top | Use the [$top](/graph/query-parameters#top-parameter) query parameter to control the number of items per response.|
5656

57+
The following table lists examples that show how to use the `$filter` parameter.
58+
59+
|Scenario | `$filter` parameter |Possible values |
60+
|:-----------------------------------------|:---------------------------------------------------------------------------------------|:-----------------------------------------------------------------------------------------------------------|
61+
|Get messages sent by user identity type |$filter=from/user/userIdentityType eq '{teamworkUserIdentityType}' |aadUser, onPremiseAadUser, anonymousGuest, federatedUser, personalMicrosoftAccountUser, skypeUser, phoneUser|
62+
|Get messages sent by application type |$filter=from/application/applicationIdentityType eq '{teamworkApplicationIdentity}' |aadApplication, bot, tenantBot, office365Connector, outgoingWebhook |
63+
|Get messages sent by user ID |$filter=from/user/id eq '{oid}' ||
64+
|Get control (system event) messages |$filter=messageType eq 'systemEventMessage' ||
65+
|Exclude control (system event) messages |$filter=messageType ne 'systemEventMessage' ||
66+
5767
## Request headers
5868

5969
|Name|Description|

api-reference/beta/api/channel-patch-tabs.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,9 @@ Update the properties of the specified [tab](../resources/teamstab.md).
1717

1818
This API can be used to configure the content of the tab.
1919

20+
> [!NOTE]
21+
> You can't use this API to update a static tab. An attempt to update a static tab returns a `400 Bad Request` response code.
22+
2023
[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
2124

2225
## Permissions

api-reference/beta/api/channel-post-tabs.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,8 @@ Namespace: microsoft.graph
1515

1616
Add (pin) a [tab](../resources/teamstab.md) to the specified [channel](../resources/channel.md) within a [team](../resources/team.md). The app must be [preinstalled in the team](../api/team-list-installedapps.md) and have the [configurableTabs](/microsoftteams/platform/resources/schema/manifest-schema#configurabletabs) property defined in the app manifest.
1717

18+
> **Note**: If the app manifest for a given **appId** contains a static tab that matches the current scope (**team**), the static tab is pinned by default.
19+
1820
[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
1921

2022
## Permissions
@@ -43,7 +45,10 @@ POST /teams/{id}/channels/{id}/tabs
4345

4446
## Request body
4547

46-
A [teamsTab](../resources/teamstab.md).
48+
In the request body, supply a JSON representation of a [teamsTab](../resources/teamstab.md).
49+
50+
> [!NOTE]
51+
> When you pin a static tab, Teams takes the **displayName** and **configuration** from the app manifest. If these properties are specified in the request body, this API returns a `400 Bad Request` response code.
4752
4853
## Response
4954

api-reference/beta/api/chat-getallretainedmessages.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,17 @@ The following example shows a request that uses the `$top` and `$filter` query p
5757
```http
5858
GET /users/{id}/chats/getAllRetainedMessages?$top=50&$filter=lastModifiedDateTime gt 2020-06-04T18:03:11.591Z and lastModifiedDateTime lt 2020-06-05T21:00:09.413Z
5959
```
60+
61+
The following table lists examples that show how to use the `$filter` parameter.
62+
63+
|Scenario | `$filter` parameter |Possible values |
64+
|:-----------------------------------------|:---------------------------------------------------------------------------------------|:-----------------------------------------------------------------------------------------------------------|
65+
|Get messages sent by user identity type |$filter=from/user/userIdentityType eq '{teamworkUserIdentityType}' |aadUser, onPremiseAadUser, anonymousGuest, federatedUser, personalMicrosoftAccountUser, skypeUser, phoneUser|
66+
|Get messages sent by application type |$filter=from/application/applicationIdentityType eq '{teamworkApplicationIdentity}' |aadApplication, bot, tenantBot, office365Connector, outgoingWebhook |
67+
|Get messages sent by user ID |$filter=from/user/id eq '{oid}' ||
68+
|Get control (system event) messages |$filter=messageType eq 'systemEventMessage' ||
69+
|Exclude control (system event) messages |$filter=messageType ne 'systemEventMessage' ||
70+
6071
## Request headers
6172

6273
|Name|Description|

api-reference/beta/api/chat-patch-tabs.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,9 @@ Namespace: microsoft.graph
1616
Update the properties of the specified [tab](../resources/teamstab.md) in a [chat](../resources/chat.md).
1717
This API can be used to configure the content of the tab.
1818

19-
> **Note:** If the chat is associated with an [onlineMeeting](../resources/onlinemeeting.md) instance, then, effectively, the tab pinned in the meeting will be updated.
19+
> [!NOTE]
20+
> - If the chat is associated with an [onlineMeeting](../resources/onlinemeeting.md) instance, then, effectively, the tab pinned in the meeting will be updated.
21+
> - You can't use this API to update a static tab. An attempt to update a static tab returns a `400 Bad Request` response code.
2022
2123
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
2224

@@ -47,7 +49,7 @@ PATCH /chats/{chat-id}/tabs/{tab-id}
4749
| Content-Type | application/json. Required. |
4850

4951
## Request body
50-
In the request body, supply a JSON representation of [tab](../resources/teamstab.md) object.
52+
In the request body, supply a JSON representation of a [tab](../resources/teamstab.md) object.
5153

5254
## Response
5355

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

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,9 @@ Namespace: microsoft.graph
1616
Add (pin) a [tab](../resources/teamstab.md) to the specified [chat](../resources/chat.md).
1717
The corresponding app must already be [installed in the chat](../api/chat-list-installedapps.md).
1818

19-
> **Note:** If the chat is associated with an [onlineMeeting](../resources/onlinemeeting.md) instance, then, effectively, the tab will get added to the meeting.
19+
> **Notes**:
20+
> * If the chat is associated with an [onlineMeeting](../resources/onlinemeeting.md) instance, then the tab is effectively added to the meeting.
21+
> * If the app manifest for a given **appId** contains a static tab that matches the current scope (`chat`/`groupChat`), the static tab is pinned by default.
2022
2123
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
2224

@@ -44,6 +46,9 @@ POST /chats/{chat-id}/tabs
4446

4547
In the request body include a JSON representation of a [teamsTab](../resources/teamstab.md).
4648

49+
> [!NOTE]
50+
> When you pin a static tab, Teams takes the **displayName** and **configuration** from the app manifest. If these properties are specified in the request body, this API returns a `400 Bad Request` response code.
51+
4752
## Response
4853

4954
If successful, this method returns a `201 Created` response code and an instance of the [teamsTab](../resources/teamstab.md) resource in the body.

api-reference/beta/api/directory-deleteditems-list.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -62,9 +62,9 @@ ConsistencyLevel: eventual
6262

6363
This example requires the **ConsistencyLevel** header because the `$orderby` and `$count` query parameters are used in the query.
6464

65-
### Examples using the $orderby OData query parameter
65+
### $orderby OData query parameter examples
6666

67-
The `$orderby` OData query parameter is supported on the **deletedDateTime**, **displayName**, and **userPrincipalName** properties of the deleted object types. On the **deletedDateTime** property, the query requires adding the [advanced query parameters](/graph/aad-advanced-queries) (**ConsistencyLevel** header set to `true` and `$count=true` query string).
67+
The `$orderby` OData query parameter is supported on the **deletedDateTime**, **displayName**, and **userPrincipalName** properties of the deleted object types. On the **deletedDateTime** property, the query requires adding the [advanced query parameters](/graph/aad-advanced-queries) (**ConsistencyLevel** header set to `eventual` and `$count=true` query string).
6868

6969
| OData cast | Properties supporting $orderby | Example |
7070
| :--- | :--- | :--- |

api-reference/beta/api/intune-androidfotaservice-devicemanagementreports-get.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -72,4 +72,4 @@ Content-Length: 86
7272
"@odata.type": "#microsoft.graph.deviceManagementReports"
7373
}
7474
}
75-
```
75+
```

api-reference/beta/api/intune-androidfotaservice-devicemanagementreports-getzebrafotadeploymentreport.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -104,4 +104,4 @@ Content-Length: 95
104104
{
105105
"value": "Z2V0WmVicmFGb3RhRGVwbG95bWVudFJlcG9ydCBJbnR1bmUgRG9jIFNhbXBsZSAyMDcxMDQ2MzM5"
106106
}
107-
```
107+
```

api-reference/beta/api/intune-androidfotaservice-devicemanagementreports-update.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -80,4 +80,4 @@ Content-Length: 65
8080
{
8181
"@odata.type": "#microsoft.graph.deviceManagementReports"
8282
}
83-
```
83+
```

api-reference/beta/api/intune-androidfotaservice-zebrafotaartifact-create.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -100,4 +100,4 @@ Content-Length: 399
100100
"releaseNotesUrl": "https://example.com/releaseNotesUrl/",
101101
"description": "Description value"
102102
}
103-
```
103+
```

api-reference/beta/api/intune-androidfotaservice-zebrafotaartifact-delete.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -61,4 +61,4 @@ DELETE https://graph.microsoft.com/beta/deviceManagement/zebraFotaArtifacts/{zeb
6161
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.
6262
``` http
6363
HTTP/1.1 204 No Content
64-
```
64+
```

api-reference/beta/api/intune-androidfotaservice-zebrafotaartifact-get.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -79,4 +79,4 @@ Content-Length: 434
7979
"description": "Description value"
8080
}
8181
}
82-
```
82+
```

api-reference/beta/api/intune-androidfotaservice-zebrafotaartifact-list.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -78,4 +78,4 @@ Content-Length: 464
7878
}
7979
]
8080
}
81-
```
81+
```

api-reference/beta/api/intune-androidfotaservice-zebrafotaartifact-update.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -100,4 +100,4 @@ Content-Length: 399
100100
"releaseNotesUrl": "https://example.com/releaseNotesUrl/",
101101
"description": "Description value"
102102
}
103-
```
103+
```

api-reference/beta/api/intune-androidfotaservice-zebrafotaconnector-approvefotaapps.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,4 +67,4 @@ Content-Length: 21
6767
{
6868
"value": true
6969
}
70-
```
70+
```

api-reference/beta/api/intune-androidfotaservice-zebrafotaconnector-connect.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,4 +67,4 @@ Content-Length: 21
6767
{
6868
"value": true
6969
}
70-
```
70+
```

api-reference/beta/api/intune-androidfotaservice-zebrafotaconnector-disconnect.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,4 +67,4 @@ Content-Length: 21
6767
{
6868
"value": true
6969
}
70-
```
70+
```

api-reference/beta/api/intune-androidfotaservice-zebrafotaconnector-get.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -78,4 +78,4 @@ Content-Length: 393
7878
"fotaAppsApproved": true
7979
}
8080
}
81-
```
81+
```

api-reference/beta/api/intune-androidfotaservice-zebrafotaconnector-hasactivedeployments.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,4 +67,4 @@ Content-Length: 21
6767
{
6868
"value": true
6969
}
70-
```
70+
```

api-reference/beta/api/intune-androidfotaservice-zebrafotaconnector-update.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -97,4 +97,4 @@ Content-Length: 360
9797
"lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
9898
"fotaAppsApproved": true
9999
}
100-
```
100+
```

api-reference/beta/api/intune-androidfotaservice-zebrafotadeployment-cancel.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,4 +67,4 @@ Content-Length: 21
6767
{
6868
"value": true
6969
}
70-
```
70+
```

api-reference/beta/api/intune-androidfotaservice-zebrafotadeployment-create.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -108,4 +108,4 @@ Content-Length: 393
108108
"Role Scope Tag Ids value"
109109
]
110110
}
111-
```
111+
```

api-reference/beta/api/intune-androidfotaservice-zebrafotadeployment-delete.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -61,4 +61,4 @@ DELETE https://graph.microsoft.com/beta/deviceManagement/zebraFotaDeployments/{z
6161
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.
6262
``` http
6363
HTTP/1.1 204 No Content
64-
```
64+
```

api-reference/beta/api/intune-androidfotaservice-zebrafotadeployment-get.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -83,4 +83,4 @@ Content-Length: 436
8383
]
8484
}
8585
}
86-
```
86+
```

api-reference/beta/api/intune-androidfotaservice-zebrafotadeployment-list.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -82,4 +82,4 @@ Content-Length: 474
8282
}
8383
]
8484
}
85-
```
85+
```

api-reference/beta/api/intune-androidfotaservice-zebrafotadeployment-update.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -108,4 +108,4 @@ Content-Length: 393
108108
"Role Scope Tag Ids value"
109109
]
110110
}
111-
```
111+
```

api-reference/beta/api/intune-apps-androidforworkapp-create.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -164,4 +164,4 @@ Content-Length: 1132
164164
"totalLicenseCount": 1,
165165
"appStoreUrl": "https://example.com/appStoreUrl/"
166166
}
167-
```
167+
```

api-reference/beta/api/intune-apps-androidforworkapp-delete.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -61,4 +61,4 @@ DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAp
6161
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.
6262
``` http
6363
HTTP/1.1 204 No Content
64-
```
64+
```

api-reference/beta/api/intune-apps-androidforworkapp-get.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -103,4 +103,4 @@ Content-Length: 1215
103103
"appStoreUrl": "https://example.com/appStoreUrl/"
104104
}
105105
}
106-
```
106+
```

api-reference/beta/api/intune-apps-androidforworkapp-list.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -102,4 +102,4 @@ Content-Length: 1293
102102
}
103103
]
104104
}
105-
```
105+
```

api-reference/beta/api/intune-apps-androidforworkapp-update.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -164,4 +164,4 @@ Content-Length: 1132
164164
"totalLicenseCount": 1,
165165
"appStoreUrl": "https://example.com/appStoreUrl/"
166166
}
167-
```
167+
```

api-reference/beta/api/intune-apps-androidforworkmobileappconfiguration-create.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -136,4 +136,4 @@ Content-Length: 814
136136
"profileApplicability": "androidWorkProfile",
137137
"connectedAppsEnabled": true
138138
}
139-
```
139+
```

0 commit comments

Comments
 (0)