Sensitivity Labels - Create Or Update

Ссылка

Service:: SQL Database

API Version:: 2021-11-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=2021-11-01

Параметры URI

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

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

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

Ответы

Имя	Тип	Описание
200 OK	SensitivityLabel	Метка конфиденциальности успешно обновлена.
201 Created	SensitivityLabel	Метка конфиденциальности успешно создана.
Other Status Codes		Ответы об ошибках: *** 400 DatawarehouseDatabaseIsDeactivated — не удалось выполнить операцию классификации данных, так как база данных приостановлена. Пожалуйста, возобновите его. 400 SensitivityLabelSourceNameNotSupported — указанный источник метки конфиденциальности недопустим. 400 InvalidSensitivityLabelResource — указанный ресурс метки конфиденциальности недопустим. 400 SensitivityLabelLabelNameAndInfoTypeNotProvided — необходимо указать по крайней мере один параметр LabelName и InformationType. 400 LabelNameTooLong — имя метки не может превышать {0} символы 400 InformationTypeTooLong — тип информации не может превышать {0} символы 400 LabelIdMustBeGuid — указан недопустимый атрибут labelId. Значение должно быть идентификатором GUID 400 InformationTypeIdMustBeGuid — указан недопустимый идентификатор informationTypeId. Значение должно быть идентификатором GUID 400 LabelMissing — требуется метка. Должен быть указан по крайней мере один из 'labelName' или 'labelId' 400 InformationTypeMissing — требуется тип информации. Должен быть указан по крайней мере один из "informationType" или "informationTypeId" 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден. 404 DatabaseDoesNotExist — пользователь указал имя базы данных, которое не существует в этом экземпляре сервера. 404 SensitivityLabelNotFound — не удалось найти указанную метку конфиденциальности. 404 SensitivityLabelsSchemaNotFound — не удалось найти схему {0} 404 SensitivityLabelsTableNotFound — не удалось найти таблицу {0} в схеме {1} 404 SensitivityLabelsColumnNotFound — не удалось найти столбец {0} в таблице {2}.{1} 501 SensitivityLabelRecommendedSourceNameNotSupported — источник меток конфиденциальности "Recommended" пока не поддерживается 501 SensitivityLabelRecommendedSourceNameNotSupported — источник меток конфиденциальности "Recommended" пока не поддерживается

Имя

Тип

Описание

200 OK

SensitivityLabel

Метка конфиденциальности успешно обновлена.

201 Created

SensitivityLabel

Метка конфиденциальности успешно создана.

Other Status Codes

Ответы об ошибках: ***

400 DatawarehouseDatabaseIsDeactivated — не удалось выполнить операцию классификации данных, так как база данных приостановлена. Пожалуйста, возобновите его.
400 SensitivityLabelSourceNameNotSupported — указанный источник метки конфиденциальности недопустим.
400 InvalidSensitivityLabelResource — указанный ресурс метки конфиденциальности недопустим.
400 SensitivityLabelLabelNameAndInfoTypeNotProvided — необходимо указать по крайней мере один параметр LabelName и InformationType.
400 LabelNameTooLong — имя метки не может превышать {0} символы
400 InformationTypeTooLong — тип информации не может превышать {0} символы
400 LabelIdMustBeGuid — указан недопустимый атрибут labelId. Значение должно быть идентификатором GUID
400 InformationTypeIdMustBeGuid — указан недопустимый идентификатор informationTypeId. Значение должно быть идентификатором GUID
400 LabelMissing — требуется метка. Должен быть указан по крайней мере один из 'labelName' или 'labelId'
400 InformationTypeMissing — требуется тип информации. Должен быть указан по крайней мере один из "informationType" или "informationTypeId"
404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден.
404 DatabaseDoesNotExist — пользователь указал имя базы данных, которое не существует в этом экземпляре сервера.
404 SensitivityLabelNotFound — не удалось найти указанную метку конфиденциальности.
404 SensitivityLabelsSchemaNotFound — не удалось найти схему {0}
404 SensitivityLabelsTableNotFound — не удалось найти таблицу {0} в схеме {1}
404 SensitivityLabelsColumnNotFound — не удалось найти столбец {0} в таблице {2}.{1}
501 SensitivityLabelRecommendedSourceNameNotSupported — источник меток конфиденциальности "Recommended" пока не поддерживается
501 SensitivityLabelRecommendedSourceNameNotSupported — источник меток конфиденциальности "Recommended" пока не поддерживается

Примеры

Updates the sensitivity label of a given column with all parameters

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=2021-11-01

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


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.SensitivityLabelInner;
import com.azure.resourcemanager.sql.models.SensitivityLabelRank;

/** Samples for SensitivityLabels CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ColumnSensitivityLabelCreateMax.json
     */
    /**
     * Sample code: Updates the sensitivity label of a given column with all parameters.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updatesTheSensitivityLabelOfAGivenColumnWithAllParameters(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getSensitivityLabels().createOrUpdateWithResponse("myRG",
            "myServer", "myDatabase", "dbo", "myTable", "myColumn",
            new SensitivityLabelInner().withLabelName("PII").withLabelId("bf91e08c-f4f0-478a-b016-25164b2a65ff")
                .withInformationType("PhoneNumber").withInformationTypeId("d22fa6e9-5ee4-3bde-4c2b-a409604c4646")
                .withRank(SensitivityLabelRank.LOW),
            Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

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

Status code:: 201

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

Определения

Имя	Описание
SensitivityLabel	Метка конфиденциальности.
SensitivityLabelRank
WritableSensitivityLabelSource	Источник метки конфиденциальности.

SensitivityLabel

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

Имя	Тип	Описание
id	string	Идентификатор ресурса.
managedBy	string	Ресурс, который управляет меткой конфиденциальности.
name	string	Имя ресурса.
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	Имя таблицы.
type	string	Тип ресурса.

SensitivityLabelRank

Имя	Тип	Описание
Critical	string
High	string
Low	string
Medium	string
None	string

WritableSensitivityLabelSource

Источник метки конфиденциальности.

Имя	Тип	Описание
current	string

Sensitivity Labels - Create Or Update

Параметры URI

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

Ответы

Примеры

Updates the sensitivity label of a given column with all parameters

Sample Request

Sample Response

Определения

SensitivityLabel

SensitivityLabelRank

WritableSensitivityLabelSource

Дополнительные ресурсы