命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示用于将特定源资源迁移到目标组织的迁移任务，并指示该迁移作的状态。 此实体捕获执行 sharePointMigrationTask 作的特定意向，具有唯一 ID，可以独立存在，具有定义的生存期，并且可以使用 ID 检索。
继承自 entity。
Methods
| 方法 | 返回类型 | 说明 |
|---|---|---|
| Get | sharePointMigrationTask | 使用任务 ID 获取以前创建的 sharePointMigrationTask 。 |
| 创建或更新 | sharePointMigrationTask | 使用 sharePointMigrationTaskParameters 创建或更新 sharePointMigrationTask 以将资源从源组织迁移到目标组织。 |
| 按源用户主体名称获取 | sharePointMigrationTask | 使用源用户PrincipalName 获取以前为用户创建的 sharePointMigrationTask。 |
| 按源站点 URL 获取 | sharePointMigrationTask | 使用源网站 URL 获取以前为常规网站创建的 sharePointMigrationTask 。 |
| 按源组邮件昵称获取 | sharePointMigrationTask | 使用源组邮件昵称获取以前为组创建的 sharePointMigrationTask 。 |
| Cancel | 无 | 取消将特定对象从源组织移动到目标组织的 sharePointMigrationTask 。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| error | publicError | 用于提供失败上下文的错误信息。 可选。 只读。 仅在 OneDrive 和 SharePoint 上。 |
| finishedDateTime | DateTimeOffset |
sharePointMigrationTask 结束的日期和时间（如果可用）。 任务可能成功完成或失败，但该任务将在该时间结束。 此为只读属性。 仅在 OneDrive 和 SharePoint 上。 时间戳类型使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 格式。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 |
| id | String | 参数中定义的源组织和资源的 sharePointMigrationTask 作的唯一 ID。 在创建过程中省略此属性。 服务会自动返回它。 继承自 entity。 |
| lastUpdatedDateTime | DateTimeOffset | 上次更新或处理 sharePointMigrationTask 的日期和时间（如果可用）。 使用此属性可查找长时间停止处理的任务。 此为只读属性。 可选。 时间戳类型使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 格式。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 |
| parameters | sharePointMigrationTaskParameters | 标识源资源和组织，定义目标组织，并包括控制迁移过程的设置。 这些设置必须在任务创建期间指定，并且还会在有关此任务的每个查询中返回这些设置，以便进行跟踪和识别。 |
| startedDateTime | DateTimeOffset |
sharePointMigrationTask 启动的日期和时间（如果可用）。 只读。 时间戳类型使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 格式。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 |
| status | sharePointMigrationTaskStatus | 指示此任务表示的迁移活动的状态。 在创建过程中省略此属性。 服务会自动返回它。 可能的值包括 notStarted、inProgress、completed、cancelled、failed、unknownFutureValue。 |
关系
无。
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"@odata.type": "#microsoft.graph.sharePointMigrationTask",
"error": {"@odata.type": "microsoft.graph.publicError"},
"finishedDateTime": "String (timestamp)",
"id": "String (identifier)",
"lastUpdatedDateTime": "String (timestamp)",
"parameters": {"@odata.type": "microsoft.graph.sharePointMigrationTaskParameters"},
"startedDateTime": "String (timestamp)",
"status": "String"
}