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 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 tratados na mesma região. Os endpoints regionais do Spanner garantem que os dados armazenados e tratados sejam restritos à configuração da instância regional do Spanner em que o banco de dados reside. Use endpoints regionais se o local dos dados precisar ser restrito 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, é necessário criar uma instância na configuração da 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 subjacentes não mudam, independentemente do endpoint usado.

Segurança e conformidade 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 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 acessada pertencer à configuração da 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 de região dupla ou multirregional com um endpoint regional. É necessário usar o endpoint global para acessar as configurações de instância de região dupla ou multirregional. 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 à instância em nam7.

Se você tiver solicitações ativas que usam endpoints regionais em qualquer um dos recursos da instância, a movimentação da instância 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 endpoints regionais

Os nomes de endpoints regionais do Spanner seguem a mesma convenção de nomenclatura dos 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 de Damã 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, a API REST ou solicitações da API RPC.

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 para a qual definir um endpoint regional. Por 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 de Damã (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 de Damã (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 regional 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 Dammam
Europa
europe-west8 Milão

Restringir o uso endpoint 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 de API global. Para mais informações, consulte Restringir o uso de endpoints.

A seguir