¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
Exportar (0) Imprimir
Expandir todo

Crear usuarios

Actualizado: mayo de 2015

Importante: El contenido de este tema puede estar obsoleto. Vea la nueva documentación interactiva de API Graph para obtener la documentación de referencia más actualizada para API Graph de Azure AD. Con la documentación interactiva, puede intentar realizar operaciones REST en un inquilino de ejemplo desde la misma documentación. Únicamente se actualiza la documentación interactiva, y este tema se quitará en el futuro.

La operación Create User(s) crea uno o más usuarios nuevos en el directorio.

La propiedad immutableId se agregó a un objeto Usuario para solicitudes que usan la versión 08-11-2013 o versiones más recientes. Al crear un usuario con la versión 08-11-2013 o una versión más reciente, esta propiedad se debe especificar si userPrincipalName (UPN) incluye un dominio federado.

La solicitud se puede construir como sigue. Reemplaza mytenantdomain por el dominio de tu inquilino de Azure Active Directory, como contoso.onmicrosoft.com. El parámetro de la cadena de consulta de api-version es obligatorio. Los ejemplos de este tema utilizan el dominio del inquilino para dirigirse al inquilino. Para conocer otras maneras de dirigirse al inquilino, vea Dirigirse a entidades y operaciones en la API Graph.

 

Método HTTP URI de solicitud Versión de HTTP

POST

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

HTTP 1.1

 

Encabezado de solicitud Descripción

Autorización

Requerido. Un token de portador emitido por Azure Active Directory. Vea Authentication Scenarios for Azure AD para obtener más información.

Content-Type

Requerido. El tipo de medio del contenido en el cuerpo de la solicitud.

Content-Length

Requerido. La longitud de la solicitud en bytes.

Una o más entidades User con las propiedades mínimas especificadas en el tema Usuario. La contraseña especificada debe cumplir los requisitos de complejidad de contraseñas del inquilino. Para obtener más información sobre los requisitos de complejidad de contraseñas, consulta el tema Usuario. La siguiente solicitud de ejemplo muestra las propiedades mínimas necesarias para crear un usuario correctamente.

La siguiente solicitud de ejemplo crea un nuevo usuario en el directorio que usa la versión 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"
}


La siguiente solicitud de ejemplo crea un usuario en el directorio con la versión 08-11-2013, especificando la propiedad 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=="
}


Una operación correcta devuelve el código de estado 201 Creado.

 

Encabezado de respuesta Descripción

Ubicación

El URI del usuario creado, que incluye un id. de objeto.

ocp-aad-diagnostics-server-name

El identificador del servidor que realizó la operación solicitada.

ocp-aad-session-key

La clave que identifica la sesión actual con el servicio de directorio.

La siguiente respuesta de ejemplo se recibe al enviar la solicitud de ejemplo anterior.

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"
}

Vea también

Conceptos

Usuario

Mostrar:
© 2015 Microsoft