accessPackageResourceAttribute 资源类型

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

访问包资源属性是用户必须能够访问应用程序的属性的定义。 此结构包含在目录的 accessPackageResource 中，对于角色包含在该目录中的访问包中的应用程序。 当用户请求访问包时，他们必须提供 属性的值，如果请求获得批准，则该值将写入用户的目录对象上。 然后，应用程序可以随后 读取用户的 属性。

属性

属性	类型	说明
attributeDestination	accessPackageResourceAttributeDestination	有关如何设置属性的信息，目前为 accessPackageUserDirectoryAttributeStore 对象类型。
attributeName	String	最终系统中属性的名称。 如果目标是 accessPackageUserDirectoryAttributeStore，则用户属性（如 jobTitle ）或用户对象类型的目录架构扩展，例如 extension_2b676109c7c74ae2b41549205f1947ed_personalTitle。
attributeSource	accessPackageResourceAttributeSource	有关如何在 实现 accessPackageAssignmentRequest （当前为 accessPackageResourceAttributeQuestion 对象类型）时填充属性值的信息。
id	String	访问包资源上的 属性的唯一标识符。 此为只读属性。
isEditable	String	指定请求者是否可以编辑现有属性值。
isPersistedOnAssignmentRemoval	布尔值	指定在分配结束后，特性是否保留在最终系统中。

accessPackageResourceAttribute 资源类型和扩展属性

访问包资源属性的 attributeDestination、 attributeName 和 attributeSource 属性与 目录扩展属性相关。

如果 attributeDestination 是 accessPackageUserDirectoryAttributeStore 对象类型，则 attributeName 指示的属性必须是 用户 对象的可写属性。 这些可写属性是在目标 User 对象上注册为扩展属性的字符串类型。

例如，假设应用程序需要两个用户属性，即用户的职务及其个人职务。 这些属性的值可以从 本地 Active Directory jobTitle 和 personalTitle 属性同步到Microsoft Entra ID。 由于 personalTitle 不是 用户 对象的默认属性之一，因此需要 创建目录架构扩展 才能将 personalTitle 属性添加到用户对象类型。 为应用程序创建资源请求时，可以包括两个访问包资源属性，一个用于用户属性 jobTitle，另一个具有为个人游戏创建的目录架构扩展属性的名称，例如 extension_2b676109c7c74ae2b41549205f1947ed_personalTitle。

如果 特性的 attributeSource 是 accessPackageResourceAttributeQuestion，则请求者提供的值将按用户对象上提供的值进行存储，并提供给应用程序和其他 Microsoft Graph 客户端。

关系

无。

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "@odata.type": "#microsoft.graph.accessPackageResourceAttribute",
  "attributeDestination": {
    "@odata.type": "microsoft.graph.accessPackageResourceAttributeDestination"
  },
  "attributeName": "String",
  "attributeSource": {
    "@odata.type": "microsoft.graph.accessPackageResourceAttributeSource"
  },
  "id": "String (identifier)",
  "isEditable": "Boolean",
  "isPersistedOnAssignmentRemoval": "Boolean"
}