更新 fileStorageContainer 的自定义属性

命名空间：microsoft.graph

更新 fileStorageContainer 上的一个或多个自定义属性。 只能更新自定义属性 的值 和 isSearchable 属性。 仅更新请求正文中指定的自定义属性。 如果容器上不存在请求正文中指定的自定义属性，则会创建该属性。

将自定义属性更新为 null 值会从容器中删除该属性。

调用此 API 的应用程序必须对相应容器类型的 fileStorageContainer 具有读取和写入权限。

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时，才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息，请参阅权限类型。 要了解有关这些权限的详细信息，请参阅 权限参考。

权限类型	最低特权权限	更高特权权限
委派（工作或学校帐户）	FileStorageContainer.Selected	不可用。
委派（个人 Microsoft 帐户）	不支持。	不支持。
应用程序	FileStorageContainer.Selected	不可用。

除了Microsoft Graph 权限外，应用还必须具有调用此 API 所需的容器类型级别权限。 有关容器类型的详细信息，请参阅 容器类型。 若要详细了解容器类型级别权限，请参阅 SharePoint 嵌入式授权。

HTTP 请求

PATCH /storage/fileStorage/containers/{containerId}/customProperties

请求标头

名称	说明
Authorization	持有者 {token}。 必填。 详细了解 身份验证和授权。
Content-Type	application/json. 必需。

请求正文

在请求正文中，提供要更新的自定义属性和相关字段的新值。

可以修改自定义属性上的以下属性。

属性	类型	说明
value	String	自定义属性的值。
isSearchable	布尔值	指示属性是否可搜索。

响应

如果成功，此操作返回 200 OK 响应代码。

示例

请求

以下示例更新value自定义属性 和 color的 属性clientUniqeId。 请注意， isSearchable 在调用此 API 之前，已 clientUniqueId 将 true 设置为 。

HTTP

PATCH https://graph.microsoft.com/v1.0/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/customProperties
Content-type: application/json

{
  "clientUniqueId": {
    "value": "c5d88310-1fc7-49be-80ca-e7d7a11e638b"
  },
  "color": {
    "value": "green"
  }
}

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const fileStorageContainerCustomPropertyDictionary = {
  clientUniqueId: {
    value: 'c5d88310-1fc7-49be-80ca-e7d7a11e638b'
  },
  color: {
    value: 'green'
  }
};

await client.api('/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/customProperties')
	.update(fileStorageContainerCustomPropertyDictionary);

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

响应

以下示例显示了相应的响应。

HTTP/1.1 200 Ok

{
  "clientUniqueId": {
    "value": "c5d88310-1fc7-49be-80ca-e7d7a11e638b",
    "isSearchable": true
  },
  "color": {
    "value": "green",
    "isSearchable": false
  }
}