Atualizar shiftsRoleDefinition

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.

Atualiza um objeto shiftsRoleDefinition .

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) Schedule.ReadWrite.All SchedulePermissions.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application Schedule.ReadWrite.All SchedulePermissions.ReadWrite.All

Solicitação HTTP

PATCH /team/{teamId}/schedule/shiftsRoleDefinitions/{roleId}

Parâmetros do caminho

Parâmetro Tipo Descrição
teamId string ID da equipe para definir as definições de função.
roleId string A função afetada. Os valores com suporte atuais são teamowner e scheduleowner.

Valores com suporte para roleId

Nome Descrição
scheduleOwner Define definições para um proprietário de agendamento.
teamOwner Define definições para um proprietário de equipe.

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.
MS-APP-ACTS-AS (preterido) Uma ID de usuário (GUID). Necessário somente se o token de autorização for um token de aplicativo; caso contrário, opcional. O MS-APP-ACTS-AS cabeçalho foi preterido e não é mais necessário com tokens de aplicativo.

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON do objeto shiftsRoleDefinition .

Você pode especificar as propriedades a seguir ao criar/atualizar uma shiftsRoleDefinition.

Propriedade Tipo Descrição
shiftsRolePermissions Coleção microsoft.graph.shiftsRolePermission Contém a definição de permissões de função em uma função. Obrigatório.

Resposta

Se tiver êxito, este método retornará um código de resposta 204 No Content. Ele não retorna nada no corpo da resposta.

Exemplos

Exemplo 1: Definir permissões para o proprietário da agenda

Solicitação

O exemplo a seguir mostra uma solicitação que permite a modificação de grupos de agendamento e motivos de folga pelos proprietários do agendamento.

PATCH https://graph.microsoft.com/beta/team/10c2c1cc-6384-48f6-aeba-ef7486344550/schedule/shiftsRoleDefinitions/scheduleowner
Content-Type: application/json

{
  "shiftsRolePermissions": [
    {
      "allowedResourceActions": [
        "CanModifySchedulingGroups",
        "CanModifyTimeOffReasons"
      ]
    }
  ]
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content

Exemplo 2: desabilitar todas as permissões para o proprietário da agenda

Solicitação

O exemplo a seguir mostra uma solicitação que desabilita todas as permissões passando uma coleção vazia como o valor de allowedResourceActions.

PATCH https://graph.microsoft.com/beta/team/10c2c1cc-6384-48f6-aeba-ef7486344550/schedule/shiftsRoleDefinitions/scheduleowner
Content-Type: application/json

{
  "shiftsRolePermissions": [
    {
      "allowedResourceActions": []
    }
  ]
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content
  • Last updated on