Sensitivity Settings - Create Or Update

Служба:: Defender for Cloud

Версия API:: 2023-02-15-preview

Создание или обновление параметров конфиденциальности данных для обнаружения конфиденциальных данных

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
api-version	query	True	string	Версия API для операции

Текст запроса

Имя	Обязательно	Тип	Описание
sensitiveInfoTypesIds	True	string[] (uuid)	Список идентификаторов выбранных типов конфиденциальной информации.
sensitivityThresholdLabelId		string (uuid)	Идентификатор метки порогового значения конфиденциальности. Любая метка с или выше этого ранга будет считаться конфиденциальной.
sensitivityThresholdLabelOrder		number	Порядок метки порогового значения конфиденциальности. Любая метка, указанная выше, будет считаться конфиденциальной. Если задано значение -1, конфиденциальность по меткам отключена

Ответы

Имя	Тип	Описание
200 OK	GetSensitivitySettingsResponse	Успешное обновление параметров конфиденциальности
Other Status Codes	CloudError	Ответ на ошибку, описывающий причину сбоя операции

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

Update sensitivity settings

Образец запроса

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"
}

Пример ответа

Код состояния:: 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"
        }
      ]
    }
  }
}

Определения

Имя	Описание
BuiltInInfoType	Предварительно настроенный тип конфиденциальной информации
CloudError	Распространенный ответ об ошибке для всех API Azure Resource Manager для возврата сведений об ошибке для неудачных операций. (Это также следует формату ответа об ошибках OData.).
CloudErrorBody	Сведения об ошибке.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
GetSensitivitySettingsResponse	Параметры конфиденциальности данных для обнаружения конфиденциальных данных
InfoType	Настраиваемый определяемый пользователем тип информации
Label	Метка конфиденциальности защиты информации Майкрософт
MipInformation	Встроенная защита информации Майкрософт и настраиваемые типы информации, метки и состояние интеграции.
MipIntegrationStatus	Состояние интеграции с Microsoft Information Protection
Properties	Свойства параметров конфиденциальности
UpdateSensitivitySettingsRequest	Запрос на обновление параметров конфиденциальности данных для обнаружения конфиденциальных данных

BuiltInInfoType

Объект

Предварительно настроенный тип конфиденциальной информации

Имя	Тип	Описание
id	string (uuid)	Идентификатор типа сведений
name	string	Отображаемое имя типа сведений
type	string	Категория встроенного типа сведений

CloudError

Объект

Распространенный ответ об ошибке для всех API Azure Resource Manager для возврата сведений об ошибке для неудачных операций. (Это также следует формату ответа об ошибках OData.).

Имя	Тип	Описание
error.additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
error.code	string	Код ошибки.
error.details	CloudErrorBody[]	Сведения об ошибке.
error.message	string	Сообщение об ошибке.
error.target	string	Целевой объект ошибки.

CloudErrorBody

Объект

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	CloudErrorBody[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorAdditionalInfo

Объект

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Дополнительный тип сведений.

GetSensitivitySettingsResponse

Объект

Параметры конфиденциальности данных для обнаружения конфиденциальных данных

Имя	Тип	Описание
id	string	Идентификатор параметров конфиденциальности
name	string	Имя параметров конфиденциальности
properties	Properties	Свойства параметров конфиденциальности
type	string	Тип параметров конфиденциальности

InfoType

Объект

Настраиваемый определяемый пользователем тип информации

Имя	Тип	Описание
description	string	Описание типа сведений
id	string (uuid)	Идентификатор типа сведений
name	string	Отображаемое имя типа сведений

Label

Объект

Метка конфиденциальности защиты информации Майкрософт

Имя	Тип	Описание
id	string (uuid)	Идентификатор метки
name	string	Отображаемое имя метки
order	number	Метки упорядочены по уровню конфиденциальности. Чем выше порядок метки, тем более чувствительным он является.

MipInformation

Объект

Встроенная защита информации Майкрософт и настраиваемые типы информации, метки и состояние интеграции.

Имя	Тип	Описание
builtInInfoTypes	BuiltInInfoType[]	Список предварительно настроенных типов конфиденциальной информации
customInfoTypes	InfoType[]	Список пользовательских типов сведений
labels	Label[]	Список меток конфиденциальности защиты информации Майкрософт
mipIntegrationStatus	MipIntegrationStatus	Состояние интеграции с Microsoft Information Protection

MipIntegrationStatus

Перечисление

Состояние интеграции с Microsoft Information Protection

Значение	Описание
Ok
noConsent
noAutoLabelingRules
noMipLabels

Properties

Объект

Свойства параметров конфиденциальности

Имя	Тип	Описание
mipInformation	MipInformation	Встроенная защита информации Майкрософт и настраиваемые типы информации, метки и состояние интеграции.
sensitiveInfoTypesIds	string[] (uuid)	Список идентификаторов выбранных типов конфиденциальной информации.
sensitivityThresholdLabelId	string (uuid)	Идентификатор метки порогового значения конфиденциальности. Любая метка с или выше этого ранга будет считаться конфиденциальной.
sensitivityThresholdLabelOrder	number	Порядок метки порогового значения конфиденциальности. Любая метка, указанная выше, будет считаться конфиденциальной. Если задано значение -1, конфиденциальность по меткам отключена

UpdateSensitivitySettingsRequest

Объект

Запрос на обновление параметров конфиденциальности данных для обнаружения конфиденциальных данных

Имя	Тип	Описание
sensitiveInfoTypesIds	string[] (uuid)	Список идентификаторов выбранных типов конфиденциальной информации.
sensitivityThresholdLabelId	string (uuid)	Идентификатор метки порогового значения конфиденциальности. Любая метка с или выше этого ранга будет считаться конфиденциальной.
sensitivityThresholdLabelOrder	number	Порядок метки порогового значения конфиденциальности. Любая метка, указанная выше, будет считаться конфиденциальной. Если задано значение -1, конфиденциальность по меткам отключена

Поделиться через

Sensitivity Settings - Create Or Update

Параметры URI

Текст запроса

Ответы

Безопасность

azure_auth

Области

Примеры

Update sensitivity settings

Образец запроса

Пример ответа

Определения

BuiltInInfoType

CloudError

CloudErrorBody

ErrorAdditionalInfo

GetSensitivitySettingsResponse

InfoType

Label

MipInformation

MipIntegrationStatus

Properties

UpdateSensitivitySettingsRequest