Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Löschen eines PostfachElements aus einem PostfachOrdner in einem Postfach.
Verwenden Sie den Abfrageparameter disposalType, um anzugeben, ob das Element vorläufig oder endgültig gelöscht werden soll.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service |
US Government L4 |
US Government L5 (DOD) |
China, betrieben von 21Vianet |
| ✅ |
❌ |
❌ |
❌ |
Berechtigungen
Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
| Berechtigungstyp |
Berechtigungen mit den geringsten Berechtigungen |
Berechtigungen mit höheren Berechtigungen |
| Delegiert (Geschäfts-, Schul- oder Unikonto) |
MailboxItem.ReadWrite |
Nicht verfügbar. |
| Delegiert (persönliches Microsoft-Konto) |
Nicht unterstützt |
Nicht unterstützt |
| Application |
MailboxItem.ReadWrite.All |
Nicht verfügbar. |
HTTP-Anforderung
DELETE /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/items/{mailboxItemId}?disposalType={disposalType}
Abfrageparameter
Geben Sie in der Anforderungs-URL den folgenden erforderlichen Abfrageparameter an.
| Parameter |
Typ |
Beschreibung |
| disposalType |
Zeichenfolge |
Erforderlich. Der Typ des durchzuführenden Löschvorgangs. Die möglichen Werte sind: softDelete, hardDelete. Wird verwendet softDelete , um der Exchange-Semantik für vorläufiges Löschen zu folgen oder hardDelete um das Element endgültig zu löschen. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben.
Hinweis
Wenn Sie hardDeleteverwenden, löscht der Exchange-Dienst das Element nur dann endgültig, wenn es sich um Kundendaten handelt, die nicht durch eine gesetzliche Aufbewahrungspflicht, eine Aufbewahrungsrichtlinie, eine Überwachung, Compliance oder eine Systemelementeinschränkung geschützt sind. Andernfalls schlägt die Anforderung mit einem 403 Forbidden Fehler fehl.
Archiv Postfächer mit automatisch erweiterten Ordnern: Wenn sich das Zielelement physisch in einem zusätzlichen (automatisch erweiterten) Archivpostfach befindet, gibt diese API möglicherweise eine Umleitungsantwort zurück, die auf den richtigen Postfachendpunkt verweist. Weitere Informationen finden Sie unter Behandeln von Umleitungen von Archivpostfächern.
Beispiele
Beispiel 1: Vorläufiges Löschen eines Postfachelements
Im folgenden Beispiel wird gezeigt, wie ein Postfachelement in einem Ordner vorläufig gelöscht werden kann disposalType=softDelete.
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
DELETE https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0648f21@aab09c93/folders/inbox/items/AAMkADk0MzI?disposalType=softDelete
// 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.Admin.Exchange.Mailboxes["{mailbox-id}"].Folders["{mailboxFolder-id}"].Items["{mailboxItem-id}"].DeleteAsync((requestConfiguration) =>
{
requestConfiguration.QueryParameters.DisposalType = "softDelete";
});
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphadmin "github.com/microsoftgraph/msgraph-beta-sdk-go/admin"
//other-imports
)
requestDisposalType := "softDelete"
requestParameters := &graphadmin.ExchangeMailboxesItemFoldersItemItemsItemRequestBuilderDeleteQueryParameters{
DisposalType: &requestDisposalType,
}
configuration := &graphadmin.ExchangeMailboxesItemFoldersItemItemsItemRequestBuilderDeleteRequestConfiguration{
QueryParameters: requestParameters,
}
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Admin().Exchange().Mailboxes().ByMailboxId("mailbox-id").Folders().ByMailboxFolderId("mailboxFolder-id").Items().ByMailboxItemId("mailboxItem-id").Delete(context.Background(), configuration)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
graphClient.admin().exchange().mailboxes().byMailboxId("{mailbox-id}").folders().byMailboxFolderId("{mailboxFolder-id}").items().byMailboxItemId("{mailboxItem-id}").delete(requestConfiguration -> {
requestConfiguration.queryParameters.disposalType = "softDelete";
});
const options = {
authProvider,
};
const client = Client.init(options);
await client.api('/admin/exchange/mailboxes/MBX:e0648f21@aab09c93/folders/inbox/items/AAMkADk0MzI?disposalType=softDelete')
.version('beta')
.delete();
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Admin\Exchange\Mailboxes\Item\Folders\Item\Items\Item\MailboxItemItemRequestBuilderDeleteRequestConfiguration;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestConfiguration = new MailboxItemItemRequestBuilderDeleteRequestConfiguration();
$queryParameters = MailboxItemItemRequestBuilderDeleteRequestConfiguration::createQueryParameters();
$queryParameters->disposalType = "softDelete";
$requestConfiguration->queryParameters = $queryParameters;
$graphServiceClient->admin()->exchange()->mailboxes()->byMailboxId('mailbox-id')->folders()->byMailboxFolderId('mailboxFolder-id')->items()->byMailboxItemId('mailboxItem-id')->delete($requestConfiguration)->wait();
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.admin.exchange.mailboxes.item.folders.item.items.item.mailbox_item_item_request_builder import MailboxItemItemRequestBuilder
from kiota_abstractions.base_request_configuration import RequestConfiguration
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
query_params = MailboxItemItemRequestBuilder.MailboxItemItemRequestBuilderDeleteQueryParameters(
disposal_type = "softDelete",
)
request_configuration = RequestConfiguration(
query_parameters = query_params,
)
await graph_client.admin.exchange.mailboxes.by_mailbox_id('mailbox-id').folders.by_mailbox_folder_id('mailboxFolder-id').items.by_mailbox_item_id('mailboxItem-id').delete(request_configuration = request_configuration)
Antwort
Das folgende Beispiel zeigt die Antwort.
HTTP/1.1 204 No Content
Beispiel 2: Endgültiges Löschen eines Postfachelements
Im folgenden Beispiel wird gezeigt, wie Sie ein berechtigtes Postfachelement in "Wiederherstellbare Elemente" mithilfe von disposalType=hardDeletelöschen.
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
DELETE https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0648f21@aab09c93/folders/recoverableitemsdeletions/items/AAMkADk0MzI?disposalType=hardDelete
// 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.Admin.Exchange.Mailboxes["{mailbox-id}"].Folders["{mailboxFolder-id}"].Items["{mailboxItem-id}"].DeleteAsync((requestConfiguration) =>
{
requestConfiguration.QueryParameters.DisposalType = "hardDelete";
});
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphadmin "github.com/microsoftgraph/msgraph-beta-sdk-go/admin"
//other-imports
)
requestDisposalType := "hardDelete"
requestParameters := &graphadmin.ExchangeMailboxesItemFoldersItemItemsItemRequestBuilderDeleteQueryParameters{
DisposalType: &requestDisposalType,
}
configuration := &graphadmin.ExchangeMailboxesItemFoldersItemItemsItemRequestBuilderDeleteRequestConfiguration{
QueryParameters: requestParameters,
}
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Admin().Exchange().Mailboxes().ByMailboxId("mailbox-id").Folders().ByMailboxFolderId("mailboxFolder-id").Items().ByMailboxItemId("mailboxItem-id").Delete(context.Background(), configuration)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
graphClient.admin().exchange().mailboxes().byMailboxId("{mailbox-id}").folders().byMailboxFolderId("{mailboxFolder-id}").items().byMailboxItemId("{mailboxItem-id}").delete(requestConfiguration -> {
requestConfiguration.queryParameters.disposalType = "hardDelete";
});
const options = {
authProvider,
};
const client = Client.init(options);
await client.api('/admin/exchange/mailboxes/MBX:e0648f21@aab09c93/folders/recoverableitemsdeletions/items/AAMkADk0MzI?disposalType=hardDelete')
.version('beta')
.delete();
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Admin\Exchange\Mailboxes\Item\Folders\Item\Items\Item\MailboxItemItemRequestBuilderDeleteRequestConfiguration;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestConfiguration = new MailboxItemItemRequestBuilderDeleteRequestConfiguration();
$queryParameters = MailboxItemItemRequestBuilderDeleteRequestConfiguration::createQueryParameters();
$queryParameters->disposalType = "hardDelete";
$requestConfiguration->queryParameters = $queryParameters;
$graphServiceClient->admin()->exchange()->mailboxes()->byMailboxId('mailbox-id')->folders()->byMailboxFolderId('mailboxFolder-id')->items()->byMailboxItemId('mailboxItem-id')->delete($requestConfiguration)->wait();
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.admin.exchange.mailboxes.item.folders.item.items.item.mailbox_item_item_request_builder import MailboxItemItemRequestBuilder
from kiota_abstractions.base_request_configuration import RequestConfiguration
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
query_params = MailboxItemItemRequestBuilder.MailboxItemItemRequestBuilderDeleteQueryParameters(
disposal_type = "hardDelete",
)
request_configuration = RequestConfiguration(
query_parameters = query_params,
)
await graph_client.admin.exchange.mailboxes.by_mailbox_id('mailbox-id').folders.by_mailbox_folder_id('mailboxFolder-id').items.by_mailbox_item_id('mailboxItem-id').delete(request_configuration = request_configuration)
Antwort
Das folgende Beispiel zeigt die Antwort.
HTTP/1.1 204 No Content