attachment 资源类型
命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
用户、邮件、任务或组帖子上多种类型的附件的基类型，用作以下派生类型的附件的基资源：
- 文件（fileAttachment 资源）
- 项目 (联系人、事件或消息，由 itemAttachment 资源)
- 文件链接（referenceAttachment 资源）
您可以以附件的形式向用户 事件、 邮件、 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
}