Sensitivity Labels - Create Or Update

Service:

SQL Database

API Version:

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

Sample Request

HTTP

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

Java

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

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