Settings - Update

Service:

Defender for Cloud

API Version:

2021-06-01

atualizar definições sobre diferentes configurações no Microsoft Defender para a Cloud

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
settingName	path	True	string	O nome da definição
subscriptionId	path	True	string	ID da subscrição 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 do Pedido

O corpo de pedido pode ser um dos seguintes:

Name	Description
AlertSyncSettings	Representa uma definição de sincronização de alertas
DataExportSettings	Representa uma definição de exportação de dados

AlertSyncSettings

Representa uma definição de sincronização de alertas

Name	Necessário	Tipo	Description
kind	True	string: AlertSyncSettings	o tipo de cadeia de definições
properties.enabled	True	boolean	A definição de sincronização de alertas está ativada?

DataExportSettings

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

Name	Necessário	Tipo	Description
kind	True	string: DataExportSettings	o tipo de cadeia de definições
properties.enabled	True	boolean	A definição de exportação de dados está ativada?

Respostas

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

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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

Scopes

Name	Description
user_impersonation	representar a sua conta de utilizador

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

Name	Description
AlertSyncSettings	Representa uma definição de sincronização de alertas
CloudError	Resposta de erro comum para todas as APIs do Azure Resource Manager para devolver detalhes do erro para operações com falhas. (Isto também segue o formato de resposta de erro OData.).
CloudErrorBody	O detalhe do erro.
DataExportSettings	Representa uma definição de exportação de dados
ErrorAdditionalInfo	Informações adicionais sobre o erro de gestão de recursos.

AlertSyncSettings

Representa uma definição de sincronização de alertas

Name	Tipo	Description
id	string	ID do Recurso
kind	string: AlertSyncSettings	o tipo de cadeia de definições
name	string	Nome do recurso
properties.enabled	boolean	A definição de sincronização de alertas está ativada?
type	string	Tipo de recurso

CloudError

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

Name	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

O detalhe do erro.

Name	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 definição de exportação de dados

Name	Tipo	Description
id	string	ID do Recurso
kind	string: DataExportSettings	o tipo de cadeia de definições
name	string	Nome do recurso
properties.enabled	boolean	A definição de exportação de dados está ativada?
type	string	Tipo de recurso

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informações adicionais.