Update groupLifecyclePolicyUpdate groupLifecyclePolicy

groupLifecyclePolicygroupLifecyclePolicy リソース タイプ オブジェクトのプロパティを更新します。Update the properties of a groupLifecyclePolicygroupLifecyclePolicy resource type object.


この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

アクセス許可の種類Permission type アクセス許可 (特権の小さいものから大きいものへ)Permissions (from least to most privileged)
委任 (職場または学校のアカウント)Delegated (work or school account) Directory.ReadWrite.AllDirectory.ReadWrite.All
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) サポートされていません。Not supported.
アプリケーションApplication Directory.ReadWrite.AllDirectory.ReadWrite.All

HTTP 要求HTTP request

PATCH /groupLifecyclePolicies/{id}

オプションの要求ヘッダーOptional request headers

名前Name 説明Description
AuthorizationAuthorization ベアラー {トークン}。必須。Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

要求本文Request body

要求本文で、更新する関連フィールドの値を指定します。In the request body, supply the values for relevant fields that should be updated. 要求本文に含まれない既存のプロパティは、以前の値のままになるか、他のプロパティ値の変更に基づいて再計算されます。Existing properties that are not included in the request body maintain their previous values or are recalculated based on changes to other property values. 最適なパフォーマンスを得るためには、変更されていない既存の値を含めないでください。For best performance you shouldn't include existing values that haven't changed.

プロパティProperty Type 説明Description
alternateNotificationEmailsalternateNotificationEmails StringString 所有者のいないグループに対して通知を送信する電子メール アドレスのリストList of email address to send notifications for groups without owners. 電子メール アドレスをセミコロンで区切って、複数の電子メール アドレスを定義することができます。Multiple email address can be defined by separating email address with a semicolon.
groupLifetimeInDaysgroupLifetimeInDays Int32Int32 グループの有効期限が切れ、更新が必要になるまでの日数。Number of days before a group expires and needs to be renewed. 更新されると、グループの有効期限は定義された日数、延長されます。Once renewed, the group expiration is extended by the number of days defined.
managedGroupTypesmanagedGroupTypes StringString 有効期限ポリシーを適用するグループの種類。The group type for which the expiration policy applies. 可能な値は、AllSelected、または None です。Possible values are All, Selected or None.


成功した場合、このメソッドは 200 OK 応答コードと、更新された groupLifecyclePolicy オブジェクトを応答本文で返します。If successful, this method returns a 200 OK response code and updated groupLifecyclePolicy object in the response body.


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

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

注: 簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。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"

SDK サンプルコードSDK sample code

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var groupLifecyclePolicy = new GroupLifecyclePolicy
    GroupLifetimeInDays = 180,
    ManagedGroupTypes = "Selected",
    AlternateNotificationEmails = "admin@contoso.com"

await graphClient.GroupLifecyclePolicies["{id}"]

SDK をプロジェクトに追加し、 authproviderインスタンスを作成する方法の詳細については、 sdk のドキュメントを参照してください。Read the SDK documentation for details on how to add the SDK to your project and create an authProvider instance.