Managed Database Sensitivity Labels - Update

Dienst:: SQL Database

API-Version:: 2023-08-01

Aktualisieren Sie Vertraulichkeitsbezeichnungen einer bestimmten Datenbank mithilfe eines Vorgangsbatches.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
databaseName	path	True	string	Der Name der Datenbank.
managedInstanceName	path	True	string	Der Name der verwalteten Instanz.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Sie können diesen Wert aus der Azure Resource Manager-API oder dem Portal abrufen.
subscriptionId	path	True	string	Die Abonnement-ID, die ein Azure-Abonnement identifiziert.
api-version	query	True	string	Die API-Version, die für die Anforderung verwendet werden soll.

Anforderungstext

Name	Typ	Beschreibung
operations	SensitivityLabelUpdate[]	Ein Aktualisierungsvorgang für Vertraulichkeitsbezeichnungen.

Antworten

Name	Typ	Beschreibung
200 OK		Vertraulichkeitsbezeichnungen wurden erfolgreich aktualisiert.
Other Status Codes	ErrorResponse	Fehlerantworten: *** 400 DatawarehouseDatabaseIsDeactivated – Der Datenklassifizierungsvorgang konnte nicht ausgeführt werden, da die Datenbank angehalten wurde. Bitte setzen Sie sie fort. 400 DatawarehouseDatabaseIsDeactivated – Der Datenklassifizierungsvorgang konnte nicht ausgeführt werden, da die Datenbank angehalten wurde. Bitte setzen Sie sie fort. 400 SensitivityLabelSourceNameNotSupported – Die angegebene Vertraulichkeitsbezeichnungsquelle ist ungültig. 400 InvalidSensitivityLabelsBatch – Der angegebene Vertraulichkeitsbezeichnungsbatch ist ungültig. Geben Sie Batchvorgänge an 400 SensitivityLabelsMissingSchema - Operation[{0}]: Fehlende Schemainformationen 400 SensitivityLabelsMissingTable - Operation[{0}]: Fehlende Tabelleninformationen 400 SensitivityLabelsMissingColumn - Operation[{0}]: Fehlende Spalteninformationen 400 SensitivityLabelsUpdateSameColumnMoreThanOnce – Die Spalte {0} kann nicht mehr als einmal in einem einzigen Befehl aktualisiert werden. 400 InvalidSensitivityLabelResource – Die angegebene Vertraulichkeitsbezeichnungsressource ist ungültig. 400 SensitivityLabelLabelNameAndInfoTypeNotProvided – Mindestens einer von LabelName und InformationType muss angegeben werden. 400 LabelNameTooLong - Bezeichnungsname darf {0} Zeichen nicht überschreiten 400 InformationTypeTooLong – Der Informationstyp darf {0} Zeichen nicht überschreiten. 400 LabelIdMustBeGuid – Die bereitgestellte "labelId" ist ungültig. Der Wert muss eine GUID sein. 400 InformationTypeIdMustBeGuid – Die bereitgestellte 'informationTypeId' ist ungültig. Der Wert muss eine GUID sein. 400 LabelMissing – Bezeichnung ist erforderlich. Mindestens einer von 'labelName' oder 'labelId' muss angegeben werden. 400 InformationTypeMissing – Informationstyp ist erforderlich. Mindestens einer von 'informationType' oder 'informationTypeId' muss bereitgestellt werden. 404 SubscriptionDoesNotHaveServer – Der angeforderte Server wurde nicht gefunden. 404 DatabaseDoesNotExist – Der Benutzer hat einen Datenbanknamen angegeben, der in dieser Serverinstanz nicht vorhanden ist. 404 SubscriptionDoesNotHaveServer – Der angeforderte Server wurde nicht gefunden. 404 SensitivityLabelsSchemaNotFound - Das Schema {0} konnte nicht gefunden werden. 404 SensitivityLabelsTableNotFound – Die Tabelle {0} konnte im Schema {1} nicht gefunden werden. 404 SensitivityLabelsColumnNotFound - Die Spalte {0} konnte in Tabelle {2}nicht gefunden werden.{1} 404 DatabaseDoesNotExist – Der Benutzer hat einen Datenbanknamen angegeben, der in dieser Serverinstanz nicht vorhanden ist. 404 SensitivityLabelsLabelNotFound – Die angegebene Vertraulichkeitsbezeichnung konnte nicht gefunden werden. 501 SensitivityLabelRecommendedSourceNameNotSupported – "Empfohlene" Vertraulichkeitsbezeichnungsquelle wird noch nicht unterstützt 501 SensitivityLabelRecommendedSourceNameNotSupported – "Empfohlene" Vertraulichkeitsbezeichnungsquelle wird noch nicht unterstützt 503 DatabaseUnavailable – Fehler beim Vorgang, weil die Datenbank nicht verfügbar ist.

Name

Typ

Beschreibung

200 OK

Vertraulichkeitsbezeichnungen wurden erfolgreich aktualisiert.

Other Status Codes

ErrorResponse

Fehlerantworten: ***

400 DatawarehouseDatabaseIsDeactivated – Der Datenklassifizierungsvorgang konnte nicht ausgeführt werden, da die Datenbank angehalten wurde. Bitte setzen Sie sie fort.
400 DatawarehouseDatabaseIsDeactivated – Der Datenklassifizierungsvorgang konnte nicht ausgeführt werden, da die Datenbank angehalten wurde. Bitte setzen Sie sie fort.
400 SensitivityLabelSourceNameNotSupported – Die angegebene Vertraulichkeitsbezeichnungsquelle ist ungültig.
400 InvalidSensitivityLabelsBatch – Der angegebene Vertraulichkeitsbezeichnungsbatch ist ungültig. Geben Sie Batchvorgänge an
400 SensitivityLabelsMissingSchema - Operation[{0}]: Fehlende Schemainformationen
400 SensitivityLabelsMissingTable - Operation[{0}]: Fehlende Tabelleninformationen
400 SensitivityLabelsMissingColumn - Operation[{0}]: Fehlende Spalteninformationen
400 SensitivityLabelsUpdateSameColumnMoreThanOnce – Die Spalte {0} kann nicht mehr als einmal in einem einzigen Befehl aktualisiert werden.
400 InvalidSensitivityLabelResource – Die angegebene Vertraulichkeitsbezeichnungsressource ist ungültig.
400 SensitivityLabelLabelNameAndInfoTypeNotProvided – Mindestens einer von LabelName und InformationType muss angegeben werden.
400 LabelNameTooLong - Bezeichnungsname darf {0} Zeichen nicht überschreiten
400 InformationTypeTooLong – Der Informationstyp darf {0} Zeichen nicht überschreiten.
400 LabelIdMustBeGuid – Die bereitgestellte "labelId" ist ungültig. Der Wert muss eine GUID sein.
400 InformationTypeIdMustBeGuid – Die bereitgestellte 'informationTypeId' ist ungültig. Der Wert muss eine GUID sein.
400 LabelMissing – Bezeichnung ist erforderlich. Mindestens einer von 'labelName' oder 'labelId' muss angegeben werden.
400 InformationTypeMissing – Informationstyp ist erforderlich. Mindestens einer von 'informationType' oder 'informationTypeId' muss bereitgestellt werden.
404 SubscriptionDoesNotHaveServer – Der angeforderte Server wurde nicht gefunden.
404 DatabaseDoesNotExist – Der Benutzer hat einen Datenbanknamen angegeben, der in dieser Serverinstanz nicht vorhanden ist.
404 SubscriptionDoesNotHaveServer – Der angeforderte Server wurde nicht gefunden.
404 SensitivityLabelsSchemaNotFound - Das Schema {0} konnte nicht gefunden werden.
404 SensitivityLabelsTableNotFound – Die Tabelle {0} konnte im Schema {1} nicht gefunden werden.
404 SensitivityLabelsColumnNotFound - Die Spalte {0} konnte in Tabelle {2}nicht gefunden werden.{1}
404 DatabaseDoesNotExist – Der Benutzer hat einen Datenbanknamen angegeben, der in dieser Serverinstanz nicht vorhanden ist.
404 SensitivityLabelsLabelNotFound – Die angegebene Vertraulichkeitsbezeichnung konnte nicht gefunden werden.
501 SensitivityLabelRecommendedSourceNameNotSupported – "Empfohlene" Vertraulichkeitsbezeichnungsquelle wird noch nicht unterstützt
501 SensitivityLabelRecommendedSourceNameNotSupported – "Empfohlene" Vertraulichkeitsbezeichnungsquelle wird noch nicht unterstützt
503 DatabaseUnavailable – Fehler beim Vorgang, weil die Datenbank nicht verfügbar ist.

Beispiele

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

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/managedInstances/myManagedInstanceName/databases/myDatabase/currentSensitivityLabels?api-version=2023-08-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"
      }
    }
  ]
}

using Azure;
using Azure.ResourceManager;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/ManagedDatabaseSensitivityLabelsCurrentUpdate.json
// this example is just showing the usage of "ManagedDatabaseSensitivityLabels_Update" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ManagedDatabaseResource created on azure
// for more information of creating ManagedDatabaseResource, please refer to the document of ManagedDatabaseResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "myRG";
string managedInstanceName = "myManagedInstanceName";
string databaseName = "myDatabase";
ResourceIdentifier managedDatabaseResourceId = ManagedDatabaseResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, managedInstanceName, databaseName);
ManagedDatabaseResource managedDatabase = client.GetManagedDatabaseResource(managedDatabaseResourceId);

// invoke the operation
SensitivityLabelUpdateList sensitivityLabelUpdateList = new SensitivityLabelUpdateList
{
    Operations = {new SensitivityLabelUpdate
    {
    Op = SensitivityLabelUpdateKind.Set,
    Schema = "dbo",
    Table = "table1",
    Column = "column1",
    SensitivityLabel = new SensitivityLabelData
    {
    LabelName = "Highly Confidential",
    LabelId = "3A477B16-9423-432B-AA97-6069B481CEC3",
    InformationType = "Financial",
    InformationTypeId = "1D3652D6-422C-4115-82F1-65DAEBC665C8",
    },
    }, new SensitivityLabelUpdate
    {
    Op = SensitivityLabelUpdateKind.Set,
    Schema = "dbo",
    Table = "table2",
    Column = "column2",
    SensitivityLabel = new SensitivityLabelData
    {
    LabelName = "PII",
    LabelId = "bf91e08c-f4f0-478a-b016-25164b2a65ff",
    InformationType = "PhoneNumber",
    InformationTypeId = "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
    },
    }, new SensitivityLabelUpdate
    {
    Op = SensitivityLabelUpdateKind.Remove,
    Schema = "dbo",
    Table = "Table1",
    Column = "Column3",
    }},
};
await managedDatabase.UpdateManagedDatabaseSensitivityLabelAsync(sensitivityLabelUpdateList);

Console.WriteLine("Succeeded");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Beispiel für eine Antwort

Statuscode:: 200

Definitionen

Name	Beschreibung
ClientClassificationSource
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
SensitivityLabel	Eine Vertraulichkeitsbezeichnung.
SensitivityLabelRank
SensitivityLabelUpdate	Ein Aktualisierungsvorgang für Vertraulichkeitsbezeichnungen.
SensitivityLabelUpdateKind
SensitivityLabelUpdateList	Eine Liste der Aktualisierungsvorgänge für Vertraulichkeitsbezeichnungen.

ClientClassificationSource

Enumeration

Wert	Beschreibung
None
Native
Recommended
MIP

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

SensitivityLabel

Objekt

Eine Vertraulichkeitsbezeichnung.

Name	Typ	Beschreibung
id	string	Ressourcen-ID.
managedBy	string	Ressource, die die Vertraulichkeitsbezeichnung verwaltet.
name	string	Ressourcenname.
properties.clientClassificationSource	ClientClassificationSource
properties.columnName	string	Der Spaltenname.
properties.informationType	string	Der Informationstyp.
properties.informationTypeId	string	Die Informationstyp-ID.
properties.isDisabled	boolean	Ist die Vertraulichkeitsempfehlung deaktiviert. Gilt nur für empfohlene Vertraulichkeitsbezeichnungen. Gibt an, ob die Vertraulichkeitsempfehlung für diese Spalte deaktiviert (geschlossen) ist oder nicht.
properties.labelId	string	Die Bezeichnungs-ID.
properties.labelName	string	Der Bezeichnungsname.
properties.rank	SensitivityLabelRank
properties.schemaName	string	Der Schemaname.
properties.tableName	string	Der Tabellenname.
type	string	Ressourcentyp.

SensitivityLabelRank

Enumeration

Wert	Beschreibung
None
Low
Medium
High
Critical

SensitivityLabelUpdate

Objekt

Ein Aktualisierungsvorgang für Vertraulichkeitsbezeichnungen.

Name	Typ	Beschreibung
id	string	Ressourcen-ID.
name	string	Ressourcenname.
properties.column	string	Spaltenname, der aktualisiert werden soll.
properties.op	SensitivityLabelUpdateKind
properties.schema	string	Schemaname der zu aktualisierenden Spalte.
properties.sensitivityLabel	SensitivityLabel	Die Vertraulichkeitsbezeichnungsinformationen, die auf eine Spalte angewendet werden sollen.
properties.table	string	Tabellenname der zu aktualisierenden Spalte.
type	string	Ressourcentyp.

SensitivityLabelUpdateKind

Enumeration

Wert	Beschreibung
set
remove

SensitivityLabelUpdateList

Objekt

Eine Liste der Aktualisierungsvorgänge für Vertraulichkeitsbezeichnungen.

Name	Typ	Beschreibung
operations	SensitivityLabelUpdate[]	Ein Aktualisierungsvorgang für Vertraulichkeitsbezeichnungen.

Freigeben über

Managed Database Sensitivity Labels - Update

URI-Parameter

Anforderungstext

Antworten

Beispiele

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

Beispielanforderung

Beispiel für eine Antwort

Definitionen

ClientClassificationSource

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

SensitivityLabel

SensitivityLabelRank

SensitivityLabelUpdate

SensitivityLabelUpdateKind

SensitivityLabelUpdateList