Criar iosCustomConfigurationCreate iosCustomConfiguration

Namespace: microsoft.graphNamespace: microsoft.graph

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Cria um novo objeto iosCustomConfiguration.Create a new iosCustomConfiguration object.

Pré-requisitosPrerequisites

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (de privilégios máximos a mínimos)Permissions (from most to least privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
AplicativoApplication Sem suporte.Not supported.

Solicitação HTTPHTTP Request

POST /deviceManagement/deviceConfigurations

Cabeçalhos de solicitaçãoRequest headers

CabeçalhoHeader ValorValue
AutorizaçãoAuthorization <Token> de portador obrigatório.Bearer <token> Required.
AceitarAccept application/jsonapplication/json

Corpo da solicitaçãoRequest body

No corpo da solicitação, forneça uma representação JSON do objeto iosCustomConfiguration.In the request body, supply a JSON representation for the iosCustomConfiguration object.

A tabela a seguir mostra as propriedades que são necessárias ao criar iosCustomConfiguration.The following table shows the properties that are required when you create the iosCustomConfiguration.

PropriedadeProperty TipoType DescriçãoDescription
idid StringString Chave da entidade.Key of the entity. Herdada de deviceConfigurationInherited from deviceConfiguration
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset DateTime da última modificação do objeto.DateTime the object was last modified. Herdada de deviceConfigurationInherited from deviceConfiguration
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset DateTime em que o objeto foi criado.DateTime the object was created. Herdada de deviceConfigurationInherited from deviceConfiguration
descriptiondescription StringString O administrador forneceu a descrição da Configuração do dispositivo.Admin provided description of the Device Configuration. Herdada de deviceConfigurationInherited from deviceConfiguration
displayNamedisplayName Cadeia de caracteresString O administrador forneceu o nome da Configuração do dispositivo.Admin provided name of the device configuration. Herdada de deviceConfigurationInherited from deviceConfiguration
versãoversion Int32Int32 Versão da configuração do dispositivo.Version of the device configuration. Herdada de deviceConfigurationInherited from deviceConfiguration
payloadNamepayloadName StringString Nome que é exibido para o usuário.Name that is displayed to the user.
payloadFileNamepayloadFileName Cadeia de caracteresString O nome do arquivo de carga (*.mobileconfigPayload file name (*.mobileconfig *.xml).*.xml).
payloadpayload BináriaBinary Carga.Payload. (Matriz de bytes codificados em UTF8)(UTF8 encoded byte array)

RespostaResponse

Se tiver êxito, este método retornará um código de resposta 201 Created e um objeto iosCustomConfiguration no corpo da resposta.If successful, this method returns a 201 Created response code and a iosCustomConfiguration object in the response body.

ExemploExample

SolicitaçãoRequest

Este é um exemplo da solicitação.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=="
}

RespostaResponse

Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada 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=="
}