Тип ресурса governanceRoleAssignment
Пространство имен: microsoft.graph
Важно!
API версии /beta
в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Предостережение
Эта версия API Privileged Identity Management (PIM) для ресурсов Azure скоро перестанет поддерживаться. Используйте новый REST API PIM Azure для ролей ресурсов Azure.
Представляет назначение роли пользователя или группы.
управление привилегированными пользователями (PIM) поддерживает два типа назначений:
- Активное назначение — представляет прямой или активированный доступ к ресурсам.
- Допустимое назначение . Представляет промежуточный этап привилегированного доступа к ресурсам, между отсутствием доступа и прямым доступом. Администраторы могут назначить пользователей или группы
eligible assignment
заранее, а если требуется доступ,activation
дляeligible assignment
получения мгновенного доступа к ресурсу в течение нескольких часов. После активацииactive assignment
для пользователей или участников группы будет создан объект , указывающий состояние активации.
Методы
Метод | Возвращаемый тип | Описание |
---|---|---|
Получение | governanceRoleAssignment | Чтение свойств и связей сущности назначения ролей. |
List | Коллекция governanceRoleAssignment | Перечисление коллекции назначений ролей для ресурса. |
Экспорт | octet-stream | Скачайте коллекцию назначений ролей в ресурсе и сохраните как .csv файл. |
Операции POST
, PUT
, PATCH
или DELETE
не поддерживаются в наборе сущностей roleAssignments
. Все операции governanceRoleAssignment
создания, обновления и удаления выполняются с помощью governanceRoleAssignmentRequest
.
Свойства
Свойство | Тип | Описание |
---|---|---|
id | String | Идентификатор назначения роли. Он имеет формат GUID. |
resourceId | String | Обязательный. Идентификатор ресурса, с которым связано назначение роли. |
roleDefinitionId | String | Обязательный. Идентификатор определения роли, с которым связано назначение роли. |
subjectId | String | Обязательный. Идентификатор субъекта, с которым связано назначение роли. |
linkedEligibleRoleAssignmentId | String | Если это active assignment и создано из-за активации в eligible assignment , он представляет идентификатор этого eligible assignment объекта ; В противном случае значение равно null . |
externalId | String | Внешний идентификатор ресурса, который используется для идентификации назначения роли в поставщике. |
startDateTime | DateTimeOffset | Время начала назначения роли. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z . |
endDateTime | DateTimeOffset | Для назначения непостоянных ролей это время истечения срока действия назначения ролей. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z . |
assignmentState | String | Состояние назначения. Это значение может быть для соответствующего назначения, если Active оно назначается Eligible Active напрямую администраторами, или активировано пользователями при назначении. |
memberType | String | Тип элемента. Значение может быть следующим: Inherited (если назначение роли наследуется от родительского ресурса область), Group (если назначение роли не наследуется, но происходит от членства в назначении группы) или User (если назначение роли не наследуется или из назначения группы). |
Связи
Связь | Тип | Описание |
---|---|---|
resource | governanceResource | Только для чтения. Ресурс, связанный с назначением роли. |
roleDefinition | governanceRoleDefinition | Только для чтения. Определение роли, связанное с назначением роли. |
subject | governanceSubject | Только для чтения. Тема, связанная с назначением роли. |
linkedEligibleRoleAssignment | governanceRoleAssignment | Только для чтения. Если это и active assignment создано из-за активации в eligible assignment , он представляет объект этого eligible assignment объекта ; В противном случае значение равно null . |
Представление JSON
В следующем представлении JSON показан тип ресурса.
{
"id": "String (identifier)",
"resourceId": "String",
"roleDefinitionId": "String",
"subjectId": "String",
"linkedEligibleRoleAssignmentId": "String",
"externalId": "String",
"startDateTime": "String (timestamp)",
"endDateTime": "String (timestamp)",
"assignmentState": "String",
"memberType": "String",
}