Freigeben über

Data Masking Policies - Create Or Update

Dienst:
SQL Database
API-Version:
2025-01-01

Erstellt oder aktualisiert eine Datenbank-Datenmaskierungsrichtlinie.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/dataMaskingPolicies/Default?api-version=2025-01-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
databaseName
 path True

string

Der Name der Datenbank.
dataMaskingPolicyName
 path True

DataMaskingPolicyName

Der Name der Datenbank, für die die Datenmaskierungsrichtlinie gilt.
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.
serverName
 path True

string

Name des Servers
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 Erforderlich Typ Beschreibung
properties.dataMaskingState True

DataMaskingState

Der Status der Datenformatierungsrichtlinie.
properties.exemptPrincipals

string

Die Liste der ausgenommenen Prinzipale. Gibt die durch Semikolons getrennte Liste von Datenbankbenutzern an, für die die Datenformatierungsrichtlinie nicht gilt. Die angegebenen Benutzer erhalten Datenergebnisse, ohne für alle Datenbankabfragen maskieren zu müssen.

Antworten

Name Typ Beschreibung
200 OK

DataMaskingPolicy

Erfolgreich erstellte Datenbank-Datenmaskierungsrichtlinie.
201 Created

DataMaskingPolicy

Erfolgreich erstellte Datenbank-Datenmaskierungsrichtlinie...
Other Status Codes

ErrorResponse

Fehlerantworten: ***

  • 400 InvalidDatabaseNameForDataMaskingOperation – Es ist nicht möglich, die Datenmaskierungsrichtlinie und -regeln direkt auf die Masterdatenbank anzuwenden. Die Datenmaskierungsrichtlinien/-regeln gelten nur für die Benutzerdatenbank.

Beispiele

Create or update data masking policy max
Create or update data masking policy min.

Create or update data masking policy max

Beispielanforderung

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default?api-version=2025-01-01

{
  "properties": {
    "dataMaskingState": "Enabled",
    "exemptPrincipals": "testuser;"
  }
}

Beispiel für eine Antwort

Statuscode:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default",
  "name": "Default",
  "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies",
  "location": "Central US",
  "kind": null,
  "properties": {
    "dataMaskingState": "Enabled",
    "applicationPrincipals": "",
    "exemptPrincipals": "testuser;",
    "maskingLevel": ""
  }
}
Statuscode:
201 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default",
  "name": "Default",
  "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies",
  "location": "Central US",
  "kind": null,
  "properties": {
    "dataMaskingState": "Enabled",
    "applicationPrincipals": "",
    "exemptPrincipals": "testuser;",
    "maskingLevel": ""
  }
}

Create or update data masking policy min.

Beispielanforderung

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default?api-version=2025-01-01

{
  "properties": {
    "dataMaskingState": "Enabled"
  }
}

Beispiel für eine Antwort

Statuscode:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default",
  "name": "Default",
  "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies",
  "location": "Central US",
  "kind": null,
  "properties": {
    "dataMaskingState": "Enabled",
    "applicationPrincipals": "",
    "exemptPrincipals": "",
    "maskingLevel": ""
  }
}
Statuscode:
201 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default",
  "name": "Default",
  "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies",
  "location": "Central US",
  "kind": null,
  "properties": {
    "dataMaskingState": "Enabled",
    "applicationPrincipals": "",
    "exemptPrincipals": "",
    "maskingLevel": ""
  }
}

Definitionen

Name Beschreibung
DataMaskingPolicy

Eine Datenbank-Datenmaskierungspolitik.
DataMaskingPolicyName

Der Name der Datenbank, für die die Datenmaskierungsrichtlinie gilt.
DataMaskingState

Der Status der Datenformatierungsrichtlinie.
ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail

Das Fehlerdetails.
ErrorResponse

Fehlerantwort

DataMaskingPolicy

Objekt

Eine Datenbank-Datenmaskierungspolitik.

Name Typ Beschreibung
id

string

Ressourcen-ID
kind

string

Die Art von Datenmaskierungspolitik. Metadaten, verwendet für Azure Portal.
location

string

Der Standort der Datenmaskierungsrichtlinie.
name

string

Ressourcenname.
properties.applicationPrincipals

string

Die Liste der Bewerbungsleiter. Dies ist ein Legacyparameter und wird nicht mehr verwendet.
properties.dataMaskingState

DataMaskingState

Der Status der Datenformatierungsrichtlinie.
properties.exemptPrincipals

string

Die Liste der ausgenommenen Prinzipale. Gibt die durch Semikolons getrennte Liste von Datenbankbenutzern an, für die die Datenformatierungsrichtlinie nicht gilt. Die angegebenen Benutzer erhalten Datenergebnisse, ohne für alle Datenbankabfragen maskieren zu müssen.
properties.maskingLevel

string

Das Maskierungsniveau. Dies ist ein Legacyparameter und wird nicht mehr verwendet.
type

string

Ressourcentyp.

DataMaskingPolicyName

Enumeration

Der Name der Datenbank, für die die Datenmaskierungsrichtlinie gilt.

Wert Beschreibung
Default

DataMaskingState

Enumeration

Der Status der Datenformatierungsrichtlinie.

Wert Beschreibung
Enabled
Disabled

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.