Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Eliminar un elemento de buzón de un buzónCarpeta en un buzón.
Use el parámetro de consulta disposalType para especificar si se eliminará el elemento mediante una eliminación temporal o permanente.
Esta API está disponible en las siguientes implementaciones en la nube nacional.
| Servicio global |
Administración pública de EE. UU. |
Gobierno de EE. UU. L5 (DOD) |
China operado por 21Vianet |
| ✅ |
❌ |
❌ |
❌ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
| Tipo de permiso |
Permisos con privilegios mínimos |
Permisos con privilegios más altos |
| Delegado (cuenta profesional o educativa) |
MailboxItem.ReadWrite |
No disponible. |
| Delegado (cuenta personal de Microsoft) |
No admitida. |
No admitida. |
| Aplicación |
MailboxItem.ReadWrite.All |
No disponible. |
Solicitud HTTP
DELETE /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/items/{mailboxItemId}?disposalType={disposalType}
Parámetros de consulta
En la dirección URL de la solicitud, proporcione el siguiente parámetro de consulta obligatorio.
| Parámetro |
Tipo |
Description |
| disposalType |
Cadena |
Obligatorio. Tipo de operación de eliminación que se va a realizar. Los valores posibles son: softDelete, hardDelete. Se usa softDelete para seguir la semántica de eliminación temporal de Exchange o hardDelete para eliminar permanentemente el elemento. |
Cuerpo de la solicitud
No proporcione un cuerpo de solicitud para este método.
Respuesta
Si se ejecuta correctamente, este método devuelve un código de respuesta 204 No Content.
Nota:
Cuando se usa hardDelete, el servicio de Exchange elimina permanentemente el elemento solo cuando se trata de datos de clientes que no están protegidos por una suspensión legal, una directiva de retención, una auditoría, un cumplimiento o una restricción de elementos del sistema. De lo contrario, se produce un 403 Forbidden error en la solicitud.
Buzones de archivo con carpetas expandidas automáticamente: Cuando el elemento de destino reside físicamente en un buzón de archivo auxiliar (expandido automáticamente), esta API puede devolver una respuesta de redireccionamiento que apunta al punto de conexión del buzón correcto. Para obtener más información, consulte Gestionar redirecciones de buzones de archivo.
Ejemplos
Ejemplo 1: Eliminar temporalmente un elemento de buzón
En el ejemplo siguiente se muestra cómo eliminar un elemento del buzón de una carpeta mediante disposalType=softDelete.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
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)
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 204 No Content
Ejemplo 2: Eliminar de forma permanente un elemento de buzón
En el ejemplo siguiente se muestra cómo eliminar de forma permanente un elemento de buzón apto en Elementos recuperables mediante disposalType=hardDelete.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
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)
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 204 No Content