groupLifecyclePolicy: renewGroupgroupLifecyclePolicy: renewGroup

重要

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.

グループの有効期限を更新します。Renews a group's expiration. グループが更新されると、グループの有効期限はポリシーで定義された日数、延長されます。When a group is renewed, the group expiration is extended by the number of days defined in the policy.

注: V 1.0 では、グループリソースを使用して更新要求を行います。Note: In V1.0, use the group resource to make renew requests.

アクセス許可Permissions

この 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) Group.ReadWrite.All または Directory.ReadWrite.AllGroup.ReadWrite.All or Directory.ReadWrite.All
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) サポートされていませんNot supported
アプリケーションApplication Group.ReadWrite.All または Directory.ReadWrite.AllGroup.ReadWrite.All or Directory.ReadWrite.All

HTTP 要求HTTP request

POST /groupLifecyclePolicies/renewGroup

要求ヘッダーRequest headers

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

要求本文Request body

要求本文で、次のパラメーターを含む JSON オブジェクトを指定します。In the request body, provide a JSON object with the following parameters.

パラメーターParameter Type 説明Description
groupIdgroupId GuidGuid 更新するグループの id。The id of the group to renew.

応答Response

成功した場合、このメソッドは 204 No Content 応答コードを返します。応答本文には何も返されません。If successful, this method returns 204 No Content response code. It does not return anything in the response body.

Example

要求Request
POST https://graph.microsoft.com/beta/groupLifecyclePolicies/renewGroup
Content-type: application/json
Content-length: 57

{
  "groupId": "ffffffff-ffff-ffff-ffff-ffffffffffff"
}
応答Response
HTTP/1.1 204 No Content

SDK サンプルコードSDK sample code


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var groupId = "ffffffff-ffff-ffff-ffff-ffffffffffff";

await graphClient.GroupLifecyclePolicies
    .RenewGroup(groupId)
    .Request()
    .PostAsync();

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