Endpoints de serviço globais e regionais

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

Um endpoint de serviço é um URL de 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 regionais estritos. Embora os dados sejam armazenados na região selecionada, eles podem ser processados fora dela. O endpoint global do Spanner é spanner.googleapis.com. O endpoint padrão da API acessa o endpoint global.

Um endpoint regional aplica 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 processados 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 atender aos requisitos regulamentares. Não é possível usar um endpoint regional para acessar recursos pertencentes a uma configuração de instância diferente. Primeiro, é preciso criar uma instância na configuração de instância regional para 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, independente de qual endpoint você usa.

Segurança e compliance para endpoints regionais

A vantagem de usar um endpoint regional do Spanner 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 pertencem à configuração da instância regional. Por exemplo, não é possível usar spanner.me-central2.rep.googleapis.com para exibir solicitações se a instância que você está acessando pertence à configuração de instância regional us-central1. A solicitação será rejeitada com um erro InvalidRegionalRequest.

Limitações de endpoints regionais

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

Se você tiver solicitações ativas que usam endpoints regionais em qualquer um dos recursos da 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 de endpoint regionais do Spanner seguem a mesma convenção de nomenclatura que os nomes de configuração de instâncias regionais. 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 as solicitações da API REST, da API RPC ou da CLI do Google Cloud.

gcloud

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

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

Forneça o seguinte valor:

REGION
A região em que um endpoint regional será definido. 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 de instância regional Dammam (me-central2), use:

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

Consulte a 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 de instância regional Dammam (me-central2), use:

spanner.me-central2.rep.googleapis.com

Consulte a 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 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

A seguir