Managed Database Sensitivity Labels - Update

Service:

SQL Database

API-versie:

2021-11-01

Vertrouwelijkheidslabels van een bepaalde database bijwerken met behulp van een bewerkingsbatch.

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

URI-parameters

Name	In	Vereist	Type	Description
databaseName	path	True	string	De naam van de database.
managedInstanceName	path	True	string	De naam van het beheerde exemplaar.
resourceGroupName	path	True	string	De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.
subscriptionId	path	True	string	De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
api-version	query	True	string	De API-versie die moet worden gebruikt voor de aanvraag.

Aanvraagbody

Name	Type	Description
operations	SensitivityLabelUpdate[]	Een bewerking voor het bijwerken van vertrouwelijkheidslabels.

Antwoorden

Name	Type	Description
200 OK		Vertrouwelijkheidslabels zijn bijgewerkt.
Other Status Codes		Foutreacties: *** 400 DatawarehouseDatabaseIsDeactivated - Kan de gegevensclassificatiebewerking niet uitvoeren omdat de database is onderbroken. Ga verder. 400 DatawarehouseDatabaseIsDeactivated - Kan de gegevensclassificatiebewerking niet uitvoeren omdat de database is onderbroken. Ga verder. 400 SensitivityLabelSourceNameNotSupported - De opgegeven bron van het vertrouwelijkheidslabel is ongeldig 400 InvalidSensitivityLabelsBatch : de opgegeven batch met vertrouwelijkheidslabels is niet geldig. Geef batchbewerkingen op 400 SensitivityLabelsMissingSchema - Bewerking[{0}]: Ontbrekende schemagegevens 400 SensitivityLabelsMissingTable - Bewerking[{0}]: Ontbrekende tabelgegevens 400 SensitivityLabelsMissingColumn - Bewerking[{0}]: Ontbrekende kolomgegevens 400 SensitivityLabelsUpdateSameColumnMoreThanOnce - De kolom {0} kan niet meer dan één keer worden bijgewerkt in één opdracht 400 InvalidSensitivityLabelResource - De opgegeven resource voor het gevoeligheidslabel is ongeldig 400 SensitivityLabelLabelNameAndInfoTypeNotProvided - Er moet ten minste één labelnaam en informationtype worden opgegeven 400 LabelNameTooLong - Labelnaam mag niet langer zijn dan {0} tekens 400 InformationTypeTooLong - Informatietype mag niet meer dan tekens bevatten {0} 400 LabelIdMustBeGuid - De opgegeven labelId is ongeldig. Waarde moet een GUID zijn 400 InformationTypeIdMustBeGuid - De opgegeven 'informationTypeId' is ongeldig. Waarde moet een GUID zijn 400 LabelMissing - Label is vereist. Er moet ten minste één van 'labelName' of 'labelId' worden opgegeven 400 InformationTypeMissing - Informatietype is vereist. Er moet ten minste één 'informationType' of 'informationTypeId' worden opgegeven 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden 404 DatabaseDoesNotExist - Gebruiker heeft een databasenaam opgegeven die niet bestaat op dit serverexemplaren. 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden 404 DatabaseDoesNotExist - Gebruiker heeft een databasenaam opgegeven die niet bestaat op dit serverexemplaren. 404 SensitivityLabelsLabelNotFound - Het opgegeven vertrouwelijkheidslabel kan niet worden gevonden 404 SensitivityLabelsSchemaNotFound - Het schema {0} kan niet worden gevonden 404 SensitivityLabelsTableNotFound - De tabel {0} kan niet worden gevonden in het schema {1} 404 SensitivityLabelsColumnNotFound - De kolom {0} kan niet worden gevonden in de tabel {2}.{1} 501 SensitivityLabelRecommendedSourceNameNotSupported - 'Aanbevolen' vertrouwelijkheidslabelbron wordt nog niet ondersteund 501 SensitivityLabelRecommendedSourceNameNotSupported - 'Aanbevolen' vertrouwelijkheidslabelbron wordt nog niet ondersteund 503 DatabaseUnavailable - De bewerking is mislukt omdat de database niet beschikbaar is.

Voorbeelden

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

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:

200

Definities

Name	Description
SensitivityLabel	Een vertrouwelijkheidslabel.
SensitivityLabelRank
SensitivityLabelUpdate	Een bewerking voor het bijwerken van vertrouwelijkheidslabels.
SensitivityLabelUpdateKind
SensitivityLabelUpdateList	Een lijst met bewerkingen voor het bijwerken van vertrouwelijkheidslabels.

SensitivityLabel

Een vertrouwelijkheidslabel.

Name	Type	Description
id	string	Resource-id.
managedBy	string	Resource die het vertrouwelijkheidslabel beheert.
name	string	Resourcenaam.
properties.columnName	string	De kolomnaam.
properties.informationType	string	Het informatietype.
properties.informationTypeId	string	De informatietype-id.
properties.isDisabled	boolean	Is gevoeligheidsaanvveling uitgeschakeld. Alleen van toepassing op aanbevolen vertrouwelijkheidslabel. Hiermee geeft u op of de aanbeveling voor vertrouwelijkheid voor deze kolom is uitgeschakeld (gesloten) of niet.
properties.labelId	string	De label-id.
properties.labelName	string	De labelnaam.
properties.rank	SensitivityLabelRank
properties.schemaName	string	De schemanaam.
properties.tableName	string	De tabelnaam.
type	string	Resourcetype.

SensitivityLabelRank

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

SensitivityLabelUpdate

Een bewerking voor het bijwerken van vertrouwelijkheidslabels.

Name	Type	Description
id	string	Resource-id.
name	string	Resourcenaam.
properties.column	string	Bij te werken kolomnaam.
properties.op	SensitivityLabelUpdateKind
properties.schema	string	Schemanaam van de kolom die moet worden bijgewerkt.
properties.sensitivityLabel	SensitivityLabel	De vertrouwelijkheidslabelinformatie die moet worden toegepast op een kolom.
properties.table	string	Tabelnaam van de kolom die moet worden bijgewerkt.
type	string	Resourcetype.

SensitivityLabelUpdateKind

Name	Type	Description
remove	string
set	string

SensitivityLabelUpdateList

Een lijst met bewerkingen voor het bijwerken van vertrouwelijkheidslabels.

Name	Type	Description
operations	SensitivityLabelUpdate[]	Een bewerking voor het bijwerken van vertrouwelijkheidslabels.