永久删除项目
本文内容
命名空间:microsoft.graph
永久删除已删除的项目 中的项目
目前,删除的项目功能仅支持 应用程序 、 servicePrincipal 、 组 和 用户 资源。 可以永久删除“已删除的项目”中的项目。 但当某个项目永久删除后,将 无法 还原。
权限
要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限 。
对于应用程序和服务主体:
权限类型
权限(从最低特权到最高特权)
委派(工作或学校帐户)
Application.ReadWrite.All、Directory.ReadWrite.All
委派(个人 Microsoft 帐户)
不支持。
应用程序
Application.ReadWrite.OwnedBy、Application.ReadWrite.All、Directory.Read.All
请求者需要具有以下角色之一: 全局管理员 或 应用程序管理员 。
对于用户:
权限类型
权限(从最低特权到最高特权)
委派(工作或学校帐户)
User.ReadWrite.All
委派(个人 Microsoft 帐户)
不支持。
应用程序
不支持。
登录用户需要具有以下角色之一: 全局管理员 或 用户管理员 。
对于组:
权限类型
权限(从最低特权到最高特权)
委派(工作或学校帐户)
Group.ReadWrite.All
委派(个人 Microsoft 帐户)
不支持。
应用程序
不支持。
请求者需要具有以下角色之一: 全局管理员 或 组管理员 。
HTTP 请求
DELETE /directory/deletedItems/{id}
名称
说明
Authorization
Bearer <code>。必需
接受
application/json
请求正文
请勿提供此方法的请求正文。
响应
如果成功,此方法返回 204 No Content
响应代码。它不在响应正文中返回任何内容。
示例
请求
DELETE https://graph.microsoft.com/v1.0/directory/deletedItems/{object-id}
GraphServiceClient graphClient = new GraphServiceClient( authProvider );
await graphClient.Directory.DeletedItems["{directoryObject-id}"]
.Request()
.DeleteAsync();
有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息,请参阅 SDK 文档 。
const options = {
authProvider,
};
const client = Client.init(options);
await client.api('/directory/deletedItems/{object-id}')
.delete();
有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息,请参阅 SDK 文档 。
MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];
NSString *MSGraphBaseURL = @"https://graph.microsoft.com/v1.0/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/directory/deletedItems/{object-id}"]]];
[urlRequest setHTTPMethod:@"DELETE"];
MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest
completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {
//Request Completed
}];
[meDataTask execute];
有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息,请参阅 SDK 文档 。
GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();
graphClient.directory().deletedItems("{object-id}")
.buildRequest()
.delete();
有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息,请参阅 SDK 文档 。
//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)
directoryObjectId := "directoryObject-id"
graphClient.Directory().DeletedItemsById(&directoryObjectId).Delete()
有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息,请参阅 SDK 文档 。
Import-Module Microsoft.Graph.Identity.DirectoryManagement
Remove-MgDirectoryDeletedItem -DirectoryObjectId $directoryObjectId
有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息,请参阅 SDK 文档 。
响应
注意:为了提高可读性,可能缩短了此处显示的响应对象。
HTTP/1.1 204 No Content