plannerRoster: assignSensitivityLabel

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Atribua um rótulo de confidencialidade a um objeto plannerRoster .

Essa API está disponível nas seguintes implantações de nuvem nacional.

Serviço global Governo dos EUA L4 US Government L5 (DOD) China operada pela 21Vianet
✅ ✅ ✅ ❌

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissões menos privilegiadas Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante) Tasks.ReadWrite Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application Tasks.ReadWrite.All Indisponível.

Solicitação HTTP

POST /planner/rosters/{rosterId}/assignSensitivityLabel

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.
If-Match if-match: {etag}. Último valor de ETag conhecido para o plannerRoster a ser atualizado. Obrigatório.

Corpo da solicitação

Forneça um objeto JSON com os seguintes parâmetros no corpo da solicitação.

Parâmetro Tipo Descrição
assignmentMethod sensitivityLabelAssignmentMethod O método usado para aplicar o rótulo de confidencialidade à lista. Os valores possíveis são: standard, privileged, auto, unknownFutureValue.
sensitivityLabelId Cadeia de caracteres A ID do rótulo aplicado à lista.

Resposta

Se for bem-sucedido, esse método retornará um código de 200 OK resposta e um objeto plannerRoster no corpo da resposta.

Esse método falha nas situações a seguir, cada uma com um respectivo código de resposta. A propriedade code na resposta de erro indica o erro específico.

Código da resposta Descrição Valor da propriedade do código
400 Bad Request Se o rótulo tiver sub-rótulos, ele não poderá ser aplicado à lista. Somente rótulos sem subrótulos podem ser aplicados. A solicitação falhou. sensitivityLabelHasSublabels
403 Forbidden Se os rótulos forem obrigatórios para o usuário e o usuário tentar remover o rótulo de confidencialidade, a solicitação falhará. sensitivityLabelsAreMandatory
403 Forbidden Se uma atribuição de rótulo existente anteriormente tiver sido aplicada sensitivityLabelAssignmentMethod.privileged e um aplicativo tentar substituir o rótulo por sensitivityLabelAssignmentMethod.standard, a solicitação falhará. existingSensitivityLabelWasAppliedWithPrivilegedMethod
404 Not Found Se um rótulo não puder ser encontrado ou o rótulo não estiver no escopo do usuário, a solicitação falhará. sensitivityLabelNotFound

Para obter mais informações, consulte Tipos de recursos e respostas de erro do Microsoft Graph.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

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

Resposta

O exemplo a seguir mostra a resposta à lista atualizada.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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