Sensitivity Labels - Update

Tjänst:

SQL Database

API-version:

2021-11-01

Uppdatera känslighetsetiketter för en viss databas med hjälp av en driftbatch.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
databaseName	path	True	string	Namnet på databasen.
resourceGroupName	path	True	string	Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.
serverName	path	True	string	Namnet på servern.
subscriptionId	path	True	string	Det prenumerations-ID som identifierar en Azure-prenumeration.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Begärandetext

Name	Typ	Description
operations	SensitivityLabelUpdate[]	En uppdateringsåtgärd för känslighetsetiketter.

Svar

Name	Typ	Description
200 OK		Känslighetsetiketterna har uppdaterats.
Other Status Codes		Felsvar: *** 400 DatawarehouseDatabaseIsDeactivated – Det gick inte att köra dataklassificeringsåtgärden eftersom databasen har pausats. Återuppta den. 400 DatawarehouseDatabaseIsDeactivated – Det gick inte att köra dataklassificeringsåtgärden eftersom databasen har pausats. Återuppta den. 400 SensitivityLabelSourceNameNotSupported – den angivna källan för känslighetsetiketter är inte giltig 400 InvalidSensitivityLabelsBatch – den angivna batchen för känslighetsetiketter är inte giltig. Ange batchåtgärder 400 SensitivityLabelsMissingSchema – Åtgärd[{0}]: Schemainformation saknas 400 SensitivityLabelsMissingTable – Åtgärd[{0}]: Tabellinformation saknas 400 SensitivityLabelsMissingColumn – Operation[{0}]: Kolumninformation saknas 400 SensitivityLabelsUpdateSameColumnMoreThanOnce – Kolumnen {0} kan inte uppdateras mer än en gång i ett enda kommando 400 InvalidSensitivityLabelResource – den angivna resursen för känslighetsetiketter är inte giltig 400 SensitivityLabelLabelNameAndInfoTypeNotProvided – Minst ett av LabelName och InformationType måste anges 400 LabelNameTooLong – Etikettnamnet får inte överskrida {0} tecken 400 InformationTypeTooLong – Informationstypen får inte överskrida {0} tecken 400 LabelIdMustBeGuid – det angivna "labelId" är ogiltigt. Värdet måste vara ett GUID 400 InformationTypeIdMustBeGuid – det angivna "informationTypeId" är ogiltigt. Värdet måste vara ett GUID 400 LabelMissing – Etikett krävs. Minst ett av "labelName" eller "labelId" måste anges 400 InformationTypeMissing – Informationstyp krävs. Minst en av "informationType" eller "informationTypeId" måste anges 404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte 404 DatabaseDoesNotExist – Användaren har angett ett databasnamn som inte finns på den här serverinstansen. 404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte 404 DatabaseDoesNotExist – Användaren har angett ett databasnamn som inte finns på den här serverinstansen. 404 SensitivityLabelsLabelNotFound – Det gick inte att hitta den angivna känslighetsetiketten 404 SensitivityLabelsSchemaNotFound – Det gick inte att hitta schemat {0} 404 SensitivityLabelsTableNotFound – Det gick inte att hitta tabellen {0} i schemat {1} 404 SensitivityLabelsColumnNotFound – Det gick inte att hitta kolumnen {0} i tabellen {2}.{1} 501 SensitivityLabelRecommendedSourceNameNotSupported – källa för rekommenderade känslighetsetiketter stöds inte ännu 501 SensitivityLabelRecommendedSourceNameNotSupported – källa för rekommenderade känslighetsetiketter stöds inte ännu 503 DatabaseUnavailable – Åtgärden misslyckades eftersom databasen inte är tillgänglig.

Exempel

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

Exempelbegäran

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

Exempelsvar

Statuskod:

200

Definitioner

Name	Description
SensitivityLabel	En känslighetsetikett.
SensitivityLabelRank
SensitivityLabelUpdate	En uppdateringsåtgärd för känslighetsetiketter.
SensitivityLabelUpdateKind
SensitivityLabelUpdateList	En lista över åtgärder för uppdatering av känslighetsetiketter.

SensitivityLabel

En känslighetsetikett.

Name	Typ	Description
id	string	Resurs-ID.
managedBy	string	Resurs som hanterar känslighetsetiketten.
name	string	Resursnamn.
properties.columnName	string	Kolumnnamnet.
properties.informationType	string	Informationstypen.
properties.informationTypeId	string	Informationstypens ID.
properties.isDisabled	boolean	Är känslighetsrekommendations inaktiverad. Gäller endast för rekommenderad känslighetsetikett. Anger om känslighetsrekommendationsen för den här kolumnen är inaktiverad (avvisad) eller inte.
properties.labelId	string	Etikett-ID.
properties.labelName	string	Etikettnamnet.
properties.rank	SensitivityLabelRank
properties.schemaName	string	Schemanamnet.
properties.tableName	string	Tabellnamnet.
type	string	Resurstyp.

SensitivityLabelRank

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

SensitivityLabelUpdate

En uppdateringsåtgärd för känslighetsetiketter.

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.column	string	Kolumnnamn som ska uppdateras.
properties.op	SensitivityLabelUpdateKind
properties.schema	string	Schemanamn för den kolumn som ska uppdateras.
properties.sensitivityLabel	SensitivityLabel	Information om känslighetsetiketter som ska tillämpas på en kolumn.
properties.table	string	Tabellnamn för den kolumn som ska uppdateras.
type	string	Resurstyp.

SensitivityLabelUpdateKind

Name	Typ	Description
remove	string
set	string

SensitivityLabelUpdateList

En lista över åtgärder för uppdatering av känslighetsetiketter.

Name	Typ	Description
operations	SensitivityLabelUpdate[]	En uppdateringsåtgärd för känslighetsetiketter.