将自定义属性添加到 fileStorageContainer

项目
11/12/2024

命名空间：microsoft.graph

将自定义属性添加到 fileStorageContainer 对象。

权限

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

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

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

HTTP 请求

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

请求标头

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

请求正文

在请求正文中，提供 fileStorageContainerCustomPropertyDictionary 的 JSON 表示形式，这是一个包含字符串键和 fileStorageContainerCustomPropertyValue 值的映射。

创建自定义属性时，可以指定以下属性。

属性	类型	说明
value	String	自定义属性的值。必填。
isSearchable	布尔值	指示属性是否可搜索的标志。可选。默认值为 `false`。

响应

如果成功，此方法返回 200 Created 响应代码。

示例

示例 1：创建自定义属性

请求

以下示例演示如何为容器创建名为的 clientUniqueId 自定义属性。

HTTP
JavaScript

PATCH https://graph.microsoft.com/v1.0/storage/fileStorage/containers/{containerId}/customProperties
Content-Type: application/json

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


const options = {
	authProvider,
};

const client = Client.init(options);

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

await client.api('/storage/fileStorage/containers/{containerId}/customProperties')
	.update(fileStorageContainerCustomPropertyDictionary);

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

响应

以下示例显示了相应的响应。默认情况下，属性不可搜索。

HTTP/1.1 200 Created

示例 2：创建自定义可搜索属性

请求

以下示例演示如何为容器创建名为 clientUniqueId 的可搜索自定义属性。

HTTP
JavaScript

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",
    "isSearchable": true
  }
}


const options = {
	authProvider,
};

const client = Client.init(options);

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

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