Поделиться через

Обновление accessPackageAssignmentWorkflowExtension

  • Статья

Пространство имен: microsoft.graph

Обновите свойства объекта accessPackageAssignmentWorkflowExtension .

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) EntitlementManagement.ReadWrite.All Недоступно.
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Приложение EntitlementManagement.ReadWrite.All Недоступно.

Совет

В делегированных сценариях с рабочими или учебными учетными записями вошедшему пользователю также должна быть назначена роль администратора с поддерживаемыми разрешениями роли с помощью одного из следующих параметров:

  • Одно из следующих назначений ролей Azure требуется либо в самом приложении логики, либо в более высоком область, например в группе ресурсов, подписке или группе управления:
    • Приложение логики участник
    • Участник
    • Владелец

И одно из следующих действий:

  • Роль в системе управления правами, где наименее привилегированной ролью является владелец каталога. Это наименее привилегированный вариант.
  • Дополнительные привилегированные Microsoft Entra роли, поддерживаемые для этой операции:
    • Администратор управления удостоверениями

В сценариях только для приложений вызывающему приложению можно назначить одну из предыдущих поддерживаемых ролей вместо EntitlementManagement.ReadWrite.All разрешения приложения. Роль владельца каталога менее привилегированна, чем EntitlementManagement.Read.All разрешение приложения. Если это делегированный вызов без URL свойства в logicAppTriggerEndpointConfiguration, вызывающий объект также должен быть авторизован в приложении логики.

Дополнительные сведения см. в разделе Делегирование и роли в управлении правами и как делегировать управление доступом диспетчерам пакетов в управлении правами.

HTTP-запрос

PUT /identityGovernance/entitlementManagement/catalogs/{catalogId}/customWorkflowExtensions/{customAccessPackageWorkflowExtensionId}

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type application/json. Обязательно.

Текст запроса

В тексте запроса укажите только значения свойств для обновления. Существующие свойства, которые не включены в текст запроса, сохраняют свои предыдущие значения или пересчитываются на основе изменений других значений свойств.

В следующей таблице указаны свойства, которые можно обновить.

Свойство Тип Описание
authenticationConfiguration customExtensionAuthenticationConfiguration Тип проверки подлинности. Наследуется от customCalloutExtension. Необязательный параметр.
description String Описание объекта accessPackageCustomWorkflowExtension. Наследуется от customCalloutExtension. Необязательный параметр.
displayName String Отображаемое имя accessPackageCustomWorkflowExtension. Наследуется от customCalloutExtension. Необязательный параметр.
endpointConfiguration customExtensionEndpointConfiguration Тип и сведения о настройке конечной точки для вызова рабочего процесса приложения логики. Наследуется от customCalloutExtension. Необязательный параметр.
callbackConfiguration customExtensionCallbackConfiguration Время ожидания для обратного вызова. Необязательный параметр.

Отклик

В случае успешного 200 OK выполнения этот метод возвращает код ответа и обновленный объект accessPackageAssignmentWorkflowExtension в тексте ответа.

Примеры

Запрос

Ниже показан пример запроса.

PUT https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/catalogs/32efb28c-9a7a-446c-986b-ca6528c6669d/customWorkflowExtensions/78ffaec5-ae8e-4902-a434-5ffc5d3d3cd0
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.accessPackageAssignmentWorkflowExtension",
  "displayName": "test_action_0124_email",
  "description": "this is for graph testing only"
}

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-Type: application/json

{
   "value":{
      "@odata.type":"#microsoft.graph.accessPackageAssignmentWorkflowExtension",
      "id":"78ffaec5-ae8e-4902-a434-5ffc5d3d3cd0",
      "displayName":"test_action_0127_email",
      "description": "this is for graph testing only",
      "createdDateTime":"2022-01-24T21:48:57.15Z",
      "lastModifiedDateTime":"2022-01-24T21:55:44.953Z",
      "clientConfiguration":null,
      "endpointConfiguration":{
         "@odata.type":"#microsoft.graph.logicAppTriggerEndpointConfiguration",
         "subscriptionId":"38ab2ccc-3747-4567-b36b-9478f5602f0d",
         "resourceGroupName":"test",
         "logicAppWorkflowName":"elm-extension-email",
         "url":"https://prod-31.eastus.logic.azure.com:443/workflows/7ccffea766ae48e680gd9a22d1549bbc/triggers/manual/paths/invoke?api-version=2016-10-01"
      },
      "authenticationConfiguration":{
         "@odata.type":"#microsoft.graph.azureAdPopTokenAuthentication"
      }
   }
}