Skip to content

Commit 358e5ba

Browse files
learn-build-service-prod[bot]learn-build-service-prod[bot]
authored
Merge pull request #27757 from microsoftgraph/main
Auto Publish – main to live - 2025-11-20 00:30 UTC
2 parents 2ff125c + 724d429 commit 358e5ba

File tree

61 files changed

+2355
-144
lines changed

Some content is hidden

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

61 files changed

+2355
-144
lines changed

‎.github/workflows/api-doctor.yml‎

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
name: API Doctor validation
2+
# cSpell:ignore apidoctor longpaths apidoc
3+
4+
on:
5+
workflow_dispatch
6+
# pull_request:
7+
# branches:
8+
# - main
9+
# - live
10+
# paths:
11+
# - api-reference/**
12+
13+
permissions:
14+
contents: read
15+
16+
env:
17+
APIDOCTOR_VERSION: 1.2.2312.152
18+
19+
jobs:
20+
validate-docs:
21+
name: Validate reference docs
22+
# Must be Windows because NuGet-published ApiDoctor
23+
# is Windows only.
24+
runs-on: windows-latest
25+
steps:
26+
# Also required by Windows
27+
- run: git config --global core.longpaths true
28+
- name: Checkout docs repo
29+
uses: actions/checkout@v4
30+
- name: Setup .NET
31+
uses: actions/setup-dotnet@v5
32+
with:
33+
dotnet-version: |
34+
6.x
35+
8.x
36+
- name: Install NuGet
37+
uses: NuGet/setup-nuget@v2
38+
- name: Install ApiDoctor from NuGet
39+
run: nuget install ApiDoctor -Version $Env:APIDOCTOR_VERSION -OutputDirectory ./nuget -NonInteractive -DisableParallelProcessing
40+
- name: Validate v1.0 docs
41+
run: |
42+
$apidoc = ".\nuget\ApiDoctor." + $Env:APIDOCTOR_VERSION + "\tools\apidoc.exe"
43+
& $apidoc check-all --path .\api-reference\v1.0 --ignore-warnings
44+
- name: Validate beta docs
45+
run: |
46+
$apidoc = ".\nuget\ApiDoctor." + $Env:APIDOCTOR_VERSION + "\tools\apidoc.exe"
47+
& $apidoc check-all --path .\api-reference\beta --ignore-warnings

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

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -68,7 +68,9 @@ Content-Type: application/json
6868
6969
{
7070
"user": {
71-
"@odata.type": "microsoft.graph.teamworkUserIdentity"
71+
"@odata.type": "microsoft.graph.teamworkUserIdentity",
72+
"id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
73+
"tenantId": "a1b2c3d4-e5f6-7890-1234-567890abcdef"
7274
}
7375
}
7476
```

‎api-reference/beta/api/crosstenantmigrationjob-cancel.md‎

Lines changed: 91 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,91 @@
1+
---
2+
title: "crossTenantMigrationJob: cancel"
3+
description: "Cancel a crossTenantMigrationJob."
4+
author: "danguilliams"
5+
ms.date: 10/30/2025
6+
ms.localizationpriority: medium
7+
ms.subservice: "t2t-migration"
8+
doc_type: apiPageType
9+
---
10+
11+
# crossTenantMigrationJob: cancel
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Cancel a [crossTenantMigrationJob](../resources/crosstenantmigrationjob.md). All tasks within the job that were in a `Sync` state are canceled. If the job can't be canceled, a `409 Conflict` response is returned and the migrations continue. This response happens when a migration is already in progress or is in a terminal state.
18+
19+
## Permissions
20+
21+
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).
22+
23+
<!-- {
24+
"blockType": "permissions",
25+
"name": "crosstenantmigrationjob-cancel-permissions"
26+
}
27+
-->
28+
[!INCLUDE [permissions-table](../includes/permissions/crosstenantmigrationjob-cancel-permissions.md)]
29+
30+
[!INCLUDE [access-requirements](../includes/rbac-for-apis/rbac-crosstenantmigration-apis.md)]
31+
32+
## HTTP request
33+
34+
<!-- {
35+
"blockType": "ignored"
36+
}
37+
-->
38+
``` http
39+
POST /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/cancel
40+
```
41+
42+
## Request headers
43+
44+
|Name|Description|
45+
|:---|:---|
46+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
47+
48+
## Request body
49+
50+
Don't supply a request body for this method.
51+
52+
## Response
53+
54+
If successful, this action returns a `202 ACCEPTED` response code and a [crossTenantMigrationCancelResponse](../resources/crosstenantmigrationcancelresponse.md) in the response body. If not successful, a `409 CONFLICT` response code is returned, and the migration continues.
55+
56+
## Examples
57+
58+
### Request
59+
60+
The following example shows a request.
61+
<!-- {
62+
"blockType": "request",
63+
"name": "crosstenantmigrationjobthis.cancel"
64+
}
65+
-->
66+
``` http
67+
POST https://graph.microsoft.com/beta/solutions/migrations/crossTenantMigrationJobs/add14989-2b21-4001-81bd-a18b0bac1dea/cancel
68+
```
69+
70+
### Response
71+
72+
The following example shows the response.
73+
>**Note:** The response object shown here might be shortened for readability.
74+
<!-- {
75+
"blockType": "response",
76+
"truncated": true,
77+
"@odata.type": "microsoft.graph.crossTenantMigrationCancelResponse"
78+
}
79+
-->
80+
``` http
81+
HTTP/1.1 202 Accepted
82+
Content-Type: application/json
83+
84+
{
85+
"id": "add14989-2b21-4001-81bd-a18b0bac1dea",
86+
"displayName": "Contoso_migration_job",
87+
"status": "pendingCancel",
88+
"message": "cancellation request has been accepted for the migration job"
89+
}
90+
```
91+

‎api-reference/beta/api/crosstenantmigrationjob-get.md‎

Lines changed: 110 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,110 @@
1+
---
2+
title: "Get crossTenantMigrationJob"
3+
description: "Read the properties and relationships of crossTenantMigrationJob object."
4+
author: "danguilliams"
5+
ms.date: 10/30/2025
6+
ms.localizationpriority: medium
7+
ms.subservice: "t2t-migration"
8+
doc_type: apiPageType
9+
---
10+
11+
# Get crossTenantMigrationJob
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Read the properties and relationships of [crossTenantMigrationJob](../resources/crosstenantmigrationjob.md) object. Includes details of the [crossTenantMigrationJob](../resources/crosstenantmigrationjob.md) , but not details of the individual [crossTenantMigrationTasks](../resources/crosstenantmigrationtask.md) of the [crossTenantMigrationJob](../resources/crosstenantmigrationjob.md).
18+
19+
## Permissions
20+
21+
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).
22+
23+
<!-- {
24+
"blockType": "permissions",
25+
"name": "crosstenantmigrationjob-get-permissions"
26+
}
27+
-->
28+
[!INCLUDE [permissions-table](../includes/permissions/crosstenantmigrationjob-get-permissions.md)]
29+
30+
[!INCLUDE [access-requirements](../includes/rbac-for-apis/rbac-crosstenantmigration-apis.md)]
31+
32+
## HTTP request
33+
34+
<!-- {
35+
"blockType": "ignored"
36+
}
37+
-->
38+
``` http
39+
GET /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}
40+
```
41+
42+
## Optional query parameters
43+
44+
This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
45+
46+
## Request headers
47+
48+
|Name|Description|
49+
|:---|:---|
50+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
51+
52+
## Request body
53+
54+
Don't supply a request body for this method.
55+
56+
## Response
57+
58+
If successful, this method returns a `200 OK` response code and a [crossTenantMigrationJob](../resources/crosstenantmigrationjob.md) object in the response body.
59+
60+
## Examples
61+
62+
### Request
63+
64+
The following example shows a request.
65+
<!-- {
66+
"blockType": "request",
67+
"name": "get_crosstenantmigrationjob"
68+
}
69+
-->
70+
``` http
71+
GET https://graph.microsoft.com/beta/solutions/migrations/crossTenantMigrationJobs/012ec4f4-df7e-41ae-ba95-6d7ccb8f74a1
72+
```
73+
74+
75+
### Response
76+
77+
The following example shows the response.
78+
<!-- {
79+
"blockType": "response",
80+
"truncated": true,
81+
"@odata.type": "microsoft.graph.crossTenantMigrationJob"
82+
}
83+
-->
84+
``` http
85+
HTTP/1.1 200 OK
86+
Content-Type: application/json
87+
88+
{
89+
"@odata.context": "https://graph.microsoft.com/beta/$metadata#solutions/migrations/crossTenantMigrationJobs/$entity",
90+
"id": "012ec4f4-df7e-41ae-ba95-6d7ccb8f74a1",
91+
"displayName": "Contoso_user_migration",
92+
"status": "completed",
93+
"jobType": "migrate",
94+
"message": "The batch and all of its users have been successfully migrated with no failures.",
95+
"completeAfterDateTime": "2025-11-06T09:11:33.2115505Z",
96+
"sourceTenantId": "12345678-1234-1234-1234-123456789012",
97+
"targetTenantId": "87654321-4321-4321-4321-210987654321",
98+
"resourceType": "users",
99+
"resources": [],
100+
"workloads": [],
101+
"createdBy": "a0d9fdb1-171f-4e2b-8a82-06775ad24790",
102+
"createdDateTime": "2025-11-06T09:06:34.4773205Z",
103+
"lastUpdatedDateTime": "2025-11-06T11:26:00Z",
104+
"exchangeSettings": {
105+
"targetDeliveryDomain": "contoso.onmicrosoft.com",
106+
"sourceEndpoint": "EXOHandler"
107+
}
108+
}
109+
```
110+

0 commit comments

Comments
 (0)