тип ресурса accessPackageResourceAttribute
Пространство имен: microsoft.graph
Важно!
API версии /beta
в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.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 . Эти записываемые свойства — это типы строк, зарегистрированные как свойства расширения в целевом объекте User .
Например, предположим, что приложению требуются два атрибута пользователя: должность пользователя и его личное название. Значения этих атрибутов можно синхронизировать с идентификатором Microsoft Entra из локальных атрибутов jobTitle Active Directory и personalTitle . Так как 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"
}