Com a capacidade de especificar uma região para executar as operações da Proteção de dados sensíveis, é possível controlar onde os dados potencialmente sensíveis serão tratados. Neste documento, explicamos o conceito de local de processamento da Proteção de dados sensíveis e mostramos como especificar uma região.
Para conferir uma lista de regiões e multirregiões compatíveis, consulte Locais da Proteção de dados sensíveis.
Sobre regiões e multirregiões
Uma região é um lugar geográfico específico, como o oeste dos Estados Unidos ou o nordeste da Ásia. Um local multirregional (ou apenas multirregião) é uma grande área geográfica, como a União Europeia, que contém duas ou mais regiões geográficas.
Questões sobre o local
O local ideal é aquele em que você encontra um equilíbrio entre latência, disponibilidade e custos de largura de banda.
Use um local regional para ajudar a otimizar a latência e a largura de banda de rede.
Use uma multirregião quando quiser processar dados de fora da rede do Google e distribuídos em grandes áreas geográficas, ou quando quiser a maior disponibilidade proveniente da redundância entre regiões.
Geralmente, o recomendável é processar os dados em um local que seja conveniente ou que contenha a maioria dos usuários dos seus dados.
Se a sua organização precisar manter os dados em trânsito em um local especificado, use apenas as regiões ou multirregiões que aceitam endpoints regionais (REP). Nesse caso, é necessário usar a API Cloud Data Loss Prevention, porque os endpoints regionais da Proteção de dados sensíveis não estão disponíveis para uso com o consoleGoogle Cloud .
Especifique uma Região
A forma de especificar a região de processamento depende do tipo de endpoint para o qual você está enviando a solicitação: o endpoint global ou um endpoint regional. O tipo de endpoint escolhido depende se você precisa manter dados em trânsito em uma região específica. Para mais informações, consulte Endpoints globais e regionais da Proteção de dados sensíveis.
Especificar uma região em uma solicitação ao endpoint global
Console
Escolha uma região ao configurar sua operação da Proteção de Dados Sensíveis.
Por exemplo, ao criar um gatilho de jobs, escolha um local no menu Local do recurso, como mostrado aqui:

Se o local de processamento não for uma preocupação, use a região Global e o Google escolherá o local onde o processamento ocorrerá. Global é a escolha de região padrão.
REST
Insira as informações da região no URL do endpoint da solicitação. Se o local de processamento não for uma preocupação, use a região global
e o Google escolherá o local onde o processamento ocorrerá. Observe que todos os recursos criados por uma solicitação que especifica a região global
são armazenados na região global
.
Confira alguns exemplos de solicitações para o endpoint global.
Como usar a região global
As duas solicitações a seguir têm o mesmo efeito. Não incluir uma região é o mesmo que especificar locations/global/
.
POST https://www.googleapis.com/dlp/v2/projects/PROJECT_ID/locations/global/content:inspect
POST https://www.googleapis.com/dlp/v2/projects/PROJECT_ID/content:inspect
Usar uma região específica
Para especificar uma região para processamento no URL do recurso, insira locations/
e depois o nome da região.
POST https://www.googleapis.com/dlp/v2/projects/PROJECT_ID/locations/us-west2/content:inspect
Especificar uma região em uma solicitação para um endpoint regional
Console
Para a Proteção de dados sensíveis, os endpoints regionais não estão disponíveis para uso com o console Google Cloud .
C#
Para saber como instalar e usar a biblioteca de cliente da Proteção de dados sensíveis, consulte Bibliotecas de cliente da Proteção de dados sensíveis.
Para autenticar na Proteção de dados sensíveis, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Para saber como instalar e usar a biblioteca de cliente da Proteção de dados sensíveis, consulte Bibliotecas de cliente da Proteção de dados sensíveis.
Para autenticar na Proteção de dados sensíveis, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Para saber como instalar e usar a biblioteca de cliente da Proteção de dados sensíveis, consulte Bibliotecas de cliente da Proteção de dados sensíveis.
Para autenticar na Proteção de dados sensíveis, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
REST
O exemplo a seguir envia uma solicitação content.inspect
para um endpoint regional.
Todos os dados anexados a essa solicitação permanecem na região especificada durante o trânsito, o uso e o repouso.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
-
REP_REGION
: uma região em que um endpoint regional (REP) para a Proteção de Dados Sensíveis está disponível, por exemplo,us-west2
. Para uma lista completa de regiões, consulte Locais da Proteção de dados sensíveis. -
PROJECT_ID
: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comoexample-project
.
Método HTTP e URL:
POST https://dlp.REP_REGION.rep.googleapis.com/v2/projects/PROJECT_ID/locations/REP_REGION/content:inspect
Corpo JSON da solicitação:
{ "inspectConfig": { "infoTypes": [ { "name": "CREDIT_CARD_NUMBER" } ] }, "item": { "value": "hi, my ccn is 4111111111111111" } }
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
{ "result": { "findings": [ { "infoType": { "name": "CREDIT_CARD_NUMBER", "sensitivityScore": { "score": "SENSITIVITY_HIGH" } }, "likelihood": "LIKELY", "location": { "byteRange": { "start": "14", "end": "30" }, "codepointRange": { "start": "14", "end": "30" } }, "createTime": "2024-08-09T19:54:13.348Z", "findingId": "2024-08-09T19:54:13.352163Z4747901452516738787" } ] } }
Considerações sobre a locação conjunta
Ao verificar um repositório de armazenamento, como o Cloud Storage ou o BigQuery, você precisará especificar o mesmo local na sua solicitação da Proteção de dados sensíveis que o local do repositório que você está verificando. Por exemplo, se o conjunto de dados do BigQuery estiver no local multirregional da União Europeia, especifique a multirregião da União Europeia (europe
) ao configurar o job da Proteção de Dados Sensíveis.
Se você não realizar um locação conjunta da solicitação da Proteção de dados sensíveis com o repositório de armazenamento que você está verificando, o processamento da solicitação poderá ser dividido entre o local dos dados e o local especificado na solicitação.
A seguir
- Saiba mais sobre regiões geográficas e zonas.
- Confira uma lista de regiões e multirregiões compatíveis.
- Saiba mais sobre os endpoints globais e regionais da Proteção de dados sensíveis.