REST Resource: projects.locations.dataPolicies

Recurso: DataPolicy

Representa a vinculação da política de rótulos.

Representação 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

Apenas saída. Nome do recurso dessa política de dados, no formato projects/{projectNumber}/locations/{locationId}/dataPolicies/{dataPolicyId}.
dataPolicyType

enum (DataPolicyType)

Tipo de política de dados.
dataPolicyId

string

ID da política de dados atribuído pelo usuário (legível) que precisa ser exclusivo em um projeto. Usado como {dataPolicyId} em parte do nome do recurso.
Campo de união matching_label. Rótulo vinculado a essa política de dados. matching_label pode ser apenas de um dos tipos a seguir:
policyTag

string

Nome do recurso da tag de política, no formato de projects/{projectNumber}/locations/{locationId}/taxonomies/{taxonomyId}/policyTags/{policyTag_id}.
Campo de união policy. A política vinculada à política de dados. policy pode ser apenas de um dos tipos a seguir:
dataMaskingPolicy

object (DataMaskingPolicy)

A política de mascaramento de dados que especifica a regra de mascaramento de dados a ser usada.

DataMaskingPolicy

A política de mascaramento de dados usada para especificar a regra de mascaramento de dados.

Representação 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ão masking_expression. Uma expressão de mascaramento para vincular à regra de mascaramento de dados. masking_expression pode ser apenas de um dos tipos a seguir:
predefinedExpression

enum (PredefinedExpression)

Uma expressão de mascaramento predefinida.
routine

string

O nome da rotina do BigQuery que contém a rotina de mascaramento personalizada, no formato projects/{projectNumber}/datasets/{dataset_id}/routines/{routine_id}.

PredefinedExpression

As regras de mascaramento disponíveis. Saiba mais aqui: https://cloud.google.com/bigquery/docs/column-data-masking-intro#masking_options.

Enums
PREDEFINED_EXPRESSION_UNSPECIFIED Expressão predefinida padrão não especificada. Nenhum mascaramento ocorrerá, porque nenhuma expressão foi especificada.
SHA256 Mascaramento da expressão para substituir dados pelo hash SHA-256.
ALWAYS_NULL Mascaramento da expressão para substituir dados por NULLs.
DEFAULT_MASKING_VALUE

Mascaramento de expressão para substituir dados pelos valores de mascaramento padrão. Os valores de mascaramento padrão para cada tipo listados abaixo:

  • STRING: ""
  • BYTES: b''
  • INTEGER: 0
  • FLOAT: 0.0
  • NUMERIC: 0
  • BOOLEAN: FALSE
  • 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

O mascaramento de expressão mostra os últimos quatro caracteres do texto. O comportamento do mascaramento é o seguinte:

  • Se o tamanho do texto for maior que quatro caracteres: substitua o texto por XXXXX, além dos últimos quatro caracteres do texto original.
  • Se o comprimento do texto for menor ou igual a quatro caracteres, aplique o hash SHA-256.
FIRST_FOUR_CHARACTERS

O mascaramento de expressão mostra os quatro primeiros caracteres do texto. O comportamento do mascaramento é o seguinte:

  • Se o comprimento do texto for maior que quatro caracteres: substitua o texto por XXXXX, incluindo os quatro primeiros caracteres do texto original.
  • Se o comprimento do texto for menor ou igual a quatro caracteres, aplique o hash SHA-256.
EMAIL_MASK

Expressão de mascaramento para endereços de e-mail. O comportamento do mascaramento é o seguinte:

  • Endereço de e-mail válido com a sintaxe: substitua o nome de usuário por XXXXX. Por exemplo, cloudysanfrancisco@gmail.com passa a ser XXXXX@gmail.com.
  • Endereço de e-mail inválido de sintaxe: aplique o hash SHA-256.

Para mais informações, consulte Máscara de e-mail.
DATE_YEAR_MASK

Mascaramento da expressão para mostrar apenas o ano de Date, DateTime e TimeStamp. Por exemplo, com o ano 2076:

  • DATE : 2076-01-01
  • DATETIME : 2076-01-01T00:00:00
  • CARIMBO DE DATA/HORA : 2076-01-01 00:00:00 UTC

Observação :o truncamento ocorre de acordo com o fuso horário UTC. Para mudar isso, ajuste o fuso horário padrão usando a variável de sistema time_zone. Para mais informações, consulte a Referência de variáveis do sistema.

DataPolicyType

Uma lista de tipos de política de dados compatíveis.

Enums
DATA_POLICY_TYPE_UNSPECIFIED Valor padrão para o tipo de política de dados. Isso não deve ser usado.
COLUMN_LEVEL_SECURITY_POLICY Usado para criar uma política de dados para segurança no nível da coluna, sem mascaramento de dados.
DATA_MASKING_POLICY Usado para criar uma política de dados para mascaramento de dados.

Métodos

create

 Cria uma nova política de dados em um projeto com o dataPolicyId (usado como o nome de exibição), a tag de política e o tipo de política de dados fornecidos.

delete

 Exclui a política de dados especificada pelo nome do recurso.

get

 Recebe a política de dados especificada pelo nome do recurso.

getIamPolicy

 Acessa a política do IAM para a política de dados especificada.

list

 Liste todas as políticas de dados no projeto pai especificado.

patch

 Atualiza os metadados de uma política de dados atual.

rename

 Renomeia o ID (nome de exibição) da política de dados especificada.

setIamPolicy

 Define a política do IAM para a política de dados especificada.

testIamPermissions

 Retorna a permissão do autor da chamada no recurso de política de dados especificado.