Compartir a través de

Data Masking Policies - Create Or Update

  • Referencia
Servicio:
SQL Database
Versión de la API:
2023-08-01

Crea o actualiza una directiva de enmascaramiento de datos de base de datos.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
databaseName
 path True

string

Nombre de la base de datos.
dataMaskingPolicyName
 path True

DataMaskingPolicyName

Nombre de la base de datos para la que se aplica la directiva de enmascaramiento de datos.
resourceGroupName
 path True

string

Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor desde la API de Azure Resource Manager o el portal.
serverName
 path True

string

Nombre del servidor.
subscriptionId
 path True

string

Identificador de suscripción que identifica una suscripción de Azure.
api-version
 query True

string

Versión de la API que se va a usar para la solicitud.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
properties.dataMaskingState True

DataMaskingState

Estado de la directiva de enmascaramiento de datos.
properties.exemptPrincipals

string

Lista de las entidades de seguridad exentas. Especifica la lista separada por punto y coma de usuarios de base de datos para los que no se aplica la directiva de enmascaramiento de datos. Los usuarios especificados reciben resultados de datos sin enmascaramiento para todas las consultas de base de datos.

Respuestas

Nombre Tipo Description
200 OK

DataMaskingPolicy

Se creó correctamente la directiva de enmascaramiento de datos de base de datos.
201 Created

DataMaskingPolicy

Se creó correctamente la directiva de enmascaramiento de datos de la base de datos.
Other Status Codes

ErrorResponse

Respuestas de error: ***

  • 400 InvalidDatabaseNameForDataMaskingOperation: no es posible aplicar reglas y directivas de enmascaramiento de datos directamente a la base de datos maestra. La directiva o reglas de enmascaramiento de datos solo se aplican a la base de datos de usuario.

Ejemplos

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

Create or update data masking policy max

Solicitud de ejemplo

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=2023-08-01

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

Respuesta de muestra

status code:
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": ""
  }
}
status code:
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.

Solicitud de ejemplo

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=2023-08-01

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

Respuesta de muestra

status code:
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": ""
  }
}
status code:
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": ""
  }
}

Definiciones

Nombre Description
DataMaskingPolicy

Una directiva de enmascaramiento de datos de base de datos.
DataMaskingPolicyName

Nombre de la base de datos para la que se aplica la directiva de enmascaramiento de datos.
DataMaskingState

Estado de la directiva de enmascaramiento de datos.
ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.
ErrorDetail

Detalle del error.
ErrorResponse

Respuesta de error

DataMaskingPolicy

Object

Una directiva de enmascaramiento de datos de base de datos.

Nombre Tipo Description
id

string

Identificador de recurso.
kind

string

El tipo de directiva de enmascaramiento de datos. Metadatos, usados para Azure Portal.
location

string

Ubicación de la directiva de enmascaramiento de datos.
name

string

Nombre del recurso.
properties.applicationPrincipals

string

Lista de entidades de seguridad de aplicación. Se trata de un parámetro heredado y ya no se usa.
properties.dataMaskingState

DataMaskingState

Estado de la directiva de enmascaramiento de datos.
properties.exemptPrincipals

string

Lista de las entidades de seguridad exentas. Especifica la lista separada por punto y coma de usuarios de base de datos para los que no se aplica la directiva de enmascaramiento de datos. Los usuarios especificados reciben resultados de datos sin enmascaramiento para todas las consultas de base de datos.
properties.maskingLevel

string

Nivel de enmascaramiento. Se trata de un parámetro heredado y ya no se usa.
type

string

Tipo de recurso.

DataMaskingPolicyName

Enumeración

Nombre de la base de datos para la que se aplica la directiva de enmascaramiento de datos.

Valor Description
Default

DataMaskingState

Enumeración

Estado de la directiva de enmascaramiento de datos.

Valor Description
Disabled
Enabled

ErrorAdditionalInfo

Object

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.
type

string

Tipo de información adicional.

ErrorDetail

Object

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.
code

string

Código de error.
details

ErrorDetail[]

Detalles del error.
message

string

Mensaje de error.
target

string

Destino del error.

ErrorResponse

Object

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.