Managed Database Sensitivity Labels - Update

Service:

SQL Database

API Version:

2021-11-01

İşlem toplu işlemini kullanarak belirli bir veritabanının duyarlılık etiketlerini güncelleştirin.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/currentSensitivityLabels?api-version=2021-11-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
databaseName	path	True	string	Veritabanının adı.
managedInstanceName	path	True	string	Yönetilen örneğin adı.
resourceGroupName	path	True	string	Kaynağı içeren kaynak grubunun adı. Bu değeri Azure Resource Manager API'sinden veya portaldan alabilirsiniz.
subscriptionId	path	True	string	Azure aboneliğini tanımlayan abonelik kimliği.
api-version	query	True	string	İstek için kullanılacak API sürümü.

İstek Gövdesi

Name	Tür	Description
operations	SensitivityLabelUpdate[]	Duyarlılık etiketi güncelleştirme işlemi.

Yanıtlar

Name	Tür	Description
200 OK		Duyarlılık etiketleri başarıyla güncelleştirildi.
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 ettirin. 400 DatawarehouseDatabaseIsDeactivated - Veritabanı duraklatıldığı için Veri Sınıflandırma işlemi yürütülemedi. Lütfen devam ettirin. 400 SensitivityLabelSourceNameNotSupported - Belirtilen duyarlılık etiketi kaynağı geçerli değil 400 InvalidSensitivityLabelsBatch - Belirtilen duyarlılık etiketleri toplu işlemi geçerli değil. Lütfen toplu işlemleri sağlayın 400 SensitivityLabelsMissingSchema - Operation[{0}]: Eksik şema bilgileri 400 SensitivityLabelsMissingTable - operation[{0}]: Eksik tablo bilgileri 400 SensitivityLabelsMissingColumn - operation[{0}]: Eksik sütun bilgileri 400 SensitivityLabelsUpdateSameColumnMoreThanOnce - Sütun {0} tek bir komutta birden çok kez güncelleştirilemez 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ı karakterleri aşamaz {0} 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 var olmayan bir veritabanı adı belirtti. 404 SubscriptionDoesNotHaveServer - İstenen sunucu bulunamadı 404 DatabaseDoesNotExist - Kullanıcı bu sunucu örneğinde var olmayan 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 503 DatabaseUnavailable - Veritabanı kullanılamadığından işlem başarısız oldu.

Örnekler

Update sensitivity labels of a given database using an operations batch.

Sample Request

HTTP

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/managedInstances/myManagedInstanceName/databases/myDatabase/currentSensitivityLabels?api-version=2021-11-01

{
  "operations": [
    {
      "properties": {
        "op": "set",
        "schema": "dbo",
        "table": "table1",
        "column": "column1",
        "sensitivityLabel": {
          "properties": {
            "labelName": "Highly Confidential",
            "labelId": "3A477B16-9423-432B-AA97-6069B481CEC3",
            "informationType": "Financial",
            "informationTypeId": "1D3652D6-422C-4115-82F1-65DAEBC665C8"
          }
        }
      }
    },
    {
      "properties": {
        "op": "set",
        "schema": "dbo",
        "table": "table2",
        "column": "column2",
        "sensitivityLabel": {
          "properties": {
            "informationType": "PhoneNumber",
            "informationTypeId": "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
            "labelId": "bf91e08c-f4f0-478a-b016-25164b2a65ff",
            "labelName": "PII"
          }
        }
      }
    },
    {
      "properties": {
        "op": "remove",
        "schema": "dbo",
        "table": "Table1",
        "column": "Column3"
      }
    }
  ]
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.SensitivityLabelInner;
import com.azure.resourcemanager.sql.fluent.models.SensitivityLabelUpdateInner;
import com.azure.resourcemanager.sql.models.SensitivityLabelUpdateKind;
import com.azure.resourcemanager.sql.models.SensitivityLabelUpdateList;
import java.util.Arrays;

/** Samples for ManagedDatabaseSensitivityLabels Update. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedDatabaseSensitivityLabelsCurrentUpdate.json
     */
    /**
     * Sample code: Update sensitivity labels of a given database using an operations batch.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateSensitivityLabelsOfAGivenDatabaseUsingAnOperationsBatch(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabaseSensitivityLabels().updateWithResponse("myRG",
            "myManagedInstanceName", "myDatabase",
            new SensitivityLabelUpdateList().withOperations(Arrays.asList(
                new SensitivityLabelUpdateInner().withOp(SensitivityLabelUpdateKind.SET).withSchema("dbo")
                    .withTable("table1").withColumn("column1")
                    .withSensitivityLabel(new SensitivityLabelInner().withLabelName("Highly Confidential")
                        .withLabelId("3A477B16-9423-432B-AA97-6069B481CEC3").withInformationType("Financial")
                        .withInformationTypeId("1D3652D6-422C-4115-82F1-65DAEBC665C8")),
                new SensitivityLabelUpdateInner().withOp(SensitivityLabelUpdateKind.SET).withSchema("dbo")
                    .withTable("table2").withColumn("column2")
                    .withSensitivityLabel(new SensitivityLabelInner().withLabelName("PII")
                        .withLabelId("bf91e08c-f4f0-478a-b016-25164b2a65ff").withInformationType("PhoneNumber")
                        .withInformationTypeId("d22fa6e9-5ee4-3bde-4c2b-a409604c4646")),
                new SensitivityLabelUpdateInner().withOp(SensitivityLabelUpdateKind.REMOVE).withSchema("dbo")
                    .withTable("Table1").withColumn("Column3"))),
            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

Tanımlar

Name	Description
SensitivityLabel	Duyarlılık etiketi.
SensitivityLabelRank
SensitivityLabelUpdate	Duyarlılık etiketi güncelleştirme işlemi.
SensitivityLabelUpdateKind
SensitivityLabelUpdateList	Duyarlılık etiketi güncelleştirme işlemlerinin listesi.

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ı mı? 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

SensitivityLabelUpdate

Duyarlılık etiketi güncelleştirme işlemi.

Name	Tür	Description
id	string	Kaynak Kimliği.
name	string	Kaynak adı.
properties.column	string	Güncelleştirilecek sütun adı.
properties.op	SensitivityLabelUpdateKind
properties.schema	string	Güncelleştirilecek sütunun şema adı.
properties.sensitivityLabel	SensitivityLabel	Bir sütuna uygulanacak duyarlılık etiketi bilgileri.
properties.table	string	Güncelleştirilecek sütunun tablo adı.
type	string	Kaynak türü.

SensitivityLabelUpdateKind

Name	Tür	Description
remove	string
set	string

SensitivityLabelUpdateList

Duyarlılık etiketi güncelleştirme işlemlerinin listesi.

Name	Tür	Description
operations	SensitivityLabelUpdate[]	Duyarlılık etiketi güncelleştirme işlemi.