plannerRoster: assignSensitivityLabel

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.

Asignar una etiqueta de confidencialidad a un 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/{rosterId}/assignSensitivityLabel

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.
If-Match If-match: {etag}. Último valor de ETag conocido para plannerRoster que se actualizará. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione un objeto JSON con los siguientes parámetros.

Parámetro Tipo Descripción
assignmentMethod sensitivityLabelAssignmentMethod El método que se usa para aplicar la etiqueta de confidencialidad a la lista. Los valores posibles son: standard, privileged, auto y unknownFutureValue
sensitivityLabelId Cadena El identificador de la etiqueta que se aplica a la lista.

Respuesta

Si se realiza correctamente, este método devuelve un código de 200 OK respuesta y un objeto plannerRoster en el cuerpo de la respuesta.

Este método falla en las situaciones siguientes, cada una con su respectivo código de respuesta. La propiedad code de la respuesta de error indica el error específico.

Código de respuesta Descripción Valor de propiedad Código
400 Bad Request Si la etiqueta tiene subetiquetas, no se puede aplicar a la lista. Solo se pueden aplicar etiquetas sin subetiquetas. Se produce un error en la solicitud. sensitivityLabelHasSublabels
403 Forbidden Si las etiquetas son obligatorias para el usuario y el usuario intenta quitar la etiqueta de confidencialidad, se produce un error en la solicitud. sensitivityLabelsAreMandatory
403 Forbidden Si se aplicó una asignación de etiqueta existente anteriormente con sensitivityLabelAssignmentMethod.privileged y una aplicación intenta sobrescribir la etiqueta con sensitivityLabelAssignmentMethod.standard, se produce un error en la solicitud. existingSensitivityLabelWasAppliedWithPrivilegedMethod
404 Not Found Si no se encuentra una etiqueta o la etiqueta no está en el ámbito del usuario, se produce un error en la solicitud. sensitivityLabelNotFound

Para obtener más información, consulte Respuestas de error de Microsoft Graph y tipos de recursos.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/planner/rosters/3e34de02-b01d-423b-b2ae-ca0ccd1fab05/assignSensitivityLabel
Content-type: application/json
If-Match: "W/\"JzEtVGFzayAgQEBAQEBAQEBAQEBAQEBAWCc=\""

{
    "assignmentMethod" : "standard",
    "sensitivityLabelId": "7a4d7cc1-f72b-46a3-9831-02680eaf56f9"
}

Respuesta

En el ejemplo siguiente se muestra la respuesta a la lista actualizada.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.plannerRoster",
  "id": "6519868f-868f-6519-8f86-19658f861965",
  "assignedSensitivityLabel": {
      "assignmentMethod" : "standard",
      "sensitivityLabelId": "720b42d7-d945-46cd-81f8-8dd825d01960",
      "tenantId": "88397d78-d160-4545-a01f-cceda28d3fe3"
  }
}