項目 (ディレクトリ オブジェクト) を完全に削除する
[アーティクル]
02/22/2024
14 人の共同作成者
フィードバック
この記事の内容
名前空間: microsoft.graph
最近削除された アプリケーション 、 グループ 、 servicePrincipal 、または ユーザー オブジェクトを 削除済みアイテム から完全に削除します。 アイテムが完全に削除された後は、復元 できません 。
deletedItems API を使用して管理単位を完全に削除することはできません 。 論理的に削除された管理単位は、復元されない限り、最初の削除から 30 日後に完全に削除されます。
この API は、次の国内クラウド展開 で使用できます。
グローバル サービス
米国政府機関 L4
米国政府機関 L5 (DOD)
21Vianet が運営する中国
✅
✅
✅
✅
アクセス許可
次の表は、サポートされている各リソースの種類でこの API を呼び出すために必要な最小特権のアクセス許可またはアクセス許可を示しています。 ベスト プラクティス に従って、最小限の特権のアクセス許可を要求します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類 」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください 。
サポートされているリソース
委任 (職場または学校のアカウント)
委任 (個人用 Microsoft アカウント)
アプリケーション
application
Application.ReadWrite.All
サポートされていません。
Application.ReadWrite.OwnedBy
グループ
Group.ReadWrite.All
サポートされていません。
サポートされていません。
servicePrincipal
Application.ReadWrite.All
サポートされていません。
Application.ReadWrite.OwnedBy
user
User.ReadWrite.All
サポートされていません。
サポートされていません。
委任されたシナリオの場合、呼び出し元のユーザーは、次のMicrosoft Entraロール の少なくとも 1 つを持っている必要があります。
削除されたアプリケーションまたはサービス プリンシパルを完全に削除するには: アプリケーション管理者 、 クラウド アプリケーション管理者 、または ハイブリッド ID 管理者 。
削除されたユーザーを完全に削除するには: ユーザー管理者 。
削除されたグループを完全に削除するには: グループ管理者 。
HTTP 要求
DELETE /directory/deletedItems/{id}
名前
説明
Authorization
ベアラー {token}。 必須です。 認証と承認 の詳細については、こちらをご覧ください。
承諾
application/json
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは 204 No Content
応答コードを返します。 応答本文では何も返されません。
例
要求
DELETE https://graph.microsoft.com/v1.0/directory/deletedItems/{object-id}
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Directory.DeletedItems["{directoryObject-id}"].DeleteAsync();
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc directory deleted-items delete --directory-object-id {directoryObject-id}
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
//other-imports
)
graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)
graphClient.Directory().DeletedItems().ByDirectoryObjectId("directoryObject-id").Delete(context.Background(), nil)
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
graphClient.directory().deletedItems().byDirectoryObjectId("{directoryObject-id}").delete();
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
const options = {
authProvider,
};
const client = Client.init(options);
await client.api('/directory/deletedItems/{object-id}')
.delete();
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
<?php
use Microsoft\Graph\GraphServiceClient;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$graphServiceClient->directory()->deletedItems()->byDirectoryObjectId('directoryObject-id')->delete()->wait();
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
Import-Module Microsoft.Graph.Identity.DirectoryManagement
Remove-MgDirectoryDeletedItem -DirectoryObjectId $directoryObjectId
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
from msgraph import GraphServiceClient
graph_client = GraphServiceClient(credentials, scopes)
await graph_client.directory.deleted_items.by_directory_object_id('directoryObject-id').delete()
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
応答
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 204 No Content