groupLifecyclePolicy: renewGroup
本文内容
命名空间:microsoft.graph
重要
Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
续订组的过期时间。 续订后,组的有效期就会延长策略中定义的天数。
注意: 调用 v1.0 终结点时,请使用 Renew 组 方法。
权限
要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限 。
权限类型
权限(从最低特权到最高特权)
委派(工作或学校帐户)
Group.ReadWrite.All 或 Directory.ReadWrite.All
委派(个人 Microsoft 帐户)
不支持
Application
Group.ReadWrite.All 或 Directory.ReadWrite.All
HTTP 请求
POST /groupLifecyclePolicies/renewGroup
名称
说明
Authorization
Bearer {token}。必需。
Content-Type
application/json
请求正文
在请求正文中,提供具有以下参数的 JSON 对象。
参数
类型
说明
groupId
Guid
要续订的组的 ID。
响应
如果成功,此方法返回 204 No Content 响应代码。它不在响应正文中返回任何内容。
示例
请求
POST https://graph.microsoft.com/beta/groupLifecyclePolicies/renewGroup
Content-type: application/json
{
"groupId": "ffffffff-ffff-ffff-ffff-ffffffffffff"
}
GraphServiceClient graphClient = new GraphServiceClient( authProvider );
var groupId = "ffffffff-ffff-ffff-ffff-ffffffffffff";
await graphClient.GroupLifecyclePolicies
.RenewGroup(groupId)
.Request()
.PostAsync();
GraphServiceClient graphClient = new GraphServiceClient( authProvider );
var groupId = "ffffffff-ffff-ffff-ffff-ffffffffffff";
await graphClient.GroupLifecyclePolicies
.RenewGroup(groupId)
.Request()
.PostAsync();
const options = {
authProvider,
};
const client = Client.init(options);
const _boolean = {
groupId: 'ffffffff-ffff-ffff-ffff-ffffffffffff'
};
await client.api('/groupLifecyclePolicies/renewGroup')
.version('beta')
.post(_boolean);
const options = {
authProvider,
};
const client = Client.init(options);
const _boolean = {
groupId: 'ffffffff-ffff-ffff-ffff-ffffffffffff'
};
await client.api('/groupLifecyclePolicies/renewGroup')
.version('beta')
.post(_boolean);
MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];
NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/groupLifecyclePolicies/renewGroup"]]];
[urlRequest setHTTPMethod:@"POST"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
NSMutableDictionary *payloadDictionary = [[NSMutableDictionary alloc] init];
NSString *groupId = @"ffffffff-ffff-ffff-ffff-ffffffffffff";
payloadDictionary[@"groupId"] = groupId;
NSData *data = [NSJSONSerialization dataWithJSONObject:payloadDictionary options:kNilOptions error:&error];
[urlRequest setHTTPBody:data];
MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest
completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {
//Request Completed
}];
[meDataTask execute];
MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];
NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/groupLifecyclePolicies/renewGroup"]]];
[urlRequest setHTTPMethod:@"POST"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
NSMutableDictionary *payloadDictionary = [[NSMutableDictionary alloc] init];
NSString *groupId = @"ffffffff-ffff-ffff-ffff-ffffffffffff";
payloadDictionary[@"groupId"] = groupId;
NSData *data = [NSJSONSerialization dataWithJSONObject:payloadDictionary options:kNilOptions error:&error];
[urlRequest setHTTPBody:data];
MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest
completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {
//Request Completed
}];
[meDataTask execute];
GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();
String groupId = "ffffffff-ffff-ffff-ffff-ffffffffffff";
graphClient.groupLifecyclePolicies()
.renewGroup(GroupLifecyclePolicyRenewGroupParameterSet
.newBuilder()
.withGroupId(groupId)
.build())
.buildRequest()
.post();
GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();
String groupId = "ffffffff-ffff-ffff-ffff-ffffffffffff";
graphClient.groupLifecyclePolicies()
.renewGroup(GroupLifecyclePolicyRenewGroupParameterSet
.newBuilder()
.withGroupId(groupId)
.build())
.buildRequest()
.post();
//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)
requestBody := msgraphsdk.NewGroupIdRequestBody()
groupId := "ffffffff-ffff-ffff-ffff-ffffffffffff"
requestBody.SetGroupId(&groupId)
result, err := graphClient.GroupLifecyclePolicies().RenewGroup().Post(requestBody)
//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)
requestBody := msgraphsdk.NewGroupIdRequestBody()
groupId := "ffffffff-ffff-ffff-ffff-ffffffffffff"
requestBody.SetGroupId(&groupId)
result, err := graphClient.GroupLifecyclePolicies().RenewGroup().Post(requestBody)
Import-Module Microsoft.Graph.Groups
$params = @{
GroupId = "ffffffff-ffff-ffff-ffff-ffffffffffff"
}
Invoke-MgRenewGroupLifecyclePolicy -BodyParameter $params
Import-Module Microsoft.Graph.Groups
$params = @{
GroupId = "ffffffff-ffff-ffff-ffff-ffffffffffff"
}
Invoke-MgRenewGroupLifecyclePolicy -BodyParameter $params
响应
HTTP/1.1 204 No Content