Crear iosCustomConfigurationCreate iosCustomConfiguration

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 iosCustomConfiguration.Create a new iosCustomConfiguration object.

Requisitos previosPrerequisites

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.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

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) DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.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 /deviceManagement/deviceConfigurations

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 iosCustomConfiguration.In the request body, supply a JSON representation for the iosCustomConfiguration object.

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

PropiedadProperty TipoType DescripciónDescription
idid CadenaString Clave de la entidad.Key of the entity. Heredado de deviceConfigurationInherited from deviceConfiguration
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Fecha y hora en la que se modificó el objeto por última vez.DateTime the object was last modified. Heredado de deviceConfigurationInherited from deviceConfiguration
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Fecha y hora en la que se creó el objeto.DateTime the object was created. Heredado de deviceConfigurationInherited from deviceConfiguration
descriptiondescription CadenaString Descripción proporcionada por el administrador de la configuración del dispositivo.Admin provided description of the Device Configuration. Heredado de deviceConfigurationInherited from deviceConfiguration
displayNamedisplayName CadenaString Nombre proporcionado por el administrador de la configuración del dispositivo.Admin provided name of the device configuration. Heredado de deviceConfigurationInherited from deviceConfiguration
versionversion Int32Int32 Versión de la configuración del dispositivo.Version of the device configuration. Heredado de deviceConfigurationInherited from deviceConfiguration
payloadNamepayloadName CadenaString Nombre que se muestra al usuario.Name that is displayed to the user.
payloadFileNamepayloadFileName CadenaString Nombre de archivo de carga útil (*.mobileconfigPayload file name (*.mobileconfig *.xml).*.xml).
carga útilpayload BinarioBinary Carga útil.Payload. (Matriz de bytes codificada UTF8)(UTF8 encoded byte array)

RespuestaResponse

Si se ejecuta correctamente, este método devuelve un código de respuesta 201 Created y un objeto iosCustomConfiguration en el cuerpo de la respuesta.If successful, this method returns a 201 Created response code and a iosCustomConfiguration 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/deviceManagement/deviceConfigurations
Content-type: application/json
Content-length: 279

{
  "@odata.type": "#microsoft.graph.iosCustomConfiguration",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "payloadName": "Payload Name value",
  "payloadFileName": "Payload File Name value",
  "payload": "cGF5bG9hZA=="
}

RespuestaResponse

Aquí tiene un ejemplo de la respuesta. Nota: Puede que el objeto de respuesta que aparece aquí se trunque para abreviar. Todas las propiedades se devolverán de una llamada real.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

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

{
  "@odata.type": "#microsoft.graph.iosCustomConfiguration",
  "id": "f34428e3-28e3-f344-e328-44f3e32844f3",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "payloadName": "Payload Name value",
  "payloadFileName": "Payload File Name value",
  "payload": "cGF5bG9hZA=="
}