Обновление accessReview (не рекомендуется)
Пространство имен: microsoft.graph
Важно!
API версии /beta
в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Предостережение
Эта версия API проверки доступа устарела и перестанет возвращать данные 19 мая 2023 г. Используйте API проверок доступа.
В функции Microsoft Entra проверки доступа обновите существующий объект accessReview, чтобы изменить одно или несколько его свойств.
Этот API не предназначен для изменения рецензентов или решений проверки. Чтобы изменить рецензентов, используйте API addReviewer или removeReviewer . Чтобы остановить уже запущенную однократную проверку или уже запущенный экземпляр повторяющейся проверки, используйте API остановки . Чтобы применить решения к целевой группе или правам доступа к приложению, используйте API apply .
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
---|---|---|
Делегированные (рабочая или учебная учетная запись) | AccessReview.ReadWrite.Membership | AccessReview.ReadWrite.All |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
Приложение | AccessReview.ReadWrite.Membership | Недоступно. |
HTTP-запрос
PATCH /accessReviews/{reviewId}
Заголовки запросов
Имя | Тип | Описание |
---|---|---|
Authorization | string | Bearer {token}. Обязательно. |
Текст запроса
В тексте запроса укажите представление параметров объекта accessReview в формате JSON.
В следующей таблице показаны свойства, которые можно предоставить при обновлении accessReview.
Свойство | Тип | Описание |
---|---|---|
displayName | String | Имя проверки доступа. |
startDateTime | DateTimeOffset | Дата и время начала проверки. Это должна быть дата в будущем. |
endDateTime | DateTimeOffset | Дата и время окончания проверки. Это должно быть по крайней мере на один день позже даты начала. |
description | String | Описание, отображаемого рецензентам. |
Отклик
В случае успешного выполнения этот метод возвращает код отклика 204 Accepted
и объект accessReview в теле отклика.
Пример
Это пример обновления однократной (не повторяющейся) проверки доступа.
Запрос
В тексте запроса укажите представление новых свойств объекта accessReview в формате JSON.
PATCH https://graph.microsoft.com/beta/accessReviews/006111db-0810-4494-a6df-904d368bd81b
Content-type: application/json
{
"displayName":"TestReview new name"
}
Отклик
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 204 Accepted
Content-type: application/json
{
"id": "006111db-0810-4494-a6df-904d368bd81b",
"displayName": "TestReview new name",
"startDateTime": "2017-02-10T00:35:53.214Z",
"endDateTime": "2017-03-12T00:35:53.214Z",
"status": "Initializing",
"businessFlowTemplateId": "6e4f3d20-c5c3-407f-9695-8460952bcc68",
"reviewerType": "delegated",
"description": "Sample description"
}
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по