attachment 资源类型

命名空间：microsoft.graph

可以附件形式向用户事件、邮件或帖子添加相关内容。

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

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

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

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

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

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

方法

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

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

属性

下面介绍了任意 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
}