Atualizar deviceManagementSettingDefinitionUpdate deviceManagementSettingDefinition

Namespace: microsoft.graphNamespace: microsoft.graph

Importante: As APIs do Microsoft Graph na versão/beta estão sujeitas a alterações; Não há suporte para o uso de produção.Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

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.

Atualiza as propriedades de um objeto deviceManagementSettingDefinition .Update the properties of a deviceManagementSettingDefinition 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 DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All

Solicitação HTTPHTTP Request

PATCH /deviceManagement/settingDefinitions/{deviceManagementSettingDefinitionId}
PATCH /deviceManagement/categories/{deviceManagementSettingCategoryId}/settingDefinitions/{deviceManagementSettingDefinitionId}
PATCH /deviceManagement/intents/{deviceManagementIntentId}/categories/{deviceManagementIntentSettingCategoryId}/settingDefinitions/{deviceManagementSettingDefinitionId}
PATCH /deviceManagement/templates/{deviceManagementTemplateId}/categories/{deviceManagementTemplateSettingCategoryId}/settingDefinitions/{deviceManagementSettingDefinitionId}

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

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

PropriedadeProperty TipoType DescriçãoDescription
idid Cadeia de caracteresString A ID da definição de configuraçãoThe ID of the setting definition
valueTypevalueType deviceManangementIntentValueTypedeviceManangementIntentValueType O tipo de dados do valor.The data type of the value. Os possíveis valores são: integer, boolean, string, complex, collection, abstractComplex.Possible values are: integer, boolean, string, complex, collection, abstractComplex.
displayNamedisplayName Cadeia de caracteresString O nome de exibição da configuraçãoThe setting's display name
isTopLevelisTopLevel BoolianoBoolean Se a configuração for de nível superior, ela poderá ser configurada sem a necessidade de ser encapsulada em uma coleção ou configuração complexaIf the setting is top level, it can be configured without the need to be wrapped in a collection or complex setting
descriptiondescription StringString A descrição da configuraçãoThe setting's description
placeholderTextplaceholderText Cadeia de caracteresString Texto do espaço reservado como um exemplo de entrada válidaPlaceholder text as an example of valid input
documentationUrldocumentationUrl Cadeia de caracteresString URL para configurar a documentaçãoUrl to setting documentation
palavras-chavekeywords Coleção de cadeias de caracteresString collection Palavras-chave associadas à configuraçãoKeywords associated with the setting
asconstraints coleção deviceManagementConstraintdeviceManagementConstraint collection Conjunto de restrições para o valor de configuraçãoCollection of constraints for the setting value
relaçãodependencies coleção deviceManagementSettingDependencydeviceManagementSettingDependency collection Coleção de dependências em outras configuraçõesCollection of dependencies on other settings

RespostaResponse

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

ExemploExample

SolicitaçãoRequest

Este é um exemplo da solicitação.Here is an example of the request.

PATCH https://graph.microsoft.com/beta/deviceManagement/settingDefinitions/{deviceManagementSettingDefinitionId}
Content-type: application/json
Content-length: 928

{
  "@odata.type": "#microsoft.graph.deviceManagementSettingDefinition",
  "valueType": "boolean",
  "displayName": "Display Name value",
  "isTopLevel": true,
  "description": "Description value",
  "placeholderText": "Placeholder Text value",
  "documentationUrl": "https://example.com/documentationUrl/",
  "keywords": [
    "Keywords value"
  ],
  "constraints": [
    {
      "@odata.type": "microsoft.graph.deviceManagementSettingAppConstraint",
      "supportedTypes": [
        "Supported Types value"
      ]
    }
  ],
  "dependencies": [
    {
      "@odata.type": "microsoft.graph.deviceManagementSettingDependency",
      "definitionId": "Definition Id value",
      "constraints": [
        {
          "@odata.type": "microsoft.graph.deviceManagementSettingAppConstraint",
          "supportedTypes": [
            "Supported Types value"
          ]
        }
      ]
    }
  ]
}

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 200 OK
Content-Type: application/json
Content-Length: 977

{
  "@odata.type": "#microsoft.graph.deviceManagementSettingDefinition",
  "id": "4ec3093d-093d-4ec3-3d09-c34e3d09c34e",
  "valueType": "boolean",
  "displayName": "Display Name value",
  "isTopLevel": true,
  "description": "Description value",
  "placeholderText": "Placeholder Text value",
  "documentationUrl": "https://example.com/documentationUrl/",
  "keywords": [
    "Keywords value"
  ],
  "constraints": [
    {
      "@odata.type": "microsoft.graph.deviceManagementSettingAppConstraint",
      "supportedTypes": [
        "Supported Types value"
      ]
    }
  ],
  "dependencies": [
    {
      "@odata.type": "microsoft.graph.deviceManagementSettingDependency",
      "definitionId": "Definition Id value",
      "constraints": [
        {
          "@odata.type": "microsoft.graph.deviceManagementSettingAppConstraint",
          "supportedTypes": [
            "Supported Types value"
          ]
        }
      ]
    }
  ]
}