Criar b2xIdentityUserFlow

Namespace: microsoft.graph

Crie um novo objeto b2xIdentityUserFlow.

Permissões

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) IdentityUserFlow.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Aplicativo IdentityUserFlow.ReadWrite.All

A conta de trabalho ou de estudante precisa pertencer a uma das seguintes funções:

  • Administrador global
  • Administrador de identidade externa Flow usuário

Solicitação HTTP

POST /identity/b2xUserFlows

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório.
Content-Type application/json. Obrigatório.

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON de um b2xIdentityUserFlow.

Propriedade Tipo Descrição
id String Obrigatório. O nome do fluxo de usuário. O nome será pré-canetado após B2X_1 a criação.
userFlowType Cadeia de caracteres Obrigatório. O tipo de fluxo de usuário que você está criando. Esse valor sempre será signUpOrSignIn .
userFlowTypeVersion Flutuação Obrigatório. A versão do fluxo de usuário. Esse valor sempre será 1.
apiConnectorConfiguration userFlowApiConnectorConfiguration Opcional. Configuração para habilitar um conector de API para uso como parte do fluxo do usuário.

Resposta

Se tiver êxito, este método retornará um código de resposta e um header Location com um URI para o objeto 201 Created b2xIdentityUserFlow criado para essa solicitação, com o prefixo adicionado ao B2X_1 nome. Caso não consiga, um 4xx erro será retornado com detalhes específicos.

Exemplos

Exemplo 1: Criar um fluxo de usuário com os valores padrão

Solicitação

Este é um exemplo de solicitação.

POST https://graph.microsoft.com/v1.0/identity/b2xUserFlows
Content-type: application/json

{
    "id": "Partner",
    "userFlowType": "signUpOrSignIn",
    "userFlowTypeVersion": 1
}

Resposta

Este é um exemplo de resposta.

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

HTTP/1.1 201 Created
Location: https://graph.microsoft.com/v1.0/identity/b2xUserFlows/B2X_1_Partner
Content-type: application/json

{
    "id": "B2X_1_Partner",
    "userFlowType": "signUpOrSignIn",
    "userFlowTypeVersion": 1
}

Exemplo 2: Criar um fluxo de usuário com os valores padrão e um provedor de identidade

Solicitação

Este é um exemplo de solicitação.

POST https://graph.microsoft.com/v1.0/identity/b2xUserFlows
Content-type: application/json

{
    "id": "Partner",
    "userFlowType": "signUpOrSignIn",
    "userFlowTypeVersion": 1,
    "identityProviders": [
        {
            "id": "Facebook-OAuth",
            "type": "Facebook",
            "name": "Facebook"
        }
    ]
}

Resposta

Este é um exemplo de resposta.

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

HTTP/1.1 201 Created
Location: https://graph.microsoft.com/v1.0/identity/b2xUserFlows/B2X_1_Partner
Content-type: application/json

{
    "id": "B2X_1_Partner",
    "userFlowType": "signUpOrSignIn",
    "userFlowTypeVersion": 1
}

Exemplo 3: Criar um fluxo de usuário com os valores padrão e configuração para conectores de API

Solicitação

Este é um exemplo de solicitação.

POST https://graph.microsoft.com/v1.0/identity/b2xUserFlows
Content-type: application/json

{
    "id": "UserFlowWithAPIConnector",
    "userFlowType": "signUpOrSignIn",
    "userFlowTypeVersion": 1,
    "apiConnectorConfiguration":{
        "postFederationSignup":{
            "@odata.id": "https://graph.microsoft.com/v1/identity/apiConnectors/{id}"
        },
        "postAttributeCollection":{
            "@odata.id": "https://graph.microsoft.com/v1/identity/apiConnectors/{id}"
        }
    }
}

Resposta

Este é um exemplo de resposta.

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

Observação: A apiConnectorConfiguration propriedade sempre retorna um valor ' {} . Para ver o valor completo com as propriedades de navegação, use esta API.

HTTP/1.1 201 Created
Location: https://graph.microsoft.com/v1.0/identity/b2xUserFlows/B2X_1_Partner
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identity/b2xUserFlows/$entity",
    "id": "B2X_1_UserFlowWithAPIConnector",
    "userFlowType": "signUpOrSignIn",
    "userFlowTypeVersion": 1,
    "apiConnectorConfiguration": {}
}