Update groupLifecyclePolicyUpdate groupLifecyclePolicy


Microsoft Graph の/betaバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでは、これらの API の使用はサポートされていません。Use of these APIs in production applications is not supported.

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 will maintain their previous values or be 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/beta/groupLifecyclePolicies/{id}
Content-type: application/json
Content-length: 151

  "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.