你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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	包含该资源的资源组名称。可以从 Azure 资源管理器 API 或门户获取此值。
schemaName	path	True	string	架构的名称。
sensitivityLabelSource	path	True	WritableSensitivityLabelSource	敏感度标签的源。
serverName	path	True	string	服务器的名称。
subscriptionId	path	True	string	用于标识 Azure 订阅的订阅 ID。
tableName	path	True	string	表的名称。
api-version	query	True	string	要用于请求的 API 版本。

请求正文

名称	类型	说明
properties.informationType	string	信息类型。
properties.informationTypeId	string	信息类型 ID。
properties.labelId	string	标签 ID。
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 SensitivityLabelsLabelNotFound - 找不到指定的敏感度标签 404 SensitivityLabelsSchemaNotFound - 找不到架构{0} 404 SensitivityLabelsTableNotFound - 在架构中找不到表{0}{1} 404 SensitivityLabelsColumnNotFound - 无法在表 {2}中找到列{0}。{1} 501 SensitivityLabelRecommendedSourceNameNotSupported - 尚不支持“推荐”敏感度标签源 501 SensitivityLabelRecommendedSourceNameNotSupported - 尚不支持“推荐”敏感度标签源

名称

类型

说明

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 SensitivityLabelsLabelNotFound - 找不到指定的敏感度标签
404 SensitivityLabelsSchemaNotFound - 找不到架构{0}
404 SensitivityLabelsTableNotFound - 在架构中找不到表{0}{1}
404 SensitivityLabelsColumnNotFound - 无法在表 {2}中找到列{0}。{1}
501 SensitivityLabelRecommendedSourceNameNotSupported - 尚不支持“推荐”敏感度标签源
501 SensitivityLabelRecommendedSourceNameNotSupported - 尚不支持“推荐”敏感度标签源

示例

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	资源 ID。
managedBy	string	管理敏感度标签的资源。
name	string	资源名称。
properties.columnName	string	列名称。
properties.informationType	string	信息类型。
properties.informationTypeId	string	信息类型 ID。
properties.isDisabled	boolean	是否禁用敏感度建议。仅适用于建议的敏感度标签。指定是否禁用此列的敏感度建议 () 消除。
properties.labelId	string	标签 ID。
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

其他资源