Atualizar externalUserProfile
Namespace: microsoft.graph
Atualize as propriedades de um objeto externalUserProfile .
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) | ExternalUserProfile.ReadWrite.All | Indisponível. |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Application | ExternalUserProfile.ReadWrite.All | Indisponível. |
A conta escolar ou profissional tem de pertencer, pelo menos, à função administrador de serviços do TeamsMicrosoft Entra.
Solicitação HTTP
PATCH /directory/externalUserProfiles/{id}
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. |
Corpo da solicitação
No corpo do pedido, forneça uma representação JSON do objeto externalUserProfile .
A tabela seguinte mostra as propriedades que podem ser atualizadas depois de um pendingExternalUserProfile ser resgatado e convertido num externalUserProfile.
Propriedade | Tipo | Descrição |
---|---|---|
address | physicalOfficeAddress | O endereço do escritório do perfil de utilizador externo pendente. |
CompanyName | String | O nome da empresa do perfil de utilizador externo pendente. |
department | String | O departamento do perfil de utilizador externo pendente. |
displayName | Cadeia de caracteres | O nome a apresentar do perfil de utilizador externo pendente. |
isDiscoverable | Booliano | Representa se o perfil de utilizador externo pendente é detetável no diretório. |
isEnabled | Booliano | Representa se o perfil de utilizador externo pendente está ativado no diretório. |
jobTitle | String | O cargo do perfil de utilizador externo. |
supervisorId | Cadeia de caracteres | O ID de objeto do supervisor do perfil de utilizador externo pendente. |
Resposta
Se for bem-sucedido, este método devolve um 204 No Content
código de resposta e um objeto externalUserProfile atualizado no corpo da resposta.
Exemplo
Solicitação
O exemplo a seguir mostra uma solicitação.
PATCH https://graph.microsoft.com/beta/directory/externalUserProfiles/{id}
Content-Type: application/json
{
"jobTitle": "Contractor"
}
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 204 No Content
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de