Exportar (0) Imprimir
Expandir Tudo

Criar usuários

Atualizado: abril de 2014

A operação de criar usuário cria um ou mais novos usuários no diretório.

A propriedade immutableId foi adicionada a um objeto User para solicitações usando a versão de 08-11-2013 ou mais recente. Ao criar um usuário com a versão de 08-11-2013 ou mais recente, esta propriedade deverá ser especificada se o userPrincipalName (UPN) incluir um domínio federado.

A solicitação pode ser criada da seguinte maneira. Substitua o mytenantdomain pelo domínio do seu locatário Azure Active Directory, como contoso.onmicrosoft.com. O parâmetro de cadeia de caracteres de consulta api-version é obrigatório. Os exemplos neste tópico usam o domínio de locatário para tratar o locatário. Para conhecer outras maneiras de tratar o locatário, consulte Endereçando entidades e operações da API Gráfica.

 

Método de HTTTP URI de solicitação Versão de HTTP

POST

https://graph.windows.net/mytenantdomain/users?api-version=2013-04-05

HTTP 1.1

 

Cabeçalho de solicitação Descrição

Autorização

Obrigatória. Um token de portador emitido pelo Controle de Acesso do Azure. Consulte Azure AD Graph Authentication para obter mais informações.

Content-Type

Obrigatória. O tipo de mídia do conteúdo no corpo da solicitação.

Content-Length

Obrigatória. O comprimento da solicitação em bytes.

Uma ou mais entidades do Usuário com as propriedades mínimas especificadas no tópico User. A senha especificada deve atender aos requisitos de complexidade de senha do locatário. Para obter mais informações sobre os requisitos de complexidade de senha, consulte o tópico User. A solicitação de exemplo a seguir mostra as propriedades mínimas necessárias para criar um usuário com sucesso.

A seguinte solicitação de exemplo cria um novo usuário no diretório usando a versão de 05-04-2013:

POST https://graph.windows.net/contoso.onmicrosoft.com/users?api-version=2013-04-05 HTTP/1.1
Authorization: Bearer eyJ0eX ... FWSXfwtQ
Content-Type: application/json
Host: graph.windows.net
Content-Length: 252

{
    "accountEnabled": true,
    "displayName": "Alex Wu",
    "mailNickname": "AlexW",
    "passwordProfile": { "password" : "Test1234", "forceChangePasswordNextLogin": false },
    "userPrincipalName": "Alex@contoso.onmicrosoft.com"
}


A seguinte solicitação de exemplo cria um novo usuário no diretório usando a versão de 08-11-2013, especificando a propriedade immutableId:

POST https://graph.windows.net/contoso.onmicrosoft.com/users?api-version=2013-11-08 HTTP/1.1
Authorization: Bearer eyJ0eX ... FWSXfwtQ
Content-Type: application/json
Host: graph.windows.net
Content-Length: 293

{
    "accountEnabled": true,
    "displayName": "Alex Wu",
    "mailNickname": "AlexW",
    "passwordProfile": { "password" : "Test1234", "forceChangePasswordNextLogin": false },
    "userPrincipalName": "Alex@contoso.onmicrosoft.com"
    "immutableId": "6SNZnFLe6jOI3n68hjO5zA=="
}


Uma operação bem-sucedida retorna o código de status 201 Criado.

 

Cabeçalho de resposta Descrição

Local

O URI do usuário criado, que inclui uma ID de objeto.

ocp-aad-diagnostics-server-name

O identificador para o servidor que realizou a operação solicitada.

ocp-aad-session-key

A chave que identifica a sessão atual com o serviço de diretório.

A seguinte resposta de exemplo é recebida quando a solicitação de exemplo acima é enviada.

HTTP/1.1 201 Created
Cache-Control: no-cache
Content-Length: 982
Content-Type: application/json;odata=minimalmetadata;streaming=true;charset=utf-8
Location: https://directory.windows.net/contoso.onmicrosoft.com/directoryObjects/4e971521-101a-4311-94f4-0917d7218b4e/Microsoft.WindowsAzure.ActiveDirectory.User
Server: Microsoft-IIS/7.5
ocp-aad-diagnostics-server-name: XDALV0qN1u6zqj4Uo0sPtNcrP2gqE1lnhxOWAGczrDE=
request-id: 65230a2c-0477-4fb8-9cd5-adb796f8eb29
client-request-id: ae924da9-55ea-433a-b14e-da2ef9fcd6af
x-ms-dirapi-data-contract-version: 1.0
ocp-aad-session-key: eHD4TUXUT8mNc01h-PGrQAw0kfAGmLi_T64SX_h1OGu8mTPZXTZfa6HCCDc7-r7pMultoOn3oDO0ciBl8PzNAkRHkc2BD-tUnUJI3bYWT7T3YxjW2s0dortRi6yKrCf4Qx9m67uJmCT5FhqZsgNAvw.FujkHs6N4TinxXNQi_y41v8vDIrI1DKDQXyhexHvdY8
X-Content-Type-Options: nosniff
DataServiceVersion: 3.0;
X-AspNet-Version: 4.0.30319
X-Powered-By: ASP.NET
X-Powered-By: ARR/2.5
X-Powered-By: ASP.NET
Date: Wed, 27 Mar 2013 22:59:47 GMT

{
    "odata.metadata": "https://graph.windows.net/contoso.onmicrosoft.com/$metadata#directoryObjects/Microsoft.WindowsAzure.ActiveDirectory.User/@Element",
    "odata.type": "Microsoft.WindowsAzure.ActiveDirectory.User",
    "objectType": "User",
    "objectId": "4e971521-101a-4311-94f4-0917d7218b4e",
    "accountEnabled": true,
    "assignedLicenses": [],
    "assignedPlans": [],
    "city": null,
    "country": null,
    "department": null,
    "dirSyncEnabled": null,
    "displayName": "Alex Wu",
    "facsimileTelephoneNumber": null,
    "givenName": null,
    "jobTitle": null,
    "lastDirSyncTime": null,
    "mail": null,
    "mailNickname": "AlexW",
    "mobile": null,
    "otherMails": [],
    "passwordPolicies": null,
    "passwordProfile": null,
    "physicalDeliveryOfficeName": null,
    "postalCode": null,
    "preferredLanguage": null,
    "provisionedPlans": [],
    "provisioningErrors": [],
    "proxyAddresses": [],
    "state": null,
    "streetAddress": null,
    "surname": null,
    "telephoneNumber": null,
    "thumbnailPhoto@odata.mediaContentType": "image",
    "usageLocation": null,
    "userPrincipalName": "Alex@contoso.onmicrosoft.com"
}

Consulte também

Conceitos

User

A Microsoft está realizando uma pesquisa online para saber sua opinião sobre o site do MSDN. Se você optar por participar, a pesquisa online lhe será apresentada quando você sair do site do MSDN.

Deseja participar?
Mostrar:
© 2014 Microsoft