Atualizar unidade administrativa
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.
Atualize as propriedades de um objeto administrativeUnit .
Esta API está disponível nas seguintes implementações de cloud nacionais.
Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Permissões
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
---|---|---|
Delegado (conta corporativa ou de estudante) | AdministrativeUnit.ReadWrite.All | Indisponível. |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Application | AdministrativeUnit.ReadWrite.All | Indisponível. |
Em cenários delegados, o utilizador com sessão iniciada também tem de ter uma função suportada do Microsoft Entra ou uma função personalizada com a permissão de microsoft.directory/administrativeUnits/allProperties/allTasks
função. O Administrador de Funções Com Privilégios é a função com menos privilégios para esta operação.
Solicitação HTTP
PATCH /administrativeUnits/{id}
PATCH /directory/administrativeUnits/{id}
Cabeçalhos de solicitação
Nome | Descrição |
---|---|
Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Corpo da solicitação
No corpo da solicitação, forneça os valores para os campos relevantes que devem ser atualizados. As propriedades existentes que não estão incluídas no corpo do pedido mantêm os valores anteriores ou são recalculadas com base em alterações a outros valores de propriedade. Para alcançar o melhor desempenho, não inclua valores existentes que não foram alterados.
Propriedade | Tipo | Descrição |
---|---|---|
description | Cadeia de caracteres | Descrição da unidade administrativa. |
displayName | Cadeia de caracteres | Nome a apresentar para a unidade administrativa. |
membershipRule | String | Regra de associação dinâmica para a unidade administrativa. Para obter mais informações sobre as regras que pode utilizar para unidades administrativas dinâmicas e grupos dinâmicos, veja Utilizar atributos para criar regras avançadas. |
membershipRuleProcessingState | String | Utilizado para controlar se a regra de associação dinâmica é processada ativamente. Defina como On quando pretende que a regra de associação dinâmica esteja ativa e Paused se quiser parar de atualizar a associação dinamicamente. |
membershipType | Cadeia de caracteres | Tipo de associação para a unidade administrativa. Pode ser dynamic ou assigned . |
visibility | Cadeia de caracteres | Visibilidade da unidade administrativa. Se não estiver definida, a predefinição é public . Pode ser definido como HiddenMembership , o que oculta a associação de não membros. |
Uma vez que o recurso administrativeUnit suporta extensões, pode utilizar a PATCH
operação para adicionar, atualizar ou eliminar os seus próprios dados específicos da aplicação em propriedades personalizadas de uma extensão numa instância administrativeUnit existente.
Resposta
Se tiver êxito, este método retornará um código de resposta 204 No Content
.
Exemplos
O exemplo seguinte define uma regra de associação dinâmica numa unidade administrativa existente para incluir todos os utilizadores cujo país seja Estados Unidos. Também atualiza o nome a apresentar da unidade administrativa.
Solicitação
PATCH https://graph.microsoft.com/beta/administrativeUnits/4d7ea995-bc0f-45c0-8c3e-132e93bf95f8
Content-type: application/json
{
"displayName": "Executive Division",
"membershipType": "Dynamic",
"membershipRule": "(user.country -eq \"United States\")",
"membershipRuleProcessingState": "On"
}
Resposta
HTTP/1.1 204 No Content
Conteúdo relacionado
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários