Endpoints de serviço globais e regionais

Nesta página, descrevemos os endpoints de serviço globais e regionais do Spanner e como usá-los.

Um endpoint de serviço é um URL base que especifica o endereço de rede de um serviço de API. O Spanner tem endpoints globais e regionais. É possível usar um endpoint de serviço global ou regional para fazer solicitações ao Spanner.

Use o endpoint global se você não tiver requisitos de restrição regional estritas. Embora os dados sejam armazenados na região selecionada, eles podem ser tratados fora dela. O endpoint global do Spanner é spanner.googleapis.com. O endpoint padrão da API acessa o endpoint global.

Um endpoint regional impõe restrições regionais. Os dados são armazenados e processados na mesma região. Os endpoints regionais do Spanner garantem que os dados armazenados e tratados sejam restritos à configuração de instância regional do Spanner em que o banco de dados está localizado. Use endpoints regionais se o local dos dados precisar ser restringido e controlado para obedecer aos requisitos regulamentares. Não é possível usar um endpoint regional para acessar recursos de uma configuração de instância diferente. Primeiro, crie uma instância na configuração de instância regional antes de usar o endpoint regional para essa configuração.

Para saber quais regiões podem ser usadas, consulte Regiões disponíveis para endpoints regionais. As políticas de armazenamento do Spanner não mudam, não importa qual endpoint você use.

Segurança e compliance para endpoints regionais

A vantagem de usar um endpoint regional em vez de um endpoint global é que o endpoint regional oferece isolamento e proteção regionais para atender aos requisitos regulamentares, de segurança e de conformidade.

Só é possível usar endpoints regionais que pertençam a essa configuração de instância regional. Por exemplo, não é possível usar spanner.me-central2.rep.googleapis.com para atender solicitações se a instância que você está acessando pertencer à configuração de instância regional us-central1. A solicitação será rejeitada com um erro InvalidRegionalRequest.

Limitações dos endpoints regionais

Não é possível acessar uma configuração de instância birregional ou multirregional com um endpoint regional. Use o endpoint global para acessar as configurações de instância de duas ou mais regiões. Por exemplo, se você tiver uma instância na configuração de instância multirregional nam7, não poderá usar o endpoint regional spanner.us-central1.rep.googleapis.com para enviar solicitações à instância em nam7.

Se você tiver solicitações ativas que usam endpoints regionais em qualquer um dos recursos de instância, mover a instância vai afetar todas as solicitações que usam o endpoint regional, porque a aplicação regional bloqueia o acesso a instâncias entre regiões. As solicitações que usam um endpoint global não são afetadas.

Convenção de nomenclatura de endpoint regional

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

Para mais informações, consulte Regiões disponíveis para endpoints regionais.

Especificar um endpoint regional

É possível especificar um endpoint regional do Spanner usando a Google Cloud CLI, REST ou solicitações de API RPC.

gcloud

Para especificar um endpoint regional e substituir o global, execute o comando a seguir:

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

Forneça o seguinte valor:

REGION
A região para definir um endpoint regional. Exemplo: me-central2

Por exemplo, para configurar o endpoint 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 endpoint regional para o endpoint global, execute:

gcloud config unset api_endpoint_overrides/spanner

API REST

O endpoint padrão da API acessa o endpoint global. Para usar um endpoint regional, configure o endpoint para o endereço do endpoint regional usando o seguinte padrão:

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

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

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

Consulte API REST e Regiões disponíveis para endpoints regionais para mais informações.

API RPC

O endpoint padrão da API acessa o endpoint global. Para usar um endpoint regional, configure o endpoint para o endereço do endpoint regional usando o seguinte padrão:

spanner.REGION.rep.googleapis.com

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

spanner.me-central2.rep.googleapis.com

Consulte API RPC e Regiões disponíveis para endpoints regionais para mais informações.

Regiões disponíveis para endpoints regionais

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

Nome da região de base Descrição da região
América
us-central1 Iowa
us-central2 Oklahoma
us-east1 Carolina do Sul
us-east4 Norte da Virgínia
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
Oriente Médio
me-central2 Damã
Europa
europe-west8 Milão

Restringir o uso de endpoints globais da API

Para ajudar a aplicar o uso de endpoints regionais, use a restrição de política da organização constraints/gcp.restrictEndpointUsage para bloquear solicitações ao endpoint de API global. Para mais informações, consulte Restringir o uso de endpoints.

A seguir