GovernanceRoleSetting aktualisierenUpdate governanceRoleSetting

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Aktualisieren der Eigenschaften von governanceRoleSetting.Update the properties of governanceRoleSetting.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Hinweis: Diese API erfordert auch, dass die anfordernde Person über Active mindestens eine Administratorrollenowner Zuweisung user access administrator(oder) für die Ressource verfügt.Note: This API also requires that the requester have at least one Active administrator role assignment (owner or user access administrator) on the resource.

BerechtigungstypPermission type BerechtigungenPermissions
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) PrivilegedAccess. ReadWrite. AzureResourcesPrivilegedAccess.ReadWrite.AzureResources
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication Nicht unterstütztNot supported.

HTTP-AnforderungHTTP request

PATCH /privilegedAccess/azureResources/roleSettings/{id}

AnforderungsheaderRequest headers

NameName BeschreibungDescription
AuthorizationAuthorization Bearer {token}Bearer {token}
Content-typeContent-type application/jsonapplication/json

AnforderungstextRequest body

Geben Sie im Anforderungstext die Werte für governanceRuleSettings an, die aktualisiert werden müssen.In the request body, supply the values for governanceRuleSettings that need to be updated.

EigenschaftProperty TypType BeschreibungDescription
adminEligibleSettingsadminEligibleSettings governanceRuleSetting -SammlunggovernanceRuleSetting collection Die Regeleinstellungen, die ausgewertet werden, wenn ein Administrator versucht, eine berechtigte Rollenzuweisung hinzuzufügen.The rule settings that are evaluated when an administrator tries to add an eligible role assignment.
adminMemberSettingsadminMemberSettings governanceRuleSetting -SammlunggovernanceRuleSetting collection Die Regeleinstellungen, die ausgewertet werden, wenn ein Administrator versucht, eine direkte Mitgliederrollen Zuweisung hinzuzufügen.The rule settings that are evaluated when an administrator tries to add a direct member role assignment.
userEligibleSettingsuserEligibleSettings governanceRuleSetting -SammlunggovernanceRuleSetting collection Die Regeleinstellungen, die ausgewertet werden, wenn ein Benutzer versucht, eine berechtigte Rollenzuweisung hinzuzufügen.The rule settings that are evaluated when a user tries to add an eligible role assignment.
userMemberSettingsuserMemberSettings governanceRuleSetting -SammlunggovernanceRuleSetting collection Die Regeleinstellungen, die ausgewertet werden, wenn ein Benutzer versucht, seine Rollenzuweisung zu aktivieren.The rule settings that are evaluated when a user tries to activate his role assignment.

AntwortResponse

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 NoContent zurückgegeben. Im Antworttext wird nichts zurückgegeben.If successful, this method returns a 204 NoContent response code. It does not return anything in the response body.

FehlercodesError codes

Diese API gibt die Standard-HTTP-Fehlercodes zurück.This API returns the standard HTTP error codes. Darüber hinaus werden die folgenden benutzerdefinierten Fehlercodes zurückgegeben.In addition, it returns the following custom error codes.

FehlercodeError code FehlermeldungError message DetailsDetails
400 BadRequest400 BadRequest RoleSettingNotFoundRoleSettingNotFound GovernanceRoleSetting ist im System nicht vorhanden.The governanceRoleSetting does not exist in system.
400 BadRequest400 BadRequest InvalidRoleSettingInvalidRoleSetting Die im Anforderungstext angegebenen governanceRuleSettings -Werte sind ungültig.The governanceRuleSettings values provided in the request body are not valid.

BeispielExample

In diesem Beispiel wird die Rollen Einstellung für benutzerdefinierte Rolle 3 im Abonnement "Flügel" Toys-Prod aktualisiert.This example updates the role setting for Custom Role 3 in the subscription Wingtip Toys - Prod.

AnforderungRequest
PATCH https://graph.microsoft.com/beta/privilegedAccess/azureResources/roleSettings/5fb5aef8-1081-4b8e-bb16-9d5d0385bab5
Content-type: application/json
Content-length: 350

{
   "adminEligibleSettings":[
      {
         "ruleIdentifier":"ExpirationRule",
         "setting":"{\"permanentAssignment\":false,\"maximumGrantPeriodInMinutes\":129600}"
      }
   ]
}
AntwortResponse
HTTP/1.1 204 No Content