Sensitivity Labels - Update

Služba:

SQL Database

Verze rozhraní API:

2021-11-01

Aktualizujte popisky citlivosti dané databáze pomocí dávky operací.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
databaseName	path	True	string	Název databáze.
resourceGroupName	path	True	string	Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API azure Resource Manager nebo z portálu.
serverName	path	True	string	Název serveru.
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.

Text požadavku

Name	Typ	Description
operations	SensitivityLabelUpdate[]	Operace aktualizace popisku citlivosti

Odpovědi

Name	Typ	Description
200 OK		Popisky citlivosti se úspěšně aktualizovaly.
Other Status Codes		Chybové odpovědi: *** 400 DatawarehouseDatabaseIsDeactivated – Nelze spustit operaci klasifikace dat, protože databáze je pozastavená. Prosím, pokračujte v tom. 400 DatawarehouseDatabaseIsDeactivated – Nelze spustit operaci klasifikace dat, protože databáze je pozastavená. Prosím, pokračujte v tom. 400 SensitivityLabelSourceNameNotSupported – zadaný zdroj popisků citlivosti není platný. 400 InvalidSensitivityLabelsBatch – zadaná dávka popisků citlivosti není platná. Zadejte dávkové operace. 400 CitlivostLabelsMissingSchema – operace[{0}]: Chybějící informace o schématu 400 SensitivityLabelsMissingTable – Operace[{0}]: Chybějící informace o tabulce 400 SensitivityLabelsMissingColumn – Operace[{0}]: Chybějící informace o sloupci 400 SensitivityLabelsUpdateSameColumnMoreThanOnce – sloupec {0} nelze aktualizovat více než jednou jedním příkazem. 400 InvalidSensitivityLabelResource – zadaný prostředek popisku citlivosti není platný. 400 SensitivityLabelLabelNameAndInfoTypeNotProvided – Musí být zadána alespoň jedna z vlastností LabelName a InformationType. 400 LabelNameTooLong – název popisku nesmí překročit {0} znaky. 400 InformationTypeTooLong – Typ informace nesmí překročit {0} znaky. 400 LabelIdMustBeGuid – zadaný identifikátor labelId je neplatný. Hodnota musí být GUID. 400 InformationTypeIdMustBeGuid – zadaný parametr informationTypeId je neplatný. Hodnota musí být GUID. 400 LabelMissing – Popisek je povinný. Musí být uvedena alespoň jedna z hodnot "labelName" nebo "labelId". 400 InformationTypeMissing – typ informace je povinný. Musí být uvedena alespoň jedna z 'informationType' nebo 'informationTypeId'. 404 SubscriptionDoesNotHaveServer – požadovaný server nebyl nalezen. 404 DatabaseDoesNotExist – Uživatel zadal název databáze, který na této instanci serveru neexistuje. 404 SubscriptionDoesNotHaveServer – požadovaný server nebyl nalezen. 404 DatabaseDoesNotExist – Uživatel zadal název databáze, který na této instanci serveru neexistuje. 404 CitlivostLabelsLabelNotFound – Zadaný popisek citlivosti nebyl nalezen. 404 SensitivityLabelsSchemaNotFound – schéma {0} nebylo nalezeno. 404 SensitivityLabelsTableNotFound – Tabulka {0} nebyla nalezena ve schématu. {1} 404 CitlivostLabelsColumnNotFound – sloupec {0} nebyl nalezen v tabulce {2}.{1} 501 SensitivityLabelRecommendedSourceNameNotSupported – doporučený zdroj popisků citlivosti se zatím nepodporuje. 501 SensitivityLabelRecommendedSourceNameNotSupported – doporučený zdroj popisků citlivosti se zatím nepodporuje. 503 DatabaseUnavailable – operace selhala, protože databáze není k dispozici.

Příklady

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

Ukázkový požadavek

HTTP

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/myServer/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",
            "rank": "Low"
          }
        }
      }
    },
    {
      "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",
            "rank": "Critical"
          }
        }
      }
    },
    {
      "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.SensitivityLabelRank;
import com.azure.resourcemanager.sql.models.SensitivityLabelUpdateKind;
import com.azure.resourcemanager.sql.models.SensitivityLabelUpdateList;
import java.util.Arrays;

/** Samples for SensitivityLabels Update. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/SensitivityLabelsCurrentUpdate.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().getSensitivityLabels().updateWithResponse("myRG", "myServer",
            "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").withRank(SensitivityLabelRank.LOW)),
                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")
                        .withRank(SensitivityLabelRank.CRITICAL)),
                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

Ukázková odpověď

Stavový kód:

200

Definice

Name	Description
SensitivityLabel	Popisek citlivosti.
SensitivityLabelRank
SensitivityLabelUpdate	Operace aktualizace popisku citlivosti
SensitivityLabelUpdateKind
SensitivityLabelUpdateList	Seznam operací aktualizace popisků citlivosti.

SensitivityLabel

Popisek citlivosti.

Name	Typ	Description
id	string	ID prostředku.
managedBy	string	Prostředek, který spravuje popisek citlivosti.
name	string	Název prostředku.
properties.columnName	string	Název sloupce.
properties.informationType	string	Typ informací.
properties.informationTypeId	string	ID typu informací.
properties.isDisabled	boolean	Je doporučení citlivosti zakázané. Platí jenom pro doporučený popisek citlivosti. Určuje, jestli je doporučení citlivosti pro tento sloupec zakázané (zavřené) nebo ne.
properties.labelId	string	ID popisku.
properties.labelName	string	Název popisku.
properties.rank	SensitivityLabelRank
properties.schemaName	string	Název schématu.
properties.tableName	string	Název tabulky.
type	string	Typ prostředku.

SensitivityLabelRank

Name	Typ	Description
Critical	string
High	string
Low	string
Medium	string
None	string

SensitivityLabelUpdate

Operace aktualizace popisku citlivosti

Name	Typ	Description
id	string	ID prostředku.
name	string	Název prostředku.
properties.column	string	Název sloupce, který se má aktualizovat.
properties.op	SensitivityLabelUpdateKind
properties.schema	string	Název schématu sloupce, který se má aktualizovat.
properties.sensitivityLabel	SensitivityLabel	Informace popisku citlivosti, které se mají použít u sloupce.
properties.table	string	Název tabulky sloupce, který se má aktualizovat.
type	string	Typ prostředku.

SensitivityLabelUpdateKind

Name	Typ	Description
remove	string
set	string

SensitivityLabelUpdateList

Seznam operací aktualizace popisků citlivosti.

Name	Typ	Description
operations	SensitivityLabelUpdate[]	Operace aktualizace popisku citlivosti