Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Importante: Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción.
Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.
Cree un objeto user.
## Permissions
Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos. El permiso específico necesario depende del contexto.
| Tipo de permiso | Permisos (de más a menos privilegiados) |
|---|---|
| Delegado (cuenta profesional o educativa) | |
| Administración de dispositivos | DeviceManagementManagedDevices.ReadWrite.All |
| MAM | DeviceManagementApps.ReadWrite.All |
| Incorporación | DeviceManagementServiceConfig.ReadWrite.All |
| Solución de problemas | DeviceManagementManagedDevices.ReadWrite.All |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | |
| Administración de dispositivos | DeviceManagementManagedDevices.ReadWrite.All |
| MAM | DeviceManagementApps.ReadWrite.All |
| Incorporación | DeviceManagementServiceConfig.ReadWrite.All |
| Solución de problemas | DeviceManagementManagedDevices.ReadWrite.All |
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Solicitud HTTP
POST /users
Encabezados de solicitud
| Encabezado | Valor |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
| Aceptar | application/json |
Cuerpo de la solicitud
En el cuerpo de la solicitud, especifique una representación JSON del objeto user.
En la tabla siguiente se muestran las propiedades necesarias para crear el objeto user.
| Propiedad | Tipo | Descripción |
|---|---|---|
| id | String | Identificador único del usuario. |
| Incorporación | ||
| deviceEnrollmentLimit | Int32 | El límite del número máximo de dispositivos que el usuario puede inscribir. Los valores permitidos son 5 o 1000. |
La compatibilidad con la propiedad del cuerpo de la solicitud varía según el contexto.
Respuesta
Si se ejecuta correctamente, este método devuelve un código de respuesta 201 Created y un objeto user en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
POST https://graph.microsoft.com/beta/users
Content-type: application/json
Content-length: 46
{
"@odata.type": "#microsoft.graph.user"
}
Respuesta
Aquí tiene un ejemplo de la respuesta. Nota: Es posible que el objeto de respuesta que aparezca aquí esté truncado para abreviar. Las propiedades devueltas de una llamada real varían según el contexto.
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 95
{
"@odata.type": "#microsoft.graph.user",
"id": "d36894ae-94ae-d368-ae94-68d3ae9468d3"
}