Delen via

Data Masking Rules - List By Database

Service:
SQL Database
API-versie:
2025-01-01

Krijgt een lijst met database-datamaskeringsregels.

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

URI-parameters

Name In Vereist Type Description
databaseName
 path True

string

De naam van de database.
dataMaskingPolicyName
 path True

DataMaskingPolicyName

De naam van de database waarop het datamaskerbeleid van toepassing is.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

De naam van de resourcegroep. De naam is hoofdletterongevoelig.
serverName
 path True

string

De naam van de server.
subscriptionId
 path True

string (uuid)

De id van het doelabonnement. De waarde moet een UUID zijn.
api-version
 query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name Type Description
200 OK

DataMaskingRuleListResult

Azure-operatie succesvol voltooid.
Other Status Codes

ErrorResponse

Een onverwachte foutreactie.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

Gets a list of database data masking rules.

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:
200 
{
  "value": [
    {
      "name": null,
      "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/rule1",
      "kind": null,
      "location": "Central US",
      "properties": {
        "aliasName": null,
        "columnName": "test1",
        "id": "dbo_Table_1_test1",
        "maskingFunction": "Text",
        "numberFrom": null,
        "numberTo": null,
        "prefixSize": "1",
        "replacementString": "asdf",
        "ruleState": "Enabled",
        "schemaName": "dbo",
        "suffixSize": "0",
        "tableName": "Table_1"
      }
    },
    {
      "name": null,
      "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies/rules",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-6852/databases/sqlcrudtest-331/dataMaskingPolicies/Default/rules/rule1",
      "kind": null,
      "location": "Central US",
      "properties": {
        "aliasName": null,
        "columnName": "test1",
        "id": "dbo_Table_1_test1",
        "maskingFunction": "Number",
        "numberFrom": "0",
        "numberTo": "2",
        "prefixSize": null,
        "replacementString": null,
        "ruleState": "Enabled",
        "schemaName": "dbo",
        "suffixSize": null,
        "tableName": "Table_1"
      }
    }
  ]
}

Definities

Name Description
createdByType

Het type identiteit waarmee de resource is gemaakt.
DataMaskingFunction

De maskeringsfunctie die wordt gebruikt voor de regel voor gegevensmaskering.
DataMaskingPolicyName
DataMaskingRule

Een regel voor data-maskering in databases.
DataMaskingRuleListResult

De respons van een DataMaskingRule-lijstoperatie.
DataMaskingRuleState

De regelstatus. Wordt gebruikt om een regel te verwijderen. Als u een bestaande regel wilt verwijderen, geeft u de schemaName, tableName, columnName, maskingFunction op en geeft u ruleState op als uitgeschakeld. Als de regel echter nog niet bestaat, wordt de regel gemaakt met ruleState ingesteld op ingeschakeld, ongeacht de opgegeven waarde van ruleState.
ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.
ErrorDetail

De foutdetails.
ErrorResponse

Foutreactie
systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

createdByType

Opsomming

Het type identiteit waarmee de resource is gemaakt.

Waarde Description
User
Application
ManagedIdentity
Key

DataMaskingFunction

Opsomming

De maskeringsfunctie die wordt gebruikt voor de regel voor gegevensmaskering.

Waarde Description
Default

Verstek
CCN

CCN
Email

E-mailadres
Number

Number
SSN

SSN
Text

Text

DataMaskingPolicyName

Opsomming
Waarde Description
Default

Verstek

DataMaskingRule

Object

Een regel voor data-maskering in databases.

Name Type Description
id

string (arm-id)

Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"
kind

string

Het soort Data Masking-regel. Metadata, gebruikt voor Azure Portal.
location

string

De locatie van de datamasking-regel.
name

string

De naam van de resource
properties.aliasName

string

De aliasnaam. Dit is een verouderde parameter en wordt niet meer gebruikt.
properties.columnName

string

De kolomnaam waarop de gegevensmaskeringsregel wordt toegepast.
properties.id

string

De regel is het niet.
properties.maskingFunction

DataMaskingFunction

De maskeringsfunctie die wordt gebruikt voor de regel voor gegevensmaskering.
properties.numberFrom

string

De eigenschap numberFrom van de maskeringsregel. Vereist als maskingFunction is ingesteld op Getal, anders wordt deze parameter genegeerd.
properties.numberTo

string

De eigenschap NumberTo van de regel voor gegevensmaskering. Vereist als maskingFunction is ingesteld op Getal, anders wordt deze parameter genegeerd.
properties.prefixSize

string

Als maskingFunction is ingesteld op Tekst, wordt het aantal tekens weergegeven dat niet wordt gemaskeerd aan het begin van de tekenreeks. Anders wordt deze parameter genegeerd.
properties.replacementString

string

Als maskingFunction is ingesteld op Tekst, moet het teken worden gebruikt voor het maskeren van het niet-belichte deel van de tekenreeks. Anders wordt deze parameter genegeerd.
properties.ruleState

DataMaskingRuleState

De regelstatus. Wordt gebruikt om een regel te verwijderen. Als u een bestaande regel wilt verwijderen, geeft u de schemaName, tableName, columnName, maskingFunction op en geeft u ruleState op als uitgeschakeld. Als de regel echter nog niet bestaat, wordt de regel gemaakt met ruleState ingesteld op ingeschakeld, ongeacht de opgegeven waarde van ruleState.
properties.schemaName

string

De schemanaam waarop de gegevensmaskeringsregel wordt toegepast.
properties.suffixSize

string

Als maskingFunction is ingesteld op Tekst, wordt het aantal tekens weergegeven dat aan het einde van de tekenreeks niet wordt gemaskeerd. Anders wordt deze parameter genegeerd.
properties.tableName

string

De tabelnaam waarop de gegevensmaskeringsregel wordt toegepast.
systemData

systemData

Azure Resource Manager metadata met creationBy en modifiedBy informatie.
type

string

Het type bron. Bijvoorbeeld: "Microsoft. Compute/virtualMachines" of "Microsoft. Opslag/opslagAccounts"

DataMaskingRuleListResult

Object

De respons van een DataMaskingRule-lijstoperatie.

Name Type Description
nextLink

string (uri)

De koppeling naar de volgende pagina met items
value

DataMaskingRule[]

De DataMaskingRule-items op deze pagina

DataMaskingRuleState

Opsomming

De regelstatus. Wordt gebruikt om een regel te verwijderen. Als u een bestaande regel wilt verwijderen, geeft u de schemaName, tableName, columnName, maskingFunction op en geeft u ruleState op als uitgeschakeld. Als de regel echter nog niet bestaat, wordt de regel gemaakt met ruleState ingesteld op ingeschakeld, ongeacht de opgegeven waarde van ruleState.

Waarde Description
Enabled

Ingeschakeld
Disabled

Disabled

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.
type

string

Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.
code

string

De foutcode.
details

ErrorDetail[]

De foutdetails.
message

string

Het foutbericht.
target

string

Het foutdoelwit.

ErrorResponse

Object

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name Type Description
createdAt

string (date-time)

De tijdstempel van het maken van resources (UTC).
createdBy

string

De identiteit waarmee de resource is gemaakt.
createdByType

createdByType

Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt

string (date-time)

Het tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy

string

De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType

createdByType

Het type identiteit dat de resource voor het laatst heeft gewijzigd.