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.
Crear un nuevo objeto plannerRoster .
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) | Tasks.ReadWrite | No disponible. |
| Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
| Aplicación | Tasks.ReadWrite.All | No disponible. |
Solicitud HTTP
POST /planner/rosters
Encabezados de solicitud
| Nombre | Descripción |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización. |
| Content-Type | application/json. Obligatorio. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione una representación JSON del objeto plannerRoster .
No hay propiedades grabables en plannerRoster.
Respuesta
Si se realiza correctamente, este método devuelve un código de 201 Created respuesta y un objeto plannerRoster en el cuerpo de la respuesta.
Este método produce un error con un código de 403 Forbidden respuesta en las situaciones siguientes. La propiedad code de la respuesta de error indica el error específico.
| Descripción | Valor de propiedad Código |
|---|---|
| Si las etiquetas son obligatorias para el usuario y la lista creada no tiene ninguna etiqueta de confidencialidad, se produce un error en la solicitud. | sensitivityLabelsAreMandatory |
| Si la lista se crea con miembros invitados agregados inicialmente, pero la etiqueta de confidencialidad propuesta no permite la adición de invitados, se produce un error en la solicitud. | addingGuestUsersProhibitedByLabel |
| Si la etiqueta proporcionada no tiene el identificador de inquilino correcto, se produce un error en la solicitud. | tenantIdIsIncorrect |
Para obtener más información, consulte Respuestas de error de Microsoft Graph y tipos de recursos.
Ejemplos
Solicitud
POST https://graph.microsoft.com/beta/planner/rosters
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.plannerRoster"
}
Respuesta
Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.
HTTP/1.1 201 Created
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.plannerRoster",
"id": "6519868f-868f-6519-8f86-19658f861965"
}