Sensitivity Labels - Create Or Update

  • Başvuru
Hizmet:
SQL Database
API Sürümü:
2021-11-01

Belirli bir sütunun duyarlılık etiketini oluşturur veya güncelleştirir

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 Parametreleri

Name İçinde Gerekli Tür Description
columnName
 path True

string

Sütunun adı.
databaseName
 path True

string

Veritabanının adı.
resourceGroupName
 path True

string

Kaynağı içeren kaynak grubunun adı. Bu değeri Azure Resource Manager API'sinden veya portaldan alabilirsiniz.
schemaName
 path True

string

Şemanın adı.
sensitivityLabelSource
 path True

WritableSensitivityLabelSource

Duyarlılık etiketinin kaynağı.
serverName
 path True

string

Sunucunun adı.
subscriptionId
 path True

string

Azure aboneliğini tanımlayan abonelik kimliği.
tableName
 path True

string

Tablonun adı.
api-version
 query True

string

İstek için kullanılacak API sürümü.

İstek Gövdesi

Name Tür Description
properties.informationType

string

Bilgi türü.
properties.informationTypeId

string

Bilgi türü kimliği.
properties.labelId

string

Etiket kimliği.
properties.labelName

string

Etiket adı.
properties.rank

SensitivityLabelRank

Yanıtlar

Name Tür Description
200 OK

SensitivityLabel

Duyarlılık etiketi başarıyla güncelleştirildi.
201 Created

SensitivityLabel

Duyarlılık etiketi başarıyla oluşturuldu.
Other Status Codes

Hata Yanıtları: **

  • 400 DatawarehouseDatabaseIsDeactivated - Veritabanı duraklatıldığı için Veri Sınıflandırma işlemi yürütülemedi. Lütfen devam edin.

  • 400 SensitivityLabelSourceNameNotSupported - Belirtilen duyarlılık etiketi kaynağı geçerli değil

  • 400 InvalidSensitivityLabelResource - Belirtilen duyarlılık etiketi kaynağı geçerli değil

  • 400 SensitivityLabelLabelNameAndInfoTypeNotProvided - LabelName ve InformationType'ın en az biri belirtilmelidir

  • 400 LabelNameTooLong - Etiket adı karakterden uzun {0} olamaz

  • 400 InformationTypeTooLong - Bilgi türü karakterleri aşamaz {0}

  • 400 LabelIdMustBeGuid - Sağlanan 'labelId' geçersiz. Değer GUID olmalıdır

  • 400 InformationTypeIdMustBeGuid - Sağlanan 'informationTypeId' geçersiz. Değer GUID olmalıdır

  • 400 LabelMissing - Etiket gereklidir. En az bir 'labelName' veya 'labelId' sağlanmalıdır

  • 400 InformationTypeMissing - Bilgi türü gereklidir. En az bir 'informationType' veya 'informationTypeId' sağlanmalıdır

  • 404 SubscriptionDoesNotHaveServer - İstenen sunucu bulunamadı

  • 404 DatabaseDoesNotExist - Kullanıcı bu sunucu örneğinde bulunmayan bir veritabanı adı belirtti.

  • 404 SensitivityLabelsLabelNotFound - Belirtilen duyarlılık etiketi bulunamadı

  • 404 SensitivityLabelsSchemaNotFound - Şema {0} bulunamadı

  • 404 SensitivityLabelsTableNotFound - Tablo {0} şemada bulunamadı {1}

  • 404 SensitivityLabelsColumnNotFound - Sütun {0} tablosunda {2}bulunamadı.{1}

  • 501 SensitivityLabelRecommendedSourceNameNotSupported - 'Önerilen' duyarlılık etiketi kaynağı henüz desteklenmiyor

  • 501 SensitivityLabelRecommendedSourceNameNotSupported - 'Önerilen' duyarlılık etiketi kaynağı henüz desteklenmiyor

Örnekler

Updates the sensitivity label of a given column with all parameters

Örnek isteği

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

Örnek yanıt

Durum kodu:
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"
  }
}
Durum kodu:
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"
  }
}

Tanımlar

Name Description
SensitivityLabel

Duyarlılık etiketi.
SensitivityLabelRank
WritableSensitivityLabelSource

Duyarlılık etiketinin kaynağı.

SensitivityLabel

Duyarlılık etiketi.

Name Tür Description
id

string

Kaynak Kimliği.
managedBy

string

Duyarlılık etiketini yöneten kaynak.
name

string

Kaynak adı.
properties.columnName

string

Sütun adı.
properties.informationType

string

Bilgi türü.
properties.informationTypeId

string

Bilgi türü kimliği.
properties.isDisabled

boolean

Duyarlılık önerisi devre dışı bırakıldı. Yalnızca önerilen duyarlılık etiketi için geçerlidir. Bu sütundaki duyarlılık önerisinin devre dışı bırakılıp bırakılmayacağını (kapatılıp kapatılmayacağını) belirtir.
properties.labelId

string

Etiket kimliği.
properties.labelName

string

Etiket adı.
properties.rank

SensitivityLabelRank

properties.schemaName

string

Şema adı.
properties.tableName

string

Tablo adı.
type

string

Kaynak türü.

SensitivityLabelRank

Name Tür Description
Critical

string

High

string

Low

string

Medium

string

None

string

WritableSensitivityLabelSource

Duyarlılık etiketinin kaynağı.

Name Tür Description
current

string