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 參數

名稱	位於	必要	類型	Description
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 訂用帳戶的訂用帳戶識別碼。
tableName	path	True	string	資料表的名稱。
api-version	query	True	string	要用於要求的 API 版本。

要求本文

名稱	類型	Description
properties.informationType	string	信息類型。
properties.informationTypeId	string	資訊類型標識碼。
properties.labelId	string	標籤識別碼。
properties.labelName	string	標籤名稱。
properties.rank	SensitivityLabelRank

回應

名稱	類型	Description
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 - 尚未支援「建議」敏感度卷標來源

名稱

類型

Description

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

定義

名稱	Description
SensitivityLabel	敏感度標籤。
SensitivityLabelRank
WritableSensitivityLabelSource	敏感度標籤的來源。

SensitivityLabel

敏感度標籤。

名稱	類型	Description
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

名稱	類型	Description
Critical	string
High	string
Low	string
Medium	string
None	string

WritableSensitivityLabelSource

敏感度標籤的來源。

名稱	類型	Description
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

其他資源