Atualizar identityUserFlowAttributeAssignment

Namespace: microsoft.graph

Atualizar as propriedades de um objeto identityUserFlowAttributeAssignment.

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) IdentityUserFlow.ReadWrite.All Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application IdentityUserFlow.ReadWrite.All Indisponível.

Importante

Para acesso delegado usando contas corporativas ou de estudante, o usuário conectado deve receber uma função do Microsoft Entra com suporte ou uma função personalizada que conceda as permissões necessárias para esta operação. O Administrador de fluxo de usuário de ID externa é a função com menos privilégios com suporte para essa operação.

Solicitação HTTP

PATCH /identity/b2cUserFlows/{id}/userAttributeAssignments/{id}
PATCH /identity/b2xUserFlows/{id}/userAttributeAssignments/{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 da solicitação, forneça uma representação JSON do objeto identityUserFlowAttributeAssignment .

A tabela a seguir mostra as propriedades que estão disponíveis para atualização no identityUserFlowAttributeAssignment.

Propriedade Tipo Descrição
displayName Cadeia de caracteres O nome de exibição do identityUserFlowAttribute em um fluxo do usuário.
isOptional Booliano Determina se o identityUserFlowAttribute é opcional. true significa que o usuário não precisa fornecer um valor. false significa que o usuário não pode concluir a inscrição sem fornecer um valor.
requiresVerification Booliano Determina se o identityUserFlowAttribute requer verificação. Isso é usado apenas para verificar o número de telefone ou o endereço de email do usuário.
userAttributeValues Coleção userAttributeValuesItem As opções de entrada para o atributo de fluxo do usuário. Aplicável somente quando userInputType é radioSingleSelect, dropdownSingleSelect, ou checkboxMultiSelect.
userInputType identityUserFlowAttributeInputType O tipo de entrada do atributo de fluxo do usuário. Os valores possíveis são: textBox, dateTimeDropdown, radioSingleSelect, dropdownSingleSelect, emailBox, checkboxMultiSelect.

Resposta

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

Exemplos

Solicitação

PATCH https://graph.microsoft.com/beta/identity/b2cUserFlows/{b2cIdentityUserFlowId}/userAttributeAssignments/{id}
Content-Type: application/json

{
  "userInputType": "textBox"
}

Resposta

HTTP/1.1 204 No Content