Pontos finais de serviço globais e regionais

Esta página descreve os pontos finais de serviço globais e regionais do Spanner e como usá-los.

Um ponto final de serviço é um URL base que especifica o endereço de rede de um serviço de API. O Spanner tem pontos finais globais e regionais. Pode usar um ponto final de serviço global ou regional para fazer pedidos ao Spanner.

Use o ponto final global se não tiver requisitos de restrição regionais rigorosos. Embora os dados sejam armazenados na região selecionada, os dados podem ser processados fora da região. O ponto final global do Spanner é spanner.googleapis.com. O ponto final da API predefinido acede ao ponto final global.

Um ponto final regional aplica restrições regionais. Os dados são armazenados e processados na mesma região. Os pontos finais regionais do Spanner garantem que os dados armazenados e tratados estão restritos à configuração da instância regional do Spanner onde a base de dados reside. Use pontos finais regionais se a localização dos seus dados tiver de ser restrita e controlada para estar em conformidade com os requisitos regulamentares. Não pode usar um ponto final regional para aceder a recursos pertencentes a uma configuração de instância diferente. Primeiro, tem de criar uma instância na configuração da instância regional antes de poder usar o ponto final regional para essa configuração da instância.

Para saber que regiões pode usar, consulte o artigo Regiões disponíveis para pontos finais regionais. As políticas de armazenamento do Spanner subjacentes não se alteram, independentemente do ponto final que usar.

Segurança e conformidade para pontos finais regionais

A vantagem de usar um ponto final regional do Spanner em vez de um ponto final global é que o ponto final regional oferece isolamento e proteção regionais para cumprir os requisitos de segurança, conformidade e regulamentares.

Só pode usar pontos finais regionais pertencentes a essa configuração de instância regional. Por exemplo, não pode usar spanner.me-central2.rep.googleapis.com para publicar pedidos se a instância à qual está a aceder pertencer à configuração da instância regional us-central1. O pedido é rejeitado com um erro InvalidRegionalRequest.

Limitações dos pontos finais regionais

Não pode aceder a uma configuração de instância de região dupla ou multirregião com um ponto final regional. Tem de usar o ponto final global para aceder às configurações de instâncias de várias regiões ou de duas regiões. Por exemplo, se tiver uma instância na configuração de instâncias de várias regiões nam7, não pode usar o ponto final regional spanner.us-central1.rep.googleapis.com para enviar pedidos para a sua instância em nam7.

Se tiver pedidos ativos que usem pontos finais regionais em qualquer um dos recursos de instância, mover a instância afeta todos os pedidos que usam o ponto final regional, porque a aplicação regional bloqueia o acesso a instâncias entre regiões. Os pedidos que usam um ponto final global não são afetados.

Convenção de nomenclatura de pontos finais regionais

Os nomes dos pontos finais regionais do Spanner seguem a mesma convenção de nomenclatura que os nomes de configuração da instância regional. O ponto final regional segue o formato spanner.REGION.rep.googleapis.com. Por exemplo, o nome da configuração da instância regional e o nome do ponto final regional para Dammam são me-central2. Por conseguinte, o ponto final regional é spanner.me-central2.rep.googleapis.com.

Para mais informações, consulte o artigo Regiões disponíveis para os pontos finais regionais.

Especifique um ponto final regional

Pode especificar um ponto final regional do Spanner através de pedidos da API REST ou RPC, ou da CLI do Google Cloud.

gcloud

Para especificar um ponto final regional e substituir o ponto final global, execute o seguinte comando:

gcloud config set api_endpoint_overrides/spanner https://spanner.REGION.rep.googleapis.com/

Indique o seguinte valor:

REGION
A região para a qual definir um ponto final regional. Por exemplo, me-central2.

Por exemplo, para configurar o ponto final regional como me-central2, execute o seguinte comando:

gcloud config set api_endpoint_overrides/spanner https://spanner.me-central2.rep.googleapis.com/

Para reconfigurar um ponto final regional para o ponto final global, execute:

gcloud config unset api_endpoint_overrides/spanner

API REST

O ponto final da API predefinido acede ao ponto final global. Para usar um ponto final regional, configure o ponto final para o endereço do ponto final regional usando o seguinte padrão:

https://spanner.REGION.rep.googleapis.com

Por exemplo, se quiser aplicar garantias de dados na configuração da instância regional de Dammam (me-central2), use:

  https://spanner.me-central2.rep.googleapis.com

Consulte a API REST e as regiões disponíveis para pontos finais regionais para mais informações.

API RPC

O ponto final da API predefinido acede ao ponto final global. Para usar um ponto final regional, configure o ponto final para o endereço do ponto final regional usando o seguinte padrão:

spanner.REGION.rep.googleapis.com

Por exemplo, se quiser aplicar garantias de dados na configuração da instância regional de Dammam (me-central2), use:

spanner.me-central2.rep.googleapis.com

Consulte a API RPC e as regiões disponíveis para os pontos finais regionais para mais informações.

Regiões disponíveis para pontos finais regionais

Os pontos finais regionais do Spanner estão disponíveis nas seguintes regiões:

Nome regional base Descrição da região
Americas
us-central1 Iowa
us-central2 Oklahoma
us-east1 Carolina do Sul
us-east4 Virgínia do Norte
us-east5 Columbus
us-east7 Alabama
us-south1 Dallas
us-west1 Oregon
us-west2 Los Angeles
us-west3 Salt Lake City
us-west4 Las Vegas
us-west8 Phoenix
Médio Oriente
me-central2 Damã
Europa
europe-west8 Milão

Restrinja a utilização do ponto final da API global

Para ajudar a aplicar a utilização de pontos finais regionais, use a restrição da política da organização constraints/gcp.restrictEndpointUsage para bloquear pedidos ao ponto final da API global. Para mais informações, consulte o artigo Restringir a utilização de pontos finais.

O que se segue?