Sensitivity Labels - Create Or Update

Служба:: SQL Database

Версия API:: 2025-01-01

Создает или обновляет метку конфиденциальности заданного столбца.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/schemas/{schemaName}/tables/{tableName}/columns/{columnName}/sensitivityLabels/current?api-version=2025-01-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
columnName	path	True	string	Имя столбца.
databaseName	path	True	string	Имя базы данных.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя регистронезависимо.
schemaName	path	True	string	Имя схемы.
sensitivityLabelSource	path	True	CurrentSensitivityLabelSource	Источник метки конфиденциальности.
serverName	path	True	string	Имени сервера.
subscriptionId	path	True	string (uuid)	Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
tableName	path	True	string	Название таблицы.
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

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

Имя	Тип	Описание
properties.clientClassificationSource	ClientClassificationSource
properties.informationType	string	Тип информации.
properties.informationTypeId	string	Идентификатор типа информации.
properties.labelId	string	Идентификатор метки.
properties.labelName	string	Имя метки.
properties.rank	SensitivityLabelRank

Ответы

Имя	Тип	Описание
200 OK	SensitivityLabel	Операция обновления ресурса 'SensitivityLabel' была успешна
201 Created	SensitivityLabel	Операция создания ресурса 'SensitivityLabel' успешно выполнена
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

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

azure_auth

Azure Active Directory OAuth2 Flow.

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

Области

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

Примеры

Updates the sensitivity label of a given column with all parameters

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

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/myServer/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn/sensitivityLabels/current?api-version=2025-01-01

{
  "properties": {
    "clientClassificationSource": "Native",
    "informationType": "PhoneNumber",
    "informationTypeId": "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
    "labelId": "bf91e08c-f4f0-478a-b016-25164b2a65ff",
    "labelName": "PII",
    "rank": "Low"
  }
}

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

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

{
  "name": "current",
  "type": "Microsoft.Sql/servers/databases/schemas/tables/columns/sensitivityLabels",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/myServer/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn/sensitivityLabels/current",
  "properties": {
    "columnName": "myColumn",
    "informationType": "PhoneNumber",
    "informationTypeId": "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
    "labelId": "bf91e08c-f4f0-478a-b016-25164b2a65ff",
    "labelName": "PII",
    "rank": "Medium",
    "schemaName": "dbo",
    "tableName": "myTable"
  }
}

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

{
  "name": "current",
  "type": "Microsoft.Sql/servers/databases/schemas/tables/columns/sensitivityLabels",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/myServer/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn/sensitivityLabels/current",
  "properties": {
    "informationType": "PhoneNumber",
    "informationTypeId": "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
    "labelId": "bf91e08c-f4f0-478a-b016-25164b2a65ff",
    "labelName": "PII",
    "rank": "High"
  }
}

Определения

Имя	Описание
ClientClassificationSource
createdByType	Тип удостоверения, создавшего ресурс.
CurrentSensitivityLabelSource
ErrorAdditionalInfo	Ошибка управления ресурсами дополнительная информация.
ErrorDetail	Детали ошибки.
ErrorResponse	Ответ на ошибку
SensitivityLabel	Метка конфиденциальности.
SensitivityLabelRank
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.

ClientClassificationSource

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

Значение	Описание
None	Нет
Native	Native
Recommended	Рекомендуется
MIP	МИП

createdByType

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

Тип удостоверения, создавшего ресурс.

Значение	Описание
User
Application
ManagedIdentity
Key

CurrentSensitivityLabelSource

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

Значение	Описание
current	текущий

ErrorAdditionalInfo

Объект

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

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

ErrorDetail

Объект

Детали ошибки.

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

ErrorResponse

Объект

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

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

SensitivityLabel

Объект

Метка конфиденциальности.

Имя	Тип	Описание
id	string (arm-id)	Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
managedBy	string	Ресурс, который управляет меткой конфиденциальности.
name	string	Имя ресурса
properties.clientClassificationSource	ClientClassificationSource
properties.columnName	string	Имя столбца.
properties.informationType	string	Тип информации.
properties.informationTypeId	string	Идентификатор типа информации.
properties.isDisabled	boolean	Отключена рекомендация конфиденциальности. Применимо только для рекомендуемой метки конфиденциальности. Указывает, отключена ли рекомендация конфиденциальности для этого столбца (отклонена) или нет.
properties.labelId	string	Идентификатор метки.
properties.labelName	string	Имя метки.
properties.rank	SensitivityLabelRank
properties.schemaName	string	Имя схемы.
properties.tableName	string	Имя таблицы.
systemData	systemData	Azure Resource Manager метаданные, содержащие информацию createdBy и modifiedBy.
type	string	Тип ресурса. Например, «Майкрософт. Compute/virtualMachines» или «Майкрософт. Аккаунты хранения/хранения»

SensitivityLabelRank

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

Значение	Описание
None	Нет
Low	Низкий
Medium	Средняя
High	Высокий
Critical	Критически важно

systemData

Объект

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя	Тип	Описание
createdAt	string (date-time)	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string (date-time)	Временная метка последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.