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


Sensitivity Settings - Create Or Update

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

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[]

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

sensitivityThresholdLabelId

string

Идентификатор метки порогового значения конфиденциальности. Любая метка с этим рангом или выше будет считаться конфиденциальной.

sensitivityThresholdLabelOrder

number

Порядок метки порогового значения конфиденциальности. Любая метка в этом заказе или выше будет считаться конфиденциальной. Если задано значение -1, конфиденциальность по меткам отключена

Ответы

Имя Тип Описание
200 OK

GetSensitivitySettingsResponse

Успешное обновление параметров конфиденциальности

Other Status Codes

CloudError

Сообщение об ошибке с описанием причины сбоя операции.

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

azure_auth

Поток OAuth2 в Azure Active Directory

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

Scopes

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

Примеры

Update sensitivity settings

Sample Request

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

Sample Response

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

Встроенные и настраиваемые типы информации, метки и состояние интеграции Microsoft Information Protection.

MipIntegrationStatus

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

Properties

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

UpdateSensitivitySettingsRequest

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

BuiltInInfoType

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

Имя Тип Описание
id

string

Идентификатор типа сведений

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

Идентификатор типа сведений

name

string

Отображаемое имя типа сведений

Label

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

Имя Тип Описание
id

string

Идентификатор метки

name

string

Отображаемое имя метки

order

number

Метки упорядочены по уровню конфиденциальности. Чем выше порядок метки, тем она чувствительнее.

MipInformation

Встроенные и настраиваемые типы информации, метки и состояние интеграции Microsoft Information Protection.

Имя Тип Описание
builtInInfoTypes

BuiltInInfoType[]

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

customInfoTypes

InfoType[]

Список пользовательских типов сведений

labels

Label[]

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

mipIntegrationStatus

MipIntegrationStatus

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

MipIntegrationStatus

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

Имя Тип Описание
Ok

string

noAutoLabelingRules

string

noConsent

string

noMipLabels

string

Properties

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

Имя Тип Описание
mipInformation

MipInformation

Встроенные и настраиваемые типы информации, метки и состояние интеграции Microsoft Information Protection.

sensitiveInfoTypesIds

string[]

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

sensitivityThresholdLabelId

string

Идентификатор метки порогового значения конфиденциальности. Любая метка с этим рангом или выше будет считаться конфиденциальной.

sensitivityThresholdLabelOrder

number

Порядок метки порогового значения конфиденциальности. Любая метка в этом заказе или выше будет считаться конфиденциальной. Если задано значение -1, конфиденциальность по меткам отключена

UpdateSensitivitySettingsRequest

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

Имя Тип Описание
sensitiveInfoTypesIds

string[]

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

sensitivityThresholdLabelId

string

Идентификатор метки порогового значения конфиденциальности. Любая метка с этим рангом или выше будет считаться конфиденциальной.

sensitivityThresholdLabelOrder

number

Порядок метки порогового значения конфиденциальности. Любая метка в этом заказе или выше будет считаться конфиденциальной. Если задано значение -1, конфиденциальность по меткам отключена