Sensitivity Settings - Create Or Update

Serviço:: Defender for Cloud

Versão API:: 2023-02-15-preview

Criar ou atualizar configurações de sensibilidade de dados para descoberta de dados confidenciais

PUT https://management.azure.com/providers/Microsoft.Security/sensitivitySettings/current?api-version=2023-02-15-preview

Parâmetros URI

Nome	Em	Necessário	Tipo	Descrição
api-version	query	True	string	Versão da API para a operação

Órgão do Pedido

Nome	Necessário	Tipo	Descrição
sensitiveInfoTypesIds	True	string[] (uuid)	Lista de IDs de tipos de informações confidenciais selecionados.
sensitivityThresholdLabelId		string (uuid)	A id do rótulo do limiar de sensibilidade. Qualquer rótulo igual ou superior a esta classificação será considerado sensível.
sensitivityThresholdLabelOrder		number	A ordem do rótulo do limiar de sensibilidade. Qualquer etiqueta com ou acima desta ordem será considerada sensível. Se definido como -1, a sensibilidade por rótulos será desativada

Respostas

Nome	Tipo	Descrição
200 OK	GetSensitivitySettingsResponse	Sucesso da atualização das configurações de sensibilidade
Other Status Codes	CloudError	Resposta de erro descrevendo por que a operação falhou

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

Tipo: oauth2
Flow: implicit
URL de autorização: https://login.microsoftonline.com/common/oauth2/authorize

Alcances

Nome	Descrição
user_impersonation	personificar a sua conta de utilizador

Exemplos

Update sensitivity settings

Pedido de exemplo

HTTP

PUT https://management.azure.com/providers/Microsoft.Security/sensitivitySettings/current?api-version=2023-02-15-preview

{
  "sensitiveInfoTypesIds": [
    "f2f8a7a1-28c0-404b-9ab4-30a0a7af18cb",
    "b452f22b-f87d-4f48-8490-ecf0873325b5",
    "d59ee8b6-2618-404b-a5e7-aa377cd67543"
  ],
  "sensitivityThresholdLabelOrder": 2,
  "sensitivityThresholdLabelId": "f2f8a7a1-28c0-404b-9ab4-30a0a7af18cb"
}

Resposta de exemplo

Código de estado:: 200

{
  "id": "/providers/Microsoft.Security/sensitivitySettings",
  "name": "current",
  "type": "Microsoft.Security/sensitivitySettings",
  "properties": {
    "sensitiveInfoTypesIds": [
      "a98fde82-45b6-4b2c-afd0-ad579cd9f826",
      "4d0d3eb6-619f-4c8c-810c-c16150c95278",
      "0e9b3178-9678-47dd-a509-37222ca96b42",
      "c5f9b9a1-2b9a-4a3a-8c5b-1f3d1d9d9c9b"
    ],
    "sensitivityThresholdLabelOrder": 2,
    "mipInformation": {
      "mipIntegrationStatus": "Ok",
      "labels": [
        {
          "name": "Public",
          "id": "fdfb5435-124d-4651-a889-a4210fec6a77",
          "order": 0
        },
        {
          "name": "Confidential",
          "id": "4c5447ec-f7f3-4345-a160-6a5850f2bf0c",
          "order": 1
        },
        {
          "name": "Highly Confidential",
          "id": "f38ac75c-f42a-4c89-aa37-9c4e74101414",
          "order": 2
        }
      ],
      "customInfoTypes": [
        {
          "name": "User created custom info type 1",
          "id": "c5f9b9a1-2b9a-4a3a-8c5b-1f3d1d9d9c9b",
          "description": "Custom info type description"
        },
        {
          "name": "User created custom info type 2",
          "id": "a4fee2b6-5618-404b-a5e7-aa377cd67543",
          "description": "Custom info type description"
        },
        {
          "name": "User created custom info type 3",
          "id": "a355f11e-f87d-4f48-8490-ecf0873325b5",
          "description": "Custom info type description"
        }
      ],
      "builtInInfoTypes": [
        {
          "name": "Http Authorization Header",
          "type": "Credentials",
          "id": "4d0d3eb6-619f-4c8c-810c-c16150c95278"
        },
        {
          "name": "User Login Credentials",
          "type": "Credentials",
          "id": "a98fde82-45b6-4b2c-afd0-ad579cd9f826"
        },
        {
          "name": "Credit card number",
          "type": "Finance",
          "id": "50842eb7-edc8-4019-85dd-5a5c1f2bb085"
        },
        {
          "name": "EU debit card number",
          "type": "Finance",
          "id": "0e9b3178-9678-47dd-a509-37222ca96b42"
        }
      ]
    }
  }
}

Definições

Nome	Descrição
BuiltInInfoType	Tipo de informação confidencial pré-configurado
CloudError	Resposta de erro comum para todas as APIs do Azure Resource Manager para retornar detalhes de erro para operações com falha. (Isso também segue o formato de resposta de erro OData.)
CloudErrorBody	O detalhe do erro.
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
GetSensitivitySettingsResponse	Configurações de sensibilidade de dados para descoberta de dados confidenciais
InfoType	Tipo de informação personalizado definido pelo utilizador
Label	Rótulo de sensibilidade de proteção de informações da Microsoft
MipInformation	Proteção de informações da Microsoft Tipos de informações internos e personalizados, rótulos e status de integração.
MipIntegrationStatus	Status de integração da proteção de informações da Microsoft
Properties	As propriedades das configurações de sensibilidade
UpdateSensitivitySettingsRequest	Solicitação para atualizar as configurações de confidencialidade de dados para descoberta de dados confidenciais

BuiltInInfoType

Objetivo

Tipo de informação confidencial pré-configurado

Nome	Tipo	Descrição
id	string (uuid)	ID do tipo de informação
name	string	Nome para exibição do tipo de informação
type	string	Categoria do tipo de informação incorporado

CloudError

Objetivo

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

Nome	Tipo	Descrição
error.additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
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

Objetivo

O detalhe do erro.

Nome	Tipo	Descrição
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
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.

ErrorAdditionalInfo

Objetivo

O erro de gerenciamento de recursos informações adicionais.

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

GetSensitivitySettingsResponse

Objetivo

Configurações de sensibilidade de dados para descoberta de dados confidenciais

Nome	Tipo	Descrição
id	string	A ID das configurações de sensibilidade
name	string	O nome das configurações de sensibilidade
properties	Properties	As propriedades das configurações de sensibilidade
type	string	O tipo de configurações de sensibilidade

InfoType

Objetivo

Tipo de informação personalizado definido pelo utilizador

Nome	Tipo	Descrição
description	string	Descrição do tipo de informação
id	string (uuid)	ID do tipo de informação
name	string	Nome para exibição do tipo de informação

Label

Objetivo

Rótulo de sensibilidade de proteção de informações da Microsoft

Nome	Tipo	Descrição
id	string (uuid)	O ID do rótulo
name	string	O nome para exibição do rótulo
order	number	Os rótulos são ordenados por nível de sensibilidade. Quanto maior a ordem do rótulo, mais sensível ele é.

MipInformation

Objetivo

Proteção de informações da Microsoft Tipos de informações internos e personalizados, rótulos e status de integração.

Nome	Tipo	Descrição
builtInInfoTypes	BuiltInInfoType[]	Lista de tipos de informações confidenciais pré-configuradas
customInfoTypes	InfoType[]	Lista de tipos de informações personalizados definidos pelo usuário
labels	Label[]	Lista de rótulos de sensibilidade à proteção de informações da Microsoft
mipIntegrationStatus	MipIntegrationStatus	Status de integração da proteção de informações da Microsoft

MipIntegrationStatus

Enumeração

Status de integração da proteção de informações da Microsoft

Valor	Descrição
Ok
noConsent
noAutoLabelingRules
noMipLabels

Properties

Objetivo

As propriedades das configurações de sensibilidade

Nome	Tipo	Descrição
mipInformation	MipInformation	Proteção de informações da Microsoft Tipos de informações internos e personalizados, rótulos e status de integração.
sensitiveInfoTypesIds	string[] (uuid)	Lista de IDs de tipos de informações confidenciais selecionados.
sensitivityThresholdLabelId	string (uuid)	A id do rótulo do limiar de sensibilidade. Qualquer rótulo igual ou superior a esta classificação será considerado sensível.
sensitivityThresholdLabelOrder	number	A ordem do rótulo do limiar de sensibilidade. Qualquer etiqueta com ou acima desta ordem será considerada sensível. Se definido como -1, a sensibilidade por rótulos será desativada

UpdateSensitivitySettingsRequest

Objetivo

Solicitação para atualizar as configurações de confidencialidade de dados para descoberta de dados confidenciais

Nome	Tipo	Descrição
sensitiveInfoTypesIds	string[] (uuid)	Lista de IDs de tipos de informações confidenciais selecionados.
sensitivityThresholdLabelId	string (uuid)	A id do rótulo do limiar de sensibilidade. Qualquer rótulo igual ou superior a esta classificação será considerado sensível.
sensitivityThresholdLabelOrder	number	A ordem do rótulo do limiar de sensibilidade. Qualquer etiqueta com ou acima desta ordem será considerada sensível. Se definido como -1, a sensibilidade por rótulos será desativada

Partilhar via

Sensitivity Settings - Create Or Update

Parâmetros URI

Órgão do Pedido

Respostas

Segurança

azure_auth

Alcances

Exemplos

Update sensitivity settings

Pedido de exemplo

Resposta de exemplo

Definições

BuiltInInfoType

CloudError

CloudErrorBody

ErrorAdditionalInfo

GetSensitivitySettingsResponse

InfoType

Label

MipInformation

MipIntegrationStatus

Properties

UpdateSensitivitySettingsRequest