Data Masking Policies - Create Or Update

Служба:

SQL Database

Версия API:

2023-08-01

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

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/dataMaskingPolicies/Default?api-version=2023-08-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
databaseName	path	True	string	Имя базы данных.
dataMaskingPolicyName	path	True	DataMaskingPolicyName	Имя базы данных, для которой применяется политика маскирования данных.
resourceGroupName	path	True	string	Имя группы ресурсов, содержащей ресурс. Это значение можно получить из API Azure Resource Manager или портала.
serverName	path	True	string	Имя сервера.
subscriptionId	path	True	string	Идентификатор подписки, идентифицирующий подписку Azure.
api-version	query	True	string	Версия API, используемая для запроса.

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

Имя	Обязательно	Тип	Описание
properties.dataMaskingState	True	DataMaskingState	Состояние политики маскирования данных.
properties.exemptPrincipals		string	Список исключенных субъектов. Указывает список пользователей базы данных с запятой, для которых политика маскирования данных не применяется. Указанные пользователи получают результаты данных без маскирования для всех запросов к базе данных.

Ответы

Имя	Тип	Описание
200 OK	DataMaskingPolicy	Успешно созданная политика маскирования данных базы данных.
201 Created	DataMaskingPolicy	Успешно созданная политика маскирования данных базы данных..
Other Status Codes	ErrorResponse	Ответы на ошибки: *** 400 InvalidDatabaseNameForDataMaskingOperation . Невозможно применить политику маскирования данных и правила непосредственно к базе данных master. Политика и правила маскирования данных применимы только к пользовательской базе данных.

Примеры

Create or update data masking policy max

Create or update data masking policy min.

Create or update data masking policy max

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

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default?api-version=2023-08-01

{
  "properties": {
    "dataMaskingState": "Enabled",
    "exemptPrincipals": "testuser;"
  }
}

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

Код состояния:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default",
  "name": "Default",
  "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies",
  "location": "Central US",
  "kind": null,
  "properties": {
    "dataMaskingState": "Enabled",
    "applicationPrincipals": "",
    "exemptPrincipals": "testuser;",
    "maskingLevel": ""
  }
}

Код состояния:

201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default",
  "name": "Default",
  "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies",
  "location": "Central US",
  "kind": null,
  "properties": {
    "dataMaskingState": "Enabled",
    "applicationPrincipals": "",
    "exemptPrincipals": "testuser;",
    "maskingLevel": ""
  }
}

Create or update data masking policy min.

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

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default?api-version=2023-08-01

{
  "properties": {
    "dataMaskingState": "Enabled"
  }
}

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

Код состояния:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default",
  "name": "Default",
  "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies",
  "location": "Central US",
  "kind": null,
  "properties": {
    "dataMaskingState": "Enabled",
    "applicationPrincipals": "",
    "exemptPrincipals": "",
    "maskingLevel": ""
  }
}

Код состояния:

201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default",
  "name": "Default",
  "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies",
  "location": "Central US",
  "kind": null,
  "properties": {
    "dataMaskingState": "Enabled",
    "applicationPrincipals": "",
    "exemptPrincipals": "",
    "maskingLevel": ""
  }
}

Определения

Имя	Описание
DataMaskingPolicy	Политика маскирования данных базы данных.
DataMaskingPolicyName	Имя базы данных, для которой применяется политика маскирования данных.
DataMaskingState	Состояние политики маскирования данных.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку

DataMaskingPolicy

Object

Политика маскирования данных базы данных.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
kind	string	Тип политики маскирования данных. Метаданные, используемые для портала Azure.
location	string	Расположение политики маскирования данных.
name	string	Имя ресурса.
properties.applicationPrincipals	string	Список субъектов приложения. Это устаревший параметр и больше не используется.
properties.dataMaskingState	DataMaskingState	Состояние политики маскирования данных.
properties.exemptPrincipals	string	Список исключенных субъектов. Указывает список пользователей базы данных с запятой, для которых политика маскирования данных не применяется. Указанные пользователи получают результаты данных без маскирования для всех запросов к базе данных.
properties.maskingLevel	string	Уровень маскирования. Это устаревший параметр и больше не используется.
type	string	Тип ресурса.

DataMaskingPolicyName

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

Имя базы данных, для которой применяется политика маскирования данных.

Значение	Описание
Default

DataMaskingState

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

Состояние политики маскирования данных.

Значение	Описание
Disabled
Enabled

ErrorAdditionalInfo

Object

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

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

ErrorDetail

Object

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

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

ErrorResponse

Object

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.