你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Attachments

项目
08/05/2023

Azure Cosmos DB 是一个全球分布式多模型数据库，支持文档、图形、cassandra 和表数据模型。本部分中的内容用于通过 REST 使用 SQL API 管理附件资源。

附件是包含引用和与外部 Blob 或媒体文件关联的元数据的特殊文档。

开发人员可以选择：

Azure Cosmos DB 托管的附件媒体/Blob 或
将其与外部 Blob 服务提供程序（如 OneDrive、Dropbox 等）一起存储。并将附件的引用元数据存储在 Azure Cosmos DB 中。

附件资源由 Azure Cosmos DB REST 资源模型中的附件表示。附件资源有固定架构。无论原始媒体存储在何处，下列属性都是必需的。

以下示例说明了文档附件的 JSON 构造。

{    
   "id":"image13d65101-90c4-4c2a-a423-fbf221c73233",  
   "contentType":"image/jpg",  
   "media":"www.bing.com",  
   "_rid":"rnYYAMVFUAUBAAAAAAAAAEC+LNM=",  
   "_ts":1408056025,  
   "_self":"dbs\/rnYYAA==\/colls\/rnYYAMVFUAU=\/docs\/rnYYAMVFUAUBAAAAAAAAAA==\/attachments\/rnYYAMVFUAUBAAAAAAAAAEC+LNM=",  
   "_etag":"00002a00-0000-0000-0000-53ed3ad90000"  
}

属性	说明
`id`	必需。它是用户可设置的属性。它是标识附件的唯一名称，也就是说，没有两个附件共享同一文档的相同 ID。 ID 不得超过 255 个字符。
`contentType`	必需。它是用户可设置的属性。它指定附件的内容类型。将附件位作为正文提交时，Cosmos DB 会将设置为 `contentType` 标头中 `Content-Type` 设置的类型。
`Media`	必需。它是附件所在的 URL 链接或文件路径。
`_rid`	它是系统生成的属性。资源 ID (`_rid`) 是一个唯一标识符，也是根据资源模型上的资源堆栈分层的。它可供内部用于放置和导航附件资源。
`_ts`	它是系统生成的属性。它指定资源的上次更新时间戳。高值是一个时间戳。
`_self`	它是系统生成的属性。它是资源的唯一可寻址 URI。
`_etag`	它是系统生成的属性，用于指定乐观并发控制所需的资源 etag。

常见响应标头

以下信息对于与附件相关的所有响应是通用的：

标头	说明
`x-ms-max-media-storage-usage-mb`	使用 Cosmos DB 附件存储来存储原始媒体时，此标头显示帐户分配的总附件存储配额。
`x-ms-media-storage-usage-mb`	使用 Cosmos DB 附件存储来存储原始媒体时，此标头显示当前使用的附件存储。

任务

可以使用附件执行以下任务：

附件内容不可编制索引或不可搜索;附件资源属性已编制索引且可搜索。

这些操作类似于文档的操作。不是对文档执行操作，而是针对特定文档下的附件资源路径执行这些操作。因此，我们将不再详细阐述各种操作。下一节中将讨论如何使用原始媒体发布和仅限元数据的发布创建附件。

Attachments

常见响应标头

任务

另请参阅

其他资源