Settings - Update

Service:

Defender for Cloud

API Version:

2021-06-01

atualizando configurações sobre diferentes configurações no Microsoft Defender para Nuvem

PUT https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/settings/{settingName}?api-version=2021-06-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
settingName	path	True	string	O nome da configuração
subscriptionId	path	True	string	ID de assinatura do Azure Regex pattern: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$
api-version	query	True	string	Versão da API para a operação

Corpo da solicitação

O corpo da solicitação pode ser um dos seguintes:

Nome	Description
AlertSyncSettings	Representa uma configuração de sincronização de alerta
DataExportSettings	Representa uma configuração de exportação de dados

AlertSyncSettings

Representa uma configuração de sincronização de alerta

Nome	Obrigatório	Tipo	Description
kind	True	string: AlertSyncSettings	o tipo da cadeia de caracteres de configurações
properties.enabled	True	boolean	A configuração de sincronização de alerta está habilitada

DataExportSettings

Representa uma configuração de exportação de dados

Nome	Obrigatório	Tipo	Description
kind	True	string: DataExportSettings	o tipo da cadeia de caracteres de configurações
properties.enabled	True	boolean	A configuração de exportação de dados está habilitada

Respostas

Nome	Tipo	Description
200 OK	Setting: DataExportSettings AlertSyncSettings	OK
Other Status Codes	CloudError	Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

Update a setting for subscription

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/settings/WDATP?api-version=2021-06-01

{
  "kind": "DataExportSettings",
  "properties": {
    "enabled": true
  }
}

Sample Response

Status code:

200

{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/settings/WDATP",
  "name": "WDATP",
  "kind": "DataExportSettings",
  "type": "Microsoft.Security/settings",
  "properties": {
    "enabled": true
  }
}

Definições

Nome	Description
AlertSyncSettings	Representa uma configuração de sincronização de alerta
CloudError	Resposta de erro comum para todas as APIs do Azure Resource Manager para retornar detalhes de erro de operações com falha. (Isso também segue o formato de resposta de erro OData.).
CloudErrorBody	Os detalhes do erro.
DataExportSettings	Representa uma configuração de exportação de dados
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.

AlertSyncSettings

Representa uma configuração de sincronização de alerta

Nome	Tipo	Description
id	string	ID do recurso
kind	string: AlertSyncSettings	o tipo da cadeia de caracteres de configurações
name	string	Nome do recurso
properties.enabled	boolean	A configuração de sincronização de alerta está habilitada
type	string	Tipo de recurso

CloudError

Resposta de erro comum para todas as APIs do Azure Resource Manager para retornar detalhes de erro de operações com falha. (Isso também segue o formato de resposta de erro OData.).

Nome	Tipo	Description
error.additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
error.code	string	O código de erro.
error.details	CloudErrorBody[]	Os detalhes do erro.
error.message	string	A mensagem de erro.
error.target	string	O destino do erro.

CloudErrorBody

Os detalhes do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	CloudErrorBody[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

DataExportSettings

Representa uma configuração de exportação de dados

Nome	Tipo	Description
id	string	ID do recurso
kind	string: DataExportSettings	o tipo da cadeia de caracteres de configurações
name	string	Nome do recurso
properties.enabled	boolean	A configuração de exportação de dados está habilitada
type	string	Tipo de recurso

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.