attachment 资源类型

命名空间：microsoft.graph

重要

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

注意

应更新将此功能与Outlook一起使用的现有应用，Outlook弃用的任务。 有关详细信息微软待办请参阅公共预览版中的 API。

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

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

Outlook 任务不支持引用附件。

附件 是以下附件派生类型的基础资源：

• 文件（fileAttachment 资源）
• 项（由 itemAttachment 资源表示的联系人、事件或邮件）
• 文件链接（referenceAttachment 资源）

注意：可以添加到的文件或项目附件的大小限制为 4 MB 以下。

但是，如果要将介于 3MB 和 150MB 之间的文件附加到邮件，可以创建上载会话并反复上载文件范围以附加它。 有关 示例，请参阅将大文件附加到 Outlook 邮件。

方法

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

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