attachment 资源类型

  • 项目

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

用户、邮件、任务或组帖子上多种类型的附件的基类型，用作以下派生类型的附件的基资源：

您可以以附件的形式向用户 事件、 邮件、 Outlook 任务或组 帖子 添加相关内容。

警告

Outlook 任务在 2022 年 8 月 10 日已弃用并停止返回数据。 通过 Outlook 任务更新使用此功能的现有应用。

组日历中的事件不支持附件。

Outlook 任务不支持引用附件。

注意：如果要将文件附加到组帖子，或者将项目附加到事件、邮件或组帖子，请将附件的大小限制为 3 MB。

如果附加的文件低于 3 MB，则可以 将文件附件添加到用户事件、 邮件或 组帖子。

如果要将 3 MB 到 150 MB 之间的文件附加到事件或消息，则可以 创建上传会话 ，并迭代上传文件的范围以附加该文件。 有关示例，请参阅 将大型文件附加到 Outlook 邮件 。

方法

以下方法适用于所有附件派生类型（fileAttachment、itemAttachment 或 referenceAttachment）。

方法 返回类型 说明
获取附件 attachment 读取附加到用户事件、邮件、Outlook 任务或帖子的附件的属性、关系或原始内容。
将附件添加到用户事件中 附件 将文件、项目或链接附件添加到用户日历中的事件中。 此操作限制可添加到 3 MB 以下的附件的大小。
将附件添加到邮件中 附件 将文件、项目或将附件链接添加到邮件中。 此操作限制可添加到 3 MB 以下的附件的大小。
创建用于附加大型文件的会话 uploadSession 创建允许应用以迭代方式上传文件范围的上传会话，以便将文件附加到指定的 消息 或 事件。 文件大小必须介于 3 MB 到 150 MB 之间。
将附件添加到 Outlook 任务 (已弃用) attachment 将文件或项目附件添加到 Outlook 任务。
将附件添加到帖子中 附件 将文件、项目或链接附件添加到组帖子。 此操作限制可添加到 3 MB 以下的附件的大小。
列出用户事件的附件 附件集合 获取用户日历中事件的附件列表。
列出邮件的附件 附件 集合 获取邮件的附件列表。
列出 Outlook 任务的附件 (已弃用) 附件集合 获取 Outlook 任务的附件列表。
列出帖子的附件 附件 集合 获取帖子的附件列表。
删除 None 删除事件、邮件、Outlook 任务或帖子上的附件。

属性

下面介绍了任意 attachment 资源的基础属性。 有关其他属性，请参阅具体附件类型（fileAttachment、itemAttachment 或 referenceAttachment）。

属性 类型 说明
contentType String MIME 类型。
id String 只读。
isInline Boolean 如果附件是内嵌附件，则为 true；否则为 false。
lastModifiedDateTime DateTimeOffset 时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z
name String 附件的显示名称。 这不必是实际的文件名。
size Int32 附件大小，以字节为单位。

关系

无

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "contentType": "string",
  "id": "string (identifier)",
  "isInline": true,
  "lastModifiedDateTime": "String (timestamp)",
  "name": "string",
  "size": 1024
}