Partager via


plannerRoster : assignSensitivityLabel

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Affectez une étiquette de confidentialité à un objet plannerRoster .

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) Tasks.ReadWrite Non disponible.
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application Tasks.ReadWrite.All Non disponible.

Requête HTTP

POST /planner/rosters/{rosterId}/assignSensitivityLabel

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Content-Type application/json. Obligatoire.
If-Match If-match : {etag}. Dernière valeur ETag connue pour le plannerRoster à mettre à jour. Obligatoire.

Corps de la demande

Dans le corps de la demande, indiquez un objet JSON avec les paramètres suivants.

Paramètre Type Description
assignmentMethod sensitivityLabelAssignmentMethod Méthode utilisée pour appliquer l’étiquette de confidentialité à la liste. Les valeurs possibles sont les suivantes : standard, privileged, auto, unknownFutureValue.
sensitivityLabelId Chaîne ID de l’étiquette appliquée à la liste.

Réponse

Si elle réussit, cette méthode renvoie un 200 OK code de réponse et un objet plannerRoster dans le corps de la réponse.

Cette méthode échoue dans les situations suivantes, chacune avec un code de réponse respectif. La propriété code dans la réponse d’erreur indique l’erreur spécifique.

Code de réponse Description Valeur de la propriété de code
400 Bad Request Si l’étiquette comporte des sous-étiquettes, elle ne peut pas être appliquée à la liste. Seules les étiquettes sans sous-étiquettes peuvent être appliquées. La requête échoue. sensitivityLabelHasSublabels
403 Forbidden Si les étiquettes sont obligatoires pour l’utilisateur et que l’utilisateur tente de supprimer l’étiquette de confidentialité, la demande échoue. sensitivityLabelsAreMandatory
403 Forbidden Si une attribution d’étiquette existante a été appliquée avec sensitivityLabelAssignmentMethod.privileged et qu’une application tente de remplacer l’étiquette par sensitivityLabelAssignmentMethod.standard, la requête échoue. existingSensitivityLabelWasAppliedWithPrivilegedMethod
404 Not Found Si une étiquette est introuvable ou si l’étiquette n’est pas dans l’étendue de l’utilisateur, la demande échoue. sensitivityLabelNotFound

Pour plus d’informations, consultez Réponses d’erreur microsoft Graph et types de ressources.

Exemples

Demande

L’exemple suivant illustre une demande.

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"
}

Réponse

L’exemple suivant montre la réponse à la liste mise à jour.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

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"
  }
}