Managed Database Sensitivity Labels - Update

Service:

SQL Database

API Version:

2021-11-01

Perbarui label sensitivitas database tertentu menggunakan batch operasi.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
databaseName	path	True	string	Nama database.
managedInstanceName	path	True	string	Nama instans terkelola.
resourceGroupName	path	True	string	Nama grup sumber daya yang berisi sumber daya. Anda dapat memperoleh nilai ini dari Azure Resource Manager API atau portal.
subscriptionId	path	True	string	ID langganan yang mengidentifikasi langganan Azure.
api-version	query	True	string	Versi API yang digunakan untuk permintaan.

Isi Permintaan

Nama	Jenis	Deskripsi
operations	SensitivityLabelUpdate[]	Operasi pembaruan label sensitivitas.

Respons

Nama	Jenis	Deskripsi
200 OK		Label sensitivitas berhasil diperbarui.
Other Status Codes		Respons Kesalahan: *** 400 DatawarehouseDatabaseIsDeactivated - Tidak dapat menjalankan operasi Klasifikasi Data karena database dijeda. Silakan lanjutkan. 400 DatawarehouseDatabaseIsDeactivated - Tidak dapat menjalankan operasi Klasifikasi Data karena database dijeda. Silakan lanjutkan. 400 SensitivityLabelSourceNameNotSupported - Sumber label sensitivitas yang ditentukan tidak valid 400 InvalidSensitivityLabelsBatch - Batch label sensitivitas yang ditentukan tidak valid. Harap sediakan operasi batch 400 SensitivityLabelsMissingSchema - Operation[{0}]: Informasi skema yang hilang 400 SensitivityLabelsMissingTable - Operation[{0}]: Informasi tabel hilang 400 SensitivityLabelsMissingColumn - Operation[{0}]: Informasi kolom yang hilang 400 SensitivityLabelsUpdateSameColumnMoreThanOnce - Kolom {0} tidak dapat diperbarui lebih dari sekali dalam satu perintah 400 InvalidSensitivityLabelResource - Sumber daya label sensitivitas yang ditentukan tidak valid 400 SensitivityLabelLabelNameAndInfoTypeNotProvided - Setidaknya salah satu LabelName dan InformationType harus ditentukan 400 LabelNameTooLong - Nama label tidak boleh melebihi {0} karakter 400 InformationTypeTooLong - Tipe informasi tidak boleh melebihi {0} karakter 400 LabelIdMustBeGuid - 'labelId' yang disediakan tidak valid. Nilai harus berupa GUID 400 InformationTypeIdMustBeGuid - 'informationTypeId' yang disediakan tidak valid. Nilai harus berupa GUID 400 LabelMissing - Label diperlukan. Setidaknya salah satu dari 'labelName' atau 'labelId' harus disediakan 400 InformationTypeMissing - Jenis informasi diperlukan. Setidaknya salah satu dari 'informationType' atau 'informationTypeId' harus disediakan 404 SubscriptionDoesNotHaveServer - Server yang diminta tidak ditemukan 404 DatabaseDoesNotExist - Pengguna telah menentukan nama database yang tidak ada pada instans server ini. 404 SubscriptionDoesNotHaveServer - Server yang diminta tidak ditemukan 404 DatabaseDoesNotExist - Pengguna telah menentukan nama database yang tidak ada pada instans server ini. 404 SensitivityLabelsLabelNotFound - Label sensitivitas yang ditentukan tidak dapat ditemukan 404 SensitivityLabelsSchemaNotFound - Skema {0} tidak dapat ditemukan 404 SensitivityLabelsTableNotFound - Tabel {0} tidak dapat ditemukan dalam skema {1} 404 SensitivityLabelsColumnNotFound - Kolom {0} tidak dapat ditemukan dalam tabel {2}.{1} 501 SensitivityLabelRecommendedSourceNameNotSupported - Sumber label sensitivitas 'Disarankan' belum didukung 501 SensitivityLabelRecommendedSourceNameNotSupported - Sumber label sensitivitas 'Disarankan' belum didukung 503 DatabaseUnavailable - Operasi gagal karena database tidak tersedia.

Contoh

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

Definisi

Nama	Deskripsi
SensitivityLabel	Label sensitivitas.
SensitivityLabelRank
SensitivityLabelUpdate	Operasi pembaruan label sensitivitas.
SensitivityLabelUpdateKind
SensitivityLabelUpdateList	Daftar operasi pembaruan label sensitivitas.

SensitivityLabel

Label sensitivitas.

Nama	Jenis	Deskripsi
id	string	ID Sumber Daya.
managedBy	string	Sumber daya yang mengelola label sensitivitas.
name	string	Nama sumber daya.
properties.columnName	string	Nama kolom.
properties.informationType	string	Jenis informasi.
properties.informationTypeId	string	ID jenis informasi.
properties.isDisabled	boolean	Apakah rekomendasi sensitivitas dinonaktifkan. Hanya berlaku untuk label sensitivitas yang direkomendasikan. Menentukan apakah rekomendasi sensitivitas pada kolom ini dinonaktifkan (ditutup) atau tidak.
properties.labelId	string	ID label.
properties.labelName	string	Nama label.
properties.rank	SensitivityLabelRank
properties.schemaName	string	Nama skema.
properties.tableName	string	Nama tabel.
type	string	Jenis sumber daya

SensitivityLabelRank

Nama	Jenis	Deskripsi
Critical	string
High	string
Low	string
Medium	string
None	string

SensitivityLabelUpdate

Operasi pembaruan label sensitivitas.

Nama	Jenis	Deskripsi
id	string	ID Sumber Daya.
name	string	Nama sumber daya.
properties.column	string	Nama kolom yang akan diperbarui.
properties.op	SensitivityLabelUpdateKind
properties.schema	string	Nama skema kolom yang akan diperbarui.
properties.sensitivityLabel	SensitivityLabel	Informasi label sensitivitas untuk diterapkan pada kolom.
properties.table	string	Nama tabel kolom yang akan diperbarui.
type	string	Jenis sumber daya

SensitivityLabelUpdateKind

Nama	Jenis	Deskripsi
remove	string
set	string

SensitivityLabelUpdateList

Daftar operasi pembaruan label sensitivitas.

Nama	Jenis	Deskripsi
operations	SensitivityLabelUpdate[]	Operasi pembaruan label sensitivitas.