共用方式為


Sensitivity Labels - Create Or Update

建立或更新指定數據行的敏感度標籤

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

範例

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

範例回覆

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