Aktualisieren von groupLifecyclePolicyUpdate groupLifecyclePolicy

Namespace: microsoft.graphNamespace: microsoft.graph

Aktualisieren Sie die Eigenschaften eines groupLifecyclePolicygroupLifecyclePolicy-Ressourcentyp-Objekts.Update the properties of a groupLifecyclePolicygroupLifecyclePolicy resource type object.

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.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Directory.ReadWrite.AllDirectory.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
ApplicationApplication Directory.ReadWrite.AllDirectory.ReadWrite.All

HTTP-AnforderungHTTP request

PATCH /groupLifecyclePolicies/{id}

Optionale AnforderungsheaderOptional request headers

NameName BeschreibungDescription
AuthorizationAuthorization Bearer {token}. Erforderlich.Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

AnforderungstextRequest body

Geben Sie im Anforderungstext die Werte für die relevanten Felder an, die aktualisiert werden sollen.In the request body, supply the values for relevant fields that should be updated. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet.Existing properties that are not included in the request body maintain their previous values or are recalculated based on changes to other property values. Aus Gründen der Leistung sollten Sie vorhandene Werte, die nicht geändert wurden, nicht angeben.For best performance you shouldn't include existing values that haven't changed.

EigenschaftProperty TypType BeschreibungDescription
alternateNotificationEmailsalternateNotificationEmails ZeichenfolgeString Liste der E-Mail-Adressen, an die Benachrichtigungen für Gruppen ohne Besitzer gesendet werden sollen.List of email address to send notifications for groups without owners. Mehrere E-Mail-Adressen können durch ein Semikolon voneinander getrennt definiert werden.Multiple email address can be defined by separating email address with a semicolon.
groupLifetimeInDaysgroupLifetimeInDays Int32Int32 Anzahl von Tagen, bis eine Gruppe abläuft und verlängert werden muss.Number of days before a group expires and needs to be renewed. Sobald die Gruppe verlängert wurde, wird der Ablaufzeitraum für die Gruppe um die Anzahl der definierten Tage verlängert.Once renewed, the group expiration is extended by the number of days defined.
managedGroupTypesmanagedGroupTypes ZeichenfolgeString Der Gruppentyp, für den die Ablaufrichtlinie gilt.The group type for which the expiration policy applies. Mögliche Werte sind Alle, Ausgewählte oder Keine.Possible values are All, Selected or None.

AntwortResponse

Wenn erfolgreich ausgeführt, gibt diese Methode den Antwortcode 200 OK und ein aktualisiertes groupLifecyclePolicy-Objekt im Antworttext zurück.If successful, this method returns a 200 OK response code and updated groupLifecyclePolicy object in the response body.

BeispielExample

AnforderungRequest
PATCH https://graph.microsoft.com/v1.0/groupLifecyclePolicies/{id}
Content-type: application/json
Content-length: 125

{
  "groupLifetimeInDays": 180,
  "managedGroupTypes": "Selected",
  "alternateNotificationEmails": "admin@contoso.com"
}
AntwortResponse

Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten.Note: The response object shown here may be truncated for brevity.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 146

{
  "id": "id-value",
  "groupLifetimeInDays": 180,
  "managedGroupTypes": "Selected",
  "alternateNotificationEmails": "admin@contoso.com"
}