Crear usuarioCreate user

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Cree un objeto user.Create a new user object.

Requisitos previosPrerequisites

Se requiere uno de los siguientes permisos para llamar a esta API.One of the following permissions is required to call this API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.To learn more, including how to choose permissions, see Permissions. El permiso específico necesario depende del contexto.The specific permission required depends on the context.

Tipo de permisoPermission type Permisos (de más a menos privilegiados)Permissions (from most to least privileged)
Delegado (cuenta profesional o educativa)Delegated (work or school account) varía según el contextovaries by context
  Administración de dispositivos    Device management DeviceManagementManagedDevices.ReadWrite.AllDeviceManagementManagedDevices.ReadWrite.All
  MAM    MAM DeviceManagementApps.ReadWrite.AllDeviceManagementApps.ReadWrite.All
  Incorporación    Onboarding DeviceManagementServiceConfig.ReadWrite.AllDeviceManagementServiceConfig.ReadWrite.All
  Solución de problemas    Troubleshooting DeviceManagementManagedDevices.ReadWrite.AllDeviceManagementManagedDevices.ReadWrite.All
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) No admitida.Not supported.
AplicaciónApplication No admitida.Not supported.

Solicitud HTTPHTTP Request

POST /users

Encabezados de solicitudRequest headers

EncabezadoHeader ValorValue
AuthorizationAuthorization Se requiere <token> de portador.Bearer <token> Required.
AceptarAccept application/jsonapplication/json

Cuerpo de la solicitudRequest body

En el cuerpo de la solicitud, especifique una representación JSON del objeto user.In the request body, supply a JSON representation for the user object.

En la tabla siguiente se muestran las propiedades necesarias para crear el objeto user.The following table shows the properties that are required when you create the user.

PropiedadProperty TipoType DescripciónDescription
idid CadenaString Identificador único del usuario.Unique identifier of the user.
IncorporaciónOnboarding
deviceEnrollmentLimitdeviceEnrollmentLimit Int32Int32 El límite del número máximo de dispositivos que el usuario puede inscribir.The limit on the maximum number of devices that the user is permitted to enroll. Los valores permitidos son 5 o 1000.Allowed values are 5 or 1000.

La compatibilidad de la propiedad de cuerpo de solicitud varía según el contexto.Request body property support varies according to context.

RespuestaResponse

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.If successful, this method returns a 201 Created response code and a user object in the response body.

EjemploExample

SolicitudRequest

Aquí tiene un ejemplo de la solicitud.Here is an example of the request.

POST https://graph.microsoft.com/v1.0/users
Content-type: application/json
Content-length: 46

{
  "@odata.type": "#microsoft.graph.user"
}

RespuestaResponse

Aquí tiene un ejemplo de la respuesta.Here is an example of the response. Nota: Es posible que el objeto de respuesta que aparezca aquí esté truncado para abreviar.Note: The response object shown here may be truncated for brevity. Las propiedades devueltas desde una llamada real varían según el contexto.Properties returned from an actual call vary according to context.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 95

{
  "@odata.type": "#microsoft.graph.user",
  "id": "d36894ae-94ae-d368-ae94-68d3ae9468d3"
}