Como usar a residência de dados com a Apigee híbrida

Visão geral

A residência de dados da Apigee atende aos requisitos regulatórios e de conformidade ao permitir que você especifique as localizações geográficas (regiões) onde os dados da Apigee são armazenados. Com a residência de dados, selecionar o local do plano de controle garante que todo o conteúdo do cliente seja armazenado na região especificada.

Para uma visão geral da residência de dados para a Apigee, consulte Introdução à residência de dados.

Residência de dados com a Apigee híbrida

A partir da versão híbrida 1.12, é possível usar a residência de dados com novas instalações da Apigee híbrida. Não é possível converter uma instalação atual para usar a residência de dados.

Ao criar sua organização da Apigee

Para criar sua organização da Apigee usando a residência de dados, você precisa das diferenças a seguir. Consulte Etapa 2: criar uma organização.

  • Local do plano de controle: é necessário especificar o local onde o conteúdo principal do cliente, como pacotes de proxy, é armazenado. Para uma lista, consulte Regiões disponíveis do plano de controle da API Apigee.

    O local do plano de controle é o local do endpoint do serviço, por exemplo, us para os Estados Unidos.

    A tabela a seguir lista as regiões disponíveis para o plano de controle da Apigee.

    Américas

    Descrição do local do plano de controle Nome do local do plano de controle Detalhes
    Estados Unidos us (multiple regions in United States) Endpoint de serviço: us-apigee.googleapis.com
    Canadá ca (multiple regions in Canada) Endpoint de serviço: ca-apigee.googleapis.com
    Descrição da região de dados do consumidor Nome da região de dados do consumidor Detalhes
    Iowa us-central1 Ícone de folha Baixo CO2
    Oregon us-west1 Ícone de folha Baixo CO2
    Los Angeles us-west2
    Salt Lake City us-west3
    Las Vegas us-west4
    Carolina do Sul us-east1
    Norte da Virgínia us-east4
    Columbus us-east5
    Dallas us-south1
    Montreal northamerica-northeast1 Ícone de folha Baixo CO2
    Toronto northamerica-northeast2 Ícone de folha Baixo CO2

    Europa

    Descrição do local do plano de controle Nome do local do plano de controle Detalhes
    Europa eu (multiple regions in the European Union) Endpoint de serviço: eu-apigee.googleapis.com
    Descrição da região de dados do consumidor Nome da região de dados do consumidor Detalhes
    Bélgica europe-west1 Ícone de folha CO2 baixo
    Frankfurt europe-west3 ícone de folha Baixo CO2
    Países Baixos europe-west4
    Milão europe-west8
    Paris europe-west9 Ícone de folha Baixo CO2
    Turim europe-west12
    Varsóvia europe-central2
    Madri europe-southwest1
    Finlândia europe-north1 Ícone de folha Baixo CO2

    Ásia-Pacífico

    Descrição do local do plano de controle Nome do local do plano de controle Detalhes
    Austrália au (multiple regions in Australia) Endpoint de serviço: au-apigee.googleapis.com
    Índia in (multiple regions in India) Endpoint de serviço: in-apigee.googleapis.com
    Descrição da região de dados do consumidor Nome da região de dados do consumidor Detalhes
    Sydney australia-southeast1
    Melbourne australia-southeast2
    Mumbai asia-south1
    Délhi asia-south2

    Oriente Médio

    Descrição do local do plano de controle Nome do local do plano de controle Detalhes
    Arábia Saudita sa (single region me-central2) Endpoint de serviço: sa-apigee.googleapis.com
    Israel il (single region me-west1) Endpoint de serviço: il-apigee.googleapis.com
    Descrição da região de dados do consumidor Nome da região de dados do consumidor Detalhes
    Damã me-central2
    Tel Aviv me-west1
  • Região de dados do consumidor: é necessário especificar uma região onde os dados do consumidor da API são armazenados. Precisa ser uma sub-região da região do plano de controle. Para ver uma lista de regiões de dados do consumidor disponíveis, consulte Locais da Apigee.
  • Tipo de faturamento: só é possível usar a residência de dados em organizações com assinatura paga.

Ao criar ambientes

Ao criar ambientes e instalá-los usando a residência de dados, você precisa criá-los no local do plano de controle. Consulte a Etapa 3: criar um grupo de ambientes.

Substituir os ajustes de arquivo

Ao usar a residência de dados, você precisa adicionar a propriedade de configuração contractProvider a cada arquivo de substituição e apontá-la para o caminho das APIs no local do plano de controle. Exemplo:

instanceID: "my_hybrid_example"
namespace: apigee

gcp:
  projectID: hybrid-example
  region: us-central1

k8sCluster:
  name: apigee-hybrid
  region: us-central1

org: hybrid-example

contractProvider: https://us-apigee.googleapis.com

Consulte a Etapa 6: criar as substituições

Ao chamar as APIs da Apigee

Quando você fizer chamadas curl para APIs da Apigee com o objetivo de realizar tarefas na instalação híbrida, será necessário chamar APIs de dentro do local do plano de controle. Exemplo:

curl -H "Authorization: Bearer $TOKEN" \
  "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"

ou

curl -H "Authorization: Bearer $TOKEN" \
  "https://us-apigee.googleapis.com/v1/organizations/my-hybrid-org/envgroups"