Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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.
Archivo un objeto plannerPlan. Al archivar un plan, también se archiva plannerTasks y plannerBuckets en el plan.
Una entidad archivada es de solo lectura. Las entidades archivadas no se pueden actualizar.
Un plan archivado se puede desarchivar.
Se pueden eliminar todas las entidades archivadas.
Las tareas archivadas no se incluyen en la respuesta de la lista de tareas asignadas a un usuario.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
Permisos
Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
| Tipo de permiso | Permisos con privilegios mínimos | Permisos con privilegios más altos |
|---|---|---|
| Delegado (cuenta profesional o educativa) | Tasks.ReadWrite | No disponible. |
| Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
| Aplicación | Tasks.ReadWrite.All | No disponible. |
Solicitud HTTP
POST /planner/plans/{planId}/archive
Encabezados de solicitud
| Nombre | Descripción |
|---|---|
| Authorization | {token} de portador. Obligatorio. |
| Content-Type | application/json. Obligatorio. |
| If-Match | Último valor ETag conocido para el plannerPlan que se va a archivar. Obligatorio. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione una representación JSON de los parámetros.
En la tabla siguiente se enumeran los parámetros necesarios al llamar a esta acción.
| Parámetro | Tipo | Descripción |
|---|---|---|
| justificación | Cadena | Motivo por el que se está archivando el plan. |
Respuesta
Si se ejecuta correctamente, esta acción devuelve un código de respuesta 204 No Content.
Este método puede devolver cualquiera de los códigos de estado HTTP. Los errores más comunes que las aplicaciones deben controlar para este método son las respuestas 400 y 403. Para obtener más información sobre estos errores, vea Common Planner error conditions (Condiciones de error habituales de Planner).
Ejemplos
Solicitud
En el ejemplo siguiente se muestra la solicitud.
POST https://graph.microsoft.com/beta/planner/plans/{planId}/archive
Content-Type: application/json
{
"justification": "String"
}
Respuesta
En el ejemplo siguiente se muestra la respuesta.
Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.
HTTP/1.1 204 No Content