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 de API padrão 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, seja qual for o endpoint usado.

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 pertence à 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 birregional ou multirregional. 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 de várias 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 de API padrão 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 de API padrão 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 de API globais

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

A seguir