Managed Database Sensitivity Labels - Create Or Update

Service:

SQL Database

API Version:

2021-11-01

Membuat atau memperbarui label sensitivitas kolom tertentu

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/schemas/{schemaName}/tables/{tableName}/columns/{columnName}/sensitivityLabels/current?api-version=2021-11-01

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
columnName	path	True	string	Nama kolom.
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.
schemaName	path	True	string	Nama skema.
sensitivityLabelSource	path	True	WritableSensitivityLabelSource	Sumber label sensitivitas.
subscriptionId	path	True	string	ID langganan yang mengidentifikasi langganan Azure.
tableName	path	True	string	Nama tabel.
api-version	query	True	string	Versi API yang digunakan untuk permintaan.

Isi Permintaan

Nama	Jenis	Deskripsi
properties.informationType	string	Jenis informasi.
properties.informationTypeId	string	ID jenis informasi.
properties.labelId	string	ID label.
properties.labelName	string	Nama label.
properties.rank	SensitivityLabelRank

Respons

Nama	Jenis	Deskripsi
200 OK	SensitivityLabel	Berhasil memperbarui label sensitivitas.
201 Created	SensitivityLabel	Berhasil membuat label sensitivitas.
Other Status Codes		Respons Kesalahan: *** 400 DatawarehouseDatabaseIsDeactivated - Tidak dapat menjalankan operasi Klasifikasi Data karena database dijeda. Silakan lanjutkan. 400 SensitivityLabelSourceNameNotSupported - Sumber label sensitivitas yang ditentukan tidak valid 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 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

Contoh

Updates or creates a sensitivity label of a given column with all parameters in a managed database

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/managedInstances/myManagedInstanceName/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": "High"
  }
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.SensitivityLabelInner;
import com.azure.resourcemanager.sql.models.SensitivityLabelRank;

/** Samples for ManagedDatabaseSensitivityLabels CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedDatabaseColumnSensitivityLabelCreate.json
     */
    /**
     * Sample code: Updates or creates a sensitivity label of a given column with all parameters in a managed database.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updatesOrCreatesASensitivityLabelOfAGivenColumnWithAllParametersInAManagedDatabase(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabaseSensitivityLabels().createOrUpdateWithResponse(
            "myRG", "myManagedInstanceName", "myDatabase", "dbo", "myTable", "myColumn",
            new SensitivityLabelInner().withLabelName("PII").withLabelId("bf91e08c-f4f0-478a-b016-25164b2a65ff")
                .withInformationType("PhoneNumber").withInformationTypeId("d22fa6e9-5ee4-3bde-4c2b-a409604c4646")
                .withRank(SensitivityLabelRank.HIGH),
            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/managedInstances/myManagedInstanceName/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn/sensitivityLabels/current",
  "name": "current",
  "type": "Microsoft.Sql/managedInstances/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": "High"
  }
}

Status code:

201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/managedInstances/myManagedInstanceName/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn/sensitivityLabels/current",
  "name": "current",
  "type": "Microsoft.Sql/managedInstances/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": "High"
  }
}

Definisi

Nama	Deskripsi
SensitivityLabel	Label sensitivitas.
SensitivityLabelRank
WritableSensitivityLabelSource	Sumber 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

WritableSensitivityLabelSource

Sumber label sensitivitas.

Nama	Jenis	Deskripsi
current	string