REST Resource: projects.locations.dataPolicies

Recurso: DataPolicy

Representa la vinculación de la política de etiquetas.

Representación JSON 
{
  "name": string,
  "dataPolicyType": enum (DataPolicyType),
  "dataPolicyId": string,

  // Union field matching_label can be only one of the following:
  "policyTag": string
  // End of list of possible types for union field matching_label.

  // Union field policy can be only one of the following:
  "dataMaskingPolicy": {
    object (DataMaskingPolicy)
  }
  // End of list of possible types for union field policy.
}
Campos
name

string

Solo salida. El nombre del recurso de esta política de datos, en el formato projects/{projectNumber}/locations/{locationId}/dataPolicies/{dataPolicyId}.
dataPolicyType

enum (DataPolicyType)

Tipo de política de datos.
dataPolicyId

string

ID asignado por el usuario (legible por humanos) de la política de datos que debe ser única dentro de un proyecto. Se usa como {dataPolicyId} en parte del nombre del recurso.
Campo de unión matching_label. Etiqueta que está vinculada a esta política de datos. matching_label puede ser solo uno de los siguientes:
policyTag

string

Nombre del recurso de la etiqueta de política, en el formato projects/{projectNumber}/locations/{locationId}/taxonomies/{taxonomyId}/policyTags/{policyTag_id}.
Campo de unión policy. La política que está vinculada a esta política de datos. policy puede ser solo uno de los siguientes:
dataMaskingPolicy

object (DataMaskingPolicy)

La política de enmascaramiento de datos que especifica la regla de enmascaramiento de datos que se usará.

DataMaskingPolicy

La política de enmascaramiento de datos que se usa para especificar la regla de enmascaramiento de datos.

Representación JSON 
{

  // Union field masking_expression can be only one of the following:
  "predefinedExpression": enum (PredefinedExpression),
  "routine": string
  // End of list of possible types for union field masking_expression.
}
Campos
Campo de unión masking_expression. Una expresión de enmascaramiento para vincularse a la regla de enmascaramiento de datos. masking_expression puede ser solo uno de los siguientes:
predefinedExpression

enum (PredefinedExpression)

Una expresión de enmascaramiento predefinida.
routine

string

El nombre de la rutina de BigQuery que contiene la rutina de enmascaramiento personalizada, en el formato projects/{projectNumber}/datasets/{dataset_id}/routines/{routine_id}.

PredefinedExpression

Las reglas de enmascaramiento disponibles. Obtén más información aquí: https://cloud.google.com/bigquery/docs/column-data-masking-intro#masking_options.

Enums
PREDEFINED_EXPRESSION_UNSPECIFIED Expresión predefinida sin especificar predeterminada. No se realizará el enmascaramiento, ya que no se especificó ninguna expresión.
SHA256 Expresión de enmascaramiento para reemplazar datos por hash SHA-256.
ALWAYS_NULL Expresión de enmascaramiento para reemplazar datos por valores NULL.
DEFAULT_MASKING_VALUE

Expresión de enmascaramiento para reemplazar datos por sus valores de enmascaramiento predeterminados. Los valores de enmascaramiento predeterminados para cada tipo que se enumeran a continuación:

  • STRING: ""
  • BYTES: b''
  • INTEGER: 0
  • FLOAT: 0.0
  • NUMERIC: 0
  • BOOLEAN: FALSO
  • TIMESTAMP: 1970-01-01 00:00:00 UTC
  • DATE: 1970-01-01
  • TIME: 00:00:00
  • DATETIME: 1970-01-01T00:00:00
  • GEOGRAPHY: POINT(0 0)
  • BIGNUMERIC: 0
  • ARRAY: []
  • STRUCT: NOT_APPLICABLE
  • JSON: NULL
LAST_FOUR_CHARACTERS

La expresión de enmascaramiento muestra los últimos cuatro caracteres del texto. El comportamiento del enmascaramiento es el siguiente:

  • Si la longitud de texto es mayor que 4 caracteres, reemplaza el texto por XXXXX, agrega los últimos cuatro caracteres del texto original.
  • Si la longitud de texto es <= 4 caracteres, aplica el hash SHA-256.
FIRST_FOUR_CHARACTERS

La expresión de enmascaramiento muestra los primeros cuatro caracteres del texto. El comportamiento del enmascaramiento es el siguiente:

  • Si la longitud de texto es mayor que 4 caracteres, reemplaza el texto por XXXXX, antepone los primeros cuatro caracteres del texto original.
  • Si la longitud de texto es <= 4 caracteres, aplica el hash SHA-256.
EMAIL_MASK

Expresión de enmascaramiento para direcciones de correo electrónico. El comportamiento del enmascaramiento es el siguiente:

  • Dirección de correo electrónico válida de sintaxis: Reemplaza el nombre de usuario por XXXXX. Por ejemplo, cloudysanfrancisco@gmail.com se convierte en XXXXX@gmail.com.
  • Dirección de correo electrónico no válida de sintaxis: Aplica el hash SHA-256.

Para obtener más información, consulta Enmascaramiento de correo electrónico.
DATE_YEAR_MASK

Expresión de enmascaramiento para mostrar solo el año de Date, DateTime y TimeStamp. Por ejemplo, con el año 2076:

  • DATE : 2076-01-01
  • DATETIME : 2076-01-01T00:00:00
  • TIMESTAMP : 2076-01-01 00:00:00 UTC

El truncamiento ocurre según la zona horaria UTC. Para cambiar esto, ajusta la zona horaria predeterminada con la variable de sistema time_zone. Para obtener más información, consulta la Referencia de variables de sistema.

DataPolicyType

Una lista de los tipos de políticas de datos compatibles.

Enums
DATA_POLICY_TYPE_UNSPECIFIED Valor predeterminado para el tipo de política de datos. No debe usarse.
COLUMN_LEVEL_SECURITY_POLICY Se usa con el fin de crear una política de datos para la seguridad a nivel de columnas, sin enmascarar de datos.
DATA_MASKING_POLICY Se usa con el fin de crear una política de datos para el enmascaramiento de datos.

Métodos

create

 Crea una nueva política de datos en un proyecto con el dataPolicyId (se usa como nombre visible), la etiqueta de política y el tipo de política de datos determinados.

delete

 Borra la política de datos especificada por su nombre de recurso.

get

 Obtiene la política de datos especificada por su nombre de recurso.

getIamPolicy

 Obtén la política de IAM para la política de datos especificada.

list

 Enumera todas las políticas de datos en el proyecto superior especificado.

patch

 Actualiza los metadatos de una política de datos existente.

rename

 Cambia el nombre del ID (nombre visible) de la política de datos especificada.

setIamPolicy

 Configura la política de IAM para la política de datos especificada.

testIamPermissions

 Devuelve el permiso del emisor en el recurso de política de datos especificado.