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
Zuweisunguser access administrator
(oder) für die Ressource verfügt.Note: This API also requires that the requester have at least oneActive
administrator role assignment (owner
oruser 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